Guida all'uso

1. Recuperare le credenziali da Alloggiati Web (WSKey)

Per inviare le schedine alla Polizia di Stato, OspiteFacile usa tre dati: Utente, Password (gli stessi che usi sul portale Alloggiati Web) e la WSKey (chiamata anche API Key), una chiave necessaria per i servizi web. La WSKey si recupera una sola volta dal portale ufficiale.

1. Accedi al portale Alloggiati Web

   Collegati con le tue credenziali rilasciate dalla Questura:

   alloggiatiweb.poliziadistato.it

   

2. Apri la sezione "Sicurezza"

   Dopo l'accesso, clicca sul menu in alto a destra e seleziona la voce SICUREZZA.

   

3. Copia la WSKey (API Key)

   Verrà mostrata una schermata di riepilogo con il codice ApiKey necessario per l'utilizzo dei servizi web. Copialo: è la tua WSKey.

   

4. Inseriscila in OspiteFacile

   Apri l'app, vai su Configurazione Credenziali e compila i campi Utente, Password e WSKey. Puoi aggiungere un Nome Alloggio per riconoscere facilmente l'utenza (utile se gestisci più strutture).

2. Associare il codice CIPAT per ISTAT Alloggi (ISPAT)

In Trentino, oltre alla Pubblica Sicurezza, devi comunicare il movimento turistico all'ISPAT (Istituto di Statistica della Provincia Autonoma di Trento) tramite la piattaforma ISTAT Alloggi. Con OspiteFacile non devi inserire alcuna username o password ISPAT: ti basta associare il codice CIPAT della tua struttura. L'invio passa dal servizio sicuro OspiteFacile.

Per inviare le presenze a ISTAT Alloggi direttamente da OspiteFacile devi prima autorizzare OspiteFacile come software house sul portale ufficiale della Provincia. È un'operazione che si fa una sola volta per ogni CIPAT e va eseguita dal titolare con le proprie credenziali SPID o CPS.

1. Accedi al portale ISTAT Alloggi

   Apri il portale della Provincia Autonoma di Trento e accedi con SPID o CPS. Dal menu SERVIZI scegli "dichiarazione ISTAT".

   alloggituristici.provincia.tn.it

2. Apri il menu "import" e scegli "software"

   Nella barra in alto passa sul menu "import" e seleziona la voce "software".

   

3. Seleziona OspiteFacile dalla tendina "software"

   Apri la tendina "software" e scegli OspiteFacile dall'elenco. Nella lista compaiono solo le software house accreditate per l'invio dei dati ISTAT in web service.

   

4. Spunta il tuo CIPAT e clicca "aggiorna"

   Metti la spunta nel quadratino davanti al codice CIPAT del tuo alloggio, poi clicca su "aggiorna". Se gestisci più alloggi, ripeti per ogni CIPAT.

   

5. Verifica l'associazione

   A destra del codice CIPAT comparirà la descrizione della software house scelta: significa che l'associazione è andata a buon fine.

   

6. Inserisci il CIPAT in OspiteFacile

   Torna in app, vai nella sezione ISTAT / ISPAT, scegli Aggiungi CIPAT e digita il codice nel formato NNNNNN-LL-NNNNNN (più un Nome struttura opzionale). Da qui potrai inviare arrivi e presenze, con ricevuta in PDF e storico degli invii.

3. Leggere i documenti: lettura ottica (OCR) o fotocamera

OspiteFacile compila automaticamente i dati dell'ospite leggendo il codice MRZ (le righe in fondo a carta d'identità, CIE e passaporti). Puoi scegliere tra scansione dal vivo con la fotocamera oppure caricamento di una foto o di un PDF già salvati. Da una sola immagine l'app può riconoscere anche più ospiti.

Inquadra la zona MRZ del documento: OspiteFacile legge i dati in automatico.

Opzione A — Scansione con la fotocamera

1. Avvia lo scanner

   Nella schermata dei dati ospite tocca l'icona della fotocamera per aprire lo scanner MRZ.

2. Inquadra il documento

   Posiziona il documento ben illuminato e dritto, allineando le righe del codice MRZ nel riquadro. L'app legge i dati in automatico.

3. Verifica i dati estratti

   I campi (nome, cognome, data di nascita, tipo e numero documento, cittadinanza...) vengono compilati da soli: controllali e correggili se necessario.

Opzione B — Caricamento da galleria o file (foto / PDF)

1. Scegli "Importa documento"

   Seleziona il caricamento da galleria (foto già scattata) oppure da file (immagine o documento PDF).

2. Prepara l'immagine

   Per la massima precisione, ritaglia la foto così da mostrare solo la zona del codice MRZ (le righe in fondo al documento), dritta e non ruotata.

3. Carica ed elabora

   L'app esegue la lettura ottica (OCR) ed estrae i dati. Se nell'immagine ci sono più documenti, potrai selezionare gli ospiti riconosciuti.