Alloggiati Web: errore nel tracciato record del file
Un errore nel tracciato record di Alloggiati Web vuol dire che una riga del file non ha la forma che il portale si aspetta. Ecco le regole del manuale, campo per campo: lunghezza della riga, spazi, ritorno a capo e codici.
Scopri l’invio automaticoIn breve
Il file per Alloggiati Web è un file di testo in UTF-8 con una riga per ospite, al massimo 1000 righe. Ogni riga ha 168 caratteri, con i campi completati da spazi, e termina con ritorno a capo e avanzamento riga, tranne l’ultima. Una riga di lunghezza sbagliata viene rifiutata.
| Cosa | Regola |
|---|---|
| Codifica | UTF-8 |
| Righe | Una per ospite, al massimo 1000 |
| Lunghezza | 168 caratteri per riga |
| Fine riga | CR + LF, tranne l’ultima riga |
Una riga per ospite, 168 caratteri
Un errore nel tracciato record di Alloggiati Web riguarda la forma del file. Secondo il manuale, il file precompilato, con codifica UTF-8, contiene una riga per ogni alloggiato, per un massimo di 1000 righe, e ogni riga è di 168 caratteri. I campi più corti del loro spazio si completano con spazi bianchi: per esempio un cognome di 5 lettere è seguito da 45 spazi, per arrivare a 50 caratteri.
Alla fine di ogni riga vanno i due caratteri di ritorno a capo (ASCII 13) e di avanzamento riga (ASCII 10), tranne che per l’ultima: con quei due caratteri la riga arriva a 170.
Fonti ufficiali
- Manuale Alloggiati Web per le strutture (PDF, portale)— Paragrafo 12 «File tracciato record», pagine 31-34
Il tracciato, campo per campo
La tabella riporta le posizioni del manuale, che contano da 0. Il tipo di alloggiato è un codice della tabella Tipo Alloggiato del portale: 16 ospite singolo, 17 capo famiglia, 18 capo gruppo, 19 familiare, 20 membro gruppo.
| Campo | Da | A | Caratteri | Contenuto |
|---|---|---|---|---|
| Tipo alloggiato | 0 | 1 | 2 | Codice tabella Tipo Alloggiato |
| Data di arrivo | 2 | 11 | 10 | gg/mm/aaaa, oggi o ieri |
| Giorni di permanenza | 12 | 13 | 2 | Massimo 30 |
| Cognome | 14 | 63 | 50 | Completato da spazi |
| Nome | 64 | 93 | 30 | Completato da spazi |
| Sesso | 94 | 94 | 1 | 1 maschio, 2 femmina |
| Data di nascita | 95 | 104 | 10 | gg/mm/aaaa |
| Comune di nascita | 105 | 113 | 9 | Codice tabella Comuni, se nato in Italia |
| Provincia di nascita | 114 | 115 | 2 | Sigla, se nato in Italia |
| Stato di nascita | 116 | 124 | 9 | Codice tabella Stati |
| Cittadinanza | 125 | 133 | 9 | Codice tabella Stati |
| Tipo documento | 134 | 138 | 5 | Codice tabella Documenti; spazi per familiari e membri |
| Numero documento | 139 | 158 | 20 | Spazi per familiari e membri |
| Luogo di rilascio | 159 | 167 | 9 | Codice Comune o Stato; spazi per familiari e membri |
Fonte: manuale Alloggiati Web per le strutture, paragrafo 12, tabella «Tracciato Record», pagina 34.
Fonti ufficiali
- Manuale Alloggiati Web per le strutture (PDF, portale)— Pagina 34: la tabella del tracciato
- Portale Alloggiati Web — Scarica tabelle— Tabelle Comuni, Stati, Tipo Documento e Tipo Alloggiato
Famiglie e gruppi
Per i familiari e i membri di un gruppo il manuale chiede di lasciare vuoti, con 34 spazi, i tre campi del documento, così che la riga resti di 168 caratteri. Le loro righe seguono quella del rispettivo capo famiglia o capo gruppo.
Fonti ufficiali
- Manuale Alloggiati Web per le strutture (PDF, portale)— Paragrafo 12, pagine 32 e 33
- Famiglie, gruppi e minori nella schedina
Come il portale segnala l’errore
Caricando il file, il portale mostra le schedine corrette e quelle scartate, con il numero di riga dell’errore e il motivo dell’esclusione, come descrive il manuale.
Nel web service, tra gli esempi del manuale dei servizi, una riga della lunghezza sbagliata torna con il codice 11 «SCHEDINA_FORMATO_NON_CORRETTO» e il dettaglio «Dimensione Riga errata».
Fonti ufficiali
- Manuale Alloggiati Web per le strutture (PDF, portale)— Pagina 17
- Manuale del web service Alloggiati Web (PDF, portale)— Paragrafo 3.3, metodo Test, pagina 9
- Errori di Alloggiati Web: come leggerli
Le schedine dal check-in online
Basta che nella scheda Legale della struttura attivi Alloggiati Web con un account per una singola struttura ricettiva, salvi le credenziali della Questura e le verifichi con «Testa connessione». BookCheckin invia la schedina ad Alloggiati Web in automatico a partire dal giorno di arrivo, quando tutti gli ospiti della prenotazione hanno completato il check-in online.
Che cosa BookCheckin non copre in Italia: il CIN, i codici regionali, la comunicazione statistica all’ISTAT o alla Regione e la tassa di soggiorno. Non ti registra nemmeno su Alloggiati Web e non genera le tue credenziali: è un adempimento tuo presso la Questura.
L’obbligo e il termine restano tuoi.
Risorse correlate
- Invio automatico delle schedine ad Alloggiati Web— Come funziona l’invio automatico
Domande frequenti
Quanti caratteri deve avere ogni riga del file?+
168, con i campi completati da spazi; dopo ogni riga, tranne l’ultima, vanno i caratteri di ritorno a capo e avanzamento riga.
Che cosa vuol dire «Dimensione Riga errata»?+
È uno degli esempi di errore del manuale del web service, codice 11: la riga non ha la lunghezza prevista dal tracciato.
Come si scrivono familiari e membri di un gruppo?+
Senza i dati del documento: i 34 caratteri dei tre campi del documento sono spazi, e le loro righe seguono quella del capo famiglia o del capo gruppo.
Continua a esplorare
Alloggiati Web: accesso al portale, schedine e invio automatico dal check-in online
Guida Alloggiati Web · Ultimo aggiornamento: 7 novembre 2026Invio schedine alloggiati alla Polizia: come si fa e entro quando
Guida Alloggiati Web · Ultimo aggiornamento: 7 novembre 2026Credenziali Alloggiati Web: come si richiedono alla Questura
Le schedine partono dal check-in online
Basta che nella scheda Legale della struttura attivi Alloggiati Web con un account per una singola struttura ricettiva, salvi le credenziali della Questura e le verifichi con «Testa connessione». BookCheckin invia la schedina ad Alloggiati Web in automatico a partire dal giorno di arrivo, quando tutti gli ospiti della prenotazione hanno completato il check-in online.
Scopri l’invio automatico