Ir al contenido principal

Conexión de revendedor de GetYourGuide

Cómo conectar sus listados de productos en GetYourGuide con Ventrata para sincronizar disponibilidad, precios, reservas y más.

Actualizado esta semana

GetYourGuide es una de las principales OTA (agencias de viajes online) y marketplaces especializados en experiencias de viaje, que ofrece un amplio catálogo de actividades, tours y atracciones en todo el mundo de más de 30 000 proveedores en más de 11 000 destinos. Con su proceso de reserva fluido, atención al cliente dedicada, amplia red de distribución y alcance global, GetYourGuide ayuda a las empresas a crecer y conectar con viajeros de todas partes. Visite getyourguide.supply para obtener más información.

Esta conexión le permite vender sus productos en GetYourGuide de forma más automatizada, eliminando la necesidad de gestionar manualmente la disponibilidad, los precios y las reservas en el Portal de Proveedores de GetYourGuide. Capacidades de esta conexión le permiten:

  • Sincronizar disponibilidad, precios y ofertas (promociones) de sus productos de GetYourGuide con Ventrata.

  • Recibir reservas, actualizaciones y cancelaciones desde GetYourGuide a Ventrata.

  • Emitir vales/tickets desde Ventrata a los clientes de GetYourGuide al instante.

Si desea utilizar la conexión para vender productos de GetYourGuide usted mismo, consulte Conexión de operador de GetYourGuide. Consulte Conexión de ticketing de GetYourGuide si utiliza su solución de web checkout.

🏆 Ventrata ofrece conectividad API líder en su clase con GetYourGuide:

2025 Socio de Conectividad PREMIUM de GetYourGuide

Como parte de su Connectivity Partner Program (Programa de Socios de Conectividad), GetYourGuide reconoce y premia anualmente a los principales sistemas de reservas y ticketing según la calidad y el rendimiento de su integración API. Esta evaluación tiene en cuenta las tasas de éxito de las solicitudes API, las funciones y capacidades admitidas, el volumen de negocio y el nivel de compromiso del socio.

Según los datos de 2024, de más de 150 sistemas integrados, solo Ventrata y otros dos recibieron el nivel más alto—Premium Connectivity Partner 2025—reconociéndolos como los mejores sistemas para proveedores que trabajan con GetYourGuide.

Comunicado de prensa

2024 Socio de Conectividad PREMIUM de GetYourGuide


Como parte de su Programa de Socios de Conectividad, GetYourGuide reconoce y premia anualmente a los principales sistemas de reservas y ticketing según la calidad y el rendimiento de su integración API. Esta evaluación tiene en cuenta las tasas de éxito de las solicitudes API, las funciones y capacidades admitidas, el volumen de negocio y el nivel de compromiso del socio.

Según los datos de 2023, de más de 150 sistemas integrados, solo Ventrata y otros tres recibieron el nivel más alto—Premium Connectivity Partner 2024—reconociéndolos como los mejores sistemas para proveedores que trabajan con GetYourGuide.

“El enfoque de Ventrata como Premium Connectivity Partner en mejorar las experiencias de reserva y establecer un alto estándar de rendimiento constante ha demostrado ser invaluable, ofreciendo a nuestros clientes acceso a una amplia gama de experiencias de viaje inolvidables.” - Tao Tao, COO y cofundador de GetYourGuide

Comunicado de prensa

Partner de conectividad ADVANCED de GetYourGuide 2023


Como parte de su Programa de Socios de Conectividad, GetYourGuide reconoce y premia anualmente a los principales sistemas de reservas y emisión de entradas en función de la calidad y el rendimiento de su integración de API. Esta evaluación tiene en cuenta las tasas de éxito de las solicitudes de API, las funciones y capacidades admitidas, el volumen de negocio y el nivel de compromiso del socio.

Según los datos de 2022, entre más de 150 sistemas integrados, Ventrata fue uno de los pocos sistemas galardonados como Advanced Connectivity Partner 2023, el segundo mejor nivel de su programa.

Partner de Conectividad PREMIUM de GetYourGuide 2021-2022


