# Documentazione - Per iniziare: Accedere, orientarsi e configurare il tuo parco - [Panoramica](/it-IT/aan-de-slag): Il tuo primo giorno in Tillor: accedere, configurare il parco nell'ordine giusto e creare il tuo primo cliente e la tua prima fattura. - [Accedere a Tillor](/it-IT/inloggen): Accedi con il tuo account Microsoft, Google o Apple e gestisci il tuo account e i metodi di accesso. - [Cercare in Tillor](/it-IT/zoeken): Trova un cliente, una fattura, una prenotazione o un terreno in un colpo solo con la ricerca globale. - [Vraag het Tillie](/it-IT/vraag-het-tillie): Stel een vraag over Tillor in gewone woorden en krijg een kort antwoord uit deze handleiding, met de pagina's erbij. - [Termini](/it-IT/begrippen): Le parole che incontri in Tillor, spiegate in modo semplice e con un link alla pagina che ne parla più a fondo. - [Dati e backup](/it-IT/gegevens-backups): Per quanto tempo Tillor conserva i backup e come chiedere a Tillor di ripristinare i dati a uno stato precedente. - [Novità](/it-IT/wat-is-nieuw): Le modifiche più importanti di Tillor, le più recenti per prime. - Nella pratica: Esempi completi che combinano più moduli - [Panoramica](/it-IT/praktijk): Quattro esempi svolti che mostrano come i moduli di Tillor lavorano insieme in una normale giornata al parco. - [Acquisire un cliente stagionale](/it-IT/praktijk/seizoensklant-binnenhalen): Dalla creazione del cliente al report dei pagamenti, con Jonas Maes che affitta il terreno 12 per la stagione. - [Fatturare il consumo](/it-IT/praktijk/verbruik-aanrekenen): Dal collegamento del contatore al terreno fino alla fattura automatica delle utenze, con Jonas Maes sul terreno 12. - [Una roulotte si libera](/it-IT/praktijk/stacaravan-komt-vrij): Dalla chiusura dell'occupazione all'attività di controllo finale e alla restituzione della cauzione, con un'automazione che prepara il lavoro di controllo. - [Un ospite alla barriera](/it-IT/praktijk/gast-aan-de-slagboom): Dall'impostazione del metodo di accesso a cosa succede con una targa, un codice QR o un tag NFC scaduti. - Moduli: Ogni modulo di Tillor, spiegato per attività - **Ospiti e soggiorno** - [Gestione clienti](/it-IT/klantenbeheer): Gestisci i clienti e i loro dati in Tillor - [Prenotazioni](/it-IT/reserveringen): Gestisci soggiorni, check-in e assegnazioni delle piazzole per gli ospiti in Tillor - [Occupazioni](/it-IT/bezettingen): Collega i clienti ai terreni e gestisci chi alloggia dove - [Scansioni di documenti d'identità](/it-IT/identiteitsscans): Creare clienti in fretta da una scansione ID, con periodo di conservazione e responsabilità - [Documenti](/it-IT/documenten): Archivia file presso i clienti e gestisci documenti come contratti, permessi e allegati - Firme: Far firmare documenti a clienti, referenti, colleghi e parti esterne - [Panoramica](/it-IT/handtekeningen): Fai firmare online un PDF come un contratto di locazione o un regolamento interno e conserva il documento firmato nella scheda del cliente. - [Richiedere firme](/it-IT/handtekeningen/handtekening-vragen): Scegli un PDF, aggiungi i firmatari, posiziona i campi firma e invia la richiesta. - [Seguire una richiesta](/it-IT/handtekeningen/opvolgen): Vedi chi ha già firmato, invia un promemoria, annulla una richiesta e scarica il PDF firmato. - [Come firma una persona](/it-IT/handtekeningen/ondertekenen): Cosa vede e cosa fa un cliente, un contatto, una parte esterna o un collega al momento della firma. - [Prova e validità](/it-IT/handtekeningen/bewijs-en-geldigheid): Cosa registra Tillor con una firma e che tipo di firma elettronica è. - [Commenti](/it-IT/notities): Aggiunga commenti interni a clienti, fatture, prenotazioni e altri record - **Fatturazione e pagamenti** - Fatture: Creare, registrare, inviare e correggere fatture - [Panoramica](/it-IT/facturen): Vedi tutte le tue fatture in un unico posto e scegli la guida giusta per creare, contabilizzare o correggere una fattura. - [Creare e modificare una fattura](/it-IT/facturen/aanmaken-en-bewerken): Crea una fattura in bozza per un cliente e compila le righe, così potrai poi contabilizzarla. - [Contabilizzare una fattura](/it-IT/facturen/boeken): Rendi definitiva una fattura in bozza, così riceve un numero di fattura e puoi inviarla e farla pagare. - [Inviare una fattura](/it-IT/facturen/versturen): Invia al cliente una fattura contabilizzata per e-mail, SMS, WhatsApp o posta, oppure invia un sollecito se non ha ancora pagato. - [Registrare un pagamento](/it-IT/facturen/betalingen-registreren): Registra un pagamento su una fattura contabilizzata, oppure assegna un pagamento già ricevuto. - [Stampare, scaricare o condividere una fattura](/it-IT/facturen/afdrukken-en-downloaden): Stampa una fattura, salvala come PDF, inviala a una stampante o condividi un link personale con il cliente. - [Correggere una fattura](/it-IT/facturen/corrigeren): Riporta in bozza una fattura contabilizzata, stornala con una nota di credito, copiala o spostala su un altro cliente. - [Stati della fattura](/it-IT/facturen/statussen): Cosa significano lo stato della fattura, lo stato di pagamento e il tipo di fattura. - Prodotti: Gestisci i prodotti e i prezzi che compaiono sulle fatture - [Panoramica](/it-IT/producten): I prodotti sono tutto ciò che può comparire su una fattura, dalle tariffe di soggiorno ai servizi e ai consumi dei contatori. - [Creare un prodotto](/it-IT/producten/product-aanmaken): Aggiungi un prodotto con prezzo e IVA, così puoi usarlo sulle fatture. - [Modificare o eliminare un prodotto](/it-IT/producten/product-bewerken): Modifica prezzo, IVA e impostazioni di un prodotto, disattivalo o eliminalo. - [Pianificare una modifica di prezzo](/it-IT/producten/prijzen-plannen): Pianifica un nuovo prezzo del prodotto da una data e calcola con il calcolatore IVA. - [Collegare azioni a un prodotto](/it-IT/producten/acties-instellen): Faccia fare automaticamente qualcosa a Tillor quando una riga di fattura con questo prodotto viene registrata o pagata. - [Azioni del prodotto](/it-IT/producten/productacties): Tutte le azioni che puoi collegare a un prodotto, con le loro impostazioni e cosa fanno alla contabilizzazione o al pagamento. - [Impostare righe di fattura extra](/it-IT/producten/bundel-instellen): Faccia inserire automaticamente a Tillor supplementi e spiegazioni sotto una riga principale della fattura. - [Passaggi del bundle](/it-IT/producten/bundel-velden): Tutti i campi di un passaggio prodotto e di un passaggio info, e la formula con cui un passaggio stabilisce le proprie righe di fattura. - [JSON del bundle](/it-IT/producten/bundel-json): La struttura JSON di un bundle (versione 1), per le importazioni e per chi costruisce un bundle fuori dalla schermata. - Elaborazione pagamenti - [Panoramica](/it-IT/betalingsverwerking): Scegli il metodo di pagamento giusto per una fattura e scopri dove ritrovare i tuoi pagamenti. - [Registrare un pagamento](/it-IT/betalingsverwerking/betaling-registreren): Registra un pagamento su una fattura contabilizzata e scegli il metodo adatto alla situazione. - [Ritrovare i pagamenti](/it-IT/betalingsverwerking/betalingen-bekijken): Cerca i pagamenti per fattura o nella panoramica, guarda i dettagli e richiedi lo stato aggiornato. - [Far pagare un cliente online](/it-IT/betalingsverwerking/online): Invia al cliente il link di pagamento di una fattura e scopri cosa vede il cliente quando sceglie e conclude un pagamento. - [Pagare con un terminale POS](/it-IT/betalingsverwerking/terminal): Invia una richiesta di pagamento al terminale POS della reception e lascia che la fattura si aggiorni automaticamente. - [Registrare contanti e bonifici](/it-IT/betalingsverwerking/contant): Registra un pagamento arrivato fuori da Tillor, come contanti alla reception o un bonifico bancario. - [Creare un trasferimento interno](/it-IT/betalingsverwerking/interne-overboeking): Sposta un importo aperto da una fattura a un'altra fattura contabilizzata dello stesso cliente. - [Far firmare un mandato SEPA](/it-IT/betalingsverwerking/mandaat): Chiedi a un cliente di firmare un mandato SEPA, a distanza per e-mail oppure alla reception sul tablet. - [Revocare o reinviare un mandato](/it-IT/betalingsverwerking/mandaat-beheren): Gestisci le richieste di mandato in sospeso e revoca un mandato SEPA attivo quando al cliente non si può più addebitare. - [Incassare una fattura con un mandato](/it-IT/betalingsverwerking/incasso): Lascia che Tillor incassi automaticamente una fattura con il mandato SEPA attivo del cliente. - [Gruppi di pagamento](/it-IT/betalingsverwerking/groepen): Raggruppa più pagamenti sotto un nome e collegali in un colpo solo a una fattura contabilizzata. - Contabilità: Report dei pagamenti e integrazione contabile - [Panoramica](/it-IT/boekhouden): Trasferisci pagamenti e fatture al tuo software di contabilità. - Report dei pagamenti: Report, sistemi contabili e metodi di pagamento - [Panoramica](/it-IT/boekhouden/betalingsrapporten): Raggruppa i pagamenti per giorno o periodo e inviali alla tua contabilità. - Sistemi contabili: Integrazione con il software contabile - [Panoramica](/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen): Panoramica e integrazione con il software contabile - [Admisol](/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen/admisol): Integrazione con il software contabile Admisol - [Odoo](/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen/odoo): Integrazione con il software di contabilità Odoo per clienti e fatture - [Exact Online](/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online): Integrazione con il software contabile Exact Online (su richiesta) - Metodi di pagamento: Mollie, conti bancari e trasferimenti interni - [Metodi di pagamento](/it-IT/boekhouden/betalingsrapporten/betaalmethodes): Panoramica dei metodi di pagamento nei report dei pagamenti - [Mollie](/it-IT/boekhouden/betalingsrapporten/betaalmethodes/mollie): Liquidazioni Mollie, pagamenti e metadati - [Conti bancari](/it-IT/boekhouden/betalingsrapporten/betaalmethodes/ponto): Transazioni bancarie tramite open banking - [Trasferimenti interni](/it-IT/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers): Trasferimenti interni tra fatture dello stesso cliente - [IVA e imposte](/it-IT/boekhouden/belasting): Imposta le aliquote IVA e i regimi IVA come l'inversione contabile, e convalida le partite IVA dei clienti - [Peppol](/it-IT/boekhouden/peppol): Invia fatture elettroniche tramite la rete Peppol - **Comunicazione** - Inbox: Conversazioni WhatsApp, Messenger, Instagram e chat del sito in un'unica panoramica - [Panoramica](/it-IT/inbox): Tutti i messaggi di WhatsApp, Messenger, Instagram e della chat sul tuo sito web in un'unica inbox. - [Leggere e rispondere alle conversazioni](/it-IT/inbox/gesprekken): Apri l'inbox, rispondi ai messaggi dei clienti, archivia le conversazioni concluse ed etichettale con i tag. - [Assistente IA dell'inbox (Tillie)](/it-IT/inbox/inbox-ai-assistant): Risposte automatiche e passaggio al team per le conversazioni dell'inbox su chat del sito web, WhatsApp, Messenger e Instagram - [Messenger](/it-IT/inbox/messenger): Collegare Facebook Messenger all'inbox di Tillor - [Instagram](/it-IT/inbox/instagram): Collegare Instagram Direct all'inbox di Tillor - [WhatsApp Business](/it-IT/inbox/whatsapp-business-inbox): Collegare WhatsApp Business all'inbox di Tillor - [Mettere la chat sul tuo sito web](/it-IT/inbox/website-chat): Installa l'integrazione Chat sul sito web e incolla un unico snippet sul tuo sito, così i visitatori possono contattare il tuo team dall'inbox. - [Impostazioni della chat del sito web](/it-IT/inbox/website-chat-instellingen): Tutti i campi del widget di chat, il modulo per i visitatori e le opzioni che puoi impostare sullo snippet. - [Conversazioni tramite chat del sito web](/it-IT/inbox/website-chat-gesprekken): Cosa vede il tuo team nell'inbox di un visitatore del sito web e cosa vede il visitatore nel widget. - Comunicazione: Gestire email, telefonia e messaggi - [Panoramica](/it-IT/communicatie): Telefonate, messaggi inviati e commenti: dove trovi la comunicazione con i clienti e come seguirla - [Inviare una fattura o un sollecito](/it-IT/communicatie/e-mails): Invia una fattura contabilizzata o un sollecito a un cliente per e-mail, SMS, posta o WhatsApp e controlla se è arrivato - [Tipi di notifica](/it-IT/communicatie/notificatietypes): Tutti i tipi di messaggio che Tillor invia, per argomento, e quando parte ciascun messaggio - [Chiamate telefoniche](/it-IT/communicatie/telefoongesprekken): Vedi chi ha chiamato, riascolta le registrazioni, leggi le trascrizioni e invia via SMS i dati della tua organizzazione durante una chiamata - Provider: Provider di telefonia per le comunicazioni - [Panoramica](/it-IT/communicatie/providers): Integrazioni di telefonia per chiamate e azioni correlate in Tillor - [Telefonia Voys](/it-IT/communicatie/providers/voys): Collega le telefonate in arrivo ai profili cliente tramite l'integrazione Voys - [Twilio](/it-IT/communicatie/providers/twilio): Recapito di SMS e WhatsApp tramite Twilio quando Tillor lo ha configurato a livello di piattaforma - [Notifiche](/it-IT/notificaties): Veda quali messaggi Tillor ha inviato a clienti e colleghi, se sono arrivati e cosa fare quando un messaggio non riesce - **Parco e tecnica** - [Parco](/it-IT/park): Il riepilogo del Suo parco con la mappa, i terreni, i contatori, i quadri contatori e il meteo. - [Terreni](/it-IT/terreinen): Crea i terreni del tuo parco, definisci la tariffa e collega i contatori, così puoi metterci sopra i clienti. - [Mappa](/it-IT/kaart): Visualizza il tuo parco su una mappa interattiva e disegna i confini dei terreni - [Meteo](/it-IT/weer): Consulta il meteo giornaliero nella località del tuo parco, accanto ai consumi e all'occupazione - [Controllo accessi](/it-IT/toegangscontrole): Decidi chi può entrare nel tuo parco con una targa, un tag NFC, un codice QR o un PIN, apri le sbarre a distanza e vedi chi è entrato e quando. - Gestione contatori: Gestisci a distanza i contatori di acqua ed energia - [Panoramica](/it-IT/meterbeheer): Leggi a distanza i contatori di acqua, gas ed elettricità e addebita il consumo al cliente che si trova sul terreno. - [Collegare un contatore a un cliente](/it-IT/meterbeheer/meter-koppelen): Collega un contatore a un terreno e assegna al cliente un'occupazione su quel terreno, così il consumo finisce a quel cliente. - [Vedere letture e trend](/it-IT/meterbeheer/meterstanden-en-trends): Vedi l'ultima lettura di un contatore, il consumo per giorno o ora e se il consumo è più alto del normale. - [Fatturare il consumo](/it-IT/meterbeheer/verbruik-factureren): Metti il consumo in sospeso di acqua, gas o corrente di un cliente su una fattura, oppure lascia che Tillor lo faccia automaticamente. - [Allarmi e stato dei contatori](/it-IT/meterbeheer/alarmen-en-status): Vedi quali contatori hanno un allarme o non inviano più nulla, e cancella un allarme dopo averlo risolto. - [Eliminare un contatore](/it-IT/meterbeheer/meter-verwijderen): Rimuovi definitivamente da Tillor un contatore che non esiste più, comprese tutte le sue letture. - [Batch di consumo](/it-IT/meterbeheer/consumptie-batches): Come vengono tracciati e fatturati i periodi di consumo - NFC: Carte NFC per accessi e servizi - [Panoramica](/it-IT/nfc): Con un tag NFC i clienti usano la doccia, una porta o una colonnina di ricarica avvicinandolo a un lettore. Qui leggi come sono collegati tag, clienti e saldo. - [Gestire i tag](/it-IT/nfc/nfc-tags): Collega un tag NFC a un cliente, modifica il saldo, blocca un tag smarrito e stabilisci dove funziona. - [Transazioni](/it-IT/nfc/nfc-transacties): Vedi quando e perché il saldo di un tag NFC è cambiato, e cosa significano stati e colonne. - Stampante: Configurare le stampanti e stampare documenti - [Panoramica](/it-IT/printer): Invii fatture, scontrini ed etichette da Tillor a una stampante del Suo parco, manualmente o in automatico al pagamento. - [Impostare le stampanti](/it-IT/printer/printers-instellen): Attivi la stampa, inserisca gli indirizzi di rete delle stampanti e scelga quando Tillor stampa gli scontrini. - [Stampare una fattura o uno scontrino](/it-IT/printer/documenten-afdrukken): Stampi una fattura sulla stampante A4 o sulla stampante di scontrini, oppure faccia stampare le fatture pagate in automatico. - [Gestire la coda di stampa](/it-IT/printer/printwachtrij): Segua i lavori di stampa, metta in pausa la stampa e riprovi o annulli i lavori non riusciti. - [Impostazioni di stampa](/it-IT/printer/afdrukinstellingen): Tutte le impostazioni per stampanti, orari di stampa e stampa automatica in Impostazioni > Stampa. - [Connector](/it-IT/connector): La scatolina nel tuo parco che collega Tillor a stampanti di scontrini, sbarre, controller di accesso e lettori di documenti, e cosa fare quando non è connessa. - Integrazioni: Collegare servizi esterni a Tillor - [Panoramica](/it-IT/integraties): Collega a Tillor servizi esterni come provider di pagamento, contabilità, telecamere e posta, tutto in un unico posto. - [Installare un'integrazione](/it-IT/integraties/integratie-installeren): Cerca un'integrazione, inserisci i dati e collegala a Tillor, oppure rimuovi di nuovo il collegamento. - [Collegare UniFi Protect](/it-IT/integraties/unifi-protect): Apri la registrazione di un punto di accesso in UniFi Protect e mostra i pagamenti in contanti e con carta come testo sulle immagini delle telecamere. - [Collegare Partoo](/it-IT/integraties/partoo): Invia automaticamente i tuoi orari di apertura alla tua sede Partoo, così su Google e sulle altre schede sono corretti. - [Collegare Outlook](/it-IT/integraties/outlook): Consulta sul profilo del cliente la posta di un cliente dalle tue caselle Outlook. - **Organizzazione e lavoro** - Attività: Tenere traccia dei lavori, assegnarli e seguirli - [Panoramica](/it-IT/taken): Tieni traccia dei lavori, assegnali e seguili con viste, bacheche e un calendario - [Viste](/it-IT/taken/weergaven): Crea elenchi e viste filtrate, decidi chi li vede e mantienili aggiornati - [Tabella, bacheca e calendario](/it-IT/taken/indelingen): Scegli come una vista mostra le tue attività e come vengono raggruppate e ordinate - [Filtrare](/it-IT/taken/filteren): Ritrova le attività per stato, priorità, persona assegnata, etichetta, scadenza e testo - [Dettagli dell'attività](/it-IT/taken/taakdetails): Tutto ciò che puoi registrare in un'attività, dalla scadenza e dal promemoria alle sottoattività e al tempo impiegato - [Attività private](/it-IT/taken/prive-taken): Come le viste in cui si trova un'attività determinano chi la vede - [Etichette](/it-IT/taken/labels): Classificare le attività con etichette colorate e far impostare automaticamente una scadenza - [Notifiche](/it-IT/taken/meldingen): Promemoria, scadenze, assegnazioni e il riepilogo giornaliero di una vista - [Condividere le attività](/it-IT/taken/delen): Condividi le tue attività o una vista come pagina di sola lettura o come abbonamento al calendario - [Attività in altre pagine](/it-IT/taken/taken-op-andere-paginas): Creare attività da clienti, fatture, conversazioni e altro, e ritrovarle dove appartengono - Automazioni: Lascia che Tillor crei attività, invii promemoria e richiami i tuoi sistemi - [Panoramica](/it-IT/automatiseringen): Fai in modo che Tillor faccia qualcosa da solo quando succede qualcosa, come creare un'attività o inviare un promemoria di pagamento - [Per iniziare](/it-IT/automatiseringen/aan-de-slag): La panoramica, i modelli e l'editor, e come salvare e attivare un'automazione - [Trigger](/it-IT/automatiseringen/triggers): Scegli quando parte un'automazione, anche in una data come l'arrivo, filtra i casi e limitala a una volta per record - [Condizioni, smistamenti e ritardi](/it-IT/automatiseringen/logica): Fai dividere un flusso con Se / altrimenti e Smista, fallo attendere, cerca record, scorri gli elenchi e chiedi una decisione - Azioni: Tutto ciò che un'automazione può fare - [Panoramica](/it-IT/automatiseringen/acties): Tutto ciò che un'automazione può fare, con tutti i campi per azione - [Attività](/it-IT/automatiseringen/acties/taken): Crea attività, cercale e aggiorna stato, priorità o assegnazione. - [Documenti](/it-IT/automatiseringen/acties/documenten): Cercare i documenti di un cliente e modificarne il tipo o lo stato - [Ospiti e messaggi](/it-IT/automatiseringen/acties/gasten-en-berichten): Invia messaggi a ospiti e colleghi, e aggiorna clienti, conversazioni e prenotazioni. - [Fatture e pagamenti](/it-IT/automatiseringen/acties/facturen-en-betalingen): Invia promemoria e fatture, e gestisci i pagamenti da un'automazione. - [Accesso e dispositivi](/it-IT/automatiseringen/acties/toegang-en-toestellen): Gestisci accesso, corrente, tag NFC e tablet da un'automazione. - [Integrazioni](/it-IT/automatiseringen/acties/integraties): Invia un webhook o chiama un'API da un'automazione. - [Variabili e modelli](/it-IT/automatiseringen/variabelen): Usa i dati dell'evento e dei passaggi precedenti in titoli, messaggi e richieste - [Chi esegue un'automazione?](/it-IT/automatiseringen/workflow-gebruiker): Perché i compiti e i commenti di un'automazione risultano a nome di un utente di sistema fisso - [Test ed esecuzioni](/it-IT/automatiseringen/testen-en-uitvoeringen): Prova un flusso senza inviare nulla e guarda cosa hanno fatto le esecuzioni reali - [Problemi e attivazione](/it-IT/automatiseringen/problemen): Perché un'automazione non può essere attivata e cosa significano i messaggi nell'editor - [Esempio: controllo caravan in affitto](/it-IT/automatiseringen/voorbeeld-nalopen): Costruisci passo dopo passo un flusso che dopo la partenza crea un'attività di controllo con sottoattività, oppure alza la priorità dell'attività aperta - [Domande frequenti](/it-IT/automatiseringen/veelgestelde-vragen): Limiti delle automazioni, spiegazioni su pausa e modifiche, e cosa fare se non succede nulla - Campi personalizzati: Aggiungi campi tuoi a clienti, terreni, prenotazioni e altri record - [Panoramica](/it-IT/eigen-velden): Conserva dati che Tillor non conosce, come numeri di cauzione, numero di cani o un rimessaggio invernale, come campo aggiuntivo su una scheda - [Creare un campo personalizzato](/it-IT/eigen-velden/veld-aanmaken): Aggiungi un campo extra a un tipo di scheda, scegli una posizione nel modulo e salvalo - [Creare elenchi di scelta](/it-IT/eigen-velden/keuzelijsten): Definisci opzioni che riutilizzi nei tipi Scelta e Scelta multipla su più campi personalizzati - [Tipi di campo e impostazioni](/it-IT/eigen-velden/veldtypes): Quali tipi di campi personalizzati esistono, quali impostazioni ha ogni tipo e quali limiti valgono - [Visibilità e accesso](/it-IT/eigen-velden/zichtbaarheid-en-toegang): Dove ritrovi i campi personalizzati in un record e come decidi chi può vederli o modificarli - Utenti e organizzazione: Gestire utenti, permessi, gruppi e impostazioni dell'organizzazione - [Panoramica](/it-IT/gebruikers): Chi ha accesso a Tillor, che cosa può fare e dove gestisci le impostazioni della tua organizzazione - [Organizzazione](/it-IT/gebruikers/organisaties): Impostazioni dell'organizzazione in Tillor - [Invitare utenti e assegnare permessi](/it-IT/gebruikers/gebruikers-en-rechten): Invita un collega nella tua organizzazione, stabilisci che cosa può fare e imposta le sue notifiche - [Gruppi](/it-IT/gebruikers/groepen): Raggruppa i colleghi per assegnare loro attività, menzionarli e condividere viste - [Gruppi Microsoft Entra](/it-IT/gebruikers/microsoft-entra): Fai aggiornare automaticamente i membri dei gruppi da Microsoft Entra ID tramite il provisioning SCIM - [Impostazioni di fatturazione](/it-IT/gebruikers/instellingen-facturatie): Stabilisci che cosa compare nei PDF delle fatture, quanto tempo hanno i clienti per pagare e quali aliquote IVA puoi scegliere. - [Impostazioni dei pagamenti](/it-IT/gebruikers/instellingen-betalingen): Attiva il metodo di pagamento Altro, scegli il valore predefinito dei promemoria per i bonifici e imposta l'indirizzo mittente delle notifiche. - [Impostare i periodi di locazione](/it-IT/gebruikers/instellingen-huurperiodes): Stabilisci quali frequenze di locazione puoi scegliere in un'occupazione, come mensile o annuale. - [Impostazioni del controllo accessi](/it-IT/gebruikers/instellingen-toegangscontrole): Stabilisci se i veicoli con una targa scaduta possono ancora uscire fuori dagli orari di apertura e quanti giorni dura la tolleranza. - [Registro attività](/it-IT/activiteitenlog): Consulta le azioni e le modifiche in Tillor nelle pagine di dettaglio di clienti, fatture e altri record - App mobile: Tablet e chioschi alla reception e sul terreno - [Panoramica](/it-IT/mobiele-app): L'app Tillor su un tablet, un chiosco o un telefono nel tuo parco, e come gestisci quei dispositivi da Tillor. - [Gestire un tablet o un chiosco](/it-IT/mobiele-app/tablets-en-kiosken): Trova un dispositivo in Tillor, modifica le sue impostazioni e inviale al tablet o al chiosco, anche a tutti i dispositivi dello stesso tipo contemporaneamente. - [Impostare la schermata iniziale e una presentazione](/it-IT/mobiele-app/startscherm-en-diavoorstelling): Metti un testo di benvenuto, foto e scorciatoie nella schermata iniziale di un tablet o di un chiosco. - [Impostare il riposo notturno dello schermo](/it-IT/mobiele-app/nachtrust-instellen): Fai spegnere o annerire di notte lo schermo di un tablet o di un chiosco, a orari fissi o secondo gli orari di apertura della tua organizzazione. - [Configurare un chiosco](/it-IT/mobiele-app/kiosk-inrichten): Bloccare un tablet Android nell'app Tillor, inclusi batteria, blocco schermo e un aggiornamento via USB - [Impostazioni del dispositivo](/it-IT/mobiele-app/toestelinstellingen): Schermata iniziale, presentazione, schermo, suono, blocco chiosco e dati del dispositivo, scheda per scheda - [Inviare un comando a un tablet](/it-IT/mobiele-app/acties-op-afstand): Riattiva un tablet, riavvialo o chiedi cosa c'è sul suo schermo, senza andare fino al dispositivo. - [Diagnostica e cronologia](/it-IT/mobiele-app/diagnose-en-geschiedenis): Cosa mostra la pagina del dispositivo sull'ultimo messaggio di un tablet e sul registro di quel dispositivo. - Controller: Docce, porte, tag e connessione - [Panoramica](/it-IT/controllers): Un controller è il piccolo schermo con lettore di tag presso una doccia, una porta o un punto di ricarica. Qui leggi cosa fa e come si collega a clienti, tag e saldo. - [Collegare un controller](/it-IT/controllers/controller-koppelen): Collega un nuovo controller e approvalo in Tillor, così gli ospiti possono usarci il loro tag. - [Gestire un controller](/it-IT/controllers/controller-beheren): Dai un nome, un tipo e un gruppo a un controller, riavvialo, aggiornalo o eliminalo. - [Configurare le reti Wi-Fi](/it-IT/controllers/wifi-netwerken): Imposta da Tillor una o più reti Wi-Fi su un controller, in ordine di priorità. - [Impostazioni controller](/it-IT/controllers/settings): Cosa significa ogni impostazione di un controller: ACL, rete, aggiornamenti e relè, con i valori predefiniti. - [Aggiornamenti firmware](/it-IT/controllers/updates): Decidi quando e con quale frequenza un controller si aggiorna da solo, e disattiva temporaneamente gli aggiornamenti. - [Glossario](/it-IT/controllers/lexicon): I termini relativi ai controller spiegati - Risoluzione dei problemi - [Messaggi sullo schermo](/it-IT/controllers/troubleshooting/scherm): Cosa significa il messaggio sullo schermo del controller? - [Problemi di connessione](/it-IT/controllers/troubleshooting/verbinding): Wi-Fi, connessione a Tillor e adozione - Sviluppatori: API, webhook, SSE, MQTT e MCP - [Panoramica](/it-IT/ontwikkelaars): Accesso API, webhook ed eventi in tempo reale per le integrazioni - [API HTTP](/it-IT/ontwikkelaars/http): Chiavi API, base URL e autenticazione per la REST API di Tillor - [MCP](/it-IT/ontwikkelaars/mcp): Collega strumenti di AI a Tillor tramite https://mcp.tillor.dev - [OAuth-clients](/it-IT/ontwikkelaars/oauth-clients): Een eigen applicatie of externe dienst laten aanmelden met Tillor, en bepalen wie dat mag - [Notifiche esterne](/it-IT/ontwikkelaars/externe-notificaties): Registra le e-mail che il tuo sistema ha inviato a un cliente, così il personale le ritrova in Tillor - [Webhook](/it-IT/ontwikkelaars/webhooks): Ricevi eventi in tempo reale tramite HTTP POST sul tuo endpoint - [Automazioni](/it-IT/ontwikkelaars/automatiseringen): Cosa riceve il tuo sistema da un'automazione, la richiesta API come utente Workflow e la struttura di un flusso - [Server-Sent Events (SSE)](/it-IT/ontwikkelaars/sse): Ricevi eventi in tempo reale tramite una connessione di lunga durata - [Event-index](/it-IT/ontwikkelaars/events): Alle realtime events met permissie, levering en een voorbeeld-payload - [MQTT](/it-IT/ontwikkelaars/mqtt): Pub/sub tramite MQTT nel namespace della tua organizzazione, con JWT o credenziali statiche - [Metadati Mollie](/it-IT/ontwikkelaars/mollie-metadata): Namespace tillor sui pagamenti Mollie per collegamento, gruppi e contabilità - [API della chat del sito web](/it-IT/ontwikkelaars/website-chat): Collega un modulo tuo al widget di chat o crea una tua interfaccia di chat con l'SDK del widget, REST, digitazione, SSE e attività dei visitatori. - Esempi: Esempi di codice e di payload - [Panoramica](/it-IT/ontwikkelaars/voorbeelden): Esempi di codice e di payload per HTTP, webhook e SSE - [Esempi HTTP](/it-IT/ontwikkelaars/voorbeelden/http): Esempi di cURL e di richieste per l'API di Tillor - [API degli orari di apertura](/it-IT/ontwikkelaars/voorbeelden/opening-hours): Recuperare per un sito web gli orari di apertura risolti e i prossimi festivi - [Esempi di webhook](/it-IT/ontwikkelaars/voorbeelden/webhooks): Payload degli eventi ed esempi di POST dei webhook - [Esempi SSE](/it-IT/ontwikkelaars/voorbeelden/sse): Node.js e cURL per i Server-Sent Events - Riferimento API: Ogni endpoint dell'API Tillor, con esempi e playground - [Panoramica](/it-IT/api-referentie): Ogni endpoint dell'API HTTP di Tillor, con parametri, richieste di esempio e un playground. - Access control - [List Access Log Entries](/it-IT/api-referentie/access-control/list-access-log-entries): Lists access log entries with filtering, sorting, and pagination - [Get Access Log Entry](/it-IT/api-referentie/access-control/get-access-log-entry): Returns one access log entry by ID, with optional includes - [Patch Access Log Entry Metadata](/it-IT/api-referentie/access-control/patch-access-log-entry-metadata): Super-admin correction: merges validated LPR metadata keys (e.g. expiredExitGrace) into one access log entry. Access log rows are otherwise connector-owned and immutable over the API. - [Open AccessPoint](/it-IT/api-referentie/access-control/open-accesspoint): Opens an access point by ID - [Close AccessPoint](/it-IT/api-referentie/access-control/close-accesspoint): Closes an access point by ID (optional closeConfig required for CONNECTOR) - [Clear APB list on KC80 controllers (by credential type)](/it-IT/api-referentie/access-control/clear-apb-list-on-kc80-controllers-by-credential-type): Creates SYSTEM controller operations (CBLADALL) for each active Koole KC80 whose access method types include NFC or QR_CODE, then pings the connector via operation-sync MQTT to claim and execute them immediately (no full access-control sync). - [Push pending access-control data from connector](/it-IT/api-referentie/access-control/push-pending-access-control-data-from-connector): Publishes MQTT so the connector uploads queued access-log entries (e.g. LPR), applies connector controller operations, and polls connected access hardware for pending log lines. - [Reset connector access-control cache](/it-IT/api-referentie/access-control/reset-connector-access-control-cache): Publishes MQTT so the connector clears its local access-control cache (queued logs, synced methods/points, device logs) and then runs a full sync to rebuild. Intended for debug/ops recovery. - [Clean up trash LPR readings](/it-IT/api-referentie/access-control/clean-up-trash-lpr-readings): Queues a Trigger run that deletes UNKNOWN LPR OCR ghosts (implausible plates or worse variants of a better same-barrier neighbor). Registered, coupled, and customer-linked rows are kept. - [List Access Methods](/it-IT/api-referentie/access-control/list-access-methods): Lists all access methods with filtering, sorting, and pagination - [Add Access Method](/it-IT/api-referentie/access-control/add-access-method): Adds one or more access methods. For QR_CODE, optional quantity creates multiple distinct QR methods with generated values; optional printThermalOnCreate queues a thermal ticket print per created QR. - [Get Access Method by ID](/it-IT/api-referentie/access-control/get-access-method-by-id): Gets an access method by its ID - [Delete Access Method](/it-IT/api-referentie/access-control/delete-access-method): Deletes an access method - [Update Access Method](/it-IT/api-referentie/access-control/update-access-method): Updates an access method - [List Unused NFC Tags](/it-IT/api-referentie/access-control/list-unused-nfc-tags): Returns NFC tags from the card registry that are not assigned to any access method. Optionally include a specific value (e.g. current selection) in the list. - [Delete Access Methods](/it-IT/api-referentie/access-control/delete-access-methods): Deletes multiple access methods by id (maximum 100) - [Get QR Code Image](/it-IT/api-referentie/access-control/get-qr-code-image): Returns base64 PNG of the QR code for a QR_CODE access method - [Send QR Access Method Notification](/it-IT/api-referentie/access-control/send-qr-access-method-notification): Sends the QR code personal URL to the customer by email, SMS, and/or WhatsApp. - [Print QR Code Ticket](/it-IT/api-referentie/access-control/print-qr-code-ticket): Queues a QR code for printing as a thermal entrance ticket - [Sync access method with connector](/it-IT/api-referentie/access-control/sync-access-method-with-connector): For NFC/QR, queues remove+add whitelist operations on matching controllers and pings the connector. For LPR, queues empty-command operations on LPR controllers when present, otherwise one controller-less history op (connector ACK), and pings the connector to refetch access methods. - [List access points](/it-IT/api-referentie/access-control/list-access-points): Lists all access points with filtering, sorting, and pagination - [Create AccessPoint](/it-IT/api-referentie/access-control/create-accesspoint): Creates a new access point - [List AccessPoint State Events](/it-IT/api-referentie/access-control/list-accesspoint-state-events): Lists physical open/closed history for access points (e.g. Shelly i4 contact sensors), with filtering, sorting, and pagination - [Get UniFi Protect playback context](/it-IT/api-referentie/access-control/get-unifi-protect-playback-context): Returns the cloud console id and access-point camera mapping used to open Protect timelapse links. - [Get AccessPoint by ID](/it-IT/api-referentie/access-control/get-accesspoint-by-id): Gets an access point by its ID with optional includes - [Delete AccessPoint](/it-IT/api-referentie/access-control/delete-accesspoint): Deletes an access point - [Update AccessPoint](/it-IT/api-referentie/access-control/update-accesspoint): Updates an access point - [Export Access Log Entries](/it-IT/api-referentie/access-control/export-access-log-entries): Generates an XLSX export of all access log entries. - [Export Access Log Entries by Customer](/it-IT/api-referentie/access-control/export-access-log-entries-by-customer): Generates an XLSX export of access log entries for a specific customer. - [Import Access Methods from Access Export](/it-IT/api-referentie/access-control/import-access-methods-from-access-export): Imports access methods from an Excel export file (e.g. Camping Vlasaard export). Matches customers by the '#' column (customer displayId). - [List Access Method Operations](/it-IT/api-referentie/access-control/list-access-method-operations) - [Get Access Method Operation](/it-IT/api-referentie/access-control/get-access-method-operation) - [List Access Controllers](/it-IT/api-referentie/access-control/list-access-controllers) - [Create Access Controller](/it-IT/api-referentie/access-control/create-access-controller): Creates an access controller (for example a KC80). Optional accessPointLinks attach entrance/exit points. - [Get Access Controller](/it-IT/api-referentie/access-control/get-access-controller) - [Update Access Controller](/it-IT/api-referentie/access-control/update-access-controller): Updates an access controller. When accessPointLinks is sent, it replaces the existing links. - [Delete Access Controller](/it-IT/api-referentie/access-control/delete-access-controller): Deletes an access controller and its access-point links. - Account - [Get Current User](/it-IT/api-referentie/account/get-current-user): Returns the current user's session information - [Update User Locale](/it-IT/api-referentie/account/update-user-locale): Updates the authenticated user's locale preference in the database - [Update User Phone](/it-IT/api-referentie/account/update-user-phone): Updates the authenticated user's phone number in the database - [Get User By ID](/it-IT/api-referentie/account/get-user-by-id): Returns a user by their ID. Only returns profile data if the user shares an organization with the caller. - [List Sessions](/it-IT/api-referentie/account/list-sessions): Returns all active sessions for the current user (without session tokens), including app metadata when available. - [Revoke Session](/it-IT/api-referentie/account/revoke-session): Deletes an active session for the current user. Does not return session tokens. - Addresses - [List address suggestions](/it-IT/api-referentie/addresses/list-address-suggestions): Completes a partly typed postal address from OpenStreetMap data (Geoapify, or the public Photon instance without a key), nearest to the organization map center first. Returns an empty list when the lookup service is unavailable. - Admisol - [Get Customer Open Documents](/it-IT/api-referentie/admisol/get-customer-open-documents): Retrieves a list of open customer documents (invoices) from Admisol. - Api keys - [List API Keys](/it-IT/api-referentie/api-keys/list-api-keys): Lists all API keys for the authenticated user - [Create API Key](/it-IT/api-referentie/api-keys/create-api-key): Creates a new API key for the authenticated user - [Delete API Key](/it-IT/api-referentie/api-keys/delete-api-key): Deletes an API key - [Update API Key](/it-IT/api-referentie/api-keys/update-api-key): Updates an API key's name, description and the permissions it is limited to - [Renew API Key](/it-IT/api-referentie/api-keys/renew-api-key): Regenerates an API key (invalidates the old, returns full new key once) - Attachments - [List attachments](/it-IT/api-referentie/attachments/list-attachments): Lists attachments with filtering, sorting, and pagination. - [Get attachment](/it-IT/api-referentie/attachments/get-attachment): Retrieves an attachment by its ID. - [Update attachment](/it-IT/api-referentie/attachments/update-attachment): Renames an attachment that is not linked to a sent inbox message or event log. - [Upload attachment](/it-IT/api-referentie/attachments/upload-attachment): Uploads a file as an orphan attachment. Pass purpose so inbox uploads require inbox write permission. With purpose `customField` (plus customFieldEntity and customFieldPath) the file is for a FILE custom field: the field's write access, type and size limits apply; save the returned id as the field's value, an upload no record holds is deleted after a day. Blobs are always encrypted at rest (AES-256-GCM). - [Download attachment](/it-IT/api-referentie/attachments/download-attachment): Downloads an attachment. - [Preview attachment](/it-IT/api-referentie/attachments/preview-attachment): Returns a signed preview URL for the attachment. Open in a browser to view PDFs/images inline. - [Ensure attachment preview](/it-IT/api-referentie/attachments/ensure-attachment-preview): Returns how to show the attachment in a browser (image or PDF rendition). Starts PDF generation for office files and Outlook messages when the rendition is missing; poll while the status is `generating`. - [Delete attachment](/it-IT/api-referentie/attachments/delete-attachment): Deletes an attachment that is not yet linked to a sent inbox message. - Audit - [List Audit Logs](/it-IT/api-referentie/audit/list-audit-logs): Lists audit logs with filtering, sorting, and pagination. - [Export Audit Logs](/it-IT/api-referentie/audit/export-audit-logs): Exports every audit log entry in the period as a ZIP archive with the data file (CSV or JSON Lines, UTC timestamps), a manifest with its SHA-256 checksum, row count and exporter, and a sha256sum-compatible checksum file. The export is itself recorded in the audit log with the same checksum. - [List Customer Audit Logs](/it-IT/api-referentie/audit/list-customer-audit-logs): Lists audit logs for a customer with filtering, sorting, and pagination. - [Get Audit Log](/it-IT/api-referentie/audit/get-audit-log): Gets a specific audit log by its ID with optional includes. - [Delete Audit Log](/it-IT/api-referentie/audit/delete-audit-log): Permanently deletes an audit log entry. Restricted to super admins. - Auth - [List API Keys](/it-IT/api-referentie/auth/list-api-keys): Lists all API keys for the authenticated user - [Create API Key](/it-IT/api-referentie/auth/create-api-key): Creates a new API key for the authenticated user - [Delete API Key](/it-IT/api-referentie/auth/delete-api-key): Deletes an API key - [Update API Key](/it-IT/api-referentie/auth/update-api-key): Updates an API key's name, description and the permissions it is limited to - [Renew API Key](/it-IT/api-referentie/auth/renew-api-key): Regenerates an API key (invalidates the old, returns full new key once) - [List OAuth Clients](/it-IT/api-referentie/auth/list-oauth-clients): Lists all OAuth clients for the authenticated user - [Create OAuth Client](/it-IT/api-referentie/auth/create-oauth-client): Creates a new OAuth client for the authenticated user - [Delete OAuth Client](/it-IT/api-referentie/auth/delete-oauth-client): Deletes an OAuth client - [Update OAuth Client](/it-IT/api-referentie/auth/update-oauth-client): Updates an OAuth client - [Rotate OAuth Client Secret](/it-IT/api-referentie/auth/rotate-oauth-client-secret): Rotates the client secret (confidential clients only) - Automations - [List Automations](/it-IT/api-referentie/automations/list-automations): Lists the organization's automations. Needs automations:read (viewing) or automations:write (changing). - [Create Automation](/it-IT/api-referentie/automations/create-automation): Creates an automation. It starts disabled. Needs automations:read (viewing) or automations:write (changing). - [Get Automation](/it-IT/api-referentie/automations/get-automation): Gets an automation with its flow definition. Needs automations:read (viewing) or automations:write (changing). - [Update Automation](/it-IT/api-referentie/automations/update-automation): Updates an automation's name, flow, or enabled state. An automation with open issues cannot be enabled. Needs automations:read (viewing) or automations:write (changing). - [Delete Automation](/it-IT/api-referentie/automations/delete-automation): Deletes an automation and its run history. Needs automations:read (viewing) or automations:write (changing). - [List API operations](/it-IT/api-referentie/automations/list-api-operations): Lists Tillor API operations an automation can call, from the OpenAPI spec. Needs automations:read (viewing) or automations:write (changing). - [Get Automation Webhook Address](/it-IT/api-referentie/automations/get-automation-webhook-address): Gets the secret address that starts an automation whose trigger is an incoming webhook. Null for other triggers. Needs automations:read (viewing) or automations:write (changing). - [Start Automation By Webhook](/it-IT/api-referentie/automations/start-automation-by-webhook): Starts an enabled automation with an incoming-webhook trigger. The JSON body and query string become the variables body and query. The address itself is the secret; a wrong or revoked address returns 404. When the trigger ignores repeats, a repeat returns accepted with duplicate true and does not start another run. A call that is missing the configured idempotency key returns 400. - [Request Automation Step](/it-IT/api-referentie/automations/request-automation-step): Asks the Tillor team for a trigger, condition or action that automations do not offer yet. Needs automations:read (viewing) or automations:write (changing). - [List Automation Runs](/it-IT/api-referentie/automations/list-automation-runs): Lists automation runs with what each step did; filter by automationId. Needs automations:read (viewing) or automations:write (changing). - [List Automation Versions](/it-IT/api-referentie/automations/list-automation-versions): Lists earlier versions of an automation's flow, newest first, with who saved each and how many steps changed. Needs automations:read (viewing) or automations:write (changing). - [Get Automation Version](/it-IT/api-referentie/automations/get-automation-version): Gets the flow of an automation as it was saved in one earlier version. Needs automations:read (viewing) or automations:write (changing). - [Search Automation Test Records](/it-IT/api-referentie/automations/search-automation-test-records): Finds records of one kind the trigger hands to a flow, to test the flow with. Needs automations:write. - [Load Automation Test Context](/it-IT/api-referentie/automations/load-automation-test-context): Builds the data a run would start with for the chosen records, so a test run can use real data. Reads only; nothing is sent, created or changed. Needs automations:write. - Bank transactions - [List Bank Account Transactions](/it-IT/api-referentie/bank-transactions/list-bank-account-transactions): Lists bank account transactions with filtering, sorting, and pagination - [List Linked Bank Accounts](/it-IT/api-referentie/bank-transactions/list-linked-bank-accounts): Lists the bank accounts linked through the Bank Accounts integration, with the bank, the state of its consent and how many transactions Tillor imported for each. - [Get Bank Account Transaction](/it-IT/api-referentie/bank-transactions/get-bank-account-transaction): Get a bank account transaction by ID - [Sync Bank Account Transactions](/it-IT/api-referentie/bank-transactions/sync-bank-account-transactions): Starts a background run that requests a fresh bank synchronization for all linked accounts and imports the transactions into Tillor. Returns the run with a read-only token to follow it over Trigger.dev realtime. - [Assign Bank Account Transaction to Invoice](/it-IT/api-referentie/bank-transactions/assign-bank-account-transaction-to-invoice): Creates or reuses a Ponto bank-transfer payment for the transaction and assigns it to a booked invoice. Manual assignment allows later unassignment from the payment or bank transactions table. - Calls - [List Calls](/it-IT/api-referentie/calls/list-calls): Lists VOIP calls with filtering, sorting, and pagination - [Initiate VOIP Call](/it-IT/api-referentie/calls/initiate-voip-call): Initiates a new VOIP call between two phone numbers. - [Get VOIP Call](/it-IT/api-referentie/calls/get-voip-call): Gets a VOIP call by ID with optional includes - [Force End VOIP Call](/it-IT/api-referentie/calls/force-end-voip-call): Marks a call as ended when the provider's hangup webhook was missed (super admin only). - [Retranscribe Call](/it-IT/api-referentie/calls/retranscribe-call): Force a new transcription using the currently configured provider and model - [Resummarize Call](/it-IT/api-referentie/calls/resummarize-call): Force a new summary using the currently configured provider and model - [Download Call Recording](/it-IT/api-referentie/calls/download-call-recording): Downloads the recording for a specific call - [Send Organization Details](/it-IT/api-referentie/calls/send-organization-details): Sends organization details to the caller via SMS with a shortURL - Comments - [Get Comment](/it-IT/api-referentie/comments/get-comment): Retrieves a comment by its ID. - [Update Comment](/it-IT/api-referentie/comments/update-comment): Updates an existing comment with partial data. Users can only update their own comments unless they are a super admin. - [Delete Comment](/it-IT/api-referentie/comments/delete-comment): Deletes a comment. Users can only delete their own comments unless they are a super admin. - [List Comments](/it-IT/api-referentie/comments/list-comments): Lists comments with filtering, sorting, and pagination. - [Create Comment](/it-IT/api-referentie/comments/create-comment): Creates a new comment with the provided data. - [List Comments as Tree](/it-IT/api-referentie/comments/list-comments-as-tree): Lists comments as a tree structure with nested replies. Filter by customerId, invoiceId, terrainId, etc. - [Export comments PDF](/it-IT/api-referentie/comments/export-comments-pdf): Generates a PDF with organization header, author avatars, and threaded comments for the given entity. Optionally restrict to a single root comment thread via rootCommentId. - [Preview comments PDF](/it-IT/api-referentie/comments/preview-comments-pdf): Builds the same PDF as export, stores it temporarily, and returns a signed `/api/storage/preview/...` URL (like comment attachments). - [Pin/Unpin Comment](/it-IT/api-referentie/comments/pin-unpin-comment): Pins or unpins a comment. Any authenticated user can pin/unpin comments. - [Resolve/Unresolve Comment](/it-IT/api-referentie/comments/resolve-unresolve-comment): Resolves or unresolves a comment. Any authenticated user can resolve/unresolve comments. - Communications - [Get Customer Communications](/it-IT/api-referentie/communications/get-customer-communications): Retrieves all communications for a specific customer. - Connector - [List Connectors](/it-IT/api-referentie/connector/list-connectors): Returns the organization's connectors (edge devices), oldest first, with their last heartbeat and label-printer availability. Used by the app to detect a live connector and whether label printing is possible. - [Get Connector MQTT Credentials](/it-IT/api-referentie/connector/get-connector-mqtt-credentials): Returns MQTT broker connection info for the Tillor connector. Authenticate with x-api-key. Revalidate before token expiry. - Controller groups - [List Controller Groups](/it-IT/api-referentie/controller-groups/list-controller-groups): Lists controller groups with pagination, filtering, and sorting. - [Create Controller Group](/it-IT/api-referentie/controller-groups/create-controller-group): Creates a controller group used for NFC authorized-groups and controller assignment. - [Get Controller Group](/it-IT/api-referentie/controller-groups/get-controller-group): Gets a controller group by its ID. - [Update Controller Group](/it-IT/api-referentie/controller-groups/update-controller-group): Updates a controller group's name. - [Delete Controller Group](/it-IT/api-referentie/controller-groups/delete-controller-group): Deletes a controller group. Controllers in the group are unassigned, not deleted. - Controllers - [List Controllers](/it-IT/api-referentie/controllers/list-controllers): Lists controllers with pagination, filtering, and sorting. - [Get Controller](/it-IT/api-referentie/controllers/get-controller): Gets a controller by its ID. Use include parameter to include relations like controllerGroup, settings. - [Delete Controller](/it-IT/api-referentie/controllers/delete-controller): Deletes a controller. The controller can request adoption again to be re-added. - [Update Controller](/it-IT/api-referentie/controllers/update-controller): Updates a controller's properties. settings.targetVersion is only applied for super admins. - Custom fields - [List Custom Field Definitions](/it-IT/api-referentie/custom-fields/list-custom-field-definitions): Lists the organization's custom field definitions, ordered per entity by position. - [Create Custom Field Definition](/it-IT/api-referentie/custom-fields/create-custom-field-definition): Adds a custom field to an entity. The key is immutable afterwards. - [Update Custom Field Definition](/it-IT/api-referentie/custom-fields/update-custom-field-definition): Changes label, description, required flag or configuration. Key and type cannot change. - [Delete Custom Field Definition](/it-IT/api-referentie/custom-fields/delete-custom-field-definition): Removes a custom field. Stored values stay in the entities' JSON but are hidden. - [Reorder Custom Field Definitions](/it-IT/api-referentie/custom-fields/reorder-custom-field-definitions): Sets the display order of an entity's custom fields. - [Resolve Custom Field References](/it-IT/api-referentie/custom-fields/resolve-custom-field-references): Display names for the records a REFERENCE field points at; a deleted record yields a null label. - [List Custom Enums](/it-IT/api-referentie/custom-fields/list-custom-enums): Lists the organization's reusable pick lists with their options. - [Create Custom Enum](/it-IT/api-referentie/custom-fields/create-custom-enum): Creates a reusable pick list. The key and the option values are immutable. - [Update Custom Enum](/it-IT/api-referentie/custom-fields/update-custom-enum): Changes label, description and options. Options are matched by value; a value that is left out is removed. - [Delete Custom Enum](/it-IT/api-referentie/custom-fields/delete-custom-enum): Deletes a pick list. Refused (409) while a custom field still uses it. - Customer meter consumption - [List Outstanding Consumption](/it-IT/api-referentie/customer-meter-consumption/list-outstanding-consumption): Lists customers with outstanding consumption. Supports pagination, sorting, and filters (no water/electricity/gas outstanding, last utility invoice min days ago, automatic billing). - [Get Customer Consumption Summary](/it-IT/api-referentie/customer-meter-consumption/get-customer-consumption-summary): Gets consumption summary for all meters for a customer. - [Invoice All Consumption](/it-IT/api-referentie/customer-meter-consumption/invoice-all-consumption): Invoices all outstanding consumption for a customer. Optionally adds items to an existing draft invoice. Optionally filters by specific meter IDs. - [Invoice, Book and Send](/it-IT/api-referentie/customer-meter-consumption/invoice-book-and-send): Invoices all outstanding consumption for a customer, books the invoice, and sends notifications. - [Mark Batch as Invoiced](/it-IT/api-referentie/customer-meter-consumption/mark-batch-as-invoiced): Marks a consumption batch as invoiced without creating an invoice. - [Mark Batch as Not Invoiced](/it-IT/api-referentie/customer-meter-consumption/mark-batch-as-not-invoiced): Marks a consumption batch as not invoiced. Only works for manually marked batches without an invoice. - [Get Open Batch](/it-IT/api-referentie/customer-meter-consumption/get-open-batch): Gets the open consumption batch for a customer-meter pair. - [Get Meter Batches](/it-IT/api-referentie/customer-meter-consumption/get-meter-batches): Gets all consumption batches for a meter across all customers. - Customers - [List Customer Tasks](/it-IT/api-referentie/customers/list-customer-tasks): Lists tasks for a customer with pagination, filtering, and sorting. - [List Customer NFC Tags](/it-IT/api-referentie/customers/list-customer-nfc-tags): Lists NFC tags for a customer with pagination, filtering, and sorting. - [List Customers](/it-IT/api-referentie/customers/list-customers): Lists customers with pagination, filtering, sorting, and includes. Supports virtual fields (terrains, meters, consumption), filtering by id, status, customerType, displayId, and text search. - [Create Customer](/it-IT/api-referentie/customers/create-customer): Creates a new customer with the provided data. Optional `identityDocumentScanId` links an unassigned (pending) identity document scan to the new customer in the same atomic transaction. - [Get Customer](/it-IT/api-referentie/customers/get-customer): Retrieves a customer by their ID. Supports virtual fields: terrains, meters, consumption (same as list endpoint). - [Update Customer](/it-IT/api-referentie/customers/update-customer): Updates an existing customer with partial data. Omitted fields stay unchanged; `null` or an empty string clears a nullable field. - [Delete Customer](/it-IT/api-referentie/customers/delete-customer): Deletes a customer by their ID. - [Check Customer Exists](/it-IT/api-referentie/customers/check-customer-exists): Checks if a customer already exists by first name + last name or phone number. Used to prevent duplicate creation. - [Get Customer Invoicing Settings](/it-IT/api-referentie/customers/get-customer-invoicing-settings): Retrieves the invoicing settings for a customer. - [Update Customer Invoicing Settings](/it-IT/api-referentie/customers/update-customer-invoicing-settings): Updates the invoicing settings for a customer. - [Get Customer Communication Settings](/it-IT/api-referentie/customers/get-customer-communication-settings): Retrieves the communication settings for a customer. - [Update Customer Communication Settings](/it-IT/api-referentie/customers/update-customer-communication-settings): Updates the communication settings for a customer, e.g. auto-voicemail or static call routing. - [Get Customer Communications](/it-IT/api-referentie/customers/get-customer-communications): Retrieves all communications for a specific customer. - [Get Customer Call Card](/it-IT/api-referentie/customers/get-customer-call-card): Returns the customer, their communication settings and the call plan features. Used by the active-call card UI. - [Get Customer Key Info](/it-IT/api-referentie/customers/get-customer-key-info): Returns what the customer page and the call card show at a glance: checked-in and upcoming reservations, and meters that are 'on' (switchState=true) with an unresolved alarm. - [Get Customer Face Portrait](/it-IT/api-referentie/customers/get-customer-face-portrait): Returns the latest customer-level identity document scan metadata for rendering a face portrait. - [Import from Sudum Export](/it-IT/api-referentie/customers/import-from-sudum-export): Imports customers from a Sudum Excel export file. - [Export Customers](/it-IT/api-referentie/customers/export-customers): Generates an XLSX export of customers with insurance documents. - [Export customer invoice overview PDF](/it-IT/api-referentie/customers/export-customer-invoice-overview-pdf): Generates an in-memory PDF with organization header, booked invoices (totals, invoice date, due date), and connected PAID payments. - [Export customer invoice overview Excel](/it-IT/api-referentie/customers/export-customer-invoice-overview-excel): Generates an XLSX with booked invoices (totals, invoice date, due date) and connected PAID payments. - [Send invoice overview PDF to iPad](/it-IT/api-referentie/customers/send-invoice-overview-pdf-to-ipad): Generates the customer invoice overview PDF and sends it to iPad devices. - [Export Customer to Accounting](/it-IT/api-referentie/customers/export-customer-to-accounting): Sends the customer address to the organization's installed accounting integration. - [List Contacts Across Customers](/it-IT/api-referentie/customers/list-contacts-across-customers): Lists contacts of every customer, newest first; `search` matches name or email. - [Create Contact](/it-IT/api-referentie/customers/create-contact): Creates a new contact for a customer. Optional `identityDocumentScanId` links a scan to the new contact in the same atomic transaction when the scan is not already tied to another contact and, if already linked to a customer, that customer matches `customerId`. - [List Contacts](/it-IT/api-referentie/customers/list-contacts): Lists all contacts for a customer. - [Get Contact](/it-IT/api-referentie/customers/get-contact): Retrieves a contact by their ID. - [Update Contact](/it-IT/api-referentie/customers/update-contact): Updates an existing contact with partial data. Omitted fields stay unchanged; `null` or an empty string clears a nullable field. - [Delete Contact](/it-IT/api-referentie/customers/delete-contact): Deletes a contact by their ID. Linked identity document scans are permanently deleted (not reassigned to the customer). - [List Customer Reservations](/it-IT/api-referentie/customers/list-customer-reservations): Lists reservations for a customer with pagination, filtering, and sorting. - [List Customer Documents](/it-IT/api-referentie/customers/list-customer-documents): Lists documents for a customer with pagination, filtering, and sorting. - [List Customer Audit Logs](/it-IT/api-referentie/customers/list-customer-audit-logs): Lists audit logs for a customer with filtering, sorting, and pagination. - Documents - [List Documents](/it-IT/api-referentie/documents/list-documents): Lists documents with pagination, filtering, and sorting. - [List Customer Documents](/it-IT/api-referentie/documents/list-customer-documents): Lists documents for a customer with pagination, filtering, and sorting. - [Get Document](/it-IT/api-referentie/documents/get-document): Retrieves a document by its ID. - [Update Document](/it-IT/api-referentie/documents/update-document): Updates a document by its ID. - [Get Document PDF](/it-IT/api-referentie/documents/get-document-pdf): Retrieves a document preview PDF by its ID. - [Download Document](/it-IT/api-referentie/documents/download-document): Retrieves the original document file for download. - [Ensure Document Preview](/it-IT/api-referentie/documents/ensure-document-preview): Returns how to show the document in a browser (image or PDF rendition). Starts PDF generation when a rendition is missing; poll while the status is `generating`. - [Archive Document](/it-IT/api-referentie/documents/archive-document): Archives a document so it is hidden from active document lists. - [Unarchive Document](/it-IT/api-referentie/documents/unarchive-document): Restores an archived document to the active document lists. - [Delete Document](/it-IT/api-referentie/documents/delete-document): Deletes a document by its ID. - [Upload Document](/it-IT/api-referentie/documents/upload-document): Uploads a new document. - [Restore Document From Temp](/it-IT/api-referentie/documents/restore-document-from-temp): Recreates a deleted document from its temp-folder copy (tempKey from the deletion notification). - Email notification deliveries - [List Email Notification Deliveries](/it-IT/api-referentie/email-notification-deliveries/list-email-notification-deliveries): Lists email notification deliveries with pagination, filtering, sorting, and includes. Use include for relations. - [Get Email Notification Delivery](/it-IT/api-referentie/email-notification-deliveries/get-email-notification-delivery): Retrieves an email notification delivery by its ID. Use include for relations. - [Get Email Notification Delivery Attachment URL](/it-IT/api-referentie/email-notification-deliveries/get-email-notification-delivery-attachment-url): Returns a short-lived download URL for an attachment of a sent email. Links to stored files are signed again on every call, so they keep working after the link in the email expired. - Holidays - [List holidays](/it-IT/api-referentie/holidays/list-holidays): Lists public or school holidays for the organization country and locale from OpenHolidays API. Country and language default from organization settings; optional overrides apply per request. - Identity document scans - [List Identity Document Scans](/it-IT/api-referentie/identity-document-scans/list-identity-document-scans): Lists identity document scans with pagination, filtering, and sorting. - [Get Identity Document Scan](/it-IT/api-referentie/identity-document-scans/get-identity-document-scan): Gets an identity document scan by its ID. - [Delete identity document scan](/it-IT/api-referentie/identity-document-scans/delete-identity-document-scan): Permanently deletes an identity document scan and its encrypted files from storage. - [Download Identity Document Scan Files](/it-IT/api-referentie/identity-document-scans/download-identity-document-scan-files): Downloads all decrypted files for an identity document scan as a ZIP archive. - [Download Identity Document Scan Raster](/it-IT/api-referentie/identity-document-scans/download-identity-document-scan-raster): Downloads a decrypted raster image: document front, document back, or face portrait. - [Download Identity Document Scan PDF](/it-IT/api-referentie/identity-document-scans/download-identity-document-scan-pdf): Generates a PDF with organization header, extracted metadata, and embedded document images (front, back, portrait when available). - [Print Identity Document Scan PDF](/it-IT/api-referentie/identity-document-scans/print-identity-document-scan-pdf): Queues the identity document scan PDF for the organization's A4 printer. - [Contact link hints for identity document scan](/it-IT/api-referentie/identity-document-scans/contact-link-hints-for-identity-document-scan): Re-syncs the scan's suggested customer (`matchingCustomerId`) and returns contact link hints (exact national register and/or exact name). Customer suggestions are persisted on the scan row. - [Assign identity document scan to customer](/it-IT/api-referentie/identity-document-scans/assign-identity-document-scan-to-customer): Links an identity document scan to an existing customer (primary guest). Clears any contact link. - [Assign identity document scan to contact](/it-IT/api-referentie/identity-document-scans/assign-identity-document-scan-to-contact): Links an identity document scan to an existing contact and sets the scan's customer to that contact's customer. - [Create customer from identity document scan](/it-IT/api-referentie/identity-document-scans/create-customer-from-identity-document-scan): Creates a customer from MRZ-derived scan fields, applies extra fields where possible, and links the scan. Returns 400 if the scan is already linked or has no given name. - [Create contact from identity document scan](/it-IT/api-referentie/identity-document-scans/create-contact-from-identity-document-scan): Creates a contact for the given customer using MRZ-derived scan fields (where present), assigns the scan to that customer if needed, and links the scan to the new contact in one step. The scan must not already be linked to another customer or to a contact. Returns 400 if data is insufficient. - [Unlink identity document scan](/it-IT/api-referentie/identity-document-scans/unlink-identity-document-scan): Removes the customer and contact link from an identity document scan. The scan itself is not deleted. - Inbox - [Get website chat embed snippet](/it-IT/api-referentie/inbox/get-website-chat-embed-snippet): Returns the public widget key and HTML snippet to embed the Tillor website chat on an external site. - [List inbox threads](/it-IT/api-referentie/inbox/list-inbox-threads): Lists omnichannel inbox conversation threads for the organization. - [List inbox tags](/it-IT/api-referentie/inbox/list-inbox-tags): Lists organization-wide inbox tags used to label conversation threads. - [Create inbox tag](/it-IT/api-referentie/inbox/create-inbox-tag): Creates an organization-wide inbox tag. Set `aiCanApply` to allow the inbox AI assistant to add this tag after replies. - [Get inbox tag](/it-IT/api-referentie/inbox/get-inbox-tag): Returns a single organization-wide inbox tag by id. - [Update inbox tag](/it-IT/api-referentie/inbox/update-inbox-tag): Updates an organization-wide inbox tag name, color, or AI applicability. - [Delete inbox tag](/it-IT/api-referentie/inbox/delete-inbox-tag): Deletes an organization-wide inbox tag and removes it from all conversation threads. - [Get inbox thread](/it-IT/api-referentie/inbox/get-inbox-thread): Returns a single inbox thread (metadata without messages). - [Update inbox thread](/it-IT/api-referentie/inbox/update-inbox-thread): Partially updates an inbox thread. Use `hasUnread` to mark a conversation read or unread. Use `aiAssistantMode` to force the AI assistant on, off, or back to automatic (30-minute pause after staff replies). Use `tagIds` to replace assigned inbox tags (requires inbox:write). - [Get inbox thread participant profile](/it-IT/api-referentie/inbox/get-inbox-thread-participant-profile): Returns enriched participant profile details for the inbox context panel, including external profile links when available. - [List inbox thread messages](/it-IT/api-referentie/inbox/list-inbox-thread-messages): Returns paginated messages for an inbox thread in chronological order. Omit page to load the latest page first; use previousPage to load older messages. - [Download inbox participant avatar](/it-IT/api-referentie/inbox/download-inbox-participant-avatar): Returns the stored participant profile image for an inbox thread when one has been saved. - [Get inbox channel availability](/it-IT/api-referentie/inbox/get-inbox-channel-availability): Returns which messaging channel integrations are installed for this organization. - [Get inbox unread count](/it-IT/api-referentie/inbox/get-inbox-unread-count): Returns the number of open inbox threads with unread inbound messages (not yet opened in the inbox). - [Mark all inbox threads read](/it-IT/api-referentie/inbox/mark-all-inbox-threads-read): Marks every open inbox thread with unread inbound messages as read for the organization. - [Send inbox message](/it-IT/api-referentie/inbox/send-inbox-message): Sends an outbound message in an existing inbox thread. - [Signal inbox typing state](/it-IT/api-referentie/inbox/signal-inbox-typing-state): Updates staff typing state for a thread and sends typing indicators on channels that support them. - [Get inbox thread typing state](/it-IT/api-referentie/inbox/get-inbox-thread-typing-state): Returns whether the visitor or staff side (including the AI assistant) is currently typing in the thread. - [Sync Messenger conversations](/it-IT/api-referentie/inbox/sync-messenger-conversations): Schedules a background job to import recent messages from all Messenger conversations on the connected Facebook Page. - [Sync inbox thread](/it-IT/api-referentie/inbox/sync-inbox-thread): Schedules a background sync for one thread: Messenger/Instagram re-import Graph history; WhatsApp retries pending image downloads. - [Export inbox thread](/it-IT/api-referentie/inbox/export-inbox-thread): Generates a plain-text export of an inbox thread, including messages and timeline events. - [Archive inbox thread](/it-IT/api-referentie/inbox/archive-inbox-thread): Marks an inbox thread as archived. - [Unarchive inbox thread](/it-IT/api-referentie/inbox/unarchive-inbox-thread): Restores an archived inbox thread to the open conversations list. - [Archive inbox threads](/it-IT/api-referentie/inbox/archive-inbox-threads): Marks multiple open inbox threads as archived (maximum 1000). - [Unarchive inbox threads](/it-IT/api-referentie/inbox/unarchive-inbox-threads): Restores multiple archived inbox threads to the open conversations list (maximum 1000). - [Generate AI draft reply](/it-IT/api-referentie/inbox/generate-ai-draft-reply): Generates an AI assistant draft reply to the latest visitor message for staff to review before sending. - [Preview outbound inbox translation](/it-IT/api-referentie/inbox/preview-outbound-inbox-translation): Translates a draft reply into the contact's language so staff can review it before sending. - [Ensure inbox thread translations](/it-IT/api-referentie/inbox/ensure-inbox-thread-translations): Translates missing inbound and AI messages in a thread into the organization language. - [Mark website chat visitor messages delivered](/it-IT/api-referentie/inbox/mark-website-chat-visitor-messages-delivered): Sets delivery receipts on inbound website chat messages after staff loaded the conversation. - [Pin inbox thread](/it-IT/api-referentie/inbox/pin-inbox-thread): Pins an inbox thread to the top of the open conversations list. - [Unpin inbox thread](/it-IT/api-referentie/inbox/unpin-inbox-thread): Removes the pin from an inbox thread. - [Remove outbound inbox message](/it-IT/api-referentie/inbox/remove-outbound-inbox-message): Removes an outbound message on channels that support it. Website inbox messages are soft-deleted in Tillor only. Staff can remove their own messages with inbox:write; other staff or AI messages require inbox:messages:manage-others. - [Edit outbound inbox message](/it-IT/api-referentie/inbox/edit-outbound-inbox-message): Updates the text and attachments of an outbound message on channels that support it. Website inbox messages are updated in Tillor only. Staff can edit their own messages with inbox:write; other staff messages require inbox:messages:manage-others; AI assistant messages require inbox:messages:edit-ai. - Integration alarms - [List Integration Alarms](/it-IT/api-referentie/integration-alarms/list-integration-alarms): Lists alarms raised by integrated systems, on a meter or on an ICY controller, with pagination, filtering, and sorting. Filter by meter, controller, resolution state, dates, and message. Optional search matches message, external ID, or meter name. Include `meter` or `icyController` for the device the alarm is on; exactly one of `meterId` and `icyControllerId` is set. - [Get Integration Alarm](/it-IT/api-referentie/integration-alarms/get-integration-alarm): Gets an alarm by ID. Use include to load the meter or the ICY controller the alarm is on. - Integrations - [List Voys Accounts](/it-IT/api-referentie/integrations/list-voys-accounts): Lists all available VoIP accounts from the Voys provider. - [Get Phonebook](/it-IT/api-referentie/integrations/get-phonebook): Returns the organization's phonebook in XML format for VoIP phones - Invoice items - [List Invoice Items](/it-IT/api-referentie/invoice-items/list-invoice-items): Lists invoice line items with pagination, sorting, and filters. Optional `search` matches line description, invoice display id, product name, and numeric quantity or amounts. Default sort follows display sequence. - [Get Invoice Item](/it-IT/api-referentie/invoice-items/get-invoice-item): Returns a single invoice line item by ID. Optional includes: invoice, product. - Invoices - [List Invoices](/it-IT/api-referentie/invoices/list-invoices): Lists all invoices in the system with pagination support. - [Create Invoice](/it-IT/api-referentie/invoices/create-invoice): Creates a new invoice with the provided data. - [Invoice dashboard stats](/it-IT/api-referentie/invoices/invoice-dashboard-stats): Returns total invoice count, open and overdue counts (unpaid or partially paid booked invoices, credit notes excluded), and the sum of outstanding amounts for open booked invoices and credit notes in the organization's currency. - [Get Invoice](/it-IT/api-referentie/invoices/get-invoice): Gets an invoice by its ID with optional includes. Use include parameter to include relations like items, customer. - [Delete Invoice](/it-IT/api-referentie/invoices/delete-invoice): Deletes an invoice by its ID. - [Replace Invoice](/it-IT/api-referentie/invoices/replace-invoice): Replaces an existing invoice with new data. For lines whose product defines metadata.invoiceBundle, bundle child rows are regenerated server-side only when that anchor's product, quantity, or (Extend occupation period) occupation changed versus the stored invoice; otherwise the submitted bundle children are preserved. - [List Guarded Ledger Balances](/it-IT/api-referentie/invoices/list-guarded-ledger-balances): Lists the customer's booked balance on every ledger that a product guards. Drafts do not count. - [List Ledger Accounts](/it-IT/api-referentie/invoices/list-ledger-accounts): Lists every ledger the customer has booked invoice lines on, with the booked balance, the products booked on it and whether a product guards it. Drafts do not count. - [List Ledger Account Entries](/it-IT/api-referentie/invoices/list-ledger-account-entries): Lists the newest booked invoices with lines on the ledger, each with its amount and the customer's running balance, plus how many there are in all. The running balance includes older invoices. - [Get Invoice PDF](/it-IT/api-referentie/invoices/get-invoice-pdf): Generates and returns a PDF for the specified invoice. - [Get Customer Outstanding Balance](/it-IT/api-referentie/invoices/get-customer-outstanding-balance): Gets the total outstanding balance for a customer's invoices. - [Get Products Used in Customer Invoices](/it-IT/api-referentie/invoices/get-products-used-in-customer-invoices): Gets the distinct products that have been used in a customer's invoices. - [Generate Personal URL](/it-IT/api-referentie/invoices/generate-personal-url-post): Generates a personal URL for accessing the invoice. - [Update Invoice Mandate](/it-IT/api-referentie/invoices/update-invoice-mandate): Couples a customer mandate to the invoice, or clears it. Credit notes cannot use mandates. On booked invoices this creates a pending mandate payment immediately and sends it to the bank two days later. - [Update Invoice Automated Reminders](/it-IT/api-referentie/invoices/update-invoice-automated-reminders): Keeps this invoice out of automated overdue reminder flows, or lets it take part again. An optional end date brings it back into those flows after that day. Other invoices of the customer are not affected. - [Preview invoice bundle lines](/it-IT/api-referentie/invoices/preview-invoice-bundle-lines): Resolves bundle child lines for a product with metadata.invoiceBundle using the same resolver and expand rules as replaceInvoice when that invoice rebuild runs for an anchor. Pass anchorLineQuantity when bundle steps use quantityScale anchor_line_quantity so preview matches the extend-occupation / period main line. When the anchor is Extend occupation period, pass terrainId so ICY meter steps match that terrain, and invoiceBillingAnchorEndDateIso (anchor endDate) when steps use extendAccessMethod. Pass invoiceItemsForBillOnceContext and anchorItemListIndex together so steps with billOncePerInvoice behave like replaceInvoice (shared steps only under the first eligible anchor in array order). Optional existingAnchorSnapshots aligns regenerate detection with the last-loaded invoice for preview. - [Book Invoice](/it-IT/api-referentie/invoices/book-invoice): Books an invoice, transitioning it from draft to final state. With force: true, users with invoicing:correct may book offer-only extend-occupation lines. With ledgerBalanceOverride, users with invoicing:override-ledger-balance may take a customer's balance on a guarded ledger below zero; the motivation is recorded on the timeline. - [Get Invoice Navigation](/it-IT/api-referentie/invoices/get-invoice-navigation): Gets navigation information for an invoice. - [Print Invoice PDF](/it-IT/api-referentie/invoices/print-invoice-pdf): Prints an invoice PDF. - [Get Invoice Payment Information](/it-IT/api-referentie/invoices/get-invoice-payment-information): Gets payment information for an invoice. - [Send New Invoice Notification](/it-IT/api-referentie/invoices/send-new-invoice-notification): Manually sends a new invoice notification for the specified invoice. - [Send Invoice Reminder Notification](/it-IT/api-referentie/invoices/send-invoice-reminder-notification): Manually sends a reminder notification for the specified invoice. - [Copy Invoice](/it-IT/api-referentie/invoices/copy-invoice): Creates a new draft invoice with the same items as the source invoice. - [Reverse Invoice](/it-IT/api-referentie/invoices/reverse-invoice): Creates a new draft invoice with reversed type (credit note becomes invoice, invoice becomes credit note) and negated amounts. - [Recalculate Invoice](/it-IT/api-referentie/invoices/recalculate-invoice): Recalculates all amounts for an invoice including subtotal, tax, total, amount paid, and outstanding amount. Also updates payment status. - [Revert Invoice to Draft](/it-IT/api-referentie/invoices/revert-invoice-to-draft): Reverts a booked invoice to DRAFT state, preserving the original displayId for rebooking. By default, only if no notifications have been sent, not on Peppol, and within one week. With force: true, super admins may bypass those rules. - [Restore Invoice Version](/it-IT/api-referentie/invoices/restore-invoice-version): Restores the invoice lines and product actions captured on an earlier revert-to-draft event. If the invoice is currently booked it is reverted to draft first (with force: true, super admins may bypass the revert window). - [Move Invoice to Another Customer](/it-IT/api-referentie/invoices/move-invoice-to-another-customer): Relocates an invoice to a different customer: updates the invoice, linked payments, meter consumption batches linked to the invoice, and invoice comments that referred to the previous customer. For booked invoices, queues a job to export the invoice to the installed accounting integration. Blocked when a Peppol document id is set. - [Export Invoice to Accounting](/it-IT/api-referentie/invoices/export-invoice-to-accounting): Exports a booked invoice to the organization's installed accounting integration. - [Send Invoice PDF to iPad](/it-IT/api-referentie/invoices/send-invoice-pdf-to-ipad): Sends the invoice PDF to iPad devices via realtime event. - [Send Invoice over Peppol](/it-IT/api-referentie/invoices/send-invoice-over-peppol): Manually sends a booked invoice over Peppol after confirming eligibility (booked, not yet sent, customer has a Peppol recipient id). Recovers invoices whose automatic send on booking did not go out. - [Lookup Peppol Directory](/it-IT/api-referentie/invoices/lookup-peppol-directory): Search Peppol recipients. Backend uses PEPPOL_DIRECTORY_PROVIDER (recommand | eu): Recommand search-peppol-directory API or official EU directory. - [Lookup Peppol Directory by Customer](/it-IT/api-referentie/invoices/lookup-peppol-directory-by-customer): Directory lookup by customer VAT (sanitized; FR VAT check digits stripped to SIREN). Provider is selected via PEPPOL_DIRECTORY_PROVIDER. - [Create Payment Link](/it-IT/api-referentie/invoices/create-payment-link): Creates a payment link for an invoice. - Ledger opening balances - [List Ledger Opening Balances](/it-IT/api-referentie/ledger-opening-balances/list-ledger-opening-balances): Lists the customer's opening balances from before Tillor, by ledger and date. They count in the customer's ledger balances. - [Create Ledger Opening Balance](/it-IT/api-referentie/ledger-opening-balances/create-ledger-opening-balance): Adds an opening balance on a ledger for a customer. A negative amount that takes a guarded ledger below zero is refused (409, `INVOICE_LEDGER_BALANCE_EXCEEDED`); a reference the customer already has on that ledger is refused (409, `LEDGER_OPENING_BALANCE_REFERENCE_EXISTS`). With `ledgerBalanceOverride`, users with invoicing:override-ledger-balance may take a guarded ledger below zero; the motivation and the violations are recorded on the customer's timeline. - [Update Ledger Opening Balance](/it-IT/api-referentie/ledger-opening-balances/update-ledger-opening-balance): Changes an opening balance. Lowering it below what the customer's guarded ledger still holds is refused (409, `INVOICE_LEDGER_BALANCE_EXCEEDED`). With `ledgerBalanceOverride`, users with invoicing:override-ledger-balance may take a guarded ledger below zero; the motivation and the violations are recorded on the customer's timeline. - [Delete Ledger Opening Balance](/it-IT/api-referentie/ledger-opening-balances/delete-ledger-opening-balance): Removes an opening balance. Refused (409, `INVOICE_LEDGER_BALANCE_EXCEEDED`) when the customer's guarded ledger would go below zero, for example when the deposit was refunded since. With `ledgerBalanceOverride`, users with invoicing:override-ledger-balance may take a guarded ledger below zero; the motivation and the violations are recorded on the customer's timeline. - [Preview Ledger Opening Balance Import](/it-IT/api-referentie/ledger-opening-balances/preview-ledger-opening-balance-import): Matches each row to a customer (Tillor customer number or id) and an existing opening balance (same ledger and reference), without writing anything. Returns the status per row and the total per ledger. - [Import Ledger Opening Balances](/it-IT/api-referentie/ledger-opening-balances/import-ledger-opening-balances): Creates opening balances and updates the ones whose reference already exists; rows without a matching customer or repeated in the file are skipped. Refused as a whole (409, `INVOICE_LEDGER_BALANCE_EXCEEDED`) when a row would take a guarded ledger below zero. With `ledgerBalanceOverride`, users with invoicing:override-ledger-balance may take a guarded ledger below zero; the motivation and the violations are recorded on the customer's timeline. - Mandate agreements - [List Mandate Agreements](/it-IT/api-referentie/mandate-agreements/list-mandate-agreements): Lists mandate agreements with pagination, filtering (e.g. `customerId`, `status`) and sorting. - [Create Mandate Agreement](/it-IT/api-referentie/mandate-agreements/create-mandate-agreement): Generates a SEPA mandate for the customer (IBAN optional) and sends it to sign: by email link, or on the reception iPad. The provider mandate is created once it is signed. Signed agreements are legal evidence, so there is no update or delete; use cancel or revoke. - [Get Mandate Agreement](/it-IT/api-referentie/mandate-agreements/get-mandate-agreement): Returns one mandate agreement, optionally with its customer, mandate or document. - [Resend Mandate Agreement](/it-IT/api-referentie/mandate-agreements/resend-mandate-agreement): Issues a fresh signing link for an agreement that is still unsigned or expired. - [Send Mandate Agreement Reminder](/it-IT/api-referentie/mandate-agreements/send-mandate-agreement-reminder): Emails another signing reminder for an agreement that is still waiting, without extending the expiry date. - [Cancel Mandate Agreement](/it-IT/api-referentie/mandate-agreements/cancel-mandate-agreement): Withdraws a mandate request the customer has not signed. - [Revoke Mandate Agreement](/it-IT/api-referentie/mandate-agreements/revoke-mandate-agreement): Revokes the active mandate behind a signed agreement at the provider. The agreement keeps its signed document (archived) and the customer is notified. - [Get Signed Mandate Document URL](/it-IT/api-referentie/mandate-agreements/get-signed-mandate-document-url): Returns a link to the signed mandate PDF, or null while it is unsigned. - [Is a Signing iPad Online](/it-IT/api-referentie/mandate-agreements/is-a-signing-ipad-online): Whether a reception iPad (Tillor app) of this organization is online, so mandates can be signed there. - [Send Mandate Agreement to iPad](/it-IT/api-referentie/mandate-agreements/send-mandate-agreement-to-ipad): Shows an unsigned mandate on the reception iPad so the customer signs it there. - [Get Mandate Agreement for iPad](/it-IT/api-referentie/mandate-agreements/get-mandate-agreement-for-ipad): What the reception iPad shows while a customer signs: mandate details, creditor, masked IBAN, first-payment methods and the SMS code state. - [Send Mandate Signing Code from iPad](/it-IT/api-referentie/mandate-agreements/send-mandate-signing-code-from-ipad): Texts the customer the code that confirms an IBAN mandate signed on the iPad. - [Sign Mandate Agreement on iPad](/it-IT/api-referentie/mandate-agreements/sign-mandate-agreement-on-ipad): Signs an IBAN mandate on the reception iPad with the SMS code and the drawn signature; the signed PDF records the device user. - [Sign and Start Mandate First Payment on iPad](/it-IT/api-referentie/mandate-agreements/sign-and-start-mandate-first-payment-on-ipad): Signs the mandate on the reception iPad (unless already signed) and starts the first payment; the response always carries a QR the customer scans to pay on their phone. - [Get Mandate First Payment State on iPad](/it-IT/api-referentie/mandate-agreements/get-mandate-first-payment-state-on-ipad): Where a first payment started from the reception iPad stands. - Mandates - [List Mandates](/it-IT/api-referentie/mandates/list-mandates): Lists mandates with pagination, filtering, and sorting. Scoped to the customer in the path. - [Create Mandate](/it-IT/api-referentie/mandates/create-mandate): Creates a new mandate for a customer. - [Get Supported Mandate Methods](/it-IT/api-referentie/mandates/get-supported-mandate-methods): Gets the supported mandate methods. - [Get Mandate](/it-IT/api-referentie/mandates/get-mandate): Gets a mandate by its ID. - [Delete Mandate](/it-IT/api-referentie/mandates/delete-mandate): Deletes a mandate for a customer. - [Execute Mandate Payment](/it-IT/api-referentie/mandates/execute-mandate-payment): Creates or executes a mandate payment. Pass delayDays (0-7) to wait before sending to the bank. - [Skip Mandate Payment Delay](/it-IT/api-referentie/mandates/skip-mandate-payment-delay): Sends a delayed mandate payment to the bank immediately. - Map - [Get Map Tile](/it-IT/api-referentie/map/get-map-tile): Returns a map tile for the given coordinates and style - [Get Map Overlay Tile](/it-IT/api-referentie/map/get-map-overlay-tile): Returns an organization-specific overlay tile for the given coordinates and style - Meter cabinets - [List Meter Cabinets](/it-IT/api-referentie/meter-cabinets/list-meter-cabinets): Lists all meter cabinets with optional filtering and sorting. - [Create Meter Cabinet](/it-IT/api-referentie/meter-cabinets/create-meter-cabinet): Creates a new meter cabinet. - [Get Meter Cabinet](/it-IT/api-referentie/meter-cabinets/get-meter-cabinet): Retrieves a meter cabinet by its ID. - [Delete Meter Cabinet](/it-IT/api-referentie/meter-cabinets/delete-meter-cabinet): Deletes a meter cabinet by its ID. - [Update Meter Cabinet](/it-IT/api-referentie/meter-cabinets/update-meter-cabinet): Updates an existing meter cabinet. - Meters - [List Meters](/it-IT/api-referentie/meters/list-meters): Lists meters with pagination, filtering, and sorting. Supports filtering by type, provider, terrain, and search. Can include relations like terrain (with nested occupations and customer), lastReading, alarms, and metadata. Use 'customer' or 'occupation' in include to fetch nested data through terrain. - [Create Meter](/it-IT/api-referentie/meters/create-meter): Creates a new meter with the provided data. - [Get Meter](/it-IT/api-referentie/meters/get-meter): Gets a meter by its ID. Supports virtual fields: customer, occupation (same as list endpoint). Use include parameter to include relations like terrain, lastReading. - [Get Meter Capabilities](/it-IT/api-referentie/meters/get-meter-capabilities): Gets the capabilities for a meter. - [Update Meter](/it-IT/api-referentie/meters/update-meter): Updates a meter with the provided data. - [Delete Meter](/it-IT/api-referentie/meters/delete-meter): Deletes a meter. - [List External Meters](/it-IT/api-referentie/meters/list-external-meters): Lists external meters from a specific provider. - [Get External Meter Name](/it-IT/api-referentie/meters/get-external-meter-name): Gets the name of an external meter. - [Synchronize Meter](/it-IT/api-referentie/meters/synchronize-meter): Synchronizes a meter with its external provider. With `requestDevice: true` the provider asks the device for a fresh reading (iCY), which can take up to a minute. - [Export Meters](/it-IT/api-referentie/meters/export-meters): Generates an XLSX export of meters grouped by provider with provider-specific sheets. - [Import Meters](/it-IT/api-referentie/meters/import-meters): Imports meter data from an XLSX file and upserts changes. Creates new meters or updates existing ones based on ID (primary) or name+provider (fallback). Only requires name, type, and provider columns. Optional: serial, terrainName, meterCabinetName. - [Set Switch State](/it-IT/api-referentie/meters/set-switch-state): Sets the switch state of a meter. - [List amperage options](/it-IT/api-referentie/meters/list-amperage-options): Lists the amperage steps configured for this organization's iCY branch. - [Set Current Amperage](/it-IT/api-referentie/meters/set-current-amperage): Sets the current amperage of a meter. - [Assign Meter](/it-IT/api-referentie/meters/assign-meter): Assigns a meter to a terrain. - [Unassign Meter](/it-IT/api-referentie/meters/unassign-meter): Unassigns a meter from its terrain. - [Clear Alarms](/it-IT/api-referentie/meters/clear-alarms): Clears all alarms for a meter. - [Reset Amperage Warning Count](/it-IT/api-referentie/meters/reset-amperage-warning-count): Resets the amperage warning notification count for a meter. - [Get Meter Readings](/it-IT/api-referentie/meters/get-meter-readings): Gets readings for a meter within an optional date range. - [Add Meter Readings](/it-IT/api-referentie/meters/add-meter-readings): Adds readings for a meter. - [Get Meter Consumption Trends](/it-IT/api-referentie/meters/get-meter-consumption-trends): Returns per-day (and, with granularity=hour, per-hour) consumption derived from this meter's readings, plus weekly totals, a trailing baseline, and an elevated-usage signal. - [Get Park Consumption Trends](/it-IT/api-referentie/meters/get-park-consumption-trends): Returns park-wide consumption trends grouped per meter type, derived from meter readings, optionally narrowed by meter type and provider. - [Delete Meter Reading](/it-IT/api-referentie/meters/delete-meter-reading): Deletes a reading for a meter. - [Get Last Meter Reading](/it-IT/api-referentie/meters/get-last-meter-reading): Gets the last reading for a meter. - Mqtt - [Get MQTT Credentials](/it-IT/api-referentie/mqtt/get-mqtt-credentials): Generates JWT credentials for MQTT client connections. Tokens allow publish and subscribe under tillor/{env}/{orgId}/integration/# (or a narrower topic prefix). - [List MQTT Static Credentials](/it-IT/api-referentie/mqtt/list-mqtt-static-credentials): Lists static (long-lived) MQTT credentials for this organization. - [Create MQTT Static Credentials](/it-IT/api-referentie/mqtt/create-mqtt-static-credentials): Creates static (long-lived) MQTT credentials. Password is returned once and cannot be retrieved later. topicPrefix must stay inside the organization namespace; omitted means the integration prefix. - [Delete MQTT Static Credentials](/it-IT/api-referentie/mqtt/delete-mqtt-static-credentials): Deletes static MQTT credentials and disconnects the client if it is connected. - Native devices - [List tablets and kiosks](/it-IT/api-referentie/native-devices/list-tablets-and-kiosks): Tablets and kiosks running the Tillor app for this organization, with their last heartbeat and pushed settings. - [Get a tablet, kiosk or phone](/it-IT/api-referentie/native-devices/get-a-tablet-kiosk-or-phone): One device with its last heartbeat and pushed settings. - [Update a tablet or kiosk](/it-IT/api-referentie/native-devices/update-a-tablet-or-kiosk): Renames the device, changes its kind or replaces its settings, and pushes the settings to the device right away. Settings left out stay the device's own choice. - [Forget a tablet or kiosk](/it-IT/api-referentie/native-devices/forget-a-tablet-or-kiosk): Removes the device from the list. A device that is still in use registers again on its next heartbeat, without pushed settings. - [Latest screenshot of a device](/it-IT/api-referentie/native-devices/latest-screenshot-of-a-device): The screenshot the device uploaded in answer to the last `screenshot` command, or null when it never sent one. - [Organization replacement sounds](/it-IT/api-referentie/native-devices/organization-replacement-sounds): Sounds that replace the built-in tablet sounds for every device, unless a device sets its own. - [Replace organization sounds](/it-IT/api-referentie/native-devices/replace-organization-sounds): Sets the sounds every device plays instead of the built-in ones, and pushes them. A key left out keeps the Tillor sound. A device can still override a key. - [Upload a replacement sound](/it-IT/api-referentie/native-devices/upload-a-replacement-sound): Stores an MP3, WAV, M4A or AAC (at most 8 MB) and returns the public path to use as an organization or device sound. - [Play a replacement sound](/it-IT/api-referentie/native-devices/play-a-replacement-sound): The uploaded clip for this organization. The name is a content hash, so a cached copy never has to be revalidated. - [Upload a slideshow photo](/it-IT/api-referentie/native-devices/upload-a-slideshow-photo): Stores a photo (JPEG, PNG or WebP; kept as WebP) and returns the public path to use as a slide in a device's slideshow. - [Copy settings to devices of the same kind](/it-IT/api-referentie/native-devices/copy-settings-to-devices-of-the-same-kind): Copies this device's settings to every other tablet (or kiosk) of the organization and pushes them. - [Send a command to a tablet or kiosk](/it-IT/api-referentie/native-devices/send-a-command-to-a-tablet-or-kiosk): `identify` shows the device's name on its screen; `reload` restarts the app; `playSound` plays the https audio file in `url`. Only reaches devices that are online. - Nfc tag transactions - [List NFC Tag Transactions](/it-IT/api-referentie/nfc-tag-transactions/list-nfc-tag-transactions): Lists NFC tag transactions with pagination, filtering, and sorting. Use include parameter to include relations like nfcTag, controller. - [Get NFC Tag Transaction](/it-IT/api-referentie/nfc-tag-transactions/get-nfc-tag-transaction): Gets an NFC tag transaction by its ID. Use include parameter to include relations like nfcTag, controller. - Nfc tags - [List NFC Tags](/it-IT/api-referentie/nfc-tags/list-nfc-tags): Lists NFC tags with pagination, filtering, and sorting. Use include for relations. - [List Customer NFC Tags](/it-IT/api-referentie/nfc-tags/list-customer-nfc-tags): Lists NFC tags for a customer with pagination, filtering, and sorting. - [Get NFC Tag by UID](/it-IT/api-referentie/nfc-tags/get-nfc-tag-by-uid): Gets an NFC tag by hardware UID. Use include for relations like customer. - [Get NFC Card Key](/it-IT/api-referentie/nfc-tags/get-nfc-card-key): Returns the diversified Ultralight C key for one card UID under the organization's current master, plus the keys a card may still carry (NXP factory key, card keys under older masters) so a provisioning session can re-key it. - [Register NFC tag after POS Ultralight C provision](/it-IT/api-referentie/nfc-tags/register-nfc-tag-after-pos-ultralight-c-provision): Upserts the tag by UID, stores Ultralight C provision metadata, and returns the tag plus a shortened personal URL for NDEF writing. - [Reserve NFC Tap (POS)](/it-IT/api-referentie/nfc-tags/reserve-nfc-tap-pos): Reserve an NFC POS tap. amount is required in euros (negative = charge, positive = top-up). Requires nfc-tags:pos:charge or nfc-tags:pos:top-up matching the sign. - [Confirm NFC Tap (POS)](/it-IT/api-referentie/nfc-tags/confirm-nfc-tap-pos): Confirm or cancel a reserved NFC POS tap. - [Send Low Balance Notification](/it-IT/api-referentie/nfc-tags/send-low-balance-notification): Sends a notification about low balance for an NFC tag. - [Generate Personal URL](/it-IT/api-referentie/nfc-tags/generate-personal-url): Generates a personal URL for accessing NFC tag information. - [Get NFC Tag](/it-IT/api-referentie/nfc-tags/get-nfc-tag): Gets an NFC tag by its ID. Use include parameter to include relations like customer. - [Assign to Customer](/it-IT/api-referentie/nfc-tags/assign-to-customer): Assigns an NFC tag to a customer. - [Unassign from Customer](/it-IT/api-referentie/nfc-tags/unassign-from-customer): Removes the customer assignment from an NFC tag. - [Top Up NFC Tag](/it-IT/api-referentie/nfc-tags/top-up-nfc-tag): Adds balance to an NFC tag. - [Set NFC Tag Balance](/it-IT/api-referentie/nfc-tags/set-nfc-tag-balance): Sets the balance of an NFC tag to a specific value. Negative balances are allowed (admin force). - [Update Authorized Groups](/it-IT/api-referentie/nfc-tags/update-authorized-groups): Updates the list of groups authorized to use this NFC tag. - [Set NFC Tag Block Status](/it-IT/api-referentie/nfc-tags/set-nfc-tag-block-status): Sets whether an NFC tag is blocked or unblocked. - [Create Top-up Invoice](/it-IT/api-referentie/nfc-tags/create-top-up-invoice): Creates an invoice for topping up an NFC tag. - [Set NFC Tag Block Status](/it-IT/api-referentie/nfc-tags/set-nfc-tag-block-status-put): Sets whether an NFC tag is blocked or unblocked. - Notification inbox - [List Notification Inbox Items](/it-IT/api-referentie/notification-inbox/list-notification-inbox-items): Lists the notifications sent to the caller, newest first, one item per notification whatever the number of channels. Pass unread=true for unread items only. - [Count Unread Notification Inbox Items](/it-IT/api-referentie/notification-inbox/count-unread-notification-inbox-items): Returns how many notifications sent to the caller they have not read yet. - [Get Notification Inbox Item](/it-IT/api-referentie/notification-inbox/get-notification-inbox-item): Retrieves one notification sent to the caller, with the email that was sent for it when there is one. - [Mark Notification Inbox Items Read](/it-IT/api-referentie/notification-inbox/mark-notification-inbox-items-read): Marks the given notifications of the caller as read, or every unread one when ids is null. - [Mark Notification Inbox Items Unread](/it-IT/api-referentie/notification-inbox/mark-notification-inbox-items-unread): Marks the given notifications of the caller as unread again. - Notifications - [List platform notifications](/it-IT/api-referentie/notifications/list-platform-notifications): Notifications the platform sent outside any organization (super-admin action codes, platform security alerts, sign-up mails, system alerts), one row per channel attempt, with recipient and delivery status. Content is masked. Super admins only. - [List Notification Deliveries](/it-IT/api-referentie/notifications/list-notification-deliveries): Lists notification deliveries with pagination, filtering, sorting, and includes. Use overviewAttemptFilter for card-specific status scopes, deliveryChannel to filter by channel (EMAIL, SMS, POST, WHATSAPP, PUSH), and include for relations. - [Get Notification Delivery](/it-IT/api-referentie/notifications/get-notification-delivery): Retrieves a notification delivery by its ID. Use include for relations. - [Register External Notification](/it-IT/api-referentie/notifications/register-external-notification): Registers a notification that your own system already sent (e.g. an email to a customer) so staff can see it in Tillor. Tillor does not send anything. Idempotent on externalSource + externalReference: repeating the call returns the existing notification. Read registered notifications with GET /notifications?source=EXTERNAL. Requires the notifications:external:write permission. - [Update External Notification](/it-IT/api-referentie/notifications/update-external-notification): Updates the status, timestamps or content of an externally registered notification. Only notifications you registered yourself, unless you hold notifications:external:manage-others. Notifications sent by Tillor cannot be changed. - [Delete External Notification](/it-IT/api-referentie/notifications/delete-external-notification): Permanently deletes an externally registered notification. Only notifications you registered yourself, unless you hold notifications:external:manage-others. Notifications sent by Tillor cannot be deleted. - [Registered post quote](/it-IT/api-referentie/notifications/registered-post-quote): Returns Pingen postage quotes for a destination country: standard post cost and, when available, the extra cost for registered mail with receipt confirmation. - Oauth clients - [List OAuth Clients](/it-IT/api-referentie/oauth-clients/list-oauth-clients): Lists all OAuth clients for the authenticated user - [Create OAuth Client](/it-IT/api-referentie/oauth-clients/create-oauth-client): Creates a new OAuth client for the authenticated user - [Delete OAuth Client](/it-IT/api-referentie/oauth-clients/delete-oauth-client): Deletes an OAuth client - [Update OAuth Client](/it-IT/api-referentie/oauth-clients/update-oauth-client): Updates an OAuth client - [Rotate OAuth Client Secret](/it-IT/api-referentie/oauth-clients/rotate-oauth-client-secret): Rotates the client secret (confidential clients only) - Occupations - [List Occupations](/it-IT/api-referentie/occupations/list-occupations): Lists occupations with pagination, filtering, sorting, and includes. Supports filtering by customer, terrain, reservation, and paidUntil date range. - [Create Occupation](/it-IT/api-referentie/occupations/create-occupation): Creates a new occupation (optional description, paid until and invoiced until). - [Get Occupation](/it-IT/api-referentie/occupations/get-occupation): Gets a single occupation by ID with optional includes. - [Update Occupation](/it-IT/api-referentie/occupations/update-occupation): Updates an existing occupation (type, rent period, price, description, paid until, invoiced until). - [Delete Occupation](/it-IT/api-referentie/occupations/delete-occupation): Deletes an existing occupation. - [Get Occupation by Terrain ID](/it-IT/api-referentie/occupations/get-occupation-by-terrain-id): Gets the occupation for a specific terrain, if it exists. - [Create Extend-Occupation Draft Invoices](/it-IT/api-referentie/occupations/create-extend-occupation-draft-invoices): Creates one draft invoice for the customer with the first Extend occupation period product (sorted by name) and one anchor line per occupation id (same order as the request). Invoice-bundle children are resolved server-side per anchor. When requested, appends billable meter consumption for all meters on those occupations' terrains to the same draft. All occupation ids must belong to the same customer. - Organization settings - [Get organization settings](/it-IT/api-referentie/organization-settings/get-organization-settings): Returns organization settings for the current organization. Requires organization:settings:read or organization:settings:write. - [Update organization settings](/it-IT/api-referentie/organization-settings/update-organization-settings): Partially updates organization settings. Requires organization:settings:write; `terrainTariffFormula` also requires terrain-tariff:write. - [Get organization feature flags](/it-IT/api-referentie/organization-settings/get-organization-feature-flags): Returns the feature flags enabled for the current organization. Available to every organization member; flags are managed by Tillor super-admins. - [Get the terrain tariff formula](/it-IT/api-referentie/organization-settings/get-the-terrain-tariff-formula): Returns the TypeScript formula that calculates a terrain's annual tariff. Available to every organization member, since occupation prices derive from it; it is edited through PATCH /organization-settings. - [List opening hours for a date or range](/it-IT/api-referentie/organization-settings/list-opening-hours-for-a-date-or-range): Resolves published opening hours for one civil date (`date`) or an inclusive range (`from` and `to`, max 366 days). Omit the dates to use today in the organization timezone. Exceptions override seasonal periods, which override the regular weekly hours. Public holidays overlapping the range are included (`holidays` and `items[].holiday`). Optional `languageIsoCode` localizes holiday names. Requires organization:settings:read or organization:settings:write. - [Get the opening hours overview](/it-IT/api-referentie/organization-settings/get-the-opening-hours-overview): Everything a website needs to show opening hours: the regular week and every seasonal period as weekly schedules (`schedules`, the one that applies today marked `current`), and the dates from today through the next six days that deviate from their weekly schedule (`upcoming`): an exception that changes the hours, or a public holiday the park is open on. An exception that matches the normal hours, such as closed on an already closed Sunday, is not listed. Optional `languageIsoCode` localizes holiday names. Requires organization:settings:read or organization:settings:write. - [Update super-admin organization settings](/it-IT/api-referentie/organization-settings/update-super-admin-organization-settings): Partially updates super-admin-only organization settings (identity document scan retention, feature flags). Requires Tillor super-admin access. - [Wallet pass background status](/it-IT/api-referentie/organization-settings/wallet-pass-background-status): Returns whether a custom Apple Wallet Poster Generic background is configured. - [Upload wallet pass background](/it-IT/api-referentie/organization-settings/upload-wallet-pass-background): Uploads a custom background image for Apple Wallet Poster Generic passes (JPEG, PNG, or WebP). Large images are downscaled server-side to a 4× @3x master before storage. - [Remove wallet pass background](/it-IT/api-referentie/organization-settings/remove-wallet-pass-background): Removes the custom Apple Wallet background and restores the default gradient. - [Wallet pass background preview](/it-IT/api-referentie/organization-settings/wallet-pass-background-preview): Returns the uploaded Apple Wallet background image for settings preview. - Organizations - [List Organizations](/it-IT/api-referentie/organizations/list-organizations): Returns a list of organizations the user is a member of - [Get Organization](/it-IT/api-referentie/organizations/get-organization): Returns an organization by ID if the user has access. - [Add User](/it-IT/api-referentie/organizations/add-user): Assigns a user to an organization. Requires `organization:memberships:write` in that organization. - [Set organization maintenance mode](/it-IT/api-referentie/organizations/set-organization-maintenance-mode): Turns maintenance mode on or off for an organization. Super-admins only; not organization-scoped so it can be used from /orgs. - [Set whether an organization must accept the DPA](/it-IT/api-referentie/organizations/set-whether-an-organization-must-accept-the-dpa): Lets an organization work without an accepted data processing agreement, or requires it again. Super-admins only. - [List all organizations](/it-IT/api-referentie/organizations/list-all-organizations): Every organization with its member count. Super-admins only. - [Create organization](/it-IT/api-referentie/organizations/create-organization): Creates the organization (closed) under the given id and starts the run that sets up its database. 409 when the id or its database is taken. Super-admins only. - [Get organization (admin)](/it-IT/api-referentie/organizations/get-organization-admin): One organization with its members, database state and recent background runs. Super-admins only. - [Update organization](/it-IT/api-referentie/organizations/update-organization): Changes name, legal name, country and language. Super-admins only. - [Delete organization](/it-IT/api-referentie/organizations/delete-organization): Backs up and archives the organization database, then removes the organization. Super-admins only. - [Retry organization setup](/it-IT/api-referentie/organizations/retry-organization-setup): Runs the database setup of an organization again (create, migrate, open). Super-admins only. - [Run organization migrations](/it-IT/api-referentie/organizations/run-organization-migrations): Applies the migration history to the organization database (migrate deploy). Super-admins only. - [List organization backups](/it-IT/api-referentie/organizations/list-organization-backups): Every database backup of the organization, newest first. Super-admins only. - [Back up organization database](/it-IT/api-referentie/organizations/back-up-organization-database): Starts a backup of the organization database (daily tier). Super-admins only. - [Get organization backup details](/it-IT/api-referentie/organizations/get-organization-backup-details): Sizes and tables recorded with one backup; null for backups made before stats existed. Super-admins only. - [Create restore ticket](/it-IT/api-referentie/organizations/create-restore-ticket): Makes a one-time ticket for restoring one backup. The machine that holds the backup private key approves the restore with it. Super-admins only. - [Get restore ticket status](/it-IT/api-referentie/organizations/get-restore-ticket-status): Says whether the restore behind a ticket was approved and started, with the run to follow. Super-admins only. - [Request a code for a destructive action](/it-IT/api-referentie/organizations/request-a-code-for-a-destructive-action): Mails a one-time code to the calling super admin; deleting or restoring the organization requires it. Super-admins only. - [Get platform organization summary](/it-IT/api-referentie/organizations/get-platform-organization-summary): Counts every organization (total, in maintenance, created in the last 30 days) and lists the newest and those in maintenance. Super admins only. - [Get platform backup health](/it-IT/api-referentie/organizations/get-platform-backup-health): The organizations whose newest recorded database backup is older than 36 hours, or who have none. Super admins only. - [List failed admin background runs](/it-IT/api-referentie/organizations/list-failed-admin-background-runs): Failed organization setup, migration, backup, restore and delete runs of the last 7 days across every organization. Super admins only. - [Get My Organization Permissions](/it-IT/api-referentie/organizations/get-my-organization-permissions): Returns the effective permission ids for the current user in the current organization. - [List Organization Memberships](/it-IT/api-referentie/organizations/list-organization-memberships): Returns paginated organization memberships for the current organization. Supports filters, sorting, and optional includes (organization, user). - [List Organization Users](/it-IT/api-referentie/organizations/list-organization-users): Returns a list of users in the current organization. - [List Organization Invitations](/it-IT/api-referentie/organizations/list-organization-invitations): Returns pending invitations for the current organization. Requires organization:memberships:write. - [Invite Organization Member](/it-IT/api-referentie/organizations/invite-organization-member): Invites a user by email. Existing accounts are added as members immediately; unknown emails get a pending invitation that is redeemed when they first sign in. Requires organization:memberships:write. - [Revoke Organization Invitation](/it-IT/api-referentie/organizations/revoke-organization-invitation): Deletes a pending invitation from the current organization. Requires organization:memberships:write. - [Remove Organization Member](/it-IT/api-referentie/organizations/remove-organization-member): Removes a membership from the current organization. Requires organization:memberships:write. - [Update Organization Membership Permissions](/it-IT/api-referentie/organizations/update-organization-membership-permissions): Updates membership permissions for a user in the current organization. Requires organization:memberships:write. - [Get organization profile](/it-IT/api-referentie/organizations/get-organization-profile): Returns legal and contact details for the current organization. Requires organization:settings:read or organization:settings:write. - [Update Organization](/it-IT/api-referentie/organizations/update-organization-patch): Updates the current organization's profile. Members with organization:settings:write can change IBAN and address. Super-admins can change all profile fields except maintenance mode, which is toggled from /orgs. - [Upload organization logo or background](/it-IT/api-referentie/organizations/upload-organization-logo-or-background): Uploads the organization logo (PNG, JPEG, WebP or SVG; stored as PNG) or the public-page background photo (stored as WebP). Each upload gets a new content-hashed public URL that is cached for a year. - [Remove organization logo or background](/it-IT/api-referentie/organizations/remove-organization-logo-or-background): Falls back to the Tillor mark (logo) or the default public-page background. - Payment groups - [List Payment Groups](/it-IT/api-referentie/payment-groups/list-payment-groups): Lists all payment groups with filtering, sorting, and pagination (including JSON path filters on `metadata`, e.g. `?metadata[externalKey]=...`). Pass `withStats` (e.g. `true`, `yes`, bare `?withStats`, or `withStats=`) to enrich each row with `paymentCount`, `totalAmount`, and `totalAmountRemaining` (when member refunds apply) aggregated across member payments (single member query, regardless of page size). Combine with `include=invoice` to also load the assigned invoice — both are how the PaymentGroupsTable and its row dropdown (assign when OPEN; sync eligible Mollie payments; delete when OPEN with no payments) consume this endpoint. - [Create Payment Group](/it-IT/api-referentie/payment-groups/create-payment-group): Creates a new payment group. The customer is propagated per member payment from the invoice at assign-time, not stored on the group itself. Optional `metadata` is an integration-owned JSON object for dedupe keys, external shift ids, etc. - [Get Payment Group](/it-IT/api-referentie/payment-groups/get-payment-group): Retrieves a payment group by its ID, optionally with member payments and assigned invoice. Pass `withStats` (e.g. `true`, `yes`, bare `?withStats`) to add `paymentCount`, `totalAmount`, and `totalAmountRemaining` (when member refunds apply) aggregated across member payments (same fields as the list endpoint). - [Update Payment Group](/it-IT/api-referentie/payment-groups/update-payment-group): Updates an OPEN payment group: `name`, `description`, and/or `metadata` (integration JSON; send `null` to clear `metadata`). ASSIGNED groups are immutable. - [Delete Payment Group](/it-IT/api-referentie/payment-groups/delete-payment-group): Deletes an OPEN payment group. Member payments are unlinked from the group (ON DELETE SET NULL); payment rows are not deleted. - [Add Payments to Payment Group](/it-IT/api-referentie/payment-groups/add-payments-to-payment-group): Adds one or more payments to an OPEN payment group. Each payment must be PAID, transferrable (synced Mollie / Ponto), unassigned to an invoice, and not already in another group. - [Remove Payments from Payment Group](/it-IT/api-referentie/payment-groups/remove-payments-from-payment-group): Unlinks one or more payments from an OPEN payment group. - [Assign Payment Group to Invoice](/it-IT/api-referentie/payment-groups/assign-payment-group-to-invoice): Bulk-assigns all member payments to a BOOKED invoice in one operation. Each payment receives the invoice's customerId and a description derived from the invoice displayId; PaymentUpdatedEvent is emitted per payment so existing handlers (Mollie metadata sync, invoice payment recalc, payment report sync) run as usual. The group is marked ASSIGNED. - [Unassign Payment Group from Invoice](/it-IT/api-referentie/payment-groups/unassign-payment-group-from-invoice): Reverses an assignment: clears invoiceId/customerId on each member payment that is still pointing at the group's invoice, and flips the group back to OPEN. - [Sync payment group's member payments from provider](/it-IT/api-referentie/payment-groups/sync-payment-group-s-member-payments-from-provider): Loads all Tillor payments in the payment group by `id`, then refreshes each from the backing provider where supported (Mollie webhook-equivalent pathway). Non-applicable payments are skipped; failures are aggregated without stopping the remainder. - Payment reports - [List Payment Reports](/it-IT/api-referentie/payment-reports/list-payment-reports): Lists all payment reports with filtering, sorting, and pagination. - [Get Payment Report](/it-IT/api-referentie/payment-reports/get-payment-report): Retrieves a payment report by its ID with associated payments. - [Get Payment Report Navigation](/it-IT/api-referentie/payment-reports/get-payment-report-navigation): Gets navigation information for a payment report. - [Generate Payment Report PDF](/it-IT/api-referentie/payment-reports/generate-payment-report-pdf): Generates a PDF for the payment report and returns a URL for inline viewing. - [Print Payment Report](/it-IT/api-referentie/payment-reports/print-payment-report): Sends the payment report PDF to a printer. - [Export Payment Report to Accounting](/it-IT/api-referentie/payment-reports/export-payment-report-to-accounting): Starts a background run that exports the payment report to the organization's installed accounting integration. Returns the run with a read-only token to follow it over Trigger.dev realtime. - [Download Payment Reports Export](/it-IT/api-referentie/payment-reports/download-payment-reports-export): Returns one merged export file for payment reports in the selected range. Use year + month (1-12) for the Brussels calendar month of each report's settlement date, or year + period (0-12) for the Admisol book period (period 0 = 1 January book date; 1-12 = remaining calendar months). Format depends on the active accounting integration. - [Recalculate Payment Report](/it-IT/api-referentie/payment-reports/recalculate-payment-report): Recalculates total amount and payment count from linked payments, syncs Mollie settlement refund links when the report has a settlement, and emits update events for accounting export when configured. - Payments - [List Payment Method Statuses](/it-IT/api-referentie/payments/list-payment-method-statuses): Payment methods the provider is currently reporting problems with. Returns an empty list when the provider status source is unavailable. - [Export payment evidence PDF](/it-IT/api-referentie/payments/export-payment-evidence-pdf): Generates an in-memory PDF with organization header, payment details, and bank transfer evidence when available. - [Send payment evidence PDF to iPad](/it-IT/api-referentie/payments/send-payment-evidence-pdf-to-ipad): Generates the payment evidence PDF and sends it to iPad devices. - [List Payments](/it-IT/api-referentie/payments/list-payments): Lists payments with filtering, sorting, pagination, optional includes, and relation-exists filters (`has{Relation}` style). Search matches Tillor payment IDs, references, descriptions, customers, and invoices. Use `cardFingerprint` for an exact match on Mollie `channelInfo.details.cardFingerprint`, `maskedNumber` for an exact match on `channelInfo.details.maskedNumber` or `cardMaskedNumber`, or pass the same values via `search`. Json path filters such as `channelInfo.details.maskedNumber` are also supported. - [Get Payment](/it-IT/api-referentie/payments/get-payment): Returns a single payment by ID with optional relation includes (e.g. customer, invoice). - [EPC QR to pay a credit note](/it-IT/api-referentie/payments/epc-qr-to-pay-a-credit-note): Builds an EPC QR code that pays a booked credit note of the same customer back to the IBAN of this bank transfer. The structured communication is the credit note's, so the outgoing transfer can be matched when the bank syncs it. - [Sync payment from provider](/it-IT/api-referentie/payments/sync-payment-from-provider): For a Tillor payment backed by a supported provider, fetches latest state from the provider and reapplies webhook-equivalent processing. The server derives the provider transaction id from stored payment fields. - [Ingest external provider payment](/it-IT/api-referentie/payments/ingest-external-provider-payment): Provider-discriminated ingest. `MOLLIE`: returns an existing Tillor payment when `channelInfo.externalId` matches `paymentId`, otherwise fetches from Mollie using `paymentId` + `profileId`. `MANUAL`: upserts a PAID transferrable payment by `externalId` and assigns it to an OPEN PaymentGroup (`paymentGroupName` / `paymentGroupExternalId`). Requires invoice correction permission. - [Delete external MANUAL payment](/it-IT/api-referentie/payments/delete-external-manual-payment): Deletes a transferrable MANUAL payment previously ingested via `POST /payments/ingest-external` when `channelInfo.externalId` matches. No-ops with `deleted: false` when missing. Requires invoice correction permission. - [List Unassigned Payments](/it-IT/api-referentie/payments/list-unassigned-payments): Lists payments that can be assigned to an invoice. Returns transferrable payments (Mollie synced, Ponto transactions, external MANUAL) in PAID status that have no invoice assigned. - [Update Payment Invoice Assignment](/it-IT/api-referentie/payments/update-payment-invoice-assignment): Updates the invoice assignment for a transferrable payment. When an invoice is assigned, the payment's customerId is automatically set from the invoice. Passing invoiceId null unassigns the payment. Payments that belong to a payment group cannot be changed here. With force: true, super admins may reassign non-transferrable Mollie payments. - [Create Manual Payment](/it-IT/api-referentie/payments/create-manual-payment): Creates a new manual payment. - [Delete Manual Payment](/it-IT/api-referentie/payments/delete-manual-payment): Deletes a manual payment. - [List Terminals](/it-IT/api-referentie/payments/list-terminals): Lists all payment terminals. - [List Terminal Payments](/it-IT/api-referentie/payments/list-terminal-payments): Lists all terminal payments for an invoice. - [Execute Terminal Payment](/it-IT/api-referentie/payments/execute-terminal-payment): Executes a payment using a terminal. - [Cancel Terminal Payment](/it-IT/api-referentie/payments/cancel-terminal-payment): Cancels a terminal payment. - [Set Terminal Payment Follow-ups](/it-IT/api-referentie/payments/set-terminal-payment-follow-ups): Prints the invoice on A4 and/or mails it once the terminal payment succeeds, even if the client disconnects. - Post - [Registered post quote](/it-IT/api-referentie/post/registered-post-quote): Returns Pingen postage quotes for a destination country: standard post cost and, when available, the extra cost for registered mail with receipt confirmation. - Post notification deliveries - [Get post delivery PDF preview](/it-IT/api-referentie/post-notification-deliveries/get-post-delivery-pdf-preview): Returns a signed preview URL for the immutable PDF snapshot that was sent by post. - Print queue - [List print queue jobs](/it-IT/api-referentie/print-queue/list-print-queue-jobs): Lists print queue jobs with pagination, filtering, and sorting. Use status and type filters to monitor pending, processing, completed, or failed jobs. - [Get print queue control state](/it-IT/api-referentie/print-queue/get-print-queue-control-state): Returns whether printing is paused for the organization, and until when. While paused, instant and delayed print jobs stay queued and are not processed. - [Pause or resume printing](/it-IT/api-referentie/print-queue/pause-or-resume-printing): Pauses printing for a duration (15m, 1h, 4h, 6h, 1d, or until resumed) or resumes it. Jobs keep queueing while paused. Timed pauses schedule a flush when they expire; resuming flushes due jobs immediately. - [Get print queue job](/it-IT/api-referentie/print-queue/get-print-queue-job): Retrieves a print queue job by its ID. - [Retry failed print queue job](/it-IT/api-referentie/print-queue/retry-failed-print-queue-job): Resets a failed print queue job to pending, clears attempt count and last error, and triggers a queue flush. - [Cancel print queue job](/it-IT/api-referentie/print-queue/cancel-print-queue-job): Cancels a pending, scheduled, or failed print queue job so it will not be printed. - [Force print queue flush](/it-IT/api-referentie/print-queue/force-print-queue-flush): Promotes all scheduled print queue jobs to pending (due now), then schedules an immediate background run to process pending and due jobs for the organization. No-ops while printing is paused. - Printer - [Print PDF](/it-IT/api-referentie/printer/print-pdf): Prints a PDF from a URL to the organization's printer. - Products - [List Products](/it-IT/api-referentie/products/list-products): Lists all products with optional filtering and sorting. Filter by configured side-effect type via `configuredActionType` (include `null` for products without actions). - [Create Product](/it-IT/api-referentie/products/create-product): Creates a new product. - [Get Product](/it-IT/api-referentie/products/get-product): Retrieves a product by its ID. - [Delete Product](/it-IT/api-referentie/products/delete-product): Deletes a product by its ID. - [Update Product](/it-IT/api-referentie/products/update-product): Updates an existing product. - [List Product Price Changes](/it-IT/api-referentie/products/list-product-price-changes): Lists the queued and applied price changes of a product, newest date first. `effectiveFrom` is a date in the organization's time zone; `appliedAt` is set once the price was copied onto the product. - [Queue Product Price Change](/it-IT/api-referentie/products/queue-product-price-change): Queues a new price (including VAT) and optionally a new VAT rate for a product, starting on `effectiveFrom` (yyyy-MM-dd, organization time zone, today or later). Replaces a pending change on the same date; a change for today is applied immediately. - [Delete Product Price Change](/it-IT/api-referentie/products/delete-product-price-change): Removes a pending price change. Applied changes are history and cannot be deleted, except by a super admin with `force`. - Push notification deliveries - [List Push Notification Deliveries](/it-IT/api-referentie/push-notification-deliveries/list-push-notification-deliveries): Lists push notification deliveries with pagination, filtering, sorting, and includes. Use include for relations. - [Get Push Notification Delivery](/it-IT/api-referentie/push-notification-deliveries/get-push-notification-delivery): Retrieves a push notification delivery by its ID. Use include for relations. - Rbac - [Get My Organization Permissions](/it-IT/api-referentie/rbac/get-my-organization-permissions): Returns the effective permission ids for the current user in the current organization. - Realtime - [Subscribe to Realtime Events](/it-IT/api-referentie/realtime/subscribe-to-realtime-events): Subscribe to organization realtime events via Server-Sent Events (SSE). Optionally filter by event types. Events are only delivered when the authenticated member has permission for that event type. - Reservations - [List Reservations](/it-IT/api-referentie/reservations/list-reservations): Lists reservations with pagination, filtering, sorting, and includes. - [Create Reservation](/it-IT/api-referentie/reservations/create-reservation): Creates a new reservation. - [List Customer Reservations](/it-IT/api-referentie/reservations/list-customer-reservations): Lists reservations for a customer with pagination, filtering, and sorting. - [Get Reservation](/it-IT/api-referentie/reservations/get-reservation): Gets a reservation by its ID. - [Replace Reservation](/it-IT/api-referentie/reservations/replace-reservation): Replaces an existing reservation. - [Check in reservation](/it-IT/api-referentie/reservations/check-in-reservation): Records check-in (status → checked in). - [Check out reservation](/it-IT/api-referentie/reservations/check-out-reservation): Records check-out (status → checked out). - [Revert check-out (backoffice)](/it-IT/api-referentie/reservations/revert-check-out-backoffice): Clears check-out timestamp and sets status back to checked in (accidental check-out). - [Revert check-in (backoffice)](/it-IT/api-referentie/reservations/revert-check-in-backoffice): Clears check-in timestamp and sets status back to booked (accidental check-in). Not allowed when already checked out. - [Cancel reservation](/it-IT/api-referentie/reservations/cancel-reservation): Records cancellation (status → canceled). Only allowed while the reservation is still booked (not checked in). - [Revert cancellation (backoffice)](/it-IT/api-referentie/reservations/revert-cancellation-backoffice): Clears cancellation and sets status back to booked (accidental cancellation). Only allowed when the reservation was canceled before check-in. - Search - [Search](/it-IT/api-referentie/search/search): Searches across multiple resources. - Security events - [List Security Events](/it-IT/api-referentie/security-events/list-security-events): Lists platform-wide security events (failed sign-ins, rejected credentials, access denials, rate limits, super admin organization access) with filtering, sorting and pagination. Super admins only. - [Get Security Event Details](/it-IT/api-referentie/security-events/get-security-event-details): Returns one security event with the names of its organization, OAuth client and API key, and how often the same cause repeated in the preceding 24 hours. Super admins only. - Signature requests - [List Signature Requests](/it-IT/api-referentie/signature-requests/list-signature-requests): Lists signature requests with pagination, filtering (e.g. `customerId`, `status`), search on the title or customer name and sorting. - [Create Signature Request](/it-IT/api-referentie/signature-requests/create-signature-request): Starts a draft signature request for a customer from an uploaded PDF (stored on the customer) or from one of the customer's PDF documents. - [Get Signature Request](/it-IT/api-referentie/signature-requests/get-signature-request): Returns one signature request, optionally with its customer, documents, signers or fields. - [Update Signature Request Draft](/it-IT/api-referentie/signature-requests/update-signature-request-draft): Replaces the title, message, expiry, signers (in signing order) and signature fields of a draft. Sent requests cannot be edited. - [Delete Signature Request Draft](/it-IT/api-referentie/signature-requests/delete-signature-request-draft): Deletes a draft that was never sent. The uploaded PDF stays on the customer. Sent requests are evidence: cancel them instead. - [Send Signature Request](/it-IT/api-referentie/signature-requests/send-signature-request): Sends a draft: the first signer gets their signing link, the next ones follow in order as each signs. - [Revert Signature Request to Draft](/it-IT/api-referentie/signature-requests/revert-signature-request-to-draft): Takes a sent request back to the editor while nobody signed, or when the only signature is the current user's own. Every signer starts over and links already sent stop working. - [Cancel Signature Request](/it-IT/api-referentie/signature-requests/cancel-signature-request): Withdraws a request that has not completed; its signing links stop working. - [Remind Signer](/it-IT/api-referentie/signature-requests/remind-signer): Sends the signer whose turn it is a new signing link; the previous link stops working. - [Send Signer to Tablet](/it-IT/api-referentie/signature-requests/send-signer-to-tablet): Opens the signing page of the signer whose turn it is on the on-site tablets of the organization. With `skipVerification` the staff member vouches for the signer's identity and no code is asked. - [Start Tablet Signing Session](/it-IT/api-referentie/signature-requests/start-tablet-signing-session): What the on-site tablet opens for a signer: their signing page, marked as on-site for the device user, plus the name to show. The signer still confirms with a verification code. - Sms notification deliveries - [List SMS Notification Deliveries](/it-IT/api-referentie/sms-notification-deliveries/list-sms-notification-deliveries): Lists SMS notification deliveries with pagination, filtering, sorting, and includes. Use include for relations. - [Get SMS Notification Delivery](/it-IT/api-referentie/sms-notification-deliveries/get-sms-notification-delivery): Retrieves an SMS notification delivery by its ID. Use include for relations. - Staff groups - [List Staff Groups](/it-IT/api-referentie/staff-groups/list-staff-groups): Lists colleague groups and their members. - [Create Staff Group](/it-IT/api-referentie/staff-groups/create-staff-group): Creates a colleague group. - [Update Staff Group](/it-IT/api-referentie/staff-groups/update-staff-group): Renames a colleague group or replaces its members. - [Delete Staff Group](/it-IT/api-referentie/staff-groups/delete-staff-group): Deletes a colleague group. Tasks keep their other assignees. - [Entra group provisioning](/it-IT/api-referentie/staff-groups/entra-group-provisioning): The tenant URL and the Entra groups waiting to be mapped onto staff groups. - [Rotate the SCIM token](/it-IT/api-referentie/staff-groups/rotate-the-scim-token): Replaces the bearer token Entra uses. The new token is returned once. - [Map an Entra group](/it-IT/api-referentie/staff-groups/map-an-entra-group): Links a pushed Entra group to a staff group, or creates one. - [Store Entra group details](/it-IT/api-referentie/staff-groups/store-entra-group-details): Group type, mail and Teams flag per Entra object id, read from Microsoft Graph by the guided setup. - [Latest guided Entra setup run](/it-IT/api-referentie/staff-groups/latest-guided-entra-setup-run): The last setup run while it runs and for an hour after it finished, with a read-only token to follow it. Null when there is none. - [Start the guided Entra setup](/it-IT/api-referentie/staff-groups/start-the-guided-entra-setup): Starts a background run that creates the Entra enterprise app, configures provisioning and pushes groups, with the admin's delegated Microsoft Graph token. Returns the run with a read-only token to follow it over Trigger.dev realtime. - Tasks - [List Task Shares](/it-IT/api-referentie/tasks/list-task-shares): Lists this user's share links for their assigned tasks, or for one saved view, including links that have been invalidated. - [Create Task Share](/it-IT/api-referentie/tasks/create-task-share): Creates a new private link, either a view-only task board or an ICS subscription. Earlier links keep working until they are invalidated. - [Revoke Task Share](/it-IT/api-referentie/tasks/revoke-task-share): Invalidates one of this user's share links. Other links are left as they are. - [List Task Time Entries](/it-IT/api-referentie/tasks/list-task-time-entries): Lists the time logged on a task, newest day first. - [Log Time On Task](/it-IT/api-referentie/tasks/log-time-on-task): Logs time the current user spent on a task on a given day. - [Delete Task Time Entry](/it-IT/api-referentie/tasks/delete-task-time-entry): Deletes a time entry the current user logged. - [List Pending Task Timers](/it-IT/api-referentie/tasks/list-pending-task-timers): Lists in-progress timers on a task, so colleagues can see who is working. - [Clear Pending Task Timer](/it-IT/api-referentie/tasks/clear-pending-task-timer): Removes the current user's in-progress timer. - [Sync Pending Task Timer](/it-IT/api-referentie/tasks/sync-pending-task-timer): Stores the current user's in-progress timer so colleagues can see it. - [List Followed Task Views](/it-IT/api-referentie/tasks/list-followed-task-views): Lists the ids of the task views the current user gets a daily digest of. - [Unfollow Task View](/it-IT/api-referentie/tasks/unfollow-task-view): Stops the current user's daily digest of the view. - [Follow Task View](/it-IT/api-referentie/tasks/follow-task-view): Sends the current user a daily email digest of what is open in the view. - [List Tasks](/it-IT/api-referentie/tasks/list-tasks): Lists tasks with pagination, filtering, and sorting. - [Create Task](/it-IT/api-referentie/tasks/create-task): Creates a new task. - [List Customer Tasks](/it-IT/api-referentie/tasks/list-customer-tasks): Lists tasks for a customer with pagination, filtering, and sorting. - [List Open Entity Tasks](/it-IT/api-referentie/tasks/list-open-entity-tasks): Lists the open tasks linked to one customer, terrain, meter, invoice, reservation or product, in the same order as List Tasks. - [List Assigned Tasks](/it-IT/api-referentie/tasks/list-assigned-tasks): Lists tasks assigned to the current user, ordered by their personal order. - [Reorder Assigned Tasks](/it-IT/api-referentie/tasks/reorder-assigned-tasks): Persists the current user's personal order for their assigned tasks. - [Reorder Subtasks](/it-IT/api-referentie/tasks/reorder-subtasks): Persists the order of a task's subtasks. - [Get Task](/it-IT/api-referentie/tasks/get-task): Gets a task by its ID. - [Update Task](/it-IT/api-referentie/tasks/update-task): Updates a task's fields, assignees, and labels. - [Delete Task](/it-IT/api-referentie/tasks/delete-task): Deletes a task by its ID. Deleting a task its automation locked fails the automation run waiting on it. - [Get Task Card](/it-IT/api-referentie/tasks/get-task-card): Gets a task with every relation the task card and dialog render. - [Get Task Link Customer](/it-IT/api-referentie/tasks/get-task-link-customer): Gets the customer a terrain, invoice, reservation or meter belongs to, so it can be linked to a task as well. - [Choose Task Action](/it-IT/api-referentie/tasks/choose-task-action): Chooses one of a task's actions, which completes the task. The choice is final: it continues the automation waiting on the task and starts the automation linked to the action. Assignees of the task and administrators. - [Move Task](/it-IT/api-referentie/tasks/move-task): Moves a task to a column and position on a grouped board, as used by drag and drop. - [Get Task PDF](/it-IT/api-referentie/tasks/get-task-pdf): Renders the task as an A4 PDF and returns a preview URL for the browser. - [Print Task](/it-IT/api-referentie/tasks/print-task): Enqueues a task print job for the A4 network printer or the POS/thermal printer. - [List Task Labels](/it-IT/api-referentie/tasks/list-task-labels): Lists available task labels. - [Create Task Label](/it-IT/api-referentie/tasks/create-task-label): Creates a task label. - [Get Task Label](/it-IT/api-referentie/tasks/get-task-label): Gets a task label by its ID. - [Update Task Label](/it-IT/api-referentie/tasks/update-task-label): Updates a task label. - [Delete Task Label](/it-IT/api-referentie/tasks/delete-task-label): Deletes a task label. Tasks keep their other labels. - [List Task Views](/it-IT/api-referentie/tasks/list-task-views): Lists the task views visible to the current user: every organization view plus their own personal views. - [Create Task View](/it-IT/api-referentie/tasks/create-task-view): Creates a new manual or smart task view. - [Get Favorite Task View](/it-IT/api-referentie/tasks/get-favorite-task-view): Returns the view the current user pinned to their dashboard, or null when they have none. - [Set Favorite Task View](/it-IT/api-referentie/tasks/set-favorite-task-view): Pins one view to the current user's dashboard, replacing any earlier pick; a null viewId clears it. - [Get All Tasks View](/it-IT/api-referentie/tasks/get-all-tasks-view): Returns the saved filter, grouping and layout of the built-in view of every task, shared by the organization. - [Save All Tasks View](/it-IT/api-referentie/tasks/save-all-tasks-view): Saves the filter, grouping and layout of the built-in view of every task for the whole organization. - [Get Task View](/it-IT/api-referentie/tasks/get-task-view): Gets a task view by its ID. - [Update Task View](/it-IT/api-referentie/tasks/update-task-view): Updates a task view's name, appearance, scope, or definition. - [Delete Task View](/it-IT/api-referentie/tasks/delete-task-view): Deletes a task view. Its tasks are kept and simply lose this membership. - [Resolve Task View](/it-IT/api-referentie/tasks/resolve-task-view): Resolves a saved view or an unsaved draft definition into grouped, paginated tasks. - [Reorder Task Views](/it-IT/api-referentie/tasks/reorder-task-views): Persists a new display order for task views. - [Duplicate Task View](/it-IT/api-referentie/tasks/duplicate-task-view): Copies a view under a new name, including its filter, its columns and the tasks placed in them. - [Add Tasks To View](/it-IT/api-referentie/tasks/add-tasks-to-view): Adds tasks to a manual view without changing anything else about them. - [Remove Tasks From View](/it-IT/api-referentie/tasks/remove-tasks-from-view): Removes tasks from a manual view. The tasks themselves are kept. - Taxes - [Validate VAT Number](/it-IT/api-referentie/taxes/validate-vat-number): Validates a VAT number using the VIES system. - Terrain types - [List Terrain Types](/it-IT/api-referentie/terrain-types/list-terrain-types): Lists all terrain types with optional filtering and sorting. - [Create Terrain Type](/it-IT/api-referentie/terrain-types/create-terrain-type): Creates a new terrain type. - [Get Terrain Type](/it-IT/api-referentie/terrain-types/get-terrain-type): Retrieves a terrain type by its ID. - [Delete Terrain Type](/it-IT/api-referentie/terrain-types/delete-terrain-type): Deletes a terrain type by its ID. Terrains using it become untyped. - [Update Terrain Type](/it-IT/api-referentie/terrain-types/update-terrain-type): Updates an existing terrain type. - Terrains - [List terrains](/it-IT/api-referentie/terrains/list-terrains): Lists terrains with pagination, filtering, sorting, and includes. Supports virtual fields: customer and occupation. Supports direct relations: meters, occupations, reservations, comments. - [Create terrain](/it-IT/api-referentie/terrains/create-terrain): Creates a new terrain with the provided data. - [List available terrains](/it-IT/api-referentie/terrains/list-available-terrains): Lists terrains without occupation by default. Set includeOccupied=true to also return occupied terrains. With checkIn (and optional checkOut), excludes terrains with overlapping active reservations. Set bookable=true to limit to bookable terrains only. - [Get terrain by ID](/it-IT/api-referentie/terrains/get-terrain-by-id): Retrieves a specific terrain by its ID. Supports virtual fields: customer, occupation (same as list endpoint). - [Update terrain](/it-IT/api-referentie/terrains/update-terrain): Updates an existing terrain with partial data. - [Delete terrain](/it-IT/api-referentie/terrains/delete-terrain): Deletes a terrain by ID. Occupations must be removed first. Reservations keep their stay history and lose the preferred-terrain link. - [Replace terrain](/it-IT/api-referentie/terrains/replace-terrain): Replaces an existing terrain with complete data. - [Export Terrains](/it-IT/api-referentie/terrains/export-terrains): Generates an XLSX export of all terrains with their details. - [Export park map PDF](/it-IT/api-referentie/terrains/export-park-map-pdf): Builds an A4 PDF from a posted map image, then a table of the terrains shown on that map. - [Import Terrains](/it-IT/api-referentie/terrains/import-terrains): Imports terrain data from an XLSX file and upserts changes. Creates new terrains or updates existing ones based on ID (primary) or name (fallback). Only requires ID or name column, all other fields are optional. - Vehicle presences - [List Vehicle Presences](/it-IT/api-referentie/vehicle-presences/list-vehicle-presences): Lists per-plate vehicle presence derived from LPR reads at barriers (inside, ghost, or left), with filtering, sorting, and pagination - [Get Vehicle Presence Trends](/it-IT/api-referentie/vehicle-presences/get-vehicle-presence-trends): Returns park occupancy trends derived from LPR reads at barriers: an entries/exits/occupancy series bucketed per hour or day in the organization timezone, an hour-of-day profile for spotting popular hours, and range totals - Wallet pass - [Wallet pass availability](/it-IT/api-referentie/wallet-pass/wallet-pass-availability): Returns which wallet pass providers are configured for this environment (Apple Wallet today; Google Wallet when enabled). - [Download QR Apple Wallet pass](/it-IT/api-referentie/wallet-pass/download-qr-apple-wallet-pass): Creates or refreshes a signed .pkpass for a QR_CODE access method. Live updates use the PassKit Web Service routes on this router. - [Save QR pass to Google Wallet (staff)](/it-IT/api-referentie/wallet-pass/save-qr-pass-to-google-wallet-staff): Creates or refreshes a Google Wallet Generic pass and redirects to the Save to Google Wallet flow. - [Force sync QR wallet passes](/it-IT/api-referentie/wallet-pass/force-sync-qr-wallet-passes): Bumps every Apple and Google Wallet pass of a QR_CODE access method, even when its content is unchanged, and pushes the update to registered devices. - [Generate personal access URL](/it-IT/api-referentie/wallet-pass/generate-personal-access-url): Returns a customer-facing URL (signed token, no expiry) to preview the QR access method; Apple Wallet download is offered on that page when configured. - [Apple Wallet pass installed (public link)](/it-IT/api-referentie/wallet-pass/apple-wallet-pass-installed-public-link): Returns whether an Apple Wallet pass for this access method has been added on at least one device (PassKit device registration). Requires a valid personal-view token in query parameter v. - [Google Wallet pass logo](/it-IT/api-referentie/wallet-pass/google-wallet-pass-logo): Public PNG logo for Google Wallet passes (org mark on theme background). Fetched by Google when a pass is saved. - [Google Wallet pass hero image](/it-IT/api-referentie/wallet-pass/google-wallet-pass-hero-image): Public wide gradient banner for Google Wallet passes, matching the Apple Wallet background theme. - [Download Apple Wallet pass (public link)](/it-IT/api-referentie/wallet-pass/download-apple-wallet-pass-public-link): Issues a signed .pkpass when the query parameter v contains a valid personal-view token. - [Save Google Wallet pass (public link)](/it-IT/api-referentie/wallet-pass/save-google-wallet-pass-public-link): Issues a Save to Google Wallet JWT when the query parameter v contains a valid personal-view token, then redirects to Google Wallet. - Weather - [List daily weather](/it-IT/api-referentie/weather/list-daily-weather): Returns stored daily weather for the organization map center between two calendar dates (org timezone). Data is populated by scheduled sync tasks. - Webhooks - [List Webhooks](/it-IT/api-referentie/webhooks/list-webhooks): Lists webhooks for the organization. - [Create Webhook](/it-IT/api-referentie/webhooks/create-webhook): Creates a new webhook. subscribedEventKeys must only include events the current member is allowed to receive (see organization permissions). - [Get webhook delivery stats](/it-IT/api-referentie/webhooks/get-webhook-delivery-stats): Returns counts of webhook deliveries waiting for retry and permanently failed deliveries for the organization, grouped by webhook endpoint. - [Retry webhook deliveries](/it-IT/api-referentie/webhooks/retry-webhook-deliveries): Retries webhook dead-letter deliveries. Use `mode: failed` to re-queue permanently failed deliveries and attempt immediate redelivery (synchronous). Use `mode: force` to retry pending scheduled and permanently failed deliveries immediately in the background, ignoring retry wait times. Pass optional `id` to scope to one enabled webhook; omit `id` for all enabled webhooks. - [Get Webhook](/it-IT/api-referentie/webhooks/get-webhook): Gets a webhook by ID. - [Update Webhook](/it-IT/api-referentie/webhooks/update-webhook): Updates a webhook. When subscribedEventKeys is set, each key must be allowed for the current member's permissions. - [Delete Webhook](/it-IT/api-referentie/webhooks/delete-webhook): Deletes a webhook. - Whatsapp notification deliveries - [List WhatsApp Notification Deliveries](/it-IT/api-referentie/whatsapp-notification-deliveries/list-whatsapp-notification-deliveries): Lists WhatsApp notification deliveries with pagination, filtering, sorting, and includes. Use include for relations. - [Get WhatsApp Notification Delivery](/it-IT/api-referentie/whatsapp-notification-deliveries/get-whatsapp-notification-delivery): Retrieves a WhatsApp notification delivery by its ID. Use include for relations.