Anatomía y composición — Campo a campo

Cómo se compone y se envía un parte de viajeros

Esta página recorre el parte de viajeros tal como lo entiende el sistema receptor: bloque a bloque, campo a campo, con los tipos de dato y los catálogos cerrados que aplican. Si entiendes la anatomía del documento, entiendes también por qué un parte se rechaza, qué hay que corregir y qué nunca debe omitirse. La descripción se basa en el Anexo I del Real Decreto 933/2021 y en las pautas del Manual Técnico de Hospedajes publicado por el Ministerio del Interior.

Tres bloques, una jerarquía

Un parte siempre tiene tres bloques jerárquicos, y siempre en este orden:

1. Bloque establecimiento — identifica quién emite.
2. Bloque contrato — describe la reserva que ampara la estancia.
3. Bloque viajeros — uno por cada persona alojada, repetido tantas veces como sea necesario.

El esquema XML del Manual Técnico modela esta jerarquía como un elemento raíz <Parte> con un hijo <Establecimiento>, un hijo <Contrato> y una lista <Viajeros> con elementos <Viajero> dentro. Cada bloque tiene un conjunto fijo de campos y unos formatos tasados.

Bloque establecimiento

Identifica quién emite el parte. Los campos son cortos pero su corrección es crítica: si el código de establecimiento no coincide con el del titular emisor del envío, SES devuelve un error inmediato.

Bloque contrato

Describe la reserva que ampara la estancia. Cada parte se refiere a uno y solo un contrato; los viajeros dentro del parte comparten todos el mismo contrato.

Bloque viajeros: los 17 campos por persona

Por cada huésped, el parte recoge un conjunto de 17 campos base. En supuestos especiales (documentos múltiples, residencia compuesta, minoría de edad) el conjunto puede ampliarse a 21 o, en casos extremos, 42. Los 17 base son:

El campo más olvidado en envíos manuales es, sin discusión, el número de soporte. Es un código adicional al número del DNI o TIE, impreso en el propio documento (al lado del número de soporte en el DNI 3.0, en el reverso del TIE), que SES usa para validar la autenticidad de la combinación documento + soporte contra la base de datos de la Dirección General de la Policía. Si lo omites, el parte se rechaza con un error específico. Para pasaportes y NIE-papel sin chip, el número de soporte no aplica.

Un fragmento ilustrativo (anonimizado)

Para fijar la estructura, este es un fragmento ilustrativo —no oficial, no apto para envío real— de cómo se vería un parte de viajeros con un viajero adulto extranjero, en formato XML conforme al esquema general del Manual Técnico:

<Parte>
  <Establecimiento>
    <Codigo>H12345678</Codigo>
    <Denominacion>Apartamentos El Mirador</Denominacion>
    <Tipo>APTUR</Tipo>
    <NifTitular>B12345678</NifTitular>
  </Establecimiento>
  <Contrato>
    <Referencia>RES-2026-04211</Referencia>
    <FechaFormalizacion>2026-04-22</FechaFormalizacion>
    <FechaEntrada>2026-05-10T16:30:00</FechaEntrada>
    <FechaSalida>2026-05-17T11:00:00</FechaSalida>
    <NumPersonas>1</NumPersonas>
    <NumHabitaciones>1</NumHabitaciones>
    <TipoPago>PLAT</TipoPago>
    <Importe>735.00</Importe>
  </Contrato>
  <Viajeros>
    <Viajero>
      <Nombre>Anna</Nombre>
      <PrimerApellido>Müller</PrimerApellido>
      <Sexo>F</Sexo>
      <Nacionalidad>DEU</Nacionalidad>
      <FechaNacimiento>1991-03-08</FechaNacimiento>
      <TipoDocumento>PAS</TipoDocumento>
      <NumeroDocumento>CXXXXXXX</NumeroDocumento>
      <Direccion>Müllerstrasse 12</Direccion>
      <Localidad>Berlin</Localidad>
      <PaisResidencia>DEU</PaisResidencia>
      <Movil>+49301234567</Movil>
      <Email>anna.example@example.de</Email>
      <NumViajeros>1</NumViajeros>
      <Rol>VI</Rol>
    </Viajero>
  </Viajeros>
