Uso de la API de Pxsol para integraciones de terceros

La API de Pxsol otorga a las aplicaciones de terceros autorizadas acceso de lectura y escritura a los datos de reservas, planes tarifarios, perfiles de huéspedes y configuración de canales de una cuenta Pxsol. Este artículo repasa los principios generales de la conectividad con la API de Pxsol y cómo los módulos de Pxsolmod establecen y mantienen esa conexión.

Autenticación en la API de Pxsol

La API de Pxsol utiliza autenticación mediante clave API. Cada cuenta Pxsol puede generar una o varias claves API desde la sección de administración de la interfaz de Pxsol (habitualmente en Administración → Integraciones → Acceso API). La clave API es una cadena alfanumérica larga que se envía en la cabecera de cada solicitud para que Pxsol pueda identificar la aplicación que llama y la cuenta de la propiedad a la que está autorizada a acceder.

Las claves API de Pxsol suelen poder limitarse a permisos específicos. Los ámbitos habituales incluyen: leer reservas, escribir reservas, leer tarifas, escribir tarifas, leer perfiles de huéspedes, escribir perfiles de huéspedes, leer configuración de canales y leer datos de informes. Las aplicaciones de terceros deben solicitar únicamente los ámbitos mínimos necesarios para su función — un enfoque de mínimo privilegio que limita la exposición si una clave se ve comprometida.

Las claves API deben tratarse como credenciales sensibles. Otorgan acceso completo a la propiedad Pxsol conectada dentro de su ámbito. Deben almacenarse cifradas, transmitirse únicamente por HTTPS y rotarse con regularidad. Cuando conectas un módulo a través de Pxsolmod, tu clave API de Pxsol se almacena cifrada con AES-256 y nunca es accesible en texto plano.

Lectura de datos de reservas desde Pxsol

La API de Pxsol expone endpoints para consultar reservas en un rango de fechas. Una respuesta típica incluye: identificador de reserva, nombre del huésped, fechas de llegada y salida, tipo de habitación, plan tarifario, importe total, estado de pago, canal de origen y datos de contacto del huésped. Estos datos son la base de la mayoría de las integraciones de terceros.

Para módulos como la Ficha de Registro Digital y el CRM de Huéspedes el patrón es: (1) consultar a Pxsol las reservas con llegada en los próximos 14 días; (2) para cada reserva, recuperar el perfil de huésped asociado; (3) procesar los datos del huésped dentro de la función del módulo (por ejemplo, enviar un enlace al portal de prellegada); (4) escribir los datos recogidos de vuelta en la reserva de Pxsol. Los pasos 1 y 2 son operaciones de lectura; el paso 4 es una operación de escritura que requiere el ámbito «escribir reservas» o «escribir perfiles de huéspedes».

Gestión de tarifas mediante la API de Pxsol

La API de Pxsol admite operaciones de lectura y escritura sobre planes tarifarios. Una llamada de escritura típica especifica: el identificador del plan tarifario (tal y como está definido en tu cuenta Pxsol), la fecha o el rango de fechas de llegada, los tipos de habitación y la nueva tarifa. Las actualizaciones de tarifa enviadas por la API se reflejan en el Channel Manager de Pxsol y luego se distribuyen a las OTAs conectadas según el ciclo de actualización estándar de Pxsol.

La distribución de tarifas vía API es la función central utilizada por los módulos de Yield Management RevPAR y Monitorización de Paridad Tarifaria. El flujo es: (1) leer las tarifas y la ocupación actuales de Pxsol; (2) calcular una tarifa recomendada o disparada por reglas; (3) enviar la nueva tarifa a Pxsol vía API; (4) Pxsol distribuye la actualización a los canales conectados. Los pasos 1 y 3 requieren los ámbitos «leer tarifas» y «escribir tarifas» respectivamente.

Integraciones basadas en webhooks y eventos

Además de las llamadas por sondeo, Pxsol admite la entrega de webhooks para determinados eventos de reserva. Una vez configurado en tu cuenta Pxsol (habitualmente en Administración → Integraciones → Webhooks), Pxsol envía un HTTP POST a una URL predefinida cuando ocurren eventos concretos — nueva reserva creada, reserva modificada o check-out completado.

Las integraciones basadas en webhooks las utiliza el módulo CRM de Huéspedes para los flujos post-estancia. Cuando Pxsol dispara un webhook de «check-out completado», el módulo activa inmediatamente la secuencia de correos post-estancia correspondiente sin necesidad de consultar Pxsol cada pocos minutos. Esta arquitectura orientada a eventos reduce el volumen de llamadas a la API y mejora los tiempos de respuesta de las comunicaciones sensibles al tiempo.

Límites de tasa y gestión de las llamadas a la API

Pxsol aplica límites de tasa sobre las llamadas a la API para proteger la plataforma frente a sobrecargas. Superar el límite provoca respuestas HTTP 429 (Too Many Requests). Los módulos de terceros bien diseñados implementan retroceso exponencial cuando reciben errores por límite de tasa y agrupan solicitudes siempre que sea posible en lugar de hacer llamadas individuales noche a noche.

Los módulos de Pxsolmod están construidos para respetar los límites de tasa de Pxsol. Las actualizaciones de tarifa se agrupan siempre que es posible. Los intervalos de sondeo se configuran de forma conservadora. Cuando varios módulos están activos sobre la misma cuenta Pxsol, las llamadas se coordinan para evitar un volumen innecesariamente alto.

Mantener la compatibilidad con los cambios de la API de Pxsol

Pxsol publica actualizaciones periódicas de su API. Algunas añaden nuevos endpoints o campos (cambios no disruptivos); otras pueden dar de baja o modificar endpoints existentes (potencialmente disruptivos para las aplicaciones dependientes). Pxsolmod monitoriza el registro de cambios de la API de Pxsol y prueba cada módulo con cada versión. Cuando se detecta un cambio disruptivo, los módulos afectados se actualizan y se publica un parche de compatibilidad, normalmente en un plazo de 48 horas.