GET /disponibilidad
Consulta previa: devuelve si la habitación está libre en el rango de fechas antes de intentar crear la reserva.
Para desarrolladores · Hoteles con web propia
API REST: tu motor de reservas
API REST: tu motor de reservas
→ partes de viajeros automáticos
Tu web ya toma reservas. Con la API REST de Partehotel, cada reserva online genera el parte de viajeros, notifica a SES.hospedajes y devuelve al huésped el enlace de check-in con escaneo IA — sin trabajo manual en recepción.
Sin tarjeta · sin coste adicional · soporte en español
En resumen
- Llama a
POST /api/v1/reservascon los datos de la reserva. - Partehotel envía la notificación a SES.hospedajes y devuelve
url_parte. - Incluye ese enlace en tu email de confirmación al huésped.
- El huésped firma el parte. Tú cumples el RD 933/2021 sin tocar nada.
Referencia rápida
Seis endpoints, todo resuelto
POST /reservas
Crea la reserva, envía a SES.hospedajes y devuelve url_parte para incluirla en el email al huésped.
GET /reservas/{id}
Estado completo de la reserva: estado del parte, url_parte, fechas, habitación y titular.
PUT /reservas/{id}
Modifica fechas, régimen o número de ocupantes mientras la reserva aún no ha sido alojada.
POST /reservas/{id}/cancelar
Cancela y reembolsa el importe al saldo si el huésped no ha completado el parte. Anula también en SES.hospedajes.
GET /habitaciones
Lista todas las habitaciones con su id, categoría, ocupación y plazas para construir el selector de habitación.
Integración en 4 pasos
De la reserva online al parte enviado, sin intervención
1
Genera la clave API
En Mi cuenta → API REST genera el token ph_live_… y entrégalo a tu desarrollador.
Se muestra una sola vez; si se pierde se revoca y genera uno nuevo.
2
Conecta tu motor de reservas
Al confirmar una reserva online, tu sistema llama a POST /api/v1/reservas
con los datos del titular, habitación, fechas y régimen. Añade un Idempotency-Key
para que los reintentos de red no generen duplicados.
3
Partehotel envía a SES y devuelve el enlace
Partehotel notifica a SES.hospedajes con las credenciales del hotel
y responde con url_parte: el enlace de check-in para el huésped.
En caso de fallo de SES, el scheduler reintenta cada 2 horas sin que tengas que hacer nada.
4
El huésped completa el check-in
Incluyes url_parte en tu email de confirmación. El huésped escanea su
documento con la IA, firma en pantalla y el parte queda enviado. Tú cumples el
RD 933/2021 sin abrir el panel.
Integración invisible
Modo transparente: tu marca, no la nuestra
Con el modo transparente activo, Partehotel no envía ningún email al
huésped. Eres tú quien incluye el enlace url_parte en tu propio email de
confirmación: el huésped ve solo tu dominio y tu marca en todo el proceso.
El envío del parte a SES.hospedajes se realiza siempre.
- Sin emails de Partehotel al huésped (ni check-in ni recibo final).
- La copia al propietario sigue llegando si está activada.
- Se activa en un solo clic desde Mi cuenta → API REST.
Referencia técnica
Lo que necesita saber tu desarrollador
Autenticación
Cabecera Authorization: Bearer ph_live_…. Una clave activa por cuenta.
Compatible con cualquier lenguaje o framework que soporte HTTP.
Idempotencia
Cabecera opcional Idempotency-Key. Reintentar la misma llamada con la
misma clave devuelve la respuesta original sin crear reservas duplicadas.
Sin sandbox
La API trabaja en producción. Cancelar una reserva de prueba antes de que el huésped complete el parte reembolsa el importe al saldo automáticamente.
Errores uniformes
Todos los errores siguen el formato {"error":{"codigo","mensaje"}}
con códigos semánticos: saldo_insuficiente, solapamiento,
habitacion_no_encontrada, etc.
Preguntas frecuentes
Dudas de desarrolladores y propietarios
¿En qué lenguajes puedo usar la API?
En cualquiera que soporte HTTP: PHP, Python, JavaScript/Node, Ruby, Go, Java… Solo necesitas
hacer llamadas HTTP con la cabecera Authorization: Bearer ph_live_… y procesar
el JSON de respuesta.
¿La API envía los partes de viajeros a SES.hospedajes automáticamente?
Sí. Al crear la reserva, Partehotel envía la notificación de reserva a SES.hospedajes con las credenciales del propietario antes de confirmar la respuesta. Si SES no responde, la reserva queda en estado guardado y el scheduler reintenta el envío cada 2 horas sin que tengas que intervenir.
¿Funciona para hoteles de Cataluña (Mossos d'Esquadra)?
Sí. Partehotel detecta automáticamente si el hotel es catalán por su código postal. Para Mossos, el fichero TXT oficial se genera y envía al propietario por email para que lo suba al portal MossosHotels, igual que con las reservas del panel.
¿Qué pasa si el saldo es insuficiente al crear una reserva por API?
La API devuelve un error 402 saldo_insuficiente con el importe requerido
y el saldo actual. La reserva no se crea. El propietario debe recargar saldo desde el
panel (Tarifas → Saldo) antes de volver a intentarlo.
¿Puedo crear reservas con varias habitaciones (grupos, familias)?
Sí. Crea la primera reserva con POST /reservas y añade las adicionales
incluyendo el grupo_id devuelto en la primera respuesta. Todas las
reservas del grupo comparten un único parte de viajeros y un único check-in.
¿El propietario puede seguir usando el panel con la API activa?
Sí. Las reservas creadas por API aparecen en el cuadro sinóptico y el calendario del panel exactamente igual que las creadas manualmente. El propietario puede modificarlas, alojar a los huéspedes o cancelarlas desde el panel en cualquier momento.
Empieza a integrar hoy
Crea tu cuenta, genera la clave API
Crea tu cuenta, genera la clave API
y envía el primer parte en minutos
Regístrate gratis, configura tus habitaciones y descarga el manual PDF de la API para tu desarrollador. Saldo de bienvenida incluido, sin tarjeta.
Sin tarjeta · sin cuota mensual · soporte en español
Siga explorando
También le interesa
Más recursos para la gestión de su hotel y el cumplimiento del RD 933/2021
Preguntas frecuentes
Resuelva sus dudas sobre precios, funcionamiento, SES.hospedajes y soporte.
Ver todas las FAQ →Partes automáticos
Envío automático de partes de viajeros a SES.hospedajes y Mossos d'Esquadra.
Conocer más →Precios
Pago por uso transparente, sin suscripciones ni permanencias.
Ver precios →Gestión hotelera
Habitaciones, cuadro sinóptico, tarifas por temporada y optimizador de ocupación.
Descubrir →¿Listo para empezar?
Regístrate gratis y recibe 5€ de saldo para probar sin compromiso.
Comenzar gratis →