Salto KS Türschlösser

Self-Check-in ohne Schlüsselübergabe. Wird eine Buchung bestätigt, fordert CampOne bei Salto KS einen PIN an, der genau für die Buchungsdauer an der jeweiligen Tür gilt. Beim Check-out wird der PIN automatisch entzogen. Das Empfangsteam berührt nie einen physischen Schlüssel.

Was Sie damit erhalten

• Automatische PIN-Erstellung bei Buchung → BESTÄTIGT
• Automatischer Entzug bei Buchung → ABGESCHLOSSEN
• Audit-Protokoll jedes erstellten PINs samt der Salto-seitigen key_id
• Ein nächtlicher Abgleich, der Abweichungen zwischen den CampOne-Datensätzen und den von Salto als aktiv gemeldeten Schlüsseln erkennt
• Ein Django-Signal (salto_key_issued), an das nachgelagerter Code andocken kann — nützlich, wenn Sie den PIN per SMS, E-Mail oder über Ihr Gäste-Portal zustellen wollen

Voraussetzungen

Salto KS Connect ist ein Partnerprogramm — eine Selbstregistrierung gibt es nicht. Reichen Sie das Formular unter https://saltosystems.com/en-ch/contact/ mit dem Stichwort “KS Connect API integration partner” ein. Die Schweizer Geschäftseinheit stellt aus:

• Eine client_id / einen API-Token für die Cloud-Connect-API
• Bestätigung der Basis-URL für Ihre Umgebung
• Eine keyTemplateId, gegen die Sie PINs ausstellen können (üblicherweise die vorbereitete “Guest-Room”-Vorlage)
• Hinweise zum Rate-Limit für POST /keys — auf einem stark frequentierten Platz können in der Hochsaison mehrere hundert PIN-Erstellungen pro Stunde anfallen

Ältere Salto-Installationen nutzen SVN (eine andere Generation als Cloud Connect). Der Adapter sieht einen Platzhalter für SVN vor, unterstützt es aktuell aber nicht — klären Sie vorab mit Salto, dass Ihr Standort auf der Cloud-Connect-Plattform läuft.

Was Sie in CampOne eintragen

Einstellungen → Integrationen → Anbieter-Adapter → Salto KS:

Feld	Beschreibung
Umgebung	Test, bis der Anbieter die Produktiv-Zugangsdaten bestätigt
Site ID	Ihre Kunden- bzw. Standortkennung bei Salto KS
API-Token	Der von Salto ausgestellte Bearer-Token
Standard-Schlüsselvorlage	Die keyTemplateId für Gästezimmer
PIN-Länge	4 oder 6 Ziffern (vom Anbieter pro Tür konfiguriert)

Klicken Sie auf Speichern und dann auf Verbindung prüfen. Der Test ruft aktive Schlüssel auflisten auf — ein grünes Symbol bestätigt, dass der Token funktioniert.

Wie ein Aufenthalt abläuft

1. Die Buchung des Gasts wechselt von OFFEN auf BESTÄTIGT.
2. CampOne meldet Salto: “Schlüssel für Tür X erstellen, gültig von Check-in bis Check-out”.
3. Salto liefert {key_id, pin}. CampOne speichert beides: key_id im Klartext, pin verschlüsselt.
4. Der PIN ist nun das, was der Gast braucht, um seine Unterkunft zu öffnen. Die Zustellung des PINs an den Gast liegt bei Ihnen — der übliche Weg ist, das Signal salto_key_issued zu abonnieren und SMS, E-Mail oder eine Portal-Nachricht zu senden.
5. Beim Check-out meldet CampOne Salto: “key_id entziehen”. Fertig.

Wird ein Aufenthalt vor dem Check-in storniert, wird der PIN sofort entzogen.

Abgleich

Einmal pro Nacht ruft CampOne die Liste der bei Salto aktiven Schlüssel ab und vergleicht sie mit den eigenen Einträgen SaltoKeyIssuance, bei denen revoked_at IS NULL gilt. Abweichungen (lokal ausgestellt, aber bei Salto fehlend, oder umgekehrt) erscheinen im Integrationsprotokoll, sodass ein manueller Abgleich rasch erledigt ist.

Support-Kontakte

• Kontaktformular: https://saltosystems.com/en-ch/contact/ (Schweizer Geschäftseinheit)
• API-Dokumentation: https://developer.saltosystems.com/ks/connect-api/

Einschränkungen

• Der Adapter liefert den PIN an CampOne, nicht direkt an den Gast. Den Zustellweg legen Sie selbst fest.
• Webhook-Ereignisse (Tür geöffnet, schwache Batterie) werden noch nicht entgegengenommen. Falls Sie diese benötigen, fragen Sie bei Salto den Webhook-Signaturschlüssel an, dann bauen wir die Anbindung ein.
• Mehrere PINs pro Aufenthalt (z. B. einer für die Unterkunft, einer für das Sanitärgebäude) sind ein Roadmap-Punkt.