Guida Sistemi Governativi

La registrazione degli ospiti funziona in ogni Paese in cui Vezpa è disponibile, e continua a funzionare. Quello che non è acceso dappertutto è il collegamento automatico con l'autorità: la trasmissione dei dati che hai già registrato.

Dove il collegamento non è ancora attivo, in cima a Configurazione → Registrazione Governo trovi un riquadro informativo che te lo dice: l'invio automatico all'autorità di quel Paese è in fase di test, e la registrazione degli ospiti funziona normalmente. È solo un'informazione: non blocca niente, non c'è niente da confermare o da chiudere, e il riquadro compare anche quando per il tuo Paese non c'è ancora nessun connettore da configurare.

Il riquadro sparisce da solo quando il collegamento del tuo Paese diventa attivo: non devi fare nulla e non serve aggiornare nessuna impostazione. Le sezioni qui sotto descrivono come si configura ciascun sistema; l'avviso dice a che punto è.

Che cosa vuol dire «Configurato»

Nella pagina Configurazione → Registrazione Governo il riquadro in cima porta il nome del sistema del tuo Paese e la parola «Configurato» oppure «Non configurato». Non dipende dal solo salvataggio: «Configurato» vuol dire credenziali salvate e interruttore «Invio automatico» acceso. Con l'interruttore spento la pagina resta su «Non configurato» anche dopo aver compilato tutto, i contatori degli ultimi 30 giorni e il riquadro «Statistiche» non compaiono, e «Testa connessione» risponde che le credenziali non sono configurate.

Le altre sezioni dicono a chi Vezpa dichiara e con quali credenziali. Questa dice quando, perché la decisione è della struttura e la prendi tu: apri Configurazione → Registrazione Governo e nel riquadro «Quando inviare alle autorità» scegli una delle tre cadenze. Vale in qualunque Paese: in Italia comanda le schedine alla Questura (il servizio Alloggiati Web della Polizia di Stato), altrove gli invii del connettore del tuo Paese.

• «Ogni 4 ore» — sei passaggi al giorno. Registri l'ospite e non ci pensi più.
• «Alle 23:15» — un passaggio solo, a fine giornata.
• «Manuale» — parte solo ciò che selezioni e spedisci tu.

Il paniere «Da inviare»

Appena scegli la cadenza manuale, nello stesso riquadro compare la voce «Da inviare»: è il paniere delle prenotazioni in attesa, raccolte per giorno di arrivo. Spunti quelle che vuoi dichiarare e premi «Invia le selezionate». Nelle altre due cadenze la voce non c'è, e non è una mancanza: non c'è niente da scegliere, parte tutto da sé.

Autorizzare non è spedire, e la differenza non è un cavillo. Quando premi, il permesso viene scritto prima della partenza, e una singola pressione può portarsi via solo una parte del lavoro: in quel caso la pagina te lo dice — «autorizzate, ma non ancora partite del tutto» — e ti offre «Completa ora». Ripremi, e riprende da dove si era fermata: non è un errore. Per la stessa ragione a schermo non leggi mai la parola inviata: una prenotazione è «Rilasciata» quando il permesso c'è, e che l'autorità l'abbia davvero accettata lo dice l'esito, uno per uno.

ISTAT e PayTourist seguono la Questura

Qui non c'è niente da decidere e non c'è un secondo interruttore: ISTAT e PayTourist vanno dietro alla Questura, da soli. Se una prenotazione è stata dichiarata alla Questura la dichiarano anche loro; se non lo è stata, non la dichiarano. È così per costruzione, e in manuale ha una conseguenza che conviene sapere prima: una notte che non hai ancora spedito arriva all'ISTAT come alloggio chiuso. Accendi la cadenza manuale solo se sei pronto a spedire con regolarità, altrimenti i tuoi dati di occupazione cambieranno per un motivo che non ha niente a che vedere con i tuoi alloggi.

In manuale la Questura accetta solo oggi e ieri

Non è una nostra scelta, è il portale: Alloggiati Web prende come data di arrivo solo oggi o ieri, e oltre quel confine la schedina viene respinta. Non è una formalità, perché una schedina con una data vecchia è di per sé la dichiarazione di un invio fuori termine. È il motivo per cui il paniere ha una finestra: con la cadenza manuale rimandare di due giorni non è rimandare, è perdere.

