Ir al contenido principal

FareHarbor: backend de operador

Conecte FareHarbor con Ventrata para revender productos de operadores de FareHarbor con disponibilidad, precios y reservas en tiempo real. Utilizado por más de 20.000 empresas.

FareHarbor logo

 

FareHarbor, que forma parte de Booking Holdings, es una plataforma de reservas y gestión empresarial utilizada por más de 20.000 empresas de tours, actividades, alquileres y atracciones, con mayor implantación entre operadores pequeños y medianos de Norteamérica y Europa. Su producto abarca ventas online y presenciales, gestión de inventario, pagos, eventos privados, informes, planificación de personal, una app móvil y programas de partners para afiliados y API.

 

Conectar FareHarbor con Ventrata le permite revender productos de operadores que utilizan FareHarbor como sistema de reservas. Ventrata lee su disponibilidad y sus precios en tiempo real desde FareHarbor, y cada reserva que recibe se crea directamente en la cuenta de FareHarbor del operador.

 

Para obtener más información sobre FareHarbor, visite fareharbor.com.

 

📒 NOTA

¿Prefiere que FareHarbor revenda sus productos? Consulte FareHarbor: conexión de revendedor.

 

‼️ IMPORTANTE

FareHarbor le cobra a usted, como distribuidor o revendedor, comisiones por utilizar esta conexión. Para más detalles, póngase en contacto directamente con FareHarbor. Ventrata no cobra ninguna comisión adicional por esta conexión.

 

Sitio web principal

Etiquetas

Booking / Ticketing System

Funciones de la conexión

Availability Sync · Pricing Sync · Bookings Sync

Desarrollado por

Ventrata (mediante la External API de FareHarbor)

 

Esta conexión de operador (también llamada backend) le permite revender productos de operadores que utilizan FareHarbor como su sistema de reservas principal, y cada reserva se crea directamente en FareHarbor. Entre las funcionalidades de esta conexión se incluyen:

  • Availability Sync: la disponibilidad en tiempo real procede de la cuenta de FareHarbor del operador.

  • Pricing Sync: los precios de venta al público y netos proceden de FareHarbor, o usted establece los precios en Ventrata.

  • Bookings Sync: las reservas se envían de Ventrata a FareHarbor, y FareHarbor emite las entradas o los vouchers.

 

La API externa de FareHarbor que se utiliza para esta conexión es una API personalizada que no sigue el estándar de la API OCTO, lo que puede limitar determinadas funcionalidades y capacidades.

 

Crear la conexión con FareHarbor

🔐 Permisos de rol necesarios: See Operators, Modify Operators, See Products, Modify Products

Antes de empezar:

  • Debe tener un acuerdo comercial con el operador sobre sus tarifas y condiciones.

  • Debe tener un acuerdo de distribuidor con FareHarbor y su User Key de FareHarbor. Consulte el paso 1.

  • Debe volver a crear los productos del operador en Ventrata. Consulte cómo crear productos. La conexión sincroniza la disponibilidad, los precios y las reservas, pero no crea productos en Ventrata.

 

Paso 1: Registrarse como distribuidor de FareHarbor

Si no se ha conectado antes con un operador de FareHarbor, envíe un correo electrónico a [email protected] con copia a [email protected] y [email protected] para solicitar un acuerdo de distribuidor. Incluya lo siguiente. Indique que es usuario de Ventrata.

  • El nombre comercial, el número de IVA y la dirección de su empresa

  • El nombre completo, la dirección de correo electrónico y el cargo de la persona firmante

  • Los operadores de FareHarbor con los que desea conectarse

  • Las páginas de su sitio web en las que tiene previsto vender sus productos (si procede)

  • Que es usuario de Ventrata

 

Una vez firmado el acuerdo, [email protected] o [email protected] le envía su User Key de FareHarbor. Si ya se ha conectado antes con operadores de FareHarbor, ya tiene una.

 

Paso 2: Configurar el operador en Ventrata

  1. En el Ventrata Dashboard, vaya a Productos → Operadores (Products → Operators) y abra el operador. Si todavía no existe, primero créelo como operador.

  2. En la sección Socio de backend (Backend Partner), seleccione FareHarbor e introduzca la clave. Deje el campo del endpoint con el valor predeterminado, salvo que el operador le indique otra cosa.

  3. Haga clic en Actualizar Operador (Update Operator).

 

 

Paso 3: conecte cada producto

  1. Abra el producto del operador en Productos → Productos (Products → Products) y edítelo. Compruebe que el Operador sea este operador.

  2. Marque Backend conectado (Backend Connected). Marque Disponibilidad del backend (Backend Availability) para usar la disponibilidad de FareHarbor y Precios del backend (Backend Pricing) para usar los precios de FareHarbor.

  3. Haga clic en Actualizar Producto (Update Product).

