Conectar SES.Hospedajes con Boris

SES.Hospedajes es el sistema del Ministerio del Interior por el que se comunican los partes de viajeros en España. Boris usa su servicio web (v3.1.2), no el portal.

1. Darse de alta

1. Registrá la entidad y el establecimiento en la Sede Electrónica del Ministerio del Interior.
2. Del alta salen: el código de arrendador (10 dígitos), el código de establecimiento (10 dígitos) y el usuario y contraseña del servicio web.

El servicio usa autenticación básica HTTP sobre TLS. No hay OAuth ni tokens.

2. Configurar en Boris

Integraciones → Registro de viajeros → SES.Hospedajes:

• Usuario y contraseña del servicio web.
• Código de arrendador y código de establecimiento.
• Entorno: empezá por Test (pre-ses) hasta ver un envío aceptado, después pasá a producción.

Tocá Probar conexión: Boris hace una consulta de lote inexistente. Que la responda con un error de negocio (y no de credenciales) prueba que la autenticación es válida.

3. Qué envía Boris

Cada estancia viaja como una operación de alta (A) de tipo parte de viajeros (PV). El detalle técnico que importa: el cuerpo SOAP lleva un único campo solicitud que no es XML, sino el XML real comprimido en ZIP y codificado en Base64. Boris arma las dos capas.

Dentro van el bloque contrato (referencia, fechas de entrada y salida, número de personas, internet, pago) y un bloque persona por huésped.

Los datos que rechazan un parte

• Segundo apellido: obligatorio si el documento es NIF o NIE. Boris parte el apellido cuando la nacionalidad es española, pero si el huésped tiene un solo apellido cargado hay que completarlo a mano.
• Documento: obligatorio solo para mayores de edad. Los menores se comunican sin documento, y eso es correcto.
• Nacionalidad: se envía en ISO 3166-1 alfa-3 (ESP, ITA, FRA). Boris convierte desde el nombre del país o desde el código de dos letras.

Anulación

Si la reserva se cancela después de haberla comunicado, Boris anula el lote entero con la operación de baja (B). Queda registrado en el expediente.