Documentación de la API
API REST para integrar tu sistema con Pxsol Agencias: buscá disponibilidad, cotizá y creá reservas desde tu propia plataforma.
Autenticación
Todos los endpoints piden una API key en el encabezado. La generás desde tu cuenta, en API Pública → Keys y Documentación.
Authorization: Bearer <api-key>Una key puede estar acotada: a ciertos endpoints (si le falta el permiso, la respuesta es 403 con code FORBIDDEN_SCOPE y el permiso que hace falta en required_scope) y a un solo cliente de la agencia (en ese caso sólo ve y opera sus propias reservas; una reserva de otro cliente responde 404). Si no se acotó nada, la key accede a todo.
URL de integración
En los ejemplos, https://BASE-URL es la URL de la API. Te la entregamos junto con tus credenciales cuando activamos el acceso.
Los archivos traen una base de ejemplo: reemplazala por la URL que te damos con tus credenciales (en Postman alcanza con editar la variable base_url).
Entorno de prueba
Antes de integrar contra inventario real, probá con una clave de prueba. La generás desde tu cuenta, en API Pública → Nueva key → Prueba. Empieza con pk_test_ y opera exactamente los mismos endpoints.
Authorization: Bearer pk_test_…- Misma URL y mismas rutas: para pasar a producción cambiás la clave y nada más.
- La disponibilidad es inventada y ninguna reserva llega a un proveedor real. Los rate_token empiezan con sbx:: y sólo los acepta una clave de prueba (y viceversa: una clave real los rechaza con 422).
- Las reservas que crees aparecen en la pantalla de Reservas de tu cuenta, marcadas como prueba, y las podés cancelar desde ahí o por la API. No entran en informes, tesorería ni facturación.
- Los correos al pasajero se envían igual, con [PRUEBA] en el asunto. Usá una dirección tuya.
- Los webhooks disparan normalmente y traen test: true en el cuerpo.
- Todavía no cubre servicios turísticos (/v1/services) ni el área /v1/admin: responden 422 con una clave de prueba.
Casos de error que podés forzar
| Hotel que nunca tiene disponibilidad | 5b000000-0000-4000-8000-000000000004 |
| Tarifa cuyo alta falla en el proveedor | NRF-FAIL |
Hoteles
Búsqueda de disponibilidad
Cotizaciones
Reservas
Admin — Reservas
Pasajeros
Webhooks
Servicios Turísticos
Estado del servicio
Estados de reserva
| Estado | Descripción | Puede ir a |
|---|---|---|
| PENDING | Reserva creada, pendiente de confirmación | CONFIRMED, CANCELLED, CANCELLED_BY_CLIENT, EXPIRED |
| CONFIRMED | Confirmada por la agencia | CANCELLED, CANCELLED_BY_CLIENT, PAID, BLOCKED |
| BLOCKED | Bloqueada por alerta o revisión manual | CONFIRMED |
| PAID | Pago recibido y confirmado | (terminal) |
| CANCELLED | Cancelada por la agencia | (terminal) |
| CANCELLED_BY_CLIENT | Cancelada a solicitud del cliente | (terminal) |
| EXPIRED | Expirada automáticamente por vencimiento del hold | (terminal) |
Planes de comida
| Código | Nombre | Descripción |
|---|---|---|
| RO | Room Only | Solo habitación |
| BB | Bed & Breakfast | Desayuno incluido |
| HB | Half Board | Media pensión (desayuno y cena) |
| FB | Full Board | Pensión completa (desayuno, almuerzo y cena) |
| AI | All Inclusive | Todo incluido |
| UAI | Ultra All Inclusive | Ultra todo incluido |
¿Querés integrarte?
Si ya sos cliente, generá tu API key desde tu cuenta. Si todavía no lo sos, escribinos y te ayudamos a evaluar la integración.
Entrar a mi cuenta