Serrature Salto KS

Self check-in senza consegna di chiavi. Quando una prenotazione è confermata, CampOne chiede a Salto KS di generare un PIN che funziona sulla porta dell’ospite per le date esatte della prenotazione. Al check-out, il PIN viene revocato. Il personale di reception non tocca mai una chiave fisica.

Cosa Le offre

• Emissione automatica del PIN su Booking → CONFIRMED
• Revoca automatica su Booking → COMPLETED
• Audit log di ogni PIN emesso, con il key_id lato Salto
• Una riconciliazione notturna che rileva le discrepanze tra i record di CampOne e quanto Salto considera attivo
• Un signal Django (salto_key_issued) a cui può abbonarsi codice a valle — utile se vuole inviare il PIN all’ospite via SMS, e-mail o portale ospiti

Prerequisiti

Salto KS Connect è un programma partner — non c’è auto-registrazione. Compili il modulo su https://saltosystems.com/en-ch/contact/ indicando “KS Connect API integration partner”. La Business Unit svizzera Le rilascerà:

• Un client_id / token API per la Cloud Connect API
• La conferma del base URL del Suo ambiente
• Un keyTemplateId su cui può emettere PIN (di norma il template “guest room” pre-configurato)
• Indicazioni sui rate limit per POST /keys — in alta stagione un sito affollato può emettere diverse centinaia di PIN all’ora

Le installazioni Salto più datate usano SVN (una generazione diversa da Cloud Connect). L’adapter ha un placeholder per SVN ma oggi non lo supporta — verifichi con Salto che il Suo sito sia sulla piattaforma Cloud Connect prima di sottoscrivere.

Cosa incollerà in CampOne

Impostazioni → Integrazioni → Vendor Adapters → Salto KS:

Campo	Descrizione
Environment	Test finché il fornitore non conferma le credenziali di produzione
Site ID	Identificativo del Suo cliente / sito Salto KS
API token	Il Bearer token rilasciato da Salto
Default key template	Il keyTemplateId per le camere ospiti
PIN length	4 o 6 cifre (configurato dal fornitore per porta)

Clicchi Save, poi Test connection. La verifica chiama list active keys — la pillola verde conferma che il token funziona.

Come si svolge un soggiorno

1. La prenotazione passa da PENDING a CONFIRMED.
2. CampOne chiama Salto: “emetti una chiave per la porta X, valida dal check-in al check-out”.
3. Salto restituisce {key_id, pin}. CampOne archivia entrambi: key_id in chiaro, pin cifrato.
4. Il PIN è ora ciò che serve all’ospite per accedere all’alloggio. La consegna del PIN all’ospite spetta a Lei — il pattern standard è abbonarsi al signal salto_key_issued e inviare SMS / e-mail / messaggio di portale.
5. Al check-out, CampOne chiama Salto: “revoca key_id”. Fatto.

Se un soggiorno è annullato prima del check-in, il PIN viene revocato immediatamente.

Riconciliazione

Una volta a notte, CampOne preleva da Salto l’elenco delle chiavi attive e lo confronta con i propri record SaltoKeyIssuance dove revoked_at IS NULL. Le discrepanze (emesse localmente ma assenti su Salto, o viceversa) compaiono nel log di integrazione, così una riconciliazione manuale è rapida.

Contatti di supporto

• Modulo di contatto: https://saltosystems.com/en-ch/contact/ (Business Unit svizzera)
• Documentazione API: https://developer.saltosystems.com/ks/connect-api/

Limiti

• L’adapter consegna il PIN a CampOne, non all’ospite. Lei sceglie il canale di consegna.
• Gli eventi webhook (porta aperta, batteria scarica) non sono ancora ingeriti. Se li desidera, chieda a Salto il signing secret del webhook e li colleghiamo.
• Multi-PIN per soggiorno (es. uno per l’alloggio, uno per il blocco docce) è un punto di roadmap.