Il riepilogo del giorno

Dalla pagina «Da inviare», in alto, si apre il «Riepilogo del giorno»: a che punto sei oggi, in tre numeri — gli «Ospiti del giorno», gli «Autorizzati» e i «Selezionati da spedire». È una pagina in sola lettura: da qui non si aggiunge e non si toglie niente, si torna al paniere con «Aggiungi o togli prenotazioni». Due posti che scrivono lo stesso elenco sarebbero due elenchi diversi.

Le due righe da guardare sono queste, perché sono quelle su cui si agisce:

• Ospiti selezionati che non si possono ancora dichiarare — manca la loro registrazione. Non partiranno: registrali, e rientrano nella dichiarazione.
• Ospiti la cui selezione è uscita dalla finestra — non partiranno, la selezione non si può più togliere, e dall'app non c'è più niente da fare: per quei giorni si passa dal portale dell'autorità. Sono contati a parte dai selezionati, non fra loro, e questo riepilogo è l'unico posto che ancora te li mostra.

La pagina delle credenziali non ha un modulo uguale per tutti. Il sistema non si sceglie: lo decide il Paese della struttura, e la pagina disegna da sola le caselle che quell'autorità pretende. Oltre a quelle comuni — nome utente, password, identificativo della struttura, indirizzo del servizio — ogni Paese dichiara i campi aggiuntivi che la sua autorità richiede, raccolti sotto «Impostazioni aggiuntive»: apri Configurazione → Registrazione Governo e compila quello che vedi. Le etichette di quei campi portano il nome ufficiale che l'autorità gli dà e non sono tradotte, così le ritrovi identiche nel portale da cui copi i valori. Dove l'autorità mette a disposizione un ambiente di prova, trovi anche l'interruttore «Ambiente di prova» per usarlo. Un campo che non vedi non manca per errore: nel tuo Paese non è previsto.

Un segreto già salvato — password, chiave, certificato — non torna mai a schermo: la casella resta vuota e sotto leggi che il valore è già salvato. Lasciarla vuota non lo cancella; per sostituirlo ne scrivi uno nuovo. «Testa connessione» chiama il servizio dell'autorità e ti dice che risponde: non è la prova che le credenziali siano quelle giuste, perché una risposta qualsiasi diversa da un errore del server vale come esito positivo.

C'è poi una cosa che non si immagina: alcune credenziali non sono della struttura, sono del singolo alloggio. Dove l'autorità rilascia un identificativo per ogni esercizio ricettivo, sotto le caselle comuni compare una scheda in più, Credenziali per alloggio. Scegli l'alloggio dal menu e compili solo ciò che cambia per quello: quello che lasci vuoto usa il valore della struttura, e non va ripetuto. Se quella scheda non compare, per il tuo Paese non serve e tutto vale per l'intera struttura.

Se l'account ha più proprietà, nel menu della scheda trovi prima una voce per ogni proprietà, «Tutti gli alloggi di …»: le credenziali che salvi lì vengono scritte su ognuno dei suoi alloggi. Serve quando l'autorità ti ha dato un identificativo per indirizzo e non uno per appartamento: lo inserisci una volta sola, e puoi sempre correggere un singolo alloggio scegliendolo dal menu.

Tutte le strutture ricettive italiane sono obbligate a comunicare i dati degli ospiti alla Questura tramite il servizio Alloggiati Web della Polizia di Stato. Vezpa manda le schedine da solo: non nell'istante in cui registri l'ospite, ma al primo dei passaggi automatici che girano ogni mezz'ora.

La finestra è stretta per legge, non per scelta nostra: Alloggiati Web accetta come data di arrivo solo oggi o ieri. Per questo Vezpa non recupera i giorni più vecchi da solo — una schedina con una data vecchia verrebbe scartata, e mandarla metterebbe agli atti che quei giorni erano scoperti.

Come ottenere le credenziali

1. Registrati su alloggiatiweb.poliziadistato.it
2. Presenta la richiesta di attivazione presso la tua Questura locale
3. Ricevi le credenziali via email: Username, Password e Token WS
4. Inserisci le credenziali in Vezpa: Configurazione → Alloggi → l'alloggio → Alloggiati (Questura)
5. Accendi l'interruttore «Abilitato» e salva

Flusso automatico

