Gestores multipropiedad
Administras alojamientos de distintos titulares con tu propio sistema de reservas y quieres que los partes se generen solos.
En resumen
La API REST de Partes de Viajeros permite a gestores multipropiedad, PMS y motores de reservas
crear reservas, enviar el check-in digital al huésped y comunicar automáticamente los partes de viajeros a
SES.hospedajes del Ministerio del Interior, todo desde su propio software, sin intervención manual en el panel.
Auth: Bearer pw_live_… ·
Docs: /api/v1/docs
API REST para motores de reservas
y gestores multipropiedad
Conecta tu PMS, channel manager o motor de reservas directo con Partes de Viajeros en una llamada. Tu software crea la reserva; nosotros enviamos el parte a SES.hospedajes y el enlace de check-in al huésped — sin que el propietario tenga que tocar el panel.
¿Para quién es esta API?
Desarrolladores de PMS
Tu software ya tiene reservas y calendarios. La API conecta ese flujo con el cumplimiento del RD 933/2021 sin que el usuario haga nada extra.
Integradores y agencias
Construyes soluciones para propietarios turísticos y necesitas el módulo de partes de viajeros sin montar infraestructura propia con SES.
Channel managers
Recibes reservas de múltiples OTAs y quieres que cada 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. La jerarquía es multi-establecimiento: un gestor con N propiedades usa una sola API key.
| Operación | Endpoint | Qué hace |
|---|---|---|
| Listar propiedades | GET /api/v1/establishments | Devuelve todos tus alojamientos con su ID y canal de check-in |
| Crear reserva | POST /api/v1/establishments/{id}/reservations | Crea la reserva, la envía a SES y genera el enlace de check-in |
| Estado de reserva | GET /api/v1/establishments/{id}/reservations/{rid} | Estado actual: check-in completado, parte enviado a SES |
| Modificar fechas | PATCH /api/v1/establishments/{id}/reservations/{rid} | Actualiza entrada, salida, régimen o número de huéspedes |
| Cancelar reserva | POST /api/v1/.../reservations/{rid}/cancel | Cancela y notifica la anulación a SES.hospedajes |
Ejemplo: crear una reserva
Una llamada POST crea la reserva, la comunica a SES.hospedajes y envía el link de check-in al huésped:
# Crear una reserva vía API REST
curl -X POST https://partesdeviajeros.com/api/v1/establishments/42/reservations \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: reserva-tu-sistema-789" \
-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"
}
}'
curl -X POST https://partesdeviajeros.com/api/v1/establishments/42/reservations \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: reserva-tu-sistema-789" \
-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 checkin_url listo para reenviar al huésped o incrustarlo en tu propio email:
{
"id": 1891,
"status": "P",
"checkin_url": "https://partesdeviajeros.com/checkin/aBcXyZ",
"ses_pending": false,
"guest_checked_in": false
}
"id": 1891,
"status": "P",
"checkin_url": "https://partesdeviajeros.com/checkin/aBcXyZ",
"ses_pending": false,
"guest_checked_in": false
}
Estados del ciclo de vida
El campo status en la respuesta indica en qué punto del flujo se encuentra la reserva:
G
Guardada — reserva creada; el envío a SES está pendiente (
ses_pending: true). El scheduler reintentará automáticamente.
P
Pendiente de check-in — reserva enviada a SES,
checkin_url activo, huésped aún no ha completado el formulario.
F
Formulario completado — el huésped completó sus datos; el parte está listo para enviar a SES.
E
Parte enviado a SES — el parte de viajeros ya está registrado en SES.hospedajes del Ministerio del Interior; huésped esperado.
I
Alojado — el huésped está alojado (fecha de entrada alcanzada).
O
Finalizada — estancia completada, el huésped ya ha salido.
C
Cancelada — reserva cancelada; la anulación se ha comunicado a SES.hospedajes automáticamente.
Idempotencia: sin reservas duplicadas
Si tu sistema reintenta una petición fallida, la API garantiza que no se crea una reserva duplicada.
Incluye el header Idempotency-Key
con el ID de reserva de tu propio sistema: 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 PMS como Idempotency-Key.
Así, aunque la conexión se corte o el request se reintente, siempre obtendrás la misma respuesta.
Modo transparente
Por defecto, al crear una reserva vía API, el huésped recibe automáticamente el enlace de check-in por email o WhatsApp.
Si tu PMS ya gestiona las comunicaciones con el huésped, activa el modo transparente desde
Mi cuenta → API REST: en ese modo no se envía ningún email automático, pero el
checkin_url
sigue disponible en la respuesta para que lo envíes tú a tu manera.
Modo normal (defecto)
Partes de Viajeros envía el check-in al huésped automáticamente. Ideal para usar la plataforma sin desarrollo adicional.
Modo transparente
Tu software gestiona la comunicación con el huésped. La plataforma no envía ningún email; el checkin_url está en la respuesta.
Cómo obtener tu API key
1. Regístrate o entra
Accede a tu panel de Partes de Viajeros. Si aún no tienes cuenta, el registro es gratuito e incluye 2 partes de prueba.
2. Ve a Mi cuenta → API REST
Abre la pestaña API REST dentro de la sección Mi cuenta del panel de usuario.
3. Genera la clave
Pulsa Generar clave de API. La clave (pw_live_…) se muestra solo una vez: guárdala en un gestor de secretos.
4. Verifica y prueba
Llama a GET /api/v1/ping con tu clave para verificar que funciona. Luego explora la documentación en /api/v1/docs.
Preguntas frecuentes
¿Tiene coste adicional usar la API REST?
No. El acceso a la API está incluido en la suscripción de Partes de Viajeros sin coste extra. Cada reserva creada vía API consume el mismo crédito que una creada desde el panel.
¿Qué ocurre si SES.hospedajes no está disponible cuando creo una reserva?
La reserva se crea igualmente con
status: "G" y ses_pending: true. El sistema reintentará automáticamente en la siguiente ventana de envíos programados (cada ~2 horas), sin que tengas que hacer nada.
¿La API es compatible con el Modo Agente (credenciales SES por establecimiento)?
Sí. Si tu cuenta está en Modo Agente, la API respeta las credenciales SES independientes configuradas por establecimiento: cada reserva se envía a SES.hospedajes con las credenciales del propietario real del inmueble.
¿Hay documentación interactiva para probar los endpoints?
Sí. La documentación Swagger UI está en partesdeviajeros.com/api/v1/docs. Puedes explorar todos los endpoints, ver ejemplos de petición y respuesta, y hacer llamadas de prueba directamente desde el navegador.
¿Más preguntas sobre la API? Ver FAQ completa →
Recursos de la API
Swagger UI
Documentación interactiva completa con ejemplos de petición y respuesta. Prueba los endpoints desde el navegador.
Artículo del blog
Guía detallada sobre la API: casos de uso, flujo de autenticación, idempotencia y modo transparente.
FAQ
Respuestas a las preguntas más comunes sobre la API REST para gestores y PMS.
También te interesa
Descubre más recursos para gestionar tus alojamientos turísticos
❓
Preguntas Frecuentes
Resuelve todas tus dudas sobre precios, funcionamiento y soporte técnico
Ver todas las FAQ →WWW
Web Personal de Reservas
Tu propia web con motor de reservas directas y conexión a tu panel de usuario
Ver detalles →🚀
¿Listo para Empezar?
Regístrate gratis y recibe 2 partes para probar sin compromiso
Comenzar Gratis →