Comunicar viajeros a las autoridades en España e Italia de forma automática
La dificultad no es enviar un formulario. Es reunir datos correctos, traducirlos al formato oficial de cada país, cumplir el plazo y poder demostrar qué comunicaciones fueron aceptadas.
Fuentes oficiales
La obligación, en breve
Determinados alojamientos deben identificar a sus huéspedes y comunicar la estancia a la autoridad competente. España e Italia persiguen un objetivo parecido, pero utilizan portales, códigos, credenciales y respuestas diferentes. La configuración debe depender del establecimiento y de su jurisdicción.
El plazo cambia la arquitectura
No puede tratarse como un informe mensual. La comunicación nace del check-in y necesita una cola con reintentos, idempotencia y alertas. Si el proveedor no responde, el sistema debe conservar el intento y volver a ejecutar sin enviar dos veces una comunicación ya aceptada.
Los dos sistemas fallan de forma distinta
Una autoridad puede rechazar un código de municipio; otra, una nacionalidad o tipo de documento. También existen caídas, credenciales vencidas y respuestas parcialmente aceptadas. Guardar solo «enviado» elimina la información necesaria para corregir el caso.
El estado útil distingue pendiente, aceptado, rechazado y pendiente de reintento, con identificador externo y mensaje sanitizado.
Recoger una vez, presentar según la autoridad
Nombre, nacimiento, nacionalidad, documento y estancia deben recogerse una sola vez. Después, cada adaptador convierte esos valores a catálogos oficiales. Los códigos pertenecen a la integración; no deberían aparecer como campos incomprensibles en el formulario del huésped.
Después, borrar lo que ya no hace falta
La imagen usada para leer un documento y los datos legales no tienen necesariamente el mismo periodo de conservación. Tras validar y comunicar, los archivos temporales deben eliminarse según la política configurada. Conservarlos «por si acaso» aumenta el riesgo sin mejorar la operación.
Qué comprobar en cualquier sistema
- ¿Muestra la aceptación por huésped y no solo un estado general?
- ¿Reintenta caídas sin duplicar comunicaciones aceptadas?
- ¿Convierte nacionalidad, documento y municipio a códigos oficiales?
- ¿El check-in manual genera el mismo proceso que el autoservicio?
- ¿Destruye las imágenes cuando dejan de ser necesarias?
Preguntas frecuentes
¿Cuánto tiempo hay para comunicar a un huésped?
El plazo cuenta desde la llegada, no desde la salida. Italia exige actualmente la comunicación en 24 horas, o en seis para estancias de menos de 24 horas, y la obligación es por huésped, no por reserva. Las normas cambian: confirma las vigentes con la autoridad antes de confiar en ninguna implementación.
¿Puede la comunicación ser un proceso nocturno?
No, y ese es justo el sentido del plazo. Un huésped que llega el viernes a las 18:00 no puede esperar a lo que se ejecute el lunes; comunicar en línea y confiar pierde el registro si el endpoint está caído; y mostrar un error no sirve porque quien lo leería ya se ha ido. Lo que exige el plazo es una cola con reintentos al menos cada hora y constancia de qué se envió, cuándo y con qué referencia.
¿Son SES.Hospedajes y Alloggiati Web variantes de una misma integración?
No, y abstraerlas demasiado pronto estropea las dos. SES.Hospedajes es SOAP y los datos viajan como archivo comprimido dentro del sobre; Alloggiati Web pide registros de ancho fijo de exactamente 168 caracteres, donde un campo un carácter más corto desplaza todo lo que sigue. Comparten los valores codificados: nacionalidad, tipo de documento y municipio son listas de la autoridad, así que un huésped que escribe «España» en un campo libre genera un registro rechazado.