Guía técnica de la API de Pxsol
Para administradores y perfiles técnicos que conectan módulos de terceros a Pxsol.
Descripción general
La API de Pxsol es una interfaz REST que permite a las aplicaciones de terceros autorizadas leer y escribir datos en una cuenta de propiedad Pxsol. Cada solicitud debe autenticarse con una clave API generada desde el panel de administración de Pxsol. Las solicitudes se realizan por HTTPS y las respuestas se devuelven en JSON.
Autenticación
Incluye tu clave API de Pxsol en la cabecera X-Api-Key de cada solicitud. Ejemplo: X-Api-Key: <tu-clave-api-pxsol>. Las claves deben mantenerse confidenciales. Si se ven comprometidas, revócalas desde el panel de administración de Pxsol y genera una nueva de inmediato.
Categorías principales de endpoints
- Reservas: operaciones GET/POST/PATCH sobre registros de reserva. Incluye llegada/salida, tipo de habitación, plan tarifario, datos de contacto del huésped, canal de origen, estado de pago.
- Tarifas: GET para recuperar tarifas actuales; POST para enviar actualizaciones por rangos de fechas y tipos de habitación específicos. Necesarios para los módulos Yield Management RevPAR y Monitorización de Paridad Tarifaria.
- Perfiles de huésped: GET del perfil por reserva o por ID de huésped; POST para actualizar perfiles. Necesarios para los módulos Ficha de Registro Digital y CRM de Huéspedes.
- Canales: GET para listar los canales conectados y su estado. Solo lectura; las conexiones de canal se gestionan desde la interfaz del Channel Manager de Pxsol.
- Informes: GET de datos del night audit, el informe de pickup y el resumen de ocupación. Necesarios para los módulos de Facturación Automatizada y Yield Management.
- Webhooks: registra una URL de webhook para recibir notificaciones de eventos (nueva reserva, check-out, cancelación). Necesario para el módulo CRM de Huéspedes.
Límites de tasa
Pxsol aplica un límite de tasa por clave API. Superarlo devuelve HTTP 429. Implementa retroceso exponencial: espera 1s en el primer 429, 2s en el segundo, 4s en el tercero y así sucesivamente. Agrupa las solicitudes por rango de fechas siempre que sea posible en lugar de llamar por noche, para minimizar el volumen de llamadas.
Gestión de errores
| Estado HTTP | Significado | Acción |
|---|---|---|
| 200/201 | Éxito | Procesar la respuesta con normalidad |
| 400 | Solicitud no válida — payload mal formado | Verifica la estructura de la solicitud contra la documentación de la API |
| 401 | No autorizado — clave API no válida | Comprueba que la clave API es correcta y no está revocada |
| 403 | Prohibido — permisos insuficientes | Verifica los ámbitos de la clave API dentro de Pxsol |
| 404 | Recurso no encontrado | Verifica el identificador de reserva o de plan tarifario |
| 429 | Límite de tasa superado | Aplica retroceso exponencial |
| 500/503 | Error del servidor Pxsol | Reintenta a los 60s; contacta con el soporte de Pxsol si persiste |
Entorno de pruebas y sandbox
Pxsol ofrece un entorno sandbox para probar la API en determinados niveles de suscripción. Solicita el acceso a tu gestor de cuenta Pxsol. Pxsolmod ejecuta pruebas de integración contra el sandbox de Pxsol antes de cada publicación de módulo y tras cada aviso de actualización de la API de Pxsol.