Guida alle Integrazioni
Dove si inseriscono i codici di Alloggiati Web, ISTAT e PayTourist, e a chi si chiedono
Indice
Dove si inseriscono i codiciNella configurazione dell'alloggio, sezione «Integrazioni»
I codici non stanno nelle impostazioni generali: stanno nella configurazione dell'alloggio, sezione «Integrazioni». È la stessa schermata da cui hai aperto questa guida, con il collegamento «Come ottenere i codici?».
Dentro ci sono tre riquadri, ognuno con il suo interruttore «Abilitato»: «Alloggiati (Questura)», «ISTAT» e «PayTourist». Finché l'interruttore è spento i campi restano chiusi e non parte nessun invio.
Alloggiati Web (Questura)Quattro valori, e sono diversi dal login al portale
Alloggiati Web è il portale della Polizia di Stato su cui vanno comunicate le generalità degli ospiti. Vezpa ci parla tramite il Web Service, che ha credenziali proprie.
| Campo | Che cos'è |
|---|---|
| «Username WS» | L'utente del Web Service, non quello con cui entri nel portale |
| «Password WS» | La password dedicata al Web Service |
| «Token WS» | La chiave generata nella sezione Gestione WS del portale |
| «Codice Licenza» | Il codice di licenza assegnato dalla Questura |
| «Numero Casa Vacanza Questura» | Solo per le case vacanza: il numero progressivo che la Questura assegna a quell'unità |
Per ottenerli, dal portale alloggiatiweb.poliziadistato.it: Tabelle › Gestione WS. Se quella sezione non c'è, l'abilitazione al Web Service va chiesta alla Questura della tua provincia.
ISTAT, regione per regionePrima si sceglie la «Regione», poi i campi cambiano nome
Ogni regione ha il suo sistema. Nel riquadro ISTAT il primo campo è «Regione», ed è quello che comanda: scelta la regione, i tre campi sotto cambiano nome e diventano quelli che quel portale usa davvero.
Nell'elenco ci sono venti regioni: Piemonte, Toscana, Basilicata, Liguria, Abruzzo, Veneto, Emilia-Romagna, Marche, Lombardia, Calabria, Sardegna, Lazio, Molise, Sicilia, Campania, Umbria, Friuli Venezia Giulia, Trentino, Puglia e Valle d'Aosta.
| Regione | Come arrivano i dati | Che cosa chiede |
|---|---|---|
| Piemonte, Toscana, Basilicata, Liguria, Abruzzo, Veneto, Emilia-Romagna, Marche, Lombardia, Calabria, Sardegna, Lazio, Molise | Invio automatico al portale regionale | «Username ISTAT», «Password ISTAT», «Codice ISTAT» |
| Sicilia | Invio automatico | UserId, Password, HotelCode |
| Campania | Invio automatico | CUSR, API Key, «Codice ISTAT» |
| Trentino | Invio automatico | «Username ISTAT», «Password ISTAT», «Codice ISTAT» |
| Valle d'Aosta | Invio automatico | Utente, Password, ID Struttura |
| Umbria, Friuli Venezia Giulia, Puglia | File da scaricare e caricare a mano | Solo Codice Struttura |
Le credenziali si chiedono all'ufficio turistico o all'APT della tua provincia o regione, e il codice struttura lo assegna l'ente regionale. Per la Sicilia il profilo da chiedere è quello dedicato ai gestionali, e il codice ha la forma TRS-IT-SIC-00004; per la Campania il CUSR e la API Key si recuperano dal portale regionale.
Le tre regioni a file
Per Umbria, Friuli Venezia Giulia e Puglia non c'è nessun invio automatico: Vezpa prepara il file e lo carichi tu sul portale della regione. Scelta la regione compare il pulsante «Scarica file ISTAT», che apre una schermata dove scegli il periodo, generi il documento e lo salvi o lo condividi.
| Regione | Formato | Dove si carica |
|---|---|---|
| Umbria | TXT (ROSS 1000) | Turismatica |
| Friuli Venezia Giulia | TXT (ROSS 1000) | WebTur |
| Puglia | XML (SPOT) | dms.puglia.it, con SPID |
PayTouristDue valori, e prima di tutto una domanda al Comune
PayTourist è la piattaforma con cui alcuni Comuni italiani raccolgono la tassa di soggiorno. Non la usano tutti: prima di compilare qualunque cosa, verifica con il tuo Comune o con l'ufficio tributi che sia quella in uso.
| Campo | Che cos'è |
|---|---|
| «ID PayTourist» | L'identificativo della struttura, fornito dal Comune o dall'operatore |
| «Token API PayTourist» | La chiave che generi tu su paytourist.com, nella sezione Integrazioni/API |
Quando partono gli inviiNon tutti allo stesso momento, e nessuno al check-out
Salvati i codici non devi lanciare niente: gli invii partono da soli, ma con tempi diversi, perché diverse sono le scadenze.
| Sistema | Quando |
|---|---|
| Alloggiati Web | Lo stesso giorno, più volte al giorno: la schedina va trasmessa entro 24 ore dall'arrivo |
| ISTAT | Una volta al giorno, e dichiara il giorno di cinque giorni prima |
| PayTourist | Una volta al giorno, sullo stesso giorno di ISTAT |
Se qualcosa non tornaI sintomi, e la causa vera di ognuno
- Non trovo la sezione Gestione WS sul portale. Il Web Service va abilitato dalla Questura: le credenziali del portale non bastano e non si convertono.
- Ho messo le credenziali del portale e non funziona. Sono un'altra cosa. Il riquadro lo dice: il riquadro avverte in maiuscolo che le credenziali WS sono DIVERSE da quelle di accesso al portale.
- Arriva un'email che dice che alcune registrazioni non sono state inviate. È l'avviso automatico, e arriva all'indirizzo della struttura insieme a una notifica nell'app. Dentro c'è il motivo riportato dal sistema: corretti i dati, l'invio riparte da solo al ciclo successivo.
- Ho cambiato regione e i campi si sono svuotati di senso. È voluto: ogni regione chiede valori diversi, e i vecchi non valgono per il portale nuovo.
- Per la mia regione non parte niente. Controlla se è una delle tre a file: Umbria, Friuli Venezia Giulia e Puglia non hanno nessun invio automatico, il documento lo carichi tu.
- Vezpa mi chiede credenziali che non ho. Vezpa non possiede credenziali proprie verso nessuno di questi enti: ogni struttura si registra per conto suo e usa le sue. Non c'è un accesso condiviso da chiedere a noi.
Hai bisogno di aiuto?
Se hai difficoltà a reperire i codici o hai domande sulla configurazione, il nostro team è a disposizione.
Contattaci