Como parte de su Programa de Socios de Conectividad, GetYourGuide reconoce y premia anualmente a los principales sistemas de reservas y emisión de entradas en función de la calidad y el rendimiento de su integración de API. Esta evaluación tiene en cuenta las tasas de éxito de las solicitudes de API, las funciones y capacidades admitidas, el volumen de negocio y el nivel de compromiso del socio.

En el año inaugural del programa, de más de 120 sistemas integrados, solo Ventrata y otros tres recibieron el nivel más alto—Premium Connectivity Partner 2024—reconociéndolos como los mejores sistemas para proveedores que trabajan con GetYourGuide. Esta evaluación se basó en datos de 2021. Los premios de 2022 y años posteriores utilizaron el año siguiente en su título.


Creación de la conexión

Antes de empezar:

  • Debes tener una cuenta de proveedor en GetYourGuide y tus productos creados en su Portal antes de crear esta conexión. Se necesitará acceso de administrador a la cuenta para configurar esta conexión. Si aún no trabajas con GetYourGuide, puedes crear una cuenta aquí.

  • Debes tener GetYourGuide creado como Revendedor en Ventrata con su tarifa (venta al público, mayorista/comisión) definidas correctamente. Ten en cuenta que esta conexión API requiere que el reseller esté configurado en el modo "Bill to my account (Facturar a mi cuenta)" como método de liquidación.

Para configurar tu conexión con GetYourGuide por primera vez, primero tendrás que añadir a Ventrata como usuario en tu cuenta de GetYourGuide y luego crear una conexión en Ventrata:

Paso 1: Crear una conexión en Ventrata

  1. En Ventrata Dashboard, ve a Connections (Conexiones) → Connections (Conexiones), haz clic en + New Connection (+ Nueva conexión), y selecciona GetYourGuide de la lista de socios.

  2. Selecciona GetYourGuide Reseller (Revendedor) de la lista de tus revendedores (deben crearse antes de crear una conexión). La conexión heredará la configuración del revendedor, como precios, destinos en lista blanca, productos, etc.

  3. (Opcional) También puedes establecer la conexión Nombre de tu elección, lo cual puede ser útil si tienes varias conexiones de GetYourGuide y quieres diferenciarlas más fácilmente en el futuro. Si es necesario, también puedes poner en lista blanca o negra productos o destinos a nivel de conexión además de lo que hayas configurado en el revendedor, lo que puede ser útil si tienes varias conexiones de GetYourGuide vinculadas a un mismo revendedor.

Paso 2: Añade Ventrata como usuario a tu cuenta de GetYourGuide

  1. Toma nota de la dirección de correo electrónico que aparece en la página de la conexión. Debería tener un formato similar a connectivity+gygeb423b77-4e73-4er5-847e-ad4b5c13893f@ventrata.com

  2. Inicia sesión en Portal de Proveedores de GetYourGuide, haz clic en tu nombre en la esquina superior derecha y ve a Account Settings (Configuración de la cuenta).

    Log in to GetYourGuide Supplier Portal, click on your name in the top-right corner, go to Account Settings:

  3. En Accounts (Cuentas) pestaña, haz clic en + Add a new account profile (+ Añadir un nuevo perfil de cuenta). En el Email (Correo electrónico) campo, introduce la dirección de correo electrónico de la página de la conexión. Puedes dejar en blanco todos los demás campos opcionales.

  4. Activa Allow login (Permitir acceso), selecciona Operations (Operaciones) como tipo de cuenta y haz clic en Add a new account profile (Añadir un nuevo perfil de cuenta). Ventrata recibirá y aceptará automáticamente la invitación a tu cuenta.

  5. Una vez enviada la invitación, actualiza la página de la conexión en Ventrata.


Mapeo de productos

Una vez creada la conexión, puedes empezar a vincular tus productos y opciones de GetYourGuide con los productos y opciones correspondientes de Ventrata; a este proceso se le llama "mapeo". Esto puede hacerse de dos maneras:

