Skip to main content
Il DB Apartments è il registro anagrafico degli appartamenti, è qui che lo studente inserisce e aggiorna tutte le informazioni sulle proprie strutture. Perché il bridge funzioni correttamente e generi voci KB accurate in Conduit, il database deve essere allineato al template Mattone: stessi nomi di campo, stessi tipi e, soprattutto, lo stesso listing_id presente in KrossBooking.

​
Campi obbligatori

Questi campi devono essere presenti nel DB Apartments con il tipo Notion corretto. Se uno o più campi mancano o hanno un tipo diverso, il bridge non riuscirà a creare le cartelle KB in Conduit.

​
Allineamento al template

Se il database dello studente è stato creato da zero o non rispetta la struttura richiesta, segui questi passaggi per allinearlo al template Mattone.
1

Duplica il template Apartments nel workspace dello studente

Apri il template Mattone Apartments (link disponibile nella piattaforma Mattone, sezione Risorse). Clicca su Duplica in alto a destra di Notion per copiarlo nel workspace dello studente. Il template include già tutti i campi obbligatori con i tipi corretti.
2

Compila i campi obbligatori per ogni appartamento

Per ogni appartamento, inserisci Nome, Indirizzo, Note accesso e carica almeno una foto. Imposta il campo Attivo su spuntato per tutti gli appartamenti che devono essere sincronizzati.
3

Verifica che listing_id corrisponda all'ID in KrossBooking

Per ogni appartamento, apri KrossBooking → Strutture → seleziona l’appartamento. Controlla che il listing_id nel DB Notion coincida esattamente con quello nel PMS. Questo è il campo che collega i dati KB alla prenotazione corretta.
4

Imposta il campo Smart Lock al tipo corretto

Nel campo Smart Lock, seleziona il dispositivo installato nell’appartamento: Nessuno, Shelly o SwitchBot. Questa informazione serve al bridge per popolare le istruzioni di accesso nella KB.
5

Avvia il test di sincronizzazione del bridge

Nella piattaforma Mattone, vai su Connessioni → Notion → Sincronizza ora. Dopo 2–3 minuti, verifica che le cartelle KB di Conduit siano state create o aggiornate per ogni appartamento attivo.
Il campo listing_id è il campo critico dell’integrazione. Un listing_id errato o mancante fa sì che il bridge crei cartelle KB disconnesse dalla prenotazione, oppure le colleghi all’appartamento sbagliato. Controlla sempre questo campo prima di dichiarare il setup completato.
Per trovare il listing_id corretto di un appartamento, vai su KrossBooking → Strutture, seleziona l’appartamento e guarda l’URL nel browser: l’ID numerico che appare nell’URL è il listing_id da inserire nel DB Notion.