📒 NOTA

FareHarbor envía tanto los precios de venta al público como los precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público como su precio de venta y el precio neto como su precio de coste, independientemente del porcentaje de coste configurado en el operador.

 

Mapear productos con FareHarbor

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto, opción y unidades de FareHarbor debe consultar la disponibilidad y realizar la reserva. Si un producto conectado al backend no está bien mapeado, sus reservas fallan. Un resaltado en rojo en toda la fila del producto indica que el producto está mal mapeado.

 

  1. En el Ventrata Dashboard, vaya a Productos → Productos (Products → Products) y abra el producto.

  2. Abra la pestaña Mapeos (Mappings). Aparece una vez que el producto tiene marcado Backend conectado (Backend Connected).

  3. Para cada opción y unidad de Ventrata, seleccione en las listas desplegables el item y los tipos de cliente correspondientes de FareHarbor, que Ventrata carga desde FareHarbor. No deje ningún campo vacío.

  4. Haga clic en Save Changes.

 

📗 CONSEJO

Haga una reserva de prueba después del mapeo y pida al operador que confirme que ha llegado a su cuenta de FareHarbor.

 

Gestionar la conexión con FareHarbor

  • Actualice el mapeo cuando el operador cambie productos, opciones o unidades en FareHarbor.

  • Sustituya la clave en el operador si FareHarbor o el operador emiten una nueva.

  • Desactive Disponibilidad del backend o Precios del backend (Backend Availability / Backend Pricing) en un producto para usar la disponibilidad o los precios propios de Ventrata. Las reservas se siguen enviando a FareHarbor.

 

Funciones de la conexión en detalle

Esta sección es para quien quiera saber exactamente cómo funciona la conexión con FareHarbor. Aquí el sentido es el contrario al de una conexión de revendedor: Ventrata llama a FareHarbor mediante la External API de FareHarbor. Para cada funcionalidad, se explica qué llamadas realiza Ventrata, cuándo las realiza y qué significa eso para usted.

 

En resumen: Ventrata solicita a FareHarbor la disponibilidad y los precios cada vez que alguien consulta un producto conectado al backend, y crea cada reserva en la cuenta de FareHarbor del operador. FareHarbor no envía cambios de vuelta a Ventrata.

 

Los tiempos son los habituales en FareHarbor, están redondeados y pueden cambiar.

 

Product Mapping

✅

Usted mapea cada producto, opción y unidad de Ventrata con el item de FareHarbor del operador en el Ventrata Dashboard.

Funciona así:

  • Company (GET /companies/{shortname}/): Ventrata lee la empresa de FareHarbor del operador, que comprueba periódicamente.

  • Items (GET /companies/{shortname}/items/): Ventrata lee los items (productos) de FareHarbor del operador y sus tipos de cliente para rellenar las listas desplegables de la pestaña Mapeos (Mappings).

 

Qué significa esto para usted: si falta un item o un tipo de cliente en la lista desplegable, el operador no lo ha puesto a su disposición en FareHarbor. Pídale que lo haga.

Availability Sync

✅

Con Disponibilidad del backend (Backend Availability) activada, Ventrata consulta la disponibilidad en tiempo real del operador en FareHarbor.

Funciona así:

  • Availabilities by date range (GET /companies/{shortname}/items/{pk}/minimal/availabilities/date-range/{start}/{end}/): cuando alguien utiliza el calendario de disponibilidad en Ventrata, Ventrata consulta en tiempo real a FareHarbor las fechas que aparecen en pantalla.

  • Availabilities by date (GET /companies/{shortname}/items/{pk}/minimal/availabilities/date/{date}/): Ventrata vuelve a comprobar la fecha elegida justo antes de crear una reserva.

 

Lo habitual con FareHarbor:

  • Las solicitudes suelen abarcar un solo día o un intervalo de 7 días, desde hoy hasta aproximadamente un año vista, a medida que los usuarios navegan.

 

Qué significa esto para usted: los clientes siempre reservan sobre la disponibilidad en tiempo real del operador en FareHarbor.

Pricing Sync

✅

Con Precios del backend activado, Ventrata toma de la disponibilidad las tarifas de FareHarbor del operador, de venta al público y netas.

Funciona así:

  • Availabilities: cada disponibilidad de FareHarbor incluye las tarifas de cada tipo de cliente, que Ventrata utiliza como precios del producto.

  • Con Precios del backend (Backend Pricing) desactivado, el producto usa los precios que usted establece en Ventrata, y las reservas se siguen enviando a FareHarbor.

FareHarbor envía tanto los precios de venta al público como los precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público como su precio de venta y el precio neto como su precio de coste, independientemente del porcentaje de coste configurado en el operador.

Bookings Sync

✅ / ❌

