Guía de integración · HeyAndes

Extraer los links de venta desde el POS

Cómo obtener los enlaces públicos de los 3 botones de venta —reservas, buscador y giftcards— para integrarlos luego en el sitio web.

Todos los enlaces cuelgan del dominio del booker: https://heyandes.cl. Solo cambian la ruta y los IDs. Entrá al POS, copiá esos IDs y armá cada URL con las plantillas de abajo.
1

Prerrequisitos

  • Cuenta de acceso al POS con rol de administrador de la agencia (no superadmin). Solicitala al hotel; no compartas credenciales por canales inseguros.
  • Un navegador de escritorio (Chrome, Edge o Firefox).
  • El agencyId del hotel (paso 2). Es el mismo para todos los enlaces.
2

Obtener el agencyId (dato base)

El agencyId identifica a la agencia/hotel y se reutiliza en cada link. Dos formas de conseguirlo:

  • Opción A (recomendada): si el hotel ya tiene booker público, está en su URL: https://heyandes.cl/{agencyId} → todo lo que va después del dominio.
  • Opción B: pedilo al hotel o a soporte de HeyAndes (identificador interno, tipo aBc123…).
3

Extraer los links por tipo

🏷️

Reservas

Actividades, hoteles, programas y alquileres.

🔎

Buscador

Marketplace / portada del hotel.

🎁

Giftcards

Catálogo de tarjetas de regalo.

A) Reservas (actividades, hoteles, programas, alquileres)

  1. En el POS: menú lateral → Servicios (desplegá el submenú).
  2. Entrá a la categoría: Actividades, Hoteles, Programas o Alquileres.
  3. Abrí el servicio específico que querés vender.
  4. Mirá la barra de direcciones: el POS muestra el ID del servicio en su propia URL.
CategoríaURL del POS al abrir el ítemDato que copiás
Actividad/services/agency/{experienceId}experienceId
Hotel (habitación)/services/hotels/{hotelId}/{roomId}roomId
Programa/services/program/{programId}/…programId

Armá el link público de reserva:

https://heyandes.cl/checkout/{agencyId}/{experienceId}
https://heyandes.cl/checkout/{agencyId}/hotel/{hotelId}
https://heyandes.cl/checkout/{agencyId}/program/{programId}
Para reservar una habitación se usa la ruta unificada /checkout/{agencyId}/{roomId} (el roomId que copiaste). La ruta /hotel/{hotelId} solo lista las habitaciones de ese hotel.

B) Buscador (marketplace de la agencia)

No requiere abrir ningún servicio: es la portada/buscador del hotel.

https://heyandes.cl/{agencyId}
https://heyandes.cl/search
https://heyandes.cl/searchReservation

C) Giftcards

  1. En el POS: menú lateral → Giftcards (verificá que el hotel tenga giftcards activas).
  2. El catálogo no necesita un ID: se publica completo.
https://heyandes.cl/checkout/{agencyId}/giftcards
https://heyandes.cl/checkout/{agencyId}/giftcards/{giftcardId}
Si necesitás el link de una giftcard puntual ({giftcardId}) y no aparece en la barra de direcciones, pedilo a soporte de HeyAndes. Para "vender giftcards" en general, basta el link del catálogo.
4

Tabla resumen (plantillas finales)

Botón de ventaPlantilla de URLIDs necesarios
Reserva actividad/habitaciónhttps://heyandes.cl/checkout/{agencyId}/{experienceId}agencyId, experienceId/roomId
Listado de hotelhttps://heyandes.cl/checkout/{agencyId}/hotel/{hotelId}agencyId, hotelId
Programahttps://heyandes.cl/checkout/{agencyId}/program/{programId}agencyId, programId
Buscador (marketplace)https://heyandes.cl/{agencyId}agencyId
Giftcards (catálogo)https://heyandes.cl/checkout/{agencyId}/giftcardsagencyId
5

Verificación (siempre antes de entregar)

  • Abrí cada link en una ventana de incógnito (sin sesión del POS).
  • Confirmá que carga el flujo correcto (la reserva del servicio correcto, el buscador o el catálogo de giftcards).
  • Recordá que el booker es responsive: al embeberlo en el sitio, el layout depende del ancho del iframe, no del navegador.
6

Entregable esperado

Una planilla con, por cada servicio: nombre del servicio · tipo (reserva/buscador/giftcard) · URL final verificada. Esa lista es la que se usará para la integración en el sitio (botones / iframes).

7

Errores comunes

  • El iframe sale en blanco al integrarlo: el dominio destino debe permitir framing (cabeceras X-Frame-Options / CSP frame-ancestors). Si pasa, reportalo a HeyAndes.
  • El link da 404: revisá que copiaste el ID completo desde la barra de direcciones y que el agencyId es el correcto.
  • Confundir hotelId con roomId: /hotel/{hotelId} lista habitaciones; para reservar se usa el roomId.

Guía de integración de botones de venta · heyandes.cl