Para PMS · channel managers · desarrolladores

Tu PMS puede automatizar el registro de viajeros
de todos tus clientes

Con un POST por reserva, tu aplicación crea la reserva en la plataforma del propietario, entrega el link de check-in al huésped desde tu propio sistema y SES.hospedajes recibe el parte automáticamente. El propietario no tiene que entrar al panel para nada.

Ver documentación técnica → Cómo funciona
Flujo de integración

Cuatro pasos, una sola vez

Una vez integrado, cada nueva reserva en tu PMS dispara el ciclo completo de forma automática.

1

El propietario crea su cuenta

Cada propietario se registra en la plataforma que le corresponde según su tipo de alojamiento. El registro es gratuito; el pago es por uso.

2

El propietario genera su API key y te la comunica

Desde Mi cuenta → API REST genera su clave secreta (prefijo pw_live_, ph_live_ o as_live_). La almacenas en tu sistema asociada al establecimiento del cliente.

3

Tu PMS crea reservas con un POST

Por cada nueva reserva, tu sistema hace POST /reservations con la API key del propietario. La plataforma envía el parte a SES.hospedajes y devuelve el checkin_link en la respuesta 201.

4

Tu sistema entrega el link de check-in al huésped

Usas el checkin_link para enviárselo al huésped por email, SMS o el canal que prefieras. En modo transparente, el huésped recibe la comunicación desde tu propio sistema.

Valor para el PMS

Tu PMS añade valor sin gestionar el cumplimiento legal

⚖️

Cumplimiento del RD 933/2021 delegado

El envío a SES.hospedajes, las 28 validaciones previas y el reintento automático si SES falla los gestiona la plataforma, no tu stack. Tú solo haces el POST.

🔒

El coste recae sobre el propietario

Cada parte consume saldo del propietario del alojamiento. El PMS no adelanta ni gestiona ningún coste de SES.hospedajes — solo usa la API key del cliente.

🎨

Experiencia del huésped bajo tu marca

Con modo transparente, el huésped recibe el link de check-in desde tu sistema. El propietario sigue usando la plataforma para consultar y gestionar reservas cuando lo necesita.

Referencia técnica

Lo que necesita saber tu equipo de desarrollo

ParámetroPartes de ViajerosPartehotelAutoSES
API key prefixpw_live_ph_live_as_live_
Base URL/api/v1/establishments/{id}//api/v1/hotel//api/v1/camping/
Campo principalaccommodation_idroom_idparcel_id
Modelo cuentaMulti-establecimientoSingle-hotelSingle-camping
OpenAPI 3.0Ver docs →Ver docs →Ver docs →

Autenticación Bearer token · JSON · Idempotency-Key · Sin rate limit · Catálogo de errores en la OpenAPI

FAQ para integradores

Preguntas frecuentes sobre la integración PMS

¿El PMS gestiona el saldo de SES.hospedajes de sus clientes?
No. El coste de cada parte recae sobre el saldo del propietario del alojamiento, no sobre el PMS. El PMS solo usa la API key del propietario para crear reservas en su nombre.
¿Puede el PMS enviar el link de check-in desde su propio sistema?
Sí. Con el modo transparente activado (o con el campo send_checkin_email: false en el POST), la plataforma no envía ningún email al huésped. El PMS recibe el checkin_link en la respuesta 201 y lo entrega al huésped desde su propio sistema.
¿El huésped sabe que usa checkin-online.es?
Solo si el integrador no activa el modo transparente. Con modo transparente activo, el huésped recibe el link desde el sistema del propietario o del PMS; la comunicación parte del alojamiento, no de las plataformas.
¿Hay entorno sandbox para probar la integración?
No existe sandbox. Las APIs son de producción. Para probar, el propietario puede recargar el mínimo de saldo, crear una reserva de prueba y cancelarla — el saldo se reembolsa automáticamente si el huésped no completó el check-in.
¿Un PMS puede integrar las tres APIs a la vez para distintos tipos de cliente?
Sí. El PMS almacena la API key de cada cliente y elige el endpoint correcto según el tipo de alojamiento: pw_live_ para apartamentos, ph_live_ para hoteles, as_live_ para campings. Cada propietario gestiona su propio saldo.

¿Qué tipo de alojamiento van a integrar tus clientes?

Empieza por la plataforma que corresponde al tipo de alojamiento de tu primer cliente. El registro es gratuito.

Partes de Viajeros — apartamentos Partehotel — hoteles AutoSES — campings

← Volver a la documentación técnica completa  ·  Comparte esta página con los propietarios de tus clientes →