# Serrature smart Nuki — codici della porta automatici

Con una Nuki Smart Lock e un Nuki Keypad ogni ospite riceve il **proprio codice per il tastierino**, valido solo dal check-in al check-out. Nessuna consegna delle chiavi, nessun codice condiviso che circola per mesi.

## Come funziona

1. Viene creata una prenotazione (a mano o dal tuo canale).
2. Quando il soggiorno è **sbloccato** (check-in completato e pagamenti saldati o esonerati) e l'arrivo è vicino, il portale ospiti crea un codice tastierino sulla tua serratura tramite la Nuki Web API.
3. L'ospite vede il codice nel portale in prossimità del soggiorno — mai prima.
4. Dopo il check-out il codice viene cancellato automaticamente.

I codici sono di 6 cifre da 1 a 9 (il tastierino Nuki non ha lo 0) e non iniziano mai con 12, come richiesto da Nuki. Se Nuki non è raggiungibile, il portale riprova ogni ora e mostra l'ultimo errore sulla prenotazione.

![L'ospite vede il codice del tastierino una volta completati tutti i passaggi](/site/img/docs/m-checkin.webp "L'ospite vede il codice del tastierino una volta completati tutti i passaggi")

## 1. Crea un token Nuki Web API

1. Accedi a `https://web.nuki.io` con l'account Nuki proprietario delle serrature. Nuki Web deve essere attivato per la serratura.
2. Apri **API** e genera un **API token** con il permesso di gestire le autorizzazioni delle tue smart lock.
3. Copia il token.

## 2. Collega Nuki

1. **Settings → Smart locks** (Impostazioni → Serrature smart).
2. Incolla il **Nuki Web API token** (archiviato in forma cifrata).
3. **Create codes … days before arrival** — almeno 2 giorni, così la serratura ha il tempo di sincronizzare il nuovo codice.
4. **Extra hours before check-in / after check-out** — ad esempio 3 ore di tolleranza prima e dopo.
5. Spunta **Create and remove codes automatically** (è disattivato finché non lo attivi) e clicca **Save**.
6. Clicca **Show my locks** per vedere gli ID delle smart lock.

![Settings → Smart locks](/site/img/docs/d-settings-locks.webp "Settings → Smart locks")

## 3. Assegna la serratura a una struttura

**Settings → Properties → Settings → Smart lock**: incolla il **Nuki smartlock ID** e imposta come lo vede l'ospite (ad esempio *Tastierino porta d'ingresso*). Salva. Una serratura per struttura; altri codici fissi (ad esempio il portone del palazzo) possono restare nell'editor della guida.

## 4. Controlla una prenotazione

Apri una prenotazione: la sezione **Door code** mostra lo stato (*not set yet*, *active*, *removed* — non ancora impostato, attivo, rimosso), il periodo di validità e il codice. **Create code now** lo crea subito (ad esempio per un arrivo anticipato), **Remove code** lo cancella immediatamente.

## Domande frequenti

### Un ospite può ricevere un codice prima di pagare?

No. Il codice viene creato solo per i soggiorni sbloccati e mostrato solo nel periodo del soggiorno.

### Cosa succede se cambio le date di una prenotazione?

Clicca **Renew code** sulla prenotazione, così la validità del codice segue le nuove date.

### L'account demo usa serrature reali?

No. Nella demo i codici della porta sono simulati.