Normative
Errori Alloggiati Web: messaggi, codici e come correggere le schedine

In breve
Quasi tutti gli errori di Alloggiati Web nascono da tre cose: una data di arrivo diversa da oggi o ieri, un codice sbagliato (comune, Stato, tipo di documento, preso dalle tabelle ufficiali) o, per chi carica un file, una riga di lunghezza errata (168 caratteri, 174 con l’appartamento). Il portale ti dice quali campi o quali righe correggere e ti lascia inviare le schedine giuste; per una schedina già inviata il manuale non prevede modifiche o annullamenti, quindi va segnalata alla Questura.
Dove compaiono gli errori di Alloggiati Web
Il portale della Polizia di Stato controlla le schedine prima di accettarle, e lo fa in modo diverso secondo come le invii. Capire in quale dei quattro casi ti trovi è il primo passo per risolvere:
| Dove | Come si presenta l’errore | Cosa fai |
|---|---|---|
| Login | «ACCESSO NEGATO», oppure ritorno al login dopo tre codici sbagliati | Controlla credenziali e Scheda dei Codici; vedi la guida alle credenziali |
| Inserimento online | Prima dell’invio il portale segnala con un messaggio i campi da correggere | Correggi i campi e invia; dal riepilogo puoi togliere un ospite e reinserirlo |
| Invio da file | Dopo «Elabora» vedi quante schedine sono corrette e quali righe sono scartate, con il motivo | Invii le corrette e poi ritrasmetti solo quelle sistemate, oppure annulli e reinvii tutto il file |
| Servizi web (gestionali) | Per ogni riga un esito con codice e descrizione dell’errore | Il software corregge la riga; il codice viene dalla tabella TipoErrore |
Se invece il portale non si apre del tutto, il problema non è nei dati: segui la guida Alloggiati Web non funziona, che spiega anche quando si può usare la PEC alla Questura.
Gli errori più comuni e come correggerli
| Errore | Perché succede | Come lo correggi |
|---|---|---|
| Data di arrivo non accettata | Il portale accetta solo la data di oggi o di ieri, perché la schedina va inviata entro 24 ore | Invia lo stesso giorno dell’arrivo; per un ospite arrivato prima contatta la Questura |
| Permanenza fuori limite | I giorni di permanenza vanno da 1 a 30 | Indica i giorni dichiarati all’arrivo, al massimo 30 |
| Luogo di nascita non trovato | Il comune va scelto dalla tabella ufficiale; per i nati all’estero si indica lo Stato, non la città | Digita le prime lettere e scegli dall’elenco; per un ospite nato a Monaco di Baviera scegli GERMANIA |
| Comune «barrato» nell’elenco | La tabella contiene anche i comuni cessati, mostrati barrati | Scegli la voce che corrisponde al documento, controllando di non prendere un comune soppresso per errore |
| Tipo di documento sbagliato | Il tipo va scelto dalla tabella dei documenti (95 voci), es. IDENT, IDELE, PASOR, PATEN | Usa il codice del documento esibito: la carta d’identità elettronica è IDELE, non IDENT. Vedi documenti validi |
| Numero documento rifiutato | Sono ammessi solo lettere, numeri, punto, trattino e barra | Togli spazi e simboli; copia il numero esattamente com’è stampato |
| Cognome o nome rifiutato | Sono ammesse lettere, anche accentate, e l’apostrofo | Togli numeri e simboli; per i caratteri non latini usa la traslitterazione del passaporto |
| Familiare senza capofamiglia | Familiari (19) e membri del gruppo (20) devono essere collegati al capofamiglia (17) o al capogruppo (18) | Inserisci prima il capofamiglia o capogruppo, poi aggiungi gli altri uno alla volta |
| Documento indicato per un familiare | Il documento si indica solo per ospite singolo, capofamiglia e capogruppo | Per familiari e membri del gruppo lascia vuoti i campi del documento |
| Appartamento non trovato | Per le utenze «Gestione Appartamenti» la schedina va collegata a un appartamento attivo | Scegli l’appartamento giusto; se lo avevi disabilitato, va reinserito |
I codici di Alloggiati Web: tabelle ufficiali
Ogni schedina usa quattro tabelle di codifica, che scarichi gratis dalla sezione «Scarica tabelle» del portale in formato CSV. Le stesse tabelle valgono per l’inserimento online, per il file e per i servizi web.
| Tabella | Cosa contiene | Esempi dalla tabella ufficiale |
|---|---|---|
| Tipo alloggiato | 5 codici | 16 ospite singolo, 17 capofamiglia, 18 capogruppo, 19 familiare, 20 membro gruppo |
| Comuni | 11.294 voci, di cui 3.396 comuni cessati con data di fine validità | 412058091 Roma (RM), 403015146 Milano (MI), 415063049 Napoli (NA), 409048017 Firenze (FI) |
| Stati | 236 voci | 100000100 Italia, 100000216 Germania, 100000215 Francia, 100000219 Regno Unito, 100000536 Stati Uniti d’America |
| Documenti | 95 tipi di documento | IDENT carta d’identità, IDELE carta d’identità elettronica, PASOR passaporto ordinario, PATEN patente di guida |
Due regole evitano molti errori. Lo Stato di nascita va sempre indicato, anche per chi è nato in Italia (con il codice dell’Italia), mentre comune e provincia di nascita si compilano solo per i nati in Italia; la provincia usa la sigla delle targhe, con RM per Roma. Il luogo di rilascio del documento è il codice del comune, se il documento è stato rilasciato in Italia, oppure quello dello Stato estero che l’ha rilasciato.
Errori nell’invio da file: il tracciato record
Se carichi un file di testo dal menu «File», il portale lo controlla riga per riga. Il formato è fisso: ogni riga è un ospite e ogni campo ha una lunghezza precisa, da completare con spazi. La guida ufficiale indica la codifica UTF-8 e un massimo di 1.000 righe per file.
| Campo | Caratteri | Note |
|---|---|---|
| Tipo alloggiato | 2 | 16, 17, 18, 19 o 20 |
| Data di arrivo | 10 | gg/mm/aaaa, solo oggi o ieri |
| Giorni di permanenza | 2 | Massimo 30 |
| Cognome | 50 | Completato con spazi (ROSSI + 45 spazi) |
| Nome | 30 | Completato con spazi |
| Sesso | 1 | 1 maschio, 2 femmina |
| Data di nascita | 10 | gg/mm/aaaa |
| Comune di nascita | 9 | Codice della tabella comuni; spazi se nato all’estero |
| Provincia di nascita | 2 | Sigla; spazi se nato all’estero |
| Stato di nascita | 9 | Sempre obbligatorio, anche per l’Italia |
| Cittadinanza | 9 | Codice della tabella Stati |
| Tipo documento | 5 | Solo 16, 17, 18; spazi per 19 e 20 |
| Numero documento | 20 | Solo 16, 17, 18; completato con spazi |
| Luogo di rilascio | 9 | Comune o Stato; spazi per 19 e 20 |
| ID appartamento | 6 | Solo nel «file unico» delle utenze Gestione Appartamenti |
- Riga troppo corta o troppo lunga: un campo non completato con spazi, un carattere in più o una tabulazione al posto degli spazi. Nei servizi web l’esempio ufficiale è l’errore 11 «SCHEDINA_FORMATO_NON_CORRETTO» con dettaglio «Dimensione Riga errata».
- Campo non valido: per esempio una data di arrivo fuori finestra; l’esempio ufficiale è l’errore 12 «SCHEDINA_CAMPO_NON_CORRETTO» con dettaglio «Data di Arrivo Errata».
- Ordine delle righe: familiari e membri del gruppo vanno nelle righe immediatamente successive al loro capofamiglia o capogruppo, con la stessa data di arrivo.
- Ritorno a capo sull’ultima riga: l’ultima riga non deve terminare con CR+LF.
- Esportazioni da Excel: salvare come CSV o con separatori rompe il formato a lunghezza fissa. Il file va generato da un programma che rispetta il tracciato.
Dopo l’elaborazione il portale mostra quante schedine sono corrette e quante scartate, con il numero di riga e il motivo. Se almeno una è corretta puoi inviarle e ritrasmettere poi solo le righe sistemate, oppure annullare tutto e ricaricare il file corretto. Evita di reinviare l’intero file dopo averne già inviato una parte: rischi di trasmettere due volte gli stessi ospiti.
Errori dei servizi web per chi usa un gestionale
I software che inviano le schedine per conto della struttura usano i servizi web SOAP del portale. Per ogni chiamata ricevono un esito con quattro informazioni: esito (vero o falso), ErroreCod, ErroreDes ed ErroreDettaglio; per un elenco di schedine, il numero di schedine valide e l’esito riga per riga. L’elenco completo dei codici è la tabella TipoErrore, che il software scarica con il metodo «Tabella» del servizio.
- Il metodo Test controlla le schedine senza inviarle; il metodo Send le controlla e acquisisce solo quelle corrette.
- Il token di accesso è temporaneo: nell’esempio del manuale scade dopo un’ora e va rigenerato con nome utente, password e WSKEY.
- Se cambi la password del portale devi generare una nuova WSKEY e aggiornarla nel software: si può generare una sola chiave nuova al giorno.
- Un errore di timeout di connessione si risolve, secondo le FAQ, verificando che il software usi l’indirizzo corretto del servizio indicato nel manuale.
Hai inviato una schedina sbagliata: cosa fare
Prima dell’invio puoi correggere tutto: dal riepilogo elimini un ospite e lo reinserisci, oppure annulli la procedura e il portale cancella i dati inseriti. Dopo l’invio il manuale del portale non descrive alcuna funzione per modificare o annullare una schedina, e «Analisi invii» serve solo a vedere i nominativi trasmessi nella giornata. Se ti accorgi di un errore, quindi:
- 01
Verifica cosa è partito
Apri «Analisi invii» lo stesso giorno e controlla i nominativi trasmessi, ordinandoli per nome o per orario.
- 02
Non reinviare d’impulso
Una seconda schedina corretta per lo stesso ospite crea un doppione: prima chiedi alla Questura come preferisce procedere.
- 03
Scrivi alla Questura
Segnala via PEC l’errore con i dati giusti e chiedi come rettificare. Conserva la PEC con le sue ricevute, insieme alla ricevuta del portale di quel giorno.
Un errore materiale corretto subito è molto diverso da una mancata comunicazione: la seconda è la contravvenzione dell’art. 17 TULPS, con arresto fino a tre mesi o ammenda fino a 206 euro. Le conseguenze dei ritardi e delle omissioni sono nella guida alle sanzioni di Alloggiati Web; la ricevuta del giorno resta la prova di cosa hai inviato.
Come evitare gli errori alla radice
- 1Raccogli i dati prima dell’arrivo, direttamente dall’ospite e per tutti i componenti del gruppo, invece di ricopiarli alla consegna delle chiavi.
- 2Controlla il documento: tipo, numero, luogo di rilascio e scadenza, confrontandolo con la persona al momento dell’identificazione.
- 3Invia lo stesso giorno dell’arrivo: così non incontri il limite della data di oggi o di ieri e rispetti le 6 ore dei soggiorni brevi.
- 4Usa le tabelle aggiornate: se il tuo software ha tabelle vecchie, comuni fusi e nuovi tipi di documento generano scarti.
- 5Scarica la ricevuta e verifica il numero di schedine: deve corrispondere agli ospiti arrivati quel giorno.
È quello che fa Maurice: l’ospite completa il check-in online dal browser e carica i documenti di tutto il gruppo, Maurice li raccoglie e li verifica e invia le schedine in automatico, nei tempi previsti; nella dashboard vedi lo stato di ogni invio e le ricevute. Per il quadro completo dell’adempimento parti dalla guida su come inviare le schedine ad Alloggiati Web o dalla guida gratuita ad Alloggiati Web.
Domande frequenti
Perché Alloggiati Web non accetta la data di arrivo?
Perché il portale accetta solo la data di oggi o di ieri: la legge chiede di comunicare gli ospiti entro 24 ore dall’arrivo, ed entro 6 ore per i soggiorni fino a 24 ore. Se l’ospite è arrivato prima, il portale non ti permette più di inserirlo: contatta la Questura.
Come si corregge una schedina già inviata ad Alloggiati Web?
Il manuale del portale non prevede una funzione per modificare o annullare una schedina dopo l’invio. Segnala l’errore alla tua Questura, via PEC, con i dati corretti, e chiedi come vuole che tu proceda prima di reinviare, per non creare doppioni.
Dove trovo i codici di comuni, Stati e documenti?
Nella sezione «Scarica tabelle» del portale Alloggiati Web, in formato CSV: comuni, Stati, documenti e tipi di alloggiato. Per esempio Roma è 412058091, l’Italia 100000100 e la carta d’identità elettronica IDELE.
Cosa vuol dire «Dimensione Riga errata»?
Che una riga del file o dell’elenco inviato dal software non ha la lunghezza prevista: 168 caratteri, o 174 per le utenze «Gestione Appartamenti» con l’identificativo dell’appartamento. Di solito manca il completamento con spazi di un campo, come cognome o numero di documento.
Che codice ha la carta d’identità elettronica su Alloggiati Web?
IDELE, «carta identità elettronica», nella tabella documenti del portale. La carta d’identità cartacea è IDENT, il passaporto ordinario PASOR e la patente di guida PATEN.
Per un ospite nato all’estero cosa metto nel luogo di nascita?
Lo Stato di nascita, dalla tabella degli Stati, lasciando vuoti comune e provincia. Non serve indicare la città estera: per un ospite nato a Lione scegli FRANCIA.
Devo inserire il documento anche dei bambini?
No. Il documento si indica per l’ospite singolo, il capofamiglia e il capogruppo; per familiari e membri del gruppo bastano permanenza e dati anagrafici. Tutti gli ospiti vanno comunque comunicati, bambini compresi.
Il file è stato scartato solo in parte: cosa faccio?
Il portale mostra le righe scartate con il motivo. Puoi inviare subito le schedine corrette e poi ritrasmettere solo le righe sistemate, oppure annullare tutto, correggere il file e reinviarlo intero; non reinviare l’intero file dopo averne inviato una parte.
Quanti ospiti posso inviare con un file?
Secondo la guida ufficiale il file può contenere al massimo 1.000 righe, una per ospite, in codifica UTF-8. Per un singolo appartamento è più semplice l’inserimento online o un software che invia per te.
Un errore nella schedina è sanzionato?
La sanzione dell’art. 17 TULPS riguarda la violazione dell’obbligo di comunicazione, cioè non comunicare o comunicare oltre i termini. Un errore materiale segnalato subito alla Questura è un’altra cosa, ma dati falsi o incompleti possono avere conseguenze: chiedi alla Questura come rettificare e conserva la corrispondenza.
Questo articolo ha carattere informativo generale e non costituisce consulenza legale o fiscale. Le norme cambiano e i regolamenti locali variano: verifica con il tuo commercialista o un professionista prima di agire.
Fonti
- Polizia di Stato — Guida al Servizio Alloggiati Web (manuale utente, PDF)
- Polizia di Stato — Servizi web di Alloggiati Web, manuale per i gestionali (PDF)
- Polizia di Stato — Tabelle di codifica del portale Alloggiati Web
- Polizia di Stato — FAQ del portale Alloggiati Web
- Ministero dell’Interno — DM 7 gennaio 2013, allegato tecnico (PDF dal portale)
- Ministero dell’Interno — DM 16 settembre 2021, tracciati record (PDF dal portale)
Matteo Anzidei · Fondatore di Maurice Assistant
Matteo Anzidei ha fondato Maurice Assistant a Milano per togliere a host e property manager il lavoro ripetitivo: messaggi agli ospiti, check-in, documenti, Alloggiati Web e pagamenti. Scrive guide pratiche su normative e automazione degli affitti brevi.