Campi obbligatori Questura

Campo	Descrizione
Cognome, Nome	Dati anagrafici dell'ospite
Sesso	M / F (obbligatorio solo per Italia)
Data e luogo di nascita	Con codice ISTAT del comune
Cittadinanza	Codice paese Alloggiatiweb
Tipo e numero documento	95 tipi disponibili (passaporto, CI, etc.)
Tipo alloggiato	Ospite singolo (16), Capofamiglia (17), Capogruppo (18)

L'Italia ha venti sistemi regionali diversi per la raccolta dei dati statistici sul turismo. Vezpa li gestisce tutti: diciassette in modo completamente automatico, tre con il download di un file da caricare a mano sul portale della regione.

Regioni con invio automatico (diciassette)

Per queste regioni Vezpa invia i dati da solo, una volta al giorno, alle quattro del mattino nel fuso della struttura. Non si dichiara il giorno appena finito: si dichiara il giorno di cinque giorni prima, per lasciare il tempo a uno spostamento di alloggio di sedimentarsi prima di essere trasmesso. Ti servono solo le credenziali regionali.

ID	Regione	Protocollo	Credenziali
0	Piemonte	SOAP v2	Username + Password
1	Toscana	SOAP v2	Username + Password
2	Basilicata	SOAP v1	Username + Password
3	Liguria	SOAP v2	Username + Password
4	Abruzzo	SOAP v2 (Turismo5)	Username + Password
5	Veneto	SOAP v2	Username + Password
6	Emilia-Romagna	SOAP v2	Username + Password
7	Marche	ROSS1000	Username + Password
8	Lombardia	Turismo5	Username + Password
9	Calabria	SOAP v2	Username + Password
10	Sardegna	ROSS1000	Username + Password
11	Lazio	ROSS1000	Username + Password
12	Molise	ROSS1000	Username + Password
13	Sicilia	REST XML	PMS User + HotelCode
14	Campania	REST JSON (Sinfonia)	CUSR + API Key
17	Trentino	SOAP DTU C59	Username + Password
19	Valle d'Aosta	SOAP VIT (INVA)	Utente + Password + ID Struttura

Regioni con download file (tre)

Per queste regioni, Vezpa genera il file che dovrai scaricare dall'app e caricare manualmente sul portale regionale.

ID	Regione	Formato	Portale di upload
15	Umbria	TXT (ROSS 1000)	Turismatica
16	Friuli Venezia Giulia	TXT (ROSS 1000)	WebTur
18	Puglia	XML (SPOT)	www.dms.puglia.it (SPID)

Come configurare l'ISTAT

1. Apri Configurazione → Alloggi dalla Direzione, menu con i tre puntini, e tocca l'alloggio
2. Apri la sezione «ISTAT» e accendi l'interruttore «Abilitato»
3. Scegli la tua «Regione» dal menu a tendina
4. Inserisci le credenziali fornite dal portale regionale
5. Inserisci il «Codice ISTAT» della struttura
6. Salva. Il primo invio automatico parte al passaggio notturno successivo

PayTourist è una piattaforma opzionale che automatizza la raccolta e il versamento della tassa di soggiorno per molti comuni italiani. Vezpa si integra direttamente con PayTourist per inviare i dati degli ospiti, con lo stesso passaggio notturno dell'ISTAT e lo stesso giorno di riferimento: cinque giorni prima.

Credenziali necessarie

Campo	Dove ottenerlo
ID PayTourist	Registrazione su paytourist.it (self-service)
Token API	Dashboard PayTourist dopo la registrazione

La firma digitale viene raccolta sia dall'app Flutter (durante la registrazione dell'ospite) sia dal self check-in web (canvas touch). La firma viene salvata come immagine PNG nel profilo dell'ospite.

La firma dell'ospite si propone solo nei Paesi in cui la legge la prevede sul modulo di registrazione: Germania, Austria, Francia e Spagna. Anche lì è facoltativa — nell'app e nel check-in online — perché l'ospite può firmare il modulo su carta all'arrivo; in nessun Paese la firma viene trasmessa all'autorità, serve alla struttura come prova. Negli altri Paesi la sezione della firma non compare e, dove Vezpa sa produrre il modulo, il PDF si genera lo stesso, con la riga da firmare su carta.

