# checkin-online.es

> Portal matriz del registro automático de viajeros en España. Agrupa tres plataformas SaaS especializadas por tipo de alojamiento que automatizan el envío de partes de viajeros a SES.hospedajes (Ministerio del Interior) y a Mossos d'Esquadra (Cataluña): Partes de Viajeros para apartamentos y casas rurales, Partehotel para hoteles y pensiones, y AutoSES para campings. Pago por uso, sin cuotas mensuales.

Full API reference with code examples: https://checkin-online.es/llms-full.txt

## Páginas principales

- [Inicio](https://checkin-online.es/): comparativa de las tres plataformas y wizard de selección.
- [API REST para desarrolladores y PMS](https://checkin-online.es/api-integracion.html): integración programática de las tres APIs.
- [Integrar tu PMS o channel manager con SES.hospedajes](https://checkin-online.es/integracion-pms-ses-hospedajes.html): guía de integración de PMS y channel managers vía API REST.
- [Cómo pedir a tu software que automatice los partes](https://checkin-online.es/como-pedir-automatizacion-partes-viajeros.html): guía en 3 pasos y plantilla de email para pedir la integración a tu proveedor.
- [Guías](https://checkin-online.es/guias.html): índice de guías técnicas y legales.
- [Obligaciones del RD 933/2021](https://checkin-online.es/obligaciones-rd-933-2021-alojamientos-turisticos.html): resumen legal para alojamientos turísticos en España.
- [Alta en SES.hospedajes paso a paso](https://checkin-online.es/alta-ses-hospedajes-paso-a-paso.html): guía de registro en la plataforma del Ministerio del Interior.
- [Cómo enviar partes de viajeros a SES.hospedajes](https://checkin-online.es/como-enviar-partes-de-viajeros-ses-hospedajes.html): proceso de envío de partes.
- [Check-in online obligatorio en apartamentos turísticos](https://checkin-online.es/check-in-online-obligatorio-apartamento-turistico.html): obligaciones para VUT.
- [Registro de viajeros en hoteles](https://checkin-online.es/registro-de-viajeros-hotel.html): guía específica para hoteles y hostales.
- [Registro de viajeros en albergues](https://checkin-online.es/registro-de-viajeros-albergue.html): guía para albergues juveniles y hostels.
- [Registro de viajeros en campings](https://checkin-online.es/registro-de-viajeros-camping.html): guía para campings y autocaravanas.
- [Partes de viajeros a Mossos d'Esquadra](https://checkin-online.es/parte-de-viajeros-mossos-esquadra.html): guía específica para alojamientos en Cataluña.
- [SES.hospedajes: qué es y cómo funciona](https://checkin-online.es/ses-hospedajes.html): explicación del sistema del Ministerio del Interior.

## API REST para desarrolladores, PMS y agentes multipropiedad

checkin-online.es ofrece tres APIs REST especializadas para que PMS, channel managers y desarrolladores integren el envío automático de partes de viajeros a SES.hospedajes directamente en sus propios sistemas.

### Características comunes a las tres APIs

- Autenticación por Bearer token (API key generada desde Mi cuenta)
- JSON puro, OpenAPI 3.0 en español
- Idempotencia con header `Idempotency-Key` para reintentos seguros
- Envío automático a SES.hospedajes (y Mossos d'Esquadra en Cataluña) en el mismo POST de creación de reserva
- Modo transparente: el huésped nunca sabe que usas checkin-online.es
- Consulta de disponibilidad (GET /availability) antes de crear la reserva
- Ciclo de vida completo de la reserva: G → P → F → E → I → O (y C para canceladas)
- Cancelación con reembolso automático de saldo si el huésped no ha completado el check-in
- Webhooks: notificaciones push firmadas con HMAC-SHA256 (eventos reservation.created, reservation.status_changed, reservation.updated, reservation.cancelled, guest.checked_in, ses.submission_succeeded, ses.submission_failed, webhook.ping; AutoSES y Partehotel añaden balance.low y receipt.sent). Se configuran en Mi cuenta → Integraciones. Entrega at-least-once con deduplicación por id, 8 reintentos con backoff exponencial y 30 días de retención. Cabecera de firma X-Partesdeviajeros-Signature / X-Partehotel-Signature / X-Autoses-Signature. Patrón push (sin polling) para PMS y channel managers.
- Sin rate limit: el coste por uso desincentiva el abuso de forma natural
- Pago por uso: cada reserva consume saldo del propietario (no del PMS ni del integrador)

### API para apartamentos turísticos, VUT, pisos turísticos y casas rurales

- Plataforma: partesdeviajeros.com
- Prefijo de API key: `pw_live_`
- Base URL: `https://partesdeviajeros.com/api/v1/establishments/{id}/`
- Documentación OpenAPI: `https://partesdeviajeros.com/api/v1/docs`
- Modelo: multi-establecimiento (un gestor puede tener N establecimientos bajo una sola cuenta y una sola API key)
- Campo principal: `accommodation_id` (id de la vivienda o habitación)
- Campos de ocupación: `num_adults`, `num_children`
- Campo de canal de origen: `channel` (booking, airbnb, vrbo, directo…)
- Webhooks: notificaciones push firmadas con HMAC-SHA256; cabecera de firma `X-Partesdeviajeros-Signature`; eventos comunes (`reservation.created/updated/status_changed/cancelled`, `guest.checked_in`, `ses.submission_succeeded/failed`, `webhook.ping`).
- Página de información: https://partesdeviajeros.com/api-integracion-alojamientos
- Registro: https://partesdeviajeros.com/registro

### API para hoteles, hostales y pensiones

- Plataforma: partehotel.com
- Prefijo de API key: `ph_live_`
- Base URL: `https://partehotel.com/api/v1/hotel/`
- Documentación OpenAPI: `https://partehotel.com/api/v1/docs`
- Modelo: single-hotel (una cuenta = un hotel; el PMS mantiene una API key por cliente)
- Campo principal: `room_id` (id numérico de la habitación)
- Campo de régimen: `board_plan` (sa=solo alojamiento, ad=alojamiento+desayuno, mp=media pensión, pc=pensión completa, ti=todo incluido)
- Campos de ocupación: `adults`, `children`
- Ámbito: hoteles, hostales, pensiones y apartahoteles de hasta 120 habitaciones
- Webhooks: notificaciones push firmadas con HMAC-SHA256; cabecera de firma `X-Partehotel-Signature`; incluye además de los eventos comunes `balance.low` (saldo bajo) y `receipt.sent` (recibo de estancia emitido).
- Página de información: https://partehotel.com/api-integracion-hotel
- Registro: https://partehotel.com/registro

### API para campings, bungalows y glamping

- Plataforma: autoses.com
- Prefijo de API key: `as_live_`
- Base URL: `https://autoses.com/api/v1/camping/`
- Documentación OpenAPI: `https://autoses.com/api/v1/docs`
- Modelo: single-camping (una cuenta = un camping; el PMS mantiene una API key por cliente)
- Campo principal: `parcel_id` (id de la parcela)
- Campos de ocupación: `adults`, `children`, `pets` (mascotas), `vehicles` (vehículos)
- Campo especial: `license_plates` (array de matrículas de los vehículos)
- Control de acceso por matrícula (ANPR / barrera): `POST /api/v1/camping/access/plate` con `{"plate": "1234ABC"}` devuelve `{"authorized": true|false, "plate": "...", "reservation": {...}}`. Autoriza si la matrícula pertenece a una reserva en estado E (parte enviado) o I (alojado) cuya estancia incluye la fecha de hoy. Permite abrir la barrera del camping automáticamente cuando llega un campista con reserva, sin intervención del personal.
- Webhooks: notificaciones push firmadas con HMAC-SHA256; cabecera de firma `X-Autoses-Signature`; incluye además de los eventos comunes `balance.low` (saldo bajo) y `receipt.sent` (recibo de estancia emitido).
- Página de información: https://autoses.com/api-integracion-camping
- Registro: https://autoses.com/registro

### Endpoints comunes (ejemplo con /hotel/; sustituir por /establishments/{id}/ o /camping/)

| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | /hotel/rooms | Lista habitaciones o parcelas con disponibilidad actual |
| GET | /hotel/availability | Consulta disponibilidad para un rango de fechas |
| POST | /hotel/reservations | Crea reserva y envía parte a SES.hospedajes. Devuelve 201 con `checkin_link` y `status: "P"` |
| GET | /hotel/reservations/{id} | Estado actual de la reserva |
| PUT | /hotel/reservations/{id} | Modifica fechas u ocupantes (solo en estados P o F) |
| POST | /hotel/reservations/{id}/cancel | Cancela la reserva; reembolsa saldo automáticamente si procede |

### Ciclo de vida de una reserva

- **G** (Guardada): reserva creada pero SES.hospedajes no disponible. Sin cobro de saldo. El scheduler reintenta.
- **P** (Pendiente): parte enviado a SES.hospedajes. Check-in pendiente de completar por el huésped. Saldo cargado.
- **F** (Formulario completado): el 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 al alojamiento.
- **I** (Alojado): huésped presente en el alojamiento. Estado automático tras hora de check-in + margen de gracia.
- **O** (Finalizado): estancia completada. Check-out. Se emite recibo al huésped por email.
- **C** (Cancelada): reserva cancelada desde cualquier estado G/P/F/E. El saldo se reembolsa si el huésped no ha guardado datos.

### Casos de uso habituales de la API

- **PMS (Property Management System)**: el PMS crea reservas en nombre de los propietarios. Cada propietario genera su API key y la comunica al PMS. El coste de SES recae sobre el saldo del propietario, no sobre el PMS.
- **Channel managers**: conectan OTAs (Booking, Airbnb, Vrbo…) con SES.hospedajes. Cada reserva entrante desde la OTA se traduce en un POST a la API.
- **Motor de reservas propio de la web del hotel**: el desarrollador integra la API en el formulario de reservas del hotel. Con `send_checkin_email: false` y modo transparente activo, el huésped no percibe que hay un sistema externo.
- **Gestores multipropiedad y agencias**: en Partes de Viajeros, un gestor puede centralizar N propiedades bajo una sola cuenta. En Partehotel y AutoSES, el gestor opera con N API keys (una por cliente) desde su propio back-office.
- **Automatización SES sin panel**: operadores que quieren el cumplimiento del RD 933/2021 sin que el propietario del alojamiento acceda a ningún panel.

## Contexto legal y técnico

- El **Real Decreto 933/2021** obliga a todos los alojamientos turísticos en España a registrar y comunicar los datos de cada viajero a SES.hospedajes antes de las 24 horas siguientes al check-in.
- **SES.hospedajes** es la plataforma del Ministerio del Interior de España para la recepción de partes de viajeros (sustituyó a los libros de registro en papel desde 2025).
- En **Cataluña**, los partes se envían a los **Mossos d'Esquadra** (portal MossosHotels); las tres plataformas lo gestionan automáticamente según el código postal del alojamiento.
- Las multas por incumplimiento del RD 933/2021 son de hasta 30.000 € por infracción grave.
- Los datos de los viajeros deben conservarse durante **3 años**.

## Plataformas hermanas (con sus propios llms.txt)

- [partesdeviajeros.com](https://partesdeviajeros.com) — apartamentos, VUT, pisos turísticos, casas rurales
- [partehotel.com](https://partehotel.com) — hoteles, hostales, pensiones, apartahoteles
- [autoses.com](https://autoses.com) — campings, bungalows, glamping, autocaravanas

## Información legal

- [Aviso legal](https://checkin-online.es/aviso-legal.html)
- [Política de privacidad](https://checkin-online.es/politica-privacidad.html)

## Optional

- [Sitemap XML](https://checkin-online.es/sitemap.xml)
- [robots.txt](https://checkin-online.es/robots.txt)