Serrures Salto KS

Auto-check-in sans remise de clé. Lorsqu’une réservation est confirmée, CampOne demande à Salto KS de générer un PIN qui fonctionne sur la porte de l’hôte exactement pour les dates de séjour. Au départ, le PIN est révoqué. Le personnel d’accueil ne manipule plus aucune clé physique.

Ce que vous y gagnez

• Émission automatique du PIN au passage Réservation → CONFIRMED
• Révocation automatique au passage Réservation → COMPLETED
• Journal d’audit de chaque PIN émis, avec le key_id côté Salto
• Un balayage de réconciliation nocturne qui détecte les écarts entre les enregistrements de CampOne et ce que Salto déclare comme actif
• Un signal Django (salto_key_issued) auquel du code en aval peut s’abonner — utile lorsque vous voulez transmettre le PIN à l’hôte par SMS, e-mail ou via votre portail client

Prérequis

Salto KS Connect est un programme partenaire — pas d’inscription en libre-service. Soumettez le formulaire à https://saltosystems.com/en-ch/contact/ en mentionnant « KS Connect API integration partner ». La Swiss Business Unit délivrera :

• Un client_id / jeton API pour la Cloud Connect API
• La confirmation de l’URL de base pour votre environnement
• Un keyTemplateId contre lequel émettre des PIN (typiquement le modèle « guest room » qu’ils préprovisionnent)
• Les indications de limites de débit pour POST /keys — en haute saison sur un site fréquenté, on peut atteindre plusieurs centaines d’émissions de PIN à l’heure

Les installations Salto plus anciennes utilisent SVN (une autre génération que Cloud Connect). L’adaptateur prévoit un emplacement pour SVN mais ne le prend pas encore en charge — confirmez auprès de Salto que votre site est bien sur la plateforme Cloud Connect avant de signer.

Ce que vous collerez dans CampOne

Réglages → Intégrations → Adaptateurs fournisseurs → Salto KS :

Champ	Description
Environment	Test jusqu’à ce que l’éditeur confirme les identifiants de production
Site ID	Votre identifiant client / site Salto KS
API token	Le Bearer token délivré par Salto
Default key template	Le keyTemplateId pour les chambres d’hôtes
PIN length	4 ou 6 chiffres (configuré par l’éditeur, par porte)

Cliquez sur Save, puis sur Test connection. La sonde appelle list active keys — une pastille verte confirme que le jeton fonctionne.

Déroulement d’un séjour

1. La réservation passe de PENDING à CONFIRMED.
2. CampOne appelle Salto : « émets une clé pour la porte X, valide du check-in au check-out ».
3. Salto retourne {key_id, pin}. CampOne enregistre les deux : key_id en clair, pin chiffré.
4. Le PIN est désormais ce dont l’hôte a besoin pour entrer dans son hébergement. La transmission du PIN à l’hôte vous incombe — le schéma standard consiste à s’abonner au signal salto_key_issued et à envoyer un SMS, un e-mail ou un message via le portail.
5. Au départ, CampOne appelle Salto : « révoque key_id ». C’est terminé.

Si un séjour est annulé avant l’arrivée, le PIN est révoqué immédiatement.

Réconciliation

Une fois par nuit, CampOne récupère la liste des clés actives chez Salto et la compare avec son propre relevé des lignes SaltoKeyIssuance dont revoked_at IS NULL. Les écarts (émis localement mais absents chez Salto, ou l’inverse) apparaissent dans le journal d’intégration pour qu’une réconciliation manuelle soit rapide.

Contacts de support

• Formulaire de contact : https://saltosystems.com/en-ch/contact/ (Swiss Business Unit)
• Documentation API : https://developer.saltosystems.com/ks/connect-api/

Limites

• L’adaptateur livre le PIN à CampOne, pas à l’hôte. Vous décidez du canal de transmission.
• Les événements webhook (porte ouverte, batterie faible) ne sont pas encore ingérés. Si vous en avez besoin, demandez à Salto le secret de signature webhook et nous le câblerons.
• Le multi-PIN par séjour (par ex. un pour l’hébergement, un pour le bloc sanitaire) figure sur la feuille de route.