Alloggiati Web
Integrazione Alloggiati Web
Il Carrubo è dotato di un’integrazione di altissimo livello con il portale Alloggiati Web della Polizia di Stato. Dimentica l’esportazione manuale di file di testo: il sistema comunica direttamente con i server della Questura tramite protocollo SOAP.
Flusso di lavoro
- Compilazione dati: Inserisci i dati degli ospiti o acquisiscili con lo Scanner MRZ.
- Validazione: Il server controlla che tutti i campi rispettino le lunghezze e le regole del tracciato ministeriale.
- Invio Telematico: Invio con un clic. Scegli se fare un invio di “Test” o di “Produzione”.
- Scaricamento Ricevute: Il giorno dopo, con un clic, scarichi le ricevute PDF ufficiali e verifichi automaticamente la correttezza rispetto alle prenotazioni.
Validazione Server-side
Il sistema impedisce l’invio di dati malformati. I controlli includono:
- Tipi di alloggiato (Ospite Singolo, Capo Famiglia, Familiare, Capo Gruppo, Membro Gruppo)
- Codici ISTAT/Belfiore per i comuni e gli stati esteri validi
- Tipologie di documento riconosciute
- Lunghezze massime obbligatorie per il tracciato
Il Tracciato Record (168 caratteri)
Il sistema genera “dietro le quinte” la stringa posizionale a lunghezza fissa richiesta dalla Questura:
00 (Tipo, 2 char) +
YYYYMMDD (Arrivo, 8) +
00 (Notti, 2) +
COGNOME (50) +
NOME (30) +
M/F (Sesso, 1) +
YYYYMMDD (Nascita, 8) +
123456789 (Comune, 9) +
PR (Provincia, 2) +
123456789 (Stato Nascita, 9) +
123456789 (Cittadinanza, 9) +
DOCUM (Tipo Doc, 5) +
123ABC (Num Doc, 20) +
123456789 (Comune Rilascio, 9)
= 168 Caratteri totali
Ambiente di Test
La modalità di Test (attivabile con un toggle sull’interfaccia) richiama l’endpoint WSDL di test della Questura. Utile per assicurarsi che un gruppo complesso passi i controlli prima dell’invio reale.
Stato Invii
L’interfaccia /invii mostra una dashboard con lo storico completo. Gli stati possibili per ogni record sono:
- 🟢 Inviato: Schedina trasmessa con successo.
- 🟡 Override: La validazione locale ha rilevato problemi, ma l’utente ha forzato l’invio.
- 🔴 Errore: Respinto dal sistema centrale (SOAP fault).