Método 1: Mapeo manual mediante el panel de Ventrata (recomendado)

  1. En Ventrata Dashboard, ve a Connections (Conexiones) → Connections (Conexiones), y selecciona GetYourGuide conexión que deseas utilizar para el mapeo de productos.

    La página de la conexión mostrará una tabla con los productos y opciones (listados) que existen en tu cuenta de GetYourGuide a la izquierda y los productos y opciones de Ventrata a los que están conectados (mapeados) actualmente a la derecha. Cualquier listado activo que no esté mapeado a Ventrata o que esté mapeado incorrectamente aparecerá resaltado en rojo.

  2. Haz clic en listado de GetYourGuide que deseas mapear. Selecciona el producto de Ventrata y, si se solicita, la opción a la que deseas conectar este listado.

    Deja el campo Unidad como All tiers (Todos los niveles) a menos que quieras mapear este listado usando la configuración de precios por grupo de GetYourGuide, donde cada grupo corresponde a una unidad (nivel) específica en Ventrata.

  3. Haz clic en Update Mapping (Actualizar mapeo). Ventrata completará automáticamente el mapeo del producto en el portal de GetYourGuide y tu producto quedará conectado.

    Ten en cuenta que tu producto podría no estar disponible para reservar en GetYourGuide durante aproximadamente 5 minutos después de actualizar el mapeo, mientras su sistema se reinicia y vuelve a sincronizar por completo toda tu disponibilidad.

Método 2: Auto-mapeo mediante el Portal de Proveedores de GetYourGuide

  1. Inicia sesión en Portal de Proveedores de GetYourGuide, ve a Manage (Manage) → Products (Productos), y haz clic en See Details (Ver detalles) junto al listado de producto de GetYourGuide que quieras conectar. Luego, del mismo modo selecciona una opción y haz clic en Edit Option (Editar opción).

  2. Haz clic en Connectivity Settings (Configuración de conectividad), luego, en Do you use an online reservation system? (¿Utilizas un sistema de reservas en línea?) elige Yes, I use a reservation system (Sí, uso un sistema de reservas) y selecciona Ventrata de la lista desplegable que aparece.

  3. A continuación, selecciona el Producto y la Opción de Ventrata a los que debe conectarse este listado de GetYourGuide en la lista desplegable mostrada. Haz clic en Continue (Continuar).

    Si no se muestra ninguna lista desplegable de productos (posible la primera vez que se mapea) y se te pide introducir External product ID (ID de producto externo) en su lugar, ponte en contacto con nosotros a través de Messenger para obtenerlo. NO introduzcas el ID de producto de Ventrata en este campo, ya que no es lo mismo que el External Product ID que necesita GetYourGuide para el mapeo. El External Product ID de GetYourGuide sigue un formato específico (connect_id.productId.optionId o connect_id.productId.optionId.unitId para la tarificación por grupo) y lo mejor es que lo proporcione el equipo de Ventrata o que se rellene automáticamente utilizando el Método de mapeo 1.

  4. Verifica si Pricing Categories (Categorías de precios) se importaron correctamente, actualiza si es necesario. Haz clic en Save and continue (Guardar y continuar).

  5. Verifica si Capacity (Capacidad) las restricciones (mín./máx. de participantes por reserva) se importaron correctamente; actualiza si es necesario. Haz clic en Save and continue (Guardar y continuar).

  6. En Do you want to apply the prices that you have specified in your reservation system? (¿Quieres aplicar los precios que has especificado en tu sistema de reservas?) select (seleccionar) Yes, I want to import my pricing configuration. (Sí, quiero importar mi configuración de precios.) Luego haz clic en Save and continue (Guardar y continuar).

  7. A continuación, GetYourGuide validará las conexiones comprobando si puede acceder a la disponibilidad y realizará algunas reservas de prueba (reservas pendientes). Cuando se complete correctamente, haz clic en Finish (Finalizar) para completar el proceso.

    Ten en cuenta que tu producto podría no estar disponible para reservar en GetYourGuide durante aproximadamente 5 minutos después de actualizar el mapeo, mientras su sistema se reinicia y vuelve a sincronizar por completo toda tu disponibilidad.


Capacidades admitidas (detalladas)

Mapeo de autoservicio

Puedes mapear tus productos por tu cuenta desde el Panel de Ventrata (recomendado) o desde el Portal de Proveedores de GetYourGuide.

