Schranken (Came / FAAC)

Der Gast fährt vor, die Kamera oder der RFID-Leser erkennt das Kennzeichen, die Schranke öffnet. Niemand am Tor nötig. CampOne pflegt die Zugangsliste: Wird eine Buchung mit Kennzeichen bestätigt, wird das Kennzeichen für die Buchungsdauer beim Schrankenanbieter registriert; beim Check-out wird es wieder entfernt.

Der Adapter unterstützt Came und FAAC ab Werk und ist so aufgebaut, dass ein dritter Anbieter ergänzt werden kann, ohne die Buchungsanbindung anzupassen.

Was Sie damit erhalten

Automatische Registrierung bei Buchung → BESTÄTIGT (sofern ein Kennzeichen erfasst ist)
Automatische Abmeldung bei Buchung → ABGESCHLOSSEN
Eingehender Webhook für Durchfahrts-Ereignisse von der Schranke (signiert mit HMAC-SHA256)
Audit-Protokoll jeder Registrierung, Abmeldung und jedes Ereignisses

Voraussetzungen

Came und FAAC sind beide Partner- bzw. OEM-Programme — eine Selbstregistrierung für API-Zugriffe gibt es nicht. Stellen Sie eine Partneranfrage:

Came Connect: https://www.came.com/global/en/contact-us/ — bitten Sie um Weiterleitung an Came Svizzera
FAAC eBoard / J-Track: +39 051 61724 anrufen (FAAC HQ Bologna) — es gibt kein öffentliches Entwicklerprogramm; der Integrationszugang läuft pro Installateur

Sie benötigen:

Die Basis-URL der Anbieter-API (unterschiedlich pro Anbieter)
Zugangsdaten im Authentifizierungsschema des Anbieters (oft als JSON-Objekt — Came verwendet OAuth, FAAC verwendet einen X-Api-Key)
Eine gate_id bzw. Installations-ID
Den Webhook-Signaturschlüssel (falls die Schranke Durchfahrtsereignisse an CampOne sendet)

Was Sie in CampOne eintragen

Einstellungen → Integrationen → Anbieter-Adapter → Schranken:

Feld	Beschreibung
Anbieter	`Came`, `FAAC` oder `Other`
Umgebung	`Test` / `Production`
Endpoint	Die Basis-URL der Anbieter-API
Gate ID	Ihre Installationskennung beim Anbieter
Format der Zugangsliste	`Kennzeichen` oder `RFID-Tag` — je nachdem, was Ihre Hardware liest
API-Zugangsdaten	JSON-Objekt mit den vom Anbieter benötigten Werten (`{"client_id": "…", "client_secret": "…"}` für Came; `{"api_key": "…"}` für FAAC)

Klicken Sie auf Speichern und dann auf Verbindung prüfen. Der Test ruft den Endpoint für jüngste Durchfahrten auf — ein grünes Symbol bestätigt die Verbindung.

Kennzeichen erfassen

Das Kennzeichenfeld erscheint im Buchungsformular (neben der Nationalität). Mitarbeitende dürfen es auch leer lassen — die Schranken-Anbindung verhält sich ohne Kennzeichen still und blockiert den restlichen Buchungsablauf nicht.

Durchfahrtsereignisse

Falls der Anbieter ausgehende Webhooks unterstützt, hinterlegen Sie auf seiner Seite die CampOne-Webhook-URL. Der Endpoint ist öffentlich erreichbar, prüft aber die Signatur — Anfragen ohne korrekten HMAC-Header werden abgelehnt. Die Durchfahrtsereignisse werden im Integrationsprotokoll abgelegt; so lässt sich nachvollziehen, wer wann eingefahren ist.

Einen weiteren Schranken-Anbieter ergänzen

Der Adapter besitzt eine interne Abstraktion BarrierProvider. Einen dritten Anbieter (z. B. Nice) zu ergänzen, ist eine Änderung in einer einzigen Datei (services/providers.py) — sprechen Sie mit Ihrem Integrationspartner, falls Sie eine andere Schranke vor Ort betreiben.

Support-Kontakte

Anbieter	Kontakt
Came	https://www.came.com/global/en/contact-us/
FAAC	+39 051 61724 (HQ Bologna) · https://www.faac.biz/contacts

Einschränkungen

Die Dokumentationen von Came Connect und FAAC eBoard sind teilweise nicht öffentlich; beide Adapter verwenden REST-Pfade nach bestem Wissen, die nach Bestätigung der genauen Endpoints durch den Anbieter ggf. nachjustiert werden müssen. Die Schnittstelle ist eng gefasst, sodass eine einzeilige Korrektur ausreicht.
Das Kennzeichen wird beim Anlegen der Buchung erfasst. Wechselt der Gast bei der Anreise das Fahrzeug, müssen Sie das Kennzeichen auf der Buchung aktualisieren — das alte Kennzeichen wird abgemeldet, das neue registriert.