Integración OCTO para distribución B2B

Bukeer implementa el estándar OCTO (Open Connectivity for Tourism) para que resellers y plataformas externas puedan consultar, reservar y gestionar tus paquetes a través de una API REST.

¿Qué es OCTO?

OCTO es el estándar internacional para conectar plataformas de turismo. Permite que agencias, OTAs y resellers se integren con tu catálogo de paquetes usando un protocolo común, sin desarrollo personalizado.

Cómo funciona

Tu catálogo de paquetes (Bukeer)
        ↓
   API OCTO Gateway
        ↓
Resellers / OTAs / Plataformas externas

Cuando un reseller se conecta:

1. Ve tu catálogo — consulta los paquetes activos con sus versiones y precios
2. Reserva — crea una reserva (hold) que mantiene el paquete disponible
3. Confirma — la confirmación aplica automáticamente el paquete al itinerario
4. Cancela — si es necesario, remueve el paquete del itinerario

Configurar un reseller

1. Ve a Configuración → Integraciones → OCTO API Keys
2. Haz clic en "Crear API Key"
3. Completa:
   • Nombre del reseller: nombre de la empresa o plataforma
   • Email (opcional): contacto del reseller
4. Copia la API Key generada y compártela con el reseller

precaución

La API Key solo se muestra una vez al crearla. Si se pierde, debes crear una nueva.

Ciclo de vida de una reserva

Los paquetes reservados por resellers siguen el estándar OCTO de 7 estados:

Estado	Descripción
ON_HOLD	Reserva temporal — el reseller tiene tiempo para confirmar
CONFIRMED	Confirmada — el paquete se aplicó al itinerario
CANCELLED	Cancelada — el paquete se removió del itinerario
EXPIRED	La reserva expiró sin ser confirmada
REDEEMED	El servicio fue utilizado por el viajero
REJECTED	La reserva fue rechazada
PENDING	En espera de confirmación externa

Reservas internas vs. OCTO

Tanto las reservas internas (desde la UI de Bukeer) como las reservas OCTO generan un registro en el sistema:

Origen	Cómo se crea	Estado inicial
Interno (UI)	Al aplicar un paquete desde la pestaña Items	CONFIRMED (directo)
OCTO (API)	POST /bookings del reseller	ON_HOLD (requiere confirmación)

Esto permite tener un historial unificado de todas las aplicaciones de paquetes, independientemente del origen.

Endpoints disponibles

Método	Endpoint	Descripción
GET	/products	Lista paquetes activos
GET	/products/:id	Detalle de un paquete con versiones
POST	/availability	Consultar disponibilidad
POST	/bookings	Crear reserva (ON_HOLD)
POST	/bookings/:id/confirm	Confirmar reserva
PATCH	/bookings/:id	Actualizar datos de reserva
DELETE	/bookings/:id	Cancelar reserva
POST	/bookings/:id/extend	Extender tiempo de hold
GET	/bookings/:id	Consultar reserva
GET	/bookings	Listar reservas con filtros

Documentación técnica

Para detalles técnicos del API (schemas, autenticación, ejemplos de request/response), consulta la especificación OCTO.