Alloggiati Web: credenziali della Questura e chiave del web service (WSKEY)

Perché un software come HazCheckin possa trasmettere le schedine alloggiati al posto tuo, non basta l’utente e la password con cui entri nel portale Alloggiati Web: serve anche una chiave tecnica, la WSKEY, che il portale genera su richiesta. Questa guida ti spiega dove nascono queste credenziali, come generare la chiave e dove inserire tutto in HazCheckin. Se non conosci ancora l’obbligo di comunicazione alla Questura, parti dalla guida completa ad Alloggiati Web e torna qui quando hai l’accesso attivo.

I dati che ti servono sono al massimo quattro:

• Utente di Alloggiati Web
• Password di Alloggiati Web
• WSKEY (chiave del web service)
• ID appartamento, solo se il tuo account è abilitato alla «Gestione Appartamenti»

Passo 1: richiedi le credenziali alla Questura

Le credenziali di Alloggiati Web non si creano online da soli: le rilascia la Questura della provincia in cui si trova la struttura. La richiesta la presenta chi dà alloggio (il titolare della struttura o il locatore, per le locazioni brevi). Le modalità pratiche cambiano da provincia a provincia, quindi cerca la tua Questura nella pagina dei contatti del portale e segui le indicazioni che ti dà.

Un dettaglio utile se non gestisci tu il giorno per giorno: il manuale del portale prevede che le credenziali possano essere affidate a una persona espressamente incaricata della trasmissione, per esempio un collaboratore o il gestore che cura i check-in. Chi risponde della comunicazione resta comunque la struttura: verifica con la tua Questura come formalizzare l’incarico.

Una volta ricevuti utente e password, verifica di riuscire a entrare nel portale Alloggiati Web. Se l’accesso non funziona ancora, aspetta a configurare HazCheckin: senza un account attivo la verifica delle credenziali fallirà.

Passo 2: genera la chiave del web service (WSKEY)

L’utente e la password servono per il portale, ma la trasmissione automatica passa dal servizio web di Alloggiati Web, che richiede una chiave dedicata. Per generarla:

1. Entra nel portale con le tue credenziali.
2. Apri il menu utente e scegli la voce «Chiave Web Service».
3. Genera la chiave. Il portale ti mostra una stringa lunga: è la tua WSKEY.
4. Copiala per intero, senza spazi prima o dopo, e conservala in un posto sicuro.

Due regole del portale che conviene conoscere prima di iniziare:

• Si può generare una sola chiave al giorno. Se sbagli a copiarla o la perdi, potresti dover aspettare il giorno successivo per crearne una nuova: copia con attenzione fin dalla prima volta.
• Cambiare la password invalida la chiave. Ogni volta che modifichi la password del portale devi generare una nuova WSKEY e aggiornarla nel software che la usa.

La WSKEY non è un secondo modo per entrare nel portale: è una credenziale tecnica pensata perché un programma trasmetta le schedine per conto tuo.

Passo 3 (solo «Gestione Appartamenti»): trova l’ID appartamento

La maggior parte degli host ha un account ordinario, legato a una sola struttura. In questo caso salta questo passaggio e lascia vuoto il campo ID appartamento in HazCheckin.

Se invece la Questura ti ha abilitato alla «Gestione Appartamenti», con lo stesso account gestisci più appartamenti, e ognuno ha un proprio ID numerico visibile nel portale nella lista degli appartamenti (la funzione che il servizio web chiama ListaAppartamenti). Prendi nota dell’ID di ciascun appartamento: in HazCheckin ogni proprietà va collegata al proprio ID, altrimenti le schedine verrebbero attribuite alla struttura sbagliata.

Dove inserire i dati in HazCheckin

Con utente, password, WSKEY (ed eventualmente l’ID appartamento) a portata di mano:

1. Entra nella dashboard di HazCheckin e apri Proprietà.
2. Scegli la proprietà e clicca Modifica.
3. Vai alla sezione Informazioni legali. Se il paese della proprietà è l’Italia, trovi i campi di Alloggiati Web: Utente, Password, WSKEY e ID appartamento.
4. Compila i campi e salva.

È il paese della proprietà a decidere il canale di comunicazione: per una struttura in Italia HazCheckin mostra solo i campi di Alloggiati Web. Se il paese non è corretto, sistemalo prima di inserire le credenziali.

Cosa fa la verifica al salvataggio

Quando salvi, HazCheckin non si limita a memorizzare i dati: si collega al servizio web di Alloggiati Web con le tue credenziali, richiede un token e lancia un test di autenticazione. Se il portale risponde correttamente, nella proprietà compare il badge verde «credenziali verificate»: da quel momento le schedine dei tuoi ospiti possono partire in automatico.

Se le credenziali sono sbagliate, il salvataggio viene rifiutato con un messaggio di errore. È voluto: meglio scoprirlo subito che alla prima trasmissione, con l’ospite già arrivato e le 24 ore che scorrono.

Se la verifica fallisce

Nella grande maggioranza dei casi l’errore ha una di queste tre cause:

Causa	Cosa controllare
Errore di battitura	Ricopia utente, password e WSKEY. Attenzione a spazi iniziali o finali, maiuscole e caratteri simili (0 e O, l e 1). La WSKEY va incollata per intero.
Password cambiata di recente	Ogni cambio password invalida la chiave. Genera una nuova WSKEY dal menu utente del portale e aggiornala in HazCheckin. Ricorda il limite di una chiave al giorno.
Account non ancora attivo	Se non riesci a entrare neanche nel portale, la Questura non ha ancora completato l’abilitazione. Contatta la tua Questura e riprova quando l’accesso funziona.

Se hai un account con «Gestione Appartamenti», controlla anche di aver inserito l’ID giusto per quella proprietà. Se dopo questi controlli la verifica continua a fallire, scrivi a support@hazcheckin.com indicando la proprietà e il messaggio di errore.

Come HazCheckin custodisce le tue credenziali

Le credenziali di Alloggiati Web vengono salvate cifrate e usate esclusivamente per trasmettere le schedine della proprietà a cui appartengono: per il test di autenticazione, per la verifica e l’invio delle schedine e per scaricare la ricevuta giornaliera. Non vengono usate per nessun altro scopo. Se un giorno decidi di non usare più HazCheckin, ti basta cambiare la password nel portale: la vecchia chiave smette di funzionare.

Da qui in poi il flusso è quello descritto nella guida al check-in online e all’identificazione degli ospiti: i tuoi ospiti compilano i dati prima di arrivare, tu confermi arrivo e identità con un clic e HazCheckin trasmette le schedine, riprova ogni ora se manca qualcosa e archivia la ricevuta per 5 anni.

Domande frequenti

La WSKEY è la stessa cosa della password del portale?

No. Utente e password ti fanno entrare nel portale; la WSKEY è una chiave separata, generata dal menu utente alla voce «Chiave Web Service», che serve solo al servizio web. HazCheckin ha bisogno di tutte e tre.

Posso generare una nuova WSKEY quando voglio?

Il portale permette di generare una chiave al giorno. Se hai appena creato una chiave e l’hai persa, dovrai aspettare il giorno successivo. Per questo conviene copiarla con cura e incollarla subito in HazCheckin.

Ho cambiato la password del portale, devo fare altro?

Sì. Il cambio password richiede di generare una nuova WSKEY. Poi apri la proprietà in HazCheckin, sezione Informazioni legali, aggiorna password e WSKEY e salva: la verifica ti confermerà che tutto funziona di nuovo.

Gestisco più strutture: mi serve un account per ognuna?

Dipende da come ti ha abilitato la Questura. Con un account ordinario ogni struttura ha le proprie credenziali. Con la «Gestione Appartamenti» un solo account copre più appartamenti, ciascuno con il suo ID appartamento, che in HazCheckin inserisci nella proprietà corrispondente. In caso di dubbio chiedi alla tua Questura quale configurazione hai.

Un collaboratore può usare le mie credenziali?

Il manuale del portale prevede che le credenziali possano essere affidate a una persona espressamente incaricata della trasmissione. Se preferisci non condividerle, puoi inserirle tu stesso in HazCheckin una sola volta: da quel momento chi gestisce i check-in non ha bisogno di conoscerle.

Il badge «credenziali verificate» è comparso: cosa succede ora?

Nulla da fare da parte tua. Ogni prenotazione riceve il proprio link di check-in e, appena tutti gli ospiti l’hanno completato e tu hai confermato l’arrivo dalla scheda della prenotazione, HazCheckin trasmette le schedine ad Alloggiati Web e archivia la ricevuta.