Las reservas realizadas en Ventrata se crean en FareHarbor. FareHarbor no tiene paso de bloqueo, y las cancelaciones deben comprobarse con el operador.

Funciona así:

  1. Bloqueo: Validate booking (POST /companies/{shortname}/availabilities/{pk}/bookings/validate/): cuando el producto se añade al carrito, Ventrata comprueba la reserva con FareHarbor. FareHarbor no bloquea plazas, por lo que Ventrata las bloquea solo por su parte mientras el cliente paga.

  2. Confirmar: Create booking (POST /companies/{shortname}/availabilities/{pk}/bookings/): tras el pago, Ventrata vuelve a validar la reserva y la crea en la cuenta de FareHarbor del operador con los datos del cliente. La referencia de reserva de FareHarbor se guarda en la reserva de Ventrata.

  3. Cancelar: cuando cancele una reserva en Ventrata, compruebe también con el operador que se ha cancelado en FareHarbor.

 

‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Ventrata a FareHarbor. Si el operador modifica o cancela una reserva en FareHarbor, Ventrata no recibe ningún aviso. Pida al operador que le informe de cualquier cambio que haga.

📒 NOTA – Como FareHarbor no bloquea plazas durante el checkout, una franja puede agotarse en FareHarbor mientras su cliente está pagando. Ventrata vuelve a comprobarlo antes de crear la reserva y la detiene si ya no hay plazas.

Content Sync

❌

Ventrata no importa el contenido de los productos desde FareHarbor.

Ventrata no importa el contenido de los productos desde FareHarbor. Usted mismo crea y describe los productos en Ventrata.

Promotions Sync

❌

Las promociones no se envían a FareHarbor.

Las promociones no se envían a FareHarbor. Sus promociones de Ventrata siguen aplicándose al precio que paga su cliente en Ventrata.

Pickups/Dropoff Sync

❌

Los datos de recogida y regreso no se transmiten a FareHarbor.

Los datos de recogida y regreso no se transmiten a FareHarbor. Compártalos con el operador por otra vía si un producto los necesita.

Custom Questions Sync

❌

Las respuestas a sus preguntas de reserva no se transmiten a FareHarbor.

Las respuestas a sus preguntas de reserva no se transmiten a FareHarbor. Compártalas con el operador por otra vía si las necesita.

Extras Sync

❌

Los extras y complementos no se reservan en FareHarbor.

Los extras y complementos no se reservan en FareHarbor. Solo se reservan el producto principal, la opción y las unidades.

Redemption Sync

❌

Los canjes y otros cambios de estado en FareHarbor no se envían de vuelta a Ventrata una vez confirmada la reserva.

Los canjes y otros cambios de estado en FareHarbor no se envían de vuelta a Ventrata una vez confirmada la reserva.

Pass Walkup Scanning Sync

❌

El escaneo de pases sin reserva previa no está disponible con FareHarbor.

El escaneo de pases sin reserva previa no está disponible con FareHarbor.

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a FareHarbor.

Las tarjetas regalo de Ventrata no se transmiten a FareHarbor. Los pagos con tarjeta regalo se quedan en Ventrata.

✅ compatible · ✅ / ❌ limitado · ❌ no compatible

 

Conviene saber: límites y detalles de la conexión con FareHarbor

  • Comisiones: FareHarbor cobra a los distribuidores por esta conexión. Ventrata no.

  • Sin bloqueo en FareHarbor: las plazas solo se bloquean en Ventrata durante el checkout, y Ventrata vuelve a comprobar la disponibilidad antes de reservar.

  • API personalizada: la External API de FareHarbor no es OCTO, por lo que algunas funcionalidades pueden estar limitadas en comparación con los backends OCTO.

  • Reservas en un solo sentido: los cambios que el operador hace en FareHarbor no llegan a Ventrata.

 

Preguntas frecuentes

Recibo un error al guardar la configuración del backend del operador.

Lo más probable es que su User Key de FareHarbor sea incorrecta. Compruébela y, si el problema persiste, póngase en contacto con nuestro Soporte técnico.

No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.

Lo más probable es que el operador asignado al producto no tenga un backend configurado. Revise la configuración de Socio de backend (Backend Partner) del operador y vuelva a intentarlo. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.

Las listas desplegables muestran los items y tipos de cliente que el operador ha puesto a su disposición en FareHarbor. Compruébelo con el operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Las reservas de un producto conectado al backend fallan.

Compruebe primero el mapeo del producto: todas las opciones y unidades deben estar mapeadas. Después, compruebe que la franja horaria sigue disponible en FareHarbor. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

 

Recursos útiles

 

 

Información del partner

FareHarbor B.V.

Vijzelstraat 66-80

1017 HL Amsterdam, Países Bajos

 

ID de partner de Ventrata: 11496205-33a3-470e-9449-13f00f85c8d5

¿Ha quedado contestada tu pregunta?