# Partehotel

> Software SaaS de gestión para hoteles pequeños, hostales y pensiones en España: habitaciones por plantas con cuadro sinóptico, reservas multi-habitación, optimizador de ocupación, tarifas por categoría y régimen, check-in digital multiidioma y envío automático de partes de viajeros a SES.hospedajes (Ministerio del Interior) y a Mossos d'Esquadra (Cataluña). Pago por uso, sin cuotas mensuales.

Partehotel automatiza el cumplimiento del Real Decreto 933/2021 en hoteles: los huéspedes rellenan el parte de viajeros online en su idioma, la IA escanea el DNI/pasaporte, se aplican 28 validaciones automáticas y el parte se envía directamente a SES.hospedajes. En Cataluña genera el fichero TXT oficial para el portal MossosHotels y lo envía por email listo para subir. Además incluye la gestión completa del hotel: habitaciones por categorías y ocupaciones, reservas con calendario y cuadro sinóptico, búsqueda inteligente de habitación, optimizador de ocupación y tarifas por temporada y régimen.

## Páginas principales

- [Inicio](https://partehotel.com/): visión general del producto y casos de uso.
- [Software de gestión para hoteles](https://partehotel.com/software-gestion-hoteles): habitaciones, reservas, cuadro sinóptico y optimizador de ocupación.
- [Check-in digital y partes de viajeros](https://partehotel.com/partes-viajeros-automaticos): check-in multiidioma con escaneo IA de documentos y envío automático a SES.hospedajes y Mossos.
- [Precios](https://partehotel.com/precios): tarifas de pago por uso, sin cuotas mensuales.
- [Comparativa](https://partehotel.com/comparativa): Partehotel frente al software tradicional de hoteles.
- [Preguntas frecuentes](https://partehotel.com/preguntas-frecuentes): FAQ sobre el RD 933/2021, SES.hospedajes y Mossos.
- [Contacto](https://partehotel.com/contacto): soporte técnico y comercial.

## Blog

- [Alta en SES.hospedajes](https://partehotel.com/blog/alta-ses-hospedajes): guía paso a paso para registrarse en SES.
- [Alta gratis en SES.hospedajes](https://partehotel.com/blog/alta-ses-hospedajes-gratis): el equipo de Partehotel hace el alta por ti sin coste.
- [Partes de viajeros en Cataluña (Mossos)](https://partehotel.com/blog/envio-partes-cataluna-mossos): fichero TXT oficial para MossosHotels.
- [Por qué no enviar los partes a mano desde SES.hospedajes](https://partehotel.com/blog/por-que-no-enviar-ses-hospedajes): riesgos del envío manual.
- [Configurar check-in digital con IA](https://partehotel.com/blog/configurar-check-in-digital): cómo activar el escaneo IA de documentos.
- [Aspectos legales de los alojamientos turísticos](https://partehotel.com/blog/aspectos-legales-alojamiento-turistico): normativa y obligaciones en España.
- [Listado completo del blog](https://partehotel.com/blog): todos los artículos.

## Contexto y datos clave

- Cumplimiento del Real Decreto 933/2021 (registro de viajeros en España).
- Envío automático de partes a SES.hospedajes (Ministerio del Interior).
- En Cataluña: generación del fichero TXT oficial para Mossos d'Esquadra (portal MossosHotels).
- Gestión de hoteles: habitaciones por categoría (Estándar, Superior, Deluxe, Suite junior, Suite de lujo) y ocupación (Individual, Cama doble, 2 camas, Triple, 4 pax), agrupadas por planta (el número de habitación lleva la planta implícita: 203 → planta 2).
- Reservas multi-habitación: grupo familiar con habitaciones vinculadas (grupo_id); 1 parte de viajeros por estancia completa.
- Regímenes: solo alojamiento (sa), alojamiento y desayuno (ad), media pensión (mp), pensión completa (pc), todo incluido (ti). Activables por propietario.
- Tarifas: precio/noche por categoría × ocupación × temporada, suplemento por régimen × categoría × temporada.
- Check-in digital en 6 idiomas: español, inglés, francés, alemán, italiano y portugués.
- Escaneo de DNI/pasaporte con IA y 28 validaciones automáticas antes del envío.
- Archivo legal de los partes durante 3 años.
- Modelo pago por uso: solo se paga por cada parte enviado. Sin permanencia ni cuotas mensuales.
- Saldo de bienvenida gratuito al registrarse.

## API REST para desarrolladores y PMS hoteleros (partehotel.com)

Partehotel ofrece una API REST que permite a motores de reservas, PMS y canales de distribución hotelera integrar la creación de reservas con el envío automático de partes de viajeros a SES.hospedajes, sin que el propietario del hotel tenga que usar el panel.

### Datos técnicos de la API

- **Prefijo de API key:** `ph_live_` (generada desde Mi cuenta → API REST)
- **Base URL:** `https://partehotel.com/api/v1/hotel/`
- **Autenticación:** Bearer token (`Authorization: Bearer ph_live_xxxx`)
- **Formato:** JSON, OpenAPI 3.0 en español
- **Documentación OpenAPI:** `https://partehotel.com/api/v1/docs`
- **Idempotencia:** header `Idempotency-Key` para reintentos seguros
- **Modelo:** single-hotel (1 cuenta = 1 hotel; el PMS usa N API keys, una por cliente)

### Campos específicos del dominio hotelero

- `habitacion_id`: id de la habitación (con su planta implícita en el número)
- `regimen`: código de régimen (`sa`/`ad`/`mp`/`pc`/`ti`)
- `num_adultos` / `num_ninos`: número de adultos y niños
- `grupo_id`: id de grupo para reservas multi-habitación vinculadas (opcional)
- `check_in` / `check_out`: fechas de entrada y salida (formato ISO 8601)
- `holder`: objeto con `name`, `surname`, `email`, `phone` del titular de la reserva
- `send_checkin_email`: booleano (false en modo transparente)

### Endpoints principales

| Método | Endpoint | Descripción |
|--------|----------|-------------|
| GET | /hotel/habitaciones | Lista habitaciones con disponibilidad actual |
| GET | /hotel/disponibilidad | Consulta disponibilidad para un rango de fechas |
| POST | /hotel/reservas | Crea reserva y envía parte a SES.hospedajes. Devuelve 201 con `checkin_link` |
| GET | /hotel/reservas/{id} | Estado actual de la reserva |
| PUT | /hotel/reservas/{id} | Modifica fechas u ocupantes (estados P o F) |
| POST | /hotel/reservas/{id}/cancelar | 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 al hotel
- **I** (Alojado): huésped presente en el hotel
- **O** (Finalizado): estancia completada; recibo emitido al huésped por email
- **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 motor de reservas del hotel gestiona la comunicación. El envío a SES.hospedajes sigue siendo automático. Se puede sobrescribir por reserva con `"send_checkin_email": false`.

### Casos de uso habituales

- **Motor de reservas de la web del hotel:** el desarrollador integra la API en el formulario de reservas; con modo transparente el huésped no sabe que hay un sistema externo
- **PMS hotelero:** crea reservas en nombre del propietario; usa N API keys (una por hotel cliente)
- **Channel manager:** convierte reservas de Booking, Expedia u OTAs en llamadas POST a la API; SES.hospedajes recibe el parte automáticamente
- **Gestión multi-habitación:** crea varias reservas vinculadas por `grupo_id` para estancias familiares; el parte de viajeros cubre a todos los huéspedes del grupo

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

## 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)
- `ph_live_` → partehotel.com (hoteles, hostales, pensiones) — esta plataforma
- `as_live_` → autoses.com (campings)

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

## Información legal

- [Política de privacidad](https://partehotel.com/politica-privacidad)
- [Términos y condiciones](https://partehotel.com/terminos-y-condiciones)
- [Política de cookies](https://partehotel.com/politica-cookies)

## Optional

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