Il modulo si genera dal dettaglio della prenotazione toccando «Documento registrazione»: esce già compilato con i dati dell'ospite, nella lingua del Paese della struttura, pronto da far firmare e conservare. Il pulsante compare da solo dove Vezpa sa produrre il modulo, e resta disattivato — con un messaggio che lo spiega — finché il responsabile della prenotazione non è registrato.

Per le strutture situate in uno dei paesi qui sotto, Vezpa può inviare automaticamente i dati degli ospiti al sistema governativo nazionale. La configurazione si trova in Configurazione → Registrazione Governo, e la pagina esiste solo per questi paesi: altrove dice che nessun connettore è disponibile, e non è un guasto. Se per il tuo Paese il collegamento non è ancora attivo, l'app te lo dice con un avviso in cima alla pagina: vedi A che punto è il collegamento.

Quando parte l'invio. Non quando registri l'ospite: ci pensano due passaggi automatici. Per i registri di polizia una passata ogni ora raccoglie gli ospiti registrati di recente; per i sistemi statistici una passata una volta al giorno. La spedizione vera e propria parte poi entro mezz'ora. L'interruttore «Invio automatico» comanda tutto: spento, non parte niente.

🇪🇸 Spagna — SES.Hospedajes

Obbligatorio dal 2 dicembre 2024 (Real Decreto 933/2021). Registro de viajeros presso il Ministerio del Interior.

Credenziale	Dove ottenerla
API Key	seshospedajes.es (self-service)
Establishment ID	Portale SES dopo registrazione struttura

🇭🇷 Croazia — eVisitor

Sistema telematico nazionale gestito dalla Hrvatska turisticka zajednica (HTZ).

Credenziale	Dove ottenerla
Username + Password	evisitor.hr (self-service)
API Key	Portale eVisitor dopo registrazione
Facility Code	Assegnato alla registrazione

🇭🇺 Ungheria — NTAK

Sistema nazionale NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa si connette tramite l'intermediario NTAK.guru per semplificare l'integrazione.

Credenziale	Dove ottenerla
Bearer Token	ntak.guru (self-service)
Accommodation ID	Portale NTAK.guru dopo registrazione

NTAK è il sistema statistico. Per la parte di polizia l'Ungheria ha un secondo sistema, VIZA, che non si accende da solo: si configura a parte, con credenziali proprie, e chi non lo fa resta col solo NTAK.

🇵🇹 Portogallo — SIBA

Boletim de Alojamento obbligatorio ai sensi della Lei n.º 23/2007 (art. 15-16).

Credenziale	Dove ottenerla
Username + Password	siba.ssi.gov.pt
Codice Estabelecimento	Registrazione SIBA

🇨🇿 Repubblica Ceca — UbyPort

Registro stranieri obbligatorio gestito dalla Cizinecká policie (Polizia per gli Stranieri).

Dal 9 ottobre 2026 Vezpa è approvato dalla polizia ceca (Ředitelství služby cizinecké policie, RSCP) come programma per l'invio automatico dei dati degli ospiti stranieri a UbyPort. L'invio parte da solo, con la passata oraria. Se a un ospite mancano dati o la polizia rifiuta una scheda, ricevi la notifica «Verifica dati ospite» con il nome dell'ospite e il motivo: la scheda rifiutata non viene ritentata da sola, ma rinviata dopo che hai corretto i dati.

Credenziale	Dove ottenerla
Username + Password	Account per l'invio robotico dei dati (účet pro robotické zasílání dat), rilasciato da RSCP
IDUB	Assegnato da RSCP alla registrazione della struttura
Zkratka	Sigla della struttura, assegnata insieme all'IDUB (facoltativa, consigliata)

Come si ottiene l'account. Non viene creato in automatico; i casi sono tre:

• Hai già un account robotico (per esempio usato con un altro gestionale): con la polizia non devi fare nulla, l'account è trasferibile. Inserisci in Vezpa le credenziali che hai.
• Hai l'IDUB ma non l'account robotico: scrivi a RSCP tramite datová schránka (ID ybndqw9) o via e-mail a [email protected] chiedendo un account per l'invio robotico dei dati. Indica IDUB, nome e indirizzo completo della struttura, il produttore e il nome del programma, che deve essere esattamente «Vezpa»: con un altro nome la richiesta non viene approvata.
• Non hai né IDUB né account: invia la normale richiesta di registrazione di una nuova struttura (Žádost o registraci nového ubytovacího zařízení) su ubyport.pcr.cz (si apre in una nuova scheda), scegliendo «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» e indicando come programma «Vezpa».