</Parte>

El elemento <Firma> no aparece en el envío a SES: la firma del huésped queda en el archivo interno del host, vinculada al parte por la referencia del contrato. Para envíos múltiples en lote, los partes se agrupan dentro de un elemento contenedor con un identificador de envío.

La firma: dónde, cuándo, por quién

El parte se considera completo desde el punto de vista interno cuando todos los viajeros mayores de 14 años han firmado. La firma no viaja a SES, pero su existencia es exigible y forma parte del archivo trianual del host profesional. Tres soportes son admisibles:

• Firma electrónica capturada en pantalla — el huésped firma con el dedo o con un puntero sobre una tableta en el momento del check-in. El soporte digital se almacena vinculado al parte por la referencia del contrato.
• Firma electrónica reforzada por OTP — el huésped recibe un enlace de pre-check-in en el móvil o el correo, completa los datos antes de la llegada y firma con una confirmación por código OTP. Este soporte deja un sello temporal y es el más defendible ante una eventual inspección.
• Firma manuscrita en papel — el huésped firma un parte impreso al recibir las llaves. El papel queda en el archivo del host. Es válido, pero no exime del envío telemático a SES; el papel no llega al sistema.

Los menores de 14 años no firman: el adulto acompañante firma por ellos, y el campo de relación de parentesco se rellena con el código correspondiente (PADRE, MADRE, TUTOR, ABUELO, etc.).

Las tres vías técnicas de envío

El parte compuesto se envía por una de tres vías técnicas. La elección depende del volumen de estancias y de la capacidad de integración del host.

1. API REST

SES.Hospedajes expone una API REST autenticada con el Certificado FNMT del prestador. Cada parte se envía como una llamada HTTPS con el cuerpo XML (o JSON) y se recibe en respuesta un identificador de comunicación con sello temporal. Es la vía que utilizan los servicios especializados y los PMS hoteleros integrados. Requiere desarrollo o un proveedor que ya lo haya implementado.

2. Carga de fichero

El host genera un fichero XML que contiene uno o varios partes en formato del esquema oficial, lo firma con su Certificado FNMT y lo sube al portal de SES. La plataforma procesa el lote, valida cada parte y devuelve un informe con los aceptados y los rechazados. Es la vía intermedia: útil para volúmenes medios sin desarrollo propio.

3. Formulario web

Para hosts con muy poco volumen, la sede electrónica ofrece un formulario web donde se rellena el parte estancia a estancia. Es la vía más lenta, la que más errores tipográficos introduce y la que peor encaja con el plazo de 24 horas cuando hay varios check-ins en un mismo día.

En el portal de Mossos d'Esquadra (Cataluña), solo están disponibles las dos últimas vías; no hay API pública en la versión actual. Los servicios especializados que cubren Cataluña automatizan la generación del fichero y la subida programada al portal.

Errores frecuentes en los primeros meses de exigencia

Desde diciembre de 2024, los patrones de rechazo en SES.Hospedajes que con mayor frecuencia aparecen son:

• Fechas en formato DD/MM/YYYY en lugar de YYYY-MM-DD.
• Nacionalidades en texto libre (España, French) en lugar del código ISO 3166-1 alfa-3.
• Sexo en texto libre (Hombre, Mujer) en lugar del catálogo cerrado.
• Omisión del número de soporte para huéspedes con DNI o TIE.
• Segundo apellido vacío para huéspedes con DNI.
• Tipo de documento NIE con número en formato incorrecto (sin la X/Y/Z inicial).
• Reservas con menores sin el campo de parentesco poblado.
• Hora de salida anterior o igual a la de entrada (descuido de zona horaria o de día).
• Importe con coma decimal en lugar de punto.

Cada uno de estos errores devuelve un código de rechazo específico. El host debe corregir y reenviar; si el reenvío se sale de las 24 horas, el parte queda fuera de plazo y entra como infracción leve.