Barriere (Came / FAAC)

Gli ospiti entrano in auto, la telecamera o il lettore RFID riconosce la targa, la barriera si apre. Nessun personale al varco. CampOne gestisce la allowlist: quando una prenotazione è confermata con una targa, la targa viene registrata presso il fornitore della barriera per le date della prenotazione; al check-out viene rimossa.

L’adapter supporta Came e FAAC out of the box ed è strutturato in modo che un terzo fornitore possa essere aggiunto senza riscrivere l’integrazione delle prenotazioni.

Cosa Le offre

• Registrazione automatica su Booking → CONFIRMED (quando viene catturata una targa)
• Cancellazione automatica su Booking → COMPLETED
• Webhook in entrata per gli eventi di pass / transito dalla barriera (firmato con HMAC-SHA256)
• Audit log di ogni registrazione / cancellazione / evento

Prerequisiti

Sia Came sia FAAC sono programmi partner / OEM — non c’è auto-registrazione per l’accesso API. Inoltri una richiesta di partnership:

• Came Connect: https://www.came.com/global/en/contact-us/ — chieda di essere indirizzato a Came Svizzera
• FAAC eBoard / J-Track: chiami +39 051 61724 (FAAC HQ Bologna) — non hanno un programma sviluppatori pubblico; l’accesso integrazione è gestito tramite installatore

Le serviranno:

• L’URL base API del fornitore (diverso per ciascun fornitore)
• Le credenziali API nel formato di autenticazione del fornitore (spesso un blob JSON — Came usa OAuth, FAAC usa una X-Api-Key)
• Un gate_id / ID di installazione
• Il signing secret del webhook (se la barriera invia gli eventi di pass a CampOne)

Cosa incollerà in CampOne

Impostazioni → Integrazioni → Vendor Adapters → Schranken:

Campo	Descrizione
Provider	Came, FAAC o Other
Environment	Test / Production
Endpoint	L’URL base API del fornitore
Gate ID	L’identificativo dell’installazione lato fornitore
Allowlist format	License plate o RFID tag — a seconda di cosa legge il Suo hardware
API credentials	Blob JSON con quanto serve al fornitore ({"client_id": "…", "client_secret": "…"} per Came; {"api_key": "…"} per FAAC)

Clicchi Save, poi Test connection. La verifica chiama l’endpoint “recent passes” del fornitore — la pillola verde conferma.

Cattura della targa

Il campo targa appare nel form di creazione prenotazione (accanto alla nazionalità). Gli operatori possono anche lasciarlo vuoto — gli hook delle barriere fanno silenziosamente no-op se la targa non c’è, così il resto del flusso di prenotazione non viene impattato.

Eventi di transito

Se il fornitore supporta i webhook in uscita, configuri sul loro lato l’URL webhook di CampOne. L’endpoint è raggiungibile pubblicamente ma con verifica della firma — senza l’header HMAC corretto le richieste sono rifiutate. Gli eventi di transito vengono archiviati nel log di integrazione, così può tracciare chi è entrato e quando.

Aggiungere un nuovo fornitore di barriere

L’adapter ha un’astrazione interna BarrierProvider. Aggiungere un terzo fornitore (es. Nice) è una modifica di un solo file in services/providers.py — si rivolga al Suo partner di integrazione se ha una barriera diversa in loco.

Contatti di supporto

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

Limiti

• La documentazione di Came Connect e FAAC eBoard è in parte chiusa; entrambi gli adapter usano percorsi REST best-effort che possono richiedere aggiustamenti quando il fornitore confermerà gli endpoint esatti. Abbiamo tenuto la cucitura stretta in modo che una correzione di una riga risolva.
• La targa viene catturata al momento della creazione della prenotazione. Se un ospite cambia auto all’arrivo, dovrà aggiornare la targa sulla prenotazione: questo cancella la vecchia targa e registra la nuova.