Get Mappings (mediante la API GraphQL del Supplier Portal de GetYourGuide): cuando abre la conexión o hace clic en Actualizar mapeo (Refresh Mapping), Ventrata inicia sesión en su cuenta de GetYourGuide como el usuario Operations que añadió en el paso 2 y lee todos sus productos y opciones de GetYourGuide, con su estado actual y su configuración de conectividad. GetYourGuide no publica documentación de esta API; el enlace muestra el concepto equivalente de mapeo autónomo en la API OCTO de Ventrata.

Update Mappings (mediante la API GraphQL del Supplier Portal de GetYourGuide): cuando pulsa Actualizar mapeo de conexión (Update Connection Mapping), Ventrata abre el producto correspondiente en su cuenta de GetYourGuide. Comprueba la configuración básica (como las categorías de entrada), borra la disponibilidad, los precios y las promociones existentes y escribe el mapeo en la configuración de conectividad de la opción. También desactiva los complementos de la opción y sincroniza de inmediato sus deals para ese producto (consulte Promotions Sync).

Product Details (GET /1/products/{productId}): cuando se introduce un External Product ID para el primer producto que mapea, GetYourGuide solicita a Ventrata sus datos básicos, incluido su Ventrata API Supplier ID (= ID/clave de la conexión).

Products List (GET /1/suppliers/{supplierId}/products/): con este ID, GetYourGuide obtiene la lista de productos disponibles en la conexión, con sus External Product IDs, y los muestra en un desplegable para facilitar el mapeo de otros productos. Ventrata crea la lista con Get Products (GET /products) de OCTO, de modo que solo contiene los productos habilitados en la conexión.

Pricing Categories (GET /1/products/{productId}/pricing-categories/): GetYourGuide importa las unidades de su producto como sus categorías de precios. Ventrata las lee con Get Product (GET /products/{productId}) de OCTO.

Availability Query (GET /1/get-availabilities/): GetYourGuide comprueba que hay al menos 2 franjas horarias o días disponibles en los próximos 365 días, que las categorías de precios (unidades) devueltas coinciden con las configuradas o importadas en GetYourGuide y que los precios son válidos (por ejemplo, sin discrepancias de moneda).

Reservation (POST /1/reserve/): GetYourGuide hace algunas reservas de prueba (reservas pendientes), normalmente para el número mínimo y máximo de participantes permitido en cada categoría de precio (tipo de unidad).

Reservation Cancellation (POST /1/cancel-reservation/): a continuación, GetYourGuide cancela (libera) estas reservas de prueba.

Las llamadas de mapeo solo se producen cuando alguien abre o edita una conexión, por lo que llegan en ráfagas cortas y no de forma programada.

Ventrata inicia sesión en su cuenta de GetYourGuide (incluido el inicio de sesión en dos pasos de GetYourGuide) cada vez que lee o guarda sus mapeos.

GetYourGuide llama a Product Details, Products List y Pricing Categories solo mientras alguien mapea en su Supplier Portal.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata): GetYourGuide solicita un producto y un intervalo de fechas. Ventrata responde con cada día o franja horaria disponible, sus plazas restantes, su hora límite de reserva y sus precios, y GetYourGuide los guarda en caché en su sistema. Internamente, el adaptador busca su mapeo y llama a Availability Check (POST /availability) de OCTO. GetYourGuide vuelve a sincronizar con una frecuencia predefinida, que puede variar en función de muchos factores:

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide): cuando su disponibilidad cambia por nuevas reservas en Ventrata o por cambios concretos de fecha u hora (no por cambios masivos), Ventrata envía a GetYourGuide las plazas (y los precios) actualizados de esa franja horaria. Ventrata los envía de inmediato para las franjas que empiezan en los próximos 90 días y a las que les quedan 10 plazas o menos, incluidas las agotadas. Los demás cambios llegan a GetYourGuide en su siguiente sincronización programada.

Reservation (POST /1/reserve/, GetYourGuide → Ventrata): cuando un cliente añade su producto al carrito en GetYourGuide, Ventrata vuelve a comprobar si queda aforo suficiente y, si no, rechaza la reserva. Así, GetYourGuide no puede sobrevender una franja aunque su disponibilidad en caché esté ligeramente desactualizada.

Availability Query: se produce las 24 horas del día de forma bastante constante, con ligeros picos durante el día. De media, cada producto mapeado se consulta cada pocos minutos.

Aproximadamente la mitad de las solicitudes se refieren a fechas del próximo mes. El resto llega más lejos, hasta casi un año vista.

La mayoría de las solicitudes se refieren a un solo día; las solicitudes más largas suelen cubrir aproximadamente una semana.

Las fechas solicitadas incluyen un desfase horario, por lo que la zona horaria de su producto es importante.

Notify Availability Update: se envía las 24 horas del día, pocos instantes después del cambio que lo desencadenó. Los envíos llegan en ráfagas que siguen la actividad de reservas y sus propios cambios.