El proceso funciona de la siguiente manera cuando se mapea desde Ventrata:

  • Get Mappings (Obtener mapeos) (a través de GYG Supplier GraphQL). Cuando abres la conexión en el Panel de Ventrata, Ventrata accede automáticamente a tu cuenta de GetYourGuide en su Portal de Proveedores utilizando la cuenta de usuario de Operaciones creada para la conexión y recupera la lista de todos los productos y opciones de la cuenta, incluidos su estado, ajustes de conectividad, etc.

  • Update Mappings (Actualizar mapeos) (a través de GYG Supplier GraphQL). Cuando actualizas los mapeos en el Panel de Ventrata, Ventrata accede automáticamente al producto correspondiente en tu cuenta de GetYourGuide, verifica sus configuraciones básicas como las categorías de tickets, elimina cualquier disponibilidad, precio y promociones (ofertas especiales) configurados anteriormente y actualiza el mapeo en los ajustes de conectividad según tu selección.

Y de la siguiente manera cuando se mapea desde GetYourGuide:

  • Product Details (Detalles del producto). Cuando se introduce el ID de producto externo para el primer producto que mapeas, GetYourGuide solicitará sus detalles básicos a Ventrata, incluido tu ID de proveedor de la API de Ventrata (= ID/Clave de conexión).

  • Products List (Lista de productos). Con este ID, GetYourGuide podrá posteriormente obtener la lista de productos disponibles para ellos en la conexión y su ID de producto externo y mostrarla en un desplegable para simplificar el mapeo de otros productos.

  • Pricing Categories (Categorías de precios). Además, GetYourGuide extraerá los detalles de las unidades de tu producto y los actualizará (importará) en consecuencia.

Cuando intentes guardar el mapeo realizado desde Ventrata o desde GetYourGuide, GetYourGuide efectuará varias validaciones/pruebas antes de guardar el mapeo correctamente. Estas pruebas incluyen:

  • Consulta de disponibilidad. GetYourGuide recuperará la disponibilidad y comprobará que existan al menos 2 franjas horarias o días disponibles en los próximos 365 días; también verificará que las categorías de precio (unidades) devueltas coincidan con las configuradas en GetYourGuide o importadas previamente, así como que los precios devueltos no presenten ningún problema (por ejemplo, discrepancias de divisa).

  • Reserva. GetYourGuide intentará crear algunas reservas (pendientes) normalmente con el número mínimo y máximo permitido de participantes para cada categoría de precio (tipo de unidad).

  • Cancelación de reserva. A continuación, GetYourGuide cancelará / liberará estas reservas (pendientes).

Si alguna de estas validaciones/pruebas falla, se mostrará al usuario el error correspondiente. Si todas pasan, el mapeo se guardará correctamente.

Disponibilidad

La disponibilidad de sus listados de productos en GetYourGuide se sincronizará regularmente con la disponibilidad de los productos/opciones de Ventrata a los que estén mapeados.

Funciona del siguiente modo:

  • Consulta de disponibilidad. GetYourGuide llamará regularmente a Ventrata para volver a sincronizar su disponibilidad (días / franjas horarias disponibles, vacantes restantes y límite de reserva para cada una) y almacenará esta información en su sistema. Normalmente esto ocurre con una frecuencia predefinida como la siguiente, pero puede variar según varios factores:

    • Cuando se mapea el producto, GYG sincroniza los próximos 365 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada 8 días, GYG sincroniza los próximos 365 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada 4 días, GYG sincroniza los próximos 90 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada día, GYG sincroniza los próximos 30 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada 4 horas, GYG sincroniza los próximos 7 días

  • Notificar disponibilidad. Cuando su disponibilidad cambie debido a nuevas reservas que lleguen a Ventrata o a cambios específicos de fecha/hora (no cambios masivos), Ventrata enviará los detalles actualizados a GetYourGuide.

  • Reserva. Cuando un cliente intente añadir un producto a su carrito en GetYourGuide, Ventrata verificará si aún queda disponibilidad para aceptar la reserva y la rechazará en caso contrario.

Precios

✅ *

Los precios de venta al público de sus listados de productos en GetYourGuide se sincronizarán regularmente con la disponibilidad del producto/opción de Ventrata al que estén mapeados. *Los productos que utilizan tarifas por tamaño de reserva (precios escalonados) no están actualmente admitidos.

