Integración con GetYourGuide

Solnow actúa como proveedor (supplier) de GetYourGuide (GYG). Una vez conectada la integración, GYG consulta disponibilidad en tiempo real contra Solnow, reserva plazas y envía las reservas confirmadas directamente a tu calendario de Solnow como si fueran leads nacidos en tu propio canal.

¿Qué consigues?

• Disponibilidad sincronizada en tiempo real entre Solnow y GYG.
• Reservas confirmadas en GYG creadas automáticamente como leads en Solnow.
• Cancelaciones propagadas desde GYG a Solnow sin intervención manual.
• Precios y horarios tomados directamente de la política de reserva que tú ya usas.

Cómo funciona la conexión

La integración combina dos flujos complementarios:

1. GYG → Solnow (entrada) Cuando un cliente busca disponibilidad o compra en GetYourGuide, GYG llama a los endpoints de proveedor de Solnow en este orden:

1. get-availabilities — GYG pide los huecos disponibles para un rango de fechas.
2. reserve — GYG reserva temporalmente una plaza (token válido 30 minutos) mientras el cliente finaliza el pago en GYG.
3. book — GYG confirma la reserva y Solnow crea el Cliente y el Lead asociado, asignando un barco del pool configurado.
4. Webhook booking.cancelled — si el cliente cancela en GYG, Solnow cancela el lead correspondiente.

2. Solnow → GYG (salida) Cada vez que en Solnow se confirma o cancela una reserva que afecta a un barco vinculado a un producto GYG, Solnow notifica a GYG para que vuelva a consultar disponibilidad. Así, las reservas directas tuyas (teléfono, web, mostrador) bloquean plazas en GYG en cuestión de segundos.

Autenticación

• Los endpoints de proveedor usan Basic Auth con usuario y contraseña que tú defines en Solnow y entregas a GYG.
• El webhook de cancelaciones usa firma HMAC-SHA256 con un secreto compartido (también definido por ti).

El concepto de "mapping"

El vínculo entre ambos sistemas se hace a dos niveles:

En GetYourGuide	En Solnow	Qué aporta
Producto (ID de GYG)	Experiencia	Define el pool de barcos que pueden cumplir la reserva
Horarios y precios del producto	Política de reserva de la experiencia	Aporta precios por temporada, horarios de salida y capacidad
Reserva de GYG	Lead en Solnow	Se crea automáticamente con el GYG Booking Ref para trazabilidad

Un mismo producto de GYG se mapea a una experiencia + una política de reserva de Solnow. Al crear el mapping, Solnow lee la política activa y rellena:

• Precios (adulto, niño, grupo) — tomados de la temporada activa.
• Tipo de producto:
  • time_point — salidas en horarios fijos (slots).
  • time_period — ventana de apertura continua (por ejemplo 10:00–18:00).
• Cutoff — cuántos segundos antes de la salida se cierra la disponibilidad.

Si cambias la política de reserva

Si modificas precios o horarios en la política, debes re-sincronizar el mapping para que GYG reciba los nuevos valores en su próxima consulta de disponibilidad.

Paso 1 — Activar la integración global

Ve a Configuración → Integraciones y busca la tarjeta de GetYourGuide al final de la lista.

Pulsa Configurar para abrir el diálogo de credenciales:

Rellena los tres campos:

• Webhook Secret — Cadena aleatoria que compartirás con GYG. Se usa para verificar que los webhooks de cancelación llegan firmados por GYG.
• Basic Auth Username — Usuario que GYG usará para autenticarse al llamar a los endpoints de proveedor.
• Basic Auth Password — Contraseña correspondiente. Se almacena cifrada; una vez guardada no se muestra, solo se puede sobrescribir.

Marca Active y pulsa Save. A partir de este momento Solnow aceptará peticiones autenticadas de GYG.

Entrega estas credenciales a GYG

El equipo de onboarding de GetYourGuide necesitará el username, la password y el webhook secret, además de la URL de tu instancia Solnow, para terminar la conexión en su lado.

Paso 2 — Mapear una experiencia con un producto de GYG

Abre la experiencia que quieres vender en GYG y entra en la pestaña Canales del menú lateral.

Pulsa Conectar (o Añadir producto si ya existe algún mapping) para abrir el formulario:

Rellena:

• GYG Product ID — Identificador del producto compartido con GetYourGuide. Solnow lo usa como clave para reconocer qué producto está consultando GYG cuando llama a disponibilidad, reserva o booking, y también lo envía de vuelta cuando notifica cambios de disponibilidad. Técnicamente es una cadena libre, pero debe coincidir exactamente con el identificador que GYG tiene registrado para ese producto en su plataforma. Lo habitual es usar el ID que te facilita tu contacto de GYG al dar de alta el producto.
• Nombre del producto — Opcional. Se usa solo como etiqueta interna para distinguir mappings.
• Política de reserva — Selecciona la política de la que se tomarán los precios, horarios y capacidades.
• Activo — Si lo desmarcas, el mapping existe pero Solnow deja de responder disponibilidad para ese producto (útil para pausar ventas temporalmente).

Pulsa Crear. Solnow sincroniza automáticamente los precios y horarios de la política hacia el mapping.

Qué ocurre a partir de aquí

1. GYG consultará disponibilidad periódicamente y recibirá los huecos libres según los barcos del pool de la experiencia.
2. Cuando un cliente compre en GYG, verás aparecer un lead nuevo con referencia GYG Booking Ref en tu calendario de Solnow.
3. Si bloqueas un barco (mantenimiento, reserva manual, etc.), GYG dejará de ofrecer plazas afectadas.
4. Las cancelaciones generadas en GYG se reflejan automáticamente como cancelación del lead en Solnow.

Solución de problemas

GYG no ve disponibilidad

• Comprueba que el mapping está Activo en la pestaña Canales de la experiencia.
• Comprueba que la integración global está Active en Configuración → Integraciones.
• Revisa que la política de reserva tiene una temporada activa cubriendo las fechas consultadas.
• Verifica que el pool de la experiencia tiene al menos un barco con capacidad disponible.

GYG recibe un precio incorrecto

• El precio se toma de la temporada activa de la política de reserva en el momento de crear o actualizar el mapping.
• Si cambiaste precios en la política, edita el mapping (o recréalo) para volver a sincronizar.