# Partes de Viajeros

> Plataforma SaaS de check-in digital y envío automático de partes de viajeros a SES.hospedajes y a la Ertzaintza/Mossos para alojamientos turísticos en España. Pago por uso desde 0,95€/parte, sin cuotas mensuales.

Partes de Viajeros automatiza el cumplimiento de la obligación legal del Real Decreto 933/2021: escaneo de DNI/pasaporte con IA, formularios de check-in multidioma, validaciones automáticas de datos, sincronización con OTAs vía iCal, alertas por WhatsApp y envío directo a SES.hospedajes.

## Páginas principales

- [Inicio](https://partesdeviajeros.com/): visión general del producto, precios y casos de uso.
- [Precios](https://partesdeviajeros.com/precios): tarifas pago por uso, bonos de créditos y comparativa.
- [Software para alojamientos turísticos](https://partesdeviajeros.com/software-alojamientos-turisticos): funcionalidades del SaaS.
- [Partes de viajeros automáticos](https://partesdeviajeros.com/partes-viajeros-automaticos): envío automático a SES.hospedajes.
- [Web personal de reservas](https://partesdeviajeros.com/web-personal): web propia para reservas directas.
- [Vídeo demo](https://partesdeviajeros.com/video-demo): demostración completa del producto.
- [Vídeo escaneo IA](https://partesdeviajeros.com/video-escaneo-ia): demo del escaneo IA de DNI, NIE y pasaportes.
- [Comparativa](https://partesdeviajeros.com/comparativa): comparación con la competencia.
- [Preguntas frecuentes](https://partesdeviajeros.com/preguntas-frecuentes): FAQ sobre el RD 933/2021 y SES.hospedajes.
- [Contacto](https://partesdeviajeros.com/contacto): soporte técnico y comercial.

## Blog

- [Alta en SES.hospedajes](https://partesdeviajeros.com/blog/alta-ses-hospedajes): guía paso a paso para registrarse en SES.
- [Configurar check-in digital con IA](https://partesdeviajeros.com/blog/configurar-check-in-digital): cómo activar el escaneo IA de DNI.
- [Sincronización de calendarios iCal](https://partesdeviajeros.com/blog/sincronizacion-calendarios-ical): conectar Airbnb, Booking y Vrbo.
- [Aspectos legales VUT](https://partesdeviajeros.com/blog/aspectos-legales-alojamiento-turistico): normativa y obligaciones.
- [Listado completo del blog](https://partesdeviajeros.com/blog): todos los artículos.

## Información legal

- [Aviso legal](https://partesdeviajeros.com/aviso-legal)
- [Política de privacidad](https://partesdeviajeros.com/politica-privacidad)
- [Política de cookies](https://partesdeviajeros.com/politica-cookies)
- [Términos de uso](https://partesdeviajeros.com/terminos-uso)

## Contexto y datos clave

- Cumplimiento del Real Decreto 933/2021 (España).
- Envío automático a SES.hospedajes (Ministerio del Interior).
- Envío automático a Ertzaintza (País Vasco) y Mossos (Cataluña).
- Modelo pago por uso: solo se paga por cada parte enviado.
- Precio mínimo desde 0,95€/parte.
- Sin permanencia ni cuotas mensuales.
- Idiomas soportados: español, inglés, francés, alemán, italiano, portugués, holandés, polaco, ruso, chino y árabe.
- Sincronización iCal con Airbnb, Booking, Vrbo y otras OTAs.

## API REST para desarrolladores, PMS y gestores multipropiedad (partesdeviajeros.com)

Partes de Viajeros ofrece una API REST que permite a PMS, channel managers y gestores multipropiedad integrar la creación de reservas en sus alojamientos con el envío automático de partes de viajeros a SES.hospedajes, sin que el propietario tenga que acceder al panel.

### Datos técnicos de la API

- **Prefijo de API key:** `pw_live_` (generada desde Mi cuenta → API REST)
- **Base URL:** `https://partesdeviajeros.com/api/v1/establishments/{id}/`
- **Autenticación:** Bearer token (`Authorization: Bearer pw_live_xxxx`)
- **Formato:** JSON, OpenAPI 3.0 en español
- **Documentación OpenAPI:** `https://partesdeviajeros.com/api/v1/docs`
- **Idempotencia:** header `Idempotency-Key` para reintentos seguros
- **Modelo:** multi-establecimiento (1 cuenta puede tener N establecimientos; el gestor usa 1 API key para todos)

### Campos específicos del dominio apartamentos/VUT

- `accommodation_id`: id de la vivienda o habitación dentro del establecimiento
- `num_adults` / `num_children`: número de adultos y niños
- `channel`: canal de origen de la reserva (booking, airbnb, vrbo, directo…)
- `check_in` / `check_out`: fechas de entrada y salida (formato ISO 8601)
- `holder`: objeto con `name`, `surname`, `email`, `phone` del titular
- `send_checkin_email`: booleano (false en modo transparente)
- `establishment_id`: id del establecimiento (aparece en la URL: `/establishments/{id}/`)

### Endpoints principales

| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | /establishments/{id}/rooms | Lista alojamientos/viviendas del establecimiento |
| GET | /establishments/{id}/availability | Consulta disponibilidad para un rango de fechas |
| POST | /establishments/{id}/reservations | Crea reserva y envía parte a SES.hospedajes. Devuelve 201 con `checkin_link` |
| GET | /establishments/{id}/reservations/{rid} | Estado actual de la reserva |
| PUT | /establishments/{id}/reservations/{rid} | Modifica fechas u ocupantes (estados P o F) |
| POST | /establishments/{id}/reservations/{rid}/cancel | Cancela; reembolsa saldo si el huésped no completó el check-in |

### Ciclo de vida de la reserva

- **G** (Guardada): creada, SES.hospedajes no disponible en ese instante; sin cobro; el scheduler reintenta
- **P** (Pendiente): parte enviado a SES.hospedajes; check-in pendiente de completar; saldo cargado
- **F** (Formulario): huésped rellenó sus datos; parte listo para segundo envío a SES
- **E** (Esperado): parte enviado a SES con datos del huésped; huésped en camino
- **I** (Alojado): huésped presente en el alojamiento
- **O** (Finalizado): estancia completada; recibo emitido al huésped
- **C** (Cancelada): cancelada desde G/P/F/E; saldo reembolsado automáticamente si procede

### Modo transparente

Con el modo transparente activado (Mi cuenta → API REST), las reservas creadas por API no envían emails al huésped (ni enlace de check-in ni recibo). El propietario o PMS gestiona la comunicación desde su propio sistema. El envío a SES.hospedajes sigue siendo automático. Se puede sobrescribir por reserva con `"send_checkin_email": false`.

### Casos de uso habituales

- **Gestor multipropiedad:** gestiona N propiedades bajo una sola cuenta con una sola API key; el `establishment_id` en la URL identifica cada establecimiento
- **PMS para VUT:** crea reservas en nombre de los propietarios; saldo cargado al propietario correspondiente
- **Channel manager:** convierte reservas de Booking, Airbnb, Vrbo en llamadas POST; SES.hospedajes recibe el parte automáticamente
- **Motor de reservas de la web del alojamiento:** con modo transparente, el huésped no sabe que hay un sistema externo

- [Página de documentación API](https://partesdeviajeros.com/api-integracion-alojamientos): descripción completa con ejemplos de código
- [Registro para obtener API key](https://partesdeviajeros.com/registro): cuenta gratuita

## Ecosistema de plataformas hermanas

checkin-online.es es el portal matriz con las tres APIs. Cada plataforma tiene su propio prefijo de clave:
- `pw_live_` → partesdeviajeros.com (apartamentos, VUT, casas rurales) — esta plataforma
- `ph_live_` → partehotel.com (hoteles, hostales, pensiones)
- `as_live_` → autoses.com (campings)

Resumen completo de las tres APIs: https://checkin-online.es/llms.txt

## Optional

- [Sitemap XML](https://partesdeviajeros.com/sitemap.xml)
- [robots.txt](https://partesdeviajeros.com/robots.txt)