Funciona del siguiente modo:

  • Pricing Categories (Categorías de precios). Durante el mapeo, GetYourGuide obtendrá los detalles de las unidades de su producto y los actualizará (importará) en consecuencia.

  • Consulta de disponibilidad. GetYourGuide llamará regularmente a Ventrata para volver a sincronizar sus precios de venta al público para cada categoría de billete y almacenarlos en su sistema. Normalmente esto ocurre con una frecuencia predefinida como la siguiente, pero puede variar en función de muchos factores:

    • Cuando se mapea el producto, GYG sincroniza los próximos 365 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada 8 días, GYG sincroniza los próximos 365 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada 4 días, GYG sincroniza los próximos 90 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada día, GYG sincroniza los próximos 30 días (en múltiples solicitudes de incrementos de 7 días)

    • Cada 4 horas, GYG sincroniza los próximos 7 días

  • Notificar disponibilidad. Cuando su disponibilidad cambie debido a nuevas reservas que lleguen a Ventrata, modificaciones de tarifas o cambios específicos de fecha/hora (no cambios masivos), Ventrata enviará los precios de venta actualizados a GetYourGuide.

Promociones

Sus promociones públicas con configuraciones admitidas por GetYourGuide se sincronizarán como Ofertas especiales / Deals de GetYourGuide.

Funciona del siguiente modo:

  • Listar ofertas / Eliminar una oferta / Crear una oferta. Cuando vinculas un producto desde Ventrata Dashboard (y no desde el portal de GetYourGuide), así como cada 60 minutos para todos los productos mapeados mediante la Pricing API, Ventrata accederá a la lista de todas las Special Offers en tu cuenta de GetYourGuide y comprobará si coincide con las promociones públicas configuradas y autorizadas para el enlace de revendedor de GetYourGuide en la conexión. En caso de discrepancia, Ventrata eliminará todas las Special Offers y las recreará para que coincidan con Ventrata, asegurando así que tus Special Offers se mantengan sincronizadas con las promociones públicas de Ventrata.

    • Actualmente, GetYourGuide solo admite promociones públicas básicas aplicables a todas las unidades con configuraciones prorrateadas. Otras promociones no se sincronizarán.


❗️IMPORTANTE❗️

Al configurar promociones con GetYourGuide, los siguientes campos no son compatibles y se ignorarán:

  • Starts at (Comienza a)

  • Ends at (Termina a)

  • Days Before (Días antes)

  • Notice Days (Días de aviso)

  • Redeemable Days (Días canjeables)

Reserva

Las reservas, los cambios de reserva y las cancelaciones realizadas por los clientes en GetYourGuide se crean automáticamente en Ventrata. El ticket/vale generado por Ventrata se emite al cliente.

Funciona del siguiente modo:

  • Reserva. Cuando un cliente añade tu producto a su carrito en GetYourGuide, GetYourGuide realizará una solicitud a Ventrata para crear una reserva pendiente y mantener la disponibilidad mientras el cliente finaliza el pago. Ventrata puede rechazar la reserva si ya no hay disponibilidad suficiente para admitirla, etc.

  • Cancelación de reserva. Si el cliente elimina tu producto de su carrito de GetYourGuide o si expira el tiempo del carrito, GetYourGuide cancelará la reserva pendiente en Ventrata.

  • Reserva. Después de que el cliente haya pagado, GetYourGuide realizará una solicitud a Ventrata para confirmar la reserva (previamente creada) y proporcionará en ese momento la información de contacto del cliente, así como otros detalles, como el precio de venta utilizado, etc.

  • Cancelación de reserva. Si un cliente cancela una reserva en GetYourGuide, GetYourGuide enviará una solicitud de cancelación a Ventrata. Ventrata puede rechazar la solicitud si la reserva ya está canjeada o si tu límite de cancelación no permite cancelaciones; en ese caso, GetYourGuide recurrirá a un proceso de cancelación manual contigo.

  • Cambios de reserva. Si un cliente modifica una reserva en GetYourGuide, GetYourGuide lo hará creando una nueva Reserva y Reserva y luego cancelando la anterior mediante Cancelación de reserva.

Canje

✅ *

Cuando una reserva se canjea (incluso parcialmente) en Ventrata, Ventrata notificará a GetYourGuide al respecto.