Pricing Categories (GET /1/products/{productId}/pricing-categories/, GetYourGuide → Ventrata): durante el mapeo, GetYourGuide obtiene los datos de las unidades de su producto y los actualiza (importa) como sus categorías de precios.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata): GetYourGuide llama regularmente a Ventrata para volver a sincronizar el precio de venta al público de cada categoría de entrada, y lo guarda en caché, con la misma frecuencia que la disponibilidad. Los precios proceden de los precios del revendedor GetYourGuide en Ventrata, a través del Availability Check de OCTO.

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide): cuando su disponibilidad cambia por nuevas reservas en Ventrata, por tarifas o por cambios concretos de fecha u hora (no por cambios masivos), Ventrata envía a GetYourGuide los precios de venta al público actualizados.

Booking (POST /1/book/, GetYourGuide → Ventrata): cada reserva incluye el precio de venta al público que utilizó GetYourGuide.

Booking Size Fares: Ventrata y GetYourGuide calculan de forma distinta las estructuras de tramos con varias unidades, por lo que solo una unidad mapeada por producto puede usar precios dinámicos por tramos. Las tarifas adicionales siguen estando permitidas y funcionan, pero se mantienen con precios estáticos. Vea un ejemplo en el que la unidad Adulto tiene activados los precios por tramos, mientras que las unidades Niño y Bebé se mantienen estáticas:

No hay una llamada de precios aparte: los precios viajan con cada respuesta de disponibilidad y con cada envío.

GetYourGuide llama a Pricing Categories solo mientras se está mapeando un producto.

List Deals (GET /1/deals), Delete a deal (DELETE /1/deals/{dealId}) y Create a Deal (POST /1/deals), Ventrata → GetYourGuide: para los productos que mapea desde el Ventrata Dashboard (no desde el portal de GetYourGuide), Ventrata lee sus ofertas especiales de GetYourGuide y comprueba que coinciden con las promociones públicas permitidas para su revendedor GetYourGuide. Lo hace cada 60 minutos. Si algo no coincide, Ventrata elimina todas las ofertas especiales y las vuelve a crear para que coincidan con el Ventrata Dashboard. GetYourGuide no tiene ninguna llamada para editar un deal, así que cada cambio consiste en eliminarlo y crear uno nuevo.

Cuando guarda un mapeo en el Ventrata Dashboard, Ventrata también sincroniza de inmediato los deals de ese producto.

Actualmente, GetYourGuide solo admite promociones públicas básicas aplicables a todas las unidades con configuración prorrateada. Las demás promociones no se sincronizan.

La comprobación de deals se ejecuta las 24 horas del día, en ciclos de una hora, y justo después de los cambios de mapeo.

Es habitual que se eliminen y se vuelvan a crear, porque cualquier diferencia hace que se regeneren los deals del producto.

Starts at

Ends at

Days Before

Notice Days

Redeemable Day

Las cuatro llamadas llegan las 24 horas del día, a medida que compran los clientes, con picos durante el día.

Hay más bloqueos que reservas. Es normal: GetYourGuide libera de inmediato casi todos los bloqueos que no se convierten en reserva, en lugar de dejar que venzan.

Cada modificación de reserva aparece en Ventrata como una nueva reserva más una cancelada con la misma referencia.

Si una llamada de reserva falla o se agota el tiempo de espera, GetYourGuide la reintenta hasta 10 veces, cada 10 minutos (consulte los reintentos de reserva de GetYourGuide), por lo que ocasionalmente una reserva puede llegar un poco después de que el cliente haya pagado.

Ticket Redemption by Booking Reference (POST /1/redeem-booking, Ventrata → GetYourGuide): en cuanto se canjea cualquiera de las entradas de una reserva (aunque la reserva solo se haya canjeado parcialmente), Ventrata envía a GetYourGuide una notificación de canje de la reserva. Esto puede ayudar a evitar cancelaciones y reembolsos de reservas canjeadas. Sin embargo, se sabe que actualmente GetYourGuide cancela reservas independientemente de la notificación recibida.

Ventrata comunica los canjes por reserva. No se utiliza la llamada de canje por entrada de GetYourGuide.

Ventrata revisa cada actualización de una reserva de GetYourGuide y envía una notificación solo cuando la actualización incluye un canje.

Las notificaciones siguen el ritmo de sus escaneos: se envían las 24 horas del día, pero sobre todo durante el día, cuando llegan los visitantes.

Cree una lista de lugares de recogida para cada uno de sus productos u opciones en el GetYourGuide Supplier Portal. Actualmente, GetYourGuide no puede obtenerlos de Ventrata, así que debe gestionarlos manualmente en su portal.

Booking (POST /1/book/, GetYourGuide → Ventrata): GetYourGuide envía a Ventrata el lugar de recogida (el hotel del viajero) con la solicitud de confirmación de la reserva, si se aplica a su producto. Mediante la API Google Maps Places, Ventrata lo asigna al punto de recogida más cercano que usted ofrece y también guarda la ubicación exacta en el campo Hotel de la reserva.

Los datos de recogida solo llegan con la llamada Booking. GetYourGuide nunca solicita a Ventrata sus puntos de recogida.

Mapeo en el portal de GetYourGuide: cuando configure o mapee un producto en el portal de GetYourGuide, establezca la opción Allow Add-ons en No. Si la establece en Yes, GetYourGuide solicitará datos de complementos a la API (Fetch Addons, GET /1/products/{productId}/addons/), que Ventrata rechaza, lo que provoca fallos en la conexión.

Mapeo en el Ventrata Dashboard: los productos mapeados directamente desde el Ventrata Dashboard tienen los complementos desactivados automáticamente durante la configuración.