Skip to main content

Descripción

GET /tours devuelve el catálogo de tours publicados en Vulcano Pro.
Este endpoint requiere el permiso tours:read en tu partner. Verifícalo con GET /me.

Parámetros de consulta

Ejemplo

Respuesta (campos principales)

Cada tour incluye datos del catálogo y un arreglo dates con tarifas y salidas (departures) disponibles por día dentro del rango. Solo se incluyen horarios cuya availability sea mayor o igual a passengers. Las tarifas en dates.rates son dinámicas según la configuración del tour: Infante, Niño, Adulto y Adulto mayor. La tarifa infante siempre tiene precio 0. Cada rate incluye price_clp y price_usd. Si el operador no tiene USD configurado (price_usd en "0" / "0.00"), la Partners API calcula price_usd con el tipo de cambio del día (price_clp / exchange). Lo mismo aplica a additional_activities. Cada tour incluye también additional_activities: actividades opcionales que el pasajero puede agregar al reservar (por ejemplo, almuerzo o polera del tour). Cada ítem trae id, name, description, price_clp y price_usd. Además, cada tour incluye policies (texto/HTML de políticas de la empresa) y cancellations_policies (tramos de penalidad por cancelación según días de anticipación al servicio).

Flujo recomendado

1

Listar países

GET /countries
2

Listar zonas

GET /zones?countryId=43
3

Listar categorías

GET /categories
4

Elegir zona, fechas y pasajeros

Usa el id de zona de Vulcano, el rango de viaje y la cantidad de pasajeros (obligatorios). La categoría es opcional.
5

Consultar tours

GET /tours?zone={id}&date_from={YYYY-MM-DD}&date_to={YYYY-MM-DD}&passengers={n}&page=1&per_page=10
6

Reservar

POST /reservations (hold) → POST /reservations/confirm. Ver Reservations.

Precios y markup

Los price_clp / price_usd de GET /tours pueden incluir el markup configurado en tu partner. Al crear un hold, Vulcano guarda el precio del canal (sin markup). Documentación completa en Reservations.

Referencia completa

Consulta la pestaña Referencia API para el esquema completo y el playground interactivo.