API REST para gestores y PMS: integra tus reservas con Partes de Viajeros
Si eres gestor multipropiedad o usas un PMS, ya puedes crear reservas, enviar el check-in y cancelar directamente desde tu software sin tocar el panel. Disponible ahora en Partes de Viajeros.
Para el gestor que trabaja en serio, el panel no es suficiente
Si gestionas diez propiedades, entrar al panel cada vez que llega una reserva tiene sentido. Si gestionas cincuenta, ya es un proceso manual que consume tiempo. Y si tienes un software propio, un PMS o una herramienta de gestión de reservas, lo que necesitas no es otro panel: necesitas que tus sistemas hablen directamente entre sí.
Para eso está la API REST de Partes de Viajeros: una interfaz programática que permite a gestores profesionales y desarrolladores de PMS crear reservas, enviar check-ins y cancelar directamente desde su propio software, sin tocar ningún panel.
🔌 Disponible ahora
La API REST está activa para todas las cuentas de Partes de Viajeros. Genera tu clave de acceso desde Mi cuenta → API REST y empieza a integrar en minutos.
¿Para quién es esta API?
💼 Gestores multipropiedad
Administras viviendas de diferentes titulares con tu propio sistema de reservas y quieres que los partes de viajeros se generen y envíen automáticamente sin intervención manual.
🖥️ Desarrolladores de PMS
Tu software de gestión hotelera o vacacional ya tiene reservas, clientes y calendarios. La API conecta ese flujo con el cumplimiento legal del RD 933/2021 sin que el usuario final deba hacer nada extra.
⚙️ Integradores y agencias digitales
Construyes soluciones para propietarios turísticos y necesitas añadir el módulo de partes de viajeros sin montar infraestructura propia de conexión con SES.hospedajes.
🔄 Channel managers
Recibes reservas de múltiples OTAs y quieres que cada nueva entrada dispare automáticamente el check-in digital y el registro en SES.hospedajes.
Qué puedes hacer con la API
La API v1 cubre el ciclo completo de una reserva:
| Operación | Endpoint | Qué hace |
|---|---|---|
| Listar propiedades | GET /api/v1/establishments | Devuelve todos tus alojamientos con su ID y canal de check-in configurado |
| Crear reserva | POST /api/v1/establishments/{id}/reservations | Crea la reserva, genera el enlace de check-in y lo envía al huésped por email/WhatsApp/SMS |
| Estado de reserva | GET /api/v1/establishments/{id}/reservations/{rid} | Consulta el estado actual: si el huésped completó el check-in y si el parte está enviado a SES |
| Modificar fechas | PATCH /api/v1/establishments/{id}/reservations/{rid} | Actualiza fechas de entrada/salida, régimen o número de huéspedes |
| Cancelar reserva | POST /api/v1/.../reservations/{rid}/cancel | Cancela la reserva y notifica la anulación a SES.hospedajes automáticamente |
Cómo funciona la autenticación
La API usa autenticación por Bearer token: cada cuenta genera una clave única (pw_live_…)
que se incluye en la cabecera de cada petición. No hay OAuth, no hay flujos complejos.
# Ejemplo de petición para crear una reserva
curl -X POST https://partesdeviajeros.com/api/v1/establishments/42/reservations \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"check_in": "2026-09-10",
"check_out": "2026-09-15",
"guests_count": 2,
"guest": {
"first_name": "Ana",
"last_name": "García",
"email": "ana@ejemplo.com"
}
}'
La respuesta incluye el id de la reserva, su estado y
el enlace de check-in (checkin_url) listo para compartir.
Idempotencia: sin reservas duplicadas
Si tu sistema reintenta una petición fallida, la API garantiza que no se crea una reserva duplicada.
Basta con incluir el mismo Idempotency-Key en la cabecera:
si la petición ya se procesó, devuelve exactamente el mismo resultado sin crear nada nuevo.
💡 Recomendación: Usa el ID de reserva de tu propio sistema como Idempotency-Key.
Así, aunque el request se corte o se reintente, siempre obtendrás la misma respuesta.
Modo transparente: check-in sin email de Partes de Viajeros
Por defecto, cuando se crea una reserva vía API, se envía al huésped un email con el enlace de check-in. Si tu PMS ya gestiona la comunicación con el huésped y prefieres enviar tú mismo el enlace, activa el modo transparente desde Mi cuenta → API REST: en ese modo la reserva se crea pero no se envía ningún email automático. El enlace de check-in sigue disponible en la respuesta de la API para que lo uses a tu manera.
Cómo empezar
- Genera tu API key: entra en tu panel → Mi cuenta → pestaña API REST → botón Generar clave de API. La clave solo se muestra una vez; guárdala en un gestor de secretos.
- Explora la documentación interactiva: ve a partesdeviajeros.com/api/v1/docs para ver todos los endpoints con ejemplos de petición y respuesta.
-
Llama a
GET /api/v1/pingpara verificar que tu clave funciona y ver el nombre de cuenta asociado. -
Integra: usa el ID de establecimiento (de
GET /api/v1/establishments) para crear tu primera reserva.
Documentación interactiva de la API
Prueba los endpoints directamente desde el navegador con Swagger UI.
Ver documentación de la API →Preguntas frecuentes
¿Necesito una cuenta de pago para usar la API?
¿La API funciona en Modo Agente (credenciales SES por establecimiento)?
¿Qué pasa si SES.hospedajes no está disponible cuando creo la reserva?
status: "G"
con ses_pending: true para que sepas que el envío a SES
quedó pendiente. El sistema reintentará automáticamente en la siguiente ventana de envíos programados.
¿Puedo tener varias API keys para distintos entornos (test/producción)?
¿Hay rate limiting o límite de peticiones?
¿Te ha resultado útil este artículo?
Prueba Partes de Viajeros gratis y automatiza el envío a SES.hospedajes.
Crear cuenta gratis →Artículos relacionados
Nuestro ecosistema de plataformas
partesdeviajeros.com para pisos, apartamentos turísticos, villas y gestores; partehotel.com para hot...
Partes en Cataluña (Mossos)
Cataluña no usa SES.hospedajes: tiene su propio sistema en el portal MossosHotels. Ahora Partes de V...
🎁Alta gratis en SES.hospedajes
Hacemos GRATIS tu alta en SES.hospedajes, la conexión con partesdeviajeros.com y la sincronización d...