Funciona del siguiente modo:

  • Canje de ticket por referencia de reserva. En cuanto alguno de los boletos de una reserva se marque como Canjeado, Ventrata envía una notificación sobre la redención de la reserva a GetYourGuide. Esto puede ayudar a prevenir cancelaciones y reembolsos de reservas ya canjeadas; sin embargo, se sabe que GetYourGuide cancela reservas independientemente de la notificación recibida.

Puntos de recogida

✅ / ❌

Actualmente GetYourGuide no puede obtener la lista de tus puntos de recogida desde Ventrata (estos deben gestionarse manualmente en su Portal); sin embargo, GetYourGuide enviará la información del punto de recogida a Ventrata y Ventrata intentará asignarla al punto de recogida más cercano.

Funciona del siguiente modo:

  • Tendrás que crear la lista de puntos de recogida para cada uno de tus productos/opciones en GetYourGuide utilizando su Supplier Portal.

  • Reserva. GetYourGuide enviará a Ventrata el punto de recogida (travelerHotel) con la solicitud de confirmación de la reserva, si esto aplica a tus productos. Con la API de Google Maps Places, Ventrata intentará emparejarlo con el punto de recogida más cercano que ofrezcas y, además, guardará la ubicación exacta en el campo Hotel de la reserva.

Extras

Actualmente GetYourGuide no admite los complementos Extras cuando se conecta mediante API. Cambios previstos para el Q4 de 2024.

Incluso si configuras los extras manualmente en el Portal de GetYourGuide, esta información no se enviará a Ventrata, lo que provocará problemas en la conexión e informes inexactos. Planeamos añadir esta funcionalidad en el Q4 de 2024; ponte en contacto con nosotros si estás interesado en participar en la beta.

Preguntas personalizadas

Actualmente GetYourGuide no admite preguntas personalizadas cuando está conectado mediante API.

Sin embargo, el personal de GetYourGuide podría configurar algunas preguntas personalizadas para tus productos utilizando sus herramientas internas de administración (GYGAdmin / GYG Catalogue). En ese caso, todas las preguntas personalizadas y sus respuestas de GetYourGuide se guardarán como notas públicas de la reserva en Ventrata.

Recursos

GetYourGuide no puede acceder a los recursos en Ventrata para seleccionarlos.

La asignación de recursos se realizará automáticamente en Ventrata para las reservas de GetYourGuide.


Solución de problemas

Problema

Posibles soluciones

Mis productos de Ventrata utilizan tarifas por tamaño de reserva y los precios no funcionan correctamente en GetYourGuide.

Actualmente GetYourGuide no puede obtener los precios de los productos con tarifas por tamaño de reserva (también conocidas como precios escalonados). Por favor, mapea los productos usando el Método 2 (Supplier Portal) y configura manualmente los precios escalonados en el portal de GetYourGuide para que coincidan exactamente con las tarifas de Ventrata. Contáctanos si necesitas ayuda.

Tengo múltiples reservas con la misma referencia GYG (referencia del reseller) en Ventrata.

Dado que GetYourGuide realiza cambios de reserva creando nuevas reservas con la misma referencia y cancelando las anteriores, no hay de qué preocuparse si todas, salvo una, de las reservas con la misma referencia están canceladas y tienen detalles diferentes; probablemente se trate de modificaciones de GetYourGuide. Si tienes varias reservas confirmadas con la misma referencia, por favor contáctanos.

He mapeado mi producto pero todavía no se puede reservar en el sitio web de GetYourGuide.

Comprueba que tu producto (tour) y la opción estén ambos en estado activo en GetYourGuide y espera 5–10 minutos después del mapeo para que el producto se pueda reservar. Si el problema persiste, contáctanos.


Recursos útiles

  • Autoasignación mediante el Portal de Proveedores de GetYourGuide – Guía paso a paso de GetYourGuide:


Información del socio

GetYourGuide Deutschland GmbH
Sonnenburger Str. 73

10437 Berlín, Alemania

GetYourGuide Tours & Tickets GmbH
Sonnenburger Str. 71-75

10437 Berlín, Alemania


Partner ID 1c1f8e6d-8685-4b17-9275-78ed40d71857

¿Ha quedado contestada tu pregunta?