Invio File Alloggiati Web: come creare il file TXT precompilato (tracciato 2026)
Il tracciato ufficiale del file precompilato per Alloggiati Web spiegato campo per campo: 168 caratteri a posizioni fisse, codici di comuni e stati, regole capo famiglia/membri, errori comuni.
Cédric
Fondateur de ScanStay
La funzione «Invio File» di Alloggiati Web permette di comunicare tutte le schedine del giorno caricando un unico file di testo, invece di ricopiare gli ospiti uno a uno nel modulo del portale. È il metodo più veloce — a condizione di rispettare alla lettera il tracciato imposto dalla Polizia di Stato.
Ecco come funziona, campo per campo, e dove si sbaglia di solito.
Le regole generali del file
- formato TXT, una riga per ogni ospite
- ogni riga è lunga esattamente 168 caratteri, a posizioni fisse
- i campi di testo si completano con spazi fino alla lunghezza prevista
- tra una riga e l'altra: CR+LF (ritorno a capo Windows) — ma non dopo l'ultima riga, o il file viene scartato
- familiari e membri di gruppo vanno immediatamente dopo il loro capo famiglia/gruppo
Il tracciato campo per campo
| Posizione | Lunghezza | Campo |
|---|---|---|
| 1-2 | 2 | Tipo alloggiato (16 singolo, 17 capo famiglia, 18 capo gruppo, 19 familiare, 20 membro) |
| 3-12 | 10 | Data di arrivo gg/mm/aaaa — solo oggi o ieri |
| 13-14 | 2 | Notti di permanenza (max 30) |
| 15-64 | 50 | Cognome |
| 65-94 | 30 | Nome |
| 95 | 1 | Sesso (1 = M, 2 = F) |
| 96-105 | 10 | Data di nascita gg/mm/aaaa |
| 106-114 | 9 | Codice comune di nascita (solo se nato in Italia, altrimenti spazi) |
| 115-116 | 2 | Sigla provincia di nascita (idem) |
| 117-125 | 9 | Codice stato di nascita |
| 126-134 | 9 | Codice cittadinanza |
| 135-139 | 5 | Codice tipo documento — solo singolo/capo, spazi per i membri |
| 140-159 | 20 | Numero documento — idem |
| 160-168 | 9 | Codice luogo di rilascio (comune se italiano, stato se estero) — idem |
Due cose da notare: il documento d'identità è richiesto solo per l'ospite singolo e per il capo famiglia/gruppo (per familiari e membri quei 34 caratteri restano spazi), e i codici di comuni, stati e documenti non sono i codici ISTAT ma tabelle proprietarie della Polizia, scaricabili dalla sezione Supporto Tecnico del portale.
Gli errori che fanno scartare le schedine
- Riga di lunghezza sbagliata — un carattere in più o in meno e la schedina è fuori
- CR+LF dopo l'ultima riga — l'errore più sneaky: il file sembra perfetto ma viene rifiutato
- Codice comune errato — omonimie (quante «Castelnuovo» ci sono?) e comuni soppressi: per un nato in un comune che non esiste più serve comunque il codice storico
- Data di arrivo non valida — il portale accetta solo oggi e ieri; niente dichiarazioni anticipate
- Familiare orfano — un tipo 19/20 che non segue il suo capo fa scartare la riga
- Accenti e caratteri speciali nei nomi — il file va in ASCII: MÀRIO deve diventare MARIO
Dopo il caricamento, il pulsante «Elabora» mostra quante schedine sono corrette e quali sono state scartate (con il motivo). Trasmetti solo quando il conto torna, e scarica sempre la ricevuta.
Excel, Access o generatore?
Tecnicamente il file si può costruire con Excel a colpi di CONCATENA e RIPETI(" "; …), gestendo a mano le tabelle dei codici e togliendo l'ultimo ritorno a capo nel Blocco note. Fattibile — una volta. Farlo ogni sabato sera con il timer delle 24 ore che corre è un'altra storia.
Il nostro generatore di file Alloggiati Web fa esattamente questo lavoro: tabella ospiti con autocompletamento sui codici ufficiali (11.294 comuni inclusi quelli soppressi, 236 stati, 95 tipi di documento), validazione in tempo reale di tutte le regole qui sopra, e download del TXT pronto per «Invio File». L'anteprima è gratuita e i dati degli ospiti non lasciano mai il tuo browser.
Per approfondire
- Alloggiati Web: la guida completa per host — registrazione, scadenze, ricevute
- Sanzioni per omessa comunicazione — cosa si rischia davvero
- Codice CIN affitti brevi — l'altro obbligo del 2026
- E se preferisci delegare tutto, il comparatore dei property manager città per città