Guía técnica
Inicio rápido: tu primer presupuesto en cinco minutos
Pide un precio con IVA, crea la reserva y consulta su estado con tres llamadas.
1. Consigue una clave
La clave de producción la emite el equipo de integraciones cuando hay acuerdo de canal: comisión, modo de precio (público, neto o con descuento) y mercados. Se pide desde la página de acceso y contestamos con la propuesta.
Para integrar sin esperar hay una clave de pruebas (sbx_…) que se pide en el portal y sale al momento: presupuesto real y altas simuladas, durante 30 días.
Además, todo el catálogo es público y sin clave: GET /api/v1/rutas, GET /api/v1/productos, GET /api/mercados y la especificación completa en /api/v1/openapi.json.
2. Pide un presupuesto
El presupuesto es el mismo cálculo que usa la web y el que se cobra al reservar: el precio que enseñas a tu cliente es el que paga.
bash
3. Crea la reserva
POST /api/v1/reservas registra la contratación previa y devuelve el código de seguimiento. La reserva queda atribuida a tu clave sin que tengas que rellenar ningún campo de origen.
Si reservas para un huésped, manda travelsOther, passengerName y passengerPhone: el conductor avisa al pasajero y la factura va a quien contrata (fullName).
4. Sigue el servicio
GET /api/v1/reservas/{code} da el estado, el vehículo, el conductor y, en traslados de aeropuerto, el estado del vuelo. Para no consultar en bucle, pide que se active el aviso saliente a tu sistema (guía de avisos).