Testo modello della richiesta (in ceco): «Žádám o přihlašovací údaje do Ubyport Webová služba pro ubytovací zařízení <název>, <adresa>, IDUB: <IDUB>, které budu zasílat prostřednictvím programu Vezpa, výrobce Vezpa.» Altri dettagli sulla pagina ufficiale della polizia ceca (si apre in una nuova scheda).

In Vezpa, in Configurazione → Registrazione Governo: Username e Password dell'account robotico, l'IDUB nel campo «Codice struttura», la Zkratka in «Impostazioni aggiuntive», poi accendi «Invio automatico». Lascia vuoto l'endpoint e spento «Ambiente di prova», che serve solo agli account di prova degli sviluppatori. Più strutture con IDUB diversi: usa «Credenziali per alloggio».

🇦🇹 Austria — Meldeamt

Gaestemeldung obbligatoria ai sensi del Meldegesetz. Ogni Bundesland ha il proprio sistema; Vezpa supporta tutti i 9 Bundeslaender con endpoint configurabile.

Credenziale	Dove ottenerla
Username + Password oppure API Key	Portale del proprio Bundesland (feratel Deskline, GMS, etc.)
Betriebsnummer	Assegnato dal Meldeamt regionale
Endpoint URL	Specifico per Bundesland

🇧🇬 Bulgaria — ESTI

Registrazione degli ospiti presso il sistema unificato ESTI, che passa dal gateway RegiX. Una sola dichiarazione soddisfa insieme l'obbligo verso il Ministero del Turismo e quello di registrazione degli stranieri.

Credenziale	Dove ottenerla
Certificato digitale	Prestatore accreditato bulgaro
Identificativo della struttura	Registro ESTI dopo la registrazione

🇸🇮 Slovenia — eTurizem (AJPES)

Registrazione turisti obbligatoria gestita da AJPES. Richiede un certificato digitale qualificato rilasciato da un prestatore accreditato sloveno.

Credenziale	Dove ottenerla
Certificato digitale PEM	SIGEN-CA, Halcom, NLB o altro ente accreditato
ID Nastanitvenega Obrata	Portale AJPES dopo registrazione

🇮🇸 Islanda — Gistiskrá (Registro Ospiti)

In base alla legge islandese sulle strutture ricettive (Lög um veitingastaði, gististaði og skemmtanahald), ogni struttura deve tenere un registro ospiti (gistiskrá) con i dati di tutti gli ospiti. Il registro deve essere disponibile per l'ispezione da parte della polizia islandese (Lögreglan).

Vezpa registra automaticamente tutti i dati richiesti durante il check-in. Non è necessaria alcuna configurazione di credenziali — i dati sono sempre disponibili nell'app e possono essere esportati o stampati in qualsiasi momento.

Campo obbligatorio	Descrizione
Nome completo	Nome e cognome dell'ospite
Data di nascita	Data completa
Nazionalità	Paese di cittadinanza
Documento	Tipo e numero (passaporto o carta d'identità)
Residenza	Indirizzo completo
Date soggiorno	Arrivo e partenza

Le regioni Umbria, Friuli Venezia Giulia e Puglia non dispongono di web service per l'invio automatico. Per queste regioni, Vezpa genera il file che dovrai scaricare e caricare manualmente.

Come scaricare il file

1. Dalla Direzione apri «Configurazione», gruppo «Alloggi», e tocca l'alloggio
2. Nella sezione «ISTAT» verifica che la «Regione» sia quella giusta
3. Tocca il pulsante «Scarica file ISTAT»
4. Scegli la data di inizio e la data di fine del periodo
5. Genera il file
6. Il file viene generato e puoi condividerlo (email, WhatsApp, salva su file system)

Formati file per regione

Regione	Formato	Dove caricarlo
Umbria	TXT (ROSS 1000, 338 char/record)	Turismatica
Friuli V.G.	TXT (ROSS 1000, 338 char/record)	WebTur
Puglia	XML (SPOT, formato movimentogiornaliero-0.6.xsd)	www.dms.puglia.it (accesso SPID)