Credenziali Alloggiati

In attesa di revisione del commercialista. Questa pagina gestisce le credenziali del portale Alloggiati Web della Polizia di Stato. Deve essere riveduta dal commercialista (e dall’avvocato, per gli aspetti di sicurezza) prima di essere considerata autorevole. Riferimenti: FISCAL_RULES.md §AW-001 (obbligo), §AW-002 (tempistiche di invio entro 24h), §AW-003 (criteri di esenzione e sanzioni).

La pagina Credenziali Alloggiati è dove tu, in qualità di Admin dell’organizzazione, registri le credenziali del portale Alloggiati Web (servizio della Polizia di Stato) per ogni questura competente. Le credenziali sono cifrate a riposo e mai restituite in chiaro dal sistema.

Solo Admin. Un utente con ruolo manager o operatore che tenta di aprire questa pagina riceve un’avviso di accesso negato (il backend risponde 403). È voluto: le credenziali sbloccano una macchina governativa, e l’accesso scrittura è limitato al numero minimo di persone.

Come ci arrivi

Dal menu a sinistra fai clic su Alloggiati. La voce è visibile solo se hai il ruolo Admin.

Cosa vedi quando la apri

In cima il titolo Credenziali Alloggiati Web.

Sotto, due aree:

1. Il modulo per aggiungere una credenziale con cinque campi:
   • Etichetta — il nome con cui la riconoscerai (es. “Roma Trastevere”, “Monte Argentario”).
   • Tipo — di solito web_service per l’API ufficiale.
   • Utente — l’username assegnato dalla questura. Mascherato.
   • Password — la password assegnata. Mascherata.
   • WS Key — la chiave del web service. Mascherata.
2. La tabella delle credenziali esistenti con: etichetta, tipo, data di creazione, stato (attiva / disattivata).

I campi sensibili (utente, password, WS Key) sono di tipo password in HTML, quindi non vengono mostrati in chiaro nemmeno mentre li digiti. La password manager del browser è disabilitata su questi campi per evitare salvataggi indesiderati.

Cosa puoi fare

Aggiungere una nuova credenziale

Compila il modulo:

1. Etichetta — qualcosa di leggibile.
2. Tipo — di solito web_service.
3. Utente — incolla dall’email della questura.
4. Password — incolla.
5. WS Key — incolla.

Fai clic su Crea credenziale. Al successo vedi una conferma e il modulo si svuota immediatamente (per non lasciare i segreti nella memoria del browser). La nuova riga compare nella tabella.

Collegare una credenziale a un immobile

Si fa dalla scheda dell’immobile, sezione Credenziale Alloggiati: scegli la credenziale dal menu. Un solo immobile può puntare a una sola credenziale per volta.

Disattivare o ruotare una credenziale

Dalla riga in tabella, fai clic su Modifica per cambiare l’etichetta o disattivarla. Per ruotare (es. la questura ha emesso una nuova password), inserisci una nuova credenziale e collega gli immobili alla nuova; poi disattiva la vecchia.

Cosa non fai da qui

• Non puoi visualizzare i segreti dopo averli inseriti. Sono cifrati nel database e mai restituiti in chiaro. Se perdi la password, devi richiederne una nuova alla questura.
• Non puoi cancellare una credenziale che è ancora collegata a un immobile. Devi prima riassegnare gli immobili a un’altra credenziale o disattivarla.

Domande frequenti

Cos’è Alloggiati Web? Il portale del Ministero dell’Interno dove tu, in qualità di struttura ricettiva, comunichi le presenze degli ospiti alla questura competente (FISCAL_RULES.md §AW-001). L’invio è obbligatorio entro 24 ore dal check-in (§AW-002). Sanzione per omessa o tardiva comunicazione: €160 – €1.032 per ospite.

Devo registrare una credenziale per ogni immobile? No. Le credenziali sono di solito per questura: una credenziale copre tutti gli immobili che ricadono sotto la stessa questura. Se hai immobili a Roma e a Monte Argentario, ti servono due credenziali (una per la questura di Roma, una per la questura di Grosseto).

Come ottengo la WS Key? Si richiede tramite il portale Alloggiati Web (servizio Web). La procedura prevede un’identificazione del legale rappresentante, qualche giorno di attesa, e poi il rilascio. Conserva la chiave in un posto sicuro e inseriscila qui appena disponibile.

Cosa succede se sbaglio la WS Key? Il sistema prova a usarla al primo invio Alloggiati per quell’ immobile. Se la questura rifiuta, il log mostra l’errore e l’ invio non avviene. Aggiorni la credenziale e riprovi. Nessun dato viene “inviato male” — l’errore avviene prima della trasmissione effettiva.

Posso vedere i log degli invii fatti con una credenziale? Sì, dalla pagina Inbox filtrando per categoria “Alloggiati”, oppure dalla scheda della prenotazione (sezione Compliance). Una vista consolidata per credenziale è prevista in una versione futura.

Cosa rischio se inserisco le credenziali sbagliate? Nessuna conseguenza fiscale immediata. Il rischio è operativo: gli invii Alloggiati falliscono finché non correggi, e accumuli il ritardo dell’obbligo di 24 ore. Se questo perdura, scattano le sanzioni (AW-002).