Guida · adempimenti

WSKey di Alloggiati Web: cos'è e come si genera.

Chi collega un gestionale ad Alloggiati Web si ferma quasi sempre nello stesso punto: il portale risponde che le credenziali non sono valide, e sono giuste. Manca la terza cosa, e quasi nessuno sa che esiste.

A cura della redazione di Nidèra · pubblicata il

In breve

La WSKey (chiave Web Service) di Alloggiati Web è un codice separato dalla password, che l'utente genera dentro il portale della Polizia di Stato e che autorizza un programma esterno a trasmettere le schedine alloggiati al posto suo. Serve insieme a utente e password: sono tre cose, non due. La chiave scade e va rigenerata dallo stesso punto del portale. Se si incolla la password al posto della WSKey, il servizio risponde che le credenziali non sono valide anche quando utente e password sono corretti.

Nidèra
La schermata di Nidèra che prepara le schedine per Alloggiati Web

Perché esistono tre credenziali e non due

Il portale Alloggiati Web della Polizia di Stato ha due porte distinte. Dalla prima entra una persona, con utente e password, e carica le schedine a mano. Dalla seconda entra un programma — un gestionale, un PMS, un channel manager — attraverso un servizio web, e quella porta vuole una credenziale in più: la WSKey.

La separazione ha una logica: la password apre tutto il portale, la WSKey autorizza solo la trasmissione delle schedine. Se un fornitore smette di piacerti, revochi la chiave e il tuo accesso personale resta intatto. È lo stesso principio per cui la chiave di casa non è la chiave della cassaforte.

Il risultato pratico è però una confusione quasi garantita, perché il messaggio d'errore è lo stesso in entrambi i casi: «credenziali non valide». Chi lo legge controlla utente e password, li trova giusti, e conclude che il software è rotto.

Come si genera la WSKey, passo per passo

1. Entra su alloggiatiweb.poliziadistato.it con le credenziali che ti ha dato la Questura quando hai aperto la struttura. Se le hai perse, le rilascia la Questura competente: nessun fornitore di software può recuperarle.

2. Cerca la voce «Chiave Web Service» — di solito sotto il profilo utente o la gestione delle utenze — e premi Genera.

3. Il portale mostra una stringa lunga. Quella è la WSKey. Copiala per intero: una chiave troncata produce lo stesso errore di una chiave sbagliata.

4. Incollala nel tuo gestionale, nel campo dedicato alla chiave web service, insieme a utente e password. Il gestionale dovrebbe provare subito il collegamento e dirti com'è andata.

Un controllo che vale dieci minuti di telefonate: se quello che hai incollato è identico alla tua password, è sbagliato. Sono due cose diverse, e non coincidono mai.

La chiave scade: non è un guasto

La WSKey ha una validità limitata. Quando scade, gli invii automatici si fermano e il gestionale segnala che le credenziali non sono più valide. Non è un difetto del software né un problema della tua utenza: si torna nel portale, si rigenera la chiave e si reincolla.

Vale la pena saperlo prima, perché il momento in cui te ne accorgi è quasi sempre il peggiore: la sera di un arrivo, con l'obbligo delle 24 ore che corre. Un gestionale fatto bene ti avvisa che la chiave sta per scadere invece di lasciartelo scoprire da solo.

Gli errori più comuni, e cosa significano davvero

«Credenziali non valide» con utente e password corretti — nove volte su dieci è la password incollata al posto della WSKey, oppure una chiave scaduta. Rigenerala e riprova.

Funzionava e ha smesso — chiave scaduta, oppure qualcuno l'ha rigenerata: rigenerare una chiave invalida la precedente, quindi se due programmi usano la stessa utenza il secondo spegne il primo.

Il portale non risponde affatto — capita, ed è il portale. Le schedine vanno trasmesse entro 24 ore dall'arrivo, quindi conviene riprovare presto, non il giorno dopo.

Utente accettato ma nessun appartamento — la struttura è registrata come gestore di più alloggi: va indicato a quale appartamento si riferisce ogni schedina, e il codice si legge nella lista appartamenti del portale.

Dove si incolla in Nidèra

In Nidèra la connessione ad Alloggiati Web ha una procedura guidata che dice esattamente queste cose nel momento in cui servono, e che prova subito il collegamento col portale vero: se qualcosa non va lo scopri durante la configurazione, non la sera del primo arrivo.

Una volta collegata, Nidèra compila le schedine dai dati che l'ospite ha già inserito nel check-in online, le mette in fila e le trasmette: all'host restano un controllo e un clic. La ricevuta della Questura viene conservata insieme alla prenotazione.

Domande frequenti

In breve.

La WSKey è la stessa cosa della password?

No. Sono due credenziali distinte: la password serve a entrare nel portale come persona, la WSKey autorizza un programma a trasmettere le schedine. Servono entrambe, insieme al nome utente.

Dove si genera la WSKey?

Dentro Alloggiati Web, alla voce «Chiave Web Service», di solito nella sezione del profilo o della gestione utenze. Si preme Genera e si copia la stringa che compare.

La WSKey scade?

Sì. Quando scade gli invii automatici si fermano e va rigenerata dallo stesso punto del portale. Non è un guasto del gestionale.

Posso usare la stessa WSKey su due programmi diversi?

È sconsigliato: rigenerare la chiave invalida la precedente, quindi il secondo programma che la rigenera spegne il primo. Meglio una sola integrazione attiva per utenza.

Entro quanto vanno trasmesse le schedine?

Entro 24 ore dall'arrivo dell'ospite; per i soggiorni di una sola notte, entro 24 ore dall'arrivo stesso. È l'obbligo previsto dall'articolo 109 del TULPS.

La demo è già pronta

Provalo su tre case di prova.

Entra senza registrarti e guarda come funziona, poi ne parliamo sulle tue case.

Oppure scrivi a info@nidera.it o su WhatsApp. Per proposte commerciali e marketing: enrico@nidera.it.