Alloggiati Web es el sistema de la Polizia di Stato para comunicar los datos de los alojados en Italia. Boris usa sus web services SOAP.

1. Habilitar el servicio web

  1. Entrá al portal alloggiatiweb.poliziadistato.it con las credenciales de la estructura (usuario, contraseña, códigos y PUK).
  2. Habilitá la cooperación aplicativa y generá la WSKEY: una cadena alfanumérica única.

La WSKEY es revocable y regenerable desde el portal sin tocar la contraseña. Boris la usa junto al usuario y la contraseña para pedir un token temporal (vale una hora) con el que hace el resto de las llamadas.

2. Importar las tablas de códigos

Este paso no es opcional. Alloggiati no acepta nombres: acepta códigos numéricos de 9 dígitos de sus propias tablas para país, comune de nacimiento y tipo de documento. Sin las tablas importadas no se puede construir ni una línea.

En la pantalla del proveedor, tocá Importar tablas de códigos. Boris descarga lugares, documentos y tipos de alojado, y los guarda para traducir los datos del check-in. Volvé a importarlas cuando la autoridad las actualice.

3. El tracciato record

Una comunicación no es XML ni JSON: es una lista de líneas de 168 caracteres de ancho fijo, una por huésped, con las posiciones absolutas definidas por la Polizia. Un carácter de más corre todos los campos siguientes y la schedina se rechaza entera.

Boris arma cada línea desde la tabla de posiciones publicada, con los acentos transliterados a ASCII (el formato es de un solo byte) y los campos rellenados a su ancho exacto.

  • Huésped solo → tipo 16, lleva sus datos de documento.
  • Primero de un grupo → tipo 17 (capofamiglia), lleva el documento.
  • Resto del grupo → tipo 19, con el bloque de documento en blanco, no en ceros.

4. Estructuras por apartamento

Si tu estructura comunica por apartamento, cargá el ID de apartamento en la configuración. Boris cambia entonces a las operaciones GestioneAppartamenti_* y añade el campo al final del registro.

Comprobar antes de enviar

La operación Test valida las líneas contra la autoridad sin comunicarlas. El botón Comprobar de la cola la usa. Vale la pena en los primeros envíos, cuando el mapeo de códigos todavía puede tener huecos.

Por qué Boris rechaza los envíos parciales

Send acepta solo las líneas correctas y descarta el resto. Boris trata eso como fallo del envío completo: comunicar a la mitad de una familia deja al operador creyendo que cumplió cuando no cumplió.

El acuse

La operación Ricevuta devuelve el PDF de los envíos de una fecha (últimos 30 días, sin contar el día en curso). Se descarga desde la columna de estancias comunicadas.

  1. Open the relevant screen Go to the section where this feature is configured.
  2. Review the required fields Fill in the data that Boris asks for in that screen.
  3. Save and verify Save the changes and check that the feature works as expected.