# Panoramica (/it-IT/aan-de-slag)

In questa pagina ripercorri il tuo primo giorno in Tillor, dall'accesso alla prima fattura. L'ordine conta, perché ogni parte si basa sulla precedente. Un'occupazione, per esempio, richiede un cliente e una piazzola, quindi crei prima quelli. Preferisci seguire un esempio dalla vita reale? Guarda [Dalla pratica](/praktijk). Se incontri una parola che non conosci, cercala in [Termini](/begrippen).

## Come si collega tutto? [#hoe-hangt-dit-samen]

Questi sono i mattoni e ciò di cui hanno bisogno:

```mermaid
flowchart LR
  I[Instellingen] --> T[Terreinen]
  T --> B[Bezetting]
  T --> R[Reservering]
  K[Klanten] --> B
  K --> R
  P[Producten] --> F[Factuur]
  K --> F
  B --> F
  R --> F
  F --> Bet[Betaling]
```

Una fattura appartiene sempre a un cliente. Un cliente su una piazzola per un periodo lungo si chiama occupazione, un soggiorno con data di check-in e di check-out si chiama prenotazione. I prodotti non sono obbligatori, ma garantiscono che prezzo, IVA e azioni sulla riga di fattura siano corretti.

<Callout type="info" title="Da sapere">
- Se hai più di un'organizzazione, dopo l'accesso ne scegli una. Se te ne manca una, chiedi al tuo amministratore di invitarti.
- Le voci di menu che vedi dipendono dai tuoi permessi. Se non vedi qualcosa, chiedi il permesso al tuo amministratore.
- Senza una piazzola non puoi creare un'occupazione. Senza un cliente non puoi creare una prenotazione, un'occupazione o una fattura.
- Contanti, bonifico e altri pagamenti manuali funzionano senza collegamento. Per pagare online o con il POS collega Mollie.
- Il modo più veloce per ritrovare qualcosa è cercare con **Ctrl+K** o **⌘K**.
</Callout>

Prima di iniziare:

- Hai un account Microsoft, Google o Apple e il tuo amministratore ti ha invitato nella tua organizzazione. Senza invito non vedi nessuna organizzazione.
- Hai i permessi per ciò che vuoi fare. Se mancano, la voce di menu non c'è o il pulsante è grigio.

## Configurare il tuo parco [#je-park-inrichten]

<Steps>
<Step>
### Accedi e scegli la tua organizzazione [#log-in-en-kies-je-organisatie]
Accedi con il tuo account Microsoft, Google o Apple. Se hai accesso a più di un'organizzazione, ne scegli una. Se non hai ancora accesso, chiedi al tuo amministratore di invitarti. Vedi [Accesso](/inloggen).
</Step>
<Step>
### Controlla le impostazioni dell'organizzazione [#loop-de-organisatie-instellingen-na]
Apri <UIPath>Assistenza > Impostazioni</UIPath>. In **Generale** controlla il fuso orario e il paese predefinito, e in **Orari di apertura** inserisci i tuoi orari. In **Fatturazione** trovi tra l'altro la scadenza predefinita e le aliquote IVA. I colleghi li inviti in **Utenti**. Vedi [Organizzazione](/gebruikers/organisaties).
</Step>
<Step>
### Crea le tue piazzole [#maak-je-terreinen-aan]
Vai a <UIPath>Parco > Piazzole</UIPath> e aggiungi i tuoi posti, come lotti, chalet e posti fissi. Senza una piazzola non puoi creare un'occupazione, e i contatori li colleghi a una piazzola. Vedi [Piazzole](/terreinen).
</Step>
<Step>
### Crea i tuoi prodotti [#maak-je-producten-aan]
Vai a <UIPath>Amministrazione > Prodotti</UIPath> e crea le tariffe e i servizi che finiscono sulle fatture, come le notti di soggiorno. Una riga di fattura può esistere anche senza prodotto, ma con un prodotto prezzo, IVA ed eventuali azioni sono subito corretti. Vedi [Prodotti](/producten).
</Step>
<Step>
### Aggiungi i tuoi clienti [#voeg-je-klanten-toe]
Vai a <UIPath>Clienti > Panoramica</UIPath> e crea un cliente. Prenotazioni, occupazioni e fatture appartengono sempre a un cliente. Vedi [Gestione clienti](/klantenbeheer).
</Step>
<Step>
### Crea una prenotazione o un'occupazione [#maak-een-reservering-of-bezetting-aan]
Una prenotazione è per un soggiorno con una data di check-in e di check-out, e puoi crearla anche senza una piazzola fissa. Un'occupazione collega un cliente a una piazzola per un periodo lungo, per esempio una piazzola annuale. Vedi [Prenotazioni](/reserveringen) e [Occupazioni](/bezettingen).
</Step>
<Step>
### Crea la tua prima fattura [#maak-je-eerste-factuur]
Apri il profilo del cliente e crea lì una nuova fattura. Aggiungi le righe, contabilizza la fattura e inviala. Vedi [Fatture](/facturen).
</Step>
<Step>
### Collega i pagamenti [#koppel-betalingen]
Se vuoi che i clienti paghino online o con il POS, collega Mollie in <UIPath>Assistenza > Impostazioni</UIPath> sotto **Integrazioni**. Contanti, bonifico e altri pagamenti manuali funzionano senza collegamento. Vedi [Elaborazione dei pagamenti](/betalingsverwerking) e [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).
</Step>
</Steps>

Se usi contatori, sbarre o tag NFC, li configuri in seguito. Guarda prima [Parco](/park) e [Controllo accessi](/toegangscontrole).

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- I tuoi clienti, le tue piazzole e i tuoi prodotti sono pronti, così puoi creare ogni giorno prenotazioni, occupazioni e fatture.
- La tua prima fattura è una bozza presso il cliente. Solo dopo **Contabilizza** riceve un numero definitivo, e poi puoi inviarla e farla pagare.
- Se hai collegato Mollie, i clienti possono pagare online o con il POS e il pagamento torna da solo sulla fattura.

## Orientarsi [#je-weg-vinden]

Il menu principale è a sinistra. In alto cambi organizzazione se ne hai più di una. Le voci che vedi dipendono dai tuoi permessi.

<DocScreenshot src="/screenshots/inleiding/dashboard-welcome.png" alt="Dashboard - schermata iniziale dopo l'accesso" />

| Menu | A cosa serve |
|------|----------|
| **Dashboard** | Schermata iniziale con gli arrivi e le partenze di oggi |
| **Prenotazioni** | Soggiorni e calendario delle prenotazioni |
| **Attività** | Distribuire e seguire il lavoro |
| **Controllo accessi** | Punti di accesso e registro degli accessi |
| **Clienti** | **Panoramica** e **Consumi in sospeso** |
| **Parco** | **Mappa**, **Piazzole**, **Contatori**, **Armadi contatori** e **Meteo** |
| **Comunicazione** | **Chiamate telefoniche**, **Notifiche** e **Commenti** |
| **Amministrazione** | **Documenti**, **Firme**, **Fatture**, **Pagamenti**, **Transazioni bancarie** (con il permesso di visualizzarle), **Report dei pagamenti**, **Coda di stampa** e **Prodotti** |

Sotto il titolo **Amministratore** trovi **Automazioni** (con il permesso di visualizzarle) e **Controller**. In basso, sotto **Assistenza**, trovi le tue notifiche, **Inbox** e **Registro di audit** (con i relativi permessi), **Impostazioni** e **Altre risorse** con la documentazione. Le voci che vedi dipendono dai tuoi permessi.

Per cercare usi **Cerca** nell'intestazione, oppure **⌘K** (Mac) o **Ctrl+K** (Windows). Così vai direttamente a un cliente, una fattura, una prenotazione o una piazzola. Vedi [Cerca](/zoeken).

Il tuo account, le sessioni e le chiavi API si trovano tramite il tuo nome in fondo al menu.


## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco ad accedere alla mia organizzazione">
Il tuo amministratore deve prima invitarti. Accedi con l'account con cui ti ha invitato. Vedi [Accesso](/inloggen).
</Accordion>
<Accordion title="Non vedo una voce di menu che compare in questa guida">
Vedi solo le voci per cui hai i permessi. Chiedi il permesso al tuo amministratore, oppure il ruolo che lo include.
</Accordion>
<Accordion title="Non riesco a creare un'occupazione">
Non c'è nessuna piazzola disponibile, oppure il cliente non esiste ancora. Crea prima una piazzola e un cliente. Una piazzola con un'occupazione in corso non compare nell'elenco di scelta.
</Accordion>
<Accordion title="Non so dove trovare qualcosa">
Usa **Cerca** nell'intestazione, oppure cerca in questa guida con la barra di ricerca in alto.
</Accordion>
</Accordions>

## Serve aiuto? [#hulp-nodig]

- Se cerchi qualcosa in questa guida, usa la barra di ricerca in alto oppure scegli in Tillor **Altre risorse > Documentazione**.
- Tillor non funziona come previsto? Controlla prima lo [stato del sistema](https://status.tillor.eu) per guasti e manutenzioni programmate.
- Non hai accesso a un'organizzazione, o vuoi modificare i dati aziendali sulle fatture? Scrivi a support@tillor.eu.
- Vuoi recuperare dati da un backup? Vedi [Dati e backup](/gegevens-backups).

## Termini [#begrippen]

- **Organizzazione**: il tuo account Tillor, di solito la tua azienda. Vedi [Termini](/begrippen#organisatie).
- **Parco**: il luogo fisico. Vedi [Termini](/begrippen#park).
- **Cliente**: una persona o un'azienda in Tillor. Vedi [Termini](/begrippen#klant).
- **Piazzola**: un posto nel tuo parco. Vedi [Termini](/begrippen#terrein).
- **Occupazione** e **prenotazione**: un cliente su una piazzola per un periodo lungo, oppure un soggiorno con data di check-in e di check-out. Vedi [Termini](/begrippen#bezetting).
- **Contabilizzare**: rendere definitiva una fattura. Vedi [Termini](/begrippen#boeken).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Dalla pratica" href="/praktijk" description="Esempi svolti di una giornata di lavoro" />
  <Card title="Termini" href="/begrippen" description="Tutti i termini in un colpo d'occhio" />
  <Card title="Accesso" href="/inloggen" description="Metodi di accesso e il tuo account" />
  <Card title="Cerca" href="/zoeken" description="Trova in fretta ciò che cerchi" />
  <Card title="Dati e backup" href="/gegevens-backups" description="Tempi di conservazione e ripristino" />
  <Card title="Novità" href="/wat-is-nieuw" description="Modifiche recenti mese per mese" />
</Cards>


# Termini (/it-IT/begrippen)

Tillor usa alcune parole più spesso di quanto ti aspetti, e alcune si assomigliano. In questa pagina trovi per ogni termine cosa significa e dove leggerne di più. L'elenco segue l'ordine alfabetico olandese. Se cerchi qualcosa sui controller stessi, come ACL o firmware, guarda il [glossario dei controller](/controllers/lexicon).

<Callout type="info" title="Due parole che si confondono spesso">
Un'**occupazione** è un cliente che sta su una piazzola per un periodo lungo, come un cliente stagionale. Una **prenotazione** è una riserva per un singolo soggiorno. Con **contabilizzare** Tillor intende sempre rendere definitiva una fattura, mai prenotare un soggiorno.
</Callout>

### Sollecito [#aanmaning]

Un promemoria a un cliente che una fattura contabilizzata non è ancora stata pagata. Lo invii per ogni fattura, con lo stesso link per pagare online. Vedi [Inviare un sollecito](/facturen/versturen#een-aanmaning-versturen).

### Automazione [#automatisering]

Una regola che Tillor esegue da sé: quando succede questo, fai quello. Per esempio creare un'attività di follow-up quando finisce un'occupazione. I passaggi di una automazione formano insieme un flusso, il disegno sulla tela. Vedi [Automazioni](/automatiseringen).

### Pagamento [#betaling]

Un importo che un cliente paga o che è ancora in arrivo, con un metodo, uno stato e di solito una fattura. Li trovi in <UIPath>Amministrazione > Pagamenti</UIPath>. Vedi [Ritrovare i pagamenti](/betalingsverwerking/betalingen-bekijken).

### Gruppo di pagamenti [#betalingsgroep]

Un insieme di pagamenti sotto un unico nome, che poi colleghi in una volta sola a una fattura contabilizzata. Per esempio tutti i pagamenti con POS di una giornata. Vedi [Gruppi di pagamenti](/betalingsverwerking/groepen).

### Report dei pagamenti [#betalingsrapport]

Il riepilogo di tutti i pagamenti di un singolo giorno di calendario, pensato per la tua contabilità. Il report di oggi è una bozza e diventa definitivo quando la giornata è finita. Vedi [Report dei pagamenti](/boekhouden/betalingsrapporten).

### Pagina di prova [#bewijspagina]

Le pagine in fondo a un PDF firmato, con il titolo del documento, chi ha firmato e quando, e due impronte digitali. Si chiamano **Prova di firma** e mostrano in seguito che il documento non è stato modificato. Vedi [Prova e validità](/handtekeningen/bewijs-en-geldigheid).

### Occupazione [#bezetting]

Un cliente che sta su una piazzola per un periodo lungo. Finché l'occupazione è in corso, Tillor addebita a quel cliente i consumi dei contatori di quella piazzola. Una piazzola ha al massimo un cliente alla volta. Vedi [Occupazioni](/bezettingen).

### Contabilizzare [#boeken]

Rendere definitiva una fattura in bozza. La fattura riceve un numero e poi non puoi più modificarla liberamente. In Tillor la parola non ha nulla a che vedere con il prenotare. Vedi [Contabilizzare una fattura](/facturen/boeken).

### Bozza [#concept]

Una fattura non ancora contabilizzata. Puoi ancora modificare le righe e non è ancora stato inviato nulla al cliente o alla contabilità. Vedi [Stati di una fattura](/facturen/statussen).

### Connector [#connector]

Una piccola scatola nella rete del tuo parco che collega Tillor ai dispositivi in loco, come stampanti e controller di accesso. Tillor la fornisce già configurata e la aggiorna da sé. Vedi [Connector](/connector).

### Controller [#controller]

Una scatola con touchscreen nel tuo parco, vicino a una doccia o a una porta. Legge un tag NFC o un codice QR, e Tillor decide se l'ospite può passare. Gestisci i controller in **Controller**. Vedi [Controller](/controllers).

### Nota di credito [#creditnota]

Una fattura con importi negativi che annulla una fattura precedente. L'app la chiama **fattura di credito**. La crei con **Storna fattura**. Vedi [Stornare una fattura](/facturen/corrigeren#een-factuur-omkeren).

### Campo personalizzato [#eigen-veld]

Un campo che la tua organizzazione aggiunge a un cliente, una piazzola, un'occupazione, un contatore o un'attività, oltre ai campi che Tillor offre già. Li gestisci in <UIPath>Impostazioni > Campi personalizzati</UIPath>. Vedi [Campi personalizzati](/eigen-velden).

### Fattura [#factuur]

Ciò che addebiti a un cliente, con righe per prodotto. Una nuova fattura è sempre una bozza. La crei nel profilo del cliente e gestisci tutte le fatture in <UIPath>Amministrazione > Fatture</UIPath>. Vedi [Fatture](/facturen).

### Evento [#gebeurtenis]

Una riga nella cronologia di un cliente, una fattura o un altro record che mostra cosa è successo, chi lo ha fatto e cosa è cambiato. Vedi [Registro attività](/activiteitenlog).

### Utente [#gebruiker]

Un account con accesso a Tillor. Nel testo corrente chiamiamo collega un altro utente. Utenti e permessi li gestisci in <UIPath>Impostazioni > Utenti</UIPath>. Vedi [Organizzazione](/gebruikers/organisaties).

### Gruppo [#groep]

Un insieme fisso di colleghi, per esempio **Reception**. Assegni attività a un gruppo, condividi viste con un gruppo e puoi dare o togliere permessi a un gruppo. Vedi [Gruppi](/gebruikers/groepen). Un gruppo di pagamenti è un'altra cosa.

### Conto contabile [#grootboek]

Il numero di conto nella tua contabilità su cui viene registrato un prodotto. Lo compili nel prodotto e viene inviato insieme alla trasmissione alla contabilità. Vedi [Il numero di conto contabile](/producten/product-aanmaken#grootboeknummer).

### Addebito diretto [#incasso]

Tillor preleva da sé l'importo di una fattura dal conto bancario del cliente. È possibile solo con un mandato attivo. Vedi [Incassare una fattura](/betalingsverwerking/incasso).

### Elenco di scelte [#keuzelijst]

Un elenco fisso di opzioni da cui attinge un campo personalizzato di tipo **Scelta** o **Scelta multipla**. Crei l'elenco una volta sola e lo usi in più campi. Vedi [Elenchi di scelte](/eigen-velden/keuzelijsten).

### Chiosco [#kiosk]

Un tablet Android che mostra l'app Tillor e vi resta, così gli ospiti non possono accedere alle impostazioni del dispositivo. Vedi [Configurare un chiosco](/mobiele-app/kiosk-inrichten).

### Cliente [#klant]

Il record in Tillor di una persona o di un'azienda: dati, fatture, occupazioni, metodi di accesso e altro. La parola ospite la usiamo solo nel testo corrente per chi soggiorna nel tuo parco. Vedi [Gestione clienti](/klantenbeheer).

### Mandato [#mandaat]

Il consenso di un cliente a incassare le fatture dal suo conto bancario (un mandato SEPA). Il cliente lo firma direttamente in Tillor. Vedi [Far firmare un mandato SEPA](/betalingsverwerking/mandaat).

### Contatore [#meter]

Un apparecchio per acqua, elettricità o gas. Un contatore appartiene a una piazzola, non a un cliente. I consumi vanno al cliente che in quel momento ha un'occupazione sulla piazzola. Vedi [Gestione contatori](/meterbeheer).

### Armadio contatori [#meterkast]

Un armadio in cui si trovano dei contatori. In <UIPath>Parco > Armadi contatori</UIPath> gestisci gli armadi e i contatori assegnati. Vedi [Parco](/park#meterkasten).

### Tag NFC [#nfc-tag]

Una tessera, un braccialetto o un portachiavi che un ospite avvicina a un controller, per esempio per la doccia o per un punto di accesso. Un tag può avere un saldo. Vedi [NFC](/nfc).

### Notifica [#notificatie]

Un messaggio che Tillor invia a un cliente o a un collega, via e-mail, SMS, posta, WhatsApp o push. In <UIPath>Comunicazione > Notifiche</UIPath> vedi se è arrivato. Vedi [Notifiche](/notificaties).

### Richiesta di firma [#ondertekenverzoek]

La richiesta di far firmare online un PDF, come un contratto di locazione, da una o più persone una dopo l'altra. Le gestisci in <UIPath>Amministrazione > Firme</UIPath>. Vedi [Firme](/handtekeningen).

### Consumi in sospeso [#openstaand-verbruik]

Consumi dei contatori che non sono ancora in una fattura. Li vedi per cliente in <UIPath>Clienti > Consumi in sospeso</UIPath> e li fatturi con **Fattura consumo**. Vedi [Gestione contatori](/meterbeheer/verbruik-factureren).

### Commento [#opmerking]

Una nota interna su un cliente, una fattura, una prenotazione o un altro record. I commenti non sono mai visibili al cliente. Vedi [Commenti](/notities).

### Organizzazione [#organisatie]

Il tuo account Tillor, cioè la tua azienda con i suoi utenti, le impostazioni e i dati. Il parco è il luogo fisico. Vedi [Organizzazione](/gebruikers/organisaties).

### Parco [#park]

Il luogo fisico: il tuo campeggio o parco vacanze. In **Parco** trovi la mappa, le piazzole, i contatori e gli armadi contatori. Vedi [Parco](/park).

### Peppol [#peppol]

Una rete europea con cui invii le fatture in formato elettronico direttamente al sistema contabile del destinatario, senza PDF. Per le fatture belghe ad aziende con partita IVA è obbligatoria. Vedi [Peppol](/boekhouden/peppol).

### Prodotto [#product]

Una tariffa o un servizio che metti su una riga di fattura, come una notte, il costo di sosta o un kWh di corrente. Un prodotto può avere azioni che Tillor esegue alla contabilizzazione o al pagamento. Vedi [Prodotti](/producten).

### Azione del prodotto [#productactie]

Qualcosa che Tillor fa in automatico quando una riga di fattura con questo prodotto viene contabilizzata o pagata, come prolungare un'occupazione o ricaricare un tag NFC. Vedi [Azioni del prodotto](/producten/productacties).

### Permesso [#recht]

Ciò che un utente può fare in Tillor, per esempio modificare prodotti o ripristinare fatture. Dai i permessi per utente o tramite un gruppo. Un rifiuto tramite un gruppo vince sempre. Vedi [Modificare i permessi](/gebruikers/organisaties#rechten-bewerken) e [Permessi di gruppo](/gebruikers/groepen#groepsrechten).

### Prenotazione [#reservering]

Una riserva per un singolo soggiorno su una piazzola, con arrivo e partenza. Una prenotazione non è la stessa cosa di un'occupazione. Vedi [Prenotazioni](/reserveringen).

### Attività [#taak]

Un lavoro per te o per un collega, con tra l'altro una scadenza, sotto-attività e clienti o piazzole collegati. Le attività le consulti nelle viste. Vedi [Attività](/taken).

### Tablet [#tablet]

Il dispositivo alla reception su cui gira l'app Tillor, per esempio per far firmare a un cliente un contratto o un mandato. Tablet, chioschi e telefoni su cui qualcuno ha effettuato l'accesso li trovi in **Impostazioni**. Vedi [Tablet e chioschi](/mobiele-app/tablets-en-kiosken).

### Piazzola [#terrein]

Un posto nel tuo parco che affitti o su cui pianifichi soggiorni, con un nome ed eventualmente dei contatori. A una piazzola colleghi i contatori, e i clienti ci arrivano tramite un'occupazione o una prenotazione. Vedi [Piazzole](/terreinen).

### Tipo di piazzola [#terreintype]

Una classificazione delle tue piazzole, come **Piazzola**, **Chalet** o **Area camper**. Usi il tipo per filtrare l'elenco, colorare la mappa e nelle automazioni. Vedi [Tipi di piazzola](/terreinen#terreintypes).

### Metodo di accesso [#toegangsmethode]

Il modo in cui un cliente passa da un punto di accesso: riconoscimento della targa, un tag NFC o un codice QR. Li gestisci presso il cliente nella scheda **Controllo accessi**. Vedi [Controllo accessi](/toegangscontrole).

### Punto di accesso [#toegangspunt]

Una sbarra, un cancello o una porta elettronica dove l'accesso è controllato. Puoi aprire e chiudere un punto di accesso da Tillor e vedere nel registro chi è passato. Vedi [Controllo accessi](/toegangscontrole).

### Trigger [#trigger]

L'inizio di un'automazione: l'evento, l'orario o il messaggio che la fa partire. Un trigger può avere un filtro, così l'automazione parte solo se qualcosa corrisponde. Vedi [Trigger](/automatiseringen/triggers).

### Lotto di consumo [#verbruiksbatch]

Un periodo di consumo di un contatore per un cliente e un contatore, con una lettura iniziale e una finale. L'app lo chiama **periodo di consumo**, in questa guida compare anche come lotto di consumo. Vedi [Lotti di consumo](/meterbeheer/consumptie-batches).

### Vista [#weergave]

Un modo salvato di guardare le tue attività, per esempio **Attività aperte** o **Manutenzione**. Ogni vista è una scheda in cima alla pagina Attività. Vedi [Viste](/taken/weergaven).

### Sigillo [#zegel]

La firma digitale della tua organizzazione con cui Tillor chiude un PDF firmato. Se dopo cambia qualcosa nel file, un lettore PDF lo segnala. Fa parte anche una marca temporale. Vedi [Sigillo e marca temporale](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Nella pratica" href="/praktijk" description="Quattro esempi svolti che combinano più moduli" />
  <Card title="Controller: glossario" href="/controllers/lexicon" description="Termini tecnici sui controller" />
</Cards>


# Dati e backup (/it-IT/gegevens-backups)

Tillor crea automaticamente backup dei dati della tua organizzazione. Non devi impostare nulla e non li vedi in Tillor. Se ti servono dati del passato o qualcosa è andato storto, il supporto Tillor ripristina per te uno stato precedente. Qui trovi come richiederlo e fino a quando puoi tornare indietro.

<Callout type="info" title="Da sapere">
- I backup risalgono fino al primo mese di calendario trascorso, con un archivio per mese. I dettagli sono nella tabella qui sotto.
- Il ripristino non lo fai da solo: passa sempre dal supporto Tillor.
- Non puoi scaricare né consultare un backup da solo.
</Callout>

Prima di iniziare: sappi di quali dati hai bisogno e da quale momento o mese.

## Per quanto tempo Tillor conserva i backup? [#hoe-lang-bewaart-tillor-back-ups]

Tillor conserva tre tipi di backup in parallelo. Insieme ti danno un punto di ripristino recente e una cronologia più lunga.

| Periodo | Cosa puoi ritrovare |
|---------|-------------------------|
| **Ultime 48 ore** | Un backup ogni 4 ore, per ripristinare a un momento recente |
| **Ultimi 14 giorni** | Un backup per notte |
| **Ogni mese di calendario trascorso** | Un archivio mensile per mese, senza eliminazione automatica |

Il mese di calendario in corso ha solo i backup notturni degli ultimi 14 giorni. Appena un mese è finito, resta conservato un backup di quel mese come archivio mensile.

I periodi valgono per tutte le organizzazioni. Se Tillor cambia la politica, aggiorniamo questa pagina.

## Far ripristinare un backup [#een-back-up-laten-terugzetten]

Il ripristino non lo fai da solo in Tillor. Lo fa il supporto Tillor insieme a te, così i tuoi dati attuali non vengono sovrascritti per errore.

<Steps>
<Step>
### Raccogli ciò che vuoi recuperare [#verzamel-wat-je-wilt-terughalen]
Stabilisci di quali dati hai bisogno, come fatture, clienti o prenotazioni. Annota il momento o il periodo a cui vuoi tornare, per esempio "ieri verso le 14:00" o "marzo 2026".
</Step>
<Step>
### Contatta il supporto Tillor [#neem-contact-op-met-tillor-support]
Scrivi a support@tillor.eu indicando il nome della tua organizzazione, quali dati vuoi recuperare e il momento o il periodo desiderato.
</Step>
<Step>
### Concorda cosa verrà ripristinato [#overleg-wat-er-precies-terugkomt]
Il supporto Tillor cerca il backup adatto alla tua richiesta e discute con te cosa succederà prima che il ripristino inizi.
</Step>
</Steps>

<Callout type="warn" title="Attenzione">
Il ripristino può riportare i dati a uno stato precedente. Tutto ciò che hai inserito dopo il momento scelto può quindi sparire. Parlane sempre prima con il supporto Tillor.
</Callout>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il supporto Tillor cerca il backup adatto e discute con te cosa verrà ripristinato prima che il ripristino parta.
- Durante il ripristino la tua organizzazione è in modalità manutenzione e solo i collaboratori di Tillor possono accedervi. Dopo, tutto è di nuovo disponibile.
- I dati che hai inserito dopo il momento scelto possono essere scomparsi. Concorda quindi sempre tutto prima.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Voglio scaricare o consultare un backup da solo">
Non è possibile in Tillor. I backup sono disponibili solo per il supporto Tillor. Chiedi al supporto di cercare i dati che ti servono.
</Accordion>
<Accordion title="Voglio dati di più di un mese fa">
Per i mesi precedenti Tillor conserva un backup per mese di calendario. Puoi quindi tornare a un mese, ma non a un giorno o a un'ora precisi di quel mese. Per gli ultimi 14 giorni si può andare per giorno, per le ultime 48 ore ogni 4 ore.
</Accordion>
<Accordion title="Tillor non è raggiungibile durante il ripristino">
Durante un ripristino la tua organizzazione è in modalità manutenzione e solo i collaboratori di Tillor possono accedervi. Concorda con il supporto Tillor un momento che ti vada bene.
</Accordion>
<Accordion title="Ho eliminato per errore una fattura o un cliente">
Scrivi al supporto Tillor indicando il nome dei dati e il momento dell'eliminazione. Controlla prima nel [registro attività](/activiteitenlog) chi ha modificato cosa e quando.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Per iniziare" href="/aan-de-slag" description="Configura il tuo parco passo dopo passo" />
  <Card title="Registro attività" href="/activiteitenlog" description="Vedi chi ha modificato cosa e quando" />
</Cards>


# Accedere a Tillor (/it-IT/inloggen)

Accedi a Tillor con un account che hai già presso Microsoft, Google o Apple. Tillor non ha una password propria: la password la gestisce quel provider. Dopo l'accesso scegli la tua organizzazione e arrivi sulla dashboard. È il tuo primo giorno? Prosegui con [Per iniziare](/aan-de-slag).

Prima di iniziare:

- Ti serve un account Microsoft, Google o Apple.
- Un amministratore deve prima averti invitato come utente con lo stesso indirizzo e-mail. Se non è successo, vedi **Nessuna organizzazione trovata**.

## Accedere [#inloggen]

<Steps>
<Step>
### Apri Tillor [#open-tillor]
Vai nel browser all'applicazione web di Tillor. Se hai già effettuato l'accesso, Tillor ti porta subito alla tua organizzazione.
</Step>
<Step>
### Scegli il metodo di accesso [#kies-je-inlogmethode]
Fai clic su **Accedi con Microsoft**, **Accedi con Google** o **Accedi con Apple**. Il metodo con cui hai effettuato l'ultimo accesso è contrassegnato con **Ultimo utilizzo**.
</Step>
<Step>
### Segui i passaggi del provider [#volg-de-stappen-van-de-provider]
Vai alla schermata di accesso di Microsoft, Google o Apple. Con Microsoft e Google scegli tu quale account usare. Poi torni a Tillor.
</Step>
<Step>
### Scegli la tua organizzazione [#kies-je-organisatie]
Se hai accesso a più di un'organizzazione, vedi una schermata di scelta. Cerca la tua organizzazione nell'elenco e fai clic su **Apri**. Se ne hai una sola, vai direttamente alla dashboard.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Arrivi sulla dashboard della tua organizzazione. Tillor ricorda il tuo ultimo metodo di accesso e la volta successiva lo contrassegna con **Ultimo utilizzo**.
- Vedi solo le sezioni per cui hai i permessi.
- La tua sessione resta attiva su questo dispositivo, fino a 30 giorni senza utilizzo o finché non esci tu stesso.

## Come si collega tutto? [#hoe-hangt-dit-samen]

Una persona ha un account Tillor. Quell'account puoi collegarlo a più metodi di accesso. Un amministratore ti aggiunge come utente a un'organizzazione e ti dà dei permessi. Ciò che vedi poi dipende da quei permessi.

```mermaid
flowchart LR
  A[Il tuo account Microsoft, Google o<br/>Apple] --> B[Il tuo account Tillor]
  B --> C[Una o più organizzazioni]
  C --> D[I tuoi permessi<br/>decidono cosa vedi]
```

<Callout type="info" title="Da sapere">
- Resti connesso finché usi Tillor. Dopo 30 giorni senza utilizzo accedi di nuovo.
- Un link di verifica per il tuo indirizzo e-mail è valido 15 minuti. Puoi richiedere una nuova e-mail al massimo ogni due minuti.
- Microsoft è sempre attivo come metodo di accesso. Google e Apple possono mancare, a seconda del tuo ambiente Tillor.
- Non puoi scollegare il tuo ultimo metodo di accesso.
</Callout>

## Dare accesso a un collega [#een-collega-toegang-geven]

Un amministratore con i permessi giusti invita i colleghi.

<Requires permission="Gestisci permessi utente" />

<Steps>
<Step>
### Apri gli utenti [#open-de-gebruikers]
Vai a <UIPath>Assistenza > Impostazioni</UIPath> e scegli **Utenti**.
</Step>
<Step>
### Invita il collega [#nodig-de-collega-uit]
Fai clic su **Invita utente**, inserisci l'indirizzo e-mail e fai clic su **Invita**.
</Step>
</Steps>

Se esiste già un account Tillor con quell'indirizzo e-mail, il collega viene aggiunto subito. Altrimenti il collega riceve un invito via e-mail e diventa membro al primo accesso. Poi imposti i permessi, vedi [Organizzazione](/gebruikers/organisaties). Il collega non vede nulla di utile finché i permessi non sono impostati.

## Gestire il tuo account [#je-eigen-account-beheren]

Fai clic sul tuo nome in fondo al menu e scegli **Account**. Qui trovi:

- **E-mail**: se il tuo indirizzo e-mail è **Verificato** o **Non verificato**. Se vedi **Non verificato**, compare il pulsante **Verifica indirizzo e-mail**, vedi [Verificare il tuo indirizzo e-mail](#je-e-mailadres-verifiëren).
- **Piattaforme collegate**: collega Microsoft, Google o Apple allo stesso account con **Collega**, oppure rimuovi un collegamento con **Scollega**. Non puoi scollegare il tuo ultimo metodo di accesso.
- **Sessioni attive**: vedi su quali dispositivi hai effettuato l'accesso. Con **Esci** termini una sessione, con **Esci da tutti gli altri dispositivi** tutte le altre.
- Il tuo numero di telefono e la lingua del tuo account.

Resti connesso finché usi Tillor. Dopo 30 giorni senza utilizzo accedi di nuovo. Per uscire scegli **Esci** nel menu sotto il tuo nome.

## Verificare il tuo indirizzo e-mail [#je-e-mailadres-verifiëren]

Tillor riprende il tuo indirizzo e-mail dal provider con cui hai effettuato il primo accesso. Google e Apple comunicano in questo caso che l'indirizzo è tuo. Microsoft di solito non lo fa, e allora il tuo indirizzo compare nella pagina **Account** come **Non verificato**.

Finché il tuo indirizzo non è verificato, all'accesso Tillor non collega un secondo metodo di accesso al tuo account. Se per esempio accedi per la prima volta con Google mentre il tuo account è stato creato con Microsoft, vedi il messaggio che l'indirizzo appartiene già a un account non ancora verificato. Verifica il tuo indirizzo una sola volta, poi funziona.

<Steps>
<Step>
### Richiedi l'e-mail di verifica [#vraag-de-verificatiemail-aan]
Se hai effettuato l'accesso, fai clic nella pagina **Account** su **Verifica indirizzo e-mail**. Se non hai effettuato l'accesso e hai ricevuto il messaggio nella pagina di accesso, inserisci lì il tuo indirizzo e-mail e fai clic su **Invia e-mail di verifica**. Quella pagina dà sempre la stessa conferma, anche se non esiste un account con quell'indirizzo.
</Step>
<Step>
### Apri l'e-mail [#open-de-e-mail]
Ricevi un'e-mail con l'oggetto **Verifica il tuo indirizzo e-mail per Tillor**. Fai clic su **Verifica indirizzo e-mail**. Il link è valido 15 minuti; se è scaduto, ne richiedi semplicemente uno nuovo.
</Step>
<Step>
### Accedi [#log-in]
Dopo il clic torni alla pagina di accesso o alla tua pagina account. Accedi con il metodo che preferisci. Da ora Tillor collega al tuo account un nuovo metodo di accesso con lo stesso indirizzo e-mail.
</Step>
</Steps>

Puoi richiedere una nuova e-mail di verifica al massimo ogni due minuti. Se non vuoi aspettare l'e-mail, come utente connesso puoi collegare subito anche un secondo metodo in **Account > Piattaforme collegate**.

## Chiavi API per i collegamenti [#api-sleutels-voor-koppelingen]

Per i collegamenti tecnici gestisci le chiavi API nella pagina **Account**. Apri **Sviluppatori** nel menu del tuo profilo e fai clic su **Vai alle chiavi API**, oppure vai a **Account** > **Chiavi API**. Vedi [Sviluppatori](/ontwikkelaars) per la documentazione di integrazione.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Account - sezione chiavi API" />

## Problemi? [#problemen]

<Accordions>
<Accordion title="Vedi Nessuna organizzazione trovata">
Il tuo account esiste, ma non è ancora collegato a un'organizzazione. Chiedi a un amministratore della tua organizzazione di invitarti con lo stesso indirizzo e-mail del tuo account Microsoft, Google o Apple.
</Accordion>
<Accordion title="Vedi che l'indirizzo e-mail appartiene già a un account non ancora verificato">
Esiste già un account Tillor con questo indirizzo, creato con un altro metodo di accesso, e quell'indirizzo non è ancora verificato. Sotto il messaggio inserisci il tuo indirizzo e-mail e fai clic su **Invia e-mail di verifica**, oppure accedi con il metodo usato prima e fai clic nella pagina **Account** su **Verifica indirizzo e-mail**. Vedi [Verificare il tuo indirizzo e-mail](#je-e-mailadres-verifiëren).
</Accordion>
<Accordion title="Il link di verifica è scaduto o non è valido">
Un link di verifica funziona per 15 minuti. Richiedine uno nuovo nella pagina di accesso o nella pagina **Account** e usa l'e-mail più recente.
</Accordion>
<Accordion title="Non è stato possibile collegare l'account">
Questo account è già collegato a un altro utente, oppure l'indirizzo e-mail non corrisponde al tuo account attuale. Usa lo stesso indirizzo e-mail, oppure accedi con l'account già collegato e scollegalo prima da lì.
</Accordion>
<Accordion title="La sessione di accesso è scaduta">
L'accesso è durato troppo o la pagina è rimasta aperta troppo a lungo. Fai di nuovo clic sul tuo metodo di accesso e completa i passaggi più in fretta.
</Accordion>
<Accordion title="Non vedo tutto ciò che vede il mio collega">
Ciò che vedi dipende dai tuoi permessi. Chiedi a un amministratore di modificare i tuoi permessi, vedi [Organizzazione](/gebruikers/organisaties).
</Accordion>
<Accordion title="Ricevi un altro messaggio di errore">
Riprova. Se non funziona di nuovo, scrivi a support@tillor.eu e comunica il messaggio.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Per iniziare" href="/aan-de-slag" description="Configura il tuo parco passo dopo passo" />
  <Card title="Utenti" href="/gebruikers" description="Permessi utente e impostazioni dell'organizzazione" />
</Cards>


# Vraag het Tillie (/it-IT/vraag-het-tillie)

Tillie is de assistent van deze handleiding. Je stelt een vraag zoals je ze aan een collega zou stellen, bijvoorbeeld "Hoe maak ik een creditnota?". Tillie zoekt de pagina's op die erover gaan, leest ze en antwoordt in een paar zinnen of stappen, met een link naar elke pagina die ze gebruikte. Zoek je een pagina waarvan je de naam al kent, dan is de [zoekfunctie](#zoeken-of-tillie) bovenaan sneller.

<Callout type="info" title="Goed om te weten">
- Tillie antwoordt uit deze handleiding. Over je eigen klanten, facturen of meters weet ze alleen iets als je haar [toegang tot je account](#tillie-in-je-account-laten-kijken) geeft.
- Ze antwoordt met AI en kan zich vergissen. Controleer een belangrijke stap op de pagina waar ze naar linkt.
- Ze antwoordt in de taal waarin je de handleiding leest.
- Zet geen persoonlijke gegevens van klanten in je vraag. Die heeft Tillie niet nodig.
</Callout>

## Een vraag stellen [#een-vraag-stellen]

<Steps>
<Step>
### Open Tillie [#open-tillie]
Klik rechtsonder op **Vraag het Tillie**, of druk op **⌘I** (Mac) of **Ctrl+I** (Windows). Tillie opent aan de rechterkant; op een telefoon vult ze het scherm. Met **Groter** maak je het venster breder.
</Step>
<Step>
### Stel je vraag [#stel-je-vraag]
Typ je vraag onderaan en druk op **Enter**. Met **Shift+Enter** begin je een nieuwe regel. Weet je niet goed hoe te beginnen, kies dan een van de voorbeeldvragen. Een vraag is maximaal 1.000 tekens lang.

Ben je niet aangemeld bij Tillor, dan controleert Tillie bij je eerste vraag dat je geen robot bent. Meestal merk je daar niets van; soms vraagt een vakje om een klik.
</Step>
<Step>
### Volg wat Tillie opzoekt [#volg-wat-tillie-opzoekt]
Boven het antwoord zie je wat Tillie doet: **Zocht naar** met de zoekwoorden en **Las** met de titel van elke pagina die ze opende. Daarna verschijnt het antwoord, woord voor woord. Met de stopknop rechts in het invoerveld breek je een antwoord af.
</Step>
<Step>
### Open de bronnen [#open-de-bronnen]
Klik op **bronnen gebruikt** om de pagina's te zien waar het antwoord op steunt, en klik een titel om de pagina te openen. Links in het antwoord zelf werken ook. Tillie blijft open terwijl je leest, behalve op een telefoon.
</Step>
</Steps>

## Tillie in je account laten kijken [#tillie-in-je-account-laten-kijken]

Ben je aangemeld bij Tillor, dan kan Tillie ook vragen over je eigen gegevens beantwoorden, zoals "Welke facturen van de familie Peeters staan nog open?" of "Wat was de laatste meterstand van plaats 12?". Daarvoor geef je haar eerst toegang.

<Steps>
<Step>
### Geef Tillie toegang [#geef-tillie-toegang]
Open Tillie. Bovenaan staat **Mag Tillie in je account kijken?**. Ben je lid van meer dan één organisatie, kies dan de organisatie. Klik **Toegang geven**.
</Step>
<Step>
### Stel je vraag [#stel-je-vraag-1]
Bovenaan staat nu **Tillie leest mee in** met de naam van je organisatie. Stel je vraag zoals altijd. Wat Tillie in je account opzoekt, zie je boven het antwoord: **Zocht in je account naar** en **Las** met wat ze bekeek.
</Step>
</Steps>

<Callout type="info" title="Wat Tillie mag">
- Tillie kan alleen **lezen**, en alleen wat jij zelf mag zien in die organisatie. Ze kan niets wijzigen, verwijderen of versturen.
- De toegang geldt 30 dagen. Met **Intrekken** stop je ze meteen.
- Geven en intrekken van de toegang staan in de [activiteitenlog](/activiteitenlog#beveiligingsgebeurtenissen) van je organisatie.
- Wat Tillie leest, gaat naar het taalmodel dat haar antwoord schrijft, net als bij de AI-assistent in de inbox. Het wordt niet bewaard om modellen te trainen.
</Callout>

## Een wijziging bevestigen [#een-wijziging-bevestigen]

Vraag je Tillie iets te veranderen, bijvoorbeeld "Zet factuur 2026-0142 terug naar concept", dan doet ze dat niet zelf. Ze stelt het voor in een kaart **Voorgestelde wijziging** met wat er zal gebeuren en welke velden veranderen, met hun nieuwe waarde.

- Klik **Bevestigen** om de wijziging uit te voeren. Tillor voert ze uit met jouw rechten, alsof je ze zelf deed, en toont daarna **Uitgevoerd.** of waarom het niet lukte.
- Klik **Annuleren** als je de wijziging niet wil. Er gebeurt dan niets.
- Een voorstel verloopt na 10 minuten. Vraag het dan opnieuw.

Elke bevestigde wijziging staat in de [activiteitenlog](/activiteitenlog#beveiligingsgebeurtenissen) van je organisatie, en de wijziging zelf staat in de **Gebeurtenissen** van het record, op jouw naam.

## Wat gebeurt er daarna? [#wat-gebeurt-er-daarna]

- Je gesprek blijft bewaard zolang het tabblad open is, ook als je naar een andere pagina gaat. Een vervolgvraag mag dus naar het vorige antwoord verwijzen ("En als de factuur al betaald is?"). Tillie onthoudt de laatste drie vragen met hun antwoord.
- Met **Nieuw gesprek** (het ronde pijltje bovenaan) begin je opnieuw. Sluit je het tabblad, dan is het gesprek weg.
- Onder elk antwoord laat je met een duim weten of het hielp. Zo zien we welke vragen de handleiding nog slecht beantwoordt.

## Hoeveel vragen kan je stellen? [#hoeveel-vragen-kan-je-stellen]

Tillie beantwoordt één vraag tegelijk. Daarnaast gelden grenzen, zodat de assistent beschikbaar blijft voor iedereen:

| Wie | Per minuut | Per dag |
|-----|------------|---------|
| Niet aangemeld | 5 vragen | 30 vragen |
| Aangemeld bij Tillor | 10 vragen | 100 vragen |

Op een netwerk dat je deelt met anderen, zoals de wifi van een kantoor of camping, geldt ook een grens voor iedereen samen. Heeft Tillie op een dag veel bezoekers geholpen, dan vraagt ze wie niet aangemeld is om zich aan te melden.

## Zoeken of Tillie? [#zoeken-of-tillie]

| Je wil | Gebruik |
|--------|---------|
| Een pagina openen waarvan je de naam kent, zoals "Mandaat" | De zoekfunctie bovenaan (**⌘K** of **Ctrl+K**) |
| Weten hoe je iets doet, in je eigen woorden | Tillie |
| Een antwoord dat meerdere pagina's combineert | Tillie |

## Problemen? [#problemen]

<Accordions>
<Accordion title="Ik zie Vraag het Tillie niet">
Tillie is nog niet voor iedereen beschikbaar. Staat de knop niet rechtsonder, gebruik dan de zoekfunctie bovenaan.
</Accordion>
<Accordion title="Je ziet Je stelde veel vragen kort na elkaar">
Je zit aan de grens per minuut of per dag. De melding zegt hoe lang je moet wachten. Ben je niet aangemeld, meld je dan aan bij Tillor: dan krijg je meer vragen per dag.
</Accordion>
<Accordion title="Je ziet Tillie beantwoordde vandaag al veel vragen van bezoekers">
De vragen voor bezoekers die niet aangemeld zijn, zijn voor vandaag op. Klik **Aanmelden bij Tillor** en stel je vraag opnieuw, of gebruik de zoekfunctie.
</Accordion>
<Accordion title="Je ziet Tillie is nu niet beschikbaar">
Tillie neemt even geen vragen aan. Gebruik de zoekfunctie bovenaan en probeer het later opnieuw.
</Accordion>
<Accordion title="Je ziet De controle of je geen robot bent lukte niet">
Herlaad de pagina en stel je vraag opnieuw. Blokkeert een extensie in je browser scripts of cookies, zet ze dan uit voor deze site.
</Accordion>
<Accordion title="Ik zie Mag Tillie in je account kijken? niet">
Dat staat er alleen als je aangemeld bent bij Tillor in dezelfde browser. Meld je aan en open Tillie opnieuw. Heb je al toegang gegeven, dan staat er **Tillie leest mee in**.
</Accordion>
<Accordion title="Je ziet Niet uitgevoerd bij een wijziging">
Tillor weigerde de wijziging, meestal omdat je er de rechten niet voor hebt of omdat het record intussen veranderde. De melding zegt waarom. Doe de wijziging dan in Tillor zelf.
</Accordion>
<Accordion title="Je ziet Verlopen bij een wijziging">
Je bevestigde niet binnen 10 minuten. Vraag Tillie de wijziging opnieuw voor te stellen.
</Accordion>
<Accordion title="Het antwoord klopt niet">
Open de bronnen onder het antwoord en controleer de stap op die pagina. Geef het antwoord een duim omlaag, zodat we het kunnen verbeteren.
</Accordion>
</Accordions>

## Zie ook [#zie-ook]

<Cards>
  <Card title="Zoeken in Tillor" href="/zoeken" description="Een klant, factuur of terrein vinden in de app" />
  <Card title="Begrippen" href="/begrippen" description="Alle termen in Tillor op een rij" />
  <Card title="Aan de slag" href="/aan-de-slag" description="Je eerste stappen in Tillor" />
</Cards>


# Novità (/it-IT/wat-is-nieuw)

Tillor riceve un aggiornamento quasi ogni giorno. In questa pagina trovi le modifiche che noti come amministratore. I piccoli miglioramenti e le correzioni di errori li omettiamo.

## Novembre 2026 [#november-2026]

### Attività [#taken]

- Filtra le attività per **Testo**: mostra solo le attività il cui nome o la cui descrizione contiene, oppure non contiene, un testo, e aggiungi tutti i testi che vuoi (ad esempio **Non contiene** `Verzekering vervallen:`). Vedi [Filtrare per testo](/taken/filteren#filteren-op-tekst).
- Filtri e impostazioni della vista integrata **Tutte** ora si possono salvare per l'intera organizzazione, con il permesso **Gestire etichette e viste condivise**. Vedi [Salvare o scartare le modifiche](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

### Ricerca [#zoeken]

- La finestra di ricerca mostra i risultati per categoria, con la categoria del risultato migliore in cima e i tre risultati migliori per categoria. Con il pulsante **Tutto** all'inizio del campo di ricerca, oppure con i tasti da **⌥1** a **⌥9** (**Alt** su Windows), cerchi in una sola categoria, anche prima di digitare. In fondo trovi le scorciatoie da tastiera e le categorie senza risultati. Vedi [Ricerca](/zoeken).

### Guida [#handleiding]

- Ora Tillie può anche guardare nel tuo account: dalle accesso in lettura alla tua organizzazione e chiedi dei tuoi clienti, fatture o contatori. Propone una modifica, che avviene solo quando la confermi. Vedi [Lasciare che Tillie guardi nel tuo account](/vraag-het-tillie#tillie-in-je-account-laten-kijken).
- Ora scegli chiaro o scuro una sola volta: il manuale segue il tema scelto in Tillor, e viceversa.
- Novità: [Chiedi a Tillie](/vraag-het-tillie). Fai una domanda con parole tue in basso a destra e Tillie risponde dal manuale, con le pagine che ha usato.
- La guida esiste ora anche in altre lingue: scegli la tua lingua in alto a destra. Si apre da sola nella lingua che usi in Tillor. Una pagina non ancora tradotta mostra il testo olandese.

### Chat del sito web [#website-chat]

- Un visitatore può ora inviare 10 messaggi al minuto e 200 al giorno tramite la chat, e tutti i visitatori di una stessa rete insieme 30 al minuto. Oltre, al visitatore viene chiesto di attendere un momento. Così uno script non può sommergere la tua inbox e le risposte di Tillie. Vedi [Problemi?](/inbox/website-chat#problemen).

### Contatori (ICY) [#meters-icy]

- Tillor legge ora ICY tramite la nuova API v2. In <UIPath>Impostazioni > Integrazioni > ICY</UIPath> inserisci il login per l'API v2 e scegli il numero del tuo parco nell'elenco; senza questi dati i contatori ICY non vengono più aggiornati.
- Un contatore ICY mostra quale **Modulo** è montato sul posto (Campère o PRM) e, se ICY lo conosce, il **Numero di serie del modulo**. Se quel numero di serie cambia presso ICY, lo trovi nell'**Attività** del contatore.
- La scheda **Controller ICY** in <UIPath>Parco > Contatori</UIPath> mostra per ogni controller quando ICY lo ha visto l'ultima volta, e quanti contatori ci sono collegati. Ora vi compaiono anche gli allarmi che ICY segnala su un controller, e ricevi la stessa notifica push di un allarme del contatore. Un controller con un allarme o fermo da più di un'ora compare in cima. Un controller porta il nome del tuo armadio contatori (per esempio **MK6**) invece del numero di ICY. Vedi [Controller ICY](/meterbeheer/alarmen-en-status#icy-controllers).
- Un contatore ICY mostra ora anche il suo **Controller** e il **Tempo di spegnimento**. Un diverso tempo di spegnimento del modulo compare nell'**Attività** del contatore.
- L'elenco in <UIPath>Parco > Contatori</UIPath> ha una colonna **Modulo** (Campère o PRM), e il file Excel di **Esporta tutti i contatori** ha la colonna `module` nel foglio ICY.
- In **Amperaggio** compaiono solo più i valori fino al massimo impostato presso ICY per il modulo in quel posto. Prima Tillor offriva su ogni contatore l'intero elenco del parco.
- Gli allarmi di ICY ricevono un nome fisso nella tua lingua, come **Sovracorrente** o **Interruzione di corrente**, e gli **Avvisi** mostrano ora quante volte è già stato usato il limite di commutazione.

### Sviluppatori [#ontwikkelaars]

- **Non retrocompatibile:** gli allarmi si chiamano d'ora in poi `integration-alarm` nell'API e negli eventi, perché ora possono trovarsi anche su un controller ICY. Gli eventi `meter-alarm:created` e `meter-alarm:resolved` sono sostituiti da [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) e [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved), e i percorsi REST `/meter-alarms` da `/integration-alarms`. I vecchi nomi non esistono più. I webhook e le automazioni esistenti sono stati convertiti automaticamente ai nuovi eventi; nel tuo codice adatta il nome dell'evento e il percorso. Il campo `meterId` di un allarme può essere vuoto; in quel caso `icyControllerId` è compilato.
- Un client OAuth può ora essere limitato alle persone della sua organizzazione, e inoltre a gruppi e permessi: selezioni **Solo le persone di (la sua organizzazione) possono accedere** nella finestra del client in <UIPath>Account > Client OAuth</UIPath>. Pensato per il single sign-on verso un servizio esterno. Veda [Client OAuth](/ontwikkelaars/oauth-clients).
- Ogni endpoint del [riferimento API](/api-referentie) mostra ora sotto **Accesso** chi può chiamarlo e quale permesso serve a un membro. Una chiave API con scope deve avere quel permesso anche tra i suoi scope. L’[indice degli eventi](/ontwikkelaars/events) mostra lo stesso per ogni evento.

### Chiavi API [#api-sleutels]

- Una chiave API può ora essere limitata ai permessi di cui un collegamento ha bisogno: attiva **Limita alle autorizzazioni selezionate** nella finestra della chiave in <UIPath>Account > Chiavi API</UIPath>. Una chiave limitata non può mai fare più di te. Vedi [Limitare i permessi](/ontwikkelaars/http#rechten-beperken).

### Campi personalizzati [#eigen-velden]

- Un campo di collegamento ai contatori può limitarsi ai contatori della piazzola dell'occupazione, e ogni campo di collegamento a un record elencabile può filtrare le sue opzioni con TypeScript personalizzato. Tillor rifiuta al salvataggio un record fuori da quella limitazione. Gli elenchi brevi (meno di 50 record) vengono mostrati subito nell'elenco di scelta, senza dover prima digitare 2 caratteri. Vedi [Filtrare le opzioni](/eigen-velden/veldtypes#opties-filteren).
- Lo stesso filtro può anche dare a un'opzione un'etichetta propria e un'intestazione nell'elenco di scelta, restituendo un testo o `{ label, group }` invece di `true`. Vedi [Etichette personalizzate](/eigen-velden/veldtypes#eigen-labels).

### Guida [#handleiding-1]

- Novità nella guida: [Termini](/begrippen), un glossario di tutti i termini di Tillor, e [Nella pratica](/praktijk), quattro esempi svolti che seguono un intero modo di lavorare attraverso i moduli, come accogliere un cliente stagionale o addebitare i consumi.
- Ogni modulo inizia ora con cosa è, cosa serve e cosa succede dopo, con un riquadro **Da sapere** e un elenco **Problemi?** per ogni compito. Nuovi sono anche [Invitare utenti e dare permessi](/gebruikers/gebruikers-en-rechten), una panoramica di tutti i [tipi di notifica](/communicatie/notificatietypes) e pagine separate per compito per [contatori](/meterbeheer), [controller](/controllers) e [stampanti](/printer).

### Firme [#handtekeningen]

- Clienti, persone di contatto e parti esterne possono ora firmare un documento anche sul tablet alla reception. Al loro turno fai clic su **Firma sul tablet**, con codice o senza codice se hai verificato tu l'identità; il tablet mostra il loro nome a caratteri grandi, anche per un mandato SEPA. Vedi [Sul tablet alla reception](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).
- Con **Invia** l'editor controlla tutto in una volta: un firmatario senza campo firma, o un cliente o una persona di contatto senza indirizzo e-mail e numero di cellulare, viene segnalato subito. Vedi [Non riesco a inviare](/handtekeningen/handtekening-vragen#problemen).

### Transazioni bancarie [#banktransacties]

- Fai clic sull'icona (i) di una transazione bancaria per aprirne il pannello dei dettagli. Dal menu delle azioni crei un'attività al riguardo o copi un link che apre subito il pannello. Vedi [Consultare le transazioni bancarie](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken).

### Prodotti e fatture [#producten-en-facturen]

- L'IVA a inversione contabile è ora una scelta in **IVA %**, accanto alle aliquote: per servizi UE e subappaltatore, e anche cessione intracomunitaria, esportazione ed esente. La fattura riceve la dicitura di legge, la contabilizzazione richiede una partita IVA dove serve, e la riga finisce in Admisol nella griglia giusta. Per Odoo inserisci per ogni regime il nome dell'IVA di Odoo nelle [impostazioni di esportazione](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes); un prezzo pianificato può anche convertire un prodotto a un regime. Vedi [IVA a inversione contabile e altri regimi senza IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw).
- Inserisci importi di prima di Tillor, come vecchie cauzioni, come saldo iniziale sul conto di un cliente: a mano o con un'importazione per tutti i clienti insieme. Contano nel saldo e nel controllo, ma non sono una fattura e non vanno alla contabilità. Vedi [Saldi iniziali di prima di Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor).
- Un bundle di prodotti è ora codice: ogni passaggio ha un prodotto, una quantità e una **Formula** facoltativa in TypeScript che al salvataggio della fattura decide se il passaggio compare, con quale quantità, o esattamente quali righe (descrizione propria, prezzo, metodo di accesso). La formula legge il cliente, l'occupazione, la piazzola e la riga principale, campi personalizzati inclusi, oltre agli elenchi di contatori e metodi di accesso. Le scelte fisse per contatore, tag NFC e cane non ci sono più; ciò che facevano compare come formula di esempio nella guida. Vedi [Formula per passaggio](/producten/bundel-velden#formule-per-stap).
- Controlla il saldo di un cliente su un conto contabile, per esempio per le cauzioni. Tillor mostra il saldo sulla fattura e rifiuta una fattura che lo porta sotto zero. Con un permesso a parte contabilizzi comunque, con una motivazione nella cronologia. Vedi [Controllare il saldo del cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
- Nella scheda **Fatturazione** di un cliente c'è la nuova tabella **Conti**: il saldo per conto contabile su cui è stato registrato qualcosa, con sotto le fatture contabilizzate e il conto corrente. Se hai conti controllati, vedi di default solo quelli; con un filtro li vedi tutti. Vedi [Controllare il saldo del cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

### Fatture e pagamenti [#facturen-en-betalingen]

- Con **Link per pagamento parziale** nel menu di una fattura contabilizzata crei un link di pagamento per una parte dell'importo aperto. Vedi [Creare un link per un pagamento parziale](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).
- Un mandato SEPA firmato è sigillato, così un lettore PDF mostra qualsiasi modifica successiva. Vedi [Mandato SEPA](/betalingsverwerking/mandaat).

### Utenti e permessi [#gebruikers-en-rechten]

- Un gruppo può consentire o negare permessi a tutti i suoi membri; un rifiuto vince sempre. In **Modifica permessi** vedi per ogni permesso se arriva direttamente o tramite un gruppo. Vedi [Permessi di gruppo](/gebruikers/groepen#groepsrechten).

### Parco e tecnica [#park-en-techniek]

- Un controller può conoscere più reti Wi-Fi, in un ordine che decidi tu. Vedi [Impostazioni del controller](/controllers/settings).
- Per un contatore **Consumo e trend** mostra il consumo per ora di un giorno, con un nuovo selettore di periodo. Vedi [Gestione contatori](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).

### Attività [#taken-1]

- Stampa un'attività su A4 o su una stampante di scontrini dal menu dell'attività; la stampa mostra anche gli elementi collegati e i blocchi. Nello stesso menu c'è **Elimina**, tranne per le attività che può chiudere solo un'automazione. Vedi [Dettagli dell'attività](/taken/taakdetails#het-menu-van-de-taak).
- Aggiungi sotto-attività mentre crei un'attività. Vedi [Creare un'attività](/taken/taakdetails#een-taak-aanmaken).
- Una vista può nascondere le attività completate dopo un giorno, una settimana o un mese. Vedi [Nascondere le attività completate](/taken/indelingen#voltooide-taken-verbergen).

## Ottobre 2026 [#oktober-2026]

### Piazzole [#terreinen]

- La **Tariffa calcolata** di una piazzola segue ora una formula che scrivi tu per organizzazione in <UIPath>Impostazioni > Tariffa piazzola</UIPath>, con le stesse variabili `{terrain.…}` delle automazioni. Provi subito la formula su una piazzola, e ogni parte nominata ottiene una colonna nell'esportazione delle piazzole. Il risultato viene conservato presso la piazzola e segue ogni modifica della piazzola o della formula. Vedi [Formula tariffaria](/terreinen#tariefformule).

### Firme [#handtekeningen-1]

- Fai firmare online un PDF come un contratto di locazione a clienti, persone di contatto, colleghi e parti esterne una dopo l'altra. Il PDF firmato con la pagina di prova finisce tra i documenti del cliente. Vedi [Firme](/handtekeningen).
- Un firmatario può anche digitare la sua firma o sigla invece di disegnarla. Vedi [Come firma una persona](/handtekeningen/ondertekenen).
- Nell'editor scegli in **Campi per** per chi posizioni i campi, e imposti un campo posizionato con **Firmatario** a nome di qualcun altro. I campi li posizioni toccando o trascinando. Vedi [Posizionare i campi](/handtekeningen/handtekening-vragen).

### Accesso [#inloggen]

- Se il tuo indirizzo e-mail è ancora **Non verificato**, lo verifichi con un clic dalla pagina **Account** o dalla pagina di accesso. Solo dopo Tillor collega un secondo metodo di accesso al tuo account. Vedi [Verificare il tuo indirizzo e-mail](/inloggen#je-e-mailadres-verifiëren).

### Automazioni [#automatiseringen]

- Con il passaggio **Esegui codice** scrivi un po' di TypeScript sulle variabili del flusso, per esempio per decidere quali sotto-attività riceve un'attività. Il risultato lo leggi nei passaggi successivi come `{result}`. Vedi [Esegui codice](/automatiseringen/logica#code-uitvoeren).
- Un flusso può prima **Sincronizza transazioni bancarie** e poi inviare un promemoria di pagamento, così una fattura appena pagata non riceve un promemoria. Salva quell'automazione dalla rete dell'ufficio, così Tillor ricorda l'IP per il collegamento bancario. Vedi [Sincronizza transazioni bancarie](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren).
- Disattiva i solleciti automatici per un cliente o per una singola fattura. Un flusso di promemoria salta i clienti che lo hanno già attivo. Vedi [Disattivare i promemoria automatici per il cliente](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant).
- In **Crea attività** puoi impostare che solo il flusso chiuda l'attività. Con **Elimina attività** rimuovi poi quell'attività. Vedi [Attività](/automatiseringen/acties/taken).
- In un'azione di attività puoi attivare **Chiedi conferma**. Il collega conferma prima la scelta, e poi il flusso prosegue.
- Costruisci automazioni da solo su una tela: scegli un trigger, aggiungi passaggi, condizioni e attese e guarda per ogni esecuzione cosa è successo. Vedi [Automazioni](/automatiseringen).
- Un'automazione può avere più trigger. Tillor blocca i cicli in cui un'automazione continua ad avviare se stessa.
- L'attesa può ora durare fino a un orario fisso, un certo numero di ore o minuti, o fino alla chiusura della tua organizzazione.
- Avvia un'automazione a una data presa da un record, con un trigger pianificato o dal tuo sistema tramite un [webhook in ingresso](/ontwikkelaars/automatiseringen).
- Con il passaggio **Chiedi una decisione** crei tu i pulsanti sull'attività, con colore e icona propri, eventualmente con una nota o una conferma obbligatoria. Ogni pulsante è un'uscita del passaggio. Vedi [Chiedi una decisione](/automatiseringen/logica#vraag-om-een-beslissing).
- Il trigger **Viene scelta un’azione dell’attività** avvia un'automazione quando qualcuno sceglie un pulsante collegato su un'attività. In un webhook in ingresso con **Ignora le ripetizioni** eviti che la stessa chiamata avvii il flusso due volte. Vedi [Trigger](/automatiseringen/triggers).
- **Attendi un evento** ha un'uscita **Eliminato** per quando il record del flusso scompare. Vedi [Logica](/automatiseringen/logica#wachten-op-een-gebeurtenis).
- Nell'editor provi con un record reale, metti **Cornici** attorno ai passaggi e ripristini una versione precedente tramite **Cronologia**. Vedi [Per iniziare](/automatiseringen/aan-de-slag#de-editor).

### Attività [#taken-2]

- Nell'elenco delle attività vedi tutti i record collegati, e filtri per tipo con **Collegato a**. Vedi [Filtrare](/taken/filteren).
- Le e-mail delle attività mostrano un'anteprima dell'attività. Le attività le trovi anche con [Cerca](/zoeken).
- Prima che un'attività privata diventi visibile a tutta l'organizzazione, Tillor chiede se vuoi renderla pubblica. Vedi [Attività private](/taken/prive-taken).
- Attività private, una vista calendario e un timer che continua a girare mentre lavori. Vedi [Attività](/taken).
- Condividi una vista come pagina di sola lettura o come link di calendario. Vedi [Condividere attività](/taken/delen).
- Gli stati di attesa sono stati riuniti in un unico stato **In attesa di risposta**.
- Assegna un'attività a un gruppo, e condividi una vista con gruppi di colleghi. Vedi [Chi vede una vista](/taken/weergaven#wie-ziet-een-weergave).
- Un'attività può avere pulsanti di scelta, eventualmente con una nota o una conferma obbligatoria. Vedi [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen).
- Incolla un file nella finestra dell'attività per aggiungerlo come allegato. I campi personalizzati delle attività compaiono anche in quella finestra.

### Inbox [#inbox]

- L'e-mail di promemoria della chat del sito apre ora la conversazione anche su un altro dispositivo o in un altro browser. Vedi [Promemoria via e-mail](/inbox/website-chat-instellingen#herinnering-per-e-mail).

### Notifiche [#meldingen]

- Scegli per ogni notifica se Tillor ti raggiunge via e-mail o push. Lo imposti in **Account** sotto **Notifiche**, oppure per un collega tramite **Impostazioni notifiche** tra i membri dell'organizzazione. Vedi [Utenti](/gebruikers).

### Tablet e chioschi [#tablets-en-kiosken]

- Ogni tablet o chiosco ha una propria pagina del dispositivo con azioni da remoto, diagnostica, cronologia e impostazioni. Vedi [Tablet e chioschi](/mobiele-app/tablets-en-kiosken).
- Blocco chiosco, modalità notte e notifiche per dispositivo per i tablet Android.

### Fatture e pagamenti [#facturen-en-betalingen-1]

- In una riga di fattura con un periodo scegli la piazzola sulla mappa. Alla contabilizzazione Tillor crea la prenotazione e fa il check-in dell'ospite, a seconda del prodotto. Vedi [Fatture](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen).
- Report dei pagamenti in bozza per la giornata in corso. Vedi [Report dei pagamenti](/boekhouden/betalingsrapporten).
- Se Mollie trattiene una riserva di saldo su un pagamento, Tillor la registra come *Riserva di saldo* sul fornitore Mollie invece che sul conto d'attesa, e al rilascio sparisce di nuovo da lì. Vedi [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve).
- I clienti ricevono un promemoria per firmare il loro mandato SEPA prima che scada.

### Clienti e file [#klanten-en-bestanden]

- Allegati, documenti ed e-mail di Outlook li guardi in un unico visualizzatore di file, senza scaricare. I video puoi riprodurli; i caricamenti possono arrivare a 250 MB.
- La panoramica dei clienti mostra i soggiorni attivi e in ritardo. La fatturazione automatica si mette in pausa in caso di consumo d'acqua insolitamente alto.
- Su una piazzola vedi la cronologia delle occupazioni, con un link al cliente.

### Campi personalizzati [#eigen-velden-1]

- Aggiungi tu stesso campi a clienti, piazzole, occupazioni, contatori, attività, prodotti, documenti, prenotazioni e metodi di accesso, in <UIPath>Impostazioni > Campi personalizzati</UIPath>. Li posizioni tra i campi standard, li fai comparire a una condizione e decidi chi li vede o li modifica. Vedi [Campi personalizzati](/eigen-velden).

### Prodotti [#producten]

- Pianifica un nuovo prezzo a partire da una data con **Prezzi pianificati**; Tillor lo applica quel giorno e ti invia un'e-mail. Il **Calcolatore IVA** converte un prezzo o lo adatta con una percentuale. Vedi [Pianificare una modifica di prezzo](/producten/prijzen-plannen).

### Clienti [#klanten]

- In cima a un cliente c'è la scheda con i dati più importanti, con i commenti fissati. I compleanni di clienti e partner sono segnalati. Vedi [Gestione clienti](/klantenbeheer).
- Un indirizzo lo compili con **Via**, **N.** e **Interno**, con suggerimenti di indirizzo mentre digiti. Vedi [Gestione clienti](/klantenbeheer#adres-invullen).

### Controllo accessi [#toegangscontrole]

- Per una tessera QR vedi in quale wallet si trova, e con **Sincronizza pass Wallet** prepari di nuovo la tessera. Vedi [Controllo accessi](/toegangscontrole).

### Integrazioni [#integraties]

- Collega Partoo per inoltrare automaticamente alla tua sede i tuoi orari di apertura, stagioni ed eccezioni. Vedi [Partoo](/integraties/partoo).

## Settembre 2026 [#september-2026]

### Pagamenti [#betalingen]

- I mandati SEPA li firmi in Tillor stesso, a distanza o sul tablet alla reception. Vedi [Mandato SEPA](/betalingsverwerking/mandaat).
- Una nuova pagina di pagamento con scelta propria del metodo di pagamento, codice QR e inoltro all'app Bancontact. Tillor avvisa se un metodo di pagamento ha un guasto.

### Controllo accessi [#toegangscontrole-1]

- Nuovo metodo di accesso: codice PIN. Un codice PIN può essere convertito automaticamente in una targa. Vedi [Controllo accessi](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel).

### Attività [#taken-3]

- Viste salvate con un costruttore di filtri, condivisione con i colleghi e un feed di calendario per vista. Vedi [Viste](/taken/weergaven).
- Dipendenze tra attività, la priorità **Urgente** ed etichette che crei direttamente.
- Collega un'attività a più clienti, oppure a piazzole, contatori, fatture e prenotazioni.

### Parco e comunicazione [#park-en-communicatie]

- Colora le piazzole sulla mappa per tipo ed esporta la mappa come PDF A4. Vedi [Mappa](/kaart).
- Per la telefonia Voys: instradamento per cliente e segreteria automatica. Vedi [Voys Telefonia](/communicatie/providers/voys).
- Esporta in Excel il riepilogo fatture di un cliente.


# Cercare in Tillor (/it-IT/zoeken)

Con la ricerca trovi in un colpo solo un cliente, una fattura, un'occupazione, una prenotazione, una chiamata telefonica, un terreno, un contatore, un'attività o un report pagamenti, da qualsiasi pagina. Non devi quindi andare prima nella sezione giusta. Il risultato apre direttamente la pagina giusta.

<Callout type="info" title="Da sapere">
- Con **Tutti i risultati**, Tillor recupera al massimo dieci risultati per categoria e mostra i tre migliori. Scegli una categoria per vederne fino a cento.
- Per i clienti, Tillor trova anche risultati con un piccolo errore di battitura, così "Jansen" restituisce anche "Janssen".
- Le note delle chiamate telefoniche sono cifrate e non vengono cercate. Cerca per numero di telefono.
- I tag NFC e le targhe non hanno una categoria propria. Li trovi in **Clienti**.
</Callout>

## Cercare e aprire un risultato [#zoeken-en-een-resultaat-openen]

<Steps>
<Step>
### Apri la finestra di ricerca [#open-het-zoekvenster]
Fai clic su **Cerca** nell'intestazione (su uno schermo stretto sulla lente d'ingrandimento), oppure premi **⌘K** (Mac) o **Ctrl+K** (Windows). Con la stessa scorciatoia chiudi di nuovo la finestra.

<DocScreenshot src="/screenshots/zoeken/search-dialog-open.png" alt="Ricerca globale aperta" />
</Step>
<Step>
### Digita il termine di ricerca [#typ-je-zoekterm]
I risultati compaiono appena smetti di digitare per un attimo. Sono raggruppati per categoria, e la categoria con il risultato migliore è in cima: la prima riga è quindi sempre il risultato migliore. Una buona corrispondenza nel titolo conta più di una corrispondenza nella descrizione. Per ogni categoria vedi i tre risultati migliori, e con **Mostra altri …** apri l'intera categoria. In fondo trovi le categorie in cui non è stato trovato nulla.

<DocScreenshot src="/screenshots/zoeken/search-results.png" alt="Risultati di ricerca per Jonas per categoria, con la categoria del risultato migliore in cima" />
</Step>
<Step>
### Limita a una categoria (facoltativo) [#beperk-tot-één-categorie-optioneel]
Se cerchi in un solo tipo di dati, sceglilo con il pulsante **Tutto** all'inizio del campo di ricerca, ad esempio **Clienti**. Puoi farlo prima o dopo aver digitato; il campo di ricerca mostra poi **Cerca in Clienti…**. Puoi anche cliccare sul nome di una categoria nei risultati.

Con la tastiera:
- **Shift+Tab** apre l'elenco delle categorie.
- I tasti da **⌥1** a **⌥9** (da **Alt+1** a **Alt+9** su Windows) scelgono subito una categoria, nell'ordine di quell'elenco. Il numero compare anche accanto al nome di ogni categoria nei risultati.
- **Tab** scorre le categorie che hanno risultati.

Per tornare a tutto: scegli **Tutto** nell'elenco, oppure premi **Backspace** in un campo di ricerca vuoto.
</Step>
<Step>
### Apri il risultato [#open-het-resultaat]
Usa i tasti freccia per scegliere e premi **Invio**. Con **Ctrl+Invio** (**⌘+Invio** su Mac) il risultato si apre in una nuova scheda. Puoi anche fare clic con il mouse. **Esc** chiude la finestra.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il risultato scelto apre il cliente, la fattura o un'altra pagina nella stessa scheda. Con **Ctrl+Invio** (**⌘+Invio** su Mac) si apre in una nuova scheda.
- Nei tuoi dati non cambia nulla: la ricerca si limita a leggere.
- Accanto a un risultato è indicato su cosa è stato trovato, ad esempio **Telefono:** o **Fattura:** con il valore corrispondente.

## Cosa cerca Tillor [#wat-tillor-doorzoekt]

| Categoria | Su cosa puoi cercare |
|-----------|-----------------------|
| **Clienti** | Nome, numero cliente, e-mail, telefono, indirizzo e località, partita IVA, osservazioni, persone di contatto (nome, e-mail, telefono) e metodi di accesso come una tessera NFC o una targa |
| **Fatture** | Numero di fattura (con o senza prefisso, anno e separatori), importo totale, l'ID nel link della fattura e le note (pubbliche e interne) |
| **Occupazioni** | Nome del terreno, nome e cognome del cliente e ID dell'occupazione |
| **Prenotazioni** | Numero di prenotazione (ad esempio `RES/2026/0001`, con o senza prefisso e anno, oppure in forma compatta `20260001`), nota, nome del cliente e ID nel link |
| **Chiamate telefoniche** | Numero in entrata e in uscita, ID della chiamata e riferimento esterno |
| **Terreni** | Nome, descrizione, ID e numero del contatore del gas del terreno |
| **Contatori** | Nome, numero di serie e ID del contatore |
| **Attività** | Titolo, descrizione e ID. Un risultato mostra anche il cliente o il terreno collegato |
| **Report pagamenti** | Numero del report |

<Callout type="info" title="NFC e targa">
Non esiste una categoria separata per i tag NFC. Le tessere NFC e gli altri valori di accesso fanno parte di **Clienti** e compaiono lì appena corrispondono al termine di ricerca.
</Callout>

## Quanti risultati vedi? [#hoeveel-resultaten-zie-je]

Se in una categoria ci sono dieci o più risultati, accanto al nome di quella categoria compare **10+**. Nella panoramica vedi i tre risultati migliori per categoria. Scegli la categoria, oppure clicca su **Mostra altri …**, per vedere fino a cento risultati. Per prenotazioni e fatture la tolleranza agli errori di battitura funziona soprattutto con i numeri e le note.

## Consigli di ricerca [#zoektips]

- **Targa, NFC o codice QR**: cerca il valore registrato per il cliente. Trovi il cliente in **Clienti**.
- **Numero di fattura o di prenotazione**: digita il numero come appare sul documento, oppure una parte. Per `RES/2026/0042` funzionano anche `2026/0042` e `20260042`.
- **Importo**: una fattura si trova anche tramite l'importo totale, ad esempio `120,50`.
- **Chi è dove**: cerca in **Occupazioni** per nome del terreno o del cliente.
- **Nomi parziali**: per i clienti di solito basta una parte del nome. Per le prenotazioni aiuta una parola della nota.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Vedi Nessun risultato trovato">
Controlla l'ortografia e prova con una parte più breve del termine. Se hai scelto una categoria, Tillor cerca solo in quella. Se ci sono risultati in un'altra categoria, la finestra lo segnala. Scegli **Tutto** con il pulsante all'inizio del campo di ricerca, oppure clicca su **Rimuova filtro**.
</Accordion>
<Accordion title="Vedi Ricerca non disponibile">
Qualcosa è andato storto durante la ricerca. Fai clic su **Riprovi**. Se continua a non funzionare, controlla lo [stato del sistema](https://status.tillor.eu).
</Accordion>
<Accordion title="Non trovo un cliente tramite targa o tessera NFC">
Cerca il valore esatto così come è registrato per il cliente. Trovi il cliente in **Clienti**, non in una categoria separata.
</Accordion>
<Accordion title="Non trovo una prenotazione">
Digita il numero come appare sul documento, oppure una parte: per `RES/2026/0042` funzionano anche `2026/0042` e `20260042`. In alternativa cerca per nome del cliente.
</Accordion>
<Accordion title="Non trovo una chiamata telefonica tramite la nota">
Le note delle chiamate telefoniche sono salvate in forma cifrata e quindi non vengono cercate. Cerca per numero di telefono.
</Accordion>
<Accordion title="La scorciatoia da tastiera non funziona">
Alcuni browser o estensioni usano Ctrl+K o ⌘K per conto proprio. In questo caso fai clic su **Cerca** nell'intestazione.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" description="Gestire i clienti" />
  <Card title="Occupazioni" href="/bezettingen" description="Un cliente su un terreno" />
  <Card title="Prenotazioni" href="/reserveringen" description="Gestire le prenotazioni" />
  <Card title="Fatture" href="/facturen" description="Gestire le fatture" />
</Cards>


# Registro attività (/it-IT/activiteitenlog)

Nel registro attività vedi cosa è cambiato in Tillor, quando e da chi. Lo apri da un cliente, una fattura, un'attività o un altro record, e a livello centrale tramite **Registro di audit** se hai i permessi necessari. È una traccia di sola lettura che usi per verificare o dimostrare qualcosa.

<Callout type="info" title="Da sapere">
- Una voce non può essere modificata né eliminata
- Un'esportazione contiene per impostazione predefinita gli ultimi 30 giorni, e al massimo un anno
- Se apri più volte lo stesso documento entro dieci minuti, viene registrato una volta sola
- Gli orari sono mostrati nel tuo fuso orario
- Ci sono anche le azioni di un'automazione, di una chiave API o del sistema, con il tipo di attore
</Callout>

## Consultare il registro attività [#activiteitenlog-bekijken]

Nell'app si chiama di solito **Eventi** o **Attività**, a seconda di dove ti trovi. Chi ha il permesso *Visualizza il registro di audit* può inoltre aprire una panoramica centrale tramite *Registro di audit* nella barra laterale (sopra Impostazioni), con filtri per utente, tipo di evento e data.

| Dove | Navigazione | Etichetta nell'app |
|------|-------------|--------------------|
| Cliente (tutta l'attività correlata) | *Clienti > cliente > Eventi* | Eventi |
| Fattura | *Amministrazione > Fatture > fattura* | Eventi |
| Prenotazione | *Clienti > cliente > Prenotazioni > prenotazione* | Attività |
| Terreno | *Parco > Terreni > terreno* | Eventi |
| Contatore | *Parco > Contatori > contatore* | Attività |
| Prodotto | *Amministrazione > Prodotti > prodotto* | Eventi |
| Attività | *Attività > attività* oppure *Clienti > cliente > Attività > attività* | Attività |
| Tag NFC | *Controller > Tag NFC > tag* | Attività |
| Tablet, chiosco o telefono | *Impostazioni > Tablet e chioschi > dispositivo* | Cronologia |
| Organizzazione (centrale) | *Registro di audit* (sopra Impostazioni, permesso *Visualizza il registro di audit*) | Registro di audit |
| Report pagamenti | *Amministrazione > Report pagamenti > report* | Registro eventi |

Per ogni attività vedi nella cronologia:

- **Titolo** - tipo di evento (ad es. "Fattura contabilizzata", "Cliente aggiornato")
- **Utente** - il collega che ha eseguito l'azione (o Tillor per le azioni automatiche)
- **Ora** - data e ora relativa
- **Descrizione** - dettagli aggiuntivi; a volte con collegamenti a fatture o altri record correlati
- **Prima / dopo** (a volte) - alla creazione, modifica o eliminazione di dati di clienti, contatti, fatture, pagamenti, mandati di pagamento, gruppi di pagamento, documenti, metodi di accesso, punti di accesso, controller, terreni, contatori, letture dei contatori, prodotti, occupazioni, attività o commenti, oltre alla scansione, assegnazione o scollegamento di un documento d'identità e alle modifiche a impostazioni, diritti dei membri, fatturazione o NFC: quali campi sono stati modificati. I PIN dei punti di accesso e i dati personali di un documento d'identità non vengono conservati nel registro
- **Allegati** (a volte) - file scaricabili, ad esempio in caso di integrazioni non riuscite
- **Login / logout** - quando un collega accede o esce, visibile nella panoramica centrale del registro di audit
- **App OAuth e consenso** - creazione, modifica, eliminazione o rotazione del segreto delle app OAuth, oltre al consenso concesso, negato o revocato; visibile nella panoramica centrale del registro di audit. I segreti del client non vengono conservati nel registro
- **Gestione e sicurezza** - modifiche al profilo dell'organizzazione (nome, dati legali, IVA, IBAN, logo, modalità di manutenzione), inviti e nuovi membri, chiavi API personali (creazione, modifica, rinnovo, eliminazione), sessioni terminate, webhook, automazioni, gruppi di colleghi, tipi di terreno, quadri contatori, gruppi di controller, integrazioni installate o rimosse e l'accettazione dell'accordo di trattamento dei dati; visibile nella panoramica centrale del registro di audit. Chiavi, segreti dei webhook e impostazioni delle integrazioni non vengono conservati; per un'integrazione vedi solo quali impostazioni sono state modificate
- **Accesso ai dati personali** - chi ha aperto o scaricato un documento, ha visualizzato o scaricato le immagini o i file di un documento d'identità, o ha aperto il PDF di una fattura o lo ha inviato al tablet. Le aperture ripetute entro dieci minuti vengono registrate una volta sola; ogni download di un documento d'identità viene registrato separatamente

## Attività per record [#activiteiten-per-record]

Nelle pagine di dettaglio vedi una cronologia con l'attività di quel record. Nella scheda **Eventi** di un cliente trovi tutte le attività collegate a quel cliente (fatture, pagamenti, occupazioni, ecc.).


<DocScreenshot src="/screenshots/activiteitenlog/customer-events.png" alt="Eventi nel profilo del cliente Jonas Maes" />

Per le **prenotazioni** ciò comprende tra l'altro la creazione, il check-in e il check-out, gli annullamenti e le relative inversioni, e l'aggiornamento dei dati della prenotazione.

Per i **gruppi di pagamento** vedi anche quali pagamenti sono stati aggiunti a un gruppo o rimossi, e per i **controller** quali richieste di adozione sono state approvate o rifiutate.

Per i **report pagamenti** ciò comprende tra l'altro la creazione del report, la finalizzazione di un report in bozza e l'invio alla contabilità.

Per le **richieste di firma** vedi ogni passaggio: creata e modificata, inviata, link inviato (di nuovo), sollecitata, pagina di firma aperta, codice inviato o inserito in modo errato, firmata, rifiutata, riportata a bozza, annullata, scaduta e conclusa. Vedi [Prove e validità](/handtekeningen/bewijs-en-geldigheid).

Per le **notifiche esterne** vedi quando un sistema collegato ha aggiornato o eliminato una notifica da lui registrata.

<Callout type="info">
Il registro attività è di sola lettura. Le voci non possono essere modificate né eliminate.
</Callout>

## Chi lo ha fatto? [#wie-heeft-het-gedaan]

Ogni riga mostra, oltre all'utente, anche **che tipo di attore** ha eseguito l'azione: un utente connesso, una chiave API, un collegamento OAuth, un'automazione, il connector di Tillor o il sistema stesso. Per una chiave API o un collegamento OAuth, l'id di quella chiave o di quel collegamento compare nei dettagli, così in caso di chiave compromessa vedi esattamente cosa è stato fatto con essa. Se compare **Sconosciuto**, Tillor non ha potuto determinare l'attore; è volutamente diverso da "Sistema".

## Eventi di sicurezza [#beveiligingsgebeurtenissen]

Nel registro attività vengono mostrati anche gli accessi non riusciti, le chiavi API e i token OAuth rifiutati, gli accessi negati (permessi mancanti), i limiti di richieste superati e l'apertura della tua organizzazione da parte di un amministratore di Tillor, con indirizzo IP e browser. I membri con il permesso **Avvisi di sicurezza** ricevono ogni ora una notifica quando sono stati modificati webhook, chiavi API o automazioni, oppure quando l'accesso è stato negato ripetutamente.

Anche l'accesso al tuo account che dai a [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) o revochi, e ogni modifica che confermi tramite Tillie, compaiono qui.

## Esportare per un audit [#exporteren-voor-een-audit]

Con **Esporta** nel registro attività scarichi tutte le righe del periodo scelto (per impostazione predefinita gli ultimi 30 giorni, al massimo un anno) come ZIP con il file dei dati (CSV o JSON Lines), un `manifest.json` con il numero di righe, il periodo, chi ha esportato e il checksum SHA-256 del file dei dati, e un file `CHECKSUMS.sha256` che puoi verificare con `sha256sum -c`. Anche l'esportazione stessa viene registrata, con lo stesso checksum. Vengono registrate anche l'apertura dell'intero registro attività e le esportazioni di massa dei dati dei clienti (elenco clienti, registro accessi, terreni, contatori).

Tutti gli orari sono salvati in **UTC** su server con sincronizzazione oraria NTP e mostrati nel tuo fuso orario; l'esportazione contiene orari ISO 8601 in UTC.

## A cosa serve il registro? [#waarvoor-gebruik-je-de-log]

- **Controllo** - verificare quale collega ha contabilizzato una fattura o modificato un cliente
- **Risoluzione dei problemi** - scoprire quando si è verificato un errore
- **Audit** - conservare una traccia completa per controlli interni o esterni

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Utenti" href="/gebruikers" description="Gestire utenti e permessi" />
  <Card title="Fatture" href="/facturen" description="Consultare la cronologia delle fatture" />
</Cards>


# Per iniziare (/it-IT/automatiseringen/aan-de-slag)

In questa pagina crei la tua prima automazione e conosci l'editor, la schermata in cui disegni i flussi. Ti serve il permesso **Gestisci automazioni**, oppure **Tutti i permessi**. Per il contesto vedi la [Panoramica](/automatiseringen).

## La panoramica [#het-overzicht]

Vai su **Amministratore > Automazioni**. Vedi un elenco con una riga per automazione:

- il nome e un'etichetta come **2 problemi** se nel flusso c'è ancora qualcosa che non va (vedi [Problemi e attivazione](/automatiseringen/problemen))
- la descrizione
- il trigger scelto, il numero di passaggi e chi ha creato l'automazione (**di**)
- una serie di barrette con le ultime esecuzioni, accanto l'orario dell'ultima esecuzione oppure **Non ancora eseguita**. Una barretta rossa è un'esecuzione non riuscita
- un interruttore per attivare o disattivare l'automazione e un menu con tre puntini

<DocScreenshot src="/screenshots/automatiseringen/overview.png" alt="Panoramica delle automazioni con l'elenco, i filtri e il campo di ricerca" />

In alto nell'elenco filtri con **Tutte**, **Abilitata** e **In pausa**. Se un'automazione ha problemi, compare anche un filtro **Problemi**. Con **Cerca automazioni** cerchi per nome o descrizione.

Fai clic sul nome per aprire l'editor. Con l'interruttore attivi o disattivi un'automazione. Non puoi attivarla finché ci sono problemi. Il menu **Azioni dell'automazione** ha due voci:

| Voce | Cosa fa |
|---|---|
| **Duplica** | Crea una copia con il nome *[nome] (copia)*. La copia è in pausa |
| **Elimina** | Elimina l'automazione e la cronologia delle esecuzioni. Tillor chiede prima conferma |

Le esecuzioni che in quel momento attendono in un ritardo si fermano se elimini l'automazione.

## Creare una nuova automazione [#een-nieuwe-automatisering-maken]

Fai clic su **Nuova automazione**. Si apre una galleria con sei punti di partenza. Puoi modificare ogni passaggio in seguito.

| Punto di partenza | Cosa fa |
|---|---|
| **Parti da zero** | Un flusso vuoto con solo un trigger |
| **Controlla il terreno dopo la partenza** | Crea un'attività di controllo per il terreno quando un'occupazione termina, con priorità alta e assegnata a chi ha chiuso l'occupazione |
| **Segui le fatture non pagate** | Attende fino a dopo la scadenza, invia un promemoria di pagamento e una settimana dopo crea un'attività per chiamare il cliente se la fattura è ancora aperta |
| **Invia le prenotazioni a un altro sistema** | Per ogni nuova prenotazione invia un payload dedicato al tuo endpoint webhook e crea un'attività se la consegna non riesce |
| **Controllare un contatore che non conta più** | Crea un'attività per la reception quando un contatore resta fermo mentre il terreno è stato usato, con sottoattività per il controllo sul posto |
| **Chiama la Tillor API** | Aggiunge un commento a ogni nuova attività tramite la Tillor API |

<DocScreenshot src="/screenshots/automatiseringen/gallery.png" alt="Galleria Nuova automazione con i punti di partenza" />

Appena scegli, Tillor crea l'automazione e apre l'editor. L'automazione è in pausa finché non la attivi.

## L'editor [#de-editor]

L'editor riempie tutto lo schermo e ha tre parti: a sinistra l'elenco dei passaggi, al centro la tela e a destra il pannello. Il nome dell'automazione compare in alto nella barra di navigazione e puoi modificarlo direttamente lì.

<DocScreenshot src="/screenshots/automatiseringen/editor.png" alt="Editor con l'elenco dei passaggi a sinistra, la tela al centro e il pannello a destra" />

Passa sopra i simboli ℹ per una breve spiegazione di ogni parte.

**Elenco dei passaggi (a sinistra).** Cerca un passaggio con **Cerca passaggi**. In alto c'è il gruppo **Strumenti** con **Commento** e **Riquadro** (vedi [Commenti e riquadri](#opmerkingen-en-kaders)). Sotto ci sono i passaggi in sei gruppi, con **Documenti** in mezzo:

- **Logica**: il trigger **Quando succede questo** e condizioni, attese, ricerche e cicli, come **Se / altrimenti**, **Smista**, **Ritardo**, **Aperto ora?**, **Cerca un record**, **Per ogni** e **Chiedi una decisione**. Vedi [Condizioni, selettori e ritardi](/automatiseringen/logica)
- **Attività**: creare, cercare e aggiornare attività
- **Documenti**: cercare e aggiornare documenti
- **Ospiti e messaggi**: messaggi a ospiti e colleghi, commenti, la inbox, clienti e prenotazioni
- **Fatture e pagamenti**: fatture, link di pagamento, mandati e consumi
- **Accesso e dispositivi**: mezzi di accesso, sbarre, corrente, tag NFC e tablet
- **Integrazioni**: **Invia webhook** e **Richiesta API**

Cosa fa ogni azione lo trovi in [Azioni](/automatiseringen/acties). In fondo c'è **Richiedi un passaggio** se ne manca uno.

**Tela (al centro).** Qui vedi il flusso. In alto c'è il trigger, sotto i passaggi con le linee tra loro. In basso a sinistra ingrandisci e riduci.

**Pannello (a destra).** In alto c'è l'interruttore **Attiva**, se ci sono problemi un pulsante come **1 problema**, un pulsante **Riordina** che mette i passaggi in ordine uno sotto l'altro (i commenti restano dove sono) e un pulsante **Nascondi pannello**. Se nascondi il pannello, **Mostra pannello** lo mostra di nuovo. Sotto scegli una scheda:

| Scheda | Cosa fai |
|---|---|
| **Configura** | Modificare il passaggio selezionato. Se non selezioni nulla, puoi inserire una **Descrizione** per l'automazione |
| **Esecuzione di prova** | Provare il flusso, vedi [Test ed esecuzioni](/automatiseringen/testen-en-uitvoeringen) |
| **Esecuzioni** | Vedere cosa hanno fatto le esecuzioni reali |
| **Cronologia** | Vedere e ripristinare le versioni salvate in precedenza, vedi [Versioni precedenti](#eerdere-versies) |

Se hai fatto modifiche, in fondo al pannello compare **Modifiche non salvate** con i pulsanti **Ripristina** e **Salva**. **Ripristina** riporta il flusso all'ultima versione salvata. Se il pannello è nascosto, quei pulsanti sono in alto a destra sulla tela.

Finché non hai selezionato un passaggio, sotto la descrizione compare chi ha creato l'automazione. Le esecuzioni non riuscite vengono inviate via e-mail a quella persona, al massimo una volta all'ora per automazione.

Su un telefono il pannello è prima nascosto, così la tela occupa tutto lo schermo. Tocca un passaggio o **Mostra pannello** per aprirlo.

### Aggiungere e collegare i passaggi [#stappen-toevoegen-en-verbinden]

Hai quattro modi per aggiungere un passaggio:

- Fai clic su un passaggio nell'elenco a sinistra. Compare al centro della tela
- Trascina un passaggio dall'elenco sulla tela
- Fai clic sul più sotto un'uscita che non porta ancora da nessuna parte (**Aggiungi un passaggio dopo "[uscita]"**) e scegli un passaggio. Il nuovo passaggio viene collegato subito
- Trascina un passaggio su una linea. Si posiziona allora tra i due passaggi (**Inserisci un passaggio qui**)

Per collegare i passaggi tra loro, trascina dall'uscita sotto un passaggio a un altro passaggio. Vale quanto segue:

- Ogni uscita porta a un solo passaggio. Se colleghi di nuovo un'uscita, la nuova linea sostituisce quella vecchia
- Una linea che formerebbe un anello viene rifiutata. Se c'è comunque un ciclo, non puoi attivare l'automazione. Un'esecuzione si ferma appena dovrebbe rifare un passaggio
- Un passaggio senza linea in entrata non viene mai eseguito. Tillor lo segnala come problema (**Non collegato, quindi questo passaggio non viene mai eseguito.**)
- Un trigger puoi modificarlo, duplicarlo e aggiungerne altri dall'elenco a sinistra. L'ultimo trigger non puoi eliminarlo. Un trigger non va su una linea: avvia un'esecuzione propria

Dai a un passaggio un nome proprio nel campo **Nome del passaggio**. Aiuta quando il flusso diventa più grande. Con i pulsanti **Duplica passaggio** ed **Elimina passaggio** in alto nel pannello copi o elimini il passaggio selezionato.

### Commenti e riquadri [#opmerkingen-en-kaders]

Con un commento spieghi sulla tela cosa fa una parte del flusso, ad esempio perché c'è una condizione. Un **Riquadro** è una linea tratteggiata con un nome che metti attorno a un gruppo di passaggi.

- Nel gruppo **Strumenti** fai clic su **Commento** o **Riquadro** e digita il testo
- Trascina il commento o il riquadro sui passaggi che spiegano. Selezionali per ingrandirli o ridurli con gli angoli
- Elimina un commento con **Elimina commento** o un riquadro con **Elimina riquadro**, oppure selezionali e premi Canc
- Commenti e riquadri non vengono mai eseguiti e non contano per i problemi. Puoi inserirne al massimo 50 in totale. Vengono conservati con **Salva**, come i passaggi, e con Ctrl/Cmd + Z annulli una modifica

### Versioni precedenti [#eerdere-versies]

Ogni volta che salvi una modifica, Tillor conserva la versione precedente. Nella scheda **Cronologia** vedi le versioni con ciò che è cambiato, ad esempio **1 passaggio aggiunto** o **Disposizione o collegamenti modificati**, e da chi o da cosa proviene la modifica (ad esempio **Tramite l’API**). Con **Ripristina** porti una versione sulla tela. Conta come modifica non salvata: salva per mantenere la versione, oppure annulla.

### Scorciatoie da tastiera [#sneltoetsen]

| Tasto | Cosa fa |
|---|---|
| Ctrl/Cmd + S | Salvare |
| Ctrl/Cmd + Z | Annullare |
| Ctrl/Cmd + Shift + Z oppure Ctrl/Cmd + Y | Ripetere |
| Ctrl/Cmd + C, Ctrl/Cmd + V | Copiare e incollare i passaggi selezionati |
| Ctrl/Cmd + D | Duplicare i passaggi selezionati |
| Ctrl/Cmd + A | Selezionare tutto |
| Canc o Backspace | Eliminare i passaggi o le linee selezionati |
| Esc | Annullare la selezione |

## Salvare e attivare [#opslaan-en-inschakelen]

Tillor non salva automaticamente. Fai clic su **Salva** (o premi Ctrl/Cmd + S) per conservare le modifiche. Il pulsante è attivo appena qualcosa è stato modificato e il nome non è vuoto.

<Callout type="warn">
Se l'automazione è attiva, puoi salvare solo quando non ci sono più problemi. Un flusso in esecuzione deve restare sempre valido. Risolvi i problemi, oppure metti prima in pausa l'automazione.
</Callout>

Con l'interruttore **Attiva** attivi l'automazione. Questo salva subito anche il flusso. L'interruttore non funziona finché ci sono problemi, con la spiegazione **Risolvi prima i problemi aperti**. Poi l'automazione parte a ogni evento corrispondente. Può volerci mezzo minuto prima che una modifica abbia effetto ovunque.

Se in seguito modifichi un flusso attivo, le modifiche valgono solo per le nuove esecuzioni. Le esecuzioni già in corso o in attesa in un ritardo terminano con il flusso così com'era quando sono partite.

## La tua prima automazione: un'attività dopo la partenza [#je-eerste-automatisering-een-taak-na-vertrek]

Questo esempio crea un'attività quando un'occupazione termina.

1. Fai clic su **Nuova automazione** e scegli **Controlla il terreno dopo la partenza**
2. Fai clic sul trigger. In **Evento** c'è `occupation:ended`
3. Fai clic sul passaggio **Crea attività**. Modifica **Titolo**, **Descrizione** e **Priorità**, oppure scegli in **Aggiungi alla bacheca** una bacheca e una **Colonna**
4. Apri la scheda **Esecuzione di prova** e fai clic su **Esegui prova**. Vedi quali passaggi il flusso percorrerebbe
5. Fai clic su **Salva** e attiva **Attiva**
6. Termina un'occupazione e guarda nella scheda **Esecuzioni** cos'è successo

## Richiedere un passaggio o un evento [#een-stap-of-gebeurtenis-aanvragen]

Ti manca un trigger, una condizione o un'azione? Fai clic su **Richiedi un passaggio** sotto l'elenco dei passaggi. Nell'elenco degli eventi del trigger c'è anche un link **Manca un evento? Richiedilo**.

1. In **Di cosa hai bisogno?** scegli tra **Un trigger o un evento**, **Una condizione o un filtro**, **Un'azione** o **Qualcos'altro**
2. In **Cosa dovrebbe fare?** descrivi cosa vuoi automatizzare. Scrivi almeno 10 caratteri, al massimo 1000
3. Fai clic su **Invia richiesta**

La tua richiesta arriva al team di Tillor, insieme al tuo nome e al nome della tua organizzazione. Ricevi una notifica che la richiesta è stata inviata.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Una nuova automazione è in pausa. Non succede nulla finché non attivi **Attiva**.
- Dopo l'attivazione, l'automazione parte a ogni evento corrispondente. Può volerci mezzo minuto prima che una modifica abbia effetto ovunque.
- Ogni avvio è un'esecuzione. Le vedi nella scheda **Esecuzioni**, con lo stato **Completata**, **In attesa**, **Non riuscita** o **Annullata**.
- Se un'esecuzione non riesce, chi ha creato l'automazione riceve un'e-mail, al massimo una all'ora per automazione.
- Se modifichi un flusso in esecuzione, le modifiche valgono solo per le nuove esecuzioni. Ciò che è già in corso o in attesa termina con il vecchio flusso.
- Le attività e i commenti creati dall'automazione sono a nome di **Flusso di lavoro**. Vedi [Chi esegue un'automazione?](/automatiseringen/workflow-gebruiker).

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'interruttore Attiva non funziona">
Tillor mostra **Risolvi prima i problemi aperti**. Fai clic in alto nel pannello sul pulsante con il numero di problemi e risolvili. Vedi [Problemi e attivazione](/automatiseringen/problemen).
</Accordion>
<Accordion title="Non riesco a salvare">
Il pulsante **Salva** è attivo solo se qualcosa è stato modificato e il nome non è vuoto. Se l'automazione è attiva, puoi salvare solo senza problemi. Risolvili o metti prima in pausa.
</Accordion>
<Accordion title="Il mio passaggio non viene mai eseguito">
Tillor segnala **Non collegato, quindi questo passaggio non viene mai eseguito.** Trascina dall'uscita di un passaggio precedente a questo passaggio.
</Accordion>
<Accordion title="Non riesco a collegare una linea">
Una linea che formerebbe un anello viene rifiutata. Un flusso può andare solo avanti.
</Accordion>
<Accordion title="Non vedo Automazioni nel menu">
Il menu compare solo se hai il permesso **Visualizza automazioni**. Per creare e modificare serve **Gestisci automazioni**. Chiedi a un amministratore di modificare i tuoi permessi.
</Accordion>
<Accordion title="Il flusso non reagisce alla mia azione">
Controlla i punti in [Perché la mia automazione non parte?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
</Accordions>

## Prossimi passi [#volgende-stappen]

<Cards>
  <Card
    title="Trigger"
    href="/automatiseringen/triggers"
    description="Scegli quando parte un'automazione"
  />
  <Card
    title="Azioni"
    href="/automatiseringen/acties"
    description="Tutto ciò che un'automazione può fare"
  />
  <Card
    title="Esempio: controllo della roulotte a noleggio"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Un flusso completo con una ricerca, un selettore e sottoattività"
  />
</Cards>


# Documenti (/it-IT/automatiseringen/acties/documenten)

Con queste azioni lavori con i documenti di un cliente, come una prova di pagamento dell'assicurazione. Il tipo e la data di scadenza di un documento si trovano nei dati del documento. In un flusso li leggi come `{document.userMetadata.documentType}` e `{document.userMetadata.insuranceExpiryDate}`.

## Trova documento [#document-zoeken]

Cerca il documento più recente di un cliente. Il passaggio ha due uscite: **Trovata** e **Non trovata**.

| Campo | Cosa inserisci |
|---|---|
| **Cliente** | L'id del cliente, ad esempio `{document.customerId}` o `{customer.id}`. Obbligatorio |
| **Tipo** | Ad esempio **Prova di pagamento dell'assicurazione**. Lascia vuoto per qualsiasi tipo |
| **Salta i documenti archiviati** | Attivo per impostazione predefinita |
| **Solo documenti non scaduti** | La data di scadenza deve essere successiva a ora. I documenti senza data di scadenza non vengono quindi considerati. Disattivo per impostazione predefinita |

Se corrispondono più documenti, il passaggio prende il più recente. Tramite **Trovata** i passaggi successivi possono usare `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` e `{foundDocument.userMetadata.insuranceExpiryDate}`.

Così controlli, ad esempio per un'assicurazione scaduta, se il cliente ha già una nuova prova di pagamento valida: cerca con **Tipo** *Prova di pagamento dell'assicurazione* e **Solo documenti non scaduti** attivo, e prosegui solo tramite **Non trovata**.

## Aggiorna documento [#document-bijwerken]

Modifica il tipo di un documento, oppure lo archivia o lo ripristina. I campi vuoti restano come sono.

| Campo | Cosa inserisci |
|---|---|
| **Documento** | L'id del documento. Per impostazione predefinita `{document.id}`. Obbligatorio |
| **Nuovo tipo** | Lascia vuoto per mantenere il tipo |
| **Stato** | **Attivo** o **Archiviato**. Lascia vuoto per mantenere lo stato |

Un tipo che richiede una data di scadenza, come **Prova di pagamento dell'assicurazione**, non riesce se il documento non ha una data di scadenza. L'azione restituisce `{updatedDocument.id}`.


# Fatture e pagamenti (/it-IT/automatiseringen/acties/facturen-en-betalingen)

Questi passaggi si trovano nel gruppo **Fatture e pagamenti**. Come funzionano le uscite lo leggi in [Uscite di un'azione](/automatiseringen/acties#uitgangen-van-een-actie).

## Invia promemoria di pagamento [#betalingsherinnering-versturen]

Invia al cliente il promemoria di pagamento di una fattura, proprio come fa il pulsante di promemoria sulla fattura.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Per impostazione predefinita `{invoice.id}`. Obbligatorio |

Attenzione: il campo si aspetta l'id interno della fattura (`{invoice.id}`) e non il numero di fattura (`{invoice.displayId}`).

Il passaggio non riesce se:

- la fattura non è contabilizzata
- non c'è più nulla da pagare, quindi la fattura è già pagata
- il cliente non ha un indirizzo e-mail, un numero di telefono e un indirizzo postale completo

L'esecuzione ottiene allora lo stato **Non riuscita** e il resto del flusso non viene eseguito. Metti quindi prima del promemoria un **Se / altrimenti** che controlli se la fattura è ancora aperta, come nel modello **Segui le fatture non pagate**.

Il passaggio salta anche una fattura se è stata esclusa dai promemoria automatici, oppure se per il cliente è attivo **Escludi dai solleciti automatici**.

## Sincronizza transazioni bancarie [#banktransacties-synchroniseren]

Recupera le nuove transazioni bancarie e attende che l'importazione sia terminata. Metti questo passaggio prima di **Invia promemoria di pagamento**, così una fattura appena pagata non riceve un promemoria. Se Ponto non è collegato, il passaggio viene saltato.

Salva l'automazione dalla rete dell'ufficio. Tillor memorizza allora l'IP necessario al collegamento bancario. Senza quell'IP la sincronizzazione non può partire.

## Disattiva promemoria automatici per il cliente [#automatische-herinneringen-uitschakelen-voor-klant]

Attiva **Escludi dai solleciti automatici** nelle impostazioni di fatturazione del cliente. I flussi di promemoria saltano poi tutte le sue fatture. Un sollecito manuale resta possibile.

| Campo | Cosa inserisci |
|---|---|
| **Cliente** | L'id del cliente. Obbligatorio |

## Disattiva promemoria automatici per la fattura [#automatische-herinneringen-uitschakelen-voor-factuur]

Toglie una singola fattura dai flussi di promemoria per i ritardi e dai promemoria automatici. I collaboratori possono comunque inviare manualmente un promemoria.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Obbligatorio |

## Invia fattura [#factuur-versturen]

Invia una fattura al cliente, nello stesso modo del pulsante di invio sulla fattura.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Per impostazione predefinita `{invoice.id}`. Obbligatorio |

Il passaggio non riesce se la fattura non è contabilizzata o se il cliente non ha un indirizzo e-mail, un numero di telefono e un indirizzo postale completo.

## Contabilizza fattura [#factuur-boeken]

Contabilizza una fattura in bozza, così riceve il suo numero di fattura.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Per impostazione predefinita `{invoice.id}`. Obbligatorio |

Se la fattura è già contabilizzata, non succede nulla e il flusso prosegue tramite **Saltato**. Dopo la contabilizzazione l'azione restituisce `{bookedInvoice.displayId}`, il numero di fattura. Puoi usarlo in un messaggio o in un'attività. Combina il passaggio con **Invia fattura** per contabilizzare e inviare una fattura in bozza in un colpo solo.

## Stampa fattura [#factuur-afdrukken]

Stampa una fattura, oppure la mostra sul tablet alla reception.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Per impostazione predefinita `{invoice.id}`. Obbligatorio |
| **Dove** | **Stampante A4** (predefinita), **Stampante per scontrini** o **Tablet** |

Le stampanti si configurano in [Impostazioni di stampa](/printer/afdrukinstellingen). Una fattura che stampi una seconda volta con questo passaggio viene semplicemente stampata di nuovo.

## Crea link di pagamento [#betaallink-aanmaken]

Crea un link di pagamento online per l'importo ancora aperto di una fattura.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Per impostazione predefinita `{invoice.id}`. Obbligatorio |
| **Metodo di pagamento** | **Lascia scegliere il cliente** (predefinito), **Bancontact**, **iDEAL**, **Carta di credito** o **Payconiq** |

Il link esiste solo per una fattura contabilizzata con qualcosa ancora aperto. Se la fattura non è contabilizzata o è già pagata, il flusso prosegue tramite **Saltato**. Poi l'azione restituisce `{paymentLink.url}`. Mettilo in un testo, ad esempio in un messaggio tramite [Scrivi a un ospite](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen).

## Richiedi mandato SEPA [#sepa-mandaat-aanvragen]

Invia a un cliente via e-mail una richiesta di firma di un mandato SEPA, oppure un promemoria per una richiesta ancora aperta. Per il mandato in sé vedi [Mandato](/betalingsverwerking/mandaat).

| Campo | Cosa inserisci |
|---|---|
| **Cliente** | L'id del cliente. Per impostazione predefinita `{customer.id}`. Obbligatorio |
| **Invia** | **Una nuova richiesta** (predefinito) oppure **Un promemoria** |

Una nuova richiesta viene saltata se ce n'è già una aperta. Un promemoria viene saltato se non c'è una richiesta aperta, oppure se la richiesta è scaduta. In entrambi i casi il flusso prosegue tramite **Saltato**.

## Incassa con addebito diretto [#innen-via-domiciliëring]

Incassa ciò che resta aperto su una fattura con il mandato SEPA attivo del cliente.

| Campo | Cosa inserisci |
|---|---|
| **Fattura** | L'id della fattura. Per impostazione predefinita `{invoice.id}`. Obbligatorio |
| **Dopo giorni** | Quanti giorni Tillor attende prima di incassare. Con 0 si incassa subito. Il massimo è 7 giorni, un numero più alto diventa 7. Per impostazione predefinita 0 |

Il passaggio incassa l'intero importo aperto. Se la fattura non è contabilizzata o è già pagata, o se il cliente non ha un mandato attivo, non succede nulla e il flusso prosegue tramite **Saltato**. Se il cliente ha più di un mandato attivo, il passaggio usa il più recente.

## Fattura i consumi [#verbruik-factureren]

Fattura i consumi dei contatori ancora aperti di un cliente, contabilizza la fattura e la invia.

| Campo | Cosa inserisci |
|---|---|
| **Cliente** | L'id del cliente. Per impostazione predefinita `{occupation.customerId}`. Obbligatorio |
| **Invia per e-mail** | Attivo per impostazione predefinita |
| **Invia per SMS** | Disattivo per impostazione predefinita |

Se non c'è nulla di aperto da fatturare, non viene creata nessuna fattura e il flusso prosegue tramite **Saltato**. Altrimenti l'azione restituisce `{consumptionInvoice.id}`. Per come vengono registrati i consumi vedi [Gestione contatori](/meterbeheer).

## Bozza fattura di proroga [#conceptfactuur-voor-verlenging]

Crea una fattura in bozza che prolunga un'occupazione, pronta per essere controllata. La fattura non è ancora contabilizzata. È lo stesso tipo di fattura che ottieni con **Estendi occupazione (fattura)** nel profilo del cliente.

| Campo | Cosa inserisci |
|---|---|
| **Occupazione** | L'id dell'occupazione. Per impostazione predefinita `{occupation.id}`. Obbligatorio |
| **Aggiungi i consumi aperti** | Mette i consumi aperti dei contatori del cliente sulla stessa fattura. Disattivo per impostazione predefinita |

L'azione restituisce `{extendInvoice.id}`. Se vuoi contabilizzare e inviare subito la fattura, usa poi **Contabilizza fattura** e **Invia fattura** con `{extendInvoice.id}` come fattura.


# Ospiti e messaggi (/it-IT/automatiseringen/acties/gasten-en-berichten)

Questi passaggi si trovano nel gruppo **Ospiti e messaggi**. Come funzionano le uscite lo leggi in [Uscite di un'azione](/automatiseringen/acties#uitgangen-van-een-actie).

## Scrivi a un ospite [#gast-een-bericht-sturen]

Invia un tuo testo a un cliente via e-mail, SMS o WhatsApp. Usalo per messaggi che non hanno un modello fisso di Tillor, come un messaggio di benvenuto il giorno dell'arrivo.

| Campo | Cosa inserisci |
|---|---|
| **Cliente** | L'id del cliente, ad esempio `{reservation.customerId}`. Obbligatorio |
| **Oggetto** | Solo per l'e-mail. Se vuoto usa il nome della tua organizzazione |
| **Messaggio** | Il testo, senza formattazione. Le variabili vengono compilate. Obbligatorio |
| **Invia per e-mail** | Attivo per impostazione predefinita |
| **Invia per SMS** | Disattivo per impostazione predefinita |
| **Invia via WhatsApp** | Disattivo per impostazione predefinita |

Da tenere presente:

- I clienti che non accettano comunicazioni non ricevono nulla. Il flusso prosegue allora tramite **Saltato**
- Fuori dalla finestra di 24 ore di WhatsApp, Tillor invia il tuo testo come template approvato. All'interno di quella finestra viene inviato come messaggio normale
- Se il cliente non esiste, il passaggio non riesce

## Avvisa i colleghi [#collegas-verwittigen]

Invia ai colleghi una notifica push, un'e-mail o entrambe.

| Campo | Cosa inserisci |
|---|---|
| **Colleghi** | Scegli uno o più colleghi |
| **Avvisa anche chi ha causato l'evento** | Avvisa anche il collega che ha causato l'evento. Se l'evento è stato causato dal sistema, non viene aggiunto nessuno |
| **Titolo** | L'intestazione della notifica. Obbligatorio |
| **Testo** | Il contenuto della notifica |
| **Invia come notifica push** | Attivo per impostazione predefinita |
| **Invia per e-mail** | Disattivo per impostazione predefinita |

L'utente **Flusso di lavoro** non riceve mai una notifica. Se non ci sono colleghi da avvisare, il passaggio non fa nulla e il flusso prosegue normalmente.

## Aggiungi un commento [#opmerking-toevoegen]

Inserisce un [commento](/notities), a nome di **Flusso di lavoro**.

| Campo | Cosa inserisci |
|---|---|
| **Commento** | Il testo del commento. Obbligatorio |
| **Su** | **I record dell'evento** (predefinito) oppure **Un'attività** |
| **Attività** | Solo con **Un'attività**: l'id dell'attività, ad esempio `{createdTask.id}`. Obbligatorio |

Da tenere presente:

- Menziona un collega con `@{triggeredBy.name}({triggeredBy.id})`. Quel collega riceve allora una notifica, come per un commento che scrivi tu stesso. Funziona solo se un collega ha causato l'evento
- Con **I record dell'evento** il commento va sul cliente, la fattura, la prenotazione, il pagamento, il terreno, il contatore e l'attività a cui si riferisce l'evento. Se l'evento non ha nessuno di questi record, il passaggio non riesce
- L'azione restituisce `{createdComment.id}`

## Rispondi nella inbox [#antwoorden-in-de-inbox]

Invia una risposta in una conversazione della inbox, tramite lo stesso canale con cui ha scritto l'ospite.

| Campo | Cosa inserisci |
|---|---|
| **Conversazione** | L'id della conversazione. Per impostazione predefinita `{threadId}`. Obbligatorio |
| **Risposta** | Il testo, senza formattazione. Le variabili vengono compilate. Oltre 4096 caratteri viene troncato. Obbligatorio |
| **Mantieni attivo l'assistente AI** | Disattivo per impostazione predefinita |

Da tenere presente:

- `{threadId}` esiste per gli eventi sui messaggi della inbox, come `inbox:message-created`
- Quell'evento vale per ogni nuovo messaggio, anche per la tua stessa risposta. Controlla quindi prima che il messaggio provenga dall'ospite, altrimenti la tua risposta fa ripartire il flusso. Metti prima di questo passaggio un [Cerca un record](/automatiseringen/logica#record-opzoeken) su **Messaggio della inbox** con `{messageId}` e un **Se / altrimenti** che verifichi se `foundInboxMessage.direction` è uguale a `INBOUND`
- Per impostazione predefinita la tua risposta mette in pausa l'[assistente AI](/inbox/inbox-ai-assistant) in quella conversazione, come quando risponde un collega. Con **Mantieni attivo l'assistente AI** l'assistente continua a rispondere. Se la conversazione è archiviata, il passaggio non riesce

## Tagga o archivia conversazione [#gesprek-taggen-of-archiveren]

Assegna tag a una conversazione della inbox, la archivia, oppure entrambe le cose.

| Campo | Cosa inserisci |
|---|---|
| **Conversazione** | L'id della conversazione. Per impostazione predefinita `{threadId}`. Obbligatorio |
| **Aggiungi tag** | Scegli uno o più tag. Si aggiungono, i tag esistenti restano |
| **Archivia la conversazione** | Disattivo per impostazione predefinita |

## Aggiorna cliente [#klant-bijwerken]

Modifica lo stato di un cliente o aggiunge una nota. Gli altri dati del cliente restano invariati.

| Campo | Cosa inserisci |
|---|---|
| **Cliente** | L'id del cliente, ad esempio `{invoice.customerId}`. Obbligatorio |
| **Stato** | **Lascia invariato** (predefinito), **Standard**, **Preferenza**, **VIP**, **Avviso** o **Bloccato** |
| **Aggiungi alle note** | Testo che va su una nuova riga sotto le note esistenti. Se vuoto non aggiunge nulla |

## Check-in, check-out o annulla [#inchecken-uitchecken-of-annuleren]

Porta una prenotazione al suo stato successivo.

| Campo | Cosa inserisci |
|---|---|
| **Prenotazione** | L'id della prenotazione. Per impostazione predefinita `{reservation.id}`. Obbligatorio |
| **Azione** | **Check-in** (predefinito), **Check-out** o **Annulla** |

La prenotazione deve trovarsi per questo nello stato giusto. **Check-in** e **Annulla** funzionano con una prenotazione nello stato **Prenotato**, **Check-out** con una prenotazione nello stato **Check-in effettuato**. Se si trova in un altro stato, non succede nulla e il flusso prosegue tramite **Saltato**.


# Panoramica (/it-IT/automatiseringen/acties)

Le azioni sono i passaggi che fanno davvero qualcosa. Le trovi nell'elenco dei passaggi nei gruppi **Attività**, **Documenti**, **Ospiti e messaggi**, **Fatture e pagamenti**, **Accesso e dispositivi** e **Integrazioni**. I passaggi nel gruppo **Logica** governano il flusso stesso. Si trovano in [Condizioni, selettori e ritardi](/automatiseringen/logica). Tutte le azioni vengono eseguite dall'[utente **Flusso di lavoro**](/automatiseringen/workflow-gebruiker) della tua organizzazione.

| Gruppo | Azione | Cosa fa |
|---|---|---|
| Attività | [Crea attività](/automatiseringen/acties/taken#taak-aanmaken) | Crea un'attività, eventualmente con sottoattività, su una bacheca e collegata a cliente, terreno o fattura |
| Attività | [Imposta stato](/automatiseringen/acties/taken#taakstatus-zetten) | Modifica lo stato di un'attività esistente |
| Attività | [Cerca attività](/automatiseringen/acties/taken#taak-zoeken) | Cerca un'attività per titolo e prosegue tramite **Trovata** o **Non trovata** |
| Attività | [Imposta priorità attività](/automatiseringen/acties/taken#taakprioriteit-zetten) | Aumenta, riduce o sceglie la priorità di un'attività esistente |
| Attività | [Aggiorna attività](/automatiseringen/acties/taken#taak-bijwerken) | Rinomina un'attività, aggiunge persone o etichette o sposta la scadenza |
| Attività | [Elimina attività](/automatiseringen/acties/taken#taak-verwijderen) | Elimina un'attività, ad esempio quella creata da questo flusso |
| Documenti | [Trova documento](/automatiseringen/acties/documenten#document-zoeken) | Cerca il documento più recente di un cliente e prosegue tramite **Trovata** o **Non trovata** |
| Documenti | [Aggiorna documento](/automatiseringen/acties/documenten#document-bijwerken) | Modifica il tipo di un documento, oppure lo archivia o lo ripristina |
| Ospiti e messaggi | [Scrivi a un ospite](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Invia un testo proprio a un cliente via e-mail, SMS o WhatsApp |
| Ospiti e messaggi | [Avvisa i colleghi](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Invia ai colleghi una notifica push o un'e-mail |
| Ospiti e messaggi | [Aggiungi un commento](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Inserisce un commento sui record dell'evento o su un'attività |
| Ospiti e messaggi | [Rispondi nella inbox](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Invia una risposta in una conversazione della inbox |
| Ospiti e messaggi | [Tagga o archivia conversazione](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Aggiunge tag a una conversazione della inbox o la archivia |
| Ospiti e messaggi | [Aggiorna cliente](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Modifica lo stato di un cliente o aggiunge una nota |
| Ospiti e messaggi | [Check-in, check-out o annulla](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Porta una prenotazione al suo stato successivo |
| Fatture e pagamenti | [Invia promemoria di pagamento](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Invia al cliente il promemoria di pagamento di una fattura |
| Fatture e pagamenti | [Sincronizza transazioni bancarie](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Recupera le nuove transazioni bancarie prima che il flusso prosegua |
| Fatture e pagamenti | [Disattiva promemoria automatici per il cliente](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Salta tutte le fatture di un cliente nei solleciti automatici |
| Fatture e pagamenti | [Disattiva promemoria automatici per la fattura](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Toglie una singola fattura dai flussi di promemoria automatici |
| Fatture e pagamenti | [Invia fattura](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Invia una fattura al cliente |
| Fatture e pagamenti | [Contabilizza fattura](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Contabilizza una fattura in bozza |
| Fatture e pagamenti | [Stampa fattura](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Stampa una fattura o la mostra su un tablet |
| Fatture e pagamenti | [Crea link di pagamento](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Crea un link di pagamento online per ciò che è ancora aperto |
| Fatture e pagamenti | [Richiedi mandato SEPA](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Chiede a un cliente di firmare un mandato, oppure invia un promemoria |
| Fatture e pagamenti | [Incassa con addebito diretto](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Incassa ciò che è aperto con il mandato attivo del cliente |
| Fatture e pagamenti | [Fattura i consumi](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Fattura i consumi dei contatori ancora aperti di un cliente |
| Fatture e pagamenti | [Bozza fattura di proroga](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Crea una fattura in bozza che prolunga un'occupazione |
| Accesso e dispositivi | [Crea metodo di accesso](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Dà a un cliente accesso con codice QR, targa, PIN o NFC |
| Accesso e dispositivi | [Aggiorna accesso](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Blocca, sblocca o prolunga i mezzi di accesso |
| Accesso e dispositivi | [Invia o stampa codice QR](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Invia un codice QR di accesso al cliente o lo stampa |
| Accesso e dispositivi | [Apri o chiudi sbarra](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Apre o chiude una sbarra o un cancello |
| Accesso e dispositivi | [Commuta corrente](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Accende o spegne la corrente di un contatore intelligente |
| Accesso e dispositivi | [Aggiorna tag NFC](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Blocca, sblocca o ricarica i tag NFC di un cliente |
| Accesso e dispositivi | [Controlla tablet o kiosk](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Risveglia un tablet o un chiosco, lo mette in stand-by o lo ricarica |
| Accesso e dispositivi | [Imposta presentazione](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Mette foto su tablet e chioschi, da un elenco o da una richiesta precedente |
| Integrazioni | [Invia webhook](/automatiseringen/acties/integraties#webhook-versturen) | Consegna un messaggio proprio a uno dei tuoi endpoint webhook |
| Integrazioni | [Richiesta API](/automatiseringen/acties/integraties#api-verzoek) | Chiama la Tillor API o un altro sito web |

In tutti i campi di testo puoi usare le [variabili](/automatiseringen/variabelen), come `{invoice.displayId}`. In alto a destra di ogni campo c'è un pulsante **Variabile** per inserirne una. I campi in cui viene richiesto un cliente, una fattura o un altro record si aspettano l'id interno di quel record, come `{invoice.id}`. Un numero di fattura o un nome quindi non funziona.

## Uscite di un'azione [#uitgangen-van-een-actie]

Sotto un passaggio ci sono una o più uscite. Colleghi ogni uscita a un passaggio successivo. Se lasci un'uscita non collegata, l'esecuzione termina lì.

| Uscita | In quali azioni | Quando |
|---|---|---|
| **Avanti** | La maggior parte delle azioni | Il passaggio è riuscito |
| **Fatto** e **Saltato** | Azioni che a volte non hanno nulla da fare | **Fatto** se il passaggio ha svolto il suo lavoro. **Saltato** se non c'era nulla da fare, ad esempio perché la fattura era già contabilizzata. Non è un errore |
| **Trovata** e **Non trovata** | **Cerca attività** | Se l'attività esiste |
| **Trovata** e **Non trovata** | **Trova documento** | Se il cliente ha un documento di quel tipo |
| **Riuscito** e **Non riuscito** | **Invia webhook** e **Richiesta API** | Se l'altra parte ha accettato il messaggio |

**Fatto** e **Saltato** si trovano in **Scrivi a un ospite**, **Check-in, check-out o annulla**, **Contabilizza fattura**, **Crea link di pagamento**, **Richiedi mandato SEPA**, **Incassa con addebito diretto** e **Fattura i consumi**. Per ciascuna di queste, sotto l'azione è indicato quando un passaggio viene saltato.

### Prosegui se questo passaggio non riesce [#doorgaan-als-deze-stap-mislukt]

Se un'azione va male, l'esecuzione normalmente si ferma con lo stato **Non riuscita**. Se vuoi decidere tu cosa succede, attiva in fondo alle impostazioni del passaggio **Prosegui se questo passaggio non riesce**. Si può fare con ogni azione tranne **Invia webhook** e **Richiesta API**, che hanno già una propria uscita **Non riuscito**.

Il passaggio ottiene allora un'uscita aggiuntiva **Errore**. Se l'azione non riesce, il flusso prosegue tramite **Errore** invece di fermarsi. I passaggi successivi possono usare queste variabili:

| Variabile | Contenuto |
|---|---|
| `{error.message}` | Il messaggio di errore. Può essere in inglese |
| `{error.step}` | Il nome del passaggio non riuscito, come lo hai inserito in **Nome del passaggio** |

Alcune cose da sapere:

- Se l'azione è riuscita o è stata saltata, non cambia nulla e **Errore** non viene usata
- Se lasci **Errore** non collegata, l'esecuzione termina lì senza ulteriori passaggi. L'esecuzione ottiene allora lo stato **Completata**, ma il passaggio stesso compare nella scheda **Esecuzioni** con il suo messaggio di errore
- Un secondo passaggio non riuscito nello stesso flusso sostituisce `{error.message}` e `{error.step}` del primo

Un esempio: lascia proseguire **Scrivi a un ospite** se non riesce e crea tramite **Errore** un'attività con `{error.message}` nella descrizione. Così un collega riprende da sé il contatto con l'ospite.

## Se un passaggio non riesce [#als-een-stap-mislukt]

Ci sono tre modi in cui può andare un fallimento.

- **Un'uscita Non riuscito.** Succede con **Invia webhook** e **Richiesta API** quando l'altra parte restituisce un errore. Il flusso prosegue tramite l'uscita **Non riuscito**. Collegala a un seguito, come un'attività per un collega. Se lasci l'uscita non collegata, l'esecuzione termina lì normalmente
- **Un'uscita Errore.** Se con un'altra azione attivi **Prosegui se questo passaggio non riesce**, il passaggio ottiene un'uscita **Errore** e puoi usare il motivo con `{error.message}`. Vedi [Prosegui se questo passaggio non riesce](#doorgaan-als-deze-stap-mislukt)
- **Il passaggio ferma l'esecuzione.** Se manca un valore dopo la compilazione delle variabili, se una fattura non può essere inviata, se un endpoint non esiste più o se il JSON non è valido, l'esecuzione ottiene lo stato **Non riuscita**. I passaggi successivi non vengono eseguiti e Tillor non riprova il passaggio. Succede solo se non hai attivato **Prosegui se questo passaggio non riesce**

Il messaggio di errore si trova nel passaggio, nella scheda **Esecuzioni**. Questi messaggi possono essere in inglese.

<Callout type="idea" title="Non perdere i fallimenti">
Vuoi che un fallimento non passi mai inosservato? Collega l'uscita **Non riuscito** di una **Richiesta API** o di **Invia webhook**, oppure l'uscita **Errore** di un'altra azione, a un passaggio [Crea attività](/automatiseringen/acties/taken#taak-aanmaken). Così un collega può occuparsene.
</Callout>

## Gruppi [#groepen]

<Cards>
  <Card title="Attività" href="/automatiseringen/acties/taken" description="Creare, cercare e aggiornare attività" />
  <Card title="Ospiti e messaggi" href="/automatiseringen/acties/gasten-en-berichten" description="Messaggi, commenti, inbox e prenotazioni" />
  <Card title="Fatture e pagamenti" href="/automatiseringen/acties/facturen-en-betalingen" description="Promemoria, fatture e pagamenti" />
  <Card title="Accesso e dispositivi" href="/automatiseringen/acties/toegang-en-toestellen" description="Accesso, corrente, NFC e tablet" />
  <Card title="Integrazioni" href="/automatiseringen/acties/integraties" description="Webhook e richieste API" />
</Cards>


# Integrazioni (/it-IT/automatiseringen/acties/integraties)

Questi passaggi si trovano nel gruppo **Integrazioni**. Una consegna non riuscita prosegue tramite **Non riuscito**. Per le altre azioni leggi [Se un passaggio fallisce](/automatiseringen/acties#als-een-stap-mislukt).

## Invia webhook [#webhook-versturen]

Consegna un messaggio personalizzato a uno degli endpoint webhook della tua organizzazione. È utile per avvisare un altro sistema, per esempio il tuo sistema di cassa o il tuo sito web.

| Campo | Cosa inserire |
|---|---|
| **Endpoint** | Scegli uno dei tuoi endpoint webhook. Li riconosci dal loro indirizzo. Obbligatorio |
| **Nome dell'evento** | Il nome che viaggia con il messaggio, così il destinatario può riconoscerlo, per esempio `automation.invoice_unpaid`. Obbligatorio |
| **Payload** | Il contenuto del messaggio, in JSON. Le variabili vengono compilate prima dell'invio. Obbligatorio |

Crei e gestisci gli endpoint dal menu del profilo sotto **Sviluppatori**. L'endpoint deve esistere ed essere attivo. In caso contrario il passaggio fallisce e l'esecuzione si interrompe.

Il messaggio viene firmato con la chiave propria dell'endpoint, esattamente come gli altri webhook che l'endpoint riceve. Tillor riprova alcune volte se il tuo server non risponde correttamente. L'endpoint non deve seguire il nome del tuo evento: il messaggio arriva comunque.

Il passaggio ha due uscite:

| Uscita | Quando |
|---|---|
| **Riuscito** | Il tuo server ha risposto con uno stato di successo |
| **Non riuscito** | La consegna è fallita dopo tutti i tentativi. Il messaggio viene poi riprovato in background, come un normale webhook |

Il modello **Invia le prenotazioni a un altro sistema** usa **Non riuscito** per creare un'attività, così qualcuno se ne occupa.

Un payload ha per esempio questo aspetto:

```json
{
  "reservation": "{reservation.displayId}",
  "checkIn": "{reservation.checkIn}",
  "adults": {reservation.numberOfAdults},
  "customer": {
    "firstName": "{reservation.customer.firstName}",
    "email": "{reservation.customer.email}"
  }
}
```

Metti il testo tra virgolette e i numeri senza. Le date passano in JSON come data e ora internazionali, come `2026-10-05T08:00:00.000Z`. Leggi [Variabili e modelli](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld) per i dettagli. Il lato tecnico, come la struttura del messaggio, è descritto in [Sviluppatori > Automazioni](/ontwikkelaars/automatiseringen).

## Richiesta API [#api-verzoek]

Chiama la Tillor API della tua organizzazione, oppure un altro indirizzo su internet. Con questa puoi fare quasi tutto ciò che fa Tillor e cercare dati per poi farci qualcosa.

In **Invia a** scegli tra **Tillor API** e **URL personalizzato**. In **Metodo** scegli **GET** (richiedere), **POST** (creare), **PUT** o **PATCH** (modificare) oppure **DELETE** (eliminare).

### Tillor API [#tillor-api]

| Campo | Cosa inserire |
|---|---|
| **Percorso** | La parte dell'indirizzo dopo l'API della tua organizzazione, per esempio `/tasks` o `/tasks/{task.id}`. Deve iniziare con `/`. Obbligatorio |
| **Corpo** | I dati che invii, in JSON. Lascia vuoto se non invii nulla |

In cima al campo trovi **Scegli un endpoint API**. Fai clic e cerca nell'elenco, per esempio *tasks*. Quando scegli un endpoint, Tillor compila il metodo e il percorso. Se il **Corpo** è ancora vuoto, ottieni anche un esempio di ciò che l'endpoint si aspetta. Sostituisci i nomi tra parentesi graffe nel percorso con variabili di passaggi precedenti. Se ci sono parametri di query, li vedi sotto il campo.

La chiamata avviene come utente **Flusso di lavoro** e non può mai uscire dalla tua organizzazione. Un'automazione non può gestire automazioni, quindi le chiamate che riguardano automazioni o le loro esecuzioni vengono rifiutate.

### URL personalizzato [#eigen-url]

| Campo | Cosa inserire |
|---|---|
| **URL** | L'indirizzo. Deve iniziare con `https://`. Obbligatorio |
| **Intestazioni** | Dati aggiuntivi per il destinatario, per esempio una chiave. Fai clic su **Aggiungi intestazione** e compila **Nome** e **Valore** |
| **Corpo** | I dati che invii, in JSON. Lascia vuoto se non invii nulla |

Valgono queste regole:

- Gli indirizzi senza `https://` vengono rifiutati
- Gli indirizzi privati e interni vengono rifiutati, anche se un nome normale punta a essi
- I reindirizzamenti non vengono seguiti. Se il server risponde con un reindirizzamento, conta come **Non riuscito**
- Le intestazioni vengono salvate cifrate. Puoi quindi inserirvi una chiave o un token
- Con **GET** e **DELETE** non viene inviato alcun corpo

### Uscite e risposta [#uitgangen-en-antwoord]

La richiesta ha due uscite: **Riuscito** (il server ha risposto con uno stato di successo) e **Non riuscito** (il server ha risposto con uno stato di errore). Se Tillor non raggiunge affatto il server, per esempio per un timeout dopo 15 secondi o un indirizzo rifiutato, l'esecuzione si interrompe con lo stato **Non riuscita**.

Per i passaggi successivi ci sono tre variabili:

| Variabile | Contenuto |
|---|---|
| `{response.status}` | Il codice di stato, per esempio 200 |
| `{response.body}` | La risposta come testo, abbreviata ai primi 4000 caratteri |
| `{response.data}` | La risposta come dati, così puoi estrarne campi con `{response.data.items.0.id}` |

Come usarla è spiegato in [Usare una risposta API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Un esempio completo con una ricerca si trova in [Controllo della casa mobile in affitto](/automatiseringen/voorbeeld-nalopen).


# Attività (/it-IT/automatiseringen/acties/taken)

Con questi passaggi un'automazione crea e aggiorna attività, così un collega se ne occupa. Si trovano nel gruppo **Attività**. Come funzionano le uscite lo leggi in [Uscite di un'azione](/automatiseringen/acties#uitgangen-van-een-actie).

## Come si collega al resto? [#hoe-hangt-dit-samen]

Un'attività di un'automazione è un'attività normale: la trovi nella pagina delle attività, nelle viste a cui appartiene e nel cliente o nel record a cui è collegata.

```mermaid
flowchart LR
  A["Passaggio Crea attività"] --> T["Attività nella pagina delle attività<br/>a nome di Flusso di lavoro"]
  T --> V["Le viste la mostrano<br/>se corrisponde o è nell'elenco"]
  T --> C["Un collega la prende in carico"]
  C -- "Stato o assegnazione cambia" --> E["Un'altra automazione può partire da questo"]
  D["Passaggio Chiedi una decisione"] --> T2["Attività con pulsanti di scelta"]
  T2 -- "Un collega sceglie un pulsante" --> F["L'automazione prosegue tramite quell'opzione"]
```

Altro su ciò che vedono e fanno i colleghi si trova in [Attività](/taken) e [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen).

## Crea attività [#taak-aanmaken]

Crea un'attività nel sistema delle attività. L'attività è a nome di **Flusso di lavoro**.

<DocScreenshot src="/screenshots/taken/automation-task-create-step.png" alt="Automazione con il passaggio Crea attività selezionato e le impostazioni a destra" />


| Campo | Cosa inserire |
|---|---|
| **Titolo** | Il nome dell'attività. Obbligatorio |
| **Descrizione** | Una spiegazione dell'attività |
| **Assegna a** | Scegli uno o più colleghi. Fai clic su un nome per attivarlo o disattivarlo |
| **Assegna a gruppi** | Scegli uno o più [gruppi](/gebruikers/groepen). L'attività vale allora per tutti quelli che in quel momento fanno parte del gruppo |
| **Etichette** | Scegli una o più [etichette](/taken/labels) |
| **Assegna anche a chi ha causato l'evento** | Assegna l'attività anche al collega che ha causato l'evento, per esempio chi ha terminato l'occupazione. Se l'evento è stato causato dal sistema, non viene aggiunto nessuno |
| **Priorità** | **Bassa**, **Media**, **Alta** o **Urgente**. Per impostazione predefinita **Media** |
| **Aggiungi alla bacheca** | Scegli una bacheca su cui compare l'attività, oppure lascia vuoto |
| **Colonna** | Scegli una colonna della bacheca qui sopra. L'elenco mostra le colonne come *[bacheca] · [colonna]* |
| **Sottoattività** | Una sottoattività per riga, oppure esattamente una variabile con un elenco, come `{result}` da [Esegui codice](/automatiseringen/logica#code-uitvoeren) |
| **Scadenza dopo** | Quanti minuti, ore, giorni o settimane dopo l'esecuzione del passaggio cade la scadenza. Con 0 l'attività non ha scadenza. Per impostazione predefinita 1 giorno |
| **Collega ai record** | Collega l'attività ai record qui sotto e al relativo cliente, terreno, fattura, prenotazione o contatore. Attivo per impostazione predefinita |
| **Collega a** | Compare se **Collega ai record** è attivo. Scegli a quali record compare l'attività. In anticipo è selezionato tutto ciò che il passaggio conosce: i record del trigger e ciò che ha trovato un passaggio di ricerca precedente |
| **Solo il flusso può completarla** | I colleghi non possono completare né eliminare l'attività. Più avanti inserisci un passaggio **Elimina attività** o **Imposta stato** per completarla |

Tieni presente:

- Se non scegli nessuno in **Assegna a** o **Assegna a gruppi** e lasci disattivato **Assegna anche a chi ha causato l'evento**, l'attività non ha nessun collega assegnato. **Flusso di lavoro** non viene mai assegnato di per sé
- Le sottoattività hanno lo stesso titolo che inserisci, nessun collega assegnato e nessuna scadenza. Le righe vuote vengono saltate. Puoi usare variabili nelle righe
- Con **Collega a** si tratta di clienti, terreni, fatture, prenotazioni e contatori. Per un'occupazione che termina, l'attività viene quindi collegata per impostazione predefinita al terreno, al cliente e alla prenotazione. Se togli un record dall'elenco, l'attività resta fuori da quello. I record che si aggiungono più tardi al flusso non vengono aggiunti da Tillor da solo una volta che hai modificato tu l'elenco. Se scegli di nuovo tutto, il passaggio torna a seguire tutti i record disponibili
- Se un'attività si trova solo su una bacheca personale, la vedono solo gli interessati. Vedi [Attività private](/taken/prive-taken)

Per i passaggi successivi l'azione fornisce `{createdTask.id}` e `{createdTask.name}`. Con questi puoi per esempio impostare poi lo stato.

Se non vuoi una seconda attività quando ce n'è già una aperta per lo stesso terreno o lo stesso cliente, inserisci prima un passaggio [Cerca attività](#taak-zoeken) e crea l'attività solo tramite **Non trovata**. L'[esempio Controllo della casa mobile in affitto](/automatiseringen/voorbeeld-nalopen) fa così.

Se attivi **Solo il flusso può completarla**, sull'attività compare **Completata dalla sua automazione**. I colleghi non possono completarla né eliminarla.

## Elimina attività [#taak-verwijderen]

Elimina un'attività, per esempio quella creata da questo flusso quando non serve più.

| Campo | Cosa inserire |
|---|---|
| **Attività** | L'id dell'attività. Per impostazione predefinita `{createdTask.id}`. Obbligatorio |

Un'attività già eliminata viene saltata. Il flusso prosegue normalmente.

## Imposta stato [#taakstatus-zetten]

Modifica lo stato di un'attività esistente, per esempio per completarla.

| Campo | Cosa inserire |
|---|---|
| **Attività** | L'id dell'attività. Per impostazione predefinita `{task.id}`. Obbligatorio |
| **Stato** | **In attesa**, **In corso**, **In attesa di risposta** o **Completato**. Per impostazione predefinita **Completato** |

`{task.id}` funziona se l'automazione parte da un evento di un'attività, come `task:created`. Dopo un passaggio **Crea attività** usi `{createdTask.id}`. L'azione fornisce `{updatedTask.id}` e `{updatedTask.status}`.

## Cerca attività [#taak-zoeken]

Cerca un'attività esistente per titolo. Il passaggio ha due uscite: **Trovata** e **Non trovata**. Così puoi aggiornare un'attività se esiste già e altrimenti crearne una nuova.

| Campo | Cosa inserire |
|---|---|
| **Titolo** | Il titolo che l'attività deve avere esattamente, per esempio `Nalopen {occupation.terrain.name}`. Le variabili vengono compilate prima. Obbligatorio |
| **Collegata ai record dell'evento** | Solo attività collegate ad almeno uno degli stessi record, come il terreno o il cliente. Attivo per impostazione predefinita |
| **Solo attività non completate** | Salta le attività completate. Attivo per impostazione predefinita |
| **Salta le sottoattività** | Cerca solo attività principali. Attivo per impostazione predefinita |

Se corrispondono più attività, il passaggio prende la più recente. Se **Collegata ai record dell'evento** è attivo ma l'evento non ha cliente, terreno, fattura, prenotazione o contatore, il flusso passa da **Non trovata**.

Tramite **Trovata** i passaggi successivi possono usare `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` e `{foundTask.status}`.

## Imposta priorità attività [#taakprioriteit-zetten]

Modifica la priorità di un'attività esistente.

| Campo | Cosa inserire |
|---|---|
| **Attività** | L'id dell'attività. Per impostazione predefinita `{foundTask.id}`. Obbligatorio |
| **Modifica** | **Un livello più alto** (predefinito), **Un livello più basso** o **A una priorità fissa** |
| **Priorità** | Solo con **A una priorità fissa**: **Bassa**, **Media**, **Alta** o **Urgente** |
| **Alza fino a** | Solo con **Un livello più alto**: la priorità massima che il passaggio può assegnare. Per impostazione predefinita **Alta**. Un'attività che ha già questa priorità o una più alta resta com'è |

L'ordine è **Bassa**, **Media**, **Alta**, **Urgente**. Un livello più basso si ferma a **Bassa**. Se non cambia nulla, il passaggio riesce comunque senza modificare l'attività. L'azione fornisce `{updatedTask.id}` e `{updatedTask.priority}`.

## Aggiorna attività [#taak-bijwerken]

Modifica un'attività esistente. I campi che lasci vuoti restano come sono.

| Campo | Cosa inserire |
|---|---|
| **Attività** | L'id dell'attività. Per impostazione predefinita `{foundTask.id}`. Obbligatorio |
| **Nuovo titolo** | Il nuovo nome dell'attività. Se vuoto, il titolo resta com'è |
| **Assegnatari** | Scegli uno o più colleghi |
| **Gruppi** | Scegli uno o più [gruppi](/gebruikers/groepen) |
| **Assegna anche a chi ha causato l'evento** | Aggiunge anche il collega che ha causato l'evento. Se l'evento è stato causato dal sistema, non viene aggiunto nessuno |
| **Assegnatari** | **Aggiungi a quelli attuali** (predefinito) oppure **Sostituisci quelli attuali** |
| **Aggiungi etichette** | Scegli una o più [etichette](/taken/labels). Vengono aggiunte, le etichette esistenti restano |
| **Scadenza dopo** | Imposta la scadenza a questo numero di minuti, ore, giorni o settimane dopo l'esecuzione del passaggio. Con 0 la scadenza resta com'è |

Tieni presente:

- Se scegli **Sostituisci quelli attuali** e non indichi nessuno, l'attività resta poi senza nessun assegnatario
- Se l'attività non esiste più, il passaggio fallisce
- L'azione fornisce `{updatedTask.id}`


# Accesso e dispositivi (/it-IT/automatiseringen/acties/toegang-en-toestellen)

Queste azioni riguardano il parco stesso: chi può entrare, quali contatori hanno corrente e cosa fanno i tablet. Vedi [Controllo accessi](/toegangscontrole) per lo sfondo sui metodi di accesso. Come funzionano le uscite lo leggi in [Uscite di un'azione](/automatiseringen/acties#uitgangen-van-een-actie).

## Crea metodo di accesso [#toegangsmiddel-aanmaken]

Dà a un cliente l'accesso tramite codice QR, targa, codice PIN o NFC.

| Campo | Cosa inserire |
|---|---|
| **Cliente** | L'id del cliente, per esempio `{reservation.customerId}`. Obbligatorio |
| **Tipo** | **Codice QR** (predefinito), **Targa**, **Codice PIN** o **NFC** |
| **Valore** | La targa o il numero NFC. Lascia vuoto per un codice QR o un codice PIN, perché li crea Tillor stesso |
| **Valido dal** | Una variabile di data, per esempio `{reservation.checkIn}`. Vuoto significa nessun limite |
| **Valido fino al** | Una variabile di data, per esempio `{reservation.checkOut}`. Vuoto significa nessun limite |

Con **Targa** e **NFC** il **Valore** è obbligatorio. L'azione fornisce `{createdAccessMethod.id}` e `{createdAccessMethod.value}`. Il valore è il codice del codice QR o del codice PIN. Con l'id puoi poi inviare il codice tramite **Invia o stampa codice QR**.

## Aggiorna accesso [#toegang-bijwerken]

Blocca, sblocca o prolunga un metodo di accesso, oppure tutti i metodi di accesso di un cliente.

| Campo | Cosa inserire |
|---|---|
| **Quale** | **Un metodo di accesso** (predefinito) oppure **Tutti quelli di un cliente** |
| **Metodo di accesso** | Solo con **Un metodo di accesso**: l'id, per esempio `{createdAccessMethod.id}`. Obbligatorio |
| **Cliente** | Solo con **Tutti quelli di un cliente**: l'id del cliente, per esempio `{occupation.customerId}`. Obbligatorio |
| **Stato** | **Lascia invariato** (predefinito), **Attivo**, **Bloccato soft**, **Bloccato** o **Inattivo** |
| **Valido fino al** | Una variabile di data. Se vuoto, mantiene la data di fine attuale |

Tieni presente:

- Se lasci **Stato** su **Lascia invariato** e **Valido fino al** vuoto, il passaggio non fa nulla
- Con **Tutti quelli di un cliente**, i metodi di accesso impostati su **Non prolungare automaticamente** mantengono la loro data di fine, come succede anche quando un cliente paga una fattura. Il loro stato cambia invece. Con **Un metodo di accesso** il passaggio modifica invece la data di fine, anche se quel metodo di accesso è impostato su **Non prolungare automaticamente**

## Invia o stampa codice QR [#qr-code-versturen-of-afdrukken]

Invia un codice di accesso QR al cliente, lo stampa, o entrambe le cose.

| Campo | Cosa inserire |
|---|---|
| **Metodo di accesso** | L'id del metodo di accesso. Per impostazione predefinita `{createdAccessMethod.id}`. Obbligatorio |
| **Invia per e-mail** | Attivo per impostazione predefinita |
| **Invia per SMS** | Disattivo per impostazione predefinita |
| **Invia via WhatsApp** | Disattivo per impostazione predefinita |
| **Stampa** | **Non stampare** (predefinito), **Stampante di etichette** o **Stampante per scontrini** |

Se disattivi tutti e tre i canali e scegli **Non stampare**, il passaggio non fa nulla.

## Apri o chiudi sbarra [#slagboom-openen-of-sluiten]

Apre o chiude una sbarra o un cancello.

| Campo | Cosa inserire |
|---|---|
| **Punto di accesso** | Scegli uno dei tuoi punti di accesso. Obbligatorio |
| **Azione** | **Apri** (predefinito) o **Chiudi** |

## Commuta corrente [#stroom-schakelen]

Accende o spegne la corrente di un contatore intelligente. Per esempio per spegnere la corrente quando termina un'occupazione.

| Campo | Cosa inserire |
|---|---|
| **Quali contatori** | **Ogni contatore commutabile di un terreno** (predefinito) oppure **Un contatore** |
| **Terreno** | Solo con **Ogni contatore commutabile di un terreno**: l'id del terreno. Per impostazione predefinita `{occupation.terrainId}`. Obbligatorio |
| **Contatore** | Solo con **Un contatore**: scegli il contatore. Obbligatorio |
| **Corrente** | **Accesa** o **Spenta**. Per impostazione predefinita **Spenta** |

Tieni presente:

- Con **Ogni contatore commutabile di un terreno** il passaggio commuta solo i contatori che possono essere commutati. Se il terreno non ne ha, non succede nulla
- Se la commutazione di un contatore non riesce, il passaggio fallisce. Con **Un contatore** succede lo stesso se il contatore non può essere commutato. I contatori già commutati prima restano commutati

## Aggiorna tag NFC [#nfc-tags-bijwerken]

Aggiorna tutti i [tag NFC](/nfc/nfc-tags) di un cliente.

| Campo | Cosa inserire |
|---|---|
| **Cliente** | L'id del cliente, per esempio `{occupation.customerId}`. L'azione vale per ogni tag NFC di questo cliente. Obbligatorio |
| **Azione** | **Blocca** (predefinito), **Sblocca**, **Ricarica** o **Invia messaggio di saldo basso** |
| **Importo** | Solo con **Ricarica**: l'importo in euro, per tag. Deve essere maggiore di 0. Obbligatorio |

Se il cliente ha due tag e inserisci 20, ogni tag riceve 20 euro in più. Senza tag il passaggio non fa nulla. Con un importo che non è un numero maggiore di 0, il passaggio fallisce.

## Controlla tablet o kiosk [#tablet-of-kiosk-bedienen]

Invia un comando a un [tablet o chiosco](/mobiele-app/tablets-en-kiosken).

| Campo | Cosa inserire |
|---|---|
| **Dispositivo** | Scegli il dispositivo. Obbligatorio |
| **Comando** | **Riattiva** (predefinito), **Sospendi**, **Ricarica**, **Identifica** o **Riproduci suono di prova** |

## Imposta presentazione [#diavoorstelling-instellen]

Imposta la presentazione su ogni tablet e chiosco, oppure su un solo dispositivo. Le altre impostazioni del dispositivo restano. Se la stessa presentazione è già impostata, quel dispositivo viene saltato.

Un trigger orario, poi una [richiesta API](/automatiseringen/acties/integraties#api-verzoek) a un feed di attività, e poi questo passaggio: così sostituisci una sincronizzazione separata. Collega il passaggio all'uscita **Riuscito** della richiesta.

| Campo | Cosa inserire |
|---|---|
| **Dispositivi** | **Ogni tablet e chiosco** (predefinito) oppure **Un solo dispositivo** |
| **Dispositivo** | Solo con **Un solo dispositivo**. Obbligatorio |
| **Modalità** | **Salvaschermo** (predefinito, dopo un periodo senza tocco) oppure **Sfondo** |
| **Secondi per foto** | Per quanto tempo resta una foto. Predefinito 10. Da 3 a 600 |
| **Attesa prima dell'avvio** | Solo con **Salvaschermo**: secondi senza tocco. Predefinito 15 |
| **Adattamento** | **Riempire** o **Adattare** |
| **Foto** | **Da una richiesta precedente** (predefinito) oppure **Indirizzi** |
| **Indirizzi delle immagini** | Solo con **Indirizzi**: un indirizzo https per riga. Obbligatorio |
| **Elenco** | Percorso dell'elenco JSON, senza parentesi graffe. Dopo una richiesta API è `response.data`. Obbligatorio |
| **Campo dell'immagine** | Nome del campo con l'indirizzo https, per esempio `signage_image`. Obbligatorio |
| **Campo dell'id** | Mantiene lo stesso id per la stessa foto, così un elenco invariato non invia un nuovo messaggio al dispositivo |
| **Campo dello stato** e **Stato** | Solo righe in cui quel campo ha questo valore, per esempio `CONFIRMED` |
| **Salta se compilato** | Le righe in cui questo campo ha un valore vengono escluse, per esempio `deleted_at` |
| **Campo della data** e **Campo della data di fine** | Una riga resta finché quel momento non è passato. Se la data di fine è vuota, conta la data |
| **Campo di ordinamento** | Ordina l'elenco in modo crescente, per esempio per `date` |
| **Numero massimo di foto** | Predefinito 5, al massimo 20 |

Un indirizzo che non inizia con `https://` non conta. Se l'elenco non è un array JSON, il passaggio fallisce e la presentazione attuale resta impostata.


# Panoramica (/it-IT/automatiseringen)

Con le automazioni fai in modo che Tillor faccia qualcosa senza che un collega debba ricordarsene. Definisci una regola: *quando succede questo, fai quello*. Alcuni esempi:

- Termina un'occupazione su una casa mobile, quindi Tillor crea un'attività di controllo con sottoattività e la assegna al collega che ha chiuso l'occupazione
- Una fattura è scaduta, quindi Tillor invia un promemoria di pagamento e una settimana dopo crea un'attività per telefonare al cliente se la fattura risulta ancora aperta
- Arriva una nuova prenotazione, quindi Tillor invia i dati al tuo sistema
- Ogni lunedì alle 08:00 Tillor crea un'attività per il controllo settimanale
- Arriva una nuova prenotazione, quindi Tillor crea un codice QR per l'ospite e glielo invia per e-mail

Costruisci un'automazione da solo su una tela, senza codice. Scegli un momento di avvio, aggiungi dei passaggi e li colleghi con delle linee.

## In parole semplici [#in-gewone-woorden]

Un'automazione ha tre tipi di elementi. I dettagli tecnici ti servono solo quando ne hai bisogno.

- **Il momento di avvio (trigger)** è il "quando". Succede qualcosa in Tillor, come la fine di un'occupazione, oppure scatta un certo orario o una certa data. Vedi [Trigger](/automatiseringen/triggers)
- **La logica** è il "se". Qui il flusso guarda i dati e sceglie una strada, oppure aspetta che succeda qualcosa. Un esempio: *la fattura non è ancora pagata dopo una settimana?* Vedi [Condizioni, smistamenti e ritardi](/automatiseringen/logica)
- **Le azioni** sono il "allora fai". Creare un'attività, inviare un messaggio, registrare una fattura. Vedi [Azioni](/automatiseringen/acties)

Inoltre, le **variabili** sono i dati del momento stesso, come il nome del terreno o del cliente. Le metti tra parentesi graffe in un testo e Tillor inserisce il valore reale. Vedi [Variabili e modelli](/automatiseringen/variabelen).

## Chi può usarle [#wie-kan-het-gebruiken]

<Callout type="warn" title="Solo per gli amministratori">
Le automazioni lavorano con tutti i permessi nella tua organizzazione. Per visualizzarle serve il permesso **Visualizza automazioni**, per crearle e modificarle **Gestisci automazioni**. Gli amministratori con **Tutti i permessi** hanno entrambi. Vedi [Chi può usare le automazioni?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken).
</Callout>

Trovi la pagina nel menu laterale in <UIPath>Amministratore > Automazioni</UIPath>.

## Come si collega al resto? [#hoe-hangt-dit-samen]

Ogni automazione è composta da passaggi che colleghi in un flusso. Un'automazione lavora insieme alle attività: crea attività, aspetta che un collega scelga un pulsante oppure parte quando un'attività cambia. Vedi [Attività](/taken#hoe-hangt-dit-samen). Ogni volta che un'automazione parte, parliamo di un'esecuzione. Un'esecuzione inizia dal momento di avvio e segue le linee verso il basso.

| Elemento | Cosa fa |
|---|---|
| **Quando succede questo** (trigger) | Il momento di avvio. Un evento in Tillor, un webhook, un'azione scelta su un'attività, una fattura scaduta, una data come l'arrivo di un ospite, un orario fisso o una pianificazione personalizzata. Un flusso può avere più trigger. Ogni trigger avvia un'esecuzione propria |
| **Solo quando** | Un filtro sul trigger. L'automazione parte solo se i dati corrispondono, per esempio solo per le case mobili |
| **Se / altrimenti** | Divide il flusso in **Sì** e **No** in base a una o più condizioni |
| **Smista** | Divide il flusso in più rami, a seconda del valore di un campo |
| **Ritardo** e altri passaggi di attesa | Fanno attendere il flusso, fino a un'ora, una data, gli orari di apertura, una condizione, un evento o la decisione di un collega |
| **Aperto ora?**, **Cerca un record**, **Per ogni** | Controllano se sei aperto, recuperano un record o eseguono i passaggi successivi per ogni elemento di un elenco |
| **Azioni** | Fanno davvero qualcosa: attività, messaggi a ospiti e colleghi, fatture, pagamenti e mandati, accessi, contatori e dispositivi, webhook e richieste API |

I passaggi con più uscite, come **Sì** e **No**, **Fatto** e **Saltato** oppure **Riuscito** e **Non riuscito**, ti permettono di scegliere un seguito diverso per ogni esito. Per ogni azione puoi anche attivare un'uscita **Errore**, così il flusso prosegue se il passaggio fallisce.

```mermaid
flowchart TD
  A["Quando succede questo<br/>La fattura è scaduta"] --> B["Invia promemoria di pagamento"]
  B --> C["Ritardo<br/>7 giorni"]
  C --> D{"Se / altrimenti<br/>non ancora pagata?"}
  D -- Sì --> E["Crea attività<br/>telefonare al cliente"]
  D -- No --> F["Fine"]
```

## Variabili [#variabelen]

I campi di testo di un passaggio accettano variabili tra parentesi graffe, come `{occupation.terrain.name}`. Tillor inserisce il nome del terreno legato all'evento. Così crei messaggi e attività diversi caso per caso. Leggi di più in [Variabili e modelli](/automatiseringen/variabelen).

## Per iniziare subito [#snel-aan-de-slag]

1. Vai su **Amministratore > Automazioni** e fai clic su **Nuova automazione**
2. Scegli un modello oppure **Parti da zero**
3. Imposta il trigger e i passaggi e fai clic su **Salva**
4. Prova il flusso nella scheda **Esecuzione di prova**. In questo caso non viene inviato né creato nulla di reale
5. Attiva **Attivo** quando sei soddisfatto

La nuova automazione resta in pausa finché non la attivi tu. Una spiegazione passo per passo si trova in [Per iniziare](/automatiseringen/aan-de-slag).

<Callout type="info" title="Da sapere">
- Una nuova automazione resta in pausa finché non la attivi tu
- Un'automazione ha al massimo 100 passaggi. Le note e i riquadri sulla tela contano a parte, al massimo 50
- Uno **Smista** ha al massimo 8 rami e **Chiedi una decisione** al massimo 8 opzioni
- Le pianificazioni e le date vengono controllate ogni minuto. Un evento fa partire l'automazione subito
- Le modifiche possono richiedere mezzo minuto prima di valere ovunque
- Un'esecuzione non riuscita viene inviata per e-mail a chi ha creato l'automazione, al massimo una volta all'ora
- Nella scheda **Esecuzioni** compaiono le ultime 20 esecuzioni
- Un flusso non può avviare se stesso o un altro flusso tramite ciò che crea lui stesso
</Callout>

<Callout type="info" title="Le automazioni fanno davvero qualcosa">
Un'automazione attivata invia promemoria reali e crea attività reali. Usa la scheda **Esecuzione di prova** e controlla le prime esecuzioni nella scheda **Esecuzioni** prima di essere sicuro che tutto sia corretto.
</Callout>

## Sezioni [#onderdelen]

<Cards>
  <Card
    title="Per iniziare"
    href="/automatiseringen/aan-de-slag"
    description="La panoramica, i modelli e l'editor, e come salvare e attivare un'automazione"
  />
  <Card
    title="Trigger"
    href="/automatiseringen/triggers"
    description="Eventi, date, fatture scadute e pianificazioni, più filtri e avvio una tantum"
  />
  <Card
    title="Condizioni, smistamenti e ritardi"
    href="/automatiseringen/logica"
    description="Dividere e far attendere il flusso, cercare record, scorrere elenchi e chiedere una decisione"
  />
  <Card
    title="Azioni"
    href="/automatiseringen/acties"
    description="Tutto ciò che può fare un'automazione, con tutti i campi"
  />
  <Card
    title="Variabili e modelli"
    href="/automatiseringen/variabelen"
    description="Usare i dati dell'evento nei tuoi testi"
  />
  <Card
    title="Chi esegue un'automazione?"
    href="/automatiseringen/workflow-gebruiker"
    description="Perché le attività e i commenti di un'automazione compaiono a nome di un utente di sistema fisso"
  />
  <Card
    title="Test ed esecuzioni"
    href="/automatiseringen/testen-en-uitvoeringen"
    description="Fare un'esecuzione di prova e rivedere le esecuzioni reali"
  />
  <Card
    title="Problemi e attivazione"
    href="/automatiseringen/problemen"
    description="Perché un'automazione non si può attivare e cosa significano le segnalazioni"
  />
  <Card
    title="Esempio: controllo della casa mobile in affitto"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Costruire un flusso completo passo per passo"
  />
  <Card
    title="Domande frequenti"
    href="/automatiseringen/veelgestelde-vragen"
    description="Limiti, spiegazioni sulla pausa e cosa fare se non succede nulla"
  />
  <Card
    title="Per gli sviluppatori"
    href="/ontwikkelaars/automatiseringen"
    description="La richiesta API, la busta del webhook, la firma e la gestione tramite API"
  />
</Cards>

<Cards>
  <Card title="Esempi dalla pratica" href="/praktijk" description="Esempi concreti dalla pratica" />
</Cards>

## Termini [#begrippen]

- **Automazione**: una regola del tipo "quando succede questo, fai quello", costruita come flusso
- **Flusso**: la tela di una singola automazione, con passaggi e linee
- **Trigger**: il momento di avvio di un flusso
- **Esecuzione**: una singola volta in cui un'automazione parte e percorre il flusso
- **Azione**: un passaggio che fa davvero qualcosa, come creare un'attività
- **Variabile**: un dato del momento, tra parentesi graffe in un testo
- **Esecuzione di prova**: una prova in cui non viene inviato né creato nulla di reale
- **Flusso di lavoro** (Workflow): l'utente a nome del quale lavora un'automazione

Altri termini si trovano nel [glossario](/begrippen).


# Condizioni, smistamenti e ritardi (/it-IT/automatiseringen/logica)

Con i passaggi del gruppo **Logica** decidi in quale direzione va un flusso e quando: il "se" e il "aspetta un momento". Un esempio: *se dopo una settimana la fattura è ancora aperta, crea un'attività*. Questi passaggi guidano le azioni successive. Solo [Chiedi una decisione](#vraag-om-een-beslissing) crea qualcosa da sé, un'attività.

| Passaggio | Cosa fa | Uscite |
|---|---|---|
| [Se / altrimenti](#als--anders) | Divide in base a condizioni | **Sì**, **No** |
| [Smista](#schakel) | Sceglie un ramo in base al valore di un campo | Una per ramo e **Predefinito** |
| [Ritardo](#vertraging) | Attende un tempo fisso o fino a una data | **Avanti** |
| [Aperto ora?](#nu-open) | Controlla se in questo momento sei aperto | **Aperto**, **Chiuso** |
| [Attendi l'apertura](#wachten-tot-open) | Attende il prossimo orario di apertura | **Avanti** |
| [Attendi la chiusura](#wachten-tot-gesloten) | Attende il prossimo orario di chiusura | **Avanti** |
| [Al massimo una volta per periodo](#hoogstens-één-keer-per-periode) | Blocca le ripetizioni | **Continua**, **Già eseguito** |
| [Cerca un record](#record-opzoeken) | Recupera un record con il suo ID | **Trovata**, **Non trovata** |
| [Per ogni](#voor-elk) | Esegue i passaggi successivi per ogni elemento di un elenco | **Per ogni**, **Completato** |
| [Attendi finché](#wachten-tot) | Attende finché le condizioni sono soddisfatte | **Soddisfatto**, **Scaduto** |
| [Attendi un evento](#wachten-op-een-gebeurtenis) | Attende che in Tillor succeda qualcosa | **Ricevuto**, **Scaduto**, a volte **Eliminato** |
| [Chiedi una decisione](#vraag-om-een-beslissing) | Fa scegliere a un collega tra le tue opzioni | Una per opzione e **Scaduto** |

## Se / altrimenti [#als--anders]

Divide il flusso in due strade in base ai dati. Il principio è lo stesso del filtro **Solo quando** del trigger, ma qui è a metà del flusso.

Il passaggio ha due uscite: **Sì** (le condizioni sono soddisfatte) e **No** (non lo sono).

1. Aggiungi un passaggio **Se / altrimenti**
2. In **Condizioni** fai clic su **Aggiungi condizione**
3. Scegli il campo con il pulsante **Variabile**, oppure digita tu il percorso, per esempio `invoice.paymentStatus`
4. Scegli il confronto (**è**, **non è**, **contiene**, **è maggiore di**, **è minore di**, **è uno tra**, **è vuoto** o **non è vuoto**) e inserisci il valore
5. Collega l'uscita **Sì** ed eventualmente **No** a un passaggio successivo

Un passaggio **Se / altrimenti** ha bisogno di almeno una condizione. Altrimenti Tillor segnala **Aggiungi una condizione.** Con più condizioni scegli tra **Devono corrispondere tutte** e **Ne basta una**. I confronti funzionano come descritto in [Solo quando](/automatiseringen/triggers#alleen-wanneer).

Non devi collegare entrambe le uscite. Se un'uscita non porta da nessuna parte, l'esecuzione finisce lì. Un flusso che fa qualcosa solo con **Sì** va quindi benissimo.

Puoi usare anche i campi dei passaggi precedenti. Dopo una [Richiesta API](/automatiseringen/acties/integraties#api-verzoek) puoi per esempio controllare `response.status` o `response.data.paymentStatus`.

## Smista [#schakel]

Scegli **Smista** quando ti servono più di due strade. Il passaggio guarda il valore di un campo e sceglie il ramo corrispondente.

1. In **Campo** scegli il campo da controllare, per esempio `occupation.occupationType`
2. In **Rami** fai clic su **Aggiungi ramo**. Compila **Ramo** (il nome che appare sull'uscita) e **Uguale a** (il valore che il campo deve avere)
3. Ripeti per ogni ramo
4. Collega ogni uscita a un passaggio successivo

Ogni ramo ha una propria uscita sotto il passaggio. In più c'è sempre un'uscita **Predefinito**, usata quando nessun ramo corrisponde.

- Il campo deve corrispondere esattamente al valore, maiuscole incluse
- Se corrisponde più di un ramo, vince il primo dell'elenco
- Un ramo senza valore in **Uguale a** non conta
- Puoi impostare al massimo 8 rami, più **Predefinito**
- Se il campo è vuoto o non esiste, il flusso passa da **Predefinito**

I valori dei campi a scelta sono nella notazione di Tillor. Un'occupazione di tipo caravan a noleggio ha per esempio il valore `RENTAL_CARAVAN`, una fattura pagata `PAID`.

<Callout type="info">
L'elenco in **Campo** mostra i campi dell'evento e dei passaggi precedenti. I campi della risposta di una richiesta API compaiono nell'elenco solo quando Tillor conosce un esempio di quella risposta. Vedi [Usare una risposta API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).
</Callout>

## Ritardo [#vertraging]

Con **Ritardo** fai attendere il flusso prima che prosegua. Lo usi per cose come *riguardare tra una settimana*.

In **Attendi** scegli uno dei due modi.

### Per un tempo fisso [#een-vaste-tijd]

Scegli **Per un tempo fisso** e in **Durata** inserisci un numero e un'unità: **secondi**, **minuti**, **ore**, **giorni** o **settimane**. I secondi non sono esatti. Il flusso può proseguire qualche secondo più tardi.

Un ritardo di 0 non fa nulla, perciò Tillor segnala **Un ritardo di 0 non fa nulla.**

### Fino a una data [#tot-een-datum]

Scegli **Fino a una data** quando il tempo di attesa dipende da una data presente nei dati, come la scadenza di una fattura o la data di fine di una prenotazione.

| Campo | Cosa inserisci |
|---|---|
| **Data** | Un campo con una data, per esempio `invoice.dueDate`. L'elenco mostra solo i campi che sono una data |
| **Rispetto a quella data** | **Prima** o **Dopo** |
| **Scarto** | Quanto tempo prima o dopo quella data, in minuti, ore, giorni o settimane. Con 0 il flusso prosegue esattamente in quella data |

Esempi:

- **Data** `invoice.dueDate`, **Dopo**, **Scarto** 1 giorno: il flusso prosegue un giorno dopo la scadenza
- **Data** `reservation.checkIn`, **Prima**, **Scarto** 2 giorni: il flusso prosegue due giorni prima dell'arrivo

Se quel momento è già passato, o la data è vuota, il flusso prosegue subito.

### Cosa succede durante l'attesa [#wat-er-tijdens-het-wachten-gebeurt]

- L'esecuzione ottiene lo stato **In attesa**. Nella scheda **Esecuzioni** vedi quando prosegue (**Riprende …**). Le attese lunghe, come le settimane, non sono un problema
- Dopo il ritardo Tillor rilegge i dati, così i passaggi successivi vedono la situazione attuale. Vedi sotto
- Se metti in pausa l'automazione durante l'attesa, l'esecuzione si ferma appena il tempo di attesa è finito. Non prosegue e ottiene lo stato **Annullata**. Se riattivi l'automazione prima che il tempo di attesa sia finito, l'esecuzione prosegue normalmente
- Se elimini l'automazione, le esecuzioni in attesa si interrompono
- Se modifichi il flusso mentre un'esecuzione è in attesa, quell'esecuzione termina con il flusso com'era quando è partita

### I dati vengono riletti [#gegevens-worden-opnieuw-gelezen]

Un'esecuzione ricorda i dati del momento dell'evento, ma rilegge i record collegati prima di proseguire. Sono il record dell'evento (per esempio la fattura) e i record a cui rimanda (per esempio il cliente).

Un esempio: un'automazione invia un promemoria per una fattura, attende 7 giorni e poi controlla con **Se / altrimenti** che `invoice.paymentStatus` non sia `PAID`. Se la fattura è stata pagata in quella settimana, la condizione vede la fattura pagata e il flusso passa da **No**.

Ci sono due eccezioni:

- Se il record non esiste più, per esempio perché un'occupazione è stata eliminata, l'esecuzione tiene la copia del momento dell'evento
- I dati prodotti da un passaggio precedente, come la risposta di una richiesta API, non vengono recuperati di nuovo. Se vuoi quei dati aggiornati dopo un ritardo, fai una nuova richiesta API

<Callout type="info" title="In una prova non viene riletto nulla">
Un'[esecuzione di prova](/automatiseringen/testen-en-uitvoeringen) salta i ritardi e lavora con i dati di esempio che inserisci tu. Cosa succede dopo un vero ritardo lo vedi solo in un'esecuzione reale.
</Callout>

## Aperto ora? [#nu-open]

Controlla se la tua organizzazione è aperta in questo momento e divide il flusso in **Aperto** e **Chiuso**. Non c'è nulla da impostare. Tillor usa gli orari in **Impostazioni > Orari di apertura**, con periodi stagionali, festività ed eccezioni. Vedi [Impostazioni dell'organizzazione](/gebruikers/organisaties#openingsuren).

Usalo per esempio per inviare un testo diverso o creare un'attività fuori orario. Se preferisci aspettare di essere di nuovo aperto, usa [Attendi l'apertura](#wachten-tot-open). Se vuoi aspettare la chiusura, usa [Attendi la chiusura](#wachten-tot-gesloten).

## Attendi l'apertura [#wachten-tot-open]

Mette in pausa il flusso fino al prossimo orario di apertura e poi prosegue. La tua organizzazione è già aperta? Allora il flusso prosegue subito. Non c'è nulla da impostare.

- L'orario di apertura viene da **Impostazioni > Orari di apertura**, nel fuso orario della tua organizzazione
- Se nel prossimo mese non c'è nessun orario di apertura, il flusso prosegue subito invece di restare in attesa
- Durante l'attesa l'esecuzione ottiene lo stato **In attesa**. Cosa succede in quel momento è descritto in [Ritardo](#wat-er-tijdens-het-wachten-gebeurt)

## Attendi la chiusura [#wachten-tot-gesloten]

Mette in pausa il flusso fino al prossimo orario di chiusura e poi prosegue. La tua organizzazione è già chiusa? Allora il flusso prosegue subito. Non c'è nulla da impostare.

- L'orario di chiusura viene da **Impostazioni > Orari di apertura**, nel fuso orario della tua organizzazione
- I blocchi consecutivi, come 9:00–12:00 e 12:00–17:00, contano come un unico tratto. Il flusso attende la fine di quel tratto
- Durante l'attesa l'esecuzione ottiene lo stato **In attesa**. Cosa succede in quel momento è descritto in [Ritardo](#wat-er-tijdens-het-wachten-gebeurt)

## Al massimo una volta per periodo [#hoogstens-één-keer-per-periode]

Lascia passare il flusso solo se per lo stesso record non ha ancora superato questo passaggio nel periodo indicato. In questo modo non invii ogni giorno lo stesso promemoria a un cliente.

| Campo | Cosa inserisci |
|---|---|
| **Periodo** | Per quanto tempo contano le esecuzioni precedenti, in minuti, ore, giorni o settimane. Predefinito 1 giorno |
| **Per** | Su cosa conti. Vuoto significa per record con cui è partito il flusso, come la fattura o la prenotazione. Inserisci una variabile, per esempio `{customer.id}`, per contare per cliente o per area |

Il passaggio ha due uscite: **Continua** se nel periodo il flusso non è ancora passato di qui, e **Già eseguito** se invece è già passato. Collega **Già eseguito** a un altro passaggio, oppure lascialo vuoto così l'esecuzione finisce lì.

Tieni presente che:

- Contano solo le esecuzioni della stessa automazione, e solo se sono passate da questo passaggio tramite **Continua**
- Se non colleghi **Eliminato** a nulla, Tillor ferma i flussi in attesa di quel record ed elimina le attività che il flusso ha creato e che solo il flusso poteva completare. Se colleghi l'uscita, il flusso prosegue da lì
- Se il flusso parte senza record, per esempio con **Ogni giorno a un'ora**, inserisci tu una variabile in **Per**. Senza quel valore ogni esecuzione è nuova e il passaggio non blocca nulla
- L'esecuzione in corso non conta a sua volta

Un esempio: **Periodo** 7 giorni e **Per** `{invoice.customerId}` lasciano passare al massimo un promemoria alla settimana per cliente, anche se quel cliente ha più fatture scadute.

## Cerca un record [#record-opzoeken]

Carica un record in base al suo ID, così i passaggi successivi possono usarne i campi. È utile quando l'evento fornisce solo un ID, come il messaggio in una conversazione della inbox.

| Campo | Cosa inserisci |
|---|---|
| **Tipo di record** | **Cliente**, **Prenotazione**, **Occupazione**, **Fattura**, **Pagamento**, **Terreno**, **Attività**, **Documento**, **Mezzo di accesso**, **Tag NFC**, **Contatore**, **Conversazione della inbox** o **Messaggio della inbox**. Predefinito **Messaggio della inbox** |
| **ID** | L'ID del record, per esempio `{messageId}`. Obbligatorio |

Il passaggio ha due uscite: **Trovata** e **Non trovata**. Se il record non esiste o l'ID è vuoto, il flusso passa da **Non trovata**.

Dopo **Trovata** i campi del record sono in variabili che iniziano con `found` seguito dal tipo: `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Gli altri tipi si chiamano `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` e `foundInboxThread`. Ci sono anche i record a cui rimanda, un livello più in profondità, come `{foundReservation.customer.firstName}`. Trovi tutto nell'elenco dietro il pulsante **Variabile**.

Una seconda ricerca dello stesso tipo sostituisce la prima. Attenzione con **Attività**: usa lo stesso nome `foundTask` di [Cerca attività](/automatiseringen/acties/taken#taak-zoeken), e vince l'ultimo dei due. Lo stesso vale per **Documento** e `foundDocument` di [Trova documento](/automatiseringen/acties/documenten#document-zoeken).

## Mappa variabili [#variabelen-mappen]

Copia valori in nuovi nomi di variabile, così i passaggi successivi possono usare un'unica forma. È comodo quando un flusso parte sia con **Webhook in entrata** (`{body.…}`) sia con **Fattura scaduta** (`{invoice.…}`).

| Campo | Cosa inserisci |
|---|---|
| **Mapping** | Righe con **Variabile destinazione** (es. `invoice`) e **Fonte** (es. `{foundInvoice}` o `{body.invoiceId}`) |

Il passaggio ha un'uscita: **Avanti**. Se la fonte è esattamente una variabile tra parentesi graffe, per esempio `{foundInvoice}`, Tillor copia l'intero record (oggetto). Altrimenti Tillor compila la fonte come testo, come `Fattura {foundInvoice.displayId}` in `meta.label`.

Un test tipico con webhook: **Webhook in entrata** → **Cerca un record** (Fattura, ID `{body.invoiceId}`) → **Mappa variabili** (`invoice` ← `{foundInvoice}`) → le stesse condizioni e la stessa approvazione del trigger schedule.

## Esegui codice [#code-uitvoeren]

Esegue un pezzo di TypeScript sulle variabili del flusso e conserva ciò che restituisce come nuova variabile. Serve per la logica che non entra in campi e condizioni: quali sottoattività devono comparire, calcolare un importo o una data, rimodellare il corpo di un webhook.

| Campo | Cosa inserisci |
|---|---|
| **Codice** | TypeScript. Le variabili si scrivono come nei testi, con le parentesi graffe: `{customer.firstName}` viene letta come valore, non inserita come testo. Chiudi con `return`. Obbligatorio |
| **Variabile di output** | Il nome con cui i passaggi successivi leggono il risultato, come `result` (poi `{result}`) o `result.names`. Predefinito `result` |

Il passaggio ha un'uscita: **Avanti**. Funziona così:

- Il codice vede solo le variabili che nomina. Una variabile che il flusso non ha è `null`; una data arriva come testo (`2026-07-01T10:00:00.000Z`)
- Formattazioni e spostamenti di data (`{bedrag|currency}`, `{datum + 1 day}`) qui non funzionano: calcolali nel codice
- Restituisci un elenco, un testo, un numero o un oggetto. Un oggetto lo leggi poi campo per campo: `{result.total}`
- Il codice non può recuperare né inviare nulla: niente internet, niente database. Si limita a calcolare. Se calcola troppo a lungo (più di 50 ms) viene interrotto
- Se il codice genera un errore, l'esecuzione si ferma con quell'errore e il numero di riga. Li vedi nella scheda **Esecuzioni**
- A destra del codice vedi subito cosa restituisce sull'esempio; durante la prova viene eseguito anche lui

Un esempio: dopo la partenza vuoi sottoattività che dipendono dal terreno. Metti un passaggio **Esegui codice** con:

```ts
const tasks = ["Plaats vegen", "Sanitair"];
if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren");
return tasks;
```

Poi in **Crea attività** compila il campo **Sottoattività** solo con `{result}`: ogni testo dell'elenco diventa una sottoattività.

## Per ogni [#voor-elk]

Esegue i passaggi dopo **Per ogni** una volta per ogni elemento di un elenco, per esempio per ogni fattura aperta di un cliente. Il flusso stesso prosegue da **Completato**.

| Campo | Cosa inserisci |
|---|---|
| **Elenco** | **Metodi di accesso di un cliente**, **Tag NFC di un cliente**, **Fatture aperte di un cliente**, **Prenotazioni confermate di un cliente**, **Occupazioni di un cliente**, **Documenti di un cliente** (solo quelli attivi) o **Contatori di un terreno**. Predefinito **Metodi di accesso di un cliente** |
| **Da** | Il cliente o il terreno di cui vuoi l'elenco, per esempio `{customer.id}` o `{occupation.terrainId}`. Obbligatorio |

Il passaggio ha due uscite con un significato proprio:

- **Per ogni** porta ai passaggi che vuoi eseguire per ogni elemento
- **Completato** è la strada con cui prosegue il flusso stesso

Funziona così:

- Ogni elemento ha una propria esecuzione, che percorre i passaggi dopo **Per ogni** fino alla fine di quel ramo. Le vedi nella scheda **Esecuzioni**, che mostra solo le ultime 20
- L'elemento è nella variabile `item`, per esempio `{item.id}`. Le variabili dell'evento e dei passaggi precedenti restano disponibili
- Il flusso non aspetta che gli elementi siano finiti. Subito dopo averli avviati, prosegue da **Completato**. Il risultato di un elemento non puoi quindi usarlo nei passaggi dopo **Completato**
- Vengono elaborati al massimo 100 elementi, i più vecchi per primi. Se nell'elenco ce ne sono di più, gli altri non vengono elaborati
- Se l'elenco è vuoto o il campo **Da** è vuoto, non parte nulla e il flusso prosegue subito da **Completato**
- Le **Fatture aperte di un cliente** sono fatture contabilizzate di cui è ancora aperto qualcosa. Le **Prenotazioni confermate di un cliente** sono prenotazioni con lo stato **Prenotato**

Un esempio: una fattura scade e vuoi creare un link di pagamento per ogni fattura aperta di quel cliente. Scegli **Fatture aperte di un cliente**, inserisci `{invoice.customerId}` in **Da** e dopo **Per ogni** metti un passaggio **Crea link di pagamento** con `{item.id}` come fattura.

## Attendi finché [#wachten-tot]

Controlla le condizioni ogni volta di nuovo finché sono soddisfatte, oppure si ferma dopo un certo tempo. Usalo quando non sai quando succederà qualcosa ma sai cosa aspetti, per esempio che una fattura sia pagata.

| Campo | Cosa inserisci |
|---|---|
| **Finché** | Una o più condizioni, nello stesso modo di [Se / altrimenti](#als--anders) |
| **Controlla ogni** | Ogni quanto Tillor ricontrolla, in minuti, ore, giorni o settimane. Almeno 5 minuti. Predefinito 1 ora |
| **Smetti di attendere dopo** | Per quanto tempo al massimo il passaggio attende. Predefinito 7 giorni |

Il passaggio ha due uscite: **Soddisfatto** (le condizioni sono soddisfatte) e **Scaduto** (il tempo di attesa è finito senza che lo fossero).

Tieni presente che:

- Il primo controllo avviene subito. Se le condizioni sono già soddisfatte, il flusso prosegue direttamente da **Soddisfatto**. Se non hai inserito nessuna condizione, è sempre soddisfatta
- A ogni controllo Tillor rilegge i record dell'evento, come per un [ritardo](#gegevens-worden-opnieuw-gelezen). Una condizione come `invoice.paymentStatus` è `PAID` vede quindi il pagamento non appena c'è
- Un intervallo inferiore a 5 minuti diventa 5 minuti
- Durante l'attesa l'esecuzione ottiene lo stato **In attesa**. Per mettere in pausa e modificare il flusso vale lo stesso di [Ritardo](#wat-er-tijdens-het-wachten-gebeurt)

## Attendi un evento [#wachten-op-een-gebeurtenis]

Mette in pausa il flusso finché in Tillor succede qualcosa, per esempio che la fattura sia pagata.

| Campo | Cosa inserisci |
|---|---|
| **Evento** | Quello che aspetti. Lo stesso elenco del [trigger](/automatiseringen/triggers#als-er-iets-gebeurt). Obbligatorio |
| **Solo per lo stesso record** | Prosegue solo se l'evento riguarda il record con cui è partito il flusso. Predefinito attivo |
| **Smetti di attendere dopo** | Per quanto tempo al massimo il passaggio attende. Predefinito 7 giorni |

Il passaggio ha due uscite: **Ricevuto** (l'evento è arrivato) e **Scaduto** (il tempo di attesa è finito senza evento). Se **Solo per lo stesso record** è attivo, si aggiunge una terza uscita, **Eliminato**. La usi quando il record del flusso è stato eliminato mentre il flusso attendeva.

Tieni presente che:

- Con **Solo per lo stesso record** attivo conta per esempio solo il pagamento della fattura con cui è partito il flusso. Se lo disattivi, ogni evento di quel tipo fa proseguire il flusso
- Se non colleghi **Eliminato** a nulla, Tillor ferma i flussi in attesa di quel record ed elimina le attività che il flusso ha creato e che solo il flusso poteva completare. Se colleghi l'uscita, il flusso prosegue da lì
- Se il flusso parte senza record, per esempio con **Ogni giorno a un'ora**, conta ogni evento di quel tipo
- Conta anche un evento causato da un passaggio di un'automazione stessa. I flussi in attesa proseguono quindi anche per il lavoro di **Flusso di lavoro**
- Dopo **Ricevuto** i dati dell'evento che aspettavi sono nelle variabili, senza il collega che lo ha causato. Se aspetti `invoice:paid`, `{invoice.paymentStatus}` dà poi il nuovo stato
- Durante l'attesa l'esecuzione ottiene lo stato **In attesa**. Per mettere in pausa e modificare il flusso vale lo stesso di [Ritardo](#wat-er-tijdens-het-wachten-gebeurt)

## Chiedi una decisione [#vraag-om-een-beslissing]

Crea un'attività con pulsanti che definisci tu e attende che qualcuno scelga un pulsante. Così inserisci un momento in cui una persona controlla, per esempio prima che il flusso blocchi un cliente o contabilizzi una fattura. Ogni opzione è un pulsante sull'attività e un'uscita del passaggio.

| Campo | Cosa inserisci |
|---|---|
| **Titolo dell'attività** | Il titolo dell'attività. Obbligatorio |
| **Descrizione** | Di' al tuo collega cosa deve essere deciso |
| **Opzioni** | I pulsanti sull'attività. Vedi sotto. Almeno una |
| **Assegna a** | Scegli uno o più colleghi |
| **Assegna a gruppi** | Scegli uno o più gruppi |
| **Collega a** | I record presso cui compare l'attività, come il cliente o la fattura. Precompilato con i record noti a questo passaggio |
| **Smetti di attendere dopo** | Per quanto tempo al massimo il passaggio attende. Predefinito 3 giorni |

### Impostare le opzioni [#opties-instellen]

1. In **Opzioni** fai clic su **Aggiungi opzione** e inserisci il nome, per esempio **Approva**. Quel nome compare sul pulsante e sull'uscita
2. Fai clic sul riquadro colorato a sinistra del nome (**Icona e colore**) per scegliere un colore e un'icona. L'icona non è obbligatoria
3. Attiva **Chiedi una nota** se il collega deve indicare un motivo con questa scelta
4. Attiva **Chiedi conferma** se il collega deve prima confermare. Compili allora un **Titolo conferma** e un **Messaggio di conferma** e scegli in **Gravità** tra **Info**, **Avviso** o **Destructive**. In questi testi puoi usare variabili
5. Ripeti per ogni opzione. Puoi creare al massimo 8 opzioni

Se l'elenco è ancora vuoto, il pulsante **Approva / Rifiuta** prepara subito due opzioni: un **Approva** verde e un **Rifiuta** rosso. Ogni opzione ha bisogno di un nome, altrimenti Tillor segnala **Ogni opzione ha bisogno di un nome.** Senza opzioni Tillor segnala **Aggiungi almeno un'opzione.**

### Uscite [#uitgangen]

Il passaggio ha un'uscita per opzione, con il nome e il colore di quell'opzione, più sempre **Scaduto**.

| Uscita | Quando |
|---|---|
| Il nome di un'opzione | Qualcuno ha scelto quel pulsante sull'attività |
| **Scaduto** | Il tempo di attesa è finito senza scelta, oppure l'attività è stata eliminata |

Tieni presente che:

- I pulsanti sono sulla scheda dell'attività, nell'elenco delle attività e nell'attività stessa. Un'attività così non ha la spunta: non puoi semplicemente completarla, solo scegliere un pulsante. Dopo la scelta l'attività è su **Completata** e viene indicato quale opzione è stata scelta. Vedi [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen)
- Può scegliere chi è assegnato all'attività, anche tramite un gruppo, e gli amministratori. Se non assegni nessuno, può scegliere chiunque veda l'attività
- L'attività ottiene priorità **Alta**. È a nome di **Flusso di lavoro**
- Se l'attività viene eliminata prima che qualcuno scelga, il flusso prosegue da **Scaduto**. Dopo **Scaduto** per il tempo di attesa l'attività resta
- I passaggi successivi possono usare `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` e `{approval.decidedBy.name}`. `{approval.label}` è il nome dell'opzione scelta e `{approval.note}` la nota che il collega ha inserito
- Durante l'attesa l'esecuzione ottiene lo stato **In attesa**. Per mettere in pausa e modificare il flusso vale lo stesso di [Ritardo](#wat-er-tijdens-het-wachten-gebeurt)

<Callout type="info" title="In una prova scegli tu l'uscita">
Un'[esecuzione di prova](/automatiseringen/testen-en-uitvoeringen) non può sapere se sei aperto, cosa decide un collega e se un record esiste. In **Cosa succede in questi passaggi?** scegli quindi tu l'uscita di **Aperto ora?**, **Al massimo una volta per periodo**, **Cerca un record**, **Per ogni**, **Attendi finché**, **Attendi un evento** e **Chiedi una decisione**. Con **Per ogni** la prova percorre l'uscita che scegli, **Per ogni** o **Completato**, non entrambe.
</Callout>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un'uscita che non colleghi fa finire l'esecuzione lì.
- Con un passaggio di attesa l'esecuzione ottiene lo stato <Status tone="info">In attesa</Status> e prosegue più tardi. Un'automazione in pausa ferma le esecuzioni in attesa appena il tempo di attesa è finito.
- Dopo un tempo di attesa Tillor rilegge i dati, così i passaggi vedono la situazione attuale.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice Aggiungi una condizione">
Un passaggio **Se / altrimenti** ha bisogno di almeno una condizione. Fai clic su **Aggiungi condizione**.
</Accordion>
<Accordion title="Tillor dice Un ritardo di 0 non fa nulla">
In **Durata** inserisci un numero maggiore di 0.
</Accordion>
<Accordion title="Il flusso passa sempre da Predefinito">
Uno **Smista** confronta il valore esattamente, maiuscole incluse. I valori a scelta sono nella notazione di Tillor, come `RENTAL_CARAVAN`. Se il campo è vuoto, il flusso passa comunque da **Predefinito**.
</Accordion>
<Accordion title="Tillor dice Aggiungi almeno un'opzione oppure Ogni opzione ha bisogno di un nome">
Un passaggio **Chiedi una decisione** ha bisogno di almeno un'opzione con un nome. In **Opzioni** fai clic su **Aggiungi opzione**.
</Accordion>
<Accordion title="L'esecuzione resta su In attesa">
Il flusso attende un tempo, una condizione, un evento o una decisione. Nella scheda **Esecuzioni** vedi quando prosegue o scade. Con **Attendi finché** è per impostazione predefinita dopo 7 giorni, con **Chiedi una decisione** dopo 3 giorni.
</Accordion>
<Accordion title="L'attività di Chiedi una decisione è sparita">
Se l'attività viene eliminata prima che qualcuno scelga, il flusso prosegue da **Scaduto**. Vedi [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
</Accordions>


# Problemi e attivazione (/it-IT/automatiseringen/problemen)

Tillor controlla continuamente il tuo flusso mentre lo costruisci. Finché ci sono problemi aperti, non puoi attivare l'automazione. Così si evita che un flusso che non può funzionare provi a inviare promemoria o attività reali.

## Dove vedi i problemi [#waar-zie-je-de-problemen]

- Su ogni passaggio con un problema c'è un piccolo numero di avviso
- Nel pannello a destra i problemi del passaggio selezionato sono in un riquadro arancione sopra le impostazioni
- In alto nel pannello c'è un pulsante con il totale, per esempio **3 problemi**. Fai clic per l'elenco e fai clic su un messaggio per saltare al passaggio
- Nella panoramica delle automazioni c'è un'etichetta come **3 problemi** accanto al nome, e un filtro **Problemi**

<DocScreenshot src="/screenshots/automatiseringen/issues.png" alt="Pulsante 1 problema in alto nel pannello con il messaggio Il titolo è obbligatorio" />

## Perché non riesco ad attivare [#waarom-kan-ik-niet-inschakelen]

L'interruttore **Attiva** non funziona finché ci sono problemi, con il testo **Risolvi prima i problemi aperti**. Nella panoramica non puoi quindi nemmeno attivare l'interruttore dell'automazione.

Se l'automazione è già attiva, non puoi salvare modifiche che causano problemi. Un flusso in esecuzione deve restare valido. Risolvi i problemi, oppure metti prima in pausa l'automazione.

## Cosa significano i messaggi [#wat-de-meldingen-betekenen]

| Messaggio | Cosa succede | Cosa fai |
|---|---|---|
| **Aggiungi un trigger per iniziare.** | Il flusso non ha un trigger | Un flusso ha sempre bisogno di almeno un trigger. Trascina **Quando succede questo** dall'elenco a sinistra sul canvas |
| **Questo evento non esiste più. Scegline un altro.** | L'evento del trigger non c'è più | In **Evento** scegline un altro |
| **Non collegato, quindi questo passaggio non viene mai eseguito.** | Nessuna linea porta al passaggio | Collega il passaggio a un'uscita di un altro passaggio, oppure eliminalo |
| **Questo passaggio fa parte di un ciclo. Un flusso può solo andare avanti.** | Una linea torna a un passaggio precedente | Elimina la linea che torna indietro. Un flusso non può girare in tondo |
| **[Campo] è obbligatorio.** | Un campo obbligatorio è vuoto, come il **Titolo** di un'attività | Compila il campo. I campi obbligatori hanno un asterisco |
| **[Campo]: [variabile] non è disponibile in questo passaggio.** | Usi una variabile che in questo passaggio non esiste | Scegli una variabile dall'elenco dietro il pulsante **Variabile**. Controlla anche che il passaggio che fornisce la variabile sia prima nel flusso |
| **[Campo] non è un JSON valido.** | Il **Payload** o il **Corpo** non è un JSON corretto | Controlla parentesi graffe, virgole e virgolette. Le variabili sono consentite |
| **Aggiungi almeno un'opzione.** | Un passaggio **Chiedi una decisione** non ha opzioni | In **Opzioni** fai clic su **Aggiungi opzione** |
| **Ogni opzione ha bisogno di un nome.** | Un'opzione di **Chiedi una decisione** non ha un nome | Inserisci il nome oppure elimina l'opzione |
| **Aggiungi una condizione.** | Un passaggio **Se / altrimenti** non ha condizioni | Fai clic su **Aggiungi condizione** |
| **Una condizione non ha un campo valido.** | Il campo di una condizione è vuoto o sconosciuto | Scegli o digita un campo presente nell'elenco dietro **Variabile** |
| **Inserisci un valore per [variabile].** | Una condizione ha un confronto ma ancora nessun valore | Inserisci il valore, oppure scegli un confronto come **è vuoto** che non ne richiede uno |
| **[Campo]: [variabile] non è un formato noto.** | Dopo il `\|` usi una formattazione che non esiste | Usa `currency`, `number`, `date`, `datetime`, `time`, `upper` o `lower`. Vedi [Formattare un valore](/automatiseringen/variabelen#een-waarde-opmaken) |
| **[Campo]: [variabile] non è un'unità.** | Scrivi uno spostamento di data con un'unità che non esiste | Usa `minutes`, `hours`, `days`, `weeks` o `months` |
| **[Campo]: il campo personalizzato [variabile] non esiste.** | Usi un campo personalizzato che non esiste (più) | Scegli un campo esistente dall'elenco dietro **Variabile** |
| **[Campo]: [variabile] ha un formato o uno spostamento di data, che funziona solo nei testi.** | Usi una formattazione nel campo del codice di **Esegui codice** | Calcolalo nel codice |
| **[Campo]: [variabile] non è un nome di variabile.** | Il nome di un risultato contiene caratteri non consentiti | Usa lettere, cifre e punti, come `result` o `result.names` |
| **Un ritardo di 0 non fa nulla.** | Il ritardo è impostato su 0 | Inserisci una durata maggiore di 0 |
| **Il percorso deve iniziare con / e restare all'interno dell'API della tua organizzazione.** | Il **Percorso** di una richiesta API non è consentito | Fai iniziare il percorso con un solo `/` e non inserire `..` né `\` |
| **L'URL deve iniziare con https://.** | L'**URL** di una richiesta API non è sicuro | Usa un indirizzo che inizia con `https://` |
| **L'espressione cron non è valida. Usa cinque campi, ad esempio 0 8 * * 1.** | L'espressione cron non è corretta | Vedi [Secondo un'espressione cron](/automatiseringen/triggers#volgens-een-cron-expressie) |

## Cosa Tillor non può controllare in anticipo [#wat-tillor-niet-vooraf-kan-controleren]

Alcuni errori emergono solo quando il flusso viene eseguito davvero.

- Un URL composto da variabili può essere controllato solo quando è stato compilato
- Per gli eventi i cui dati non sono descritti, Tillor non controlla le variabili
- Se un record esiste, se una fattura può essere inviata o se un altro server è raggiungibile si scopre solo durante un'esecuzione

Un flusso senza messaggi non è quindi per forza un flusso che riesce sempre. Provalo con [Test ed esecuzioni](/automatiseringen/testen-en-uitvoeringen) e controlla le prime esecuzioni reali.

<Callout type="info" title="Un evento che scompare">
Se cambia un evento o un campo su cui si basa il tuo flusso, lo vedi come messaggio sul passaggio interessato. Modifica il passaggio prima di riattivare l'automazione.
</Callout>


# Test ed esecuzioni (/it-IT/automatiseringen/testen-en-uitvoeringen)

Nell'editor lavori con due schede per controllare che un flusso faccia ciò che vuoi: **Esecuzione di prova** per una prova ed **Esecuzioni** per ciò che è successo davvero. Le apri a destra nel pannello. La quarta scheda, **Cronologia**, mostra le versioni precedenti del flusso, vedi [Versioni precedenti](/automatiseringen/aan-de-slag#eerdere-versies).

## Un'esecuzione di prova [#een-testuitvoering]

Scegli la scheda **Esecuzione di prova**. Una prova percorre il flusso con dati di esempio e mostra quali passaggi farebbe.

<Callout type="info" title="Non succede nulla di reale">
Un'esecuzione di prova non invia nulla, non crea nulla e non modifica nulla. I ritardi vengono saltati, così vedi subito il risultato finale. Le azioni mostrano solo cosa farebbero, con il testo **Non eseguito in una prova.**
</Callout>

<DocScreenshot src="/screenshots/automatiseringen/test-run.png" alt="Scheda Esecuzione di prova con i dati di esempio e il risultato per passaggio" />

### Dati di esempio [#voorbeeldgegevens]

In alto c'è **Prova con un record reale**. Per ogni record del trigger, come **Occupazione**, scegli un record con **Scegli un record** (cerca per nome o numero). Tillor carica il record com'è adesso, con i record a cui rimanda, nei dati di esempio. La prova continua a non inviare, creare né modificare nulla.

Sotto **Dati di esempio dell'evento** ci sono i dati con cui lavora la prova, in formato JSON. Se l'automazione è già partita davvero una volta, la prova inizia con i dati dell'ultima esecuzione reale. Altrimenti Tillor compila un esempio con la forma dell'evento: un testo diventa *example*, un numero 1 e una data il momento attuale.

Modifica i valori per provare altri casi, per esempio un altro tipo di terreno o una fattura con un altro stato. Se il testo non è un JSON valido, compare **I dati di esempio non sono un JSON valido.** e non puoi avviare la prova.

Se il flusso contiene una **Richiesta API**, c'è anche un campo **Esempio di risposta API**. Incolla lì la risposta che ti aspetti dalla richiesta. Così la prova può percorrere i passaggi dopo la richiesta, e Tillor indica i campi della risposta come variabili. Vedi [Usare una risposta API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).

### Cosa succede in questi passaggi [#wat-gebeurt-er-bij-deze-stappen]

In alcuni passaggi l'esito dipende dal mondo esterno: **Invia webhook**, **Richiesta API**, azioni con un'uscita **Ignorato** o **Errore**, e logica come **Aperto ora?**, **Cerca un record**, **Attendi un evento** e **Chiedi una decisione**. In **Cosa succede in questi passaggi?** scegli per ogni passaggio da quale uscita prosegue la prova. Così provi anche la strada per quando qualcosa va storto.

### Il risultato [#het-resultaat]

Fai clic su **Esegui prova**. Vedi i passaggi in ordine, con per ogni passaggio:

- i valori inseriti, per esempio il titolo di un'attività come verrebbe creata
- per una condizione, riga per riga cosa è stato confrontato e se corrispondeva. Verde è riuscito, rosso no, con il valore che c'era davvero (*era …*)
- da quale uscita è proseguito il flusso (**Prosegue su: Sì**)
- per un ritardo, fino a quando si sarebbe atteso

Dopo l'esecuzione il pulsante si chiama **Esegui di nuovo**. La prova riproduce i passaggi uno alla volta (**Passo 2 di 5…**). Con **Mostra tutto** salti la riproduzione. Sul canvas si colora la strada percorsa dalla prova, e i passaggi che non sono stati raggiunti vengono attenuati. Fai clic sul nome di un passaggio nel risultato per saltare a quel passaggio. In fondo c'è **Terminato dopo 5 passaggi.**

Se il filtro in **Solo quando** non corrisponde ai tuoi dati di esempio, vedi **Il filtro del trigger non corrisponde a questi dati, quindi il flusso non partirebbe.** Controlla allora quale condizione è rossa. Con **Cancella** togli di nuovo il risultato dal canvas.

### Cosa una prova non mostra [#wat-een-test-niet-laat-zien]

- Se una fattura può davvero essere inviata, se un endpoint è raggiungibile o se un percorso API esiste
- Che aspetto hanno i record dopo un ritardo. La prova lavora con i tuoi dati di esempio e non rilegge nulla
- Errori che si verificano solo con dati reali, come un campo vuoto

Guarda perciò sempre le prime esecuzioni reali nella scheda **Esecuzioni**.

## Esecuzioni reali [#echte-uitvoeringen]

Nella scheda **Esecuzioni** ci sono le ultime 20 esecuzioni reali di questa automazione, la più recente in alto. L'elenco si aggiorna da solo circa ogni 15 secondi. Finché non è partito ancora nulla, vedi **Ancora nessuna esecuzione. Abilita l'automazione e attendi il suo evento.**

Ogni esecuzione mostra l'orario di avvio, il numero di passaggi o (in attesa) quando prosegue, e uno stato.

| Stato | Cosa significa |
|---|---|
| **In corso** | L'esecuzione è in corso in questo momento |
| **In attesa** | L'esecuzione è in un [ritardo](/automatiseringen/logica#vertraging), attende un evento o un'approvazione, e prosegue più tardi |
| **Completato** | Il flusso è stato percorso fino alla fine |
| **Non riuscito** | Un passaggio non ha potuto essere eseguito. Il messaggio compare come **Non riuscito: …** |
| **Annullata** | L'esecuzione si è fermata perché l'automazione è stata messa in pausa o eliminata mentre attendeva |

Fai clic su un'esecuzione per aprirla. Vedi allora:

- tutti i passaggi eseguiti, con l'orario e cosa ha fatto il passaggio
- i valori inseriti, per esempio il titolo che l'attività ha davvero ottenuto
- per una condizione, quali righe corrispondevano
- per un passaggio non riuscito il messaggio di errore, che può essere in inglese

Sul canvas si colora la strada percorsa da questa esecuzione. I passaggi che non sono stati raggiunti vengono attenuati. Fai clic sul nome di un passaggio per saltare a quel passaggio.

Sotto i passaggi c'è un pulsante come **3 set di dati**. Mostra i dati con cui è partita l'esecuzione e cosa ha prodotto ogni azione, come l'ID dell'attività creata o la risposta di una richiesta API. Così puoi verificare quali valori aveva una variabile.

In fondo a un'esecuzione aperta c'è anche una **Traccia**: un codice di lettere e cifre. Se qualcosa non torna in un'esecuzione, comunica quel codice al supporto. Così ritroviamo esattamente questa esecuzione.

<Callout type="info">
Gli eventi che non hanno superato il filtro in **Solo quando**, o per cui l'automazione era già stata eseguita con **Esegui una volta per record**, non avviano un'esecuzione e quindi non compaiono nell'elenco.
</Callout>

Nella panoramica delle automazioni, accanto a ogni automazione c'è l'orario dell'ultima esecuzione, con a fianco una barretta per ogni esecuzione recente.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Dopo un'esecuzione di prova non è cambiato nulla in Tillor. Solo quando attivi **Attiva**, l'automazione gira davvero.
- Le esecuzioni reali restano nella scheda **Esecuzioni**. Mostra le ultime 20.
- Un'esecuzione non riuscita genera un'e-mail a chi ha creato l'automazione, al massimo una all'ora.

## Problemi? [#problemen]

<Accordions>
<Accordion title="I dati di esempio non sono un JSON valido">
Tillor mostra **I dati di esempio non sono un JSON valido.** e non fa partire la prova. Controlla parentesi graffe, virgole e virgolette.
</Accordion>
<Accordion title="Il filtro del trigger non corrisponde a questi dati">
Con questi dati di esempio il flusso non partirebbe. Guarda quale condizione è rossa e modifica i dati o la condizione.
</Accordion>
<Accordion title="Non vedo esecuzioni">
Tillor mostra **Ancora nessuna esecuzione. Abilita l'automazione e attendi il suo evento.** Gli eventi che non hanno superato il filtro non compaiono. Vedi [Domande frequenti](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="La prova riesce, ma l'esecuzione reale non riesce">
Una prova non invia nulla e non rilegge i record. Se una fattura può essere inviata o un indirizzo è raggiungibile lo si scopre solo davvero. Apri l'esecuzione per il messaggio di errore e i dati per passaggio. Ti serve aiuto dal supporto? Comunica il codice **Traccia** dell'esecuzione.
</Accordion>
</Accordions>

## Un'esecuzione che non vuole partire [#een-uitvoering-die-niet-wil-starten]

Vedi [Domande frequenti](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) per una lista di controllo.


# Trigger (/it-IT/automatiseringen/triggers)

Il trigger è il momento di partenza di un'automazione: il "quando". Si trova in cima a ogni flusso, sotto il nome **Quando succede questo**. Un esempio: *parte quando un'occupazione termina*. Il trigger determina anche quali dati possono usare i passaggi successivi. Un flusso può avere più trigger. Ogni trigger avvia un'esecuzione a sé, con il proprio filtro. Ne aggiungi uno dall'elenco a sinistra. L'ultimo trigger non può essere eliminato.

<DocScreenshot src="/screenshots/automatiseringen/trigger-settings.png" alt="Trigger selezionato con i campi Parte da ed Evento, il filtro Solo quando e i dati forniti dall'evento" />

## Da cosa parte l'automazione [#waar-start-de-automatisering-op]

In **Parte da** scegli uno tra sette momenti di partenza.

| Scelta | Parte quando |
|---|---|
| **Quando succede qualcosa** | In Tillor avviene un evento, per esempio un'occupazione che termina o una fattura che viene pagata |
| **Fattura scaduta** | Una fattura contabilizzata è ancora aperta dopo la scadenza |
| **Webhook in entrata** | Un altro sistema invia un messaggio all'indirizzo dell'automazione |
| **Viene scelta un’azione dell’attività** | Qualcuno sceglie, su un'attività, un pulsante di scelta collegato a questa automazione |
| **Si raggiunge una data** | Si raggiunge una data di un record, eventualmente un po' prima o dopo. Per esempio un giorno prima dell'arrivo di una prenotazione |
| **Ogni giorno a un'ora** | È l'ora scelta di ogni giorno |
| **In base a un'espressione cron** | Tocca al programma che indichi |

Scegli quindi prima il tipo di momento di partenza e poi i dettagli. Se scegli un altro momento di partenza, i filtri in **Solo quando** vengono svuotati. Erano scritti per la scelta precedente e non sono più adatti.

## Quando succede qualcosa [#als-er-iets-gebeurt]

In **Evento** scegli cosa deve avviare l'automazione. Fai clic sul campo e digita per cercare, per esempio *occupation* o *invoice*. Gli eventi sono scritti con la notazione di Tillor, come `occupation:ended`: prima l'argomento, poi cosa è successo.

Questi sono gli eventi che ti servono più spesso:

| Evento | Parte quando |
|---|---|
| `occupation:ended` | Un'occupazione termina |
| `reservation:created` | Viene creata una prenotazione |
| `reservation:updated` | Una prenotazione viene modificata |
| `customer:created` | Viene creato un cliente |
| `customer:updated` | Un cliente viene modificato |
| `invoice:created` | Viene creata una fattura |
| `invoice:updated` | Una fattura viene modificata |
| `invoice:paid` | Una fattura è stata pagata |
| `payment:created` | Arriva un pagamento |
| `task:created` | Viene creata un'attività |
| `task:status-changed` | Lo stato di un'attività cambia |
| `task:assigned` | Un'attività viene assegnata a qualcuno |
| `task:action-chosen` | Qualcuno sceglie un pulsante di scelta su un'attività |
| `integration-alarm:created` | Un contatore genera un allarme |
| `comment:created` | Viene pubblicato un commento |
| `document:created` | Viene aggiunto un documento |
| `signatureRequest:updated` | Una richiesta di firma viene aggiornata |
| `signatureRequest:completed` | Tutti i firmatari di una richiesta di firma hanno firmato |
| `mandate-agreement:signed` | Un cliente ha firmato un mandato SEPA |
| `mandate-agreement:activated` | Un mandato SEPA è diventato attivo |
| `mandate-agreement:expired` | Una richiesta di mandato SEPA è scaduta senza firma |
| `mandate-agreement:failed` | L'attivazione di un mandato SEPA è stata rifiutata o non è riuscita |
| `productPriceChange:applied` | Entra in vigore un [prezzo di prodotto pianificato](/producten/prijzen-plannen) |

È la stessa lista dei [webhook](/ontwikkelaars/events). Puoi quindi usare qualsiasi evento per cui Tillor può inviare un webhook. Alcuni eventi che si verificano molto spesso, come lo stato fisico delle barriere, la digitazione nella inbox, i log dei controller e la presenza dei veicoli, non sono nell'elenco.

<Callout type="info" title="Ti manca un evento?">
Sotto il campo **Evento** c'è il link **Manca un evento? Richiedilo**. Vedi [Richiedere un passaggio o un evento](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).
</Callout>

### Quali dati ricevi [#welke-gegevens-krijg-je-mee]

A quasi tutti gli eventi è associato un record, come un'occupazione, una fattura o un'attività. Quel record, più i record a cui rimanda, sono poi disponibili come variabili nei passaggi. Con `occupation:ended` puoi per esempio usare:

- `{occupation.terrain.name}` per il nome del terreno
- `{occupation.customer.firstName}` per il nome del cliente
- `{occupation.reservation.displayId}` per il numero della prenotazione. Non ogni occupazione ha una prenotazione: in quel caso resta vuoto

Inoltre ci sono sempre `{triggeredBy.name}` e `{triggeredBy.id}`: il collega che ha causato l'evento. Se l'evento è stato causato dal sistema, per esempio da una sincronizzazione bancaria, questi campi sono vuoti.

Sotto le impostazioni del trigger c'è **Dati forniti da questo evento**. Qui vedi esattamente quali variabili puoi usare. Per un evento di cui i dati non sono descritti, Tillor dice che non c'è nulla da scegliere. Le variabili che digiti tu funzionano comunque. Vedi [Variabili e modelli](/automatiseringen/variabelen).

## Viene scelta un’azione dell’attività [#er-wordt-een-taakactie-gekozen]

Alcune attività hanno pulsanti di scelta invece di una spunta, per esempio da [Chiedi una decisione](/automatiseringen/logica#vraag-om-een-beslissing). Un pulsante può essere collegato a un'automazione. Con questo trigger l'automazione parte non appena qualcuno sceglie quel pulsante. Vedi anche [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen).

Il collegamento di un pulsante a un'automazione non si fa nell'editor dei flussi. Se ti serve, chiedilo all'amministratore Tillor o al supporto.

I passaggi ricevono i dati dell'attività, per esempio `{task.name}` e `{task.id}`, più `{action.label}` (il nome del pulsante scelto) e `{note}` (la nota inserita dal collega, se il pulsante la richiedeva). Sotto **Dati forniti da questo evento** vedi l'elenco completo.

## Fattura scaduta [#factuur-is-vervallen]

Questo trigger parte per ogni fattura che:

- è contabilizzata (le bozze e le fatture annullate non contano)
- non è una nota di credito
- ha ancora un importo aperto
- ha una scadenza precedente a oggi

Per ognuna di queste fatture parte un'esecuzione a sé. I dati della fattura e del cliente sono disponibili come `{invoice.…}`, per esempio `{invoice.displayId}`, `{invoice.amountOutstanding}` e `{invoice.customer.firstName}`.

Se disattivi **Esegui una volta per record**, l'automazione parte per la stessa fattura al massimo una volta al giorno finché è scaduta. Se la lasci attiva, parte esattamente una volta per fattura. Di solito è ciò che vuoi per un promemoria.

In **Da sollecitare** scegli da quanto tempo la fattura deve essere aperta, con la stessa regola dell'elenco delle fatture. Attiva **Salta i clienti esclusi dai solleciti automatici** per saltare i clienti che lo hanno impostato nelle loro impostazioni di fatturazione. Anche una fattura esclusa dai promemoria automatici non fa partire il flusso.

## Webhook in entrata [#inkomende-webhook]

Un webhook è un messaggio che un altro sistema invia a un indirizzo. Con questo trigger quel sistema avvia l'automazione, per esempio il tuo sito web, un modulo o una piattaforma di prenotazione. Ogni automazione ha un proprio indirizzo segreto.

1. In **Parte da** scegli **Webhook in entrata**
2. Salva l'automazione. In **Indirizzo** compare l'URL
3. Fai clic su **Copia** e imposta l'indirizzo nell'altro sistema
4. Attiva l'automazione

L'altro sistema invia una `POST` con JSON a quell'indirizzo. Il contenuto è poi disponibile come `{body.…}`, per esempio `{body.email}` o `{body.reservering.nummer}`, e i parametri nell'URL come `{query.…}`. Con **Solo quando** puoi filtrare anche su questi campi.

Per il resto funziona così:

- L'indirizzo è il segreto. Chi lo conosce può avviare l'automazione. Condividilo quindi solo con il sistema che ne ha bisogno
- Se l'indirizzo trapela, fai clic su **Nuovo indirizzo** e salva. Da quel momento il vecchio indirizzo non funziona più
- Un'automazione disattivata o un indirizzo sbagliato restituisce un errore `404`
- Il contenuto può essere al massimo di 100 KB
- Ogni chiamata avvia un'esecuzione per ogni trigger webhook del flusso. L'indirizzo appartiene al primo trigger webhook. **Nuovo indirizzo** su quel trigger lo sostituisce
- Non è collegato nessun record, quindi **Esegui una volta per record** non ha effetto

### Ignorare le ripetizioni [#herhalingen-negeren]

Se l'altro sistema a volte invia due volte la stessa chiamata, con **Ignora le ripetizioni** eviti che il flusso parta due volte. Tillor ricorda una chiave della chiamata. Se la stessa chiave arriva di nuovo, non parte nulla.

| Scelta | Cos'è la chiave |
|---|---|
| **Ogni chiamata avvia il flusso** | Non c'è nessuna chiave. Impostazione predefinita |
| **Da un'intestazione** | Il valore di un'intestazione che scegli in **Nome dell'intestazione**, per esempio `Idempotency-Key` |
| **Dal corpo JSON** | Il valore di un campo del JSON, che scegli in **Campo**, come `id` o `data.eventId` |
| **Lo stesso corpo JSON** | L'intero contenuto. Una chiamata con esattamente lo stesso contenuto conta come ripetizione |

In **Ricorda la chiave per** scegli per quanto tempo vale la chiave, in ore, giorni o settimane. Dopo questo tempo la stessa chiave fa ripartire il flusso. Con 0 la chiave vale finché non elimini l'automazione. Una chiamata senza l'intestazione scelta o senza il campo scelto viene rifiutata.

## Si raggiunge una data [#een-datum-is-bereikt]

Questo trigger parte in una data di un record. In **Data** scegli qualsiasi campo data di un record che Tillor invia anche con gli eventi, scritto come record e campo. Alcuni esempi:

| Data | Record |
|---|---|
| `reservation.checkIn` | La data di arrivo di una prenotazione |
| `reservation.checkOut` | La data di partenza di una prenotazione |
| `invoice.dueDate` | La scadenza di una fattura |
| `task.dueDate` | La scadenza di un'attività |
| `occupation.paidUntil` | Fino a quando un'occupazione è pagata |
| `accessMethod.periodTo` | La fine della validità di un codice QR, di una targa o di un altro metodo di accesso |
| `nfcTag.activatedUntil` | Fino a quando un tag NFC è attivato |
| `mandateAgreement.expiresAt` | Quando scade una richiesta di firma di un mandato SEPA |
| `customer.birthday` | La data di nascita di un cliente |
| `contact.birthday` | La data di nascita di un contatto |

Per impostazione predefinita il trigger parte una volta, nella data stessa. Attiva **Ripeti ogni anno** per far contare solo giorno e mese: il flusso riparte allora ogni anno, come per il compleanno con `contact.birthday`. Un 29 febbraio cade il 28 febbraio negli altri anni.

Puoi scegliere anche dati salvati in un record come campi aggiuntivi. `document.userMetadata.insuranceExpiryDate` è la scadenza di un documento, come una prova di pagamento dell'assicurazione. Una data senza ora conta come mezzanotte (UTC, il tempo standard internazionale). Con **Solo quando** limiti poi il trigger a un solo tipo, per esempio `document.userMetadata.documentType` è `INSURANCE_PAYMENT_PROOF`, e ai documenti attivi con `document.status` è `ACTIVE`.

Con **Quanto tempo** e **Prima o dopo** sposti il momento. *1 giorno* e **Prima** con `reservation.checkIn` fa partire il flusso un giorno prima dell'arrivo. Con 0 parte nella data stessa. Una data senza ora conta come mezzanotte.

Con **Ora** scegli a che ora di quel giorno parte il flusso. **L'ora della data** usa il momento presente nel campo, come l'ora di arrivo di una prenotazione. **Ora fissa del giorno** parte nel giorno della data all'ora e al minuto che scegli, nel fuso orario della tua organizzazione. Così `contact.birthday` con **Ripeti ogni anno** parte ogni anno alle 09:00 nel giorno del compleanno. **Quanto tempo** conta allora da quell'ora: *1 giorno* e **Prima** parte il giorno prima alle 09:00, anche se quella notte l'orologio viene spostato.

Per ogni record parte un'esecuzione a sé, con i dati di quel record come variabili, per esempio `{reservation.displayId}` e `{reservation.customer.firstName}`. Con **Solo quando** la limiti, per esempio alle sole prenotazioni con stato prenotata.

Per il resto funziona così:

- Per ogni record e per ogni momento il flusso parte una volta. Se la data si sposta più avanti, per esempio perché un ospite arriva più tardi, riparte nel nuovo momento
- Se il momento era già passato quando hai salvato o attivato l'automazione, non parte più per quel momento
- I momenti persi, per esempio durante una manutenzione, Tillor li recupera fino a un'ora dopo

## Ogni giorno a un'ora [#elke-dag-op-een-uur]

In **Ora** scegli un'ora (da 0 a 23) e in **Minuto** un minuto da 0 a 59. L'orario è quello del fuso orario della tua organizzazione.

I passaggi ricevono `{now}`: il momento in cui è partita l'esecuzione.

## In base a un'espressione cron [#volgens-een-cron-expressie]

Scegli un ritmo, come ogni giorno, ogni lunedì alle 08:00, o i lunedì dispari (il 1°, 3° e 5°). Con **Personalizzato** imposti l'intervallo, i giorni della settimana e l'orario, al minuto. Con **Espressione cron** scrivi tu il programma.

Un'espressione cron è una notazione breve per un orario ripetuto. Ha cinque parti, separate da uno spazio: **minuto**, **ora**, **giorno del mese**, **mese** e **giorno della settimana**.

| Espressione | Significato |
|---|---|
| `0 8 * * 1` | Ogni lunedì alle 08:00 |
| `7 8 * * 1` | Ogni lunedì alle 08:07 |
| `30 7 * * 1-5` | Ogni giorno feriale alle 07:30 |
| `0 9 1 * *` | Il primo di ogni mese alle 09:00 |
| `0 8 * * 1#1,1#3,1#5` | Ogni lunedì dispari (1°, 3° e 5° del mese) alle 08:00 |
| `0 8 * * 1L` | L'ultimo lunedì del mese alle 08:00 |
| `0 8 * * 1 W2:2026-10-05` | Ogni due settimane di lunedì alle 08:00, a partire dalla settimana del 5 ottobre 2026 |
| `*/15 * * * *` | Ogni quarto d'ora |
| `* * * * *` | Ogni minuto |

In ogni parte puoi usare un numero, un elenco con virgole (`8,17`), un intervallo (`1-5`), un passo (`*/15`) o un asterisco (`*`, ogni valore). Il giorno della settimana 0 e 7 sono entrambi domenica. `1#2` è il secondo lunedì, `1L` l'ultimo. Un sesto campo `W2:2026-10-05` ripete ogni due settimane, contate a partire da quella settimana. Nomi come *MON* o *JAN* non funzionano. Se compili sia un giorno del mese sia un giorno della settimana, l'automazione parte in uno dei due.

Se l'espressione non è valida, Tillor lo segnala nel trigger. Gli orari valgono nel fuso orario della tua organizzazione.

## A che ora parte esattamente un programma [#hoe-laat-start-een-schema-precies]

<Callout type="warn" title="Un programma parte nel minuto in cui tocca">
Tillor controlla ogni minuto quali programmi tocca eseguire. Un'automazione che deve partire alle 08:07 parte in quel minuto. Vale per **Fattura scaduta**, **Si raggiunge una data**, **Ogni giorno a un'ora** e **In base a un'espressione cron**.
</Callout>

Per ogni minuto un programma parte al massimo una volta. Un controllo che gira solo nel minuto successivo non recupera il minuto precedente.

Gli eventi partono subito, senza questo ritardo.

## Solo quando [#alleen-wanneer]

Con **Solo quando** fai partire l'automazione solo se i dati corrispondono. Così parti, per esempio, solo per le case mobili o solo per le fatture sopra un certo importo. Lascialo vuoto per partire a ogni evento di questo tipo.

1. Fai clic su **Aggiungi condizione**
2. Scegli il campo con il pulsante **Variabile** (oppure digita il percorso, per esempio `invoice.status`)
3. Scegli come confrontare
4. Inserisci il valore. Per i campi con una scelta fissa, come uno stato, un tipo di terreno o un collega, scegli da un elenco

Puoi usare i seguenti confronti:

| Scelta | Corrisponde quando |
|---|---|
| **è** | Il campo è uguale al valore |
| **non è** | Il campo non è uguale al valore |
| **contiene** | Il valore compare da qualche parte nel campo |
| **è maggiore di** | Il campo è maggiore del valore (per numeri e date) |
| **è minore di** | Il campo è minore del valore (per numeri e date) |
| **è uno tra** | Il campo è uguale a uno dei valori scelti |
| **è vuoto** | Il campo è vuoto |
| **non è vuoto** | Il campo non è vuoto |

Maiuscole e minuscole non contano. I numeri vengono confrontati come numeri, quindi 10 è maggiore di 9.

Se hai più di una condizione, scegli come collaborano: **Devono corrispondere tutte** o **Ne basta una**.

<Callout type="info">
Gli eventi fermati dal filtro non avviano nessuna esecuzione e quindi non lasciano traccia nella scheda **Esecuzioni**. Se vuoi vedere se il filtro è corretto, usa la prova: lì vedi per ogni condizione se era soddisfatta.
</Callout>

## Esegui una volta per record [#eén-keer-per-record-uitvoeren]

Con **Esegui una volta per record** l'automazione parte al massimo una volta per fattura, prenotazione o altro record, per quante volte si verifichi l'evento.

È utile soprattutto con eventi che tornano spesso, come `invoice:updated`: una fattura viene modificata decine di volte, ma vuoi inviare un solo promemoria. Tillor ricorda per ogni record che l'automazione è già partita. Questa memoria scompare se elimini l'automazione.

Funziona solo con eventi a cui è associato un record, e con **Fattura scaduta** e **Si raggiunge una data**. Con **Si raggiunge una data** significa: anche se la data si sposta più avanti, il flusso non riparte. Con un programma come **Ogni giorno a un'ora** non ha effetto.

## Cosa succede poi? [#wat-gebeurt-er-daarna]

- Ogni volta che si verifica il momento di partenza e il filtro corrisponde, parte un'esecuzione con i dati di quel momento come variabili.
- Un evento parte subito. Una data, un'ora o un programma parte nel minuto in cui tocca.
- Se il filtro non corrisponde, non parte nulla e nella scheda **Esecuzioni** non c'è traccia.

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'automazione non parte con il mio evento">
Controlla che l'automazione sia attiva, di aver scelto l'**Evento** giusto e che il filtro in **Solo quando** non sia troppo severo. Prova con i dati di un caso reale nella scheda **Esecuzione di prova**. Altro in [Domande frequenti](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Tillor dice L'espressione cron non è valida">
Usa cinque campi separati da uno spazio, come `0 8 * * 1`. Nomi come *MON* non funzionano.
</Accordion>
<Accordion title="Un webhook in entrata restituisce un errore 404">
L'automazione è disattivata oppure l'indirizzo non è corretto. Attiva l'automazione e copia di nuovo l'indirizzo.
</Accordion>
<Accordion title="Il mio filtro è sparito quando ho scelto un altro momento di partenza">
Con un altro momento di partenza i filtri in **Solo quando** vengono svuotati, perché erano scritti per il momento di partenza precedente. Aggiungili di nuovo.
</Accordion>
<Accordion title="Il flusso non riparte per la stessa fattura">
**Esegui una volta per record** è attivo. In tal caso parte al massimo una volta per fattura, prenotazione o altro record.
</Accordion>
</Accordions>

## Per saperne di più [#meer-lezen]

<Cards>
  <Card
    title="Condizioni, smistamenti e ritardi"
    href="/automatiseringen/logica"
    description="Far dividere il flusso e farlo attendere"
  />
  <Card
    title="Variabili e modelli"
    href="/automatiseringen/variabelen"
    description="Usare i dati dell'evento nei tuoi passaggi"
  />
</Cards>


# Variabili e modelli (/it-IT/automatiseringen/variabelen)

Con le variabili crei testi che cambiano da caso a caso. Scrivi una variabile tra parentesi graffe e Tillor inserisce il valore reale quando l'automazione viene eseguita.

Un esempio di titolo di un'attività:

```text
Controleer {occupation.terrain.name}
```

Se l'occupazione termina sul terreno 12, l'attività si chiama *Controleer 12*.

## Inserire una variabile [#een-variabele-invoegen]

Sopra ogni campo di testo in cui le variabili funzionano c'è il pulsante **Variabile**. Fai clic e vedi un elenco di tutti i dati disponibili, raggruppati per record. Digita per cercare (**Cerca variabili**) e fai clic su una riga. Tillor inserisce la variabile nel punto del cursore.

<DocScreenshot src="/screenshots/automatiseringen/variables-picker.png" alt="Pulsante Variabile accanto al campo Titolo con l'elenco delle variabili disponibili aperto" />

Puoi anche digitare tu stesso una variabile. Sotto il campo un riquadro grigio mostra come appare il testo con dati di esempio, così vedi subito se è corretto.

Le variabili funzionano in campi di testo come titoli, descrizioni, sottoattività, messaggi, l'ID di un cliente, di una fattura o di un altro record, il percorso o l'URL di una richiesta API, il corpo, il payload di un webhook, il nome dell'evento del webhook e i valori delle intestazioni. Negli ultimi due manca il pulsante **Variabile**, ma una variabile che digiti tu viene comunque compilata. Tillor non controlla questi due campi alla ricerca di errori e non mostra un esempio.

Nei campi in cui scegli un dato con cui confrontare, scrivi la variabile senza parentesi graffe. Vale per **Solo quando**, **Se / altrimenti** e **Finché** in **Attendi finché** (per esempio `invoice.status`), per il **Campo** di uno **Smista** e per la **Data** di un **Ritardo**.

## Quali variabili esistono [#welke-variabelen-zijn-er]

| Variabile | Disponibile | Contenuto |
|---|---|---|
| `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` e altre | Dopo un evento | I campi del record di cui parla l'evento. Il nome del record è anche l'inizio della variabile |
| `{occupation.terrain.name}` | Dopo un evento | I campi dei record a cui rimanda il record, come il cliente o il terreno. Funziona per un livello di profondità |
| `{triggeredBy.name}`, `{triggeredBy.id}` | Sempre | Il collega che ha causato l'evento. Vuoto se è stato il sistema |
| `{invoice.…}` | Con **Fattura scaduta** | I campi della fattura scaduta e del cliente |
| `{reservation.…}`, `{task.…}` e altre | Con **Si raggiunge una data** | I campi del record di cui è stata raggiunta la data, più i record a cui rimanda |
| `{now}`, `{today}` | Sempre | Il momento in cui viene eseguito il passaggio e la mezzanotte di quel giorno nel fuso orario dell'organizzazione. Insieme a uno spostamento (più sotto) `{today + 1 day}` dà domani |
| `{threadId}`, `{messageId}` | Con eventi sui messaggi della inbox, come `inbox:message-created` | L'ID della conversazione e del messaggio |
| I campi dell'evento | Dopo **Attendi un evento**, tramite **Ricevuto** | I dati dell'evento atteso. Sostituiscono i dati degli stessi record dall'inizio del flusso |
| `{createdTask.id}`, `{createdTask.name}` | Dopo **Crea attività** | L'attività appena creata |
| `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | Dopo **Cerca attività**, tramite **Trovata** | L'attività trovata dal passaggio |
| `{updatedTask.id}`, `{updatedTask.status}` | Dopo **Imposta stato** | L'attività il cui stato è stato modificato |
| `{updatedTask.id}`, `{updatedTask.priority}` | Dopo **Imposta priorità attività** | L'attività la cui priorità è stata modificata |
| `{updatedTask.id}` | Dopo **Aggiorna attività** | L'attività che è stata modificata |
| `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | Dopo **Trova documento**, tramite **Trovata** | Il documento trovato dal passaggio |
| `{updatedDocument.id}` | Dopo **Aggiorna documento** | Il documento che è stato modificato |
| `{response.status}`, `{response.body}`, `{response.data.…}` | Dopo **Richiesta API** | La risposta della richiesta |
| `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` e altre | Dopo **Cerca un record**, tramite **Trovata** | I campi del record trovato dal passaggio, più i record a cui rimanda. Il nome è `found` più il tipo di record: `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` o `foundInboxMessage` |
| `{body.…}`, `{query.…}`, `{receivedAt}` | Dopo **Webhook in entrata** | Il corpo JSON, i parametri di query e l'orario di ricezione della chiamata webhook |
| Ogni nome di destinazione di **Mappa variabili** | Dopo **Mappa variabili** | Ciò che inserisci come destinazione in quel passaggio, per esempio `{invoice.displayId}` dopo `invoice` ← `{foundInvoice}` |
| `{item.…}` | Nei passaggi dopo **Per ogni** | I campi dell'elemento per cui il passaggio sta girando, come `{item.id}` |
| `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | Dopo **Chiedi una decisione**, tramite un'opzione | L'attività, l'opzione scelta, il nome di quell'opzione, la nota e il collega che ha scelto |
| `{task.…}`, `{action.label}`, `{note}` | Con **Viene scelta un’azione dell’attività** | L'attività, il pulsante scelto e la nota inserita |
| `{createdComment.id}` | Dopo **Aggiungi un commento** | Il commento appena pubblicato |
| `{bookedInvoice.displayId}` | Dopo **Contabilizza fattura**, tramite **Fatto** | Il numero della fattura contabilizzata |
| `{paymentLink.url}` | Dopo **Crea link di pagamento**, tramite **Fatto** | Il link con cui il cliente può pagare online |
| `{consumptionInvoice.id}` | Dopo **Fattura i consumi**, tramite **Fatto** | La fattura per il consumo del contatore |
| `{extendInvoice.id}` | Dopo **Bozza fattura di proroga** | La bozza di fattura che prolunga l'occupazione |
| `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | Dopo **Crea metodo di accesso** | Il nuovo metodo di accesso e il suo valore, come il codice di un codice QR o di un PIN |
| `{error.message}`, `{error.step}` | Dopo un'azione con **Prosegui se questo passaggio non riesce**, tramite **Errore** | Il messaggio di errore e il nome del passaggio non riuscito |

Quali campi ha esattamente un record lo vedi nell'elenco dietro il pulsante **Variabile**. Nel trigger c'è anche il riepilogo **Dati forniti da questo evento**.

### Solo ciò che viene prima nel flusso [#alleen-wat-eerder-in-de-flow-komt]

Un passaggio può usare solo variabili del trigger che lo raggiunge e dei passaggi che lo precedono sullo stesso percorso. Se più trigger raggiungono lo stesso passaggio, sono disponibili solo le variabili che ognuno di questi trigger fornisce. Un campo di un passaggio precedente conta se ognuno di questi trigger passa anche da quel passaggio. Se usi una variabile che in quel punto non esiste, Tillor segnala **[Campo]: [variabile] non è disponibile in questo passaggio.** Un flusso con un messaggio del genere non può essere attivato.

Alcuni record conservano dati aggiuntivi in un solo campo, come i dati del documento in `userMetadata`. Ogni chiave al suo interno è una variabile: `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` o un'altra chiave. Le chiavi note, come il tipo e la scadenza di un documento, sono anche nell'elenco e puoi confrontarle come data. Una data senza ora, come `2026-10-07`, compare in un messaggio come `07-10-2026`.

Le variabili di **Per ogni** (`{item.…}`) esistono solo nei passaggi dopo l'uscita **Per ogni**, non dopo **Completato**. Anche le variabili di un'uscita che non hai preso non esistono: `{paymentLink.url}` c'è solo se il passaggio è passato da **Fatto**, e `{foundTask.id}` solo dopo **Trovata**.

Con eventi di cui i dati non sono descritti, Tillor non può verificare quali variabili esistono. In quel caso non ricevi questo messaggio. Controlla quindi questi flussi con particolare attenzione con un'esecuzione di prova.

### Un nuovo valore sostituisce il vecchio [#een-nieuwe-waarde-vervangt-de-oude]

Una seconda **Richiesta API** nello stesso flusso sostituisce la `response` della prima. Lo stesso vale per `createdTask` dopo una seconda **Crea attività**, per `foundTask` dopo un secondo **Cerca attività** o **Cerca un record** su **Attività**, e per `error` dopo un secondo passaggio non riuscito. Usa quindi i dati di una risposta nel passaggio che segue subito.

## Come vengono compilati i valori [#hoe-waarden-worden-ingevuld]

Tillor adatta la notazione al tipo di campo.

**Nel testo normale** (titoli, descrizioni, sottoattività):

- Le date sono nel fuso orario della tua organizzazione, per esempio `05-10-2026`. Se l'orario non cade esattamente a mezzanotte, c'è anche un'ora, come `05-10-2026 14:30`
- Un campo vuoto dà un testo vuoto
- Una variabile che Tillor non conosce resta come l'hai scritta, per esempio `{occupation.terain.name}`. Un errore di battitura si nota così subito nell'attività o nel messaggio
- Se un record collegato non c'è, la variabile resta vuota. Un'occupazione senza prenotazione non dà quindi nulla per `{occupation.reservation.displayId}`, e un evento causato dal sistema non dà nulla per `{triggeredBy.name}`. Se in quel caso vuoi un altro testo, metti prima un **Se / altrimenti** con **è vuoto**

**In JSON** (il **Payload** di un webhook e il **Corpo** di una richiesta API):

- Il testo viene inserito in modo sicuro. Virgolette, a capo e altri caratteri speciali nel valore non possono rompere il JSON
- Numeri e valori sì/no vengono inseriti senza virgolette, quindi non metterle intorno. Il testo invece va tra virgolette
- Le date passano come data e ora internazionali, come `2026-10-05T08:00:00.000Z`, così il sistema ricevente le gestisce bene

```json
{
  "reservation": "{reservation.displayId}",
  "adults": {reservation.numberOfAdults}
}
```

Se dopo la compilazione il JSON non è valido, per esempio perché un numero è vuoto, l'esecuzione si ferma con un messaggio di errore.

**In un percorso o URL** (in una richiesta API):

- I valori vengono convertiti in modo da starci in un indirizzo. Un nome con uno spazio non dà quindi un indirizzo rotto
- Anche qui le date passano come data e ora internazionali
- Ciò che digiti tu resta come lo digiti. Se vuoi uno spazio in un termine di ricerca, digita tu `%20`

## Spostare una data [#een-datum-verschuiven]

Dopo una variabile data può esserci uno spostamento: `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. Le unità sono `minutes`, `hours`, `days`, `weeks` e `months` (va bene anche il singolare). Giorni e settimane hanno durata fissa, così una validità resta della stessa lunghezza anche attraverso l'ora legale e solare; i mesi seguono il calendario, quindi il 31 gennaio più un mese è il 28 o 29 febbraio. Su un valore che non è una data lo spostamento non fa nulla, e un'unità che non esiste è un errore del passaggio. I campi data come **Valido fino a** accettano la stessa scrittura.

## Formattare un valore [#een-waarde-opmaken]

Dopo la variabile metti un `|` e un formato, per esempio `{invoice.amountOutstanding|currency}`. Senza formato un importo appare nudo, come `1295.3`. Con `|currency` diventa `€ 1.295,30`.

| Formato | Esempio | Risultato |
|--------|-----------|-----------|
| `currency` | `{invoice.amountOutstanding\|currency}` | `€ 1.295,30` |
| `currency:USD` | `{invoice.amountOutstanding\|currency:USD}` | `US$ 1.295,30` |
| `number` | `{invoice.amountOutstanding\|number}` | `1.295,3` |
| `number:2` | `{invoice.amountOutstanding\|number:2}` | `1.295,30` (numero fisso di decimali) |
| `date` | `{invoice.dueDate\|date}` | `30-06-2026` |
| `datetime` | `{invoice.createdAt\|datetime}` | `01-06-2026 16:04` |
| `time` | `{invoice.createdAt\|time}` | `16:04` |
| `upper` / `lower` | `{customer.lastName\|upper}` | `VAN DEN BROECKE` |

- Numeri e importi sono sempre in notazione belga: un punto per le migliaia e una virgola per i decimali
- Date e orari sono nel fuso orario della tua organizzazione
- Se il formato non riesce a leggere il valore, per esempio `|currency` su un testo, il valore compare semplicemente senza formato
- Un formato che Tillor non conosce resta come l'hai scritto, e l'editor mostra un avviso
- In JSON e in un URL il valore formattato viene inserito come testo. In JSON metti quindi le virgolette intorno

## Usare una risposta API [#een-api-antwoord-gebruiken]

Dopo una [Richiesta API](/automatiseringen/acties/integraties#api-verzoek) puoi usare i campi della risposta con `{response.data.…}`. La risposta di una ricerca di attività è per esempio fatta così:

```json
{
  "items": [
    { "id": "task_1", "priority": "LOW" }
  ]
}
```

Allora `{response.data.items.0.id}` dà l'ID della prima attività (il primo di un elenco è il numero 0) e `{response.data.items.0.priority}` la sua priorità.

Tillor può offrire i campi di una risposta come variabili solo se sa com'è fatta la risposta. Ci sono due modi:

- Fai girare davvero l'automazione una volta. Tillor usa allora la risposta dell'ultima esecuzione
- Incolla un esempio nella scheda **Esecuzione di prova**, nel campo **Esempio di risposta API**. Il campo compare non appena il flusso contiene una **Richiesta API**. Sotto ci sono i **Campi di questa risposta**. Fai clic su un campo per copiarlo, parentesi graffe incluse

Poi i campi compaiono nell'elenco dietro il pulsante **Variabile** e nell'elenco di **Campo** di uno **Smista**.

Se digiti tu un percorso sotto `response.data`, viene sempre accettato, anche senza esempio. Inoltre:

- `{response.body}` contiene i primi 4000 caratteri della risposta. Se la risposta è più lunga, il resto viene tagliato
- `{response.data}` è vuoto se la risposta non è JSON o se la risposta è molto grande (oltre 100.000 caratteri)
- Con una ricerca senza risultati `{response.data.items.0.id}` non esiste. Uno **Smista** su un campo del genere passa allora da **Predefinito**

<Callout type="info" title="Un esempio nella prova">
Nella scheda **Esecuzione di prova** inserisci anche i dati di esempio dell'evento. Così nell'esecuzione di prova vedi quali valori Tillor inserirebbe. Vedi [Prove ed esecuzioni](/automatiseringen/testen-en-uitvoeringen).
</Callout>

## Cosa succede poi? [#wat-gebeurt-er-daarna]

- Non appena l'automazione viene eseguita, Tillor sostituisce ogni variabile con il valore reale. Una variabile che Tillor non conosce resta come l'hai scritta.
- Se un dato è vuoto, il posto resta vuoto. Se allora vuoi un altro testo, metti prima un **Se / altrimenti** con **è vuoto**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Vedo {occupation.terain.name} nella mia attività">
Una variabile che Tillor non conosce resta letteralmente così. Di solito c'è un errore di battitura. Scegli la variabile con il pulsante **Variabile**.
</Accordion>
<Accordion title="Tillor dice che una variabile non è disponibile in questo passaggio">
Stai usando un dato che in questo punto del flusso non esiste ancora, per esempio di un passaggio che viene dopo o di un'uscita che non hai preso. Metti prima nel flusso il passaggio che fornisce il dato. Finché il messaggio c'è, non puoi attivare l'automazione.
</Accordion>
<Accordion title="Il JSON non è corretto dopo la compilazione">
Un numero vuoto rende il JSON non valido. Il testo va tra virgolette, i numeri no. Controlla i campi con un'esecuzione di prova.
</Accordion>
<Accordion title="Non vedo nell'elenco i campi di una risposta API">
Tillor non conosce ancora la forma della risposta. Fai girare davvero l'automazione una volta, oppure incolla un esempio in **Esempio di risposta API** nella scheda **Esecuzione di prova**.
</Accordion>
</Accordions>


# Domande frequenti (/it-IT/automatiseringen/veelgestelde-vragen)

## Chi può usare le automazioni? [#wie-kan-automatiseringen-gebruiken]

Chi ha **Visualizza automazioni** vede le automazioni e le loro esecuzioni. Chi ha **Gestisci automazioni** può anche crearle, modificarle, attivarle ed eliminarle. Gli amministratori con **Tutti i permessi** possono fare tutto. Assegni questi permessi nei membri della tua organizzazione.

Attenzione a **Gestisci automazioni**: un'automazione lavora con tutti i permessi della tua organizzazione. Chi può costruire flussi può quindi fare di tutto tramite un flusso. Assegnalo solo a persone di cui ti fidi. Chi non ha nessuno dei due permessi non vede la voce di menu **Amministratore > Automazioni**.

## Perché la mia automazione non parte? [#waarom-start-mijn-automatisering-niet]

Controlla questi punti.

1. **È attiva?** Un'automazione con l'interruttore spento (filtro **In pausa**) non parte. Se ci sono problemi, non hai potuto attivarla. Vedi [Problemi e attivazione](/automatiseringen/problemen)
2. **È l'evento giusto?** Una nuova prenotazione è `reservation:created`, una modifica `reservation:updated`. Controlla anche che l'evento si verifichi davvero con l'azione che fai
3. **Lo ferma il filtro?** Gli eventi che non superano il filtro in **Solo quando** non lasciano un'esecuzione. Usa la scheda **Esecuzione di prova** con i dati di un caso reale per vedere quale condizione non è soddisfatta. Fai attenzione ai valori dei campi a scelta: uno stato di fattura è per esempio `BOOKED`
4. **È attivo Esegui una volta per record?** In tal caso l'automazione non riparte per una fattura o prenotazione per cui è già girata. Vedi [Esegui una volta per record](/automatiseringen/triggers#eén-keer-per-record-uitvoeren)
5. **È un programma?** Allora parte nel minuto in cui tocca. Un'ora fissa e un programma usano il fuso orario della tua organizzazione
6. **L'hai appena attivata o modificata?** Può servire mezzo minuto prima che tutto se ne accorga
7. **Arrivano molti eventi insieme?** Allora le esecuzioni vengono elaborate una alla volta e può volerci un po' prima che tocchi alla tua

Se l'automazione parte ma poi qualcosa va storto, guarda nella scheda **Esecuzioni** cosa è successo e dove si è bloccata l'esecuzione.

## Perché il mio programma parte in ritardo? [#waarom-start-mijn-schema-te-laat]

I programmi vengono controllati ogni minuto. Un'automazione che parte in una data, a un'ora o in base a un programma inizia in quel minuto. Un evento parte subito.

## Un'automazione può continuare ad avviarsi da sola? [#kan-een-automatisering-zichzelf-blijven-starten]

All'interno di un flusso no. Se colleghi un'uscita in modo che il flusso tornerebbe a un passaggio precedente, Tillor rifiuta quella linea. Un flusso con un ciclo del genere non può essere attivato. Se un'esecuzione arriva comunque a un passaggio che ha già fatto, si ferma, invece di rifare quel passaggio.

Nemmeno tramite gli eventi. Ciò che fa un passaggio avviene come utente **Flusso di lavoro**, e gli eventi causati da **Flusso di lavoro** non avviano automazioni. Un'automazione che parte con `task:created` e fa **Crea attività** non riparte quindi con l'attività che ha creato lei stessa. Vale anche tra automazioni: una non può avviarne un'altra.

Se in poco tempo arrivano molti eventi, per esempio per un grande invio, ogni evento avvia un'esecuzione. Tillor ne elabora alcune alla volta. Non si perde nulla, ma può volerci un po'.

## Quali limiti ci sono? [#welke-grenzen-gelden-er]

| Cosa | Limite |
|---|---|
| Passaggi in una automazione | 100 |
| Rami in uno **Smista** | 8, oltre a **Predefinito** |
| Collegamenti da una uscita | 1 passaggio. Se colleghi di nuovo, la nuova linea sostituisce la vecchia |
| Lunghezza del nome | 120 caratteri |
| Lunghezza della descrizione | 500 caratteri |
| Commenti e riquadri sulla tela | 50 in tutto |
| Opzioni in **Chiedi una decisione** | 8 |
| Tempo di attesa di una richiesta API | 15 secondi |
| La risposta in `{response.body}` | I primi 4000 caratteri |
| La risposta in `{response.data}` | Fino a 100.000 caratteri, più grande è vuoto |
| Ritardo in secondi | Non esatto, può arrivare qualche secondo dopo |
| Programmi | Controllo ogni minuto |
| Elementi in un **Per ogni** | 100 alla volta |
| Controllo in **Attendi finché** | Al massimo ogni 5 minuti |
| Contenuto di un webhook in entrata | 100 KB |
| Esecuzioni nella scheda **Esecuzioni** | Le ultime 20 |

## Più automazioni possono partire con lo stesso evento? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten]

Sì. Ogni automazione attiva il cui trigger e filtro corrispondono avvia la propria esecuzione. Non contare su un ordine fisso.

## Dopo un'uscita posso far fare due cose insieme? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen]

No, un'uscita porta a un solo passaggio. Metti le azioni una dopo l'altra, oppure crea una seconda automazione con lo stesso trigger.

## Cosa succede alle esecuzioni in corso se cambio qualcosa? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander]

| Cosa fai | Cosa succede alle esecuzioni |
|---|---|
| Modifichi il flusso e salvi | Le nuove esecuzioni usano il nuovo flusso. Le esecuzioni già in corso o in attesa terminano con il flusso com'era |
| Metti in pausa l'automazione | Le esecuzioni in attesa in un ritardo si fermano non appena il tempo di attesa è finito e ricevono lo stato **Annullata**. Ciò che è già in corso a quel momento finisce. Se la riattivi prima che il tempo di attesa sia finito, l'esecuzione prosegue normalmente |
| Elimini l'automazione | Le esecuzioni e la cronologia vengono eliminate. Le esecuzioni in attesa si fermano |

## Cosa succede se un passaggio non riesce? [#wat-gebeurt-er-als-een-stap-mislukt]

L'esecuzione si ferma con lo stato **Non riuscita** e i passaggi successivi non vengono eseguiti. Chi ha creato l'automazione riceve un'email sull'esecuzione non riuscita, al massimo una all'ora per automazione. Tillor non ritenta il passaggio. Con **Invia webhook** e **Richiesta API** puoi intercettare un errore con l'uscita **Non riuscito**. Con le altre azioni attiva **Prosegui se questo passaggio non riesce**: il passaggio ottiene allora un'uscita **Errore** e il flusso prosegue da lì. Vedi [Se un passaggio non riesce](/automatiseringen/acties#als-een-stap-mislukt).

## Durante una prova viene inviato davvero qualcosa? [#wordt-er-echt-iets-verstuurd-tijdens-een-test]

No. Un'esecuzione di prova non invia nulla, non crea nulla e non modifica nulla. Vedi [Prove ed esecuzioni](/automatiseringen/testen-en-uitvoeringen).

## I miei dati sono salvati in modo sicuro? [#zijn-mijn-gegevens-veilig-opgeslagen]

I tuoi flussi e la cronologia delle esecuzioni, comprese le intestazioni con chiavi o token, vengono salvati in forma cifrata. Per gli indirizzi su internet è consentito solo `https` e gli indirizzi interni vengono rifiutati.

## Mi manca un evento, una condizione o un'azione [#ik-mis-een-gebeurtenis-voorwaarde-of-actie]

Usa **Richiedi un passaggio** nell'editor. Vedi [Richiedere un passaggio o un evento](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).

## Posso gestire le automazioni anche dal mio sistema? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren]

Sì, se il tuo collegamento dispone di tutti i permessi. Vedi [Per sviluppatori](/ontwikkelaars/automatiseringen).

<Callout type="idea" title="Inizia in piccolo">
Comincia con un trigger e un'azione, lasciali girare qualche giorno e controlla le esecuzioni. Poi amplia con condizioni e ritardi.
</Callout>


# Esempio: controllo caravan in affitto (/it-IT/automatiseringen/voorbeeld-nalopen)

Questo esempio costruisce un flusso con un filtro, **Cerca attività**, **Imposta priorità attività**, un **Se / altrimenti** e un'attività con sottoattività. Non ti serve nessuna richiesta API.

Negli ambienti demo di Tillor questo flusso è già pronto, in pausa, come esempio con il nome **Nalopen huurcaravan**. Puoi guardarlo lì mentre lo costruisci.

## Cosa fa il flusso [#wat-de-flow-doet]

Un ospite parte da una casa mobile. La caravan va controllata per l'ospite successivo.

- Se per quel terreno non c'è ancora un'attività di controllo aperta, il flusso ne crea una, con cinque sottoattività e una scadenza dopo 7 giorni. L'attività va anche al collega che ha fermato l'occupazione
- Se c'è già un'attività di controllo aperta, per esempio perché la caravan si è liberata due volte a breve distanza, il flusso non crea una seconda attività. In cambio la priorità dell'attività esistente sale di un livello

```mermaid
flowchart TD
  A["Occupazione fermata<br/>solo case mobili"] --> F{"Attività di controllo aperta?"}
  F -- Trovata --> P["Priorità di un livello più alta<br/>fino ad Alta"]
  F -- Non trovata --> B{"Fermata da un collega?"}
  B -- Sì --> C["Crea attività di controllo<br/>con il nome del collega"]
  B -- No --> D["Crea attività di controllo"]
```

I due passaggi attività in basso sono quasi uguali. Cambia solo la descrizione: se è stato il sistema a terminare l'occupazione, non c'è nessun collega da citare.

## Cosa ti serve [#wat-je-nodig-hebt]

- Hai il permesso **Gestisci automazioni**, oppure **Tutti i permessi**
- Nella tua organizzazione esiste un tipo di terreno per le case mobili, in questo esempio **Stacaravan**
- Facoltativo: una bacheca e una colonna per le attività di controllo

## Costruire il flusso [#de-flow-bouwen]

### 1. Creare un flusso vuoto [#1-een-lege-flow-maken]

1. Vai in **Amministratore > Automazioni** e fai clic su **Nuova automazione**
2. Scegli **Parti da zero**
3. Nella barra di navigazione in alto inserisci il nome **Nalopen huurcaravan**
4. Fai clic sulla tela, accanto ai passaggi, e nel pannello in **Descrizione** scrivi a cosa serve il flusso

### 2. Impostare il trigger [#2-de-trigger-instellen]

1. Fai clic sul trigger. Lascia **Parte da** su **Quando succede qualcosa**
2. In **Evento** scegli `occupation:ended`. Digita *occupation* per cercare
3. In **Nome del passaggio** dai al passaggio il nome *Bezetting gestopt*

Ora il flusso parte a ogni occupazione che termina. Tu lo vuoi solo per le case mobili:

1. In **Solo quando** fai clic su **Aggiungi condizione**
2. Fai clic su **Variabile** e scegli `occupation.terrain.terrainTypeId`
3. Lascia il confronto su **è**
4. Come valore scegli il tipo di terreno **Stacaravan**

<DocScreenshot src="/screenshots/automatiseringen/trigger-filter.png" alt="Trigger con la condizione tipo di terreno è Stacaravan" />

### 3. Cercare un'attività di controllo aperta [#3-een-open-nalooptaak-zoeken]

1. Aggiungi un passaggio **Cerca attività**, collegagli il trigger e dagli il nome *Open nalooptaak?*
2. In **Titolo** inserisci `Nalopen {occupation.terrain.name}`
3. Lascia attivi **Collegata ai record dell'evento**, **Solo attività non completate** e **Salta le sottoattività**

Il passaggio cerca ora un'attività principale non ancora completata, che si chiami esattamente *Nalopen* seguito dal nome del terreno e che sia collegata allo stesso terreno, allo stesso cliente o alla stessa prenotazione. Poi il flusso prosegue da **Trovata** o **Non trovata**.

### 4. Alzare la priorità [#4-de-prioriteit-verhogen]

1. Aggiungi un passaggio **Imposta priorità attività**, chiamalo *Prioriteit verhogen* e collegagli l'uscita **Trovata**
2. Lascia **Attività** su `{foundTask.id}`
3. Lascia **Modifica** su **Un livello più alto** e **Alza fino a** su **Alta**

### 5. Verificare chi ha fermato l'occupazione [#5-nagaan-wie-de-bezetting-stopzette]

1. Aggiungi un passaggio **Se / altrimenti**, collegagli l'uscita **Non trovata** di *Open nalooptaak?* e chiamalo *Door een collega gestopt?*
2. Fai clic su **Aggiungi condizione** e in **Variabile** scegli `triggeredBy.id`
3. Scegli il confronto **non è vuoto**

`{triggeredBy.id}` è vuoto se è stato il sistema a terminare l'occupazione, per esempio un'attività pianificata. Allora il flusso passa da **No**.

### 6. Creare l'attività [#6-de-taak-aanmaken]

Aggiungi un passaggio **Crea attività**, chiamalo *Nalooptaak maken* e collegagli l'uscita **Sì**. Compila i campi così:

| Campo | Valore |
|---|---|
| **Titolo** | `Nalopen {occupation.terrain.name}` |
| **Descrizione** | `Automatisch gegenereerd.`, una riga vuota e `Bezetting stopgezet door @{triggeredBy.name}({triggeredBy.id})` |
| **Priorità** | **Bassa** |
| **Scadenza dopo** | 7 giorni |
| **Assegna anche a chi ha causato l'evento** | Attivo |
| **Collega ai record** | Attivo |
| **Sottoattività** | Cinque righe: *Kuisen*, *Inboedel*, *Internet + TV*, *Kader QR code*, *Controleren op werkjes* |

Con `@{triggeredBy.name}({triggeredBy.id})` il collega viene citato nella descrizione. Se vuoi che l'attività finisca su una bacheca, scegli una bacheca in **Aggiungi alla bacheca** e una colonna in **Colonna**. Chi deve sempre ricevere l'attività lo scegli in **Assegna a**.

Lascia il titolo uguale a quello in *Open nalooptaak?*. Altrimenti il passaggio di ricerca non ritroverà l'attività la volta successiva.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Passaggio Nalooptaak maken con le impostazioni nel pannello" />

### 7. L'attività per il sistema [#7-de-taak-voor-het-systeem]

1. Fai clic sul passaggio *Nalooptaak maken* e poi su **Duplica passaggio**
2. Dai alla copia il nome *Nalooptaak maken (systeem)* e collegagli l'uscita **No**
3. Imposta la **Descrizione** solo su `Automatisch gegenereerd.`

### 8. Provare e attivare [#8-testen-en-inschakelen]

1. Controlla che in alto nel pannello non ci sia un pulsante con problemi (come **1 problema**)
2. Apri la scheda **Esecuzione di prova** e fai clic su **Esegui prova**. Vedi quale strada prende il flusso e quale titolo e descrizione avrebbe l'attività. Non viene creato nulla
3. Attiva l'interruttore **Attiva**

## Perché due passaggi invece di uno [#waarom-twee-stappen-in-plaats-van-één]

Puoi usare i passaggi **Cerca attività** e **Imposta priorità attività** anche separatamente. Se per esempio non vuoi fare nulla quando l'attività esiste già, non collegare semplicemente nulla a **Trovata**. Se vuoi dare all'attività esistente un commento o un altro stato, metti un altro passaggio dopo **Trovata**, come **Imposta stato** con `{foundTask.id}`.

## Cosa succede nella pratica [#wat-er-in-de-praktijk-gebeurt]

| Situazione | Cosa fa il flusso |
|---|---|
| Nessuna attività di controllo aperta per questo terreno | Crea una nuova attività con cinque sottoattività |
| Attività aperta con priorità **Bassa** | La imposta su **Media** |
| Attività aperta con priorità **Media** | La imposta su **Alta** |
| Attività aperta con priorità **Alta** o **Urgente** | Lascia la priorità com'è |
| Occupazione su un altro tipo di terreno | Non parte |

<Callout type="info" title="Come appare l'attività in Tillor">
L'attività è a nome di [**Flusso di lavoro**](/automatiseringen/workflow-gebruiker) ed è collegata al terreno e al cliente dell'occupazione, e alla prenotazione se c'è. Non ogni occupazione ha una prenotazione. Il collega che ha fermato l'occupazione risulta come persona assegnata all'attività.
</Callout>


# Chi esegue un'automazione? (/it-IT/automatiseringen/workflow-gebruiker)

Un'automazione non lavora a nome tuo. Tutti i passaggi vengono eseguiti da un utente fisso della tua organizzazione che si chiama **Flusso di lavoro**.

## Cosa noti [#wat-je-ervan-merkt]

- Un'attività creata da un'automazione risulta a nome di **Flusso di lavoro**
- Anche un commento aggiunto da un'automazione tramite una [richiesta API](/automatiseringen/acties/integraties#api-verzoek) risulta a nome di **Flusso di lavoro**
- Nell'editor, nel pannello a destra, finché non hai selezionato un passaggio, trovi il promemoria che i passaggi vengono eseguiti come utente **Flusso di lavoro** della tua organizzazione, mai a nome tuo

Così è sempre chiaro cosa ha fatto un collega e cosa ha fatto un'automazione. Il tuo nome non compare accanto a qualcosa che non hai fatto tu.

## Cos'è **Flusso di lavoro** [#wat-workflow-is]

- Un utente di sistema, non un collega. Non puoi accedere con questo utente e non ha una casella e-mail
- Ce n'è uno per organizzazione. Esiste solo all'interno della tua organizzazione e non può fare nulla altrove
- Ha tutti i permessi all'interno della tua organizzazione, come un amministratore. Per questo solo gli amministratori possono creare e modificare le automazioni
- Non è membro dell'organizzazione, a differenza di un collega

<Callout type="warn" title="Un'automazione può fare molto">
Poiché **Flusso di lavoro** può fare tutto, un'automazione può fare anche tutto ciò che l'API di Tillor consente. Una **Richiesta API** può quindi, per esempio, modificare o eliminare dati. Tieni quindi i tuoi flussi piccoli e provali bene.
</Callout>

## Cosa non può fare **Flusso di lavoro** [#wat-workflow-niet-mag]

Un'automazione non può creare, modificare, attivare o eliminare automazioni e non può vederne le esecuzioni. Una richiesta API in tal senso viene rifiutata. Così un flusso non può modificare se stesso né un altro flusso.

## Evento causato da **Flusso di lavoro** [#gebeurtenis-veroorzaakt-door-workflow]

Ciò che fa **Flusso di lavoro** genera eventi normali, per esempio una nuova attività. Nella cronologia e nei webhook compare allora **Flusso di lavoro** come autore. Questi eventi non avviano automazioni: un flusso non può quindi avviare se stesso né un altro flusso. Un'esecuzione che attende con **Attendi un evento** prosegue invece con quell'evento: non può avviare un nuovo flusso, quindi nemmeno un ciclo. Maggiori informazioni nelle [Domande frequenti](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten).

## A chi assegni [#wie-wijs-je-toe]

**Flusso di lavoro** non viene mai assegnato a un'attività e non riceve mai una notifica da **Avvisa i colleghi**. Se vuoi che un collega prenda in carico l'attività, scegli un collega in **Assegna a**, oppure spunta **Assegna anche a chi ha causato l'evento**.


# Registrare un pagamento (/it-IT/betalingsverwerking/betaling-registreren)

Un pagamento si registra su una fattura contabilizzata con un saldo aperto. La schermata di pagamento è la stessa per tutti i metodi. Cambiano solo i campi sotto **Metodo di pagamento**.

<Steps>
<Step>
### Apri la fattura [#open-de-factuur]
Vai su <UIPath>Amministrazione > Fatture</UIPath> oppure apri la fattura da <UIPath>Clienti > cliente > Fatturazione</UIPath>. La fattura deve essere contabilizzata e avere un saldo aperto.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Fattura contabilizzata - Effettua pagamento" />
</Step>
<Step>
### Fai clic su Effettua pagamento [#klik-op-maak-betaling]
Si apre la schermata **Nuovo pagamento per** la fattura. In alto trovi il totale della fattura e l'importo residuo.
</Step>
<Step>
### Scegli il metodo di pagamento [#kies-de-betaalmethode]
In **Metodo di pagamento** scegli come arriva il pagamento. Le scelte che vedi dipendono dalla fattura e dalle impostazioni della tua organizzazione.

- **Terminale** invia la richiesta a un terminale POS. Vedi [Terminale](/betalingsverwerking/terminal).
- **Contanti**, **Bonifico** ed eventualmente **Altro** registrano denaro arrivato fuori da Tillor. Vedi [Contanti e bonifico](/betalingsverwerking/contant).
- **Trasferimento interno** sposta il saldo su un'altra fattura dello stesso cliente. Vedi [Trasferimento interno](/betalingsverwerking/interne-overboeking).
- **Mandato SEPA** incassa l'importo con un mandato attivo del cliente. Vedi [Incassare una fattura](/betalingsverwerking/incasso).
</Step>
<Step>
### Inserisci l'importo [#vul-het-bedrag-in]
**Importo** è per impostazione predefinita l'importo residuo. Con i pulsanti 25%, 50%, 75% e 100% inserisci rapidamente una parte, oppure digiti tu un importo. L'importo non può essere superiore all'importo residuo.
</Step>
<Step>
### Esegui il pagamento [#voer-de-betaling-uit]
Fai clic su **Esegui pagamento**.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

L'importo residuo e lo stato di pagamento della fattura vengono aggiornati. Il pagamento compare sulla fattura sotto **Pagamenti** e in <UIPath>Amministrazione > Pagamenti</UIPath>. Come ritrovarli lo trovi in [Ritrovare i pagamenti](/betalingsverwerking/betalingen-bekijken).

Il cliente preferisce pagare da solo? Allora invia la fattura con **Invia notifica**. Vedi [Pagare online](/betalingsverwerking/online).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo il pulsante Effettua pagamento">
Il pulsante compare solo su una fattura contabilizzata con un saldo aperto. Una fattura in bozza va prima contabilizzata. Una fattura pagata per intero non ha più il pulsante.
</Accordion>
<Accordion title="Mandato SEPA è disattivato">
Il cliente non ha un mandato attivo il cui importo massimo sia sufficiente per questo importo. Per una nota di credito il metodo non compare nell'elenco. Vedi [Incassare una fattura](/betalingsverwerking/incasso).
</Accordion>
<Accordion title="Manca il metodo Terminale">
Terminale compare nell'elenco solo se Mollie è collegato e la tua organizzazione può ricevere pagamenti con POS. Vedi [Terminale](/betalingsverwerking/terminal).
</Accordion>
</Accordions>


# Ritrovare i pagamenti (/it-IT/betalingsverwerking/betalingen-bekijken)

Vedi i pagamenti in tre posti: sulla fattura stessa, nella panoramica di tutti i pagamenti e nella schermata di dettaglio di un pagamento.

## Vedere i pagamenti di una fattura [#betalingen-van-een-factuur-bekijken]

Apri la fattura e scorri fino a **Pagamenti**. Vedi solo i pagamenti collegati a questa fattura.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Pagamenti sulla fattura" />

## Cercare tra tutti i pagamenti [#alle-betalingen-doorzoeken]

Vai su <UIPath>Amministrazione > Pagamenti</UIPath>. Filtra per data, metodo di pagamento, stato o cliente, oppure cerca per nome del cliente o numero di fattura.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Panoramica dei pagamenti - Tutti i pagamenti" />

Dal menu azioni (tre puntini) di un pagamento puoi, a seconda del pagamento:

| Azione | Cosa fa |
|---|---|
| **Dettagli** | Apre la schermata di dettaglio |
| **PDF di pagamento** | Crea una ricevuta di pagamento |
| **Sincronizza** | Recupera lo stato aggiornato da Mollie. Solo per pagamenti Mollie già esistenti presso Mollie |
| **Salta il ritardo** | Invia subito alla banca un addebito programmato. Vedi [Incassare una fattura](/betalingsverwerking/incasso) |
| **Rimuovi assegnazione fattura** | Toglie il pagamento dalla fattura |
| **Annulla** | Annulla un pagamento non ancora concluso |
| **Elimina** | Elimina il pagamento |

## Leggere i dettagli di un pagamento [#de-details-van-een-betaling-lezen]

Fai clic su **Dettagli** per la schermata **Dettagli del pagamento**. Vi trovi l'importo, lo stato, il metodo, la fattura e una cronologia.

- **Data di ritiro** compare per un addebito SEPA in corso. Lo stato mostra allora <Status tone="warning">Previsto</Status> con quella data.
- **Invia dopo** compare per un addebito che Tillor non ha ancora inviato alla banca.
- **Report pagamenti** mostra il report in cui finisce il pagamento. Finché il pagamento non è ancora in un report, compare il numero del report seguito da **(previsto)**. Per un pagamento Mollie compare **Con il prossimo versamento Mollie**, perché il report è noto solo al momento del versamento.

Maggiori informazioni sui report si trovano in [Report dei pagamenti](/boekhouden/betalingsrapporten).

## Etichette di stato [#statuslabels]

| Stato | Significato |
|---|---|
| <Status tone="warning">Pending</Status> | Il pagamento è ancora in corso |
| <Status tone="info">Autorizzato</Status> | Approvato, non ancora concluso |
| <Status tone="success">Pagata</Status> | Concluso |
| <Status tone="error">Non riuscito</Status> | Non andato a buon fine |
| <Status>Annullato</Status> | Interrotto prima di essere concluso |
| <Status>Scaduto</Status> | La sessione di pagamento è scaduta |
| <Status>Rimborsato</Status> e <Status>Parzialmente rimborsato</Status> | L'importo è stato restituito per intero o in parte |
| <Status tone="error">Stornato</Status> | La banca o l'emittente della carta ha ritirato l'importo |

## Seguire gli importi aperti [#openstaande-bedragen-opvolgen]

Vai su <UIPath>Amministrazione > Fatture</UIPath>. La scheda **Fatture con saldo aperto** mostra le fatture contabilizzate non ancora pagate per intero. Nelle tabelle filtri per stato di pagamento **Aperto** e ordini per data di scadenza.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Fatture con saldo aperto" />

### Inviare un sollecito [#een-aanmaning-versturen]

Un sollecito si invia per singola fattura, non in blocco.

<Steps>
<Step>
### Apri la fattura [#open-de-factuur]
Scegli una fattura ancora aperta.
</Step>
<Step>
### Invia il sollecito [#verstuur-de-aanmaning]
Fai clic su **Invia notifica** e scegli **Invia promemoria**. Conferma l'invio.
</Step>
</Steps>

Il cliente riceve un promemoria con un link per pagare online. Vedi [Pagare online](/betalingsverwerking/online).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Lo stato non corrisponde a Mollie">
Usa **Sincronizza** nel menu azioni del pagamento. Tillor recupera allora i dati aggiornati. Aiuta soprattutto se una notifica di Mollie è andata persa.
</Accordion>
<Accordion title="Non vedo Sincronizza">
L'azione compare solo per i pagamenti Mollie che hanno già una transazione presso Mollie. Per un addebito che Tillor non ha ancora inviato, non c'è nulla da recuperare.
</Accordion>
</Accordions>


# Registrare contanti e bonifici (/it-IT/betalingsverwerking/contant)

Con **Contanti**, **Bonifico** ed eventualmente **Altro** registri che un cliente ha pagato fuori da Tillor. Tillor non invia nulla. Aggiorna il saldo aperto della fattura.

- **Contanti**: il cliente paga in contanti alla reception.
- **Bonifico**: hai ricevuto un bonifico bancario che non è stato collegato automaticamente alla fattura.
- **Altro**: per altri pagamenti con una descrizione propria, come un assegno o uno scambio. Il metodo compare solo se la tua organizzazione lo ha attivato.

## Registrare un pagamento [#een-betaling-registreren]

<Steps>
<Step>
### Apri la schermata di pagamento [#open-het-betaalscherm]
Apri una fattura contabilizzata con saldo aperto e fai clic su **Effettua pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Finestra di pagamento - Contanti" />
</Step>
<Step>
### Scegli il metodo [#kies-de-methode]
In **Metodo di pagamento** scegli **Contanti** oppure **Bonifico**.
</Step>
<Step>
### Inserisci l'importo [#vul-het-bedrag-in]
Digita un importo o usa i pulsanti 25%, 50%, 75% e 100%.
</Step>
<Step>
### Controlla la data di ricezione [#controleer-de-datum-van-ontvangst]
**Data di ricezione** è per impostazione predefinita oggi. Modificala se il denaro è arrivato un altro giorno.
</Step>
<Step>
### Aggiungi eventualmente una nota [#voeg-eventueel-een-opmerking-toe]
In **Nota** puoi inserire un numero di riferimento o un appunto. Con **Altro** la descrizione è obbligatoria.
</Step>
<Step>
### Esegui il pagamento [#voer-de-betaling-uit]
Fai clic su **Esegui pagamento**.
</Step>
</Steps>

<Callout type="idea" title="Data di ricezione">
La data determina in quale report dei pagamenti finisce il pagamento. Se registri oggi un pagamento di ieri, imposta la data a ieri, così viene integrato il report giusto.
</Callout>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Il pagamento compare subito sulla fattura e in <UIPath>Amministrazione > Pagamenti</UIPath>. Vedi [Ritrovare i pagamenti](/betalingsverwerking/betalingen-bekijken).

Con **Bonifico** puoi anche far arrivare al cliente un'e-mail con il suggerimento di usare la comunicazione strutturata nei bonifici successivi. La casella **Invia promemoria comunicazione strutturata** si trova nella schermata di pagamento. La casella è disattivata se il cliente non ha un indirizzo e-mail.

## Impostazioni per i pagamenti manuali [#instellingen-voor-handmatige-betalingen]

In <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath> trovi queste impostazioni:

| Impostazione | Cosa fa |
|---|---|
| **Mostra metodo di pagamento "Altri"** | Aggiunge il metodo **Altro** nella schermata di pagamento |
| **Massimo in contanti** | L'importo massimo in contanti per pagamento, per impostazione predefinita 2999 euro |
| **Predefinito: promemoria bonifico manuale** | Attiva per impostazione predefinita la casella del promemoria |
| **Massimo in contanti** | Importo massimo che puoi registrare come pagamento in contanti, in euro interi (predefinito 2999) |

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor rifiuta il mio importo in contanti">
Un pagamento in contanti non può superare il **Massimo in contanti** in <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath> (predefinito 2999 euro). Registra l'importo in più parti, oppure scegli un altro metodo.
</Accordion>
<Accordion title="Non vedo il metodo Altro">
Il metodo è disattivato. Attiva **Mostra metodo di pagamento "Altri"** in <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath>.
</Accordion>
<Accordion title="Non vedo metodi manuali">
I pagamenti manuali non sono disponibili per ogni fattura. La schermata lo segnala.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Registrare un pagamento" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Terminale" href="/betalingsverwerking/terminal" />
</Cards>


# Gruppi di pagamento (/it-IT/betalingsverwerking/groepen)

Un gruppo di pagamento raggruppa più pagamenti in entrata sotto un nome, così puoi collegarli in un colpo solo a una fattura contabilizzata. Utile se vuoi riconciliare solo a fine giornata o a fine attività.

Esempi:

- **Chiudere un turno di cassa**: tutti i pagamenti POS della giornata sono in un gruppo. Li colleghi alla fattura dell'incasso giornaliero.
- **Fatturare un'attività**: i partecipanti pagano online in anticipo. Al momento della contabilizzazione colleghi l'intero gruppo alla fattura.
- **Una prenotazione con caparra e saldo**: caparra e pagamento finale sono insieme in un gruppo e vengono assegnati in un colpo solo.

## Le regole [#de-regels]

- Un gruppo ha lo stato <Status tone="info">Aperto</Status> (non ancora collegato) oppure <Status tone="success">Assegnato</Status> (già collegato a una fattura).
- Un gruppo non ha un cliente proprio. Il cliente deriva dalla fattura a cui colleghi il gruppo.
- I pagamenti di un gruppo si spostano solo insieme. Un singolo pagamento di un gruppo non può essere collegato a un'altra fattura.
- Puoi collegare un gruppo solo a una fattura contabilizzata. Le fatture in bozza possono ancora cambiare o sparire.

## Collegare un gruppo a una fattura [#een-groep-aan-een-factuur-koppelen]

<Steps>
<Step>
### Apri i gruppi di pagamento [#open-de-betalingsgroepen]
Vai su <UIPath>Amministrazione > Pagamenti</UIPath> e guarda sotto **Gruppi di pagamento**. L'elenco mostra per impostazione predefinita solo i gruppi aperti. Modifica il filtro **Stato** per vedere anche i gruppi assegnati.

<DocScreenshot src="/screenshots/betalingen/payment-groups.png" alt="Panoramica dei pagamenti - Gruppi di pagamento" />
</Step>
<Step>
### Scegli Assegna [#kies-koppelen]
Apri il menu azioni (tre puntini) di un gruppo aperto e scegli **Assegna**.
</Step>
<Step>
### Scegli la fattura [#kies-de-factuur]
Seleziona la fattura contabilizzata a cui deve essere collegato l'intero gruppo.
</Step>
<Step>
### Conferma [#bevestig]
Fai clic su **Assegna** nella finestra. Tutti i pagamenti del gruppo passano in un colpo solo a quella fattura e il gruppo riceve lo stato <Status tone="success">Assegnato</Status>.
</Step>
</Steps>

Puoi farlo anche dalla fattura. Scegli lì **Assegna pagamento** nel menu azioni, vai alla scheda **Gruppi di pagamento** e fai clic su **Assegna gruppo**.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Un gruppo assegnato compare nel PDF della fattura come una riga con il totale del gruppo. I singoli pagamenti li espandi nella panoramica dei pagamenti della fattura. Il gruppo stesso lo ritrovi nei dettagli di ogni pagamento che ne fa parte.

Se il gruppo contiene un pagamento Mollie già esistente presso Mollie, accanto a **Assegna** compare anche **Sincronizza**. Questa azione recupera in una volta i dati aggiornati di tutti i pagamenti idonei del gruppo. Aiuta se hai dubbi sullo stato o se una notifica è andata persa. Un gruppo vuoto puoi eliminarlo con **Elimina**.

## Come finiscono i pagamenti in un gruppo? [#hoe-komen-betalingen-in-een-groep]

Il tuo sistema di cassa o di gestione delle attività può passare un nome di gruppo quando crea un pagamento Mollie. Tillor crea allora da sé un gruppo, oppure usa un gruppo aperto esistente, e vi inserisce il pagamento. I campi relativi si trovano in [Metadati Mollie](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a collegare il gruppo alla mia fattura">
La fattura è ancora una bozza. Contabilizzala prima, perché solo le fatture contabilizzate possono ricevere un gruppo.
</Accordion>
<Accordion title="Voglio spostare un pagamento del gruppo su un'altra fattura">
Non è possibile per un pagamento che si trova ancora in un gruppo. Lavora a livello di gruppo.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Ritrovare i pagamenti" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Metadati Mollie" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Incassare una fattura con un mandato (/it-IT/betalingsverwerking/incasso)

Se un cliente ha un mandato attivo, Tillor può incassare una fattura dal suo conto bancario. Scegli tu come: colleghi il mandato alla fattura così l'incasso parte da solo dopo la contabilizzazione, oppure avvii l'incasso manualmente con **Effettua pagamento**.

Un mandato si richiede con [Far firmare un mandato SEPA](/betalingsverwerking/mandaat). Una nota di credito non si può incassare.

## Far incassare una fattura automaticamente [#een-factuur-automatisch-laten-innen]

<Steps>
<Step>
### Apri la fattura [#open-de-factuur]
Vai su <UIPath>Amministrazione > Fatture</UIPath> e apri una fattura in bozza o contabilizzata del cliente.
</Step>
<Step>
### Scegli il mandato [#kies-het-mandaat]
In **Mandato di addebito** scegli il mandato del cliente. Nell'elenco compaiono solo i mandati attivi. Scegli **Nessun mandato** per togliere di nuovo il collegamento.

Il campo dice cosa succede: Tillor crea subito un pagamento in sospeso e la banca viene addebitata due giorni dopo la contabilizzazione. Fino ad allora puoi annullare il pagamento.
</Step>
<Step>
### Contabilizza la fattura [#boek-de-factuur]
Dopo la contabilizzazione, nella fattura compare **L’addebito è previsto per il** con la data. In quel giorno Tillor invia l'addebito alla banca.
</Step>
</Steps>

Se la fattura era già contabilizzata quando hai collegato il mandato, vale lo stesso termine di due giorni a partire da quel momento. Se Tillor ha già inviato l'addebito alla banca, non puoi più modificare il mandato sulla fattura.

### L'importo massimo di un mandato [#het-maximumbedrag-van-een-mandaat]

Ogni mandato ha un importo massimo. Lo vedi nell'elenco dei mandati come **max.** con un importo. Se una fattura è più alta:

- il mandato è disattivato nell'elenco, con l'avviso che il massimo è inferiore all'importo della fattura;
- la fattura mostra l'avviso che l'importo della fattura supera il massimo del mandato;
- Tillor non può contabilizzare una fattura con un mandato collegato di questo tipo.

Scegli allora un mandato con un massimo più alto, oppure fai pagare il cliente in un altro modo.

## Avviare un addebito manualmente [#een-incasso-handmatig-starten]

<Steps>
<Step>
### Apri la schermata di pagamento [#open-het-betaalscherm]
Apri la fattura contabilizzata e fai clic su **Effettua pagamento**.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Fattura contabilizzata - Effettua pagamento" />
</Step>
<Step>
### Scegli Mandato SEPA [#kies-sepa-mandaat]
In **Metodo di pagamento** scegli **Mandato SEPA**. Se è disattivato, il cliente non ha un mandato attivo che copra l'importo.
</Step>
<Step>
### Scegli il mandato e il ritardo [#kies-het-mandaat-en-de-vertraging]
Seleziona il **Mandato**. Tillor sceglie da sé il primo mandato attivo che copre l'importo. In **Ritardo (giorni)** inserisci da 0 a 7 giorni. Con 0 l'addebito va subito alla banca, con un numero più alto Tillor attende quei giorni.
</Step>
<Step>
### Esegui il pagamento [#voer-de-betaling-uit]
Fai clic su **Esegui pagamento**.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Il pagamento compare nella fattura e in <UIPath>Amministrazione > Pagamenti</UIPath>.

- Finché l'addebito è in attesa, nei dettagli compare **Invia dopo** con la data. Scegli **Salta il ritardo** nel menu azioni per inviarlo subito alla banca, oppure **Annulla** per fermarlo.
- Dopo l'invio il pagamento ha lo stato <Status tone="warning">Pending</Status> con la **Data di ritiro**. Un addebito SEPA richiede alcuni giorni. Poi diventa <Status tone="success">Pagata</Status>, oppure <Status tone="error">Non riuscito</Status> se la banca rifiuta l'addebito.
- Un addebito in corso conta già nella contabilità come pagamento in sospeso. Se fallisce o lo annulli, sparisce di nuovo dalla bozza. Vedi [Report dei pagamenti](/boekhouden/betalingsrapporten).
- Il cliente vede nella pagina di pagamento **Addebitato tramite addebito diretto** con l'importo e la data, e nessun pulsante di pagamento. Così nessuno paga due volte. Il PDF della fattura e l'e-mail della fattura riportano l'importo e la data dell'addebito.

Il piccolo primo pagamento con cui un cliente ha confermato il proprio mandato viene detratto da Tillor dalla fattura successiva.

## Incassare automaticamente le fatture delle utenze [#nutsfacturen-automatisch-innen]

Le fatture dei consumi di acqua, elettricità e gas puoi farle incassare automaticamente con il mandato del cliente.

- Se alla firma il cliente spunta **Usa questo mandato anche per pagare automaticamente le mie bollette (acqua, luce, gas)**, Tillor imposta questo mandato non appena è attivo. La casella è attiva per impostazione predefinita.
- Puoi anche scegliere il mandato tu stesso in <UIPath>Clienti > cliente > Fatturazione</UIPath>, nella scheda **Impostazioni di fatturazione**, in **Mandato**.
- Nell'elenco dei mandati, il mandato per le utenze è contrassegnato con **Utenze**.

Una nuova fattura dei consumi riceve allora da sola questo mandato come **Mandato di addebito**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Mandato SEPA è disattivato in Effettua pagamento">
Il cliente non ha un mandato con stato <Status tone="success">Attivo</Status> il cui massimo sia abbastanza alto. Controlla la scheda **Mandati** in <UIPath>Clienti > cliente > Fatturazione</UIPath>.
</Accordion>
<Accordion title="Non riesco a contabilizzare la fattura">
Il mandato collegato ha un massimo inferiore all'importo della fattura. Scegli un altro mandato oppure togli il mandato dalla fattura.
</Accordion>
<Accordion title="Non riesco più a modificare il mandato sulla fattura">
Tillor ha già inviato l'addebito alla banca. Segui il pagamento in <UIPath>Amministrazione > Pagamenti</UIPath>.
</Accordion>
<Accordion title="L'addebito non è riuscito">
Apri il pagamento per vedere il motivo. La fattura è di nuovo aperta. Scegli **Effettua pagamento** per un nuovo addebito o un altro metodo, oppure invia al cliente un link di pagamento con **Invia notifica**.
</Accordion>
<Accordion title="Voglio ancora fermare l'addebito">
Finché il pagamento in <UIPath>Amministrazione > Pagamenti</UIPath> mostra ancora **Invia dopo**, puoi annullarlo. Se è già stato inviato, non è più possibile. Puoi però revocare il mandato per le fatture successive, vedi [Revocare un mandato](/betalingsverwerking/mandaat-beheren).
</Accordion>
</Accordions>

Anche le automazioni possono incassare: il passaggio [Incassa tramite addebito diretto](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Far firmare un mandato SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Revocare o reinviare un mandato" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Ritrovare i pagamenti" href="/betalingsverwerking/betalingen-bekijken" />
</Cards>


# Panoramica (/it-IT/betalingsverwerking)

Un pagamento in Tillor è collegato di solito a una fattura contabilizzata. Il cliente può pagare online da solo, tu puoi registrare un pagamento alla reception, oppure Tillor incassa l'importo automaticamente tramite un mandato SEPA. In questa pagina vedi quale metodo serve a cosa.

<Callout type="info" title="Da sapere">
- Un pagamento è collegato a una fattura contabilizzata. Su una bozza non puoi pagare.
- Un pagamento in contanti può essere al massimo di 2999 euro per impostazione predefinita. Lo modifichi con **Massimo in contanti** in <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath>.
- Sopra i 2500 euro la pagina di pagamento avvisa il cliente che la banca o la carta possono rifiutare il pagamento online. Il cliente riceve allora l'IBAN e la comunicazione strutturata per fare un bonifico.
- Un addebito con un mandato va alla banca due giorni dopo la contabilizzazione. Con **Effettua pagamento** scegli tu un ritardo da 0 a 7 giorni. Finché l'addebito non parte, puoi annullarlo.
- Se una fattura supera il massimo del mandato, non puoi incassare. Se quel mandato è sulla fattura, non puoi nemmeno contabilizzare la fattura.
- Il link di firma di un mandato funziona per 14 giorni. Tillor ricorda al cliente dopo 7 giorni, 2 giorni prima della scadenza e nell'ultimo giorno.
- Un trasferimento interno è possibile solo tra due fatture contabilizzate dello stesso cliente.
- Tillor non può rimborsare denaro a un cliente. Un rimborso lo gestisci fuori da Tillor, per esempio con un bonifico bancario.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

Ogni metodo finisce nello stesso punto: un pagamento sulla fattura. Poi prosegue verso il report dei pagamenti e la tua contabilità.

```mermaid
flowchart LR
  F[Fattura contabilizzata] --> M{Metodo di pagamento}
  M -- Online --> P[Pagamento]
  M -- Terminale --> P
  M -- Contanti o bonifico --> P
  M -- Addebito SEPA --> P
  M -- Trasferimento interno --> P
  P -- Stato e saldo --> F
  P -- Per giorno --> R[Report pagamenti]
  R --> B[Contabilità]
```

Un addebito resta prima <Status tone="warning">Pending</Status>. La fattura risulta allora già pagata (in sospeso). Se l'incasso fallisce, la fattura torna aperta. I report dei pagamenti e il collegamento con il software di contabilità si trovano in [Contabilità](/boekhouden).

## Quale metodo scegli? [#welke-methode-kies-je]

| Metodo | Quando | Come paga il cliente | Cosa registra Tillor |
|---|---|---|---|
| [Pagare online](/betalingsverwerking/online) | Il cliente paga da solo, da casa o in viaggio | Tramite il link nell'e-mail o nell'SMS della fattura, con iDEAL, Bancontact, carta di credito o un altro metodo | Il pagamento non appena il partner di pagamento lo conferma, anche se il cliente non fa più nulla |
| [Terminale](/betalingsverwerking/terminal) | Il cliente è alla reception | Con carta o telefono su un terminale POS Mollie | Il pagamento non appena il terminale lo conclude |
| [Contanti e bonifico](/betalingsverwerking/contant) | Denaro ricevuto fuori da Tillor | Contanti alla reception o un bonifico bancario | Il pagamento che registri tu, con la data di ricezione |
| [Mandato SEPA](/betalingsverwerking/incasso) | Fatture ricorrenti o di importo elevato, consumi | Non paga. Tillor incassa l'importo dal conto bancario | Un pagamento in sospeso finché la banca non conferma l'incasso |
| [Trasferimento interno](/betalingsverwerking/interne-overboeking) | Spostare saldo tra due fatture dello stesso cliente | Non paga. Non arriva denaro | Due pagamenti collegati, uno positivo e uno negativo |

I pagamenti online, i pagamenti con POS e gli addebiti passano da Mollie. I pagamenti in contanti e i bonifici li registri tu.

<Cards>
  <Card title="Registrare un pagamento" href="/betalingsverwerking/betaling-registreren" icon={<ReceiptTextIcon />} description="La schermata di pagamento su una fattura contabilizzata" />
  <Card title="Ritrovare i pagamenti" href="/betalingsverwerking/betalingen-bekijken" icon={<SearchIcon />} description="Per fattura, nella panoramica e nei dettagli" />
  <Card title="Pagare online" href="/betalingsverwerking/online" icon={<GlobeIcon />} description="La pagina di pagamento che vede il cliente" />
  <Card title="Terminale" href="/betalingsverwerking/terminal" icon={<MonitorSmartphoneIcon />} description="Pagamenti con POS alla reception" />
  <Card title="Contanti e bonifico" href="/betalingsverwerking/contant" icon={<BanknoteIcon />} description="Registrare pagamenti fuori da Tillor" />
  <Card title="Trasferimento interno" href="/betalingsverwerking/interne-overboeking" icon={<ArrowLeftRightIcon />} description="Spostare saldo tra fatture" />
  <Card title="Far firmare un mandato SEPA" href="/betalingsverwerking/mandaat" icon={<FileSignatureIcon />} description="A distanza o alla reception" />
  <Card title="Incassare una fattura" href="/betalingsverwerking/incasso" icon={<LandmarkIcon />} description="Incassare automaticamente con un mandato" />
  <Card title="Gruppi di pagamento" href="/betalingsverwerking/groepen" icon={<LayersIcon />} description="Raggruppare i pagamenti e collegarli in un colpo solo" />
  <Card title="Esempi pratici" href="/praktijk" icon={<ReceiptTextIcon />} description="Esempi sviluppati dalla pratica" />
</Cards>

## Termini [#begrippen]

- **Pagamento**: un importo ricevuto o in corso, con un metodo, uno stato e di solito una fattura.
- **Mandato**: l'autorizzazione di un cliente a incassare fatture dal suo conto bancario. Vedi [Mandato SEPA](/betalingsverwerking/mandaat).
- **Gruppo di pagamento**: un insieme di pagamenti che colleghi più tardi in un colpo solo a una fattura. Vedi [Gruppi di pagamento](/betalingsverwerking/groepen).
- **Report pagamenti**: il riepilogo giornaliero dei pagamenti ricevuti per la contabilità. Vedi [Report dei pagamenti](/boekhouden/betalingsrapporten).
- **Trasferimento interno**: spostare saldo tra due fatture dello stesso cliente, senza che arrivi denaro.
- **Addebito**: Tillor preleva l'importo dal conto bancario del cliente, con il suo mandato.
- **Cliente**: il cliente a cui appartiene la fattura. Vedi [Cliente](/begrippen#klant).


# Creare un trasferimento interno (/it-IT/betalingsverwerking/interne-overboeking)

Con **Trasferimento interno** sposti un importo da una fattura contabilizzata a un'altra fattura contabilizzata dello stesso cliente. Non arriva denaro. Tillor crea un pagamento positivo sulla fattura che chiudi e un pagamento negativo collegato sulla fattura di destinazione.

Non è un pagamento in contanti, con POS o con bonifico. Quei metodi sono separati nella schermata di pagamento.

## Registrare un trasferimento interno [#een-interne-overboeking-registreren]

<Steps>
<Step>
### Apri la schermata di pagamento [#open-het-betaalscherm]
Apri la fattura contabilizzata con saldo aperto e fai clic su **Effettua pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-internal-transfer.png" alt="Finestra di pagamento - Trasferimento interno con il menu a tendina della fattura di destinazione aperto" />
</Step>
<Step>
### Scegli Trasferimento interno [#kies-interne-overboeking]
In **Metodo di pagamento** scegli **Trasferimento interno**.
</Step>
<Step>
### Scegli la fattura di destinazione [#kies-de-doelfactuur]
In **Fattura di destinazione** seleziona la fattura contabilizzata a cui va l'importo. L'elenco mostra solo fatture contabilizzate dello stesso cliente.
</Step>
<Step>
### Inserisci l'importo [#vul-het-bedrag-in]
Digita un importo o usa i pulsanti 25%, 50%, 75% e 100%.
</Step>
<Step>
### Esegui il pagamento [#voer-de-betaling-uit]
Compila eventualmente **Data di ricezione** e fai clic su **Esegui pagamento**.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Tillor crea due pagamenti collegati, **Trasferimento interno da** e **Trasferimento interno a**, ciascuno con il numero dell'altra fattura.
- Il saldo aperto di entrambe le fatture viene aggiornato.
- Se elimini uno dei due pagamenti, Tillor elimina anche l'altro.

## Trasferimento interno e contabilità [#interne-overboeking-en-boekhouding]

- Un trasferimento interno compare nel report dei pagamenti del giorno in cui lo registri. Se lo registri oggi, compare subito nel [report in bozza](/boekhouden/betalingsrapporten#concept-en-definitief) di oggi.
- Viene incluso nell'esportazione contabile, insieme ai pagamenti Mollie.
- I pagamenti in contanti, i bonifici e i conti bancari non vengono inclusi nell'esportazione contabile.

## Dopo aver stornato una fattura con Estendi occupazione [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen]

Con **Storna fattura** trasformi una fattura in una nota di credito. Un trasferimento interno tra queste due fatture è solo una compensazione contabile. Non estende né accorcia di nuovo l'occupazione.

Cosa significa per **Pagato fino al**:

- Nella fattura originale **Pagato fino al** non cambia.
- Nella nota di credito **Pagato fino al** torna indietro solo se la fattura originale era già stata pagata con un pagamento reale, come contanti, bonifico o Mollie. Se era stata solo compensata con un trasferimento interno, **Pagato fino al** resta uguale.
- **Fatturato fino al** era già stato adeguato al momento della contabilizzazione.

## Problemi? [#problemen]

<Accordions>
<Accordion title="La fattura di destinazione non è nell'elenco">
Compaiono solo le fatture contabilizzate dello stesso cliente. Contabilizza prima una fattura in bozza e non scegliere la stessa fattura su cui crei il pagamento.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Registrare un pagamento" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Conti bancari" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Revocare o reinviare un mandato (/it-IT/betalingsverwerking/mandaat-beheren)

Tutte le azioni per un mandato si trovano nel menu (tre puntini) alla fine della riga nella scheda **Mandati**. La trovi in <UIPath>Clienti > cliente > Fatturazione</UIPath>. Le azioni che vedi dipendono dallo stato.

| Stato | Azioni nel menu |
|---|---|
| <Status tone="info">In attesa di firma</Status> | **Mostra sull'iPad**, **Invia promemoria**, **Invia di nuovo il link per la firma**, **Annulla richiesta** |
| <Status>Link scaduto</Status> | **Invia di nuovo il link per la firma**, **Annulla richiesta** |
| <Status tone="error">Attivazione non riuscita</Status> | **Annulla richiesta** |
| <Status tone="success">Attivo</Status> | **Apri mandato firmato**, **Revoca mandato** |
| <Status>Revocato</Status> | **Apri mandato firmato** |

**Mostra sull'iPad** compare solo se l'app Tillor è online su un dispositivo della tua organizzazione.

## Reinviare una richiesta in sospeso [#een-openstaande-aanvraag-opnieuw-versturen]

<Steps>
<Step>
### Apri il menu della richiesta [#open-het-menu-bij-de-aanvraag]
Cerca la richiesta con stato <Status tone="info">In attesa di firma</Status> oppure <Status>Link scaduto</Status>.
</Step>
<Step>
### Scegli l'azione [#kies-de-actie]
- **Invia promemoria** invia di nuovo un'e-mail al cliente, con un nuovo link. La data di scadenza non cambia.
- **Invia di nuovo il link per la firma** invia un nuovo link che funziona di nuovo per 14 giorni.

Un link inviato in precedenza non funziona più dopo entrambe le azioni.
</Step>
</Steps>

Tillor segnala **Promemoria inviato** oppure **Link per la firma inviato di nuovo**. Il cliente riceve un'e-mail. Come funzionano i promemoria automatici lo trovi in [Far firmare un mandato SEPA](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen).

## Annullare una richiesta [#een-aanvraag-annuleren]

Scegli **Annulla richiesta** se il cliente non deve più firmare. La richiesta riceve lo stato <Status>Annullato</Status>. Se è sul tablet, lì sparisce. Poi puoi avviare una nuova richiesta.

## Revocare un mandato attivo [#een-actief-mandaat-intrekken]

Revoca un mandato se al cliente non si può più addebitare, per esempio in caso di trasloco, di contratto disdetto o su richiesta del cliente.

<Callout type="warn" title="La revoca non si può annullare">
Per il pagamento automatico serve poi un nuovo mandato, con una nuova firma del cliente.
</Callout>

<Steps>
<Step>
### Scegli Revoca mandato [#kies-mandaat-intrekken]
Apri il menu del mandato attivo e scegli **Revoca mandato**.
</Step>
<Step>
### Conferma [#bevestig]
Nella schermata **Revocare questo mandato?** fai clic su **Revoca**. Tillor segnala **Mandato revocato**.
</Step>
</Steps>

Cosa succede dopo:

- Nessuna fattura viene più incassata tramite questo mandato. Gli addebiti che Tillor non aveva ancora inviato alla banca vengono annullati.
- Lo stato del mandato diventa <Status>Revocato</Status>.
- Il documento firmato viene conservato come prova, ma passa nell'archivio. Nei documenti del cliente lo trovi sotto **Archiviati**, così l'elenco mostra solo i mandati ancora validi.
- Il cliente riceve un'e-mail che il mandato è stato revocato, con una copia del documento firmato.

I mandati impostati fuori da Tillor mostrano nel menu solo **Revoca mandato**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Revoca mandato">
L'azione compare solo per un mandato con stato <Status tone="success">Attivo</Status>. Una richiesta non ancora firmata la annulli con **Annulla richiesta**.
</Accordion>
<Accordion title="Un addebito era già in viaggio verso la banca">
La revoca annulla solo gli addebiti che Tillor non aveva ancora inviato alla banca. Un addebito già in viaggio lo segui in <UIPath>Amministrazione > Pagamenti</UIPath>.
</Accordion>
<Accordion title="Voglio usare un altro mandato per una fattura">
Scegli il mandato in **Mandato di addebito** nella fattura. Vedi [Incassare una fattura](/betalingsverwerking/incasso).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Far firmare un mandato SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Incassare una fattura" href="/betalingsverwerking/incasso" />
</Cards>


# Far firmare un mandato SEPA (/it-IT/betalingsverwerking/mandaat)

Con un mandato SEPA un cliente autorizza l'incasso automatico delle fatture dal suo conto bancario. Il cliente firma il mandato direttamente in Tillor. Tillor conserva il documento firmato presso il cliente e poi puoi far incassare le fatture. Lo trovi in [Incassare una fattura](/betalingsverwerking/incasso).

Prima di iniziare:

- I mandati devono essere abilitati per la tua organizzazione. Se non lo sono, il pulsante **Creare mandato** segnala che devi contattare l'amministratore.
- Il cliente ha bisogno di un indirizzo e-mail.
- Un cliente può avere una sola richiesta aperta alla volta.

## Richiedere un mandato [#een-mandaat-aanvragen]

<Steps>
<Step>
### Apri il cliente [#open-de-klant]
Vai su <UIPath>Clienti > cliente > Fatturazione</UIPath>. In fondo c'è la scheda **Mandati** con tutti i mandati e le richieste del cliente.
</Step>
<Step>
### Fai clic su Creare mandato [#klik-op-mandaat-aanmaken]
Si apre un menu con una o due scelte. Scegli come firma il cliente.
</Step>
</Steps>

<Tabs items={["A distanza", "Alla reception"]}>
<Tab value="A distanza">
Scegli **Invia invito al mandato**. Il cliente riceve un'e-mail con un link alla pagina di firma e Tillor segnala **Mandato inviato per la firma a** con l'indirizzo e-mail del cliente.

Il link funziona per 14 giorni, fino all'ultimo giorno compreso. Il cliente non deve indicare un IBAN. Sceglie lui come confermare il mandato.
</Tab>
<Tab value="Alla reception">
Scegli **Far firmare sull'iPad della reception**. Il mandato compare sul tablet della reception e Tillor segnala **Il mandato è sull'iPad, il cliente può firmare**.

Questa scelta compare nel menu solo se l'app Tillor è online su un dispositivo della tua organizzazione. Vedi [Tablet e chioschi](/mobiele-app/tablets-en-kiosken). Il cliente firma con il dito sul tablet. Il documento firmato riporta che è stato firmato alla reception e quale collega ha usato il tablet.

La richiesta è già stata inviata e vuoi mostrarla comunque sul tablet? Apri il menu della richiesta e scegli **Mostra sull'iPad**.
</Tab>
</Tabs>

## Cosa fa il cliente? [#wat-doet-de-klant]

Il cliente passa attraverso alcune schermate. Sul tablet sono le stesse schermate, con alcune differenze indicate più sotto.

<Steps>
<Step>
### Guardare il mandato [#het-mandaat-bekijken]
La pagina **Firma il tuo mandato SEPA per** la tua organizzazione mostra chi è il creditore, per chi incassa e che tipo di pagamento è. Il cliente tocca **Firma il mandato**.
</Step>
<Step>
### Accettare il testo [#de-tekst-accepteren]
Il cliente legge il riepilogo oppure, con **Leggi il testo completo del mandato**, tutto il testo, e spunta che è d'accordo.

Sotto c'è una seconda casella per usare il mandato anche per le fatture delle utenze (acqua, elettricità, gas). La casella è attiva per impostazione predefinita. Vedi [Incassare una fattura](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
</Step>
<Step>
### Firmare [#tekenen]
Il cliente firma con il dito o con il mouse.
</Step>
<Step>
### Scegliere la conferma [#de-bevestiging-kiezen]
Sotto **Come vuoi autorizzare?** il cliente sceglie tra due modi di confermare.

- **Un piccolo primo pagamento** con la propria banca o carta, per esempio tramite iDEAL, Bancontact, carta di credito o Apple Pay. L'importo è compreso tra 0 e 1 euro, a seconda del metodo. In questo modo la banca conferma che il conto è del cliente e il cliente non deve ridigitare l'IBAN. Tillor detrae l'importo dalla fattura successiva.
- **Conto bancario (SEPA)**: il cliente inserisce il proprio IBAN, conferma che il conto è suo e inserisce un codice di sei cifre. Il codice arriva per SMS sul numero di telefono del cliente, oppure per e-mail se non è noto nessun numero.
</Step>
</Steps>

Sul tablet il percorso con IBAN funziona allo stesso modo: il codice va per SMS sul telefono del cliente. Se il cliente sceglie il primo pagamento, il tablet mostra un codice QR che il cliente scansiona con il telefono per pagare.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il mandato compare nell'elenco con lo stato <Status tone="warning">Firmato, in attivazione</Status>, oppure <Status tone="warning">In attesa del primo pagamento</Status> se il cliente ha scelto il piccolo pagamento.
- Non appena il mandato è valido presso il partner di pagamento, lo stato diventa <Status tone="success">Attivo</Status>. Il cliente riceve per e-mail una copia del mandato firmato.
- Tillor conserva il documento firmato tra i documenti del cliente. Lo apri dal menu del mandato con **Apri mandato firmato**. Il documento è sigillato e dotato di marca temporale, così una modifica successiva in un lettore PDF è visibile. Vedi [Sigillo e marca temporale](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).
- Se la finestra del cliente è stata chiusa prima che il primo pagamento fosse completato, la richiesta resta aperta. Il cliente può riprovare con lo stesso link o passare al proprio IBAN.

## Stati [#statussen]

| Stato | Significato |
|---|---|
| <Status tone="info">In attesa di firma</Status> | Il cliente non ha ancora firmato |
| <Status tone="warning">Firmato, in attivazione</Status> | Firmato con IBAN, Tillor sta creando il mandato |
| <Status tone="warning">In attesa del primo pagamento</Status> | Firmato, il piccolo pagamento deve ancora andare a buon fine |
| <Status tone="success">Attivo</Status> | Puoi usare il mandato per l'addebito |
| <Status tone="error">Attivazione non riuscita</Status> | Il partner di pagamento ha rifiutato il mandato. Tillor riprova più tardi |
| <Status>Link scaduto</Status> | Il cliente non ha firmato entro 14 giorni |
| <Status>Annullato</Status> | Hai annullato la richiesta |
| <Status>Revocato</Status> | Il mandato attivo è stato revocato |

I mandati impostati fuori da Tillor mostrano gli stati <Status tone="warning">Pending</Status>, <Status tone="success">Attivo</Status>, <Status tone="error">Inattivo</Status> e <Status>Annullato</Status>. Solo un mandato attivo puoi usarlo per l'addebito.

## Promemoria prima della firma [#herinneringen-voor-het-tekenen]

Tillor invia da sé promemoria per e-mail al cliente finché la richiesta è aperta: quando mancano ancora 7 giorni, due giorni prima della scadenza e nell'ultimo giorno. Ogni promemoria contiene un link di firma nuovo.

Vuoi dare tu una spinta al cliente? Scegli nel menu della richiesta **Invia promemoria**. La data di scadenza resta uguale. Se il link è scaduto, o vuoi concedere di nuovo 14 giorni, scegli **Invia di nuovo il link per la firma**. Maggiori informazioni su queste azioni in [Revocare o reinviare un mandato](/betalingsverwerking/mandaat-beheren).

Vuoi che un'automazione reagisca quando una richiesta scade? Per questo esiste il trigger **Richiesta di mandato scaduta**, vedi [Automazioni](/automatiseringen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il pulsante Creare mandato è disattivato">
Passa sopra il pulsante per vedere il motivo. Di solito il cliente non ha un indirizzo e-mail, oppure i mandati non sono abilitati per la tua organizzazione. Aggiungi un indirizzo e-mail al cliente o chiedi al tuo amministratore di attivare i mandati.
</Accordion>
<Accordion title="Tillor dice che c'è già un mandato in attesa di firma">
Per ogni cliente può essere aperta una sola richiesta alla volta. Reinvia la richiesta esistente oppure annullala, e poi creane una nuova.
</Accordion>
<Accordion title="Manca la scelta per firmare alla reception">
La scelta compare solo se l'app Tillor su un dispositivo della tua organizzazione ha avuto contatto con Tillor di recente. Apri l'app sul tablet, attendi un momento e riprova.
</Accordion>
<Accordion title="Il cliente non riceve il codice SMS">
Il codice va al numero di telefono del profilo cliente. Controlla che sia corretto. Se il cliente non ha un numero, il codice arriva per e-mail. Il cliente può chiedere un nuovo codice.
</Accordion>
<Accordion title="Il cliente vede che il link è scaduto">
Il cliente vede **Questo link per la firma è scaduto**. Scegli nella richiesta **Invia di nuovo il link per la firma**.
</Accordion>
<Accordion title="Lo stato resta Attivazione non riuscita">
Il partner di pagamento ha rifiutato il mandato. Tillor riprova automaticamente più tardi. Se non riesce in modo permanente, annulla la richiesta con **Annulla richiesta** e chiedi al cliente di firmare di nuovo, eventualmente con un'altra conferma.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Incassare una fattura" href="/betalingsverwerking/incasso" />
  <Card title="Revocare o reinviare un mandato" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Metodi di pagamento" href="/betalingsverwerking" />
</Cards>


# Far pagare un cliente online (/it-IT/betalingsverwerking/online)

Il pagamento online passa dalla pagina di pagamento personale di una fattura. Il cliente apre la pagina, sceglie un metodo di pagamento e conclude il pagamento presso la sua banca o l'emittente della carta. Tillor collabora per questo con [Mollie](https://www.mollie.com), quindi Mollie deve essere collegato.

Non c'è un pulsante separato per inviare il link di pagamento. Condividi la pagina con una notifica o con l'URL personale della fattura.

Prima di iniziare:

- La fattura è contabilizzata e c'è un importo aperto. Altrimenti il cliente non ha nulla da pagare.
- Mollie è collegato. Senza metodi di Mollie il cliente vede solo un pulsante di pagamento, vedi [Problemi?](#problemen).
- Il cliente ha un indirizzo e-mail o un numero di telefono, oppure condividi tu il link.

## Inviare il link di pagamento al cliente [#de-betaallink-naar-de-klant-sturen]

<Steps>
<Step>
### Contabilizza la fattura [#boek-de-factuur]
Il pagamento online è possibile solo su una fattura contabilizzata con saldo aperto.
</Step>
<Step>
### Invia una notifica [#verstuur-een-notificatie]
Fai clic su **Invia notifica** e scegli un canale, come e-mail o SMS. Il cliente riceve un messaggio con il pulsante **Visualizza e paga online**.
</Step>
</Steps>

Preferisci condividerlo tu? Apri il menu azioni (tre puntini) nella fattura e scegli **URL personale**. Tillor copia il link negli appunti. Un sollecito con lo stesso link lo invii con **Invia promemoria**, vedi [Ritrovare i pagamenti](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). Il cliente vuole pagare solo una parte? Crea allora un [link per un pagamento parziale](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).

## Cosa vede il cliente? [#wat-ziet-de-klant]

Il cliente apre la pagina **La tua fattura da** la tua organizzazione. Vi trova l'importo da pagare, un riepilogo delle righe della fattura e un pulsante per vedere la fattura. Da quella schermata il cliente prosegue in tre passaggi.

<Steps>
<Step>
### Paga [#betaal]
Il cliente tocca **Paga** con l'importo. Se c'è un pulsante Apple Pay, il cliente può pagare direttamente con quello.
</Step>
<Step>
### Scegli un metodo [#kies-een-methode]
Sotto **Come vuoi pagare?** ci sono i metodi disponibili, come iDEAL, Bancontact e carta di credito. L'ordine viene da Mollie e si adatta alla lingua del cliente. Valgono queste regole:

- Il metodo che il cliente ha usato l'ultima volta su quel dispositivo è indicato con **Ultimo utilizzo**.
- Per i clienti francofoni Pay By Bank è in cima con **Spesso la scelta migliore**.
- Se un metodo ha un disservizio presso Mollie, compare un avviso, per esempio che il metodo è parzialmente non disponibile o in manutenzione. Il cliente può comunque provare il metodo, ma l'avviso dice che potrebbe non riuscire. Il testo del disservizio viene da Mollie.
</Step>
<Step>
### Concludi il pagamento [#rond-de-betaling-af]
Cosa succede dopo dipende dal metodo e dal dispositivo. Vedi sotto.
</Step>
</Steps>

### Concludere su computer o telefono [#afronden-op-computer-of-telefoon]

<Tabs items={["Su un computer", "Su un telefono"]}>
<Tab value="Su un computer">
Con iDEAL e Bancontact Tillor mostra un codice QR sotto **Scansiona per pagare**. Il cliente apre l'app della banca sul telefono e scansiona il codice. La pagina prosegue da sola non appena il pagamento è arrivato. Se il cliente preferisce pagare sul computer, può farlo con **Paga nel browser**.
</Tab>
<Tab value="Su un telefono">
Con Bancontact Tillor mostra il pulsante **Apri l'app Bancontact**. Il cliente conclude il pagamento nell'app e poi torna alla pagina. Con **Paga nel browser** il cliente può pagare anche sul telefono nel browser.
</Tab>
</Tabs>

Con altri metodi, come la carta di credito, Tillor porta il cliente alla pagina di pagamento del partner di pagamento e poi lo riporta indietro. Se il reindirizzamento non avviene da solo, compare un link per continuare.

### Se non riesce [#als-het-niet-lukt]

- **Scegli un altro metodo** riporta il cliente all'elenco.
- **Ricomincia** avvia un nuovo pagamento con lo stesso metodo. Utile se il cliente ha annullato nell'app della banca o non è successo nulla.
- In caso di pagamento non riuscito, annullato o scaduto, la pagina segnala l'esito e il cliente può scegliere un altro metodo.

## Cos'altro può mostrare la pagina [#wat-de-pagina-nog-meer-kan-tonen]

| Situazione | Cosa vede il cliente |
|---|---|
| La fattura è pagata | **Pagata per intero** con l'importo ricevuto, e una conferma per e-mail |
| La banca ha avviato un bonifico | **Conferma del pagamento in corso**. Con Pay By Bank di solito richiede alcuni secondi e al massimo qualche giorno lavorativo |
| È programmato un addebito SEPA | **Addebitato tramite addebito diretto** con l'importo e la data. Il cliente non deve fare nulla. Non ci sono opzioni di pagamento, così nessuno paga due volte |
| L'importo è superiore a 2.500 euro | Un avviso che la banca o la carta possono rifiutare il pagamento online per via di limiti, con l'IBAN e la comunicazione strutturata per fare un bonifico |
| Il pagamento online non è possibile per questa fattura | **Paga con bonifico** con le coordinate bancarie |

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Il link personale non ha scadenza. Il cliente può quindi aprirlo anche più tardi. Non appena Mollie conferma il pagamento, compare nella fattura e in <UIPath>Amministrazione > Pagamenti</UIPath>. La fattura passa a <Status tone="success">Pagata</Status> quando l'intero importo è arrivato. Non devi registrare nulla tu. Vedi [Ritrovare i pagamenti](/betalingsverwerking/betalingen-bekijken) per gli stati.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il cliente non vede metodi di pagamento">
Mollie non trasmette allora nessun metodo. Il cliente vede solo il pulsante di pagamento e con quello va direttamente alla pagina di pagamento di Mollie. Se resta così, controlla il collegamento con Mollie.
</Accordion>
<Accordion title="Il cliente ha pagato, ma la fattura è ancora aperta">
Apri il pagamento da <UIPath>Amministrazione > Pagamenti</UIPath> e usa **Sincronizza**. Con Pay By Bank la conferma può richiedere alcuni giorni lavorativi.
</Accordion>
<Accordion title="Il cliente riceve un avviso su un disservizio di un metodo">
Mollie segnala che il metodo ha dei problemi. Il cliente può scegliere un altro metodo o riprovare più tardi.
</Accordion>
</Accordions>

Integri un sistema tuo con i pagamenti Mollie? Vedi [Metadati Mollie](/ontwikkelaars/mollie-metadata).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Ritrovare i pagamenti" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mandato SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Pagare con un terminale POS (/it-IT/betalingsverwerking/terminal)

Con il metodo di pagamento **Terminale** invii l'importo ancora aperto di una fattura a un terminale POS alla reception. Il cliente paga con carta o telefono e Tillor registra il pagamento non appena il terminale lo conclude.

Tillor è Tech Partner esclusivo di [Mollie](https://www.mollie.com) per i pagamenti con POS. Tillor fornisce i terminali Mollie e configura insieme a te Mollie Connect, il dispositivo e il collegamento con le fatture. Le domande sul POS alla reception arrivano quindi a Tillor.

<Callout type="info" title="Solo terminali Mollie">
Tillor non collega terminali Worldline, CCV o di altri fornitori. Se hai già un terminale di questo tipo, da noi ricevi un dispositivo Mollie. In questo modo pagamenti online, POS e [report dei pagamenti](/boekhouden/betalingsrapporten) restano un'unica catena.
</Callout>

## Avviare un pagamento con POS [#een-pinbetaling-starten]

<Steps>
<Step>
### Apri la schermata di pagamento [#open-het-betaalscherm]
Apri una fattura contabilizzata con saldo aperto e fai clic su **Effettua pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-terminal.png" alt="Finestra di pagamento - metodo di pagamento Terminale selezionato" />
</Step>
<Step>
### Scegli Terminale [#kies-terminal]
In **Metodo di pagamento** scegli **Terminale**.
</Step>
<Step>
### Scegli il terminale [#kies-de-terminal]
Seleziona il terminale della tua reception. Tillor mostra solo i terminali disponibili in quel momento. Se ne hai uno solo, è già selezionato.
</Step>
<Step>
### Inserisci l'importo [#vul-het-bedrag-in]
Digita un importo o usa i pulsanti 25%, 50%, 75% e 100%. Un importo parziale è utile per un acconto o se il cliente paga una parte in contanti e una parte con il POS.
</Step>
<Step>
### Invia il pagamento [#stuur-de-betaling]
Fai clic su **Esegui pagamento**. Mentre Tillor invia la richiesta al terminale compare la schermata **Il pagamento è in fase di elaborazione**.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

La schermata segue il pagamento in tempo reale. Il cliente paga sul terminale e la schermata passa da **Pagamento in sospeso** a **Pagamento riuscito**. Si chiude da sola dopo qualche secondo e il saldo aperto della fattura risulta aggiornato.

Finché il terminale è in attesa, puoi attivare due caselle:

- **Stampa A4 a pagamento riuscito** mette il PDF della fattura nella coda della stampante A4 non appena il pagamento riesce. L'opzione è disattivata se nessun connettore è online.
- **Invia via email dopo il pagamento** invia la fattura per email al cliente non appena il pagamento riesce. L'opzione è disattivata se il cliente non ha un indirizzo email.

Se il pagamento non riesce o scade, ricevi il messaggio **Pagamento non riuscito** o **Pagamento scaduto**. Fai clic su **Invia nuovamente al terminale** per riprovare.

## Impostare il terminale standard [#de-standaardterminal-instellen]

Tillor attiva il POS con il vostro account Mollie. Dopo il collegamento di Mollie, Tillor sceglie da sé il terminale se c'è esattamente un terminale attivo. Ne scegli un altro in <UIPath>Impostazioni > Integrazioni</UIPath> alla voce Mollie, nel campo **Terminale standard** (accanto a **Profilo principale**). Tillor lo propone poi a ogni pagamento con POS.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Terminale in Metodo di pagamento">
Il metodo compare solo quando Mollie è collegato e al tuo account è associato un terminale. Controlla il collegamento in <UIPath>Impostazioni > Integrazioni</UIPath>.
</Accordion>
<Accordion title="Il terminale manca dall'elenco">
Tillor mostra solo i terminali online e attivi. Controlla che il terminale sia acceso e connesso, poi riprova.
</Accordion>
<Accordion title="C'è ancora un vecchio pagamento in sospeso">
Dopo un nuovo tentativo può restare un vecchio pagamento con stato <Status tone="warning">In sospeso</Status>. Annullalo da <UIPath>Amministrazione > Pagamenti</UIPath> con **Annulla** nel menu delle azioni, così la fattura torna corretta.
</Accordion>
<Accordion title="Guasto o una reception in più">
Scrivi a **support@tillor.eu**.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Registrare un pagamento" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Gruppi di pagamento" href="/betalingsverwerking/groepen" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Occupazioni (/it-IT/bezettingen)

Un'occupazione registra che un cliente utilizza un determinato terreno (una piazzola, un palo della corrente e simili). Finché l'occupazione è in corso, Tillor attribuisce automaticamente al cliente i consumi dei contatori di quel terreno. Gestisci le occupazioni dal profilo del cliente. Inizia da [Creare un'occupazione](#een-bezetting-aanmaken).

<Callout type="info" title="Buono a sapersi">
- Un terreno può essere occupato da un solo cliente alla volta. I terreni con un'occupazione attiva non compaiono nell'elenco di scelta.
- **Pagato fino al** accetta solo la data di oggi o una data successiva.
- Il terreno di un'occupazione non si può modificare in seguito. Se un cliente si sposta, termina l'occupazione e creane una nuova.
- Eliminare un'occupazione non si può annullare, ma i consumi fino alla data di fine restano salvati e possono ancora essere fatturati.
- Con **Estendi occupazione (fattura)** la bozza di fattura riceve una scadenza di 14 giorni dopo la creazione.
- Solo i campi **Tipo**, **Frequenza affitto** e **Prezzo** sono informativi. Non guidano automaticamente la registrazione dei contatori né la fatturazione.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

Un'occupazione collega tre elementi: il cliente, il terreno e i contatori di quel terreno. In questo modo Tillor sa a nome di chi vanno i consumi.

```mermaid
flowchart LR
  K[Klant] --> B[Bezetting]
  B --> T[Terrein]
  T --> M[Meters op het terrein]
  M --> V[Verbruiksperiode van de klant]
  V --> F[Factuur]
  B -->|Bezetting verlengen| F
```

Alla creazione Tillor annota le letture iniziali dei contatori, alla chiusura quelle finali. I consumi nel mezzo sono del cliente. Una nuova occupazione sullo stesso terreno inizia un nuovo periodo.

## Consultare le occupazioni [#bezettingen-bekijken]

Apri il profilo di un cliente da <UIPath>Clienti > Panoramica</UIPath> e vai alla scheda **Occupazioni** nella scheda **Panoramica**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Occupazioni sul profilo del cliente" />

- La tabella mostra per ogni occupazione **Terreno**, **Tipo**, **Frequenza affitto**, **Prezzo**, **Stato** e **Pagato fino al**, con un'indicazione relativa come "tra 12 giorni".
- Accanto a **Pagato fino al** c'è un'icona info con **Fatturato fino al** in un tooltip, se quella data è compilata o uguale a **Pagato fino al**.
- Con **Filtra occupazioni...** cerchi per nome del terreno.
- Le azioni per ogni occupazione (modificare, estendere, eliminare) sono nel menu con tre puntini alla fine della riga.

## Creare un'occupazione [#een-bezetting-aanmaken]

Prima di iniziare:

- Il terreno deve essere libero. Se non è nell'elenco, è già occupato. Vedi Problemi in fondo.
- Se il terreno ha contatori, tieni a portata di mano le letture iniziali. Se non inserisci nulla, Tillor prende l'ultima lettura nota.

<Steps>
<Step>
### Apri il profilo del cliente [#open-het-klantprofiel]
Vai a <UIPath>Clienti > Panoramica</UIPath>, apri il cliente e vai alla scheda **Occupazioni**.
</Step>
<Step>
### Fai clic su Crea occupazione [#klik-op-bezetting-aanmaken]
Trovi il pulsante nella barra degli strumenti della tabella. Si apre una finestra.
</Step>
<Step>
### Compila i dati [#vul-de-gegevens-in]
Solo **Terreno** è obbligatorio. Il resto è facoltativo.

- **Terreno**: scegli tramite **Selezioni un terreno**. Nell'elenco ci sono solo terreni disponibili. Se nessun terreno è disponibile, vedi **Nessun terreno disponibile trovato.**
- **Pagato fino al (facoltativo)**: fino a quando il cliente ha pagato in anticipo. Scegli oggi o una data successiva.
- **Fatturato fino al (facoltativo)**: lascia vuoto per seguire la stessa data di **Pagato fino al**, oppure scegli una data propria.
- **Tipo**: **Alloggio proprio** (predefinito) o **Caravan a noleggio**.
- **Frequenza affitto (facoltativo)**: una delle opzioni impostate dalla tua organizzazione, ciascuna con un mese di inizio e un numero di mesi (per esempio inizio a gennaio, 6 mesi). Scegli **Nessuna frequenza** se non vuoi registrarne una.
- **Descrizione (facoltativo)**: una nota, per esempio accordi tariffari.
- **Prezzo**: l'occupazione riprende il prezzo del terreno. Con **Sovrascrivi prezzo terreno ereditato** indichi un prezzo personalizzato.
- **Letture contatore iniziali (facoltativo)**: compare non appena il terreno ha contatori. Se non ne ha, vedi **Nessun contatore collegato**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu delle azioni di un'occupazione con Modifica, Estendi ed Elimina" />
</Step>
<Step>
### Conferma [#bevestig]
Fai clic su **Crea occupazione** per salvare.
</Step>
</Steps>

### Inserire le letture dei contatori [#meterstanden-invullen]

<Tabs items={["Handmatige meter", "Automatische meter"]}>
<Tab value="Handmatige meter">
Digita tu stesso la lettura nella scheda **Manuale**. Il campo mostra come esempio l'ultima lettura nota. Se ci sono letture precedenti, con **Seleziona** puoi anche scegliere una lettura esistente.
</Tab>
<Tab value="Automatische meter">
Un contatore che invia da solo le letture non consente l'inserimento manuale. Scegli una lettura esistente con **Seleziona una lettura**.
</Tab>
</Tabs>

Se inserisci una lettura inferiore a quella salvata in precedenza, Tillor mostra un avviso. Puoi comunque confermare il valore più basso oppure correggere l'inserimento.

### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- L'occupazione è attiva subito e compare nella tabella sul profilo del cliente.
- Per ogni contatore del terreno Tillor avvia un periodo di consumo per questo cliente. Le nuove letture contano da ora come consumi del cliente.
- Il terreno non è più disponibile per un'altra occupazione.

## Modificare un'occupazione [#een-bezetting-bewerken]

<Steps>
<Step>
### Apri il menu dell'occupazione [#open-het-menu-van-de-bezetting]
Fai clic sul menu con tre puntini accanto all'occupazione e scegli **Modifica**.
</Step>
<Step>
### Modifica i campi [#pas-de-velden-aan]
Puoi cambiare **Tipo**, **Frequenza affitto**, **Descrizione**, **Pagato fino al**, **Fatturato fino al** e **Prezzo**. **Terreno** è di sola lettura. Se la tua organizzazione ha [campi personalizzati](/eigen-velden) per le occupazioni, si trovano in fondo alla finestra.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-edit-dialog.png" alt="Finestra Modifica occupazione" />
</Step>
<Step>
### Salva [#sla-op]
Fai clic su **Salva modifiche**. La modifica compare con un confronto prima/dopo nella scheda **Eventi** del cliente.
</Step>
</Steps>

## Terminare un'occupazione [#een-bezetting-beëindigen]

Terminare rimuove il collegamento tra cliente e terreno. Il terreno torna poi disponibile.

<Steps>
<Step>
### Scegli Elimina [#kies-verwijderen]
Fai clic sul menu con tre puntini accanto all'occupazione e scegli **Elimina**. Si apre la finestra **Elimina occupazione**.
</Step>
<Step>
### Scegli la data e le letture finali [#kies-de-datum-en-de-eindmeterstanden]
Se il terreno ha contatori, puoi compilare **Letture contatore finali (facoltativo)**. Scegli prima in **Data** il giorno in cui l'occupazione termina (oggi o prima). Poi compare un campo per la lettura finale di ogni contatore. Un contatore manuale lo compili con **Manuale** o lo scegli con **Seleziona**. Un contatore automatico richiede sempre una lettura esistente tramite **Seleziona una lettura**.
</Step>
<Step>
### Conferma [#bevestig-1]
Fai clic su **Elimina**. Non si può annullare.
</Step>
</Steps>

### Cosa succede dopo? [#wat-gebeurt-er-daarna-1]

- Tillor chiude i periodi di consumo aperti del cliente. I consumi fino alla data di fine restano salvati e possono ancora essere fatturati.
- Il terreno torna disponibile per una nuova occupazione.
- L'occupazione scompare dalla tabella.

## Fatturazione: estendere un'occupazione [#facturatie-bezetting-verlengen]

Con **Estendi occupazione (fattura)** crei una bozza di fattura per il periodo successivo di un'occupazione, per esempio la tariffa annuale di sosta. Puoi farlo per una sola occupazione o per tutte quelle del cliente insieme.

Prima di iniziare: deve esistere almeno un prodotto con l'azione **Estendi occupazione** (spesso Sosta). Vedi [Prodotti](/producten).

<Steps>
<Step>
### Avvia l'azione [#start-de-actie]
<Tabs items={["Eén bezetting", "Alle bezettingen"]}>
<Tab value="Eén bezetting">
Apri il menu con tre puntini accanto all'occupazione e scegli **Estendi occupazione (fattura)**.
</Tab>
<Tab value="Alle bezettingen">
Fai clic nella barra degli strumenti su **Estendi tutte**. Tutte le occupazioni finiscono in un'unica bozza di fattura, con una riga principale per occupazione.
</Tab>
</Tabs>
</Step>
<Step>
### Scegli se fatturare anche i consumi [#kies-of-je-verbruik-meefactureert]
Seleziona **Fattura consumi in sospeso per questo terreno** (con **Estendi tutte**: **Fattura consumi in sospeso (tutti i terreni)**) se vuoi fatturare nella stessa bozza anche i consumi in sospeso. Se sui contatori interessati non c'è nulla in sospeso, restano solo le righe dell'estensione dell'occupazione.
</Step>
<Step>
### Crea la bozza di fattura [#maak-de-conceptfactuur]
Fai clic su **Crea bozza fattura**. Tillor usa il primo prodotto con l'azione **Estendi occupazione** (in ordine alfabetico per nome) e costruisce le righe per te. Poi completa il periodo sulla fattura e contabilizza quando sei pronto.
</Step>
</Steps>

### Cosa succede dopo? [#wat-gebeurt-er-daarna-2]

- Presso il cliente c'è una bozza di fattura pronta, con il messaggio **Completato** e una descrizione di ciò che è stato creato.
- Se contabilizzi la fattura, Tillor imposta **Fatturato fino al** sul momento finale della riga.
- Dopo il pagamento Tillor aggiorna **Pagato fino al**. **Fatturato fino al** avanza solo se era ancora precedente a quel momento finale.

<Callout type="warn" title="Attenzione con una bozza esistente">
Se esiste già una bozza di fattura che estende questo terreno, Tillor mostra **Verifichi prima di continuare**. Una seconda bozza può duplicare righe o saltare un periodo. Apri la bozza esistente con **Apri bozza ...**, oppure scegli **Crea bozza comunque**.
</Callout>

## Pagato fino al, tipo, frequenza affitto e prezzo [#betaald-tot-type-huurfrequentie-en-prijs]

| Campo | Significato |
|---|---|
| **Pagato fino al** | Fino a quando il cliente ha pagato in anticipo. Alla creazione o modifica scegli oggi o una data successiva. |
| **Fatturato fino al** | Fino a quando è stato fatturato. Se lo lasci vuoto, la visualizzazione segue **Pagato fino al**. |
| **Tipo** | Distingue l'alloggio proprio dal noleggio. |
| **Frequenza affitto** | Registra il ritmo dell'affitto per il seguito amministrativo. |
| **Prezzo** | Di norma segue il terreno, ma si può adattare per ogni occupazione. |

## Scenari frequenti [#veelvoorkomende-scenarios]

### Arriva un nuovo ospite [#een-nieuwe-gast-checkt-in]

1. Cerca il cliente o aggiungilo.
2. Sul profilo del cliente crea un'occupazione sul terreno.
3. Inserisci la lettura iniziale, oppure lascia che Tillor prenda l'ultima lettura.
4. Da quel momento Tillor collega a questo cliente i consumi dei contatori di quel terreno.

### Un ospite parte [#een-gast-vertrekt]

1. Nell'occupazione scegli **Elimina**.
2. Scegli la data di partenza e inserisci le letture finali.
3. Conferma. Tillor chiude i periodi di consumo e il terreno torna disponibile.

### Un cliente si sposta su un altro terreno [#een-klant-verhuist-naar-een-ander-terrein]

1. Termina l'occupazione attuale con le letture finali del vecchio terreno.
2. Crea una nuova occupazione sul nuovo terreno con le letture iniziali.
3. Tillor tiene separati i periodi di consumo per ogni terreno.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il terreno non compare nell'elenco di scelta">
Nell'elenco ci sono solo terreni senza un'occupazione attiva. Se un altro cliente ha ancora il terreno, termina prima quell'occupazione. Se non c'è nulla di disponibile, vedi **Nessun terreno disponibile trovato.** Se mancano tutti i terreni e vedi **Si è verificato un errore durante il caricamento dei terreni.**, ricarica la pagina.
</Accordion>
<Accordion title="Non si può creare l'occupazione perché il terreno è già occupato">
Un altro utente è stato più rapido e ha occupato il terreno. Ricarica la pagina del cliente, scegli un altro terreno oppure termina prima l'occupazione dell'altro cliente.
</Accordion>
<Accordion title="Non posso scegliere una data passata in Pagato fino al">
È voluto. Alla creazione o modifica **Pagato fino al** accetta solo oggi o una data successiva.
</Accordion>
<Accordion title="Le letture finali non compaiono in Elimina">
Scegli prima in **Data** il giorno in cui l'occupazione termina. Poi compare un campo per ogni contatore. Se il terreno non ha contatori, non c'è nessun campo.
</Accordion>
<Accordion title="Non posso digitare una lettura per un contatore">
È un contatore che invia da solo le letture. Scegli una lettura esistente con **Seleziona una lettura**. Se vedi **Nessuna lettura contatore disponibile**, il contatore non ha ancora inviato nessuna lettura.
</Accordion>
<Accordion title="Tillor dice: Impossibile creare la fattura">
Di solito non esiste un prodotto con l'azione **Estendi occupazione**. Creane uno, vedi [Prodotti](/producten), e riprova. Se estendi tutte le occupazioni insieme, controlla anche che appartengano allo stesso cliente.
</Accordion>
<Accordion title="Tillor mostra Verifichi prima di continuare quando estendo">
C'è già una bozza per questo terreno, oppure il terreno è fatturato fino a una data non ancora pagata. Leggi il messaggio. Con **Crea bozza comunque** prosegui consapevolmente, con **Apri bozza ...** controlli prima la bozza esistente.
</Accordion>
<Accordion title="Ho eliminato un'occupazione per errore">
Non si può annullare. Crea una nuova occupazione sullo stesso terreno. I consumi fino alla data di fine della vecchia occupazione sono rimasti salvati.
</Accordion>
</Accordions>

## Concetti [#begrippen]

- **Occupazione**: un cliente su un terreno per un periodo. Vedi [occupazione](/begrippen#bezetting).
- **Terreno**: il posto stesso, con eventuali contatori. Vedi [terreno](/begrippen#terrein).
- **Pagato fino al**: la data fino alla quale il cliente ha pagato in anticipo.
- **Fatturato fino al**: la data fino alla quale è già stato fatturato.
- **Periodo di consumo**: il periodo in cui i consumi di un contatore sono attribuiti a un solo cliente. Vedi [batch di consumo](/begrippen#verbruiksbatch).
- **Frequenza affitto**: il ritmo dell'affitto, per esempio annuale o semestrale.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" description="Aggiungere e gestire i clienti" />
  <Card title="Gestione contatori" href="/meterbeheer" description="Come si leggono i contatori e come si collegano alle occupazioni" />
  <Card title="Batch di consumo" href="/meterbeheer/consumptie-batches" description="Come si tengono e si fatturano i periodi di consumo" />
  <Card title="Esempi pratici" href="/praktijk" />
  <Card title="Acquisire un cliente stagionale" href="/praktijk/seizoensklant-binnenhalen" />
  <Card title="Si libera una casa mobile" href="/praktijk/stacaravan-komt-vrij" />
</Cards>


# IVA e imposte (/it-IT/boekhouden/belasting)

Qui leggi come l'IVA finisce sulle tue fatture e come Tillor controlla la partita IVA di un cliente. Il controllo avviene tramite VIES, il servizio europeo con cui si può verificare una partita IVA.

## Aliquote IVA [#btw-tarieven]

Le aliquote IVA si impostano per prodotto. Vai a **Amministrazione > Prodotti** e apri un prodotto per scegliere l'**IVA %** tra le aliquote disponibili (di default 0%, 6%, 9%, 12% e 21%).

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Elenco prodotti - colonna IVA per prodotto" />

## Inversione contabile e altri regimi senza IVA [#btw-verlegd-en-andere-regimes-zonder-btw]

A volte non applichi l'IVA, ma non si tratta di una semplice aliquota 0%: il cliente deve dichiarare l'IVA da sé, oppure la cessione è esente. Nell'elenco di scelta **IVA %** di un prodotto, sotto le aliquote, trovi perciò cinque regimi. Se ne scegli uno, il prodotto resta allo 0% e Tillor sa il perché.

| Regime | Quando | Riquadro nella dichiarazione IVA |
|--------|--------|----------------------------------|
| **Inversione contabile (servizi UE)** | Un servizio per un cliente soggetto a IVA in un altro paese UE | 44 |
| **Inversione contabile (cocontraente)** | Lavori su beni immobili per un cliente belga soggetto a IVA che presenta dichiarazioni periodiche | 45 |
| **Cessione intracomunitaria** | Merci che invii a un cliente soggetto a IVA in un altro paese UE | 46 |
| **Esportazione extra UE** | Merci che lasciano l'UE | 47 |
| **Esente IVA** | Una cessione esente per sua natura (articolo 44 del codice IVA belga) | 00 |

Un regime fa quattro cose che una semplice aliquota 0% non fa:

- **Sulla fattura** accanto alla riga compare `0%*`, e sotto i totali la dicitura di legge del regime, per esempio *Inversione contabile: l'IVA è dovuta dal destinatario*. Se su una fattura ci sono due regimi, il secondo riceve `**`.
- **La contabilizzazione riesce solo con una partita IVA** per i due regimi di inversione contabile e per una cessione intracomunitaria. Inserisci il numero sul profilo del cliente; compare poi anche sulla fattura.
- **Verso la contabilità** la riga va con il codice del regime, così finisce nel riquadro giusto della tua dichiarazione IVA. Vedi [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes).
- **Tramite Peppol** la riga riceve la categoria IVA del regime.

<Callout type="warn" title="Quale regime si applica lo decidi tu">
Tillor non controlla se un cliente o una cessione hanno diritto a un regime. Se hai dubbi, chiedi al tuo commercialista.
</Callout>

## Convalida della partita IVA [#btw-nummer-validatie]

Quando inserisci una partita IVA sul profilo del cliente, Tillor la controlla automaticamente tramite il servizio europeo VIES non appena il paese è compilato.

### Come funziona [#hoe-het-werkt]

1. Apri **Clienti > cliente** (sezione **Dati del cliente**)
2. Imposta il **paese** e inserisci la partita IVA (per esempio `NL123456789B01` o `BE0123456789`)
3. Tillor convalida il numero automaticamente (dopo una breve pausa)
4. Con una partita IVA valida compare una spunta verde; fai clic per vedere i dati aziendali da VIES
5. Vuoi riprendere nome e indirizzo? Fai clic su **Applicare l'indirizzo dell'azienda** in quella finestra (la ragione sociale va nel campo nome)
6. Con una partita IVA non valida compare un'icona rossa con una spiegazione

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Profilo del cliente - Dati del cliente con campi IVA" />

<Callout type="info">
La convalida IVA funziona per tutti i paesi UE. Per le aziende non UE puoi inserire la partita IVA a mano, senza convalida.
</Callout>

### Paesi supportati [#ondersteunde-landen]

La convalida supporta tutti gli Stati membri dell'UE, tra cui Paesi Bassi (NL), Belgio (BE), Germania (DE), Francia (FR) e tutti gli altri paesi UE.

### Codice paese sul PDF della fattura [#landcode-op-de-factuur-pdf]

Sul PDF della fattura Tillor completa automaticamente un codice paese mancante per i paesi in cui è la scrittura abituale: se per un cliente belga inserisci `0123456789`, sulla fattura compare `BE0123456789`. Per Spagna, Italia e Portogallo questo non avviene, perché lì il codice fiscale nazionale si scrive senza codice paese (un NIF spagnolo come `B04876793` resta quindi invariato). Se digiti tu stesso il codice paese nel campo, viene sempre mantenuto.

## Clienti belgi e Peppol [#belgische-klanten-en-peppol]

Per i clienti belgi con una partita IVA deve esserci un **Peppol ID** nella scheda **Fatturazione** prima di poter contabilizzare le fatture. È obbligatorio per legge per la fatturazione B2B in Belgio.

Vedi la [documentazione Peppol](/boekhouden/peppol) per maggiori informazioni.

## IVA sulle fatture [#btw-op-facturen]

Tutte le righe della fattura mostrano automaticamente l'aliquota IVA corretta in base al prodotto collegato. Sulla fattura vedi **Subtotale**, **IVA** e **Totale**; sul PDF della fattura c'è inoltre un riepilogo per aliquota IVA.

<Callout type="info" title="Modificare l'IVA per riga">
Hai i diritti per modificare le impostazioni dell'organizzazione? Vai a **Impostazioni > Fatturazione** e attiva **Menu a tendina aliquota IVA sulle righe fattura in bozza**. Sulle **fatture in bozza** compare allora una colonna per scegliere l'aliquota per riga (le opzioni seguono le aliquote configurate per la vostra organizzazione). Quando selezioni un prodotto, l'aliquota standard del prodotto resta il valore iniziale. Nella stessa colonna scegli anche un [regime senza IVA](#btw-verlegd-en-andere-regimes-zonder-btw) per una riga.
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="La partita IVA del cliente riceve un'icona rossa">
Tillor non ha potuto confermare il numero tramite VIES. Controlla paese e numero. Per un'azienda fuori dall'UE puoi inserire il numero anche senza convalida.
</Accordion>
<Accordion title="Non riesco a contabilizzare una fattura con inversione contabile">
Il cliente non ha una partita IVA. L'inversione contabile e una cessione intracomunitaria esistono solo per un cliente soggetto a IVA. Inserisci il numero in <UIPath>Clienti > cliente</UIPath>, sezione **Dati del cliente**, e contabilizza di nuovo.
</Accordion>
<Accordion title="Non riesco a inviare tramite Peppol una fattura con due regimi">
Una fattura Peppol può riportare un solo motivo per l'assenza di IVA. Metti le righe di ogni regime su una fattura a parte.
</Accordion>
<Accordion title="Mi manca un'aliquota IVA su un prodotto">
Puoi scegliere solo tra le aliquote consentite, di default 0%, 6%, 9%, 12% e 21%.
</Accordion>
<Accordion title="Non riesco a scegliere l'aliquota IVA su una riga della fattura">
La colonna con le aliquote compare solo sulle fatture in bozza e solo se **Menu a tendina aliquota IVA sulle righe fattura in bozza** è attivo.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Prodotti" href="/producten" description="Collegare le aliquote IVA ai prodotti" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Fatturazione elettronica in Belgio" />
  <Card title="Fatture" href="/facturen" description="Creare e contabilizzare le fatture" />
</Cards>


# Metodi di pagamento (/it-IT/boekhouden/betalingsrapporten/betaalmethodes)

I report dei pagamenti contengono pagamenti provenienti da fonti diverse. Solo **Mollie** e i **trasferimenti interni** vengono inviati alla contabilità.

| Metodo | Nel report Tillor | Verso la contabilità |
|---------|-------------------|------------------|
| [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Sì (tramite liquidazione Mollie) | Sì |
| [Conti bancari](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Sì (nel giorno del pagamento) | No |
| [Trasferimento interno](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Sì | Sì |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Report dei pagamenti - pagamenti da fonti diverse" />

```mermaid
flowchart LR
  Mollie[Mollie] --> R[Tillor-rapport]
  Bank[Bankrekeningen] --> R
  Internal[Interne overboeking] --> R
  R --> BH[Boekhouding]
  Mollie --> BH
  Internal --> BH
```

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Conti bancari" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Trasferimento interno" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Trasferimenti interni (/it-IT/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers)

Con **Trasferimento interno** sposti un importo aperto da una fattura a un'altra fattura **contabilizzata** dello **stesso cliente**. Tillor crea un pagamento positivo sulla fattura che stai pagando e un pagamento negativo collegato sulla fattura di destinazione.

Vedi [Trasferimento interno - Registrare](/betalingsverwerking/interne-overboeking) per la procedura passo per passo con schermate.

## Nei report dei pagamenti [#in-betalingsrapporten]

- I trasferimenti interni compaiono nel report dei pagamenti Tillor del giorno in cui li registri (ora di Bruxelles).
- Vanno **sì** nell'esportazione contabile: insieme ai pagamenti Mollie, e **non** insieme ai conti bancari o ad altri metodi manuali (contanti, bonifico, ...).
- Nell'esportazione contabile ogni riga compare come `Tillor - Interne overboeking - {factuurnummer}`, collegata alla fattura e al cliente interessati.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Registrare" href="/betalingsverwerking/interne-overboeking" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Conti bancari" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Mollie (/it-IT/boekhouden/betalingsrapporten/betaalmethodes/mollie)

I pagamenti Mollie (iDEAL, carta di credito, Bancontact, terminale, ecc.) vengono sincronizzati in Tillor e collegati ai report dei pagamenti tramite la **liquidazione Mollie**.

## Collegare in Tillor [#koppelen-in-tillor]

1. Vai a **Impostazioni > Integrazioni** e scegli **Mollie** nell'elenco.
2. Segui i passaggi OAuth di Mollie se il collegamento non è ancora attivo.
3. Nella pagina di dettaglio, sotto **Profilo del sito web**, scegli un **Profilo principale** (il profilo del sito web Mollie per pagamenti e sincronizzazione). Facoltativamente scegli un **Terminale standard** (il POS che Tillor propone di default per le fatture).
4. Fai clic su **Salva**. Senza profilo principale i pagamenti Mollie non funzionano in Tillor; un terminale serve solo per i pagamenti con POS.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-marketplace-install.png" alt="Impostazioni > Integrazioni - Mollie nell'elenco" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-connection-settings.png" alt="Impostazioni Mollie - Profilo principale e Terminale standard" />

### Icone di stato negli elenchi di scelta [#statusiconen-in-de-keuzelijsten]

A sinistra del nome del profilo e del terminale c'è un'icona colorata. È lo stato presso Mollie, non il nome stesso.

| Icona | Profilo del sito web | Terminale |
|-------|----------------|----------|
| Verde (spunta) | Verificato - adatto ai pagamenti live | Attivo - pronto per i pagamenti con POS |
| Arancione (orologio) | Non ancora verificato presso Mollie | In attesa - non ancora attivo |
| Rosso (divieto) | Bloccato | - |
| Grigio | - | Inattivo |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-profile-select-open.png" alt="Profilo principale aperto - icona di stato accanto al nome del profilo" />

Scegli di preferenza un profilo **verificato**. Un terminale **attivo** è facoltativo e serve solo se vuoi proporre pagamenti con POS da Tillor. Senza profilo principale, pagamenti e sincronizzazione non funzionano.

## Liquidazioni Mollie [#mollie-settlements]

Finché Mollie non ha ancora versato un pagamento, questo compare come **anticipo** nel report bozza aperto. Solo alla finalizzazione la liquidazione decide a quale report appartiene; vedi [Pagamenti Mollie nella bozza](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept).

Per il **giorno di report D** Tillor cerca una liquidazione in quest'ordine:

1. Liquidazione **creata il giorno D**
2. Altrimenti liquidazione **creata il giorno D+1** (tipico: l'incasso di D viene versato la mattina dopo)

```mermaid
flowchart TD
  D[Rapportdag D] --> E{Settlement aangemaakt op D?}
  E -- ja --> F[Koppel aan rapport D]
  E -- nee --> G{Settlement aangemaakt op D+1?}
  G -- ja --> F
  G -- nee --> H[Nog geen Mollie op dit rapport]
  F --> I[Eén settlement-id per rapport]
```

**Regole stabilite:**

- Ogni id di liquidazione compare su **al massimo un** report dei pagamenti.
- Un report ha già una liquidazione? Quel collegamento **resta**; Tillor non lo sostituisce.
- Mancano sia D sia D+1 (per esempio nel fine settimana): il report può già esistere con soli pagamenti manuali o di conti bancari; non appena Mollie pubblica, la sincronizzazione giornaliera aggiunge Mollie.

## Esempi [#voorbeelden]

| Giorno di report D | Liquidazione creata presso Mollie | Risultato |
|--------------|----------------------------------|-----------|
| Mar 20 maggio | Mar 20 maggio (`stl_aaa`) | `PAYR/2026/0140` (20 maggio) riceve `stl_aaa` |
| Mar 20 maggio | Mer 21 maggio presto (`stl_bbb`) | `PAYR/2026/0140` (20 maggio) riceve `stl_bbb` (regola D+1) |
| Dom 18 maggio | Lun 19 maggio (`stl_ccc`) | `PAYR/2026/0138` (domenica) riceve `stl_ccc`, **non** il report del lunedì |
| Lun 19 maggio | Lun 19 maggio (`stl_ccc`) | Il report del lunedì cerca una liquidazione propria (`stl_ddd` martedì o dopo), non `stl_ccc` |
| Sab 17 maggio | Nessuna liquidazione sab/dom/lun mattina | Report 17 maggio: prima manuali/conti bancari; Mollie segue quando c'è la liquidazione |
| Mar 20 maggio | Il report esisteva già senza liquidazione | Esecuzione successiva alle 09:00: liquidazione comunque su 20 maggio, pagamenti collegati |

**In concreto (D+1):** l'incasso di **martedì 20 maggio** è nella liquidazione `stl_6necch`, creata **mercoledì 21 maggio** alle 06:08. Tillor collega `stl_6necch` a **`PAYR/2026/0140` (giorno di report 20 maggio)**, non al report del 21 maggio.

**Report esistente:** `PAYR/2026/0140` era già in Tillor senza liquidazione Mollie collegata e con due righe manuali? Dopo la sincronizzazione `stl_6necch` viene comunque collegata; le righe esistenti restano; i pagamenti Mollie di quella liquidazione si aggiungono.

**Già collegato:** il report del **15 maggio** ha già `stl_old`. Tillor **non** modifica quell'id. I singoli pagamenti Mollie con lo stesso id di liquidazione finiscono comunque sul report che ha già quella liquidazione.

## Sincronizzazione sui report esistenti [#synchronisatie-op-bestaande-rapporten]

Dopo aver creato i report mancanti, Tillor cerca **solo report senza liquidazione Mollie collegata** in una finestra mobile di **un mese di calendario prima di ieri** fino a ieri. I report che hanno già una liquidazione Mollie **non** vengono richiesti di nuovo tramite l'elenco delle liquidazioni Mollie.

```mermaid
flowchart TD
  start[Synchronisatie<br/>ma-za 09:00] --> scope[Rapportdag vanaf<br/>maand vóór gisteren t/m gisteren]
  scope --> nullOnly[Alleen rapporten<br/>zonder Mollie-afrekening]
  nullOnly --> U{Zoek settlement voor D of D+1}
  U -- gevonden --> V[Settlement vastleggen]
  U -- niet --> W[Geen Mollie-stap]
  V --> X[Ongekoppelde Mollie-betalingen<br/>uit settlement koppelen]
  X --> Z[Betalingen met dezelfde<br/>settlement-id op dat rapport]
```

I pagamenti che hanno già un id di liquidazione di Mollie ma non sono ancora su un report finiscono sul report con lo stesso id di liquidazione.

## Pagamenti Mollie in Tillor [#mollie-betalingen-in-tillor]

Tillor recupera i pagamenti Mollie **ogni 15 minuti** (per organizzazione con collegamento Mollie attivo). In aggiunta i webhook di Mollie funzionano subito: un pagamento diventa immediatamente **Pagato**, **Rimborsato** o **Stornato**, anche se è nato fuori da Tillor (per esempio un POS). Nel dubbio o se un webhook è andato perso: **Sincronizza** nel menu delle azioni del pagamento.

Un pagamento finisce su un report se:

- è nella **liquidazione** collegata (elenco di Mollie), oppure
- il pagamento ha già un id di liquidazione che appartiene al report.

| Tipo nel report | Significato |
|-----------------|-----------|
| Noto | Pagamento collegato a una fattura in Tillor |
| Sconosciuto | Nessun collegamento a una fattura in Tillor → conto d'attesa 499000, a meno che tu invii i dati contabili tramite Mollie |

I pagamenti di liquidazione che **non** esistono in Tillor compaiono come pagamento Mollie sconosciuto sul report.

Su un report dei pagamenti vedi i pagamenti Mollie collegati nella tabella **Pagamenti**:

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Dettaglio report dei pagamenti - pagamenti e Invia alla contabilità" />

## Metadati Mollie [#mollie-metadata]

Hai una cassa o un altro sistema che crea da sé pagamenti Mollie? Puoi guidare Tillor tramite i metadati di quel pagamento: collegamento a una fattura o a un [gruppo di pagamento](/betalingsverwerking/groepen), oppure direttamente verso la contabilità. I campi sono descritti in [Metadati Mollie](/ontwikkelaars/mollie-metadata).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Report dei pagamenti" href="/boekhouden/betalingsrapporten" />
  <Card title="Gruppi di pagamento" href="/betalingsverwerking/groepen" />
  <Card title="Conti bancari" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Trasferimenti interni" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Metadati Mollie (API)" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Conti bancari (/it-IT/boekhouden/betalingsrapporten/betaalmethodes/ponto)

Il collegamento bancario si connette al tuo conto bancario tramite open banking e recupera automaticamente le transazioni.

## Come funziona [#hoe-het-werkt]

1. **Transazioni**: ogni 5 minuti Tillor recupera le transazioni bancarie dalla tua banca
2. **Comunicazione strutturata**: viene letta la comunicazione +++123/4567/89002+++ oppure il numero di fattura (INV/2024/0001)
3. **Collegamento**: Tillor cerca una fattura corrispondente → il pagamento viene creato e collegato
4. **Doppio bonifico manuale**: se sulla stessa fattura c'è già un bonifico manuale con lo stesso importo, viene eliminato in modo che il pagamento non conti due volte
5. In Tillor vedi quel pagamento come **bonifico bancario**

## Collegare [#koppelen]

L'integrazione si chiama **Conti bancari** e si trova in <UIPath>Impostazioni > Integrazioni > Conti bancari</UIPath>. Inserisci un **ID cliente** e un **Client secret**; un amministratore Tillor ti aiuta con la configurazione e segue l'onboarding.

## Consultare le transazioni bancarie [#banktransacties-bekijken]

Le transazioni bancarie importate si trovano in **Amministrazione > Transazioni bancarie**. Questa pagina è visibile solo agli utenti con il permesso **Visualizza transazioni bancarie**. Senza quel permesso non vedi la pagina nel menu.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-list.png" alt="Elenco delle transazioni bancarie con colonna Fattura" />

Nella tabella **Transazioni** la colonna **Fattura** si trova tra **Data valuta** e **Causale**:

- La transazione è già su una fattura? Allora vedi il numero di fattura come link (per esempio `INV/2026/0001`).
- Ancora nessun collegamento? Apri il menu delle azioni (tre puntini) alla fine della riga e scegli **Assegna a fattura**. Se serve, Tillor crea prima un pagamento e lo collega alla transazione. Per questo ti serve il permesso **Assegna pagamento**; senza quel permesso non vedi questa azione nel menu.
- La transazione è già su una fattura? Apri lo stesso menu delle azioni e scegli **Rimuovi assegnazione fattura** per eliminare il collegamento (sia manuale sia abbinato automaticamente).

Fai clic sull'icona (i) accanto all'IBAN per aprire il pannello di dettaglio di quella transazione: importo, data valuta, controparte e IBAN, causale, i dati dell'estratto conto (riferimento bancario, riferimento del committente, numero della carta, ...), la fattura, il pagamento e il report dei pagamenti collegati, e i riferimenti. Il menu delle azioni è anche in cima a quel pannello.

Nel menu delle azioni puoi inoltre scegliere:

- **Crea attività** per collegare un'attività alla transazione, per esempio per elaborare un pagamento a mano. L'attività mostra la transazione come elemento collegato; fai clic su di essa per aprire il pannello di dettaglio. Vedi [Elementi collegati](/taken/taakdetails#gekoppelde-items).
- **Copia link** per un link che apre la pagina **Transazioni bancarie** con il pannello di dettaglio di quella transazione, per esempio da incollare in un commento o in un messaggio.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-assign-dialog.png" alt="Finestra Assegna a fattura per una transazione bancaria" />

La stessa colonna **Fattura** la vedi su un **report dei pagamenti** nella tabella **Transazioni conto bancario**, finché hai il permesso di lettura.

## Rimuovere il collegamento [#ontkoppelen]

In **Amministrazione > Transazioni bancarie** (e su un report dei pagamenti in **Transazioni conto bancario**) apri il menu delle azioni su una riga collegata e scegli **Rimuovi assegnazione fattura**. Funziona sia per le transazioni collegate a mano sia per quelle abbinate automaticamente.

In **Amministrazione > Pagamenti** **Rimuovi assegnazione fattura** compare solo per i pagamenti che hai collegato o spostato tu stesso a una fattura. In questo modo eviti di eliminare per errore un collegamento automatico corretto dall'elenco dei pagamenti.

<DocScreenshot src="/screenshots/betalingen/payment-unassign-menu.png" alt="Menu delle azioni del pagamento con Rimuovi assegnazione fattura" />

## Sincronizzare a mano [#handmatig-synchroniseren]

In **Amministrazione > Transazioni bancarie** e su un **report dei pagamenti** (tabella **Transazioni conto bancario**) c'è il pulsante **Sincronizza conto bancario** se il collegamento bancario è installato e hai il permesso **Sincronizza transazioni bancarie**. Con esso richiedi una nuova sincronizzazione bancaria; Tillor importa poi le nuove transazioni e cerca di collegarle alle fatture.

Senza collegamento bancario o senza quel permesso il pulsante non compare. Tillor importa le nuove transazioni anche automaticamente, ogni 5 minuti.

Imposti entrambi i permessi in **Impostazioni > Permessi utente** (gruppo **Transazioni bancarie**).

## Nei report dei pagamenti [#in-betalingsrapporten]

I bonifici bancari compaiono **sì** nel report dei pagamenti Tillor della data di pagamento (Bruxelles), insieme ai pagamenti manuali di quel giorno. **Non** vanno nell'esportazione contabile: solo Mollie e i trasferimenti interni. Il collegamento bancario serve soprattutto per l'abbinamento automatico alle fatture in Tillor.

<Callout type="idea" title="Abbinamento automatico">
Il cliente paga con bonifico e comunicazione strutturata → Tillor recupera dalla tua banca → la fattura viene abbinata → pagamento + fattura pagata.
</Callout>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Trasferimenti interni" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Admisol (/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen/admisol)

Admisol è un pacchetto contabile che Tillor supporta per l'invio dei report dei pagamenti. I report dei pagamenti vengono convertiti in XML Admisol e inviati ad Admisol automaticamente o a mano.

## Installazione [#installatie]

1. Vai a **Impostazioni** (indicatore **1** nella schermata) e scegli **Integrazioni**.
2. Cerca **Admisol** nell'elenco delle integrazioni (indicatore **2**) e apri la pagina di dettaglio.
3. Nella pagina di dettaglio inserisci il tuo **Identificativo dell'azienda** e la **Chiave del servizio Web** (dati di Admisol) e fai clic su **Installare**.

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-marketplace-install.png" alt="Impostazioni > Integrazioni - Admisol nell'elenco" />

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-credentials-dialog.png" alt="Dettaglio Admisol - Identificativo dell'azienda e Chiave del servizio Web" />

## Invio automatico [#automatisch-versturen]

Quando un report dei pagamenti **cambia nel contenuto** (per esempio dopo il collegamento di pagamenti o dopo **Ricalcola report**):

1. Tillor controlla se Admisol è installato per l'organizzazione
2. Il report viene convertito in XML Admisol
3. L'XML viene inviato ad Admisol

Nella **creazione giornaliera** (09:00) Tillor passa in rassegna i giorni mancanti **dal più vecchio al più recente**. Ogni nuovo report va ad Admisol solo quando il report precedente ha ricevuto una risposta (accettazione o rifiuto). Se l'invio non riesce, Tillor si ferma per quell'organizzazione fino all'esecuzione successiva.

Il [report bozza](/boekhouden/betalingsrapporten#concept-en-definitief) del giorno in corso va già ad Admisol non appena c'è un pagamento Mollie o un trasferimento interno, e poi di nuovo solo quando la registrazione cambia. I pagamenti in contanti sulla bozza non portano a un invio. I pagamenti Mollie su una bozza vengono controregistrati sul fornitore Mollie **senza riferimento al documento**; Admisol lo registra come **anticipo** ("ancora da ricevere"). I rimborsi che Mollie non ha ancora trattenuto compaiono come seconda riga di anticipo separata su Mollie ("ancora da trattenere"). Con l'invio definitivo, al loro posto arriva il vero versamento con i costi bancari, e i pagamenti che non erano nella liquidazione passano come anticipo alla bozza successiva. Finché il report è in bozza, in Admisol il riferimento del documento è `PAYR/2026/0275 - Concept`; quell'aggiunta scompare con l'invio definitivo. Se il report diventa definitivo il giorno lavorativo successivo, Tillor lo invia di nuovo, ora con la liquidazione Mollie, con **lo stesso numero di documento e la stessa data di registrazione**.

In caso di invio automatico non riuscito ricevi una notifica e compare una riga nella cronologia degli eventi del report.

## Invio manuale [#handmatig-versturen]

1. Vai a **Amministrazione > Report pagamenti**
2. Apri il report che vuoi inviare
3. Fai clic su **"Invia alla contabilità"**

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Report dei pagamenti - Invia alla contabilità" />

## Quali pagamenti vengono inviati? [#welke-betalingen-gaan-mee]

Solo i pagamenti con:

- **Mollie** come provider, oppure
- **Trasferimento interno** come metodo di pagamento

I pagamenti dei conti bancari non vengono inviati alla contabilità.

## Rimborso parziale (Mollie) [#gedeeltelijke-terugbetaling-mollie]

Se un pagamento Mollie collegato è stato rimborsato in parte o del tutto, Tillor invia l'**importo originale del pagamento** nel report dei pagamenti della **liquidazione Mollie in cui il pagamento è arrivato**. Il **rimborso** compare come riga negativa nel report della **liquidazione in cui Mollie detrae il rimborso** (etichetta *Rimborso*). Possono essere liquidazioni successive; più rimborsi ricevono ciascuno la propria riga nel report della propria liquidazione. In questo modo il report corrisponde a ciò che Mollie versa effettivamente. Registrando i rimborsi solo nel giorno di quella liquidazione, non serve alcuna riga aggiuntiva sul conto d'attesa **499000** (*saldo residuo*).

## Costi bancari per fattura Mollie [#bankkosten-per-mollie-factuur]

Mollie trattiene i propri costi a ogni versamento e li fattura una volta al mese. Tillor registra quindi i costi trattenuti **per periodo di fatturazione**: ogni riga porta il mese per cui Mollie fattura i costi, per esempio *Costi bancari 01/2026*. Un versamento nei primi giorni del mese contiene spesso ancora costi del mese precedente; questi compaiono come riga separata nello stesso report.

Tutte le righe dello stesso periodo sommate danno l'importo della fattura Mollie di quel mese. Le righe del mese in corso restano aperte finché Mollie non emette la fattura.

### Sul fornitore Mollie [#op-de-leverancier-mollie]

I costi trattenuti non sono un secondo costo: Mollie ci paga la propria fattura. Tillor li registra quindi sul **fornitore Mollie**, senza riferimento al documento. Il costo e l'IVA arrivano solo tramite la fattura di acquisto Mollie. Ogni mese sul fornitore Mollie punti la fattura contro le righe *Costi bancari* di quel periodo; insieme hanno lo stesso importo. Non serve una correzione tramite un'operazione diversa.

Mollie di solito trattiene i costi di un pagamento già al momento in cui il pagamento arriva, anche se il versamento segue più tardi. Un report bozza registra quindi già quei costi per periodo di fatturazione, e l'anticipo su Mollie è l'importo al netto dei costi. Un pagamento con carta che Mollie trattiene ancora non ha ancora costi trattenuti: quel costo arriva solo sul report con il versamento. Fino ad allora il mese sul fornitore Mollie non è ancora completo.

In Admisol **non puntare righe di un report bozza** (il riferimento del documento termina con *- Concept*). Con l'invio definitivo Admisol sostituisce le righe del report, e i punteggi su quelle righe possono scomparire. Può succedere anche quando reinvii un report definitivo, anche se non è cambiato nulla: controlla poi i punteggi sul fornitore Mollie.

## Riserva di saldo [#balansreserve]

A volte Mollie trattiene una parte del versamento come **riserva di saldo**: denaro che ti spetta ma che Mollie trattiene temporaneamente. Poiché non è né un costo né un rimborso, Tillor registra quell'importo sul **fornitore Mollie** con l'etichetta *Riserva di saldo*, proprio come il versamento stesso. Così resta come credito aperto su Mollie invece che sul conto d'attesa. Se Mollie rilascia poi la riserva, nel report di quella liquidazione compare una riga *Riserva di saldo* di segno opposto che storna di nuovo il credito. Non devi fare nulla; sul fornitore Mollie le due righe si annullano.

## Fatture già punteggiate in Admisol [#facturen-die-in-admisol-al-afgepunt-zijn]

Admisol rifiuta una riga su una fattura o una nota di credito che in Admisol hai punteggiato a mano contro una registrazione diversa dal report dei pagamenti. Tillor registra allora le righe di quella singola fattura sul cliente **senza riferimento al documento**, in modo che il report prosegua comunque. Gli importi e il cliente restano gli stessi; solo il collegamento con la fattura lo ripunti tu in Admisol. Nella cronologia degli eventi del report, nell'XML inviato, è indicato di quale fattura si tratta.

## Parametri contabili [#boekhoudparameters]

Dopo l'installazione imposti i parametri contabili tramite **Impostazioni** sull'app Admisol (stessa schermata di Identificativo dell'azienda e Chiave del servizio Web). Contengono tra l'altro i tipi di documento per fatture e liquidazioni, il codice fornitore Mollie, il conto contabile predefinito per le righe di fattura e il reparto predefinito. I campi mancanti ricevono i valori predefiniti di Tillor.

I pagamenti Mollie sconosciuti vengono registrati sul conto d'attesa **499000**. Per ogni pagamento puoi indicare anche reparto ed esercizio tramite [metadati Mollie](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping).

### Regimi IVA [#btw-regimes]

Una riga di fattura con un [regime senza IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) va ad Admisol con un proprio **profilo di indirizzo fiscale** e un proprio **codice fiscale**. Insieme determinano in quale riquadro della dichiarazione IVA finisce la riga. I valori predefiniti sono quelli di un nuovo dossier Admisol:

| Regime | Profilo di indirizzo fiscale | Codice fiscale | Riquadro |
|--------|------------------|----------|---------|
| Inversione contabile (servizi UE) | `EU` | `vd21` | 44 |
| Inversione contabile (cocontraente) | `MED` | `v21` | 45 |
| Cessione intracomunitaria | `EU` | `v21` | 46 |
| Esportazione extra UE | `EXP` | `v21` | 47 |
| Esente IVA | `NA` | `v0` | 00 |

Se il tuo dossier usa altri codici, modificali nei parametri contabili: per ogni regime c'è un campo per il profilo di indirizzo fiscale e uno per il codice fiscale. I codici del tuo dossier li trovi in Admisol in **Impostazioni > Impostazioni IVA > Relazioni fiscali**. La scheda cliente in Admisol mantiene il proprio profilo di indirizzo fiscale; solo la riga di fattura riceve quello del regime.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Exact Online (/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online)

Exact Online è il pacchetto contabile usato da molti parchi olandesi e dai loro uffici. Tillor collega **clienti**, **fatture contabilizzate** e **report dei pagamenti** a Exact Online. Il collegamento è **disponibile su richiesta** - non ancora in self-service nell'App Marketplace.

<Callout type="info" title="Su richiesta">
Vuoi collegare Tillor a Exact Online? Richiedi l'attivazione tramite la [demo](https://tillor.eu/demo) o scrivi a **support@tillor.eu**. Configuriamo il collegamento insieme al vostro commercialista.
</Callout>

## Cosa copre il collegamento [#wat-de-koppeling-dekt]

L'esportazione prevista segue la stessa catena di [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) e [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). L'esatta mappatura di registri e conti di ricavo la concordiamo all'attivazione.

- **Clienti** da Tillor a Exact Online
- **Fatture contabilizzate** (righe e IVA)
- **Report dei pagamenti** - solo **Mollie** e **trasferimenti interni**, come per le altre esportazioni contabili

I pagamenti dei conti bancari compaiono nel report Tillor, ma non vanno nell'esportazione contabile. Vedi [sistemi contabili](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Ancora nessun self-service [#nog-geen-zelfbediening]

Exact Online non lo trovi ancora in **Impostazioni > Integrazioni**. La scelta dell'amministrazione, la mappatura del piano dei conti e la prima esportazione avvengono insieme al supporto Tillor. Non c'è un modulo di installazione da compilare da soli.

<Callout type="warn" title="Un solo sistema contabile attivo">
Tillor esporta verso un solo pacchetto contabile per organizzazione. Se usi già Admisol o Odoo, concordiamo quale sistema resta attivo.
</Callout>

## Richiedere [#aanvragen]

1. Annota la tua amministrazione Exact Online (divisione) e se il tuo commercialista partecipa.
2. Richiedi il collegamento tramite [tillor.eu/demo](https://tillor.eu/demo) o **support@tillor.eu**.
3. Tillor pianifica l'attivazione e la mappatura di registri e conti di ricavo.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Sistemi contabili" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Panoramica (/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen)

Tillor supporta l'integrazione con il software contabile per l'invio dei report dei pagamenti. I report dei pagamenti vengono convertiti nel formato del tuo pacchetto contabile (attualmente Admisol) e inviati automaticamente o a mano. [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) è disponibile su richiesta.

## Sistemi supportati [#ondersteunde-systemen]

| Sistema | Stato |
|---------|--------|
| [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Supportato |
| [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Clienti e fatture contabilizzate |
| [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | Su richiesta |

## In generale [#algemeen]

- **Automatico**: alla creazione o a un aggiornamento significativo di un report dei pagamenti, questo viene inviato ad Admisol (solo se Admisol è installato)
- **Manuale**: tramite **Amministrazione > Report pagamenti** → apri il report → **Invia alla contabilità**
- **Quali pagamenti**: solo **Mollie** e **trasferimenti interni**. I conti bancari compaiono nel report Tillor, ma non vanno nell'esportazione contabile.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Report dei pagamenti - Invia alla contabilità manualmente" />

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
</Cards>


# Odoo (/it-IT/boekhouden/betalingsrapporten/boekhoudsystemen/odoo)

Il collegamento Odoo in Tillor esporta **clienti** e **fatture contabilizzate** verso Odoo. I report pagamenti verso Odoo arriveranno in una versione successiva; fino ad allora usa [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) se vuoi inoltrare automaticamente i report pagamenti.

## Installazione [#installatie]

1. Vai a **Impostazioni** e apri l'App Marketplace.
2. Cerca la scheda **Odoo** e fai clic su **Installare**.
3. Compila prima sotto **Connessione**:
   - **URL di Odoo** - ad esempio `https://mijnbedrijf.odoo.com` oppure solo `mijnbedrijf` (Tillor completa allora l'URL `.odoo.com`)
   - **Nome utente** - utente con accesso API
   - **Chiave API** - chiave API (Odoo: profilo utente > Chiavi API)
4. Fai clic su **Continua al database**. Tillor recupera i database disponibili (oppure ti lascia inserire il nome a mano).
5. Scegli il database sotto **Database** e completa l'installazione.

Al salvataggio Tillor verifica la connessione.

<Callout type="info" title="Un solo sistema di contabilità attivo">
Se sono installati sia Admisol sia Odoo, per l'esportazione Tillor usa **Admisol** (priorità fissa). Installa Odoo solo se non usi più Admisol.
</Callout>

## Parametri contabili (app Odoo) [#boekhoudparameters-odoo-app]

Dopo l'installazione imposti i parametri di esportazione tramite **Impostazioni** sull'app Odoo (oltre a URL, database, utente e chiave API). Tillor recupera in tempo reale da Odoo i giornali di vendita e i conti dei ricavi; li scegli tramite un campo di ricerca (codice e nome).

| Campo nell'app | Predefinito | Significato |
|---|---|---|
| **Codice del giorno delle vendite** | INV | Giornale di vendita in Odoo con questo codice |
| **Conto delle entrate standard** | 700000 | Conto dei ricavi se la riga della fattura non ha un proprio numero di libro mastro |
| **Pubblica fatture automaticamente** | disattivato | Dopo l'esportazione, contabilizza subito in Odoo |
| **Allega fattura PDF** | attivato | PDF della fattura Tillor come allegato alla fattura Odoo |
| **Allega Peppol UBL** | attivato | UBL Peppol come allegato aggiuntivo (solo se Tillor ha già quell'UBL) |

Per ogni riga di fattura Tillor cerca prima un conto Odoo con lo stesso codice del **numero di libro mastro** della riga; altrimenti il conto dei ricavi standard. Per l'IVA Tillor cerca in Odoo un'IVA di vendita con la stessa percentuale della riga.

### Regimi IVA [#btw-regimes]

Una riga di fattura con un [regime senza IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), come l'inversione contabile, in Odoo ha bisogno di una propria IVA di vendita: un normale 0% finisce nel riquadro sbagliato della tua dichiarazione. Per questo, nelle impostazioni di esportazione, per ogni regime che usi inserisci il **nome dell'IVA di vendita in Odoo**, esattamente come compare in Odoo sotto **Contabilità > Configurazione > Imposte** (in un Odoo belga, ad esempio, `0% EU S` per i servizi UE). Ci sono cinque campi: inversione contabile (servizi UE), inversione contabile (subappaltatore), cessione intracomunitaria, esportazione fuori dall'UE ed esente da IVA.

Se il campo di un regime è vuoto o l'IVA non esiste in Odoo, l'esportazione di quella fattura si interrompe con un messaggio di errore. Inserisci il nome e invia di nuovo la fattura.

## PDF della fattura in Odoo [#factuur-pdf-in-odoo]

Con **Allega fattura PDF** (attivato per impostazione predefinita) Tillor carica lo stesso PDF che c'è in Tillor. In caso di nuova esportazione questo avviene **prima** della contabilizzazione in Odoo, così l'anteprima a destra sulla fattura può essere collegata. Il nome del file segue il numero di fattura Tillor (ad es. `INV_2026_0001.pdf`). Tillor imposta quel PDF anche come allegato principale della fattura Odoo.

In **Eventi** della fattura Tillor vedi se l'esportazione è riuscita, inclusi cliente, fattura, PDF e UBL.

- Se la fattura Odoo esiste già (stesso riferimento: il numero di fattura Tillor), Tillor aggiorna cliente, righe, date e riferimento di pagamento. Se la fattura era già contabilizzata in Odoo, Tillor la riporta prima in bozza, modifica i dati e contabilizza di nuovo quando **Pubblica fatture automaticamente** è attivo o la fattura era già contabilizzata.
- Poi gli allegati PDF e UBL vengono sostituiti o aggiunti quando quelle opzioni sono attive.
- Se il caricamento non riesce dopo una fattura in bozza appena creata, quella fattura Odoo viene eliminata in modo che una nuova esportazione possa riprovare.

## Peppol UBL in Odoo [#peppol-ubl-in-odoo]

Con **Allega Peppol UBL** (attivato per impostazione predefinita) Tillor carica l'UBL Peppol come allegato aggiuntivo sulla fattura Odoo. Il nome del file segue il numero di fattura Tillor (ad es. `INV_2026_0001.xml`).

- Tillor non genera UBL da sé: il file diventa disponibile solo dopo una consegna Peppol riuscita.
- Se l'UBL non è ancora pronto al momento dell'esportazione, Tillor salta l'allegato UBL; non appena l'UBL arriva, viene comunque aggiunto alla fattura Odoo esistente.
- Se il caricamento dell'UBL non riesce, l'intera esportazione Odoo **non** fallisce (a differenza del PDF). Solo un errore del PDF dopo una nuova fattura annulla la bozza Odoo.

## Fatture [#facturen]

- Alla **contabilizzazione** o **ricontabilizzazione** di una fattura, Tillor esporta automaticamente la fattura verso Odoo.
- Manualmente: azioni della fattura > esporta in contabilità (lo stesso pulsante di Admisol).
- Vengono esportate solo le fatture con stato **Contabilizzata**.
- Se esiste già una fattura Odoo con lo stesso numero di fattura Tillor, non ne viene creata una seconda. Tillor aggiorna cliente, righe e date su quella fattura (ad esempio dopo lo spostamento a un altro cliente o la ricontabilizzazione) e sostituisce gli allegati PDF/UBL quando quelle opzioni sono attive.
- Se il PDF della fattura cambia dopo un **pagamento** (o un altro importo sul documento), Tillor sostituisce l'allegato PDF esistente in Odoo non appena il nuovo PDF è pronto. Non viene creata una seconda fattura Odoo e in Odoo non viene registrato alcun pagamento.

## Clienti [#klanten]

I clienti vengono aggiornati o creati in Odoo con il numero cliente Tillor come riferimento. I partner esistenti con lo stesso numero vengono aggiornati.

## Report pagamenti [#betalingsrapporten]

L'invio automatico e manuale dei report pagamenti a Odoo **non è ancora disponibile**. Il processo giornaliero dei report pagamenti salta Odoo senza messaggio di errore.

## Requisiti in Odoo [#vereisten-in-odoo]

- Giornale di vendita con il codice impostato (predefinito `INV`)
- Conti di contabilità generale con codici che corrispondono alle righe Tillor o al conto dei ricavi standard
- Facoltativo: aliquote IVA di vendita in Odoo con le stesse percentuali di Tillor

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Sistemi di contabilità" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Panoramica (/it-IT/boekhouden/betalingsrapporten)

Un **report pagamenti** è un riepilogo giornaliero dei pagamenti di un singolo giorno di calendario. Numerazione: `PAYR/YYYY/DDDD` (giorno dell'anno, quattro cifre; ad es. `PAYR/2026/0054`).

**Contenuto:** pagamenti noti e sconosciuti, l'accredito Mollie (se applicabile) e le transazioni bancarie non collegate dei tuoi conti bancari. Un accredito di Mollie in contabilità si chiama settlement: l'importo che Mollie versa sul tuo conto bancario per una serie di pagamenti.

Il tuo commercialista lavora con questi report. Tu non devi crearli né chiuderli. Vedi anche [Come sono collegate le cose?](/boekhouden#hoe-hangt-dit-samen).

## Bozza e definitivo [#concept-en-definitief]

Un report ha uno **stato**:

| Stato | Significato |
|--------|-----------|
| **Bozza** | Il report del **giorno in corso**. I pagamenti di oggi (giroconti interni, contanti, conti bancari e Mollie) vi vengono già collegati e il report va già alla contabilità. I pagamenti Mollie compaiono come **anticipo**: denaro che Mollie deve ancora versare. Non c'è ancora un settlement Mollie e il report non viene ancora stampato automaticamente. |
| **Definitivo** | La giornata è chiusa. Tillor ha collegato il settlement Mollie (se applicabile), ha stampato il report e ha inviato la versione definitiva alla contabilità. |

Il report in bozza di oggi nasce automaticamente: con l'esecuzione delle 09:00, oppure prima, non appena registri il primo pagamento manuale o il primo pagamento da conto bancario di quel giorno. Non devi mai rendere definitiva una bozza da solo; lo fa Tillor alla prima esecuzione giornaliera dopo la fine della giornata.

Una bozza la riconosci dal **numero di report grigio con sottolineatura tratteggiata** e dal badge **Bozza**, nell'elenco (colonna e filtro **Stato**), nella pagina di dettaglio e ovunque ci sia un collegamento al report. Il PDF di una bozza porta **(bozza)** nel titolo. Il numero del report e la data di registrazione in contabilità restano gli stessi quando la bozza diventa definitiva.

### Pagamenti Mollie sulla bozza [#mollie-betalingen-op-het-concept]

Ogni pagamento Mollie pagato che Mollie non ha ancora accreditato finisce subito sul report in bozza aperto. In contabilità il totale compare come **anticipo sul fornitore Mollie**: così vedi in ogni momento quanto hai ancora da ricevere da Mollie.

Un **addebito diretto SEPA ancora in corso** conta allo stesso modo, anche quando l'incasso parte verso Mollie solo tra qualche giorno. La fattura in Tillor risulta già pagata (in elaborazione), e così compare anche in contabilità. Se l'incasso fallisce o viene annullato, il pagamento sparisce di nuovo dalla bozza.

Quando la bozza diventa definitiva, Tillor confronta il report con il settlement Mollie:

- I pagamenti che **sono nel settlement** restano sul report. L'anticipo viene sostituito dall'accredito reale, con le commissioni bancarie.
- I pagamenti che **non** ci sono (ad esempio carta di credito con accredito successivo, o fatturato dopo la chiusura di Mollie) passano al **report in bozza successivo** e vi restano come anticipo.
- Se un pagamento del settlement era già su una bozza successiva, Tillor lo riporta sul report del settlement.

Vengono considerati solo i pagamenti recenti: pagati nell'ultimo mese e ancora senza settlement presso Mollie.

I **rimborsi** contano subito. Un rimborso che Mollie non ha ancora trattenuto da un accredito compare come riga negativa sulla bozza aperta. In contabilità restano due anticipi separati su Mollie: uno per i pagamenti ancora da ricevere e uno per i rimborsi ancora da trattenere; non vengono compensati tra loro. Questo vale anche quando il pagamento originale è già su un report definitivo più vecchio: Mollie trattiene allora l'importo su un accredito successivo. Non appena un settlement compensa il rimborso, questo compare sul report di quel settlement e sparisce dalla bozza.

<Callout type="info" title="Bozza in contabilità">
Una bozza va alla contabilità non appena contiene qualcosa che la contabilità registra (un pagamento Mollie o un giroconto interno). Poi Tillor la reinvia solo se la registrazione cambia, sempre con lo stesso numero di documento. Le modifiche vengono raggruppate: l'invio parte circa dieci secondi dopo l'ultima modifica e al più tardi dopo un minuto, così ad esempio l'assegnazione di un pagamento a una fattura genera un solo invio. Una bozza con soli pagamenti in contanti o da conti bancari non viene quindi inviata, e un ulteriore pagamento in contanti non provoca un nuovo invio.
</Callout>

## Generazione giornaliera [#dagelijkse-generatie]

Ogni **giorno lavorativo alle 09:00** (dal lunedì al sabato, fuso orario Europa/Bruxelles) Tillor elabora tutti i report **dal 1° gennaio a ieri** che mancano ancora o sono ancora in **bozza**, **dal più vecchio al più recente**: le bozze vengono rese definitive, i giorni mancanti vengono creati subito come report definitivo. Per ogni report Tillor attende la risposta di Admisol (successo o errore) prima di elaborare e inviare il report successivo. Poi Tillor apre il **report in bozza di oggi**. Per ogni organizzazione con collegamento Mollie attivo segue poi una sincronizzazione **limitata**: report **senza** settlement Mollie da **un mese di calendario prima di ieri** fino a ieri (vedi [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)).

```mermaid
flowchart TD
  start[Start werkdag 09:00] --> create[Concepten t/m gisteren definitief maken<br/>ontbrekende dagen aanmaken]
  create --> manual[Handmatige en bankrekeningbetalingen<br/>op rapportdag koppelen]
  manual --> rollover[Niet-uitbetaalde Mollie-betalingen<br/>naar volgend concept]
  rollover --> concept[Conceptrapport van vandaag openen]
  concept --> mollieCheck{Mollie actief?}
  mollieCheck -- nee --> done[Klaar]
  mollieCheck -- ja --> sync[Rapporten zonder settlement<br/>afgelopen maand bijwerken]
  sync --> done
```

### Cosa c'è in un report? [#wat-zit-in-een-rapport]

| Fonte | Quando viene collegato |
|------|-------------------|
| Pagamenti manuali | Giorno di calendario della data di creazione (Bruxelles) |
| Pagamenti da conto bancario | Giorno di calendario della data di pagamento (Bruxelles) |
| Mollie | Settlement per il giorno di report D (vedi [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) |

I pagamenti da conto bancario compaiono **sì** sul report Tillor di quel giorno, ma **non** vanno nell'esportazione contabile (solo Mollie e giroconti interni).

### Ieri senza settlement Mollie [#gisteren-zonder-mollie-settlement]

Il report di **ieri** deve ancora diventare definitivo (o essere ancora creato) e Mollie non ha ancora un settlement per ieri o oggi? Allora Tillor **attende** il giorno lavorativo successivo; il report resta intanto in **bozza**. I giorni più vecchi senza settlement ricevono comunque un report (manuale/conti bancari); Mollie viene collegato più tardi con la sincronizzazione.

<Callout type="warn" title="Fine settimana">
Il fatturato di sabato e domenica ottiene spesso un settlement Mollie solo il lunedì mattina. Questo appartiene al report di **domenica** (regola D+1), non a quello di lunedì. Vedi [esempi nella pagina Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).
</Callout>

## Esempi [#voorbeelden]

| Situazione | Cosa vedi |
|----------|-------------|
| Giorno lavorativo, settlement la mattina dopo | Il report di **ieri** riceve comunque Mollie (regola D+1) |
| Giroconto interno registrato oggi | Compare subito sul **report in bozza di oggi** e va alla contabilità |
| Pagamento Mollie ricevuto oggi | Compare subito sulla bozza, in contabilità come anticipo su Mollie |
| Pagamento Mollie non nel settlement del report | Alla chiusura definitiva passa alla bozza successiva |
| Report di ieri ancora in bozza, nessun settlement | Tillor **attende** che Mollie pubblichi (giorno lavorativo successivo alle 09:00); il report resta in bozza |
| Il report esisteva senza Mollie | L'esecuzione successiva delle 09:00 aggiunge settlement + pagamenti |
| Il report aveva già un id di settlement | L'id **resta**; possono essere collegati ancora solo pagamenti aggiuntivi |

Altri esempi di date (fine settimana, doppio settlement): [Mollie > Esempi](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

## Aprire e navigare un report pagamenti [#betalingsrapport-openen-en-navigeren]

1. Vai a **Amministrazione > Report pagamenti** (indicatore verde **1** nello screenshot).
2. Apri un report nell'elenco.
3. Nella pagina di dettaglio usa le frecce nella barra delle azioni a destra per andare al report precedente o successivo.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Panoramica dei report pagamenti" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Dettaglio del report pagamenti - Invia alla contabilità e frecce di navigazione" />

Passando il mouse su una freccia vedi un contesto aggiuntivo (numero del report, data e numero di pagamenti) del report verso cui navighi.

A destra nella pagina di dettaglio c'è il **Registro eventi**. Qui vedi quando il report è stato creato, quando è diventato definitivo e se è stato inviato alla contabilità.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il report di ieri resta in Bozza">
Mollie non ha ancora pubblicato un accredito per ieri. Tillor attende allora il giorno lavorativo successivo alle 09:00. Il report diventa definitivo da solo, tu non devi fare nulla.
</Accordion>
<Accordion title="Un pagamento non è sul report del giorno che mi aspettavo">
Un pagamento va sul report del giorno in cui è stato ricevuto. Per contanti e bonifico è la **Data di ricezione** che hai inserito. Modifica quella data durante la registrazione, vedi [Contanti e bonifico](/betalingsverwerking/contant).
</Accordion>
<Accordion title="Un pagamento Mollie è sul report successivo">
Il pagamento non era nell'accredito del report. Passa alla bozza successiva e vi resta come anticipo finché Mollie non lo accredita.
</Accordion>
<Accordion title="Il report non è nella mia contabilità">
Vanno solo i pagamenti Mollie e i giroconti interni. Un report con soli pagamenti in contanti o da conti bancari non viene inviato. Un errore durante l'invio lo trovi nel **Registro eventi** del report.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Sistemi di contabilità" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Metodi di pagamento" href="/boekhouden/betalingsrapporten/betaalmethodes" />
</Cards>

## Termini [#begrippen]

- **Report pagamenti**: il riepilogo giornaliero dei pagamenti di un singolo giorno di calendario, con numero `PAYR/anno/giorno`.
- **Bozza**: il report del giorno in corso. Può ancora cambiare.
- **Definitivo**: la giornata è chiusa e il report è stato inviato alla contabilità.
- **Anticipo**: un pagamento Mollie che Mollie non ha ancora accreditato.
- **Settlement**: l'accredito di Mollie a te.


# Panoramica (/it-IT/boekhouden)

Qui trasferisci i pagamenti e le fatture di Tillor al tuo software di contabilità. Tillor raggruppa i pagamenti per giorno in un report pagamenti e lo inoltra, così il tuo commercialista non deve ricopiare nulla.

<Callout type="info" title="Da sapere">
- Viene creato un report pagamenti per ogni giorno di calendario. Il rapporto di oggi esiste già come **Bozza** e diventa definitivo quando la giornata è finita.
- Tillor elabora i rapporti ogni giorno lavorativo (dal lunedì al sabato) alle 09:00, ora belga.
- Solo i pagamenti Mollie e i giroconti interni vanno alla contabilità. Contanti, bonifici e conti bancari compaiono nel rapporto, ma non vengono inoltrati.
- I pagamenti Mollie vengono aggiornati ogni 15 minuti, i conti bancari ogni 5 minuti.
- Mollie di solito effettua il pagamento il giorno successivo. Per il fine settimana l'accredito arriva spesso solo il lunedì mattina.
- Tillor raggruppa le modifiche a una bozza e la invia circa dieci secondi dopo l'ultima modifica, al più tardi dopo un minuto.
- Un cliente belga con partita IVA ha bisogno di un Peppol ID prima che tu possa contabilizzare una fattura.
</Callout>

## Come sono collegate le cose? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  F[Geboekte factuur] --> B[Betaling]
  B --> R[Betalingsrapport van de dag]
  R -- Mollie en interne overboekingen --> X[Boekhoudsoftware]
  R -- Bankrekeningen en contant --> O[Alleen overzicht in Tillor]
```

- Un pagamento è collegato a una fattura. Vedi [Fatture](/facturen).
- Ogni pagamento compare nel rapporto del giorno in cui è stato ricevuto.
- Un pagamento Mollie compare prima come anticipo nel rapporto in bozza. Quando Mollie effettua il pagamento, quell'anticipo diventa il vero accredito.
- Il rapporto va al tuo software di contabilità. Quali sistemi sono possibili lo leggi in [Sistemi di contabilità](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Cosa fa? [#wat-doet-het]

- **Report pagamenti**: riepiloghi giornalieri con il numero `PAYR/YYYY/DDDD`, dove DDDD è il giorno dell'anno
- **Sistemi di contabilità**: collegamento con Admisol, Odoo per clienti e fatture (i report pagamenti verso Odoo seguiranno più avanti) e [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) su richiesta
- **Metodi di pagamento**: Mollie, conti bancari e giroconti interni

**Esempio:** il fatturato del **20 maggio** viene accreditato il **21 maggio** e compare nel rapporto **`PAYR/2026/0140` (20 maggio)**. Altri esempi: [Esempi Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

Nella web app vedi pagamenti e fatture come qui sotto.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Elenco dei pagamenti - Tutti i pagamenti" />

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Elenco delle fatture - Tutte le fatture" />

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Report pagamenti" href="/boekhouden/betalingsrapporten" />
  <Card title="Sistemi di contabilità" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Metodi di pagamento" href="/boekhouden/betalingsrapporten/betaalmethodes" />
  <Card title="IVA e imposte" href="/boekhouden/belasting" />
  <Card title="Peppol" href="/boekhouden/peppol" />
  <Card title="Esempi pratici" href="/praktijk" />
</Cards>

## Termini [#begrippen]

- **Report pagamenti**: il riepilogo dei pagamenti di un singolo giorno di calendario.
- **Bozza**: il rapporto del giorno in corso, che può ancora cambiare.
- **Definitivo**: un rapporto chiuso che è stato inviato alla contabilità.
- **Accredito (settlement)**: l'importo che Mollie versa sul tuo conto bancario per una serie di pagamenti.
- **Anticipo su Mollie**: denaro che Mollie deve ancora versarti, così come risulta in contabilità.
- **Libro mastro**: il numero di conto nella tua contabilità. Vedi [Prodotti](/producten).
- **Peppol**: la rete europea per inviare fatture direttamente al sistema del destinatario. Vedi [Peppol](/boekhouden/peppol).


# Peppol (/it-IT/boekhouden/peppol)

Con Peppol invii una fattura direttamente al sistema di contabilità del destinatario, senza PDF. Peppol è la rete europea per la fatturazione elettronica. In Tillor avviene in automatico: se un cliente ha un Peppol ID, la fattura parte da sola dopo la contabilizzazione.

## Quando usi Peppol? [#wanneer-gebruik-je-peppol]

Peppol è obbligatorio per:

- **Fatture B2B belghe** - l'invio di fatture ad aziende belghe con partita IVA
- **Appalti pubblici** - la fatturazione a enti pubblici nella maggior parte dei paesi UE

Per i clienti olandesi Peppol è facoltativo ma supportato.

<Callout type="warn">
Dal 2026 Peppol è obbligatorio per tutte le fatture B2B in Belgio. Assicurati che i Peppol ID dei tuoi clienti belgi siano impostati correttamente.
</Callout>

## Impostare Peppol [#peppol-instellen]

### Peppol per la tua organizzazione [#peppol-voor-je-organisatie]

Peppol usa la **partita IVA** e l'**indirizzo** della tua organizzazione. Controlla che questi dati siano corretti in **Impostazioni**.

Al primo invio Peppol, Tillor registra automaticamente la tua organizzazione come mittente nella rete Peppol.

<Callout type="info">
Contatta il supporto Tillor se Peppol non è ancora disponibile per la tua organizzazione.
</Callout>

### Impostare il Peppol ID per un cliente [#peppol-id-instellen-voor-een-klant]

Per ogni cliente a cui vuoi fatturare tramite Peppol:

1. Vai a *Clienti > [cliente] > Fatturazione*
2. Apri **Impostazioni di fatturazione**
3. Inserisci il **Peppol ID**, oppure scegli un destinatario con l'icona di ricerca
4. Fai clic su **Salva**

<Callout type="warn">
Hai un cliente belga con partita IVA? Allora non puoi contabilizzare una fattura finché non è impostato un Peppol ID.
</Callout>

## Cercare un destinatario Peppol [#een-peppol-ontvanger-opzoeken]

Non conosci il Peppol ID di un cliente? Usa l'icona di ricerca a sinistra del campo:

1. Vai a *Clienti > [cliente] > Fatturazione*
2. Fai clic sull'icona di ricerca a sinistra di **Peppol ID**
3. Tillor cerca automaticamente in base alla partita IVA del cliente
4. Seleziona il destinatario corretto tra i risultati

<Callout type="info">
Non tutte le aziende sono registrate nella rete Peppol. Se un'azienda non viene trovata, puoi comunque inviare la fattura per e-mail.
</Callout>

## Inviare fatture tramite Peppol [#facturen-via-peppol-versturen]

Quando per un cliente è impostato un Peppol ID, Tillor invia la fattura automaticamente tramite Peppol dopo la contabilizzazione:

1. Crea la fattura come al solito
2. Controlla che il **Peppol ID** del cliente sia impostato correttamente
3. Controlla righe e importi sulla fattura in bozza, poi fai clic su **Contabilizza fattura**

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Fattura in bozza con Contabilizza fattura" />

4. Tillor invia la fattura automaticamente tramite la rete Peppol (di solito entro pochi minuti dalla contabilizzazione)

### Controllare lo stato di invio [#verzendstatus-controleren]

Apri la fattura contabilizzata e guarda **Eventi** nel pannello a destra. Qui vedi se la fattura è stata inviata tramite Peppol, oppure se l'invio o la consegna non sono riusciti.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- La fattura viene inviata automaticamente non appena la contabilizzi. Non devi inviare nulla.
- Una fattura inviata tramite Peppol riceve l'etichetta **Inviata via Peppol** nell'elenco del profilo cliente.
- Una fattura di questo tipo non puoi più riportarla in bozza né spostarla a un altro cliente. Per correggerla usi una nota di credito. Vedi [Correggere una fattura](/facturen/corrigeren).
- Se l'invio non riesce, lo vedi in **Eventi** sulla fattura e c'è una segnalazione in <UIPath>Comunicazione > Notifiche</UIPath>. In quel caso invia la fattura per e-mail, vedi [Inviare una fattura](/facturen/versturen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="La fattura non può essere contabilizzata perché il cliente non ha un Peppol ID">
Il cliente è belga e ha una partita IVA. Inserisci il Peppol ID in <UIPath>Clienti > cliente > Fatturazione</UIPath>, **Impostazioni di fatturazione**. Se non conosci l'ID, usa l'icona di ricerca a sinistra del campo.
</Accordion>
<Accordion title="Non trovo il destinatario nei risultati di ricerca">
Non tutte le aziende sono collegate a Peppol. In quel caso invia la fattura per e-mail.
</Accordion>
<Accordion title="La fattura non è stata inviata tramite Peppol">
Controlla che il Peppol ID del cliente sia compilato prima di contabilizzare.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Fatture" href="/facturen" description="Creare e contabilizzare fatture" />
  <Card title="IVA e imposte" href="/boekhouden/belasting" description="Convalidare le partite IVA" />
  <Card title="Contabilità" href="/boekhouden" description="Panoramica finanziaria" />
</Cards>


# Inviare una fattura o un sollecito (/it-IT/communicatie/e-mails)

Con **Invia notifica** invii una fattura contabilizzata al cliente. Con **Invia promemoria** ricordi al cliente una fattura ancora aperta. Scegli tu se inviare per e-mail, SMS, posta o WhatsApp, e poi segui il recapito in [Notifiche](/notificaties).

Tillor non invia questi messaggi da solo al momento della contabilizzazione. Sei tu a decidere quando il cliente riceve qualcosa. Se vuoi che avvenga in automatico, puoi usare un'[automazione](/begrippen#automatisering).

Prima di iniziare:

- La fattura deve essere **contabilizzata**. Su una fattura in bozza il pulsante non c'è.
- Il cliente ha almeno un indirizzo e-mail, un numero di telefono o un indirizzo postale completo (via, CAP e comune). Altrimenti non vedi **Invia notifica**.
- Per un sollecito deve esserci ancora un importo aperto. Una fattura pagata non offre la scelta **Invia promemoria**.
- Per ogni canale deve essere noto il dato corrispondente. Altrimenti il canale è disattivato, con il messaggio **Nessun indirizzo e-mail registrato**, **Nessun numero di telefono registrato** o **Nessun indirizzo postale registrato**.

## Inviare una fattura [#een-factuur-versturen]

<Steps>
<Step>
### Apri la fattura [#open-de-factuur]
Vai a <UIPath>Amministrazione > Fatture</UIPath> e apri una fattura contabilizzata.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification-button.png" alt="Fattura contabilizzata con il pulsante Invia notifica nella barra delle azioni" />
</Step>
<Step>
### Fai clic su Invia notifica [#klik-op-verstuur-notificatie]
Si apre la finestra **Invia notifica**. Scegli i canali attraverso cui il cliente riceve la fattura.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification.png" alt="La finestra Invia notifica con E-mail, SMS e Posta" />
</Step>
<Step>
### Scegli i canali e fai clic su Invia [#kies-de-kanalen-en-klik-op-versturen]
Tillor segnala **Notifica inviata**. Se non riesce, vedi **Notifica non inviata**.
</Step>
</Steps>

I canali funzionano così:

| Canale | Cosa riceve il cliente |
|---|---|
| **E-mail** | È attivo per impostazione predefinita. La fattura è allegata al messaggio come PDF, all'indirizzo e-mail del profilo cliente |
| **SMS** | Un breve testo con il link personale alla fattura |
| **Posta** | La fattura come lettera all'indirizzo postale del profilo cliente. È disattivato per impostazione predefinita. Tillor mostra un importo indicativo di spedizione per lettera |
| **WhatsApp** | Compare se hai collegato WhatsApp Business. Se la finestra di 24 ore del cliente è chiusa e non hai un metodo di pagamento presso Meta, Tillor blocca l'invio |

## Inviare un sollecito [#een-aanmaning-versturen]

<Steps>
<Step>
### Apri il menu accanto a Invia notifica [#open-het-menu-naast-verstuur-notificatie]
Fai clic sulla freccia accanto al pulsante e scegli **Invia promemoria**.
</Step>
<Step>
### Scegli i canali [#kies-de-kanalen]
Per un sollecito **SMS** è attivo per impostazione predefinita se il cliente ha un numero di telefono. Se scegli **Posta**, il cliente riceve una lettera di sollecito con la fattura allegata e un codice QR sulla lettera. Vedi [Inviare una fattura](/facturen/versturen).

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Invio del sollecito con la scelta di Posta e raccomandata" />
</Step>
<Step>
### Conferma [#bevestig]
Fai clic su **Invia**. Se hai scelto anche **Raccomandata con avviso di ricevimento**, vedi **Invia con costo aggiuntivo**. Questa opzione esiste solo se la posta raccomandata è supportata nel paese dell'indirizzo postale. Tillor addebita i costi aggiuntivi alla tua organizzazione.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il messaggio compare in <UIPath>Comunicazione > Notifiche</UIPath> con canale, stato e un collegamento alla fattura. Lo vedi anche sul cliente.
- E-mail e SMS partono come <Status tone="info">In attesa</Status> e diventano <Status tone="success">Inviato</Status> non appena vengono consegnati. Il cliente può leggere il messaggio e fare clic sul link. Entrambe le cose le ritrovi nella finestra di dettaglio.
- Per la posta lo stato diventa <Status tone="success">Inviato</Status> non appena il servizio postale conferma che la lettera è in viaggio o consegnata. Per la posta vedi l'importo di spedizione al momento dell'invio e, per la raccomandata, anche l'importo aggiuntivo.
- Se un messaggio resta bloccato per più di 5 minuti, Tillor riprova. Dopo 2 giorni senza invio diventa <Status tone="error">Non riuscito</Status>.
- Se il messaggio non riesce, la fattura resta com'era. Puoi sempre inviare di nuovo.

Vuoi che Tillor reagisca da solo, ad esempio avvisando un collega quando un sollecito non riesce? Per questo puoi creare un'[automazione](/begrippen#automatisering).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo il pulsante Invia notifica">
La fattura è ancora una bozza, oppure il cliente non ha né indirizzo e-mail, né numero di telefono, né indirizzo postale completo. Contabilizza la fattura o completa uno di questi dati nel profilo cliente.
</Accordion>
<Accordion title="Non vedo Invia promemoria nel menu">
La fattura è già pagata, oppure non è ancora contabilizzata. Un sollecito è possibile solo per una fattura contabilizzata con ancora un importo aperto.
</Accordion>
<Accordion title="Un canale è disattivato con Nessun indirizzo e-mail registrato">
Il dato manca nel profilo cliente. Aggiungi l'indirizzo e-mail, il numero di telefono o l'indirizzo postale e riapri la finestra.
</Accordion>
<Accordion title="Tillor segnala Notifica non inviata">
Apri <UIPath>Comunicazione > Notifiche</UIPath> e fai clic sul canale del messaggio. Nella finestra di dettaglio trovi il messaggio di errore. Di solito l'indirizzo o il numero non è corretto. Correggilo nel profilo cliente e invia di nuovo.
</Accordion>
<Accordion title="Non vedo Raccomandata sotto Posta">
L'invio raccomandato è possibile solo verso indirizzi postali in paesi in cui Tillor lo supporta. Per altri indirizzi resta possibile la posta ordinaria.
</Accordion>
<Accordion title="Il cliente dice di non aver ricevuto nulla">
Guarda lo stato in <UIPath>Comunicazione > Notifiche</UIPath>. Se il messaggio è su **Respinto**, l'indirizzo non esiste. Se è su **Inviato**, chiedi al cliente di controllare la posta indesiderata. Vedi [Notifiche](/notificaties#problemen).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Notifiche" href="/notificaties" description="Stato di recapito dei messaggi inviati" />
  <Card title="Tipi di notifica" href="/communicatie/notificatietypes" description="Tutti i tipi di messaggio che Tillor invia" />
  <Card title="Inviare una fattura" href="/facturen/versturen" description="Posta, codice QR e lettere di sollecito" />
</Cards>


# Panoramica (/it-IT/communicatie)

In Comunicazione segui tutto ciò che viene detto o inviato tra il tuo parco e i tuoi clienti: telefonate, messaggi che Tillor invia e commenti interni. Qui decidi anche quali messaggi vanno a un cliente e vedi se sono arrivati. Le conversazioni che i clienti avviano tramite chat o social media si trovano nella [inbox](/inbox).

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Panoramica delle telefonate in Comunicazione" />

<Callout type="info" title="Da sapere">
- Un messaggio di fattura o un sollecito non parte mai da solo alla contabilizzazione. Lo avvii tu, oppure un'[automazione](/begrippen#automatisering)
- Se un messaggio resta bloccato per più di 5 minuti, Tillor riprova. Dopo 2 giorni senza invio risulta **Fallito**
- Un SMS con i dati dell'organizzazione puoi inviarlo solo durante una chiamata in corso, dal pannello in basso a destra
- Un nuovo messaggio nella inbox compare come scheda in basso a destra e scompare dopo circa dieci secondi
- Le telefonate arrivano solo dopo che Voys è stato installato e il piano di chiamata punta a Tillor
</Callout>

## Come sono collegate le cose? [#hoe-hangt-dit-samen]

Tutta la comunicazione con un cliente confluisce nel profilo cliente. Ciò che esce e ciò che entra passa attraverso canali diversi.

```mermaid
flowchart LR
  K[Klant] -->|belt| T[Telefoongesprekken]
  K -->|chat, WhatsApp, Messenger, Instagram| I[Inbox]
  P[Park] -->|factuur of aanmaning| N[Notificaties]
  N -->|e-mail, sms, post, WhatsApp| K
  P -->|interne opmerking| O[Opmerkingen]
  T --> KP[Klantprofiel]
  I --> KP
  N --> KP
```

- Le **telefonate** arrivano tramite il tuo provider telefonico e sono collegate al cliente tramite il numero di telefono.
- I **messaggi dei clienti** via chat o social media arrivano nella inbox.
- I **messaggi ai clienti** li invii da una fattura. Il recapito lo segui in Notifiche.
- I **commenti** sono interni. I clienti non li vedono.

## Sezioni [#onderdelen]

<Cards>
  <Card title="Inbox" href="/inbox" description="WhatsApp, Messenger, Instagram e chat del sito web in un unico posto" />
  <Card title="Chiamate telefoniche" href="/communicatie/telefoongesprekken" description="Seguire le chiamate, ascoltare le registrazioni e inviare dati via SMS" />
  <Card title="Inviare una fattura o un sollecito" href="/communicatie/e-mails" description="Inviare tu stesso un messaggio a un cliente" />
  <Card title="Notifiche" href="/notificaties" description="Consultare lo stato di recapito dei messaggi inviati" />
  <Card title="Tipi di notifica" href="/communicatie/notificatietypes" description="Tutti i tipi di messaggio e quando partono" />
  <Card title="Commenti" href="/notities" description="Commenti interni su clienti, fatture e altri record" />
  <Card title="Provider" href="/communicatie/providers" description="Voys e Twilio: chi chiama e chi invia gli SMS" />
</Cards>

## Termini [#begrippen]

- **Provider telefonico**: l'azienda che fornisce la tua linea telefonica, ad esempio Voys.
- **Notifica**: un messaggio che Tillor invia a un cliente o a un [utente](/begrippen#gebruiker).
- **Canale**: il percorso che segue un messaggio, come e-mail, SMS, posta o WhatsApp.
- **Inbox**: il luogo in cui arrivano i messaggi dei clienti via chat e social media.
- **Commento**: una nota interna su un [cliente](/begrippen#klant), una fattura o un altro record.

Altri termini si trovano nel [glossario](/begrippen).


# Tipi di notifica (/it-IT/communicatie/notificatietypes)

Questo elenco mostra ogni tipo di messaggio che puoi incontrare nella [panoramica delle notifiche](/notificaties) e quando Tillor lo invia. Il tipo lo vedi nella colonna **Tipo** e puoi filtrarlo con il filtro **Tipo**. I nomi corrispondono a quelli della schermata.

I messaggi ai clienti vanno per e-mail, SMS, posta o WhatsApp. I messaggi ai colleghi vanno tramite push, e-mail o telefono, secondo le preferenze di quel collega. Vedi [Avvisi nell'app](/notificaties#meldingen-in-de-app).

<Callout type="info" title="I messaggi di fattura non partono da soli">
Messaggi come **Nuova fattura** o **Promemoria fattura** Tillor non li invia automaticamente alla contabilizzazione di una fattura. Li avvii tu con **Invia notifica** o **Invia promemoria** sulla fattura. Vedi [Inviare una fattura o un sollecito](/communicatie/e-mails).
</Callout>

## Fatture e pagamenti [#facturen-en-betalingen]

| Tipo | Quando viene inviato |
|---|---|
| Nuova fattura | Al cliente, quando invii una fattura. La fattura è allegata al messaggio |
| Fattura pagata | Al cliente, quando una fattura è stata pagata |
| Promemoria fattura | Al cliente, come promemoria per una fattura aperta |
| Promemoria bonifico manuale | Al cliente che paga con bonifico, con il consiglio di usare la causale strutturata |
| Archivio fatture | All'indirizzo di supporto della tua organizzazione, con il tuo contabile in copia, quando un archivio di fatture è pronto |
| Invio fattura Peppol non riuscito | Quando una fattura non ha potuto essere inviata tramite Peppol |
| Invio fattura al software contabile non riuscito | Quando l'inoltro di una fattura al tuo software di contabilità non riesce |
| Invio fattura al software contabile ripristinato | Quando quell'inoltro, dopo segnalazioni precedenti, è comunque riuscito |
| Invio report pagamenti al software contabile non riuscito | Quando l'inoltro di un riepilogo dei pagamenti non riesce |
| Fatture ripristinate ricontabilizzate | Quando fatture riportate in bozza sono state ricontabilizzate automaticamente di notte |
| Pagamento bancario che non salda la fattura | Quando un pagamento bancario è collegato a una fattura, ma la fattura risulta ancora aperta |
| Consumo ben sopra il solito, trattenuto dalla fatturazione automatica | Quando un cliente non è stato fatturato automaticamente perché il consumo di elettricità o acqua è molto sopra il solito |
| Prezzo prodotto pianificato applicato | Alla tua organizzazione, il giorno in cui entra in vigore un [prezzo pianificato](/producten/prijzen-plannen). Prezzo vecchio e nuovo sono affiancati |
| Rimborso automatico avvio macchina | Quando un pagamento online per l'avvio di una macchina è stato rimborsato perché la macchina non si è avviata |
| Verifica pagamenti NFC offline | Quando, dopo la sincronizzazione, i pagamenti NFC offline non hanno potuto essere verificati |
| Saldo basso tag NFC | Al cliente quando il saldo di un tag NFC è basso |

## Mandati SEPA e firme [#sepa-mandaten-en-ondertekenen]

| Tipo | Quando viene inviato |
|---|---|
| Richiesta di firma del mandato SEPA | Al cliente con il link per firmare il mandato, anche per i promemoria prima che il link scada |
| Codice di verifica del mandato SEPA | Al cliente con il codice da inserire nella pagina di firma, via SMS o e-mail |
| Copia del mandato SEPA firmato | Al cliente, non appena il mandato è attivo |
| Mandato SEPA revocato | Al cliente, con di nuovo il documento firmato allegato |
| Richiesta di firma | A un firmatario quando è il suo turno, per e-mail o per SMS se non c'è un indirizzo e-mail |
| Codice di firma | Al firmatario con il codice per firmare, via SMS o e-mail |
| Documento firmato | A tutti i firmatari con il PDF firmato, non appena l'ultimo ha firmato |
| Firma rifiutata | Al collega che ha inviato la richiesta, quando un firmatario rifiuta |
| Accettazione DPA | Conferma dell'accettazione del DPA, con il DPA firmato in allegato |
| Codice di verifica DPA | Via SMS al responsabile con il codice per accettare il contratto di trattamento dei dati |

## Contatori, controller e accessi [#meters-controllers-en-toegang]

| Tipo | Quando viene inviato |
|---|---|
| Allarme del contatore | Quando un contatore ha un nuovo allarme |
| Allarme contatore o controller risolto | Quando un allarme del contatore è stato risolto |
| Rimozione contatore | Quando dei contatori sono stati rimossi |
| Contatori che richiedono attenzione | Riepilogo dei contatori le cui misurazioni mancano o che hanno un allarme da molto tempo |
| Controller non raggiungibile | Quando un controller non dà segni di vita per più di 5 minuti |
| Controller surriscaldato | Avviso urgente quando un controller diventa troppo caldo |
| Connettore offline | Quando il connettore del tuo parco non dà più segni di vita |
| Connettore di nuovo online | Quando il connettore è di nuovo raggiungibile |
| Gateway HTTP del connettore non disponibile | Quando il connettore è ancora attivo, ma le telecamere non lo raggiungono più |
| Telecamera LPR offline | Quando una telecamera per targhe non risponde per più di 5 minuti |
| Punto di accesso aperto troppo a lungo | Quando un punto di accesso resta aperto più a lungo del consentito |
| Riepilogo uscite di targhe scadute | Riepilogo dei veicoli con un periodo di accesso scaduto che sono usciti mentre la reception era chiusa |
| Codice QR di accesso | Al cliente con il codice QR per l'accesso |
| Tablet o chiosco offline | Quando un tablet o un chiosco non dà segni di vita fuori dal suo periodo di riposo |
| Batteria di tablet o chiosco quasi scarica | Quando un tablet o un chiosco è quasi scarico e non è in carica |

## Attività, commenti e inbox [#taken-opmerkingen-en-inbox]

| Tipo | Quando viene inviato |
|---|---|
| Attività assegnata | Al collega a cui è stata assegnata un'attività |
| Attività non più assegnata | Al collega a cui è stata tolta un'attività |
| Attività completata | Quando un'attività è stata completata |
| Promemoria attività | Quando è arrivato il momento del promemoria di un'attività |
| Scadenza attività | Quando un'attività raggiunge la scadenza senza essere conclusa |
| Riepilogo giornaliero di una vista | Per e-mail, il riepilogo giornaliero di una vista di attività che segui |
| Risposta a commento | Qualcuno ha risposto a un commento |
| Menzione in commento | Sei stato menzionato in un commento |
| Commento risolto | Un commento è stato contrassegnato come risolto |
| Risposta al commento rifiutata | Quando una risposta e-mail a un commento non è stata pubblicata perché l'indirizzo del mittente non è corretto |
| Messaggio in posta in arrivo | Quando arriva un nuovo messaggio nella inbox |
| Escalation AI urgente | Quando l'assistente AI ti passa una conversazione urgente |
| Follow-up chat sito web | A un visitatore del sito con una risposta non letta, con un link per riprendere la conversazione |

## Automazioni e integrazioni [#automatiseringen-en-integraties]

| Tipo | Quando viene inviato |
|---|---|
| Messaggio dell'automazione | Testo che un'automazione invia a un cliente |
| Avviso dell'automazione | Avviso che un'automazione invia a un collega, via push, e-mail o entrambi |
| Esecuzione dell'automazione non riuscita | Al creatore di un'automazione quando un'esecuzione termina con un errore |
| Consegna webhook non riuscita | Quando le consegne al tuo webhook falliscono e Tillor continua a riprovare |
| Consegna webhook fallita definitivamente | Quando Tillor, dopo tutti i tentativi, non ha potuto consegnare un evento webhook |
| Notifica esterna | Messaggio che un sistema collegato ha inviato da sé, vedi [Notifiche esterne](/notificaties#externe-notificaties) |

Un webhook è un collegamento con cui Tillor trasmette automaticamente un evento a un altro sistema.

## Account e organizzazione [#account-en-organisatie]

| Tipo | Quando viene inviato |
|---|---|
| Benvenuto utente | Messaggio di benvenuto per un nuovo utente |
| Verifica dell'e-mail | Il link per confermare un indirizzo e-mail |
| Invito all'organizzazione | Invito per qualcuno senza account Tillor a entrare nella tua organizzazione |
| Dettagli organizzazione | SMS a un chiamante con un link ai dati della tua organizzazione |
| Invio modulo di contatto | Quando qualcuno compila il modulo di contatto |
| Promemoria orari in un giorno festivo | Promemoria per inserire gli orari di apertura per un prossimo giorno festivo |
| Documento eliminato | All'utente che ha eliminato un documento |

## Avvisi del team Tillor [#meldingen-van-het-tillor-team]

Questi messaggi sono destinati al team Tillor e normalmente non li vedi: **Incidente di sistema**, **Avviso di sicurezza**, **Allarme Grafana** e **Interruzione del gateway LoRa**.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Notifiche" href="/notificaties" description="Stato di recapito e avvisi nell'app" />
  <Card title="Inviare una fattura o un sollecito" href="/communicatie/e-mails" description="Inviare tu stesso un messaggio" />
  <Card title="Automazioni" href="/automatiseringen" description="Messaggi tramite un'automazione" />
</Cards>


# Panoramica (/it-IT/communicatie/providers)

Tramite un provider telefonico come Voys, Tillor vede chi sta chiamando e conserva chiamate, registrazioni e trascrizioni. Colleghi il provider in <UIPath>Impostazioni > Integrazioni</UIPath>. Twilio non è un provider telefonico: invia gli SMS di Tillor ed è stato configurato da Tillor stessa.

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Impostazioni > Integrazioni" />

## Provider disponibili [#beschikbare-providers]

<Cards>
  <Card
    title="Voys"
    href="/communicatie/providers/voys"
    description="Collega le telefonate in arrivo ai profili cliente"
  />
  <Card
    title="Twilio"
    href="/communicatie/providers/twilio"
    description="Recapito di SMS e WhatsApp tramite impostazione di piattaforma"
  />
  <Card title="Inbox" href="/inbox" description="Messenger e WhatsApp Business per la inbox omnicanale" />
</Cards>


# Twilio (/it-IT/communicatie/providers/twilio)

Twilio invia per conto di Tillor gli SMS e, se configurato, le notifiche WhatsApp. Non è un provider di telefonia come Voys e non lo installi tu: Tillor lo ha configurato per l'intera piattaforma.

## Differenza con Voys [#verschil-met-voys]

| | Voys | Twilio |
|---|---|---|
| Telefonia (chiamare, telefonate) | Sì | No |
| Configurazione in Tillor | **Impostazioni > Integrazioni** | No - impostazione di piattaforma |
| Visibile agli utenti | Telefonate, registrazioni, trascrizioni | SMS inviati e notifiche WhatsApp |

## Cosa fa Twilio in Tillor? [#wat-doet-twilio-in-tillor]

Una volta configurato Twilio, Tillor lo usa tra l'altro per:

- **Inviare notifiche SMS** (ad esempio promemoria di pagamento, conferme di prenotazione e notifiche di fattura)
- **Inviare per SMS i dati dell'organizzazione** da **Comunicazione > Chiamate telefoniche** (pulsante SMS con tooltip **Invia informazioni sull'organizzazione al chiamante tramite SMS**)
- **Recapitare notifiche WhatsApp** quando WhatsApp è configurato tramite Twilio sulla piattaforma
- **Usare codici di verifica via SMS** per la firma del contratto di trattamento dei dati (DPA)

Gli SMS e le notifiche WhatsApp inviati li segui in **Comunicazione > Notifiche**:

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Panoramica delle notifiche - stato di recapito dei messaggi" />

<Callout type="info">
Twilio non lo configuri tu in Tillor. Chiedi all'amministratore della piattaforma o al supporto Tillor il collegamento giusto per il tuo ambiente.
</Callout>

## Nessuna installazione in Integrazioni [#geen-installatie-in-integraties]

A differenza di Voys, Twilio **non** si trova in **Impostazioni > Integrazioni**. Il collegamento è gestito dall'amministratore dell'ambiente Tillor.

## Vedi anche [#zie-ook]

<Cards>
  <Card
    title="Telefonia Voys"
    href="/communicatie/providers/voys"
    description="Integrazione di telefonia per le chiamate"
  />
  <Card
    title="Chiamate telefoniche"
    href="/communicatie/telefoongesprekken"
    description="Inviare i dati dell'organizzazione per SMS"
  />
</Cards>


# Telefonia Voys (/it-IT/communicatie/providers/voys)

Con l'integrazione Voys, Tillor vede chi sta chiamando e mostra subito i dati del cliente. Le chiamate, le registrazioni e le trascrizioni finiscono poi in [Chiamate telefoniche](/communicatie/telefoongesprekken). Voys è un fornitore di telefonia per le aziende.

Prima di iniziare:

- Ti serve un account VoIP Voys attivo e l'accesso alle impostazioni del piano di chiamata in Voys.
- Ti serve l'autorizzazione **Gestisci integrazioni**.
- Il numero di telefono di chi chiama deve essere sul profilo cliente o presso una persona di contatto, altrimenti Tillor non collega la chiamata a un cliente.

<DocScreenshot src="/screenshots/communicatie/providers/voys/incoming-call.png" alt="Chiamata in arrivo sulla dashboard" />

## Configurare Voys [#voys-instellen]

1. Vai a **Impostazioni** (nella barra laterale, sotto **Assistenza**)

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-nav.png" alt="Navigazione verso Impostazioni" />

2. Scegli **Integrazioni** e apri **Voys** nell'elenco
3. Nella pagina di dettaglio inserisci i tuoi dati Voys (`username`, `password`, `client_uuid`, `token`) e fai clic su **Installare**

Ti serve un account VoIP Voys attivo.

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-voys.png" alt="Impostazioni > Integrazioni - Voys nell'elenco" />

<Callout type="info">
Dopo l'installazione e la configurazione, Tillor collega automaticamente le chiamate ai clienti quando il numero di telefono corrisponde a un cliente o a un contatto.
</Callout>

## Ritrovare gli URL per Voys [#urls-voor-voys-terugvinden]

Tillor e Voys comunicano tra loro tramite indirizzi (URL). In alcuni passaggi Voys chiede a Tillor una risposta, ad esempio se sei aperto. Quella risposta è **ACK** (sì, continua) oppure **NAK** (no, segui l'altro percorso). Un webhook è un indirizzo di questo tipo che Voys richiama durante una chiamata.

Per i webhook, la ricerca del nome di chi chiama e i codici di accesso usi gli URL che Tillor genera per te.

1. Vai a **Impostazioni > Integrazioni** e apri **Voys**
2. Dopo l'installazione, nella pagina di dettaglio, sotto **Impostazioni**, trovi il blocco **URL da configurare**: copia lì l'URL giusto per ogni scopo

Trovi tra l'altro:

- **Notifiche di chiamata** - URL del webhook per gli eventi delle chiamate
- **Webhook per Beller Lookup** - URL per la ricerca del nome del chiamante (caller name lookup) nel tuo piano di chiamata Voys
- **XML Phonebook** - URL con cui i telefoni VoIP recuperano la rubrica
- **Codici di accesso** - URL per comandare il punto di accesso (sbarra, cancello o porta) tramite il piano di chiamata
- **Webhook degli orari di apertura** - ACK se Tillor è aperto, NAK se Tillor è chiuso
- **Webhook chiamante consentito** - ACK se la chiamata può essere inoltrata, NAK se il chiamante deve andare alla segreteria
- **Webhook di instradamento** - ACK con una destinazione, NAK se non è impostata nessuna destinazione

Nel piano di chiamata Voys usa le stesse variabili indicate in Tillor (come `{callerid}`, `{did}`, `{callername}`, `{callid}` e `{code}`).

<DocScreenshot src="/screenshots/communicatie/providers/voys/config-urls-dialog.png" alt="Dettaglio Voys - URL da configurare nella pagina" />

## Configurare le notifiche di chiamata in Voys [#gespreksnotificaties-in-voys-configureren]

1. In Voys apri il modulo [Notifiche di chiamata](https://freedom.voys.nl/redirect/CallNotification)
2. Fai clic su **Aggiungi**
3. Come pacchetto/servizio scegli **Personalizzato**
4. Incolla l'URL di Tillor preso da **Notifiche di chiamata**
5. Salva

Documentazione di Voys:

- [Notifiche di chiamata](https://help.voys.nl/gespreksnotificaties)

## Configurare i nomi dei chiamanti (caller lookup) nel piano di chiamata [#bellernamen-caller-lookup-in-call-plan-configureren]

Per la ricerca del nome del chiamante usi in Voys un passaggio webhook nel piano di chiamata.

1. In Tillor apri l'URL **Webhook per Beller Lookup** (in **Impostazioni > Integrazioni > Voys**, sotto **URL da configurare**) e copialo
2. In Voys apri il modulo [Webhook](https://help.voys.nl/webhooks) e crea un webhook con questo modello di URL
3. Attiva quel webhook nel piano di chiamata tramite il passaggio webhook
4. Nel modello di URL usa le variabili supportate da Voys (`{callerid}`, `{did}`, `{callername}` e, se necessario, `{code}`)
5. Nell'instradamento del webhook imposta **Variabile nome chiamante**, così il nome restituito viene mostrato sugli apparecchi

I webhook degli orari di apertura e dell'instradamento non cercano il nome del chiamante. Per questo usa questo passaggio separato.

Altri approfondimenti:

- [Webhook](https://help.voys.nl/webhooks)
- [Cosa sono le notifiche di chiamata (differenza rispetto ai webhook)](https://help.voys.nl/gespreksnotificaties)

## Orari di apertura e destinazioni nel piano di chiamata [#openingsuren-en-bestemmingen-in-het-belplan]

Tillor è la fonte per gli orari di apertura, le vacanze e le eccezioni per i giorni festivi. Voys non ha più bisogno di conoscere da sé quel calendario.

1. In **Impostazioni > Integrazioni > Voys** scegli l'apparecchio Voys per **aperto** e, facoltativamente, per **chiuso**
2. Copia **Webhook degli orari di apertura** o **Webhook di instradamento** da **URL da configurare**
3. In Voys crea un [webhook](https://help.voys.nl/webhooks) con quel modello di URL
4. Inserisci quel webhook come passaggio nel piano di chiamata, **sopra** eventuali menu di scelta
5. Lascia disattivato **Usa menu**

Due schemi:

- **Webhook degli orari di apertura** - `status=ACK` segue il percorso **HTTP e menu riusciti** (aperto), `status=NAK` segue **HTTP o menu non riusciti** (chiuso). Se è impostata una destinazione per l'apertura, questa è presente con ACK come `destination`.
- **Webhook di instradamento** - Tillor sceglie la destinazione. Nel passaggio riuscito imposta **Variabile destinazione finale**. ACK + `destination` se c'è una destinazione, altrimenti NAK.

In caso di errore o timeout Voys prende il percorso non riuscito. Trattalo come chiuso.

Documentazione di Voys: [Webhook](https://help.voys.nl/webhooks).

## Inviare automaticamente i chiamanti alla segreteria [#bellers-automatisch-naar-voicemail-sturen]

Con il **Webhook chiamante consentito** lasci che Voys decida, chiamante per chiamante, se una chiamata viene inoltrata. Tillor controlla se il numero del chiamante appartiene a un cliente che ha attivato la segreteria automatica.

Imposta prima il piano di chiamata:

1. Copia **Webhook chiamante consentito** da **URL da configurare** in **Impostazioni > Integrazioni > Voys**
2. In Voys crea un [webhook](https://help.voys.nl/webhooks) con quel modello di URL
3. Inserisci quel webhook come passaggio nel piano di chiamata, **sopra** i passaggi che inoltrano la chiamata
4. Lascia disattivato **Usa menu**
5. Indirizza il percorso **HTTP e menu riusciti** al tuo normale instradamento e il percorso **HTTP o menu non riusciti** alla segreteria
6. In **Impostazioni > Integrazioni > Voys**, sotto **Instradamento chiamate**, seleziona **Segreteria automatica in Voys**

Finché è disattivato, non vedi **Invia le chiamate alla segreteria** sul profilo cliente.

Poi attiva la segreteria automatica per singolo cliente:

1. Apri il profilo cliente e vai alla scheda **Comunicazioni**
2. In **Impostazioni di comunicazione** seleziona l'opzione **Invia le chiamate alla segreteria**
3. Fai clic su **Salva**

Ecco come funziona la risposta:

- **ACK** - il chiamante può passare. Vale anche per i numeri sconosciuti e per i chiamanti con numero nascosto.
- **NAK** - il numero appartiene a un cliente con segreteria automatica. Voys segue il percorso non riuscito.

Tillor confronta il numero del chiamante con il numero di telefono sul profilo cliente, indipendentemente da spazi o notazione del prefisso internazionale. I numeri di telefono delle persone di contatto non contano.

<Callout type="warn">
In caso di errore o timeout Voys prende anch'esso il percorso non riuscito. In quel caso tutti i chiamanti vanno temporaneamente alla segreteria, non solo quelli bloccati. Usa quindi una destinazione di segreteria in cui controlli regolarmente i messaggi.
</Callout>

Questo webhook non tiene conto degli orari di apertura. Combinalo con il webhook degli orari di apertura o di instradamento inserendo entrambi come passaggi separati nel piano di chiamata.

Documentazione di Voys: [Webhook](https://help.voys.nl/webhooks).

## Instradamento fisso per chiamante [#vaste-routering-per-beller]

Lo stesso **Webhook di instradamento** può inoltrare subito un chiamante a un apparecchio Voys, a un interno o a un numero di telefono specifico. Questo vale solo per i clienti per i quali hai scelto una destinazione e solo se **Instradamento fisso in Voys** è attivo.

1. Inserisci il **Webhook di instradamento** nel piano di chiamata, come per gli orari di apertura
2. Nel passaggio riuscito imposta **Variabile destinazione finale**
3. In **Impostazioni > Integrazioni > Voys**, sotto **Instradamento chiamate**, seleziona **Instradamento fisso in Voys**

Finché è disattivato, non vedi **Instradamento fisso delle chiamate** sul profilo cliente. Il webhook usa allora solo l'apparecchio per aperto o chiuso.

Imposta poi la destinazione per singolo cliente:

1. Apri il profilo cliente e vai alla scheda **Comunicazioni**
2. In **Instradamento fisso delle chiamate** scegli un apparecchio Voys, oppure **Altro** per un numero di telefono o un interno (ad esempio 411)
3. Scegli **Nessuno** per disattivare l'instradamento fisso
4. Fai clic su **Salva**

Ecco come il webhook di instradamento sceglie la destinazione:

- Se per questo chiamante c'è una destinazione fissa, quella è `destination`.
- Altrimenti `destination` è l'apparecchio Voys per aperto o chiuso.
- **NAK** - non c'è né una destinazione fissa né un apparecchio per lo stato attuale. Vale anche per i numeri sconosciuti e per i chiamanti con numero nascosto, finché non c'è un apparecchio per aperto o chiuso.

Tillor confronta il numero del chiamante con il numero di telefono sul profilo cliente, indipendentemente da spazi o notazione del prefisso internazionale. I numeri di telefono delle persone di contatto non contano.

In caso di errore o timeout Voys prende il percorso non riuscito.

Documentazione di Voys: [Webhook](https://help.voys.nl/webhooks).

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Ogni chiamata in arrivo o in uscita compare in <UIPath>Comunicazioni > Chiamate telefoniche</UIPath>, con il cliente accanto se il numero corrisponde. Vedi [Chiamate telefoniche](/communicatie/telefoongesprekken).
- Quando arriva una chiamata, il chiamante compare come scheda in basso a destra in Tillor, con i dati del cliente.
- Le registrazioni e le trascrizioni arrivano non appena la chiamata è terminata, se le registrazioni delle chiamate sono attive nel tuo account Voys.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo il blocco URL da configurare">
Il blocco compare solo dopo l'installazione. Fai prima clic su **Installare** nella pagina di dettaglio di Voys.
</Accordion>
<Accordion title="In Tillor non arriva nessuna chiamata">
Voys inoltra le chiamate solo se il modulo Notifiche di chiamata usa l'URL **Notifiche di chiamata** di Tillor. Controlla in Voys che l'URL sia presente e che provenga dal blocco **URL da configurare**.
</Accordion>
<Accordion title="Il nome del chiamante non compare sull'apparecchio">
Controlla che il webhook per la ricerca del nome del chiamante sia nel piano di chiamata e che **Variabile nome chiamante** sia impostata nel passaggio riuscito. I webhook per gli orari di apertura e l'instradamento non cercano nomi.
</Accordion>
<Accordion title="Non vedo Invia le chiamate alla segreteria sul profilo cliente">
Seleziona prima **Segreteria automatica in Voys** in <UIPath>Impostazioni > Integrazioni > Voys</UIPath>, sotto **Instradamento chiamate**. Solo dopo l'opzione compare nella scheda **Comunicazioni** del cliente. Lo stesso vale per **Instradamento fisso delle chiamate**.
</Accordion>
<Accordion title="All'improvviso tutti i chiamanti vanno alla segreteria">
In caso di errore o timeout di un webhook Voys prende il percorso non riuscito. Controlla che Tillor sia raggiungibile e che l'URL nel webhook sia ancora corretto. Vedi l'avviso in [Inviare automaticamente i chiamanti alla segreteria](#bellers-automatisch-naar-voicemail-sturen).
</Accordion>
<Accordion title="Una chiamata non appartiene a un cliente">
Tillor confronta il numero con il numero di telefono sul profilo cliente. I numeri delle persone di contatto contano per il collegamento delle chiamate, ma non per la segreteria e l'instradamento fisso.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card
    title="Chiamate telefoniche"
    href="/communicatie/telefoongesprekken"
    description="Azioni sulle chiamate, come i dati dell'organizzazione via SMS"
  />
  <Card title="Gestione clienti" href="/klantenbeheer" description="Profili cliente e dati di contatto" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Come vengono inviati gli SMS" />
</Cards>


# Chiamate telefoniche (/it-IT/communicatie/telefoongesprekken)

In <UIPath>Comunicazioni > Chiamate telefoniche</UIPath> trovi ogni chiamata in arrivo o in uscita tramite il tuo fornitore di telefonia, con il cliente accanto se Tillor riconosce il numero. Usi la pagina per seguire le chiamate e, durante una chiamata in corso, per inviare via SMS al chiamante i dati della tua organizzazione.

Prima di iniziare:

- Le chiamate compaiono solo dopo aver installato e configurato [Voys](/communicatie/providers/voys). Senza collegamento l'elenco resta vuoto.
- Le registrazioni e le trascrizioni esistono solo se le registrazioni delle chiamate sono attive nel tuo account Voys.
- Il pulsante SMS in una chiamata in corso funziona solo se l'invio di SMS è configurato per il tuo ambiente. Vedi [Twilio](/communicatie/providers/twilio).

## Vedere le chiamate [#gesprekken-bekijken]

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Panoramica delle chiamate telefoniche" />

Nella tabella **Tutte le conversazioni** vedi per ogni chiamata:

| Colonna | Cosa vedi |
|---|---|
| **Direzione** | **In arrivo** o **In uscita** |
| **Iniziato il** | Data e ora |
| **Da** e **A** | I numeri di telefono |
| **Durata** | La durata della chiamata, a chiamata conclusa |
| **Cliente** | Il cliente collegato, oppure un nome comunicato da Voys (non verificato) se non c'è nessun cliente |
| **Stato** | A che punto è la chiamata |

Tillor collega una chiamata a un cliente in base al numero di telefono. Se il numero non appartiene ancora a un cliente, aggiungilo al profilo cliente o a una persona di contatto. Le nuove chiamate vengono poi collegate automaticamente.

Una chiamata attraversa questi stati:

| Stato | Significato |
|---|---|
| <Status tone="info">Creato</Status> | La chiamata è appena iniziata |
| <Status tone="info">Squillo</Status> | Il telefono squilla |
| <Status tone="warning">Risposto</Status> | Qualcuno ha risposto |
| <Status tone="warning">Nella conversazione</Status> | La chiamata è in corso |
| <Status tone="warning">Interconnessione calda</Status> e <Status tone="warning">Interconnessione fredda</Status> | La chiamata è stata trasferita, con o senza annuncio |
| <Status>Appeso</Status> e <Status>Terminato</Status> | La chiamata è finita |
| <Status tone="error">Fallito</Status> | La chiamata non è stata stabilita |

## Inviare i dati dell'organizzazione via SMS [#organisatiegegevens-via-sms-versturen]

Un chiamante chiede il tuo indirizzo o gli orari di apertura? Invia tutto via SMS in pochi secondi, mentre la chiamata è in corso.

<Steps>
<Step>
### Attendi che la chiamata sia in corso [#wacht-tot-het-gesprek-loopt]
L'azione si trova nel pannello delle chiamate attive in basso a destra, non nell'elenco. La chiamata deve avere lo stato **Nella conversazione**. Su un telefono tocca prima l'icona del telefono in alto a destra.
</Step>
<Step>
### Espandi la chiamata [#klap-het-gesprek-uit]
Se la chiamata è ridotta, espandila.
</Step>
<Step>
### Fai clic sull'icona del messaggio [#klik-op-het-berichtenpictogram]
Il suggerimento dice **Invia informazioni sull'organizzazione al chiamante tramite SMS**.
</Step>
<Step>
### Scegli la lingua [#kies-de-taal]
Tillor contrassegna con *(rilevato)* la lingua che riconosce nel chiamante. Scegli la lingua dell'SMS.
</Step>
</Steps>

Il chiamante riceve un breve link a una pagina pubblica con i dati della tua organizzazione. Se l'indirizzo della tua organizzazione è compilato, ci sono anche i pulsanti di percorso per **Waze**, **Google Maps** e **Apple Maps**. Il pulsante email in quella pagina ha già un oggetto e un testo, con il numero e l'ora della chiamata se noti. Il link al sito web riceve dei tag di tracciamento, così puoi misurare quanti chiamanti fanno clic.

## Registrazioni e trascrizioni [#opnames-en-transcripties]

<Steps>
<Step>
### Apri la chiamata [#open-het-gesprek]
Nell'elenco, fai clic su **Trascrizione** accanto alla chiamata. Si apre la finestra **Dettagli della chiamata**.
</Step>
<Step>
### Scegli una scheda [#kies-een-tabblad]
In **Assunzione** la chiamata viene riprodotta nel browser. In **Trascrizione** trovi il testo trascritto per interlocutore, e in **Riepilogo** un breve riassunto.
</Step>
</Steps>

Tillor crea da sé la trascrizione e il riepilogo non appena la chiamata è conclusa e c'è una registrazione. Ci vuole un po' di tempo. Per una chiamata senza registrazione non ci sono schede.

<Callout type="warn">
Le registrazioni delle chiamate possono contenere informazioni sensibili per la privacy. Assicurati di rispettare la normativa sulla privacy (GDPR) quando registri le chiamate e informa i chiamanti che le chiamate vengono registrate.
</Callout>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- A chiamata conclusa, la chiamata compare nell'elenco con la durata, il cliente e, se c'è una registrazione, una trascrizione e un riepilogo.
- Un SMS inviato con i dati dell'organizzazione compare in <UIPath>Comunicazioni > Notifiche</UIPath> con il tipo **Dettagli organizzazione**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'elenco delle chiamate è vuoto">
Controlla che Voys sia installato in <UIPath>Impostazioni > Integrazioni</UIPath> e che le notifiche di chiamata in Voys puntino all'URL di Tillor. Vedi [Telefonia Voys](/communicatie/providers/voys).
</Accordion>
<Accordion title="Una chiamata non appartiene a un cliente">
Tillor confronta il numero del chiamante con il numero di telefono sul profilo cliente o presso una persona di contatto. Aggiungi il numero e le nuove chiamate verranno collegate. Le chiamate già arrivate restano come erano.
</Accordion>
<Accordion title="Non trovo il pulsante SMS">
Il pulsante è solo nel pannello delle chiamate attive in basso a destra e solo mentre la chiamata ha lo stato **Nella conversazione**. Nell'elenco di questa pagina non c'è.
</Accordion>
<Accordion title="Non vedo la scheda Assunzione">
Voys non ha registrato la chiamata. Attiva le registrazioni delle chiamate nel tuo account Voys. Le chiamate precedenti non possono essere registrate a posteriori.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Telefonia Voys" href="/communicatie/providers/voys" description="Installare Voys e configurare il piano di chiamata" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Come vengono inviati gli SMS" />
  <Card title="Notifiche" href="/notificaties" description="Stato di consegna degli SMS inviati" />
</Cards>


# Connector (/it-IT/connector)

Il Tillor Connector è una piccola scatola nella rete del tuo parco. Collega Tillor ai dispositivi in loco: stampanti di scontrini, sbarre, controller di accesso e lettori di documenti. Senza connector, Tillor non può comandare questi dispositivi. Se è spento, la stampa e il comando delle sbarre da Tillor non funzionano. Come proseguire in quel caso è spiegato in [Problemi](#problemen).

Tillor consegna il connector già configurato e lo monitora da remoto. Tu non devi installare né aggiornare nulla.

<Callout type="info" title="Da sapere">
- Ogni organizzazione ha un solo connector. Se gestisci più parchi, ogni parco (organizzazione) riceve la propria scatola.
- Il connector si annuncia a Tillor ogni 15 secondi.
- Se Tillor non sente nulla per 3 minuti, il team di Tillor riceve automaticamente una segnalazione.
- Gli aggiornamenti li installa Tillor stesso, senza che tu debba fare nulla.
- Il connector stabilisce da sé una connessione sicura in uscita. Non devi aprire porte nel tuo router.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

Il connector sta tra Tillor su internet e i dispositivi nella tua rete. Tillor invia un comando al connector, e il connector lo esegue sul dispositivo giusto. Al contrario, il connector segnala cosa è successo, ad esempio una targa letta.

```mermaid
flowchart LR
  T[Tillor] <-->|beveiligde verbinding via internet| C[Connector in je park]
  C --> P[Bonnenprinter]
  C --> S[Slagboom of toegangscontroller]
  C --> I[Identiteitslezer]
```

Ad esempio:

- Stampi uno scontrino o un'etichetta. Tillor lo invia al connector, che lo manda alla tua stampante.
- Dai a un cliente un metodo di accesso. Tillor invia la modifica tramite il connector ai controller di accesso, vedi [Controllo accessi](/toegangscontrole#hoe-hangt-dit-samen).
- Un ospite scansiona una carta d'identità al check-in. Il connector inoltra la scansione a Tillor, vedi [Scansioni dei documenti d'identità](/identiteitsscans).

## Cosa fa Tillor per te [#wat-tillor-voor-je-doet]

- **Consegna**: la scatola arriva già configurata per la tua organizzazione.
- **Installazione e collegamento**: colleghiamo le tue stampanti, sbarre e scanner durante l'avvio.
- **Aggiornamenti**: le nuove versioni vengono installate automaticamente, senza interruzioni.
- **Monitoraggio**: Tillor vede se il connector è connesso e in caso di interruzione si attiva da solo.

## Cosa ti serve [#wat-je-zelf-nodig-hebt]

- Una presa di corrente vicino alle tue apparecchiature di rete
- Un cavo di rete verso il tuo router o switch, nella stessa rete delle tue stampanti e sbarre
- Una connessione internet stabile

## Dispositivi collegati [#gekoppelde-apparaten]

- **Stampanti**: vedi [Stampante](/printer) per configurazione e uso.
- **Sbarre, cancelli e controller di accesso**: vedi [Controllo accessi](/toegangscontrole).
- **Lettori di documenti**: vedi [Scansioni dei documenti d'identità](/identiteitsscans) per creare clienti da una scansione e per i periodi di conservazione.

<Callout type="info" title="Per il lettore tecnico">
Nella rete del tuo parco puoi vedere lo stato del connector su `http://[adres-van-de-connector]:3000/`. Vi trovi la connessione con Tillor, la coda di stampa e le ultime targhe lette. Il supporto di Tillor ti comunica l'indirizzo durante l'installazione. Altri dettagli sul protocollo sono in [MQTT](/ontwikkelaars/mqtt).
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il connector non è connesso">
Controlla che la scatola riceva corrente e che il cavo di rete sia ben inserito. Verifica che internet nel tuo parco funzioni. Poi stacca un attimo la spina dalla scatola e reinseriscila. Se il problema persiste, contatta il supporto di Tillor. Un'interruzione di solito la vediamo già noi.
</Accordion>
<Accordion title="Non riesco a stampare o a comandare una sbarra">
Guarda prima lo stato del connector, vedi il consiglio tecnico qui sopra. Controlla che il dispositivo sia acceso e nella stessa rete. Se il connector è connesso e il dispositivo è raggiungibile ma non succede nulla, contatta il supporto.
</Accordion>
<Accordion title="I nuovi metodi di accesso non arrivano alla barriera">
Guarda sotto **Operazioni controller** nella pagina Controllo accessi. Se un comando resta su **In attesa**, il connector è offline.
</Accordion>
</Accordions>

## Concetti [#begrippen]

- **Connector**: la scatola nel tuo parco che collega Tillor ai tuoi dispositivi.
- **Controller di accesso**: una scatola presso una sbarra che legge tag e codici QR.
- **Soluzione gestita**: Tillor consegna, configura e mantiene la scatola per te.

Altre spiegazioni sono nel [glossario](/begrippen).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Controller" href="/controllers" description="Lettori di tag presso docce, porte e punti di ricarica" />
  <Card title="Stampante" href="/printer" description="Configurare e usare le stampanti" />
  <Card title="Controllo accessi" href="/toegangscontrole" description="Sbarre e metodi di accesso" />
  <Card title="Scansioni dei documenti d'identità" href="/identiteitsscans" description="Scansionare le carte d'identità al check-in" />
</Cards>


# Documenti (/it-IT/documenten)

Con la gestione dei documenti conservi i file presso un cliente, come polizze assicurative, carte d'identità, contratti, permessi e altri allegati. I file che non appartengono ancora a nessuno restano nell'elenco centrale dei documenti finché non li colleghi a un cliente. Inizia da [Documenti presso un cliente](#documenten-bij-een-klant) o da [L'elenco centrale dei documenti](#de-centrale-documentenlijst).

<Callout type="info" title="Da sapere">
- Un file può pesare al massimo 250 MB.
- Puoi caricare PDF, Word, messaggi Outlook (.msg), Excel, PowerPoint, immagini (JPEG, PNG, GIF) e file di testo.
- Dopo il caricamento Tillor converte le immagini in PDF. Gli altri tipi di file restano come sono, con un'anteprima PDF accanto.
- Quando elimini un documento, ricevi una copia come allegato al tuo indirizzo email, se è stato possibile metterlo al sicuro.
- Un PDF che appartiene a una richiesta di firma, e il PDF firmato, puoi archiviarli ma non eliminarli.
- Un documento archiviato viene conservato, ma non compare più tra i documenti attivi.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  U[Upload of e-mail] --> C[Centrale documentenlijst]
  C -->|Koppelen aan klant| K[Documenten van de klant]
  K --> S[Ondertekenverzoek]
  S --> O[Ondertekende PDF bij de klant]
  M[SEPA-mandaat] --> K
```

Un documento sta in un solo posto: o nell'elenco centrale, o presso un cliente. Se lo colleghi a un cliente, sparisce dall'elenco centrale. I PDF firmati e i mandati firmati finiscono automaticamente tra i documenti del cliente.

## Documenti presso un cliente [#documenten-bij-een-klant]

### Vedere i documenti [#documenten-bekijken]

1. Vai a <UIPath>Clienti > Panoramica</UIPath> e apri il profilo del cliente.
2. Fai clic sulla scheda **Documenti**.
3. Vedi i documenti di questo cliente, divisi tra **Attiva** e **Archiviati**.
4. Fai clic su un documento (o sull'occhio) per vederlo a destra in **Anteprima**. Con l'icona di download lo salvi.

### Modificare, spostare o archiviare un documento [#een-document-bewerken-verplaatsen-of-archiveren]

Il menu **…** accanto a un documento contiene **Modifica**, **Sposta a cliente**, **Scarica**, **Archivia** (o **Ripristina**) ed **Elimina**.

### Eliminare un documento [#een-document-verwijderen]

Prima di iniziare: un documento che appartiene a una richiesta di firma non puoi eliminarlo. Archivialo.

<Steps>
<Step>
### Scegli Elimina [#kies-verwijderen]
Scegli **Elimina** nel menu **…** accanto al documento.
</Step>
<Step>
### Conferma [#bevestig]
Conferma nella finestra di dialogo con **Elimina**, oppure annulla con **Annulla**. L'eliminazione non può essere annullata.

<DocScreenshot src="/screenshots/documenten/document-delete-dialog.png" alt="Finestra di conferma per l'eliminazione del documento" />
</Step>
</Steps>

Dopo l'eliminazione ricevi al tuo indirizzo email dell'account un messaggio con il documento eliminato come allegato, così di solito hai a portata di mano una copia.

### Far firmare un documento [#een-document-laten-ondertekenen]

Sotto i documenti di un cliente trovi le **Richieste di firma**. Con **Richiedi firme** fai firmare online un PDF dal cliente, da una persona di contatto, da un collega o da una parte esterna. Il PDF firmato compare tra i documenti come **[titolo] (firmato)**, con il tipo **Accordo firmato** se il PDF originale non aveva un tipo. Vedi [Firme](/handtekeningen).

## L'elenco centrale dei documenti [#de-centrale-documentenlijst]

Oltre ai documenti presso i clienti, Tillor ha un elenco centrale. Qui compaiono i file non ancora collegati a un cliente, ad esempio documenti che arrivano via email. Vai a <UIPath>Amministrazione > Documenti</UIPath>.

<DocScreenshot src="/screenshots/documenten/documents-upload.png" alt="Elenco centrale dei documenti con area di caricamento" />

### Caricare un documento [#een-document-uploaden]

<Tabs items={["Slepen of kiezen", "Per e-mail"]}>
<Tab value="Slepen of kiezen">
Trascina un file nell'area di caricamento, oppure fai clic su **Seleziona file**. Il file viene salvato automaticamente e compare come nuovo elemento nell'elenco.
</Tab>
<Tab value="Per e-mail">
Nell'area di caricamento c'è un indirizzo email speciale. Invia il file come allegato a quell'indirizzo e comparirà da solo nell'elenco centrale.
</Tab>
</Tabs>

### Collegare un documento a un cliente [#een-document-koppelen-aan-een-klant]

Ogni documento nell'elenco centrale ha un modulo di modifica e un pannello di anteprima.

<Steps>
<Step>
### Trova il documento [#zoek-het-document]
Vai a <UIPath>Amministrazione > Documenti</UIPath> e scorri fino al documento.
</Step>
<Step>
### Compila i campi [#vul-de-velden-in]
- **Nome documento**: il nome del documento.
- **Assegna a cliente**: il cliente a cui appartiene questo documento (facoltativo).
- **Tipo di documento**: ad esempio **Polizza assicurativa**, **Prova di pagamento dell'assicurazione**, **Carta d'identità**, **Mandato SEPA**, **Accordo firmato** o **Altro** (facoltativo).
- **Data di scadenza assicurazione**: la data in cui scade un'assicurazione o un permesso. Questo campo compare solo per i tipi di documento che possono avere una data di scadenza.
- **Note**: appunti liberi sul documento (facoltativo).
</Step>
<Step>
### Salva [#sla-op]
Fai clic su **Salva modifiche**.
</Step>
</Steps>

### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il documento sparisce dall'elenco centrale e si trova nella scheda **Documenti** di quel cliente.
- Se hai compilato una **Data di scadenza assicurazione**, la vedi come etichetta accanto al documento.

## Suggerimenti IA per i documenti [#ai-suggesties-bij-documenten]

Quando carichi un PDF, Tillor ne analizza il contenuto in background. Se Tillor riconosce un nome che corrisponde a un cliente nella tua amministrazione, accanto a **Assegna a cliente** compare un pulsante di suggerimento con il nome del cliente e una percentuale che indica quanto Tillor è sicuro. Può comparire un suggerimento anche per una data di scadenza dell'assicurazione.

Fai clic sul pulsante per accettare il suggerimento, oppure scegli tu un altro cliente. Un suggerimento è sempre una proposta. Fai clic su **Salva modifiche** per rendere definitiva la tua scelta.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a eliminare un documento">
Se il documento appartiene a una richiesta di firma, come PDF originale o come PDF firmato, Tillor rifiuta l'eliminazione, perché è una prova. Archivialo con **Archivia** nel menu **…**.
</Accordion>
<Accordion title="Tillor dice: Archiviazione non riuscita">
Il messaggio è **Non è stato possibile archiviare il documento.** Riprova. Lo stesso vale per **Ripristino non riuscito** con **Ripristina**.
</Accordion>
<Accordion title="Tillor dice: Aggiornamento non riuscito">
Le tue modifiche a **Nome documento**, cliente, tipo o note non sono state salvate. Controlla il modulo e fai di nuovo clic su **Salva modifiche**.
</Accordion>
<Accordion title="Tillor dice: Download non riuscito">
Non è stato possibile scaricare il documento. Riprova.
</Accordion>
<Accordion title="Manca il campo Data di scadenza assicurazione">
Quel campo compare solo per i tipi di documento che possono avere una data di scadenza, come **Polizza assicurativa**. Scegli prima il tipo giusto in **Tipo di documento**.
</Accordion>
<Accordion title="Il mio file non viene accettato">
Controlla il tipo di file (PDF, Word, messaggio Outlook, Excel, PowerPoint, JPEG, PNG, GIF o testo) e le dimensioni (al massimo 250 MB).
</Accordion>
<Accordion title="Il documento non è più nell'elenco centrale">
Non appena un documento è collegato a un cliente, si trova solo presso quel cliente sotto **Documenti**. Se è nell'archivio, lo trovi sotto **Archiviati**.
</Accordion>
</Accordions>

## Concetti [#begrippen]

- **Tipo di documento**: il genere di documento, ad esempio **Polizza assicurativa** o **Carta d'identità**.
- **Archiviati**: un documento che viene conservato ma non compare più tra i documenti attivi.
- **Elenco centrale dei documenti**: file non ancora collegati a un cliente.
- **Richiesta di firma**: un incarico per far firmare un PDF. Vedi [richiesta di firma](/begrippen#ondertekenverzoek).
- **Cliente**: il record in Tillor a cui è agganciato un documento. Vedi [cliente](/begrippen#klant).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" />
  <Card title="Firme" href="/handtekeningen" />
</Cards>


# Panoramica (/it-IT/eigen-velden)

Con i campi personalizzati aggiungi tu stesso dei campi a una scheda. Pensa a un numero di cauzione della bombola del gas su un cliente, a un supplemento su un terreno o a un orario di arrivo previsto su una prenotazione. Il campo compare nel modulo di quella scheda, proprio come i campi che Tillor fornisce di suo.

Li gestisci in <UIPath>Impostazioni > Campi personalizzati</UIPath>.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-list.png" alt="Impostazioni > Campi personalizzati con la scheda Clienti e l'elenco dei campi" />

<Callout type="info" title="Da sapere">
- Il tipo di un campo e la chiave non si possono più modificare dopo la creazione
- Testo: di default al massimo 1.000 caratteri, Testo lungo 10.000. Un elenco di scelta ha al massimo 200 opzioni
- Un gruppo di campi ha al massimo 30 sottocampi. Righe ripetute: di default al massimo 100 righe, mai più di 500
- File: di default al massimo 20 per campo (mai più di 50), ciascuno al massimo 50 MB
- Un campo che scompare a causa di una condizione viene svuotato quando si salva la scheda
- Un campo eliminato sparisce dai moduli. I valori inseriti restano comunque sulle schede
- Tutti i limiti per tipo si trovano in [Tipi di campo e impostazioni](/eigen-velden/veldtypes)
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

Crei un campo una sola volta e poi compare ovunque venga compilato quel tipo di scheda.

```mermaid
flowchart LR
  L[Keuzelijst met opties] -->|gebruikt door| V[Eigen veld van het type Keuze]
  V -->|staat in het formulier van| R[Klant, terrein, bezetting, taak en andere records]
  T[Toegang: wie mag zien en bewerken] --> V
  R -->|waarden komen terug in| E[Exports, filters en automatiseringen]
```

- Gli **Elenchi di scelta** li crei separatamente dai campi. Se modifichi un'opzione, il cambiamento vale in ogni campo che usa l'elenco.
- **Un campo** appartiene a un solo tipo di scheda. Il tipo e la chiave sono fissi.
- **Accesso** lo regoli per campo. Chi non può vedere un campo non vede mai il valore, nemmeno nelle esportazioni o nelle automazioni.

## Dove puoi aggiungere campi personalizzati [#waar-kun-je-eigen-velden-toevoegen]

Ogni tipo di scheda ha una propria scheda a linguetta. Dopo il nome c'è il numero di campi.

| Scheda | Record |
|---|---|
| **Clienti** | Profilo cliente |
| **Terreni** | Terreno |
| **Occupazioni** | Occupazione |
| **Contatori** | Contatore |
| **Attività** | Attività |
| **Prodotti** | Prodotto |
| **Documenti** | Documento |
| **Prenotazioni** | Prenotazione |
| **Metodi di accesso** | Metodo di accesso |

La scheda **Elenchi di scelta** non ha record. Lì crei elenchi di opzioni che riutilizzi nei campi a scelta.

## Cosa puoi farci [#wat-je-ermee-kunt]

- Aggiungere un campo di un certo tipo, come testo, numero, importo, data, scelta o file. Vedi [Tipi di campo e impostazioni](/eigen-velden/veldtypes)
- Mettere il campo nel modulo tra i campi esistenti, oppure mostrarlo solo se un altro valore è corretto
- Rendere il campo obbligatorio, eventualmente solo a una condizione
- Decidere chi può vedere il campo e chi può modificarlo. Vedi [Visibilità e accesso](/eigen-velden/zichtbaarheid-en-toegang)

I valori sono disponibili nell'esportazione di clienti e terreni e nelle automazioni. Un'automazione può anche compilare un campo personalizzato con il passaggio **Imposta campo personalizzato**.

## Chi può usarli [#wie-kan-het-gebruiken]

<Callout type="info" title="La gestione richiede un'autorizzazione">
Creare, modificare, riordinare ed eliminare i campi è possibile con l'autorizzazione **Gestisci campi personalizzati**. Chi non ce l'ha può aprire la pagina se può vedere le impostazioni, ma i pulsanti sono disattivati.
Compilare un campo su una scheda può farlo chiunque possa vedere e modificare il campo.
</Callout>

## Sezioni [#onderdelen]

<Cards>
  <Card
    title="Creare un campo personalizzato"
    href="/eigen-velden/veld-aanmaken"
    description="Aggiungere, posizionare e adattare un campo passo dopo passo"
  />
  <Card
    title="Elenchi di scelta"
    href="/eigen-velden/keuzelijsten"
    description="Definire opzioni per i tipi Scelta e Scelta multipla"
  />
  <Card
    title="Tipi di campo e impostazioni"
    href="/eigen-velden/veldtypes"
    description="Per ogni tipo, quali impostazioni e limiti esistono"
  />
  <Card
    title="Visibilità e accesso"
    href="/eigen-velden/zichtbaarheid-en-toegang"
    description="Dove si trovano i valori e chi può vederli o modificarli"
  />
</Cards>

## Concetti [#begrippen]

- **[Campo personalizzato](/begrippen#eigen-veld)**: un campo aggiuntivo che aggiungi tu stesso a una scheda
- **Etichetta**: il nome che i colleghi vedono sopra il campo di inserimento
- **Chiave**: il nome fisso del campo, ad esempio `gasMeterNumber`. La vedi nell'elenco e viene usata nelle esportazioni e nei filtri
- **Tipo**: che genere di valore conserva il campo
- **[Elenco di scelta](/begrippen#keuzelijst)**: un elenco di opzioni che usi in più campi a scelta

Altri termini sono nel [glossario](/begrippen). Un esempio concreto è in [Esempi pratici](/praktijk).


# Creare elenchi di scelta (/it-IT/eigen-velden/keuzelijsten)

Un campo di tipo **Scelta** o **Scelta multipla** ha bisogno di un elenco di scelta. Crei l'elenco una sola volta e lo usi in quanti campi vuoi. Se modifichi un'opzione, il cambiamento vale subito ovunque.

<Requires permission="Gestisci campi personalizzati" />

<Steps>
<Step>
### Apri la scheda Elenchi di scelta [#open-het-tabblad-keuzelijsten]
Vai a <UIPath>Impostazioni > Campi personalizzati</UIPath> e fai clic su **Elenchi di scelta**. Ogni elenco mostra le sue opzioni con il colore e quanti campi lo usano.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enums.png" alt="La scheda Elenchi di scelta con l'elenco Tipo di contratto" />
</Step>
<Step>
### Crea un elenco [#maak-een-lijst-aan]
Fai clic su **Nuovo elenco di scelta**. Compila un **Nome** e, se vuoi, una **Descrizione**. Tillor crea da sé una **Chiave**.
</Step>
<Step>
### Aggiungi le opzioni [#voeg-opties-toe]
Fai clic su **Aggiungi opzione** e compila l'**Etichetta**, ad esempio *Stagione*. Scegli un colore con il pallino colorato. Un elenco ha bisogno di almeno un'opzione.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enum-dialog.png" alt="Finestra Nuovo elenco di scelta" />
</Step>
<Step>
### Salva [#sla-op]
Fai clic su **Salva**. Poi scegli l'elenco quando crei un campo di tipo **Scelta** o **Scelta multipla**.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- L'elenco è disponibile quando crei un campo di tipo **Scelta** o **Scelta multipla**.
- Se più tardi modifichi l'etichetta o il colore di un'opzione, il cambiamento vale subito in ogni campo che usa l'elenco.
- Il **Valore** di un'opzione resta fisso non appena è stata usata su una scheda.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a eliminare un elenco">
Un elenco ancora usato in un campo non puoi eliminarlo. Tillor segnala che l'elenco è ancora usato da un campo. Togli prima l'elenco da quei campi oppure elimina quei campi.
</Accordion>
<Accordion title="Nel mio campo a scelta c'è scritto Crea prima un elenco di scelta">
Non esiste ancora nessun elenco. Creane uno nella scheda **Elenchi di scelta** e poi sceglilo nel campo.
</Accordion>
<Accordion title="Non riesco a salvare l'elenco">
Un elenco ha bisogno di almeno un'opzione e di al massimo 200. Aggiungi un'opzione con **Aggiungi opzione**.
</Accordion>
</Accordions>


# Creare un campo personalizzato (/it-IT/eigen-velden/veld-aanmaken)

Con un campo personalizzato conservi un dato che Tillor non conosce, come il numero di cauzione di una bombola del gas su un cliente. Lo crei in pochi minuti e a destra della pagina vedi subito come i colleghi riceveranno il campo. Poi lo compili sulla scheda stessa, vedi [Visibilità e accesso](/eigen-velden/zichtbaarheid-en-toegang).

Prima di iniziare:

- Ti serve l'autorizzazione **Gestisci campi personalizzati**. Senza quell'autorizzazione il pulsante **Nuovo campo** è grigio.
- Se il campo ha bisogno di una scelta, crea prima un [elenco di scelta](/eigen-velden/keuzelijsten). Altrimenti compare **Crea prima un elenco di scelta**.
- Scegli il tipo con cura: dopo non puoi più cambiarlo.

<Requires permission="Gestisci campi personalizzati" />

<Steps>
<Step>
### Apri Campi personalizzati e scegli la scheda [#open-eigen-velden-en-kies-het-tabblad]
Vai a <UIPath>Impostazioni > Campi personalizzati</UIPath> e apri la scheda della scheda-record a cui appartiene il campo, ad esempio **Clienti**. Fai clic su **Nuovo campo**.

Se la scheda è ancora vuota, sotto **Avvio rapido** vedi alcune proposte, come **Numero di cani** per i clienti. Fai clic su una proposta per aprire il modulo già compilato. Le proposte con un elenco di scelta chiedono prima un elenco. Vedi [Elenchi di scelta](/eigen-velden/keuzelijsten).
</Step>
<Step>
### Compila il campo [#vul-het-veld-in]
Sotto **1. Campo** scegli in **Si applica a** il tipo di scheda, dai al campo un'**Etichetta** e scegli il **Tipo**. Ogni scheda di tipo ha una breve spiegazione.

Tillor crea da sé una **Chiave** a partire dalla tua etichetta. Sotto **3. Chiave** puoi cambiarla con **Modifica** prima di salvare.

<DocScreenshot src="/screenshots/eigen-velden/field-new-form.png" alt="Nuovo campo personalizzato con le schede dei tipi, le impostazioni e l'anteprima a destra" />
</Step>
<Step>
### Rifinisci il campo [#stel-het-veld-af]
Sotto **2. Impostazioni** trovi le opzioni che appartengono al tipo scelto. Vedi [Tipi di campo e impostazioni](/eigen-velden/veldtypes). Inoltre puoi scegliere:

- **Larghezza**: **Metà** o **Larghezza intera** nel modulo
- **Posizione nel modulo**: lascia il campo in fondo (**Sezione predefinita (in basso)**), oppure scegli un campo esistente del modulo e metti il campo **Prima** o **Dopo** quel campo
- **Obbligatorio**: la scheda non può essere salvata finché il campo è vuoto
- **Visibilità**: mostra il campo solo se è soddisfatta una condizione
- **Obbligatorio quando**: rendi il campo obbligatorio solo se è soddisfatta una condizione
- **Regole di validazione**: confronta il valore con un altro campo, oppure verificalo con un'espressione
- **Testo di aiuto**: una breve spiegazione sotto il campo di inserimento
</Step>
<Step>
### Decidi chi può accedere [#bepaal-wie-erbij-mag]
Sotto **4. Accesso** c'è di default che tutti possono vedere e modificare il campo. Fai clic su **Limita** per cambiarlo. Vedi [Visibilità e accesso](/eigen-velden/zichtbaarheid-en-toegang).
</Step>
<Step>
### Salva il campo [#sla-het-veld-op]
Fai clic su **Salva**. Tillor segnala **Campo salvato** e ti riporta all'elenco. Il campo è subito nel modulo della scheda.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il campo è subito nel modulo della scheda, nella posizione che hai scelto.
- Le schede esistenti hanno ancora un valore vuoto. Se il campo è obbligatorio, un collega deve compilarlo prima di salvare di nuovo una di quelle schede.
- I valori vengono inclusi nell'esportazione di clienti e terreni e sono disponibili nelle automazioni.
- Chi può vedere o modificare il campo lo regoli sotto **4. Accesso**.

## Posizione e condizioni [#plaats-en-voorwaarden]

Con **Posizione nel modulo** metti un campo vicino ai campi a cui appartiene, invece che in fondo. Con **Visibilità** mostri un campo solo se un altro valore lo richiede. In questo esempio **Rimessaggio invernale** compare solo su un terreno con **Tipo di contratto** Stagione, subito dopo **Descrizione**.

<DocScreenshot src="/screenshots/eigen-velden/field-edit-conditions.png" alt="Modifica campo con Posizione nel modulo e una condizione in Visibilità e Obbligatorio quando" />

Una condizione è composta da una o più regole. In **Tipo di condizione** scegli **Regole** oppure **Espressione**. L'espressione è pensata per i casi complicati e richiede un po' di codice. Per la maggior parte dei campi bastano le regole.

<Callout type="info" title="Un campo nascosto viene svuotato">
Se un campo scompare perché la condizione non è più soddisfatta, Tillor cancella il valore quando si salva la scheda. Se il campo ritorna, è vuoto. Un campo obbligatorio a una condizione è obbligatorio solo finché è visibile.
</Callout>

## Modificare, spostare o eliminare un campo [#een-veld-bewerken-verplaatsen-of-verwijderen]

Nell'elenco ogni campo ha quattro pulsanti.

| Pulsante | Cosa fa |
|---|---|
| **Sposta su** e **Sposta giù** | Cambia l'ordine dei campi nel modulo |
| **Modifica campo** | Apre il campo. Il tipo, la chiave e la scheda a cui appartiene il campo restano fissi |
| **Elimina** | Elimina il campo dopo una conferma |

Un campo eliminato sparisce dai moduli. I valori inseriti restano comunque sulle schede, ma non vengono più mostrati né modificati.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a fare clic su Nuovo campo">
Il pulsante è disattivato senza l'autorizzazione **Gestisci campi personalizzati**. Chiedi a un amministratore di assegnarti l'autorizzazione.
</Accordion>
<Accordion title="Voglio cambiare il tipo o la chiave di un campo esistente">
Non è possibile. Crea un nuovo campo con il tipo giusto ed elimina poi il vecchio. Tillor non riporta i valori del vecchio campo.
</Accordion>
<Accordion title="Il mio campo non è dove me lo aspetto">
Controlla in **Posizione nel modulo** se hai scelto un campo. Con **Sezione predefinita (in basso)** il campo si trova dopo i campi standard del modulo. Se ha una condizione in **Visibilità**, compare solo quando è soddisfatta.
</Accordion>
</Accordions>


# Tipi di campo e impostazioni (/it-IT/eigen-velden/veldtypes)

Quando crei un campo scegli un tipo. Dopo non puoi più cambiarlo. Sotto **2. Impostazioni** trovi le opzioni di quel tipo. Tutte le opzioni sono facoltative, salvo diversa indicazione qui sotto.

Per quasi ogni tipo puoi anche compilare un **Messaggio di errore**. Sostituisce il messaggio standard quando un valore non è corretto. Con **Testo segnaposto** decidi cosa c'è nel campo di inserimento vuoto.

## Testo e Testo lungo [#tekst-en-lange-tekst]

**Testo** è una riga, **Testo lungo** più righe.

| Impostazione | Cosa fa |
|---|---|
| **Lunghezza minima** e **Lunghezza massima** | Il numero di caratteri. Senza massimo valgono 1.000 caratteri per Testo e 10.000 per Testo lungo |
| **Formato** | **Testo libero**, **Indirizzo email**, **Numero di telefono**, **Indirizzo web**, **IBAN**, **CAP**, **Solo cifre** o **Modello personalizzato** |
| **Modello (espressione regolare)** | Con **Modello personalizzato**. L'intero valore deve corrispondere. Tillor rifiuta i modelli con ripetizioni annidate o riferimenti all'indietro e i modelli più lunghi di 200 caratteri |

## Numero e Importo [#getal-en-bedrag]

**Importo** usa la valuta della tua organizzazione.

| Impostazione | Vale per | Cosa fa |
|---|---|---|
| **Minimo** e **Massimo** | Numero, Importo | Limite inferiore e superiore |
| **Solo numeri interi** | Numero | Nessun decimale consentito |
| **Visualizzazione** | Numero, solo con numeri interi | **Campo di immissione** o **Contatore (− / +)** con pulsanti |
| **Passo** | Numero | Il valore deve essere il minimo (o 0) più un numero intero di passi |
| **Decimali massimi** | Numero | Limita i decimali |

## Sì / no [#ja--nee]

Un interruttore acceso/spento. Con **Deve essere selezionata** la scheda si può salvare solo con la casella attiva. Utile per un consenso.

## Data [#datum]

| Impostazione | Cosa fa |
|---|---|
| **Data minima** e **Data massima** | Limiti fissi |
| **Non nel passato** e **Non nel futuro** | Confrontato con oggi nel fuso orario della tua organizzazione |
| **Entro giorni da oggi** | Al massimo questo numero di giorni prima o dopo oggi |

## Scelta e Scelta multipla [#keuze-en-meerkeuze]

Scegli un [elenco di scelta](/eigen-velden/keuzelijsten). **Scelta** conserva una sola opzione, **Scelta multipla** più opzioni. Con Scelta multipla imposti **Minimo selezionati** e **Massimo selezionati**. Un elenco ha al massimo 200 opzioni.

## Collegamento a scheda [#koppeling-naar-record]

Il campo punta a un'altra scheda in Tillor.

| Impostazione | Cosa fa |
|---|---|
| **Collega a** | Cliente, Terreno, Occupazione, Contatore, Attività, Fattura, Prenotazione, Rapporto pagamenti, Telefonata, Persona di contatto, Prodotto, Armadio contatori, Pagamento, Documento, Tag NFC o Metodo di accesso |
| **Più schede** | Consenti più di una scheda collegata. Puoi allora impostare anche un minimo e un massimo |
| **Visualizzazione** | **Selettore** o **Menu a tendina** (un unico elenco con ricerca) |
| **Solo i record di questo cliente** | Limita le opzioni ai record del cliente che stai modificando. Solo per Persona di contatto, Fattura, Prenotazione, Occupazione, Pagamento, Documento, Tag NFC e Metodo di accesso |
| **Solo record della piazzola** | Limita le opzioni ai contatori del terreno: per un'occupazione il terreno di quell'occupazione, per un terreno il terreno stesso. Solo per Contatore. Un contatore di un altro terreno non puoi salvarlo |
| **Filtra opzioni** | TypeScript facoltativo che decide per ogni opzione se compare nell'elenco, vedi [Filtrare le opzioni](#opties-filteren). Per Persona di contatto, Prodotto, Armadio contatori, Pagamento, Documento, Tag NFC, Metodo di accesso, Fattura, Prenotazione, Occupazione, Contatore e Terreno |

Se una scheda collegata viene eliminata in seguito, il campo mostra **Eliminato**.

Se ci sono almeno 50 schede tra cui scegliere, digiti prima 2 caratteri per cercare. Se sono meno, come i contatori di un solo terreno, le vedi subito tutte.

### Filtrare le opzioni [#opties-filteren]

Con **Filtra opzioni** decidi tu quali schede offre il campo. Scrivi TypeScript, come per la [formula della tariffa](/terreinen#tariefformule), che Tillor esegue per ogni opzione. Se restituisce `true`, l'opzione compare nell'elenco; altrimenti no.

Nel filtro leggi i campi con le parentesi graffe. Il menu **Variabile** mostra cosa c'è, inclusi i campi personalizzati:

| Variabile | Cos'è |
|-----------|------------|
| `{option.…}` | La scheda che potresti scegliere, ad esempio `{option.type}` o `{option.terrainId}` per un contatore |
| `{occupation.…}`, `{terrain.…}`, … | La scheda che stai modificando, con il nome del suo tipo, con `customFields` per i suoi campi personalizzati |

Esempio: solo contatori elettrici del terreno dell'occupazione.

```ts
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};
```

### Etichette personalizzate [#eigen-labels]

Lo stesso filtro può anche decidere come si chiama un'opzione nell'elenco. Ciò che restituisci determina il risultato:

| Cosa restituisci | Risultato |
|----------------|-----------|
| `true` | L'opzione è nell'elenco con il suo nome |
| `false`, `null` o un testo vuoto | L'opzione non è nell'elenco |
| Un testo | L'opzione è nell'elenco con quel testo |
| `{ label, group }` | L'opzione riceve quell'etichetta e finisce sotto l'intestazione `group`. Entrambi sono facoltativi |

Esempio: solo contatori di ICY e Hydrodigit, con il tipo accanto e raggruppati per fornitore.

```ts
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };
```

L'etichetta vale nell'elenco di scelta e sui chip selezionati nel modulo. Nei punti che mostrano solo il valore, come la pagina di dettaglio o un'esportazione, compare il nome proprio della scheda.

**Inserisci esempio** sotto il campo offre un punto di partenza. Un filtro che non compila non puoi salvarlo; il messaggio sotto il campo dice cosa non va.

Il filtro non limita solo l'elenco. Se tramite l'API o un vecchio modulo scegli comunque una scheda che il filtro esclude, Tillor rifiuta il salvataggio indicando il nome del campo. Automazioni e importazioni non vengono controllate, così come possono compilare anche i campi nascosti.

## Gruppo di campi [#groep-velden]

Un insieme fisso di sottocampi che stanno insieme nel modulo, come **Cani** e **Altri animali** sotto **Animali**.

| Impostazione | Cosa fa |
|---|---|
| **Aggiungi sottocampo** | Ogni sottocampo ha un'etichetta, un tipo e impostazioni proprie. Fai clic su **Altro** per la chiave, la larghezza e le condizioni. Un gruppo può avere al massimo 30 sottocampi |
| **Visualizzazione** | **Riquadro** (con bordo) o **In linea** (i campi proseguono nel modulo) |
| **Colonne** | Da 1 a 4 |
| **Larghezza nel gruppo** | Per ogni sottocampo, quante colonne occupa |

## Righe ripetute [#herhalende-rijen]

Una tabella a cui aggiungi righe con **Aggiungi riga**, ad esempio più veicoli. Imposti i sottocampi come per un gruppo. Con **Righe minime** e **Righe massime** limiti l'elenco. Senza massimo valgono 100 righe, e più di 500 non è possibile.

Un gruppo o una riga ripetuta può contenere, a un solo livello di profondità, un altro gruppo o un'altra riga ripetuta, non oltre.

## File [#bestanden]

Per documenti e foto. Un file che carichi può essere aperto solo da chi può vedere il campo.

| Impostazione | Cosa fa |
|---|---|
| **Più file** | Consenti più di un file |
| **File minimi** e **File massimi** | Senza massimo valgono 20 file, e più di 50 non è possibile |
| **Dimensione massima per file (MB)** | Al massimo 50 MB per file, anche se vuoi un valore più alto |
| **Tipi di file consentiti** | **Qualsiasi file**, **Immagini**, **PDF**, **Documenti Office**, oppure un'estensione propria come `.dwg` o un tipo MIME come `application/zip` |

Tillor controlla il tipo in base al contenuto del file, non solo al nome.

## JSON [#json]

Pensato per dati strutturati che un collegamento con un altro sistema fornisce. I colleghi raramente li compilano nel modulo. Con **Dimensione massima (KB)** imposti un limite, di default 64 KB e al massimo 256 KB.

## Impostazioni per ogni tipo [#instellingen-voor-elk-type]

| Impostazione | Cosa fa |
|---|---|
| **Cifra questo valore** | Conserva il valore cifrato. Un campo cifrato non si può cercare, filtrare né ordinare e non è disponibile come variabile nelle automazioni. Solo per campi di primo livello, quindi non per sottocampi. Tutti i campi personalizzati vengono comunque salvati cifrati, che tu attivi questa opzione o no |
| **Solo API** | Nasconde il campo nei moduli e nelle viste di dettaglio. Un collegamento lo compila tramite l'API. Un campo così non può essere obbligatorio |
| **Solo API, sola lettura** | Mostra il campo, ma disattivato, così i colleghi vedono il valore ma non lo modificano |
| **Regole di validazione** | Confronta una data, un numero o un importo con un altro campo (**Prima di**, **Entro**, **Dopo**, **Da**, con uno scarto in giorni, settimane o mesi), oppure verifica il valore con un'espressione. Al massimo 10 regole per campo |

Un limite modificato non vale retroattivamente. Un valore che non modifichi non blocca il salvataggio della scheda, anche se non soddisfa più la nuova regola.


# Visibilità e accesso (/it-IT/eigen-velden/zichtbaarheid-en-toegang)

Un campo personalizzato si trova nel modulo del record a cui appartiene. Per impostazione predefinita, chiunque abbia accesso a quel record può vedere e compilare il campo. Puoi limitarlo campo per campo.

## Dove vedi i valori [#waar-je-de-waarden-ziet]

Compili i campi personalizzati nello stesso punto degli altri dati del record.

| Record | Dove |
|---|---|
| Cliente | Il blocco **Dati del cliente** nel profilo del cliente |
| Piazzola, contatore, occupazione, prenotazione, prodotto, documento, metodo di accesso | Il modulo per creare o modificare il record |
| Attività | La finestra dell'attività. Salvi le modifiche con **Salva campi** |

Un campo si trova nel punto che hai scelto in **Posizione nel modulo**. Senza una scelta, compare dopo i campi standard.

<DocScreenshot src="/screenshots/eigen-velden/customer-custom-fields.png" alt="Il profilo del cliente con campi personalizzati come Cani, Data di arrivo e Numero cauzione bombola del gas tra i campi standard" />

Se un campo è obbligatorio, non puoi salvare il record finché è vuoto. Un campo con **Visibilità** compare solo quando la condizione è soddisfatta.

I campi personalizzati si ritrovano anche nell'esportazione di clienti e piazzole e puoi usarli nelle automazioni.

## Chi può vedere o modificare un campo [#wie-mag-een-veld-zien-of-bewerken]

Apri il campo in <UIPath>Impostazioni > Campi personalizzati</UIPath> e vai a **4. Accesso**. Fai clic su **Limita**.

<Requires permission="Gestisci campi personalizzati" />

<DocScreenshot src="/screenshots/eigen-velden/field-edit-access.png" alt="Modifica del campo con Chi può vedere questo campo e Chi può modificare questo campo" />

Hai due blocchi.

| Blocco | Cosa fa |
|---|---|
| **Chi può vedere questo campo** | Se lo lasci vuoto, ogni membro può vederlo. Chi non può vederlo non ne vede mai il valore, nemmeno nelle esportazioni o nelle automazioni che modifica |
| **Chi può modificare questo campo** | Se lo lasci vuoto, chiunque veda il campo può anche modificarlo. Gli altri lo vedono in sola lettura |

In ogni blocco scegli un **collega o gruppo** e/o un **permesso**. Chi corrisponde a uno dei colleghi, gruppi o permessi scelti ha accesso. Puoi modificare un campo solo se puoi anche vederlo.

Nell'elenco un campo di questo tipo riceve l'etichetta **Limitato**. Passa il mouse sopra per la spiegazione: solo determinati colleghi, gruppi o permessi possono vedere o modificare questo campo.

<Callout type="warn" title="Un campo nascosto non è un campo protetto">
L'opzione **Visibilità** (una condizione) nasconde un campo solo nel modulo. Chi può vedere il campo può comunque trovarne il valore. Usa **Chi può vedere questo campo** se nessun altro deve poterlo leggere.
</Callout>

## Chi può gestire i campi [#wie-mag-velden-beheren]

Creare, modificare, riordinare ed eliminare campi e gestire gli elenchi di scelta richiede il permesso **Gestisci campi personalizzati**. Come assegnare i permessi è spiegato in [Invitare utenti e assegnare permessi](/gebruikers/gebruikers-en-rechten). La pagina **Campi personalizzati** è visibile a chi può vedere o modificare le impostazioni, o ha questo permesso. Senza il permesso vedi solo i campi che puoi leggere, e **Nuovo campo**, la modifica e l'eliminazione sono disattivati.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Un collega non vede un campo">
Controlla in **Chi può vedere questo campo** se è stato scelto quel collega, il suo gruppo o uno dei suoi permessi. Se il campo è un campo **Solo API**, non compare nei moduli.
</Accordion>
<Accordion title="Un collega non può modificare un campo">
Guarda in **Chi può modificare questo campo**. Se lì sono stati scelti colleghi, gruppi o permessi, gli altri possono solo leggere. Se qualcuno prova comunque a modificare il valore, Tillor lo rifiuta.
</Accordion>
</Accordions>


# Creare e modificare una fattura (/it-IT/facturen/aanmaken-en-bewerken)

Una nuova fattura è sempre una bozza: la crei nel profilo del cliente e compili le righe. Finché è una bozza, puoi aggiungere, modificare, spostare ed eliminare righe. Poi la [contabilizzi](/facturen/boeken).

Prima di iniziare:

- Il cliente esiste già in Tillor. Vedi [Gestione clienti](/klantenbeheer).
- Per i prodotti con una piazzola o un'occupazione, il cliente ha un'occupazione su quella piazzola. Senza occupazione crei un'offerta che non puoi contabilizzare.

## Creare una fattura [#een-factuur-aanmaken]

Le fatture si creano nel profilo del cliente, non da <UIPath>Amministrazione > Fatture</UIPath>.

<Steps>
<Step>
### Apri il cliente [#open-de-klant]
Vai a <UIPath>Clienti > Panoramica</UIPath> e apri il profilo del cliente.
</Step>
<Step>
### Crea la fattura [#maak-de-factuur-aan]
Nel blocco **Fatture** fai clic su **Nuova fattura**. Tillor crea una fattura in bozza e apre subito la pagina della fattura.

<DocScreenshot src="/screenshots/klanten/customer-new-invoice.png" alt="Nuova fattura dal profilo del cliente" />
</Step>
</Steps>

La fattura riceve un numero di bozza provvisorio. Il numero di fattura definitivo, la data della fattura e la scadenza arrivano solo con la [contabilizzazione](/facturen/boeken).

## Aggiungere e modificare le righe [#regels-toevoegen-en-aanpassen]

Nella pagina della fattura trovi una tabella con le righe. In fondo c'è una riga vuota in cui inizi una nuova riga.

<Steps>
<Step>
### Scegli un prodotto o scrivi una descrizione [#kies-een-product-of-typ-een-omschrijving]
Scegli un **Prodotto** dall'elenco e Tillor compila la **Descrizione** e il prezzo. Puoi anche scrivere tu una descrizione.
</Step>
<Step>
### Compila quantità e prezzo [#vul-aantal-en-prijs-in]
Modifica la **Quantità** e il **Prezzo (IVA incl.)** per unità dove serve. Il **Totale** della riga viene calcolato automaticamente. Se per la tua organizzazione è attiva l'impostazione dell'IVA per riga, scegli anche l'aliquota IVA.
</Step>
<Step>
### Aggiungi una nota (facoltativo) [#voeg-een-notitie-toe-optioneel]
Sotto la tabella puoi compilare una **Nota (facoltativa)**. Il testo compare sulla fattura ed è visibile al cliente.
</Step>
</Steps>

Le modifiche vengono salvate automaticamente quasi subito. Puoi anche fare clic su **Salva modifiche**, oppure su **Annulla** per annullare le modifiche non salvate.

### Riordinare o eliminare le righe [#regels-herschikken-of-verwijderen]

- Trascina una riga con la maniglia alla sua sinistra per cambiare l'ordine.
- Fai clic sulla croce a destra di una riga per eliminarla.

Nella cronologia **Eventi** accanto alla fattura vedi cosa è stato modificato e quando, con il prima e il dopo dei campi e delle righe.

## Righe con un'azione [#regels-met-een-actie]

Se il prodotto scelto ha un'azione sulla riga della fattura, sotto la riga compaiono campi aggiuntivi. Le azioni di un prodotto si impostano nel prodotto stesso. Vedi [Azioni dei prodotti](/producten/productacties).

| Azione | Cosa compili nella fattura |
|-------|-----------------------------|
| **Ricarica tag NFC** | Il tag da ricaricare. Dopo il pagamento Tillor accredita l'importo sul saldo del tag. |
| **Periodo** | Data di inizio e di fine e, per un prodotto con piazzola, anche la **Piazzola** (in un elenco o **Scegli sulla mappa**). |
| **Estendi periodo occupazione** | La piazzola per cui estendi l'occupazione, più data di inizio e di fine. |
| **Richiedi dati di contatto** | Indirizzo e-mail e numero di telefono del cliente. Se sono obbligatori, non puoi contabilizzare senza. |
| **Crea metodo di accesso** | Il tipo di metodo di accesso ed eventualmente una targa o un PIN. |
| **Mostra avviso** | Niente. Vedi solo un avviso con il testo impostato nel prodotto. |
| **Impedisci prenotazione** | Niente. La fattura non può essere contabilizzata finché la riga è presente. |

### Scegliere periodo e piazzola [#periode-en-terrein-kiezen]

In una riga con **Periodo** scegli una data di inizio e di fine. Sotto vedi il numero di giorni e la **Quantità** che Tillor addebita. Se il periodo non coincide esattamente con una settimana o un mese del prodotto, Tillor arrotonda per eccesso e compare **Arrotondato per eccesso**. Con la casella **Pro rata** addebiti invece una settimana o un mese parziale in proporzione. Questa casella compare solo per i prodotti con periodo settimanale o mensile.

Se il prodotto richiede una piazzola, scegli prima il periodo e poi la **Piazzola**.

Alla contabilizzazione Tillor crea la prenotazione. Nella riga compare poi una scheda con numero di prenotazione, stato, piazzola e date. Se il cliente effettua subito il check-in dipende dal prodotto: con **Registra l'arrivo alla conferma** avviene alla contabilizzazione, con **Registra l'arrivo al pagamento** solo quando la fattura è pagata. Un acconto blocca soltanto la piazzola.

### Estendere un'occupazione [#een-bezetting-verlengen]

Con **Estendi periodo occupazione** fatturi un periodo per un'occupazione del cliente, per esempio la quota di sosta.

<Steps>
<Step>
### Scegli la piazzola [#kies-het-terrein]
In **Selezioni occupazione attiva** scegli la piazzola. L'elenco mostra le occupazioni attive del cliente.
</Step>
<Step>
### Scegli il periodo [#kies-de-periode]
Scegli la **Data inizio**. Poi Tillor apre subito il calendario per la **Data fine**. Sotto le date vedi fino a quando l'occupazione è attualmente fatturata e quanti giorni e quale quantità copre la riga.
</Step>
<Step>
### Imposta l'arrotondamento [#stel-het-afronden-in]
La casella **Arrotonda al prossimo confine periodo** è attiva per impostazione predefinita. In tal caso la riga termina al primo confine di periodo successivo della frequenza di affitto, così il cliente segue a lungo termine lo stesso ciclo. Con la casella disattivata la riga dura esattamente un periodo dalla data di inizio.
</Step>
</Steps>

La riga riceve una descrizione nella forma **Nome prodotto | Nome piazzola | Periodo**. La data di fine conta come ultimo giorno e un mezzo periodo viene addebitato per metà.

Se l'occupazione ha già una data **Pagato fino al** e l'arrotondamento è attivo, la nuova riga inizia il giorno dopo. Se **Pagato fino al** è ancora vuoto, scegli tu la data di inizio e Tillor calcola la data di fine fino al primo confine di periodo successivo. Cosa succede con **Pagato fino al** e **Fatturato fino al** dopo la contabilizzazione e il pagamento è spiegato in [Occupazioni](/bezettingen).

Due caselle aggiuntive aiutano in situazioni eccezionali:

- **Mostra tutti i terreni (offerta)** ti permette di scegliere una piazzola qualsiasi per creare un'offerta. Se il cliente non ha occupazione su quella piazzola, non puoi contabilizzare la fattura. Gli utenti con il permesso **Correzioni fatture** possono comunque registrare una fattura di questo tipo, vedi [Contabilizzare una fattura](/facturen/boeken#problemen).
- **Segna come credito (rimborso)** trasforma la riga in un rimborso. La quantità diventa negativa e il periodo va da oggi a **Pagato fino al**. Con **Arrotonda al confine periodo** lo arrotondi a un confine di periodo.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Le modifiche vengono salvate automaticamente quasi subito. La cronologia **Eventi** mostra chi ha modificato cosa.
- Al cliente non arriva nulla e nulla cambia per occupazioni o tag. Succede solo alla [contabilizzazione](/facturen/boeken) e al pagamento.
- Una bozza con una riga **Impedisci prenotazione** non può essere contabilizzata.
- Elimini una bozza con **Elimina fattura** nel menu delle azioni.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco più a modificare le righe">
Solo le fatture in bozza sono modificabili. Una fattura contabilizzata puoi riportarla in bozza a determinate condizioni, vedi [Correggere una fattura](/facturen/corrigeren#terugzetten-naar-concept).
</Accordion>
<Accordion title="Una riga con Ricarica tag NFC non mostra tag">
Il cliente non ha tag disponibili. Collega prima un tag NFC al cliente. Vedi [NFC](/nfc).
</Accordion>
<Accordion title="Non vedo il pulsante Nuova fattura">
Il pulsante si trova nel profilo del cliente, nel blocco **Fatture**, non nell'elenco fatture sotto **Amministrazione**.
</Accordion>
<Accordion title="Il cliente non compare nell'elenco Selezioni occupazione attiva">
Con **Estendi periodo occupazione** l'elenco mostra solo le occupazioni attive del cliente. Crea prima un'occupazione, vedi [Occupazioni](/bezettingen), oppure usa **Mostra tutti i terreni (offerta)** per un'offerta.
</Accordion>
</Accordions>

## Altro [#verder]

<Cards>
  <Card title="Contabilizzare una fattura" href="/facturen/boeken" />
  <Card title="Prodotti" href="/producten" description="Impostare le azioni sulle righe della fattura" />
</Cards>


# Stampare, scaricare o condividere una fattura (/it-IT/facturen/afdrukken-en-downloaden)

Con **Stampa** stampi una fattura, la salvi come PDF o la invii a una stampante. Il pulsante è presente in ogni pagina di fattura, anche in una bozza. La freccia accanto apre un menu con le altre opzioni. Un link per il cliente lo crei in [Condividere un link personale](#een-persoonlijke-link-delen).

Prima di iniziare: per le opzioni di stampa deve essere in esecuzione un Tillor Connector per la tua organizzazione. Senza connector queste opzioni sono grigie.

## Stampare o salvare [#afdrukken-of-opslaan]

| Opzione | Cosa fa |
|-------|--------------|
| **Stampa** | Apre la finestra di stampa del browser. Puoi usare anche la scorciatoia Ctrl+P (Cmd+P su Mac). |
| **Apri in nuova finestra** | Mostra il PDF in una nuova finestra. |
| **Scarica PDF** | Salva la fattura come file PDF. |
| **Invia a stampante A4** | Invia la fattura alla stampante A4 collegata. |
| **Invia a stampante ricevute** | Invia la fattura alla stampante di ricevute collegata. |

Le due opzioni di stampante sono grigie finché non è attivo un Tillor Connector per la tua organizzazione. Come impostare le stampanti è spiegato in [Stampante](/printer).

## Mostrare la fattura su un tablet [#de-factuur-tonen-op-een-tablet]

Se alla reception c'è un tablet che mostra i documenti del cliente, puoi far comparire lì la fattura. Apri i tre puntini in alto a destra nella pagina della fattura e scegli **Anteprima su iPad**. In caso di pagamento in contanti lo stesso pulsante si trova anche nella finestra di pagamento.

## Condividere un link personale [#een-persoonlijke-link-delen]

Per una fattura contabilizzata puoi creare un link che il cliente può aprire da solo per vedere la fattura e, se c'è ancora qualcosa da pagare, pagare online.

<Steps>
<Step>
### Apri il menu delle azioni [#open-het-actiemenu]
Fai clic sui tre puntini in alto a destra nella pagina della fattura e scegli **URL personale**.
</Step>
<Step>
### Condividi il link [#deel-de-link]
Tillor copia il link negli appunti e mostra il messaggio **URL generato**. Incollalo in un messaggio o in una mail al cliente.
</Step>
</Steps>

<DocScreenshot src="/screenshots/facturen/invoice-actions-menu.png" alt="Menu delle azioni della fattura - URL personale, Copia fattura, Storna fattura" />

Il menu delle azioni contiene altre opzioni. Vedi [Correggere una fattura](/facturen/corrigeren) per copiare, stornare e ricalcolare una fattura.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Stampare, scaricare e inviare alla stampante non cambiano nulla nella fattura.
- Con **Anteprima su iPad** il cliente vede la fattura sul tablet. Nella cronologia della fattura risulta che il PDF è stato inviato al tablet.
- Il link personale non ha data di scadenza. Il cliente vi vede l'importo ancora aperto e può pagare online. Vedi [Far pagare un cliente online](/betalingsverwerking/online).
- I prodotti possono anche stampare automaticamente al pagamento. Vedi [Azioni dei prodotti](/producten/productacties#thermisch-printen-en-a4-printen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Invia a stampante A4 è grigio">
Non c'è un Tillor Connector attivo per la tua organizzazione. Controlla la connessione e le impostazioni della stampante, vedi [Stampante](/printer).
</Accordion>
<Accordion title="URL personale non c'è">
Questa opzione è presente solo nel menu delle azioni di una fattura contabilizzata.
</Accordion>
<Accordion title="La stampa non riesce">
Tillor mostra allora un messaggio con il motivo, per esempio che la carta o il toner sono esauriti. Risolvi il problema e riprova.
</Accordion>
</Accordions>

## Altro [#verder]

<Cards>
  <Card title="Stampante" href="/printer" description="Impostare le stampanti e stampare automaticamente" />
  <Card title="Inviare una fattura" href="/facturen/versturen" />
</Cards>


# Registrare un pagamento (/it-IT/facturen/betalingen-registreren)

Su una fattura contabilizzata con un importo aperto esegui un pagamento o ne registri uno, per esempio un pagamento con carta, in contanti o un addebito diretto. L'importo, lo stato di pagamento e l'elenco **Pagamenti** accanto alla fattura vengono poi aggiornati. Tutti i metodi sono descritti anche in [Elaborazione dei pagamenti](/betalingsverwerking).

Prima di iniziare:

- La fattura è contabilizzata e c'è ancora un importo aperto. Altrimenti manca **Effettua pagamento**.
- Per **Terminale** Mollie è collegato. Per **Mandato SEPA** il cliente ha un mandato attivo. Altrimenti il metodo non è nell'elenco o è grigio.

## Eseguire un pagamento [#een-betaling-uitvoeren]

<Steps>
<Step>
### Apri la fattura contabilizzata [#open-de-geboekte-factuur]
Vai a <UIPath>Amministrazione > Fatture</UIPath> e apri una fattura contabilizzata. Il pulsante **Effettua pagamento** è presente finché c'è un importo aperto.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Fattura contabilizzata - Effettua pagamento" />
</Step>
<Step>
### Scegli il metodo di pagamento [#kies-de-betaalmethode]
Fai clic su **Effettua pagamento** e scegli un **Metodo di pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Finestra di pagamento - metodo di pagamento e importo" />

| Metodo | Lo usi per |
|---------|-----------------|
| **Terminale** | Un pagamento con carta. Scegli un terminale di pagamento e Tillor gli invia il pagamento. Vedi [Terminale](/betalingsverwerking/terminal). |
| **Trasferimento interno** | Spostare l'importo su un'altra fattura contabilizzata dello stesso cliente (**Fattura di destinazione**). Vedi [Trasferimento interno](/betalingsverwerking/interne-overboeking). |
| **Contanti** | Registrare un pagamento in contanti. Vedi [Contanti](/betalingsverwerking/contant). |
| **Bonifico** | Registrare un bonifico bancario ricevuto. |
| **Mandato SEPA** | Un addebito diretto automatico tramite un **Mandato** attivo del cliente. Vedi [Mandato](/betalingsverwerking/mandaat). |
| **Altro** | Un'altra forma di pagamento, come un assegno. Si trova sotto **Altri metodi di pagamento** ed è visibile solo se lo hai attivato. In tal caso una descrizione è obbligatoria. |

**Terminale** e **Mandato SEPA** compaiono solo se sono disponibili per la tua organizzazione. **Mandato SEPA** è grigio finché il cliente non ha un mandato attivo e non esiste per le note di credito.
</Step>
<Step>
### Compila l'importo [#vul-het-bedrag-in]
L'**Importo** è per impostazione predefinita l'intero importo aperto. Scrivi un altro importo o usa i pulsanti **25%**, **50%**, **75%** e **100%**. L'importo non può superare quello aperto.
</Step>
<Step>
### Compila i campi aggiuntivi [#vul-de-extra-velden-in]
Con **Contanti**, **Bonifico** e **Altro** compili facoltativamente la **Data di ricezione** (non nel futuro) e un **Commento**. Per un addebito diretto scegli il **Mandato** ed eventualmente un **Ritardo (giorni)**, dove 0 invia subito.

Se scegli **Bonifico** e il cliente ha un indirizzo e-mail, puoi selezionare **Invia promemoria comunicazione strutturata**. Il cliente riceve allora un'e-mail con il suggerimento di usare la comunicazione strutturata nei pagamenti successivi.
</Step>
<Step>
### Esegui il pagamento [#voer-de-betaling-uit]
Fai clic su **Esegui pagamento**.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Pagamenti sulla fattura" />
</Step>
</Steps>

Con **Contanti** c'è anche un pulsante **Anteprima su iPad** per mostrare la fattura al cliente su un tablet collegato.

## Importi massimi [#maximumbedragen]

Un pagamento in contanti non può superare il **Massimo in contanti** in <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath> (predefinito 2999 euro). Con un addebito diretto l'importo non può superare il massimo del mandato.

## Assegnare un pagamento esistente [#een-bestaande-betaling-koppelen]

Se è già arrivato un pagamento o una transazione bancaria relativa a questa fattura, lo assegni invece di crearne uno nuovo.

<Requires permission="Assegna pagamento" />

<Steps>
<Step>
### Apri il menu delle azioni [#open-het-actiemenu]
Fai clic sui tre puntini in alto a destra nella pagina della fattura e scegli **Assegna pagamento**.
</Step>
<Step>
### Scegli il pagamento [#kies-de-betaling]
Nella finestra scegli un pagamento o un gruppo. Nelle schede **Gruppi di pagamento**, **Pagamenti carta e online** e **Transazioni bancarie** vedi cosa è disponibile. In alto ci sono suggerimenti che corrispondono all'importo aperto.
</Step>
<Step>
### Assegna [#koppel]
Fai clic su **Assegna pagamento**, **Assegna gruppo** o **Assegna transazione bancaria**, a seconda di ciò che hai scelto.
</Step>
</Steps>

Per le transazioni bancarie ti serve anche il permesso **Visualizza transazioni bancarie**.

## Creare un link per un pagamento parziale [#een-link-voor-een-deelbetaling-maken]

Se il cliente vuole pagare solo una parte dell'importo aperto, crei un link di pagamento per un importo scelto da te. Si può fare su qualsiasi fattura contabilizzata con un importo aperto.

<Steps>
<Step>
### Apri il menu delle azioni [#open-het-actiemenu-1]
Fai clic sui tre puntini accanto a **Invia notifica** e scegli **Link per pagamento parziale**.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-menu.png" alt="Menu delle azioni di una fattura con Link per pagamento parziale" />
</Step>
<Step>
### Compila l'importo [#vul-het-bedrag-in-1]
In **Importo** scrivi quanto può pagare il cliente. L'importo deve essere maggiore di 0 e non può superare quanto è ancora aperto.
</Step>
<Step>
### Crea il link [#maak-de-link]
Fai clic su **Crea e copia il link**. Tillor copia il link negli appunti e lo mostra sotto **Link di pagamento**. Con il pulsante di copia accanto lo copi di nuovo.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-dialog.png" alt="Finestra Link per pagamento parziale con importo e link di pagamento" />
</Step>
</Steps>

Invia tu il link al cliente, per esempio per e-mail o in chat. Il cliente apre la normale pagina di pagamento della fattura, che ora richiede solo il tuo importo, con l'avviso che si tratta di un pagamento parziale dell'importo ancora aperto. Il cliente paga poi nel modo che sceglie sulla [pagina di pagamento](/betalingsverwerking/online).

Il link resta valido, ma non richiede mai più di quanto è aperto in quel momento. Se nel frattempo è già stata pagata una parte, la pagina di pagamento si adegua. Dopo un pagamento la fattura è <Status tone="warning">Parzialmente</Status> finché non è arrivato l'intero importo.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- L'importo aperto diminuisce e lo stato di pagamento cambia: <Status tone="warning">Parzialmente</Status> finché resta qualcosa di aperto, <Status tone="success">Pagata</Status> quando è arrivato tutto.
- Con un addebito diretto o un pagamento con carta, la fattura è prima <Status tone="info">In attesa</Status> finché il denaro non è arrivato definitivamente.
- Se una riga ha un'azione di pagamento, Tillor la esegue non appena la fattura è pagata. Per esempio ricaricare un tag NFC, estendere **Pagato fino al** di un'occupazione o stampare uno scontrino. Vedi [Come è collegato tutto?](/producten#hoe-hangt-dit-samen).
- Il pagamento finisce nel rapporto pagamenti del giorno. Vedi [Rapporti pagamenti](/boekhouden/betalingsrapporten).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Effettua pagamento">
La fattura deve essere contabilizzata e deve esserci un importo aperto. Su una fattura in bozza non puoi pagare.
</Accordion>
<Accordion title="Non vedo Link per pagamento parziale">
La fattura deve essere contabilizzata e deve esserci ancora un importo aperto.
</Accordion>
<Accordion title="Mandato SEPA è grigio">
Il cliente non ha un mandato attivo. Impostalo nei dati del cliente, vedi [Mandato](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Non riesco a scegliere Altro">
Questo metodo di pagamento è disattivato per impostazione predefinita. Attiva **Mostra metodo di pagamento "Altri"** in <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath>.
</Accordion>
<Accordion title="La fattura è In attesa">
Il pagamento è stato avviato, per esempio un addebito diretto, ma il denaro non è ancora arrivato in modo definitivo. Non appena il pagamento è elaborato, lo stato passa a **Pagata**. Vedi [Stati](/facturen/statussen).
</Accordion>
</Accordions>

## Altro [#verder]

<Cards>
  <Card title="Elaborazione dei pagamenti" href="/betalingsverwerking" description="Tutti i metodi di pagamento in dettaglio" />
  <Card title="Stati" href="/facturen/statussen" />
</Cards>


# Contabilizzare una fattura (/it-IT/facturen/boeken)

La contabilizzazione trasforma una bozza in una fattura definitiva con un proprio numero di fattura. Solo dopo puoi [inviare](/facturen/versturen) la fattura e [farla pagare](/facturen/betalingen-registreren). Controlla quindi le righe prima di contabilizzare, perché una fattura contabilizzata non è più modificabile liberamente.

Prima di iniziare:

- La fattura ha almeno una riga, oppure un totale diverso da zero.
- Le righe con **Periodo** o **Estendi periodo occupazione** hanno una data di inizio e di fine.
- Se una riga ha un'azione che richiede dati, questi sono compilati. Pensa a **Richiedi dati di contatto** o **Crea metodo di accesso**.
- Per un cliente belga con partita IVA è compilato un Peppol ID. Vedi [Peppol](/boekhouden/peppol).

Se c'è un problema, **Contabilizza fattura** è grigio. Passa il mouse sul pulsante per leggerne il motivo. Vedi anche [Problemi?](#problemen).

## Contabilizzare una fattura [#een-factuur-boeken]

<Steps>
<Step>
### Apri la fattura in bozza [#open-de-conceptfactuur]
Vai a <UIPath>Amministrazione > Fatture</UIPath> e apri una fattura con stato <Status>Bozza</Status>, per esempio dall'elenco **Bozze**.
</Step>
<Step>
### Controlla la fattura [#controleer-de-factuur]
Rivedi le righe e la nota.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Fattura in bozza - righe e Contabilizza fattura" />
</Step>
<Step>
### Fai clic su Contabilizza fattura [#klik-op-boek-factuur]
La fattura riceve un numero di fattura progressivo. Tillor segnala che la fattura è stata contabilizzata.
</Step>
</Steps>

## Cosa cambia? [#wat-verandert-er]

Ecco come appare una fattura prima e dopo la contabilizzazione. Sono due fatture di esempio diverse, ma si vede la differenza in numero, stato e pulsanti.

**Prima della contabilizzazione**: un numero di bozza provvisorio e il pulsante **Contabilizza fattura**.

<DocScreenshot src="/screenshots/facturen/invoice-before-title.png" alt="Titolo di una fattura in bozza con il numero di bozza CON/2026/0001" />

<DocScreenshot src="/screenshots/facturen/invoice-before-toolbar.png" alt="Pulsanti di una fattura in bozza: Contabilizza fattura e Stampa" />

**Dopo la contabilizzazione**: un numero di fattura definitivo, uno stato di pagamento e i pulsanti **Effettua pagamento** e **Invia notifica**.

<DocScreenshot src="/screenshots/facturen/invoice-after-title.png" alt="Titolo di una fattura contabilizzata con numero INV/2026/0001 e stato di pagamento Parzialmente" />

<DocScreenshot src="/screenshots/facturen/invoice-after-toolbar.png" alt="Pulsanti di una fattura contabilizzata: Effettua pagamento, Stampa e Invia notifica" />

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- La **data della fattura** è il giorno della contabilizzazione. La **scadenza** è quel giorno più la **Scadenza predefinita (giorni)** della tua organizzazione, di norma 7 giorni. La modifichi in <UIPath>Assistenza > Impostazioni > Fatturazione</UIPath>.
- Se il totale non è un multiplo di 5 centesimi, Tillor aggiunge da sé una riga **Arrotondamento**.
- Se la fattura ha un totale negativo, diventa una **Nota di credito**.
- Se il cliente ha un Peppol ID, Tillor invia automaticamente la fattura tramite Peppol. Vedi [Peppol](/boekhouden/peppol).
- Le righe con **Estendi periodo occupazione** portano **Fatturato fino al** dell'occupazione alla fine della riga. **Pagato fino al** segue solo al pagamento. Vedi [Come è collegato tutto?](/producten#hoe-hangt-dit-samen).
- Le righe con **Periodo** e **Chiedere la piazzola** creano una prenotazione. Se il cliente effettua subito il check-in dipende dal prodotto.
- Se è collegato un mandato di addebito, Tillor crea subito un pagamento aperto. La banca viene interpellata due giorni dopo la contabilizzazione.
- Il cliente non riceve nulla automaticamente. La notifica la invii tu, vedi [Inviare una fattura](/facturen/versturen).
- Vuoi ancora modificare qualcosa? Entro 7 giorni e finché non è stato inviato nulla, [riporti la fattura in bozza](/facturen/corrigeren#terugzetten-naar-concept).

## Scegliere un altro termine di pagamento [#een-andere-betaaltermijn-kiezen]

Se la scadenza si discosta dal tuo valore predefinito, non devi impostarlo in anticipo.

<Steps>
<Step>
### Apri il menu di scelta [#open-het-keuzemenu]
Fai clic sulla freccia accanto a **Contabilizza fattura** e scegli **Termini di pagamento personalizzati…**.
</Step>
<Step>
### Scegli il termine [#kies-de-termijn]
In **Termini di pagamento** scegli un'opzione, da **Scadenza alla data fattura** a **Netto 60 giorni**. Vedi subito la **Scadenza stimata**.
</Step>
<Step>
### Contabilizza [#boek]
Fai clic su **Contabilizza fattura**.
</Step>
</Steps>

## Inoltro alla contabilità [#doorsturen-naar-je-boekhouding]

L'inoltro al tuo software di contabilità avviene normalmente da solo. Se vuoi riavviarlo, per esempio dopo un errore, puoi farlo per ogni fattura.

<Requires permission="Invia alla contabilità" />

Apri la fattura contabilizzata, fai clic sui tre puntini in alto a destra e scegli **Invia al software contabile**. Quali sistemi sono disponibili lo leggi in [Contabilità](/boekhouden). [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) è disponibile su richiesta.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Contabilizza fattura è grigio">
Passa il mouse sul pulsante. Tillor indica il motivo. I più comuni sono qui sotto.
</Accordion>
<Accordion title="Questa fattura in bozza contiene una riga Impedisci prenotazione">
Il prodotto di quella riga non consente la contabilizzazione. Elimina la riga o scegli un altro prodotto.
</Accordion>
<Accordion title="Compila la data di inizio e di fine in ogni riga con Periodo o periodo di occupazione esteso">
Una riga con **Periodo** o **Estendi periodo occupazione** non ha una data. Compila la data di inizio e di fine.
</Accordion>
<Accordion title="Aggiungi almeno una riga o un importo totale diverso da zero">
Aggiungi una riga, oppure fai in modo che il totale non sia zero.
</Accordion>
<Accordion title="Compila i dati di contatto obbligatori, o scegli un tipo di metodo di accesso">
Nelle righe con **Richiedi dati di contatto** compila i campi obbligatori. Nelle righe con **Crea metodo di accesso** scegli un tipo e, per il riconoscimento targa, anche la targa.
</Accordion>
<Accordion title="Questa fattura estende una piazzola che il cliente non ha in occupazione (offerta)">
Una fattura di questo tipo è un'offerta e non puoi contabilizzarla. Fai prima occupare la piazzola al cliente. Se hai il permesso **Correzioni fatture**, puoi scegliere **Forza contabilizzazione** con la freccia accanto a **Contabilizza fattura**. L'occupazione viene allora estesa solo quando il cliente occupa la piazzola.
</Accordion>
<Accordion title="L'importo della fattura supera il massimo del mandato collegato">
L'importo della fattura non può superare l'importo massimo del mandato collegato. Modifica il mandato in **Mandato di addebito** nelle **Informazioni fattura** accanto alla fattura, oppure riduci l'importo. Vedi [Mandato SEPA](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Questa fattura porta il saldo del cliente sotto zero">
Un prodotto con conto protetto (per esempio una cauzione) non può portare il saldo del cliente sotto zero. Se hai il permesso **Ignorare il saldo del conto**, puoi contabilizzare comunque con una motivazione. Vedi [Tenere sotto controllo il saldo del cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
</Accordion>
<Accordion title="La fattura non può essere contabilizzata perché il cliente non ha un Peppol ID">
Per un cliente belga con partita IVA deve essere noto un Peppol ID. Apri <UIPath>Clienti > cliente > Fatturazione</UIPath>, vai a **Impostazioni di fatturazione** e compila l'ID. Vedi [Peppol](/boekhouden/peppol).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Inviare una fattura" href="/facturen/versturen" />
  <Card title="Registrare i pagamenti" href="/facturen/betalingen-registreren" />
  <Card title="Correggere una fattura" href="/facturen/corrigeren" description="Se dopo la contabilizzazione vuoi comunque modificare qualcosa" />
</Cards>


# Correggere una fattura (/it-IT/facturen/corrigeren)

Una fattura contabilizzata non si può semplicemente modificare. Quale strada scegliere dipende da quanto è avanzata la fattura.

Tutte le correzioni tranne il ripristino si trovano nel menu delle azioni (tre puntini) accanto a **Invia notifica**.

<DocScreenshot src="/screenshots/facturen/invoice-correct-menu.png" alt="Menu delle azioni di una fattura contabilizzata con Copia fattura e Storna fattura" />

| Situazione | Cosa fai |
|----------|-------------|
| La fattura è appena stata contabilizzata e non è ancora stata inviata | [Ripristinare in bozza](#terugzetten-naar-concept) |
| La fattura è già stata inviata o è troppo vecchia | [Stornare](#een-factuur-omkeren) con una nota di credito |
| Vuoi riutilizzare le stesse righe | [Copiare](#een-factuur-kopiëren) |
| La fattura è sul cliente sbagliato | [Spostare](#een-factuur-verplaatsen-naar-een-andere-klant) |
| Gli importi non tornano | [Ricalcolare](#een-factuur-herberekenen) |

## Ripristinare in bozza [#terugzetten-naar-concept]

Finché la fattura non è ancora uscita, la riporti in bozza e la contabilizzi di nuovo dopo la modifica.

È possibile se sono soddisfatte tutte queste condizioni:

- La fattura è contabilizzata.
- Tillor non ha ancora inviato alcuna notifica per essa, su nessun canale.
- La fattura non è stata inviata tramite Peppol.
- La data della fattura è di meno di 7 giorni fa.

<Steps>
<Step>
### Apri la fattura contabilizzata [#open-de-geboekte-factuur]
Vai a <UIPath>Amministrazione > Fatture</UIPath> e apri la fattura.
</Step>
<Step>
### Riportala in bozza [#zet-hem-terug]
Fai clic su **Ripristina in bozza** e conferma con **Sì, ripristina in bozza**. Se il pulsante non c'è, la fattura non soddisfa le condizioni.
</Step>
<Step>
### Modifica la fattura e contabilizza di nuovo [#pas-de-factuur-aan-en-boek-opnieuw]
Modifica le righe e fai clic su **Contabilizza fattura**.
</Step>
</Steps>

Nel frattempo la fattura ha un numero di bozza con il numero originale tra parentesi. La riga **Arrotondamento** viene rimossa e ricompare alla nuova contabilizzazione. Alla nuova contabilizzazione la fattura riceve di nuovo il suo numero originale, con la data della fattura e la scadenza originali. Una bozza che deriva da una fattura contabilizzata non si può eliminare.

Dopo un ripristino, nella cronologia **Eventi** compare per quell'evento un pulsante **Ripristina versione**. Con esso sostituisci le righe attuali con le righe com'erano al momento del ripristino. Se la fattura è nel frattempo di nuovo contabilizzata, Tillor la riporta prima in bozza.

<Callout type="warn" title="Attenzione">
Se la fattura è già stata stampata, mostrata al cliente o condivisa in altro modo, fai attenzione. Il cliente ha allora una versione che poi non sarà più corretta.
</Callout>

### Quando il ripristino non è più possibile [#als-terugzetten-niet-meer-kan]

<Requires permission="Correzioni fatture" />

Se la fattura non soddisfa più le condizioni, per esempio perché è già stata inviata una notifica o la fattura ha più di 7 giorni, con il permesso **Correzioni fatture** puoi comunque ripristinarla. Apri i tre puntini in alto a destra nella pagina della fattura e scegli **Forza ripristino in bozza**. Usalo solo se è lecito dal punto di vista legale e contabile. Una nota di credito tramite [storno](#een-factuur-omkeren) è di solito la soluzione più pulita.

## Stornare una fattura [#een-factuur-omkeren]

Con lo storno crei una nota di credito che annulla una fattura contabilizzata. Funziona sempre, anche se la fattura è già stata inviata o pagata.

<Steps>
<Step>
### Storna la fattura [#keer-de-factuur-om]
Apri i tre puntini in alto a destra nella fattura contabilizzata e scegli **Storna fattura**. Tillor crea una nuova bozza con le stesse righe in importi negativi e la apre.
</Step>
<Step>
### Controlla e contabilizza [#controleer-en-boek]
Modifica la bozza se necessario e fai clic su **Contabilizza fattura**. Diventa allora una **Nota di credito**.
</Step>
</Steps>

Le due fatture rimandano l'una all'altra. Nelle **Informazioni fattura** la nota di credito riporta **Storno di** e la fattura originale **Stornata come**. Nell'elenco delle fatture nel profilo del cliente vedi per la bozza l'etichetta **Bozza storno** e per la fattura originale **Questa fattura è stata stornata**.

Se hai già stornato una fattura in precedenza, Tillor chiede conferma con **Sì, storna di nuovo**, così non crei per sbaglio due note di credito.

Se vuoi compensare la nota di credito con la fattura originale, scegli **Trasferimento interno** al momento del pagamento. Vedi [Trasferimento interno](/betalingsverwerking/interne-overboeking).

## Copiare una fattura [#een-factuur-kopiëren]

Scegli **Copia fattura** nel menu delle azioni di una fattura contabilizzata. Tillor crea una nuova bozza con le stesse righe, la stessa nota e lo stesso mandato di addebito, e la apre. La riga **Arrotondamento** non viene copiata.

## Spostare una fattura su un altro cliente [#een-factuur-verplaatsen-naar-een-andere-klant]

<Requires permission="Correzioni fatture" />

Se una fattura è sul cliente sbagliato, la sposti.

<Steps>
<Step>
### Apri il menu delle azioni [#open-het-actiemenu]
Fai clic sui tre puntini in alto a destra nella pagina della fattura e scegli **Sposta a cliente**.
</Step>
<Step>
### Scegli il cliente [#kies-de-klant]
Scegli il **Cliente di destinazione** e fai clic su **Sposta fattura**.
</Step>
</Steps>

La fattura si sposta insieme ai pagamenti collegati, ai lotti di contatori e ai commenti. Una fattura contabilizzata viene poi inviata di nuovo alla tua contabilità. Se la fattura è già stata inviata tramite Peppol, non puoi spostarla.

## Ricalcolare una fattura [#een-factuur-herberekenen]

Se gli importi di una fattura contabilizzata non corrispondono alle righe, scegli **Ricalcola fattura** nel menu delle azioni. Tillor ricalcola i totali.

## Eliminare una bozza [#een-concept-verwijderen]

Puoi eliminare una fattura in bozza con **Elimina fattura** nel menu delle azioni. Torni poi al profilo del cliente. Le fatture contabilizzate non si possono eliminare, si stornano.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

| Strada | Conseguenza |
|-------|--------|
| Ripristinare in bozza | Il numero di fattura viene conservato. Alla nuova contabilizzazione la fattura riceve di nuovo il numero e le date originali. |
| Stornare | Nasce una nota di credito che rimanda alla fattura originale. Puoi compensare con un [trasferimento interno](/betalingsverwerking/interne-overboeking). |
| Copiare | Nasce una nuova bozza. La fattura originale non cambia. |
| Spostare | Pagamenti, lotti di contatori e commenti si spostano insieme. Una fattura contabilizzata viene inviata di nuovo alla tua contabilità. |
| Ricalcolare | I totali vengono ricalcolati dalle righe. |

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Ripristina in bozza">
Una delle condizioni non è soddisfatta. È già stata inviata una notifica o la fattura ha 7 giorni o più? Allora puoi stornare oppure, con il permesso **Correzioni fatture**, ripristinare forzatamente.
</Accordion>
<Accordion title="Sposta a cliente manca">
Per questo ti serve il permesso **Correzioni fatture**. Se la fattura è stata inviata tramite Peppol, lo spostamento non è possibile.
</Accordion>
<Accordion title="Quali permessi ha il mio utente?">
Li imposta un amministratore. Vedi [Utenti](/gebruikers).
</Accordion>
</Accordions>

## Altro [#verder]

<Cards>
  <Card title="Contabilizzare una fattura" href="/facturen/boeken" />
  <Card title="Stati" href="/facturen/statussen" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Inviare fatture tramite Peppol" />
</Cards>


# Panoramica (/it-IT/facturen)

In <UIPath>Amministrazione > Fatture</UIPath> trovi tutte le fatture del tuo parco, con gli importi aperti in alto. Una fattura inizia come bozza e diventa definitiva solo quando la contabilizzi. Poi puoi inviarla, farla pagare ed eventualmente correggerla.

<Callout type="info" title="Da sapere">
- Una nuova fattura si crea nel profilo del cliente, non da questo elenco.
- Una fattura contabilizzata riceve una scadenza: il giorno della contabilizzazione più la scadenza predefinita della tua organizzazione, di norma 7 giorni. Per ogni fattura puoi scegliere un altro termine.
- Se il totale non è un multiplo di 5 centesimi, Tillor aggiunge alla contabilizzazione una riga **Arrotondamento**.
- Tillor non invia da sola al cliente una fattura contabilizzata. Lo fai tu con **Invia notifica**.
- Il ripristino in bozza è possibile fino a 7 giorni dopo la data della fattura, finché non è stata inviata una notifica e la fattura non è stata inviata tramite Peppol. Dopo, storni la fattura con una nota di credito.
- Un pagamento in contanti può essere al massimo di 2999 euro per impostazione predefinita. Lo modifichi con **Massimo in contanti** in <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath>.
- Un addebito diretto con mandato SEPA parte per la banca due giorni dopo la contabilizzazione. Fino ad allora puoi annullare il pagamento.
- Il link personale di una fattura non ha data di scadenza. Il cliente vi vede cosa è ancora aperto.
- Se il cliente ha un Peppol ID, Tillor invia automaticamente la fattura tramite Peppol dopo la contabilizzazione.
</Callout>

## Come è collegato tutto? [#hoe-hangt-dit-samen]

Una fattura è l'inizio di una catena. Un pagamento è collegato a una fattura contabilizzata, i pagamenti di un giorno finiscono in un rapporto pagamenti e quel rapporto va alla tua contabilità.

```mermaid
flowchart LR
  A[Fattura in bozza] -- Contabilizzare --> B[Fattura contabilizzata]
  B -- Invia notifica --> K[Il cliente riceve la fattura]
  K -- Il cliente paga online --> C[Pagamento]
  B -- Tu registri un pagamento --> C
  C -- Saldo e stato di pagamento --> B
  C -- Raggruppati per giorno --> D[Rapporto pagamenti]
  D -- Mollie e trasferimenti interni --> E[Contabilità]
```

- Il saldo aperto e lo stato di pagamento della fattura derivano automaticamente dai pagamenti.
- Un pagamento senza fattura puoi assegnarlo in seguito a una fattura contabilizzata.
- Quali pagamenti vanno alla contabilità lo leggi in [Contabilità](/boekhouden).

## L'elenco fatture [#de-facturenlijst]

In alto ci sono quattro contatori: **Fatture totali**, **Fatture aperte** (non pagate o parzialmente pagate), **Fatture scadute** (scadenza superata) e **Totale in sospeso** (l'importo totale delle fatture aperte).

Sotto ci sono quattro elenchi:

- **Pagamenti in attesa**: fatture contabilizzate il cui pagamento è stato avviato ma non è ancora arrivato in modo definitivo
- **Fatture con saldo aperto**: fatture contabilizzate con un importo ancora da pagare, ordinate per scadenza
- **Bozze**: le dieci fatture in bozza create più di recente
- **Tutte le fatture**: l'elenco completo, per impostazione predefinita filtrato sulle fatture contabilizzate

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Panoramica fatture - Tutte le fatture" />

Le nuove fatture non si creano da questo elenco. Lo fai nel profilo del cliente, vedi [Creare una fattura](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken).

### Cercare e filtrare [#zoeken-en-filteren]

La barra di ricerca cerca per numero di fattura, nome o cognome del cliente, indirizzo e-mail e importo. Nell'elenco **Tutte le fatture** puoi inoltre filtrare per:

| Filtro | Cosa fai con esso |
|--------|-------------------|
| **Periodo** | Solo le fatture di un determinato periodo |
| **Stato** | **Bozza** o **Contabilizzata** |
| **Stato pagamento** | **Non pagata**, **Parzialmente**, **In attesa** o **Pagata** |
| **Tipo cliente** | **Predefinito**, **Roulotte a noleggio per lavoratori** o **Roulotte di traino del lavoratore** |
| **Cliente** | Tutte le fatture di un cliente |
| **Prodotti** | Fatture con un determinato prodotto in una riga |
| **Importo** | Fatture con un importo minimo o massimo |

Nell'elenco **Fatture con saldo aperto** c'è anche il filtro **Da sollecitare**. Scegli un numero di giorni (da 7 a 90) e vedi le fatture scadute create almeno da così tanto tempo e per cui negli ultimi giorni non è stato inviato un sollecito per e-mail o SMS. Utile per decidere chi sollecitare di nuovo.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Fatture con saldo aperto" />

### Fatture per cliente [#facturen-per-klant]

Nel profilo di un cliente trovi tutte le fatture di quel cliente nel blocco **Fatture** della scheda **Panoramica**, oppure nella scheda **Fatturazione**. Lì crei anche una nuova fattura.

## Guide [#handleidingen]

<Cards>
  <Card title="Creare e modificare" href="/facturen/aanmaken-en-bewerken" description="Creare una fattura in bozza e aggiungere righe" />
  <Card title="Contabilizzare una fattura" href="/facturen/boeken" description="Rendere definitiva la fattura" />
  <Card title="Inviare una fattura" href="/facturen/versturen" description="Notifica o sollecito al cliente" />
  <Card title="Registrare i pagamenti" href="/facturen/betalingen-registreren" description="Registrare o assegnare un pagamento" />
  <Card title="Stampare e scaricare" href="/facturen/afdrukken-en-downloaden" description="PDF, stampante e link personale" />
  <Card title="Correggere" href="/facturen/corrigeren" description="Ripristinare, stornare, copiare e spostare" />
  <Card title="Stati" href="/facturen/statussen" description="Cosa significano Bozza, Contabilizzata e Pagata" />
</Cards>

## Correlati [#gerelateerd]

<Cards>
  <Card title="Elaborazione dei pagamenti" href="/betalingsverwerking" description="I metodi di pagamento in dettaglio" />
  <Card title="Prodotti" href="/producten" description="Azioni sulle righe della fattura" />
  <Card title="Contabilità" href="/boekhouden" description="Rapporti pagamenti e collegamenti contabili" />
  <Card title="Esempi pratici" href="/praktijk" description="Esempi elaborati dalla pratica" />
</Cards>

## Termini [#begrippen]

- **Bozza**: una fattura che puoi ancora modificare, con un numero di bozza provvisorio.
- **Contabilizzata**: una fattura definitiva con un proprio numero di fattura. Vedi [Contabilizzare](/begrippen#boeken).
- **Nota di credito**: una fattura contabilizzata con un totale negativo, per esempio dopo lo storno di una fattura.
- **Stato pagamento**: se e quanto della fattura è stato pagato. Vedi [Stati](/facturen/statussen).
- **Cliente**: il cliente a cui è intestata la fattura. Vedi [Cliente](/begrippen#klant).
- **Occupazione**: un cliente su una piazzola per un periodo. Vedi [Occupazione](/begrippen#bezetting).


# Stati della fattura (/it-IT/facturen/statussen)

Ogni fattura ha uno **stato** (se è già definitiva) e, una volta contabilizzata, uno **stato pagamento** (quanto è stato pagato). Puoi filtrare entrambi nell'[elenco fatture](/facturen).

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Elenco fatture con stato e stato di pagamento per ogni fattura" />

## Stato della fattura [#factuurstatus]

| Stato | Significato |
|--------|-----------|
| <Status>Bozza</Status> | La fattura è ancora modificabile e ha un numero di bozza provvisorio. Non puoi ancora inviarla né farla pagare. |
| <Status tone="success">Contabilizzata</Status> | La fattura è definitiva e ha un proprio numero di fattura. Puoi inviarla, farla pagare e correggerla. |

Una bozza ripristinata da una fattura contabilizzata ha un numero di bozza con il numero di fattura originale tra parentesi. Vedi [Correggere una fattura](/facturen/corrigeren).

## Stato pagamento [#betalingsstatus]

Lo stato di pagamento si trova accanto al numero di fattura di una fattura contabilizzata.

| Stato | Significato |
|--------|-----------|
| <Status tone="error">Non pagata</Status> | Non è stato ancora pagato nulla. |
| <Status tone="warning">Parzialmente</Status> | Una parte è stata pagata e c'è ancora un importo aperto. |
| <Status tone="info">In attesa</Status> | L'intero importo è stato avviato, per esempio un addebito diretto, ma il denaro non è ancora stato elaborato in modo definitivo. |
| <Status tone="success">Pagata</Status> | La fattura è completamente saldata. |

Una fattura è **scaduta** se la scadenza è superata e c'è ancora un importo aperto. Non è uno stato a sé. Lo vedi nel contatore **Fatture scadute** nell'elenco fatture.

## Tipo di fattura [#factuurtype]

| Tipo | Significato |
|------|-----------|
| **Fattura** | Una normale fattura con un totale positivo. |
| **Nota di credito** | Una fattura contabilizzata con un totale negativo, per esempio dopo [lo storno di una fattura](/facturen/corrigeren#een-factuur-omkeren). |

## Etichette nell'elenco del profilo del cliente [#labels-in-de-lijst-op-het-klantprofiel]

| Etichetta | Significato |
|-------|-----------|
| **Inviata via Peppol** | La fattura è stata inviata tramite Peppol. |
| **Bozza storno** | Questa bozza è stata creata per stornare un'altra fattura. |
| **Questa fattura è stata stornata** | Esiste una nota di credito o una bozza che annulla questa fattura. |

## Altro [#verder]

<Cards>
  <Card title="Panoramica" href="/facturen" description="L'elenco fatture e i filtri" />
  <Card title="Registrare i pagamenti" href="/facturen/betalingen-registreren" />
</Cards>


# Inviare una fattura (/it-IT/facturen/versturen)

Con **Invia notifica** invii al cliente una fattura contabilizzata per e-mail, SMS, WhatsApp o posta. Tillor non lo fa mai da sola. Se la fattura è già stata inviata ma non ancora pagata, invii un sollecito. Il cliente può poi pagare tramite il link nel messaggio, vedi [Far pagare un cliente online](/betalingsverwerking/online).

Prima di iniziare:

- La fattura è contabilizzata. Su una bozza i pulsanti non ci sono.
- Il cliente ha almeno un indirizzo e-mail, un numero di telefono o un indirizzo postale completo (via, CAP e comune). Altrimenti i pulsanti non ci sono.
- Per un sollecito c'è ancora un importo aperto.

## Inviare una fattura [#een-factuur-versturen]

<Steps>
<Step>
### Apri la fattura contabilizzata [#open-de-geboekte-factuur]
Vai a <UIPath>Amministrazione > Fatture</UIPath> e apri una fattura con stato <Status tone="success">Contabilizzata</Status>.
</Step>
<Step>
### Fai clic su Invia notifica [#klik-op-verstuur-notificatie]
Si apre una finestra **Invia notifica**.
</Step>
<Step>
### Scegli i canali [#kies-de-kanalen]
Puoi scegliere tra:

- **E-mail**: il cliente riceve un'e-mail con la fattura in allegato. È attivo per impostazione predefinita se c'è un indirizzo e-mail.
- **SMS**: il cliente riceve un messaggio SMS. Disponibile solo con un numero di telefono.
- **WhatsApp**: visibile solo se WhatsApp Business è installato. Richiede un numero di telefono, e un metodo di pagamento presso Meta o una conversazione in corso con il cliente.
- **Posta**: la fattura parte come PDF per posta. Disponibile solo con un indirizzo postale completo. È disattivato per impostazione predefinita e mostra un importo indicativo di affrancatura per lettera.

Un canale non utilizzabile per questo cliente è disattivato con il motivo accanto, per esempio **Nessun indirizzo e-mail registrato**. Scegli almeno un canale.
</Step>
<Step>
### Invia [#verstuur]
Fai clic su **Invia**.
</Step>
</Steps>

## Inviare un sollecito [#een-aanmaning-versturen]

Un sollecito è possibile non appena la fattura è contabilizzata e c'è ancora un importo aperto.

<Steps>
<Step>
### Apri il menu di scelta [#open-het-keuzemenu]
Fai clic sulla freccia accanto a **Invia notifica** e scegli **Invia promemoria**.
</Step>
<Step>
### Scegli i canali [#kies-de-kanalen-1]
Qui **E-mail** e **SMS** sono attivi per impostazione predefinita se il cliente ha un indirizzo e-mail e un numero di telefono. Con **Posta** il cliente riceve una lettera di sollecito con la fattura in allegato, con un codice QR per vederla o pagarla online.

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Finestra di conferma dell'invio del sollecito" />
</Step>
<Step>
### Scegli eventualmente la raccomandata [#kies-eventueel-aangetekend]
Se hai selezionato **Posta**, puoi scegliere **Raccomandata con avviso di ricevimento**. È possibile solo per un sollecito, non per la prima notifica della fattura, e solo se la raccomandata è disponibile per quell'indirizzo. Tillor mostra allora l'importo aggiuntivo indicativo oltre alle normali spese di spedizione. Il pulsante si chiama allora **Invia con costo aggiuntivo**.
</Step>
<Step>
### Invia [#verstuur-1]
Fai clic su **Invia**.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Nella pagina della fattura, il blocco **Notifiche** mostra quali messaggi sono stati inviati. Tutti i messaggi della tua organizzazione si trovano in <UIPath>Comunicazione > Notifiche</UIPath>.

Gli invii postali partono con lo stato **In attesa**. Poi segue lo stato della lettera: **PDF ricevuto**, **Validato**, **In elaborazione**, **In centro stampa** e **Consegnato al servizio postale**. Non appena il vettore lo conferma, lo stato diventa **Inviato**. La posta non recapitabile diventa **Non riuscito**. Una lettera annullata presso il vettore riceve lo stato **Ignorato**. Apri il messaggio per l'importo di affrancatura, il riferimento del vettore e l'ultimo stato di tracciamento. Maggiori informazioni in [Notifiche](/notificaties).

- Tillor invia subito il messaggio. Il cliente riceve un link per vedere la fattura e pagare online.
- Un sollecito resta un'azione singola per fattura. Il filtro **Da sollecitare** nell'[elenco fatture](/facturen) ti aiuta a scegliere chi sollecitare di nuovo.
- Le automazioni possono inviare i solleciti anche automaticamente. Vedi [Automazioni](/automatiseringen).

<Callout type="info">
Una fattura per cui è già stata inviata una notifica non si può più riportare facilmente in bozza. Vedi [Correggere una fattura](/facturen/corrigeren#terugzetten-naar-concept).
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Invia notifica">
La fattura deve essere contabilizzata e il cliente deve avere un indirizzo e-mail, un numero di telefono o un indirizzo postale completo. Completa i dati nel profilo del cliente.
</Accordion>
<Accordion title="Non vedo Invia promemoria">
Un sollecito è possibile solo per una fattura contabilizzata con un importo aperto.
</Accordion>
<Accordion title="Il messaggio non è riuscito">
Apri il messaggio in <UIPath>Comunicazione > Notifiche</UIPath> per vedere l'errore. Controlla poi l'indirizzo e-mail, il numero di telefono o l'indirizzo postale del cliente e invia di nuovo. Vedi [Notifiche](/notificaties).
</Accordion>
</Accordions>

## Altro [#verder]

<Cards>
  <Card title="Notifiche" href="/notificaties" description="Stato e cronologia dei messaggi inviati" />
  <Card title="Registrare i pagamenti" href="/facturen/betalingen-registreren" />
</Cards>


# Invitare utenti e assegnare permessi (/it-IT/gebruikers/gebruikers-en-rechten)

Un collega con un account Tillor si chiama utente in Tillor. Sei tu a decidere chi ha accesso alla tua organizzazione e che cosa può vedere e fare, con i permessi. Per i colleghi che coinvolgi spesso insieme, crea poi un [gruppo](/gebruikers/groepen).

Prima di iniziare:

- Ti serve il permesso **Gestisci permessi utente**. Senza questo permesso i pulsanti **Invita utente** e **Modifica permessi utente** sono grigi.
- Puoi assegnare solo permessi che hai tu stesso. Un permesso che non hai non puoi attivarlo per un altro.
- Il permesso **Gestisci permessi utente** può assegnarlo a un altro solo un utente con **Tutti i permessi**.

## Invitare un collega [#een-collega-uitnodigen]

<Steps>
<Step>
### Apri gli utenti [#open-de-gebruikers]
Vai a <UIPath>Assistenza > Impostazioni > Utenti</UIPath>. Vedi i **Membri** della tua organizzazione e gli **Inviti in sospeso**.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Impostazioni > Utenti con l'elenco dei membri" />
</Step>
<Step>
### Fai clic su Invita utente [#klik-op-gebruiker-uitnodigen]
Si apre la finestra **Invita utente**.

<DocScreenshot src="/screenshots/gebruikers/settings-members-invite-dialog.png" alt="La finestra Invita utente" />
</Step>
<Step>
### Inserisci l'indirizzo e-mail [#vul-het-e-mailadres-in]
Digita l'**Indirizzo e-mail** del tuo collega e fai clic su **Invita**.
</Step>
</Steps>

Che cosa succede dopo dipende dall'indirizzo e-mail:

<Tabs items={["Esiste già un account Tillor", "Non c'è ancora un account Tillor"]}>
<Tab value="Esiste già un account Tillor">
L'utente diventa subito membro della tua organizzazione. Tillor segnala **Utente aggiunto all'organizzazione**. La persona vede subito la tua organizzazione tra le sue organizzazioni.
</Tab>
<Tab value="Non c'è ancora un account Tillor">
Tillor segnala **Invito inviato** e manda un invito via e-mail. Finché la persona non accede per la prima volta, compare tra gli **Inviti in sospeso** con il badge **In attesa**. Al primo accesso diventa membro della tua organizzazione. Con **Revoca invito** ritiri l'invito e Tillor segnala **Invito revocato**.
</Tab>
</Tabs>

Un nuovo utente parte con questi permessi: **Visualizza impostazioni**, **Modifica impostazioni**, **Visualizza integrazioni**, **Gestisci integrazioni**, **Notifiche allarmi contatori**, **Notifiche messaggi inbox**, **Avvisi tablet e chiosco**, **Gestire le richieste di firma** e **Gestisci campi personalizzati**. Controlla che vadano bene e modificali se serve.

## Modificare i permessi [#rechten-bewerken]

<Steps>
<Step>
### Fai clic su Modifica permessi utente [#klik-bij-de-gebruiker-op-rechten-bewerken]
Si apre la finestra **Modifica permessi utente**. In alto trovi i gruppi di cui l'utente fa parte. Con **Cerca autorizzazioni** trovi rapidamente un permesso.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions-dialog.png" alt="La finestra Modifica permessi utente con i permessi per area" />
</Step>
<Step>
### Attiva o disattiva i permessi [#zet-rechten-aan-of-uit]
I permessi sono raggruppati per area, come **Fatturazione**, **Pagamenti** o **Inbox**. In fondo vedi quanti permessi effettivi ha l'utente.
</Step>
<Step>
### Salva i permessi [#sla-de-rechten-op]
Fai clic su **Salva permessi**. Tillor segnala **Permessi utente salvati**.
</Step>
</Steps>

### Da dove viene un permesso? [#waar-komt-een-recht-vandaan]

Accanto a ogni permesso è indicata la fonte. Così vedi perché qualcuno può o non può fare qualcosa.

| Fonte | Significato |
|---|---|
| **Diretto** | Hai assegnato il permesso direttamente a questo utente. Qui puoi disattivarlo |
| Il nome di un gruppo | Quel [gruppo](/gebruikers/groepen#groepsrechten) assegna il permesso. Qui non puoi disattivarlo, puoi farlo nel gruppo |
| **Bloccato** con il nome di un gruppo | Quel gruppo nega il permesso. Anche se l'utente lo aveva di suo, resta bloccato |
| **Non concesso** | Nessuno assegna il permesso |

Il pulsante **Modifica permessi utente** è grigio per la tua riga e per gli utenti con il badge **Tutti i permessi**. Questi utenti hanno tutto e non puoi limitarli.

## Impostare le notifiche di un collega [#meldingen-van-een-collega-instellen]

Con l'icona della campanella (**Impostazioni notifiche**) accanto a un utente apri le sue notifiche in questa organizzazione. Per ogni notifica scegli e-mail, push o telefonata. Con **Tutte le notifiche** disattivi un canale in un colpo solo. Le modifiche hanno effetto subito e valgono solo in questa organizzazione.

<DocScreenshot src="/screenshots/gebruikers/settings-members-notifications-dialog.png" alt="La finestra con le notifiche di un collega" />

Le notifiche che vengono sempre inviate non puoi disattivarle. Che cos'è una notifica e dove la ritrovi lo trovi in [Notifiche](/notificaties#meldingen-in-de-app).

## Rimuovere un utente [#een-gebruiker-verwijderen]

Fai clic sull'icona del cestino (**Rimuovi dall'organizzazione**) e conferma con **Rimuovi utente**. Tillor segnala **Utente rimosso dall'organizzazione**. La persona perde subito l'accesso a questa organizzazione. Il suo account Tillor resta, così come le eventuali altre organizzazioni.

Non puoi rimuovere te stesso. Un utente con **Tutti i permessi** puoi rimuoverlo solo se hai anche tu **Tutti i permessi**.

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- L'utente vede la tua organizzazione tra le sue organizzazioni e può usare ciò per cui ha i permessi.
- Una modifica dei permessi vale subito dopo il salvataggio.
- Un utente rimosso perde subito l'accesso. Il suo account Tillor resta.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il pulsante Invita utente è grigio">
Non hai il permesso **Gestisci permessi utente**. Chiedi a un collega con **Tutti i permessi** di assegnartelo.
</Accordion>
<Accordion title="Tillor segnala Impossibile invitare l'utente">
Quell'indirizzo e-mail è già membro della tua organizzazione, oppure per quell'indirizzo c'è già un invito aperto. Controlla gli elenchi **Membri** e **Inviti in sospeso**. Se l'invito c'è già, revocalo e invita di nuovo se la persona non ha ricevuto l'e-mail.
</Accordion>
<Accordion title="La persona invitata non trova la sua e-mail">
Chiedile di controllare lo spam. Diventa membro solo se accede con esattamente l'indirizzo e-mail con cui l'hai invitata. Se accede con un altro indirizzo, revoca l'invito e invita quell'indirizzo.
</Accordion>
<Accordion title="Un permesso è grigio e non riesco ad attivarlo">
Puoi assegnare solo permessi che hai tu stesso. Se accanto al permesso c'è il nome di un gruppo, è quel gruppo ad assegnarlo o a bloccarlo e lo modifichi nel gruppo.
</Accordion>
<Accordion title="Modifica permessi utente è grigio per un collega">
Il collega ha **Tutti i permessi**, oppure è la tua riga. Non puoi modificarli.
</Accordion>
<Accordion title="A un collega manca un pulsante anche se ho assegnato il permesso">
Controlla nella finestra **Modifica permessi utente** se un gruppo mostra il permesso come **Bloccato**. Il rifiuto di un gruppo prevale sempre su un permesso assegnato direttamente.
</Accordion>
<Accordion title="Non riesco a rimuovere un utente">
Non puoi rimuovere te stesso. Un utente con **Tutti i permessi** puoi rimuoverlo solo se hai anche tu **Tutti i permessi**.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gruppi" href="/gebruikers/groepen" description="Raggruppare i colleghi e impostare i permessi per gruppo" />
  <Card title="Notifiche" href="/notificaties" description="Come arrivano le notifiche" />
  <Card title="Visibilità e accesso dei campi personalizzati" href="/eigen-velden/zichtbaarheid-en-toegang" description="Permessi per ogni campo personalizzato" />
  <Card title="Organizzazione" href="/gebruikers/organisaties" description="Tutte le sezioni di Impostazioni" />
</Cards>


# Gruppi (/it-IT/gebruikers/groepen)

Un gruppo è un insieme fisso di colleghi, per esempio **Reception** o **Servizio tecnico**. Usi un gruppo in questi punti:

- **Assegnare attività**: quando assegni un'attività, cerca il nome del gruppo
- **Menzionare e avvisare**: una menzione o una notifica a un gruppo arriva a tutti i membri
- **Condividere viste**: in una vista delle attività scegli **Gruppi specifici**, vedi [Viste](/taken/weergaven#wie-ziet-een-weergave)
- **Automazioni**: i passaggi che creano o aggiornano un'attività possono assegnarla a gruppi

## Creare un gruppo [#een-groep-maken]

<Steps>
<Step>
### Apri Gruppi [#open-groepen]
Vai a <UIPath>Assistenza > Impostazioni > Gruppi</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-groups.png" alt="Impostazioni > Gruppi con due gruppi" />
</Step>
<Step>
### Fai clic su Nuovo gruppo [#klik-op-nieuwe-groep]
Inserisci un **Nome**, per esempio Reception.
</Step>
<Step>
### Scegli i membri [#kies-de-leden]
In **Membri** scegli le persone. Puoi aggiungere solo utenti che sono già membri dell'organizzazione.
</Step>
<Step>
### Fai clic su Salva [#klik-op-opslaan]
Tillor segnala **Gruppo salvato**.
</Step>
</Steps>

Fai clic su un gruppo per modificarne il nome o i membri. Se elimini un gruppo, le attività restano assegnate a chi vi è assegnato direttamente. Sparisce solo il gruppo.

## Autorizzazioni del gruppo [#groepsrechten]

Un gruppo può anche concedere o togliere permessi. Accanto al gruppo fai clic sulla chiavetta (**Autorizzazioni del gruppo**). Per ogni permesso scegli:

| Scelta | Che cosa fa |
|---|---|
| **Consenti** | Tutti nel gruppo ottengono il permesso ("Concesso a tutti") |
| **Eredita** | Il gruppo non fa nulla con questo permesso. Ogni membro mantiene il proprio accesso ("Eredita il proprio accesso"). È lo stato iniziale |
| **Nega** | Il permesso è bloccato per tutti nel gruppo ("Bloccato per tutti") |

<DocScreenshot src="/screenshots/gebruikers/settings-group-permissions-dialog.png" alt="La finestra Autorizzazioni del gruppo con Nega, Eredita e Consenti" />

Con **Cerca autorizzazioni** trovi rapidamente un permesso. In fondo vedi quanti permessi hai impostato. Fai clic su **Salva** e Tillor segnala **Autorizzazioni del gruppo salvate**.

<Requires permission="Gebruikersrechten beheren" />

Senza questo permesso il pulsante **Autorizzazioni del gruppo** è grigio. Inoltre non puoi eliminare un gruppo che ha ancora autorizzazioni del gruppo.

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Le autorizzazioni del gruppo si aggiungono ai permessi propri di ogni membro. Un rifiuto prevale sempre: se un permesso è su **Nega** in un gruppo e su **Consenti** in un altro, resta bloccato.
- Nella finestra **Modifica permessi utente** di un membro vedi per ogni permesso quale gruppo lo concede o lo blocca. Vedi [Modificare i permessi](/gebruikers/gebruikers-en-rechten#rechten-bewerken).
- Se aggiungi un membro, le autorizzazioni del gruppo valgono anche per lui. Se lo togli, non più.
- Assegnare un'attività, menzionare qualcuno o inviare una notifica al gruppo raggiunge tutti i membri in quel momento.

## Gruppi da Microsoft Entra [#groepen-uit-microsoft-entra]

Se gestisci già il personale in Microsoft Entra ID, Entra può aggiornare automaticamente i membri di un gruppo. Sotto l'elenco dei gruppi compare allora la tabella **Gruppi Entra**, in cui colleghi ogni gruppo Entra a un gruppo Tillor.

<Callout type="info">
In un gruppo collegato la fonte è Entra. Un membro che aggiungi o togli a mano in Tillor viene riallineato a Entra alla sincronizzazione successiva.
</Callout>

Vedi [Gruppi Microsoft Entra](/gebruikers/microsoft-entra) per configurare il collegamento.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor segnala Impossibile salvare il gruppo">
Riprova. Se continua a non funzionare, contatta il supporto Tillor.
</Accordion>
<Accordion title="Il pulsante Autorizzazioni del gruppo è grigio">
Non hai il permesso **Gestisci permessi utente**.
</Accordion>
<Accordion title="Un membro non può fare qualcosa anche se il gruppo lo consente">
Un altro gruppo di quel membro nega quel permesso. Un rifiuto prevale sempre. Apri la finestra **Modifica permessi utente** del membro per vedere quale gruppo lo blocca.
</Accordion>
<Accordion title="Non vedo un membro nell'elenco di scelta">
Nell'elenco ci sono solo gli utenti della tua organizzazione. Invita prima la persona. Vedi [Invitare utenti](/gebruikers/gebruikers-en-rechten).
</Accordion>
<Accordion title="Un membro sparisce di continuo dal gruppo">
Se il gruppo è collegato a Microsoft Entra, la fonte è Entra e la sincronizzazione successiva riallinea i membri. Modifica il membro in Entra.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gruppi Microsoft Entra" href="/gebruikers/microsoft-entra" description="Aggiornare i gruppi automaticamente da Entra" />
  <Card title="Viste" href="/taken/weergaven" description="Condividere una vista delle attività con un gruppo" />
  <Card title="Organizzazione" href="/gebruikers/organisaties" description="Impostazioni e permessi utente" />
</Cards>


# Panoramica (/it-IT/gebruikers)

Qui stabilisci chi lavora con Tillor e che cosa può fare: invitare utenti, assegnare permessi, raggruppare i colleghi e modificare le impostazioni della tua organizzazione. Un utente è chiunque abbia un account con accesso alla tua organizzazione. Gestisci tutto in <UIPath>Assistenza > Impostazioni</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Impostazioni > Utenti con l'elenco dei membri" />

<Callout type="info" title="Da sapere">
- Un nuovo utente riceve un set fisso di permessi iniziali (impostazioni, integrazioni, alcune notifiche, richieste di firma e campi personalizzati). Tutto il resto lo assegni tu
- Puoi assegnare solo permessi che hai tu stesso. Il permesso **Gestisci permessi utente** può passarlo solo un utente con **Tutti i permessi**
- Un rifiuto tramite un gruppo prevale sempre su un permesso assegnato direttamente
- Non puoi rimuovere te stesso né modificare i tuoi permessi
- Non hai una password Tillor separata: accedi tramite Google, Microsoft o Apple
- I dati aziendali come partita IVA o IBAN non li modifichi tu. Lo fa il supporto Tillor
</Callout>

## Come sono collegati? [#hoe-hangt-dit-samen]

Un utente ha i permessi in due modi: direttamente o tramite un gruppo. Un gruppo può anche negare un permesso.

```mermaid
flowchart TD
  U[Utente] -->|assegnato direttamente| R[Permessi dell'utente]
  U -->|è membro di| G[Gruppo]
  G -->|Consenti| R
  G -->|Eredita| N[Non fa nulla, l'utente mantiene i propri permessi]
  G -->|Nega| B[Permesso bloccato, anche se l'utente lo aveva di suo]
  R --> A[Che cosa l'utente vede e può fare in Tillor]
  B --> A
```

- **Diretto**: attivi un permesso nella finestra **Modifica permessi utente**. Vedi [Invitare utenti e assegnare permessi](/gebruikers/gebruikers-en-rechten).
- **Tramite un gruppo**: in **Autorizzazioni del gruppo** scegli per ogni permesso **Consenti**, **Eredita** o **Nega**. Vale per tutti nel gruppo. Vedi [Gruppi](/gebruikers/groepen).
- **Negato**: se un permesso è su **Nega** in un solo gruppo, è bloccato, per quanti altri gruppi o permessi diretti lo concedano.
- Gli stessi gruppi li usi per assegnare attività, menzionare e condividere viste.

## Il tuo account [#je-eigen-account]

Nella sidebar fai clic sul tuo nome (in basso) e scegli **Account**. Lì gestisci il tuo profilo, il numero di telefono, le sessioni attive, le app OAuth e le piattaforme di accesso collegate. In **Notifiche** scegli per ogni notifica se Tillor ti raggiunge via e-mail o push. Vedi [Accedere e accesso](/inloggen).

## Chiavi API [#api-sleutels]

Una chiave API permette a un altro programma di comunicare con Tillor a tuo nome. Appartiene al tuo account. Le gestisci nella pagina del tuo account.

<Steps>
<Step>
### Apri il tuo account [#open-je-account]
Nella sidebar fai clic sul tuo nome (in basso) e scegli **Account**.
</Step>
<Step>
### Crea la chiave [#maak-de-sleutel]
Apri la sezione **Chiavi API** e fai clic su **Crea chiave API**.
</Step>
<Step>
### Copiala subito [#kopieer-hem-meteen]
Dopo, Tillor non mostra più la chiave per intero.
</Step>
</Steps>

Tramite **Sviluppatori** (stesso menu utente) trovi anche il collegamento rapido **Vai alle chiavi API**.

<Callout type="warn">
Conserva le chiavi API in modo sicuro e non condividerle mai su canali non protetti. Se una chiave è stata divulgata, eliminala oppure fai clic su **Rigenera** e crea una nuova chiave se serve.
</Callout>

## Sezioni [#onderdelen]

<Cards>
  <Card title="Invitare utenti e assegnare permessi" href="/gebruikers/gebruikers-en-rechten" description="Aggiungere colleghi e stabilire che cosa possono fare" />
  <Card title="Gruppi" href="/gebruikers/groepen" description="Assegnare, menzionare e dare permessi ai colleghi insieme" />
  <Card title="Gruppi Microsoft Entra" href="/gebruikers/microsoft-entra" description="Aggiornare automaticamente i membri dei gruppi da Entra" />
  <Card title="Organizzazione" href="/gebruikers/organisaties" description="Tutte le sezioni di Impostazioni" />
  <Card title="Impostazioni di fatturazione" href="/gebruikers/instellingen-facturatie" description="PDF, scadenza e aliquote IVA" />
  <Card title="Impostazioni dei pagamenti" href="/gebruikers/instellingen-betalingen" description="Altro, solleciti e indirizzo mittente" />
  <Card title="Impostare i periodi di locazione" href="/gebruikers/instellingen-huurperiodes" description="Frequenze di locazione per le occupazioni" />
  <Card title="Impostazioni del controllo accessi" href="/gebruikers/instellingen-toegangscontrole" description="Uscire con una targa scaduta" />
  <Card title="Sviluppatori" href="/ontwikkelaars" description="Documentazione delle integrazioni e webhook" />
</Cards>

## Termini [#begrippen]

- **Utente**: chi ha un account con accesso alla tua [organizzazione](/begrippen#organisatie).
- **[Permesso](/begrippen#recht)**: un'autorizzazione a vedere o fare qualcosa, come **Modifica prodotti**.
- **Tutti i permessi**: un badge per gli utenti che possono fare tutto. I loro permessi non si modificano.
- **[Gruppo](/begrippen#groep)**: un insieme fisso di colleghi, eventualmente con permessi propri.
- **Invito**: una richiesta in sospeso a qualcuno senza account di diventare membro.
- **Chiave API**: un codice con cui un altro programma lavora con Tillor.

Altri termini sono nell'[elenco dei termini](/begrippen).


# Impostazioni dei pagamenti (/it-IT/gebruikers/instellingen-betalingen)

In <UIPath>Assistenza > Impostazioni > Pagamenti</UIPath> trovi alcune impostazioni che influiscono sulla registrazione dei pagamenti e sull'invio delle notifiche. Le impostazioni valgono per tutta la tua organizzazione.

<Requires permission="Instellingen bewerken" />

<DocScreenshot src="/screenshots/instellingen/settings-payments.png" alt="Impostazioni > Pagamenti" />

## Impostazioni [#instellingen]

| Impostazione | Che cosa fa |
|---|---|
| **Mostra metodo di pagamento "Altri"** | Inserisce il metodo **Altro** nella schermata di pagamento. Con questo registri pagamenti con una descrizione tua, per esempio un assegno o uno scambio. Di default disattivato. |
| **Predefinito: promemoria bonifico manuale** | Attiva di default la spunta del promemoria sulla comunicazione strutturata quando registri un bonifico bancario manuale. Puoi comunque attivare o disattivare la spunta per ogni pagamento. Di default disattivato. |
| **Massimo in contanti** | Un importo in euro interi. Di default 2999. |
| **Indirizzo mittente e-mail** | L'indirizzo con cui Tillor invia le notifiche via e-mail. |

## Massimo in contanti [#maximumbedrag-contant]

Con **Massimo in contanti** stabilisci quanto può essere alto un singolo pagamento in contanti. Di default sono 2999 euro. Tillor lo controlla a ogni pagamento in contanti, anche se arriva tramite un collegamento. Se l'importo è più alto, registralo in più parti o scegli un altro metodo. Vedi [Contanti e bonifico](/betalingsverwerking/contant).

## Indirizzo mittente delle notifiche [#afzenderadres-van-meldingen]

Se lasci vuoto **Indirizzo mittente e-mail**, come mittente delle notifiche compare il nome della tua organizzazione, con un indirizzo di Tillor. Se inserisci un indirizzo e-mail valido, per esempio `meldingen@recreatiepark-het-meer.be`, Tillor usa quell'indirizzo, con il nome della tua organizzazione come nome del mittente. Inserisci solo l'indirizzo, senza nome. Un indirizzo non valido non viene salvato.

## Salvare le modifiche [#wijzigingen-opslaan]

In fondo fai clic su **Salva impostazioni**. Con **Annulla** riporti il modulo ai valori salvati.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Contanti e bonifico" href="/betalingsverwerking/contant" description="Registrare pagamenti arrivati fuori da Tillor" />
  <Card title="Registrare pagamenti su una fattura" href="/facturen/betalingen-registreren" description="Metodi di pagamento e campi nella schermata di pagamento" />
  <Card title="Impostazioni di fatturazione" href="/gebruikers/instellingen-facturatie" description="Scadenza, IVA e PDF" />
</Cards>


# Impostazioni di fatturazione (/it-IT/gebruikers/instellingen-facturatie)

In <UIPath>Assistenza > Impostazioni > Fatturazione</UIPath> imposti i valori predefiniti per le fatture e per il PDF che invii ai clienti. Le impostazioni valgono per tutta la tua organizzazione.

<Requires permission="Instellingen bewerken" />

<DocScreenshot src="/screenshots/instellingen/settings-invoicing.png" alt="Impostazioni > Fatturazione" />

## Che cosa compare nel PDF della fattura [#wat-staat-er-op-de-factuur-pdf]

| Impostazione | Che cosa fa |
|---|---|
| **Condizioni generali sul PDF fattura** | Il PDF ottiene per ogni pagina un retro con le condizioni generali. Nel piè di pagina c'è un rimando. Il testo delle condizioni è fisso e riporta la denominazione legale della tua organizzazione. Di default disattivato. |
| **Tabella riepilogo IVA sul PDF fattura** | Accanto ai totali compare una tabella con, per ogni aliquota IVA, l'imponibile e l'importo IVA. Di default disattivato. |
| **Righe per pagina del PDF fattura** | Il numero massimo di righe in una pagina. Se ce ne sono di più, segue una nuova pagina. Di default 20, minimo 1. |

## Termine di pagamento [#betaaltermijn]

In **Scadenza predefinita (giorni)** inserisci il numero di giorni tra la data della fattura e la data di scadenza. Vale per le fatture per cui non hai scelto tu una data di scadenza. Di default sono 7 giorni. Puoi inserire 0: la fattura scade allora il giorno della contabilizzazione. Vedi [Contabilizzare una fattura](/facturen/boeken).

## Scegliere le aliquote IVA [#btw-tarieven-kiezen]

In **Aliquote IVA ammesse** trovi le aliquote che puoi scegliere nell'elenco IVA delle fatture in bozza. Di default sono 0%, 6%, 9%, 12% e 21%.

1. Digita una percentuale tra 0 e 100 nel campo sotto l'elenco. Va bene la virgola o il punto.
2. Fai clic su **Aggiungi aliquota**.
3. Togli un'aliquota con la crocetta accanto alla percentuale.
4. Fai clic su **Salva impostazioni**.

L'elenco è sempre in ordine crescente. Un'aliquota già presente nell'elenco non la aggiungi due volte. Se una riga di fattura esistente ha un'aliquota che poi togli dall'elenco, quell'aliquota resta su quella riga.

Questo elenco lo vedi solo se **Menu a tendina aliquota IVA sulle righe fattura in bozza** è attivo. Una fattura in bozza ha allora una colonna IVA in cui scegli un'aliquota per ogni riga. Se scegli un prodotto, l'aliquota di quel prodotto resta il valore iniziale. Vedi [IVA](/boekhouden/belasting) e [Creare e modificare fatture](/facturen/aanmaken-en-bewerken).

## Fatture automatiche per i consumi [#automatische-facturen-voor-verbruik]

In **Importo minimo per le fatture utenze automatiche** inserisci un importo in euro. Per i clienti con fatturazione automatica delle utenze, Tillor crea una fattura solo quando l'importo aperto raggiunge questo importo. Se lasci il campo vuoto (**Nessun minimo**), viene fatturato qualsiasi importo aperto.

Se un cliente ha un proprio minimo nel profilo cliente, per quel cliente vale quel minimo al posto di questa impostazione. Vedi [Gestione contatori](/meterbeheer).

## Salvare le modifiche [#wijzigingen-opslaan]

In fondo fai clic su **Salva impostazioni**. Con **Annulla** riporti il modulo ai valori salvati. Se hai solo il permesso **Visualizza impostazioni**, i campi sono grigi.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Contabilizzare una fattura" href="/facturen/boeken" description="Data della fattura e data di scadenza" />
  <Card title="IVA" href="/boekhouden/belasting" description="Aliquote IVA e IVA sulle fatture" />
  <Card title="Impostazioni dei pagamenti" href="/gebruikers/instellingen-betalingen" description="Contanti, Altro e indirizzo mittente" />
</Cards>


# Impostare i periodi di locazione (/it-IT/gebruikers/instellingen-huurperiodes)

In un'occupazione scegli una **Frequenza affitto**. Le scelte che vedi lì le stabilisci in <UIPath>Assistenza > Impostazioni > Periodi di affitto</UIPath>. Ogni periodo che aggiungi qui diventa una scelta nell'elenco.

<Requires permission="Instellingen bewerken" />

<DocScreenshot src="/screenshots/instellingen/settings-occupation.png" alt="Impostazioni > Periodi di affitto con un nuovo periodo" />

## Aggiungere un periodo [#een-periode-toevoegen]

<Steps>
<Step>
### Aggiungi un periodo [#voeg-een-periode-toe]
Apri **Periodi di affitto** e fai clic su **Aggiungi periodo**. Compare un blocco con i valori iniziali: gennaio, 12 mesi.
</Step>
<Step>
### Compila il periodo [#vul-de-periode-in]
Scegli il **Mese di inizio** e in **Durata (mesi)** inserisci un numero da 1 a 12. Un periodo di 12 mesi che inizia a gennaio è un anno solare. Un periodo di 1 mese è un affitto mensile. In **Etichetta** puoi inserire un nome tuo, per esempio Annuale.
</Step>
<Step>
### Scegli come arrotondare [#kies-hoe-je-afrondt]
La spunta **Arrotonda le date di inizio al periodo successivo** è attiva di default. Che cosa fa lo leggi in [Arrotondare al periodo successivo](#afronden-naar-de-volgende-periode).
</Step>
<Step>
### Salva [#sla-op]
Fai clic su **Salva impostazioni**. Con **Rimuovi periodo** togli un periodo. Con **Annulla** riporti il modulo all'elenco salvato.
</Step>
</Steps>

Se non hai ancora aggiunto periodi, compare **Nessun periodo di affitto configurato**. Nel modulo di un'occupazione non puoi allora scegliere una frequenza di locazione.

## Dove ritrovi i periodi [#waar-zie-je-de-periodes-terug]

Nel modulo di un'occupazione l'elenco è sotto **Frequenza affitto**, con in cima **Nessuna frequenza**. Un periodo di 1 mese si chiama lì **Mensile**. Un periodo di 12 mesi appare come **Anno (gen - dic)**, con il primo e l'ultimo mese del tuo periodo. Altre durate appaiono come **6 mesi (apr - set)**. Se per un periodo hai compilato un'**Etichetta**, quell'etichetta compare al posto di quel testo, nell'elenco e nella colonna **Frequenza affitto** delle occupazioni.

Se togli un periodo dalle impostazioni, le occupazioni già create con quel periodo mantengono la loro frequenza di locazione.

## Arrotondare al periodo successivo [#afronden-naar-de-volgende-periode]

La spunta determina lo stato iniziale di **Arrotonda al prossimo confine periodo** sulla riga di fattura con cui prolunghi un'occupazione. Sulla riga di fattura puoi comunque attivare o disattivare la spunta da solo.

- Se la spunta è attiva, la riga termina al primo confine di periodo successivo. Se inizi a metà di un periodo, calcoli il primo tratto in proporzione. Poi il cliente segue lo stesso ciclo degli altri affittuari.
- Se la spunta è disattiva, la riga dura esattamente un periodo a partire dalla data di inizio.

Vedi [Creare e modificare fatture](/facturen/aanmaken-en-bewerken) e [Occupazioni](/bezettingen).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Occupazioni" href="/bezettingen" description="Collegare un cliente a una piazzola a lungo termine" />
  <Card title="Creare e modificare fatture" href="/facturen/aanmaken-en-bewerken" description="Arrotondare al prossimo confine periodo su una riga di fattura" />
</Cards>


# Impostazioni del controllo accessi (/it-IT/gebruikers/instellingen-toegangscontrole)

In <UIPath>Assistenza > Impostazioni > Controllo accessi</UIPath> imposti il comportamento delle sbarre per le targhe il cui periodo di accesso è scaduto.

<Requires permission="Instellingen bewerken" />

<DocScreenshot src="/screenshots/instellingen/settings-access-control.png" alt="Impostazioni > Controllo accessi" />

## Far uscire le targhe scadute [#verlopen-kentekens-laten-uitrijden]

Un visitatore con una targa il cui periodo di accesso è scaduto altrimenti non passa più dalla sbarra di uscita. Con **Consenti l'uscita alle targhe scadute** la sbarra di uscita si apre comunque, durante un periodo di tolleranza dopo la scadenza. Funziona solo fuori dagli orari di apertura. Se la reception è aperta, il personale gestisce il veicolo al banco.

La spunta è attiva di default. Se la disattivi, la sbarra di uscita resta chiusa per una targa scaduta.

| Impostazione | Che cosa fa |
|---|---|
| **Consenti l'uscita alle targhe scadute** | Attiva o disattiva il periodo di tolleranza. |
| **Periodo di tolleranza per l'uscita (giorni)** | Il numero di giorni dopo la scadenza in cui un veicolo può ancora uscire fuori dagli orari di apertura. Di default 2, al massimo 30. Con 0 non c'è tolleranza. |

La tolleranza vale solo per le targhe a un'uscita. Una targa bloccata o non attiva non ottiene mai tolleranza. Per altri metodi di accesso, come i tag NFC o i codici QR, la tolleranza non esiste.

Gli orari di apertura vengono da <UIPath>Assistenza > Impostazioni > Orari di apertura</UIPath>. Vedi [Orari di apertura](/gebruikers/organisaties#openingsuren).

## Salvare le modifiche [#wijzigingen-opslaan]

In fondo fai clic su **Salva impostazioni**. Con **Annulla** riporti il modulo ai valori salvati.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Controllo accessi" href="/toegangscontrole" description="Punti di accesso, veicoli e registro" />
  <Card title="Organizzazione" href="/gebruikers/organisaties" description="Orari di apertura e altre impostazioni" />
</Cards>


# Gruppi Microsoft Entra (/it-IT/gebruikers/microsoft-entra)

Con il provisioning, Microsoft Entra ID invia a Tillor i tuoi utenti e gruppi. Se colleghi un gruppo Entra a un [gruppo](/gebruikers/groepen) Tillor, i membri di quel gruppo seguono Entra: chi aggiungi in Entra riceve le attività e le viste del gruppo, e chi togli o disattivi le perde. Per questo nessuno deve accedere di nuovo.

Entra usa a tal fine il protocollo SCIM. Tillor non legge nulla da solo dal tuo tenant Microsoft: è Entra a decidere quali utenti e gruppi inviare. Solo durante la [configurazione rapida](#snel-instellen) il tuo browser parla con Microsoft per creare l'app al posto tuo.

## Che cosa succede e che cosa no [#wat-er-wel-en-niet-gebeurt]

- **Solo membri esistenti.** Entra non crea account Tillor. Chi non è ancora membro della tua organizzazione non conta finché non lo [inviti](/gebruikers/organisaties). Non appena diventa membro, entra subito nei suoi gruppi collegati
- **Nessun dato dei non membri.** Delle persone senza account Tillor, Tillor non conserva né nome né indirizzo e-mail, solo un codice illeggibile con cui le riconosce quando diventano membri in seguito
- **Niente senza collegamento.** Un gruppo Entra cambia qualcosa in Tillor solo quando lo colleghi a un gruppo Tillor in **Gruppi Entra non collegati**
- **Uno a uno.** Un gruppo Tillor appartiene al massimo a un gruppo Entra
- **Il nome resta di Tillor.** Se rinomini il gruppo in Entra, vedi il nuovo nome dopo **Entra ·**, ma il gruppo Tillor mantiene il proprio nome
- **I gruppi annidati** non vengono espansi. Un gruppo che è membro di un altro gruppo non conta come membro. Se vuoi anche quelle persone, assegna il gruppo annidato a parte in Entra e collegalo allo stesso gruppo Tillor o a un altro
- **L'accesso non cambia.** Le persone accedono come sempre con Microsoft, vedi [Accedere](/inloggen)

## Prima di iniziare [#voordat-je-begint]

Ti servono:

- In Tillor il permesso **Modifica impostazioni**
- In Microsoft Entra il ruolo **Cloud Application Administrator** o **Application Administrator** (o superiore)
- Una licenza Entra che consenta il provisioning automatico verso app proprie (Microsoft Entra ID P1 o superiore)

Assicurati che i tuoi colleghi abbiano in Tillor lo stesso account Microsoft o lo stesso indirizzo e-mail che hanno in Entra. Così Tillor riconosce chi è chi, vedi [Come Tillor riconosce le persone](#hoe-tillor-mensen-herkent).

## Configurazione rapida [#snel-instellen]

Se sei tu l'amministratore Entra, Tillor prepara il collegamento in un colpo solo.

1. Vai a **Assistenza > Impostazioni** e scegli **Gruppi**
2. Accanto a **Microsoft Entra** fai clic su **Configura con Microsoft** e poi su **Accedi e configura**
3. Nella finestra di Microsoft accedi con il tuo account amministratore e concedi il permesso. Microsoft chiede di poter gestire app e provisioning e leggere i tuoi gruppi

Tillor crea quindi l'app in Entra, inserisce l'URL del tenant e il token, fa riconoscere gli utenti dal loro account Microsoft e fa inviare a Entra anche il tipo di ogni gruppo. Poi parte la sincronizzazione e Tillor invia subito te e tutti i tuoi gruppi, così non devi aspettare la prima sincronizzazione. Infine Tillor legge per ogni gruppo il tipo e se c'è un Team collegato. Vedi spuntare ogni passaggio. Tillor lo fa in background: puoi chiudere la finestra o perfino la pagina. Se in seguito fai di nuovo clic su **Configura con Microsoft**, vedi a che punto è, oppure fino a un'ora dopo la fine se è riuscito o fallito. Poi puoi ricominciare con **Configura di nuovo**.

Entra invia così tutti i tuoi utenti e gruppi. Non devi scegliere nulla prima: i gruppi finiscono in **Gruppi Entra non collegati** e non cambiano nulla finché non li colleghi. Per farlo continua con [Collegare i gruppi in Tillor](#groepen-koppelen-in-tillor). I membri dei gruppi arrivano con la prima sincronizzazione. Richiede qualche minuto, per le grandi organizzazioni qualche ora.

<Callout type="info">
Tillor usa l'accesso solo per questa configurazione. Va cifrato all'attività in background e poi non viene conservato da nessuna parte; Microsoft lo fa scadere da sé dopo circa un'ora. Se ripeti **Configura con Microsoft**, Tillor ritrova la stessa app e non ne crea una seconda.
</Callout>

<Callout type="warn">
La configurazione rapida crea un nuovo token. Un token che avevi incollato a mano in Entra in precedenza non funziona più. Se la configurazione si ferma a metà, fai clic su **Riprova**.
</Callout>

Se l'accesso non riesce, per esempio perché la tua organizzazione blocca il consenso alle app, o se vuoi che Entra invii solo alcuni gruppi, imposta il collegamento a mano come descritto qui sotto.

## Configurazione manuale [#handmatig-instellen]

<Steps>
<Step>

### Creare il token in Tillor [#token-maken-in-tillor]

1. Vai a **Assistenza > Impostazioni** e scegli **Gruppi**
2. In alto c'è **Microsoft Entra**. Se il collegamento è già configurato, fai clic su **Connessione**
3. Copia l'**URL del tenant**. Ha un aspetto come `https://…/api/orgs/<organisatie>/scim/v2`
4. Fai clic su **Genera token** e copia il token che compare

<Callout type="warn">
Il token viene mostrato una sola volta. Incollalo subito in Entra. Se lo perdi, fai clic su **Sostituisci token** e usa il nuovo token.
</Callout>

</Step>
<Step>

### Creare un'app in Entra [#een-app-maken-in-entra]

1. Apri il [centro di amministrazione Microsoft Entra](https://entra.microsoft.com)
2. Vai a **Identity > Applications > Enterprise applications** e fai clic su **New application**
3. Fai clic su **Create your own application**
4. Dai un nome all'app, per esempio **Tillor**, scegli **Integrate any other application you don't find in the gallery (Non-gallery)** e fai clic su **Create**

Se hai già un'enterprise application per Tillor, puoi usare anche quella.

</Step>
<Step>

### Collegare il provisioning [#provisioning-koppelen]

1. Nell'app apri **Provisioning** e fai clic su **Get started** (o **New configuration**)
2. Imposta **Provisioning Mode** su **Automatic**
3. In **Admin Credentials** inserisci:
   - **Tenant URL**: l'URL del tenant di Tillor
   - **Secret Token**: il token di Tillor
4. Fai clic su **Test Connection**. Entra deve segnalare che la connessione è riuscita
5. Fai clic su **Save**

</Step>
<Step>

### Controllare gli attributi [#attributen-controleren]

In **Mappings** apri la regola **Provision Microsoft Entra ID Users**:

- Imposta **externalId** su **objectId** (di default c'è **mailNickname**). Così Tillor riconosce una persona dal suo account Microsoft, anche se l'indirizzo e-mail è diverso
- Lascia **userName** (← **userPrincipalName**), **active** e **emails[type eq "work"].value** (← **mail**) come sono

Lascia attivo **Provision Microsoft Entra ID Groups**. Le impostazioni predefinite (**displayName**, **externalId** ← **objectId**, **members**) vanno bene.

Se in Tillor vuoi vedere che tipo di gruppo è, aggiungi ai gruppi questi attributi. In **Show advanced options** scegli prima **Edit attribute list for customappsso** e aggiungi gli attributi di destinazione, poi per ogni riga **Add New Mapping**:

| Origine in Entra | Attributo di destinazione | Tipo |
|---|---|---|
| Espressione `Join(",", [groupTypes])` | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:groupTypes` | String |
| **securityEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:securityEnabled` | Boolean |
| **mailEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:mailEnabled` | Boolean |
| **onPremisesSyncEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:onPremisesSyncEnabled` | Boolean |
| **mail** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:mail` | String |
| **description** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:description` | String |

Se un'origine manca nell'elenco di Entra, salta quella riga. Se a un gruppo è collegato un Team, Entra non può inviarlo così; Tillor lo vede solo tramite **Configura con Microsoft**.

Puoi lasciare stare gli altri attributi. Tillor non li conserva.

</Step>
<Step>

### Assegnare i gruppi [#groepen-toewijzen]

1. Nell'app apri **Users and groups** e fai clic su **Add user/group**
2. Scegli i gruppi che Tillor deve ricevere, per esempio **Reception**, e fai clic su **Assign**
3. In **Provisioning > Settings** controlla che **Scope** sia su **Sync only assigned users and groups**

Entra invia un gruppo insieme ai suoi membri. Non devi assegnare i membri a parte.

</Step>
<Step>

### Avviare il provisioning [#provisioning-starten]

In **Provisioning** imposta **Provisioning Status** su **On** e fai clic su **Save**.

Il primo giro può richiedere un po' di tempo, a seconda del numero di utenti. Poi Entra invia le modifiche circa ogni 40 minuti. Se vuoi aggiornare subito una persona, usa **Provision on demand** in Entra.

</Step>
<Step>

### Collegare i gruppi in Tillor [#groepen-koppelen-in-tillor]

Aggiorna **Impostazioni > Gruppi**. In alto c'è la riga **Microsoft Entra** con l'ultima sincronizzazione e quanti gruppi sono collegati. Sotto i tuoi gruppi Tillor c'è **Gruppi Entra non collegati** con i gruppi inviati che ancora non fanno nulla. Fai clic su **Mostra** se l'elenco è chiuso e usa il campo di ricerca per trovare un gruppo. Per ogni gruppo scegli in **Collega a…** che cosa deve succedere e poi fai clic su **Salva**. Con **Annulla modifiche** scarti le tue scelte. Un gruppo Tillor può essere collegato a un solo gruppo Entra; i gruppi già collegati non puoi sceglierli di nuovo.

| Scelta | Che cosa succede |
|---|---|
| **Crea nuovo** | Tillor crea un gruppo con il nome di Entra e lo riempie con i membri riconosciuti |
| Un gruppo esistente | I membri di quel gruppo vengono sostituiti dai membri riconosciuti di Entra. Se Entra non ha ancora inviato i membri di quel gruppo, restano i membri attuali finché la sincronizzazione non li fornisce |

Da ora Entra aggiorna i membri a ogni sincronizzazione. Il gruppo collegato sparisce dall'elenco e tra i tuoi gruppi Tillor compare sotto il gruppo **Entra · [nome]** con il tipo di gruppo.

Il collegamento si fa solo da **Gruppi Entra non collegati**. Un gruppo Tillor che gestisci a mano, come IT, non lo colleghi dal gruppo stesso.

Dopo ogni nome di gruppo compare che tipo di gruppo è in Entra. Con i pulsanti sopra l'elenco mostri un solo tipo.

| Etichetta | Che cos'è |
|---|---|
| **Sicurezza** | Un normale gruppo di sicurezza, spesso il gruppo che vuoi collegare |
| **Sicurezza abilitata alla posta** | Un gruppo di sicurezza con un proprio indirizzo e-mail |
| **Lista di distribuzione** | Solo una lista e-mail |
| **Microsoft 365** | Un gruppo con una casella condivisa e un sito SharePoint, a volte con un Team |
| **Windows Server AD** | Viene dal tuo Active Directory locale (ibrido) e viene gestito lì |
| **Dinamico** | Entra decide da sé i membri con una regola |
| **Teams** | Al gruppo è collegato un Team |
| **Tipo sconosciuto** | Tillor non conosce ancora il tipo. Esegui di nuovo **Configura con Microsoft** |

I gruppi del sito SharePoint, come **Proprietari**, **Membri** e **Visitatori** di un sito, non sono gruppi Entra. Non arrivano mai in Tillor. Quello che vedi è il gruppo Microsoft 365 dietro il sito.

</Step>
</Steps>

## Come Tillor riconosce le persone [#hoe-tillor-mensen-herkent]

Per ogni utente che Entra invia, Tillor cerca un membro esistente della tua organizzazione:

1. Prima in base all'**account Microsoft** con cui quella persona accede a Tillor (l'ID oggetto Entra, se imposti **externalId** su **objectId**)
2. Altrimenti in base all'**indirizzo e-mail**: l'indirizzo di lavoro di Entra, o lo **userPrincipalName** se è un indirizzo e-mail

Se Tillor non trova nessuno, o se l'utente è disattivato in Entra, non conta nel gruppo. Non appena la persona diventa membro dell'organizzazione, conta subito. Se in Entra lo riattivi, conta dalla sincronizzazione successiva.

## Che cosa succede alle modifiche in Entra [#wat-er-gebeurt-bij-wijzigingen-in-entra]

| In Entra | In Tillor |
|---|---|
| Membro aggiunto a un gruppo collegato | Entra nel gruppo Tillor (se è membro dell'organizzazione) |
| Membro tolto dal gruppo | Esce dal gruppo Tillor |
| Utente disattivato (**Account enabled** disattivato) | Esce da tutti i gruppi Tillor collegati. Il suo account Tillor resta |
| Utente o gruppo non più assegnato all'app | Entra invia una disattivazione o una rimozione, con lo stesso effetto |
| Gruppo eliminato | Sotto il gruppo Tillor compare **Rimosso in Entra. I membri sono stati conservati.** Il gruppo Tillor resta con i suoi ultimi membri e non viene più aggiornato |

Togliere qualcuno del tutto dalla tua organizzazione si fa in Tillor, in [Organizzazione](/gebruikers/organisaties). Entra gestisce solo i membri dei gruppi.

## Che cosa ritrovi nel registro attività [#wat-je-terugziet-in-het-activiteitenlog]

Nel [registro attività](/activiteitenlog) vedi:

- Ogni modifica ai membri di un gruppo Tillor che Entra applica, con chi è entrato o uscito. Compare a nome del sistema, non di un utente
- Ogni giro di sincronizzazione di Entra, una riga per giro. Un giro in cui Entra non invia nulla non lo vedi
- Chi ha collegato o scollegato un gruppo Entra a un gruppo Tillor, e chi ha sostituito il token

## Modificare o interrompere il collegamento [#koppeling-wijzigen-of-stoppen]

- **Scollegare**: accanto al gruppo Tillor fai clic su **Scollega**. Il gruppo Tillor resta com'è e lo gestisci di nuovo a mano. Il gruppo Entra torna in **Gruppi Entra non collegati**
- **Un altro gruppo Tillor**: scollega e poi collega il gruppo Entra a un altro gruppo in **Gruppi Entra non collegati**. Il gruppo precedente mantiene i suoi membri, ma non viene più aggiornato
- **Interrompere del tutto**: in Entra imposta **Provisioning Status** su **Off**, oppure elimina l'enterprise application

## Sostituire il token [#token-vervangen]

Nella riga **Microsoft Entra** fai clic su **Connessione** e poi su **Sostituisci token** se il token è stato divulgato o se te ne serve uno nuovo. Il vecchio token smette subito di funzionare. Incolla il nuovo token in Entra in **Provisioning > Admin Credentials > Secret Token** e fai clic su **Save**. Finché non lo fai, la sincronizzazione in Entra fallisce.

## Risolvere i problemi [#problemen-oplossen]

**Configura con Microsoft si ferma a un passaggio**

Al passaggio compare il messaggio di Microsoft. Di solito al tuo account manca il ruolo di amministratore o il consenso. Controlla i ruoli in [Prima di iniziare](#voordat-je-begint) e fai clic su **Riprova**. Tillor riutilizza l'app e il provisioning già creati.

**Test Connection non riesce**

Controlla che l'URL del tenant sia stato copiato per intero, incluso `/scim/v2`, e che il token sia l'ultimo generato. Dopo **Sostituisci token** un vecchio token non funziona più.

**Un gruppo non compare nell'elenco**

Aspetta che la prima sincronizzazione sia terminata e aggiorna la pagina. Se hai impostato il collegamento a mano, Entra invia solo i gruppi assegnati all'app: controlla **Users and groups** nell'app e attendi il giro successivo, oppure usa **Provision on demand**.

**Manca qualcuno nel gruppo Tillor**

- Quella persona è membro della tua organizzazione Tillor? Entra non crea account
- L'indirizzo e-mail in Entra corrisponde a quello in Tillor? Altrimenti imposta **externalId** su **objectId**, così Tillor la riconosce dal suo account Microsoft. Funziona solo se ha già effettuato l'accesso a Tillor con Microsoft
- L'utente è attivo in Entra?
- È membro diretto del gruppo, e non tramite un gruppo annidato?

**La mia modifica manuale sparisce**

In un gruppo collegato la fonte è Entra. Modifica i membri in Entra, oppure scollega il gruppo.

**Più dettagli su un giro non riuscito**

In Entra apri **Provisioning > Provisioning logs**. Lì vedi per ogni utente e gruppo che cosa ha provato Entra e quale risposta ha dato Tillor.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gruppi" href="/gebruikers/groepen" description="Creare e usare i gruppi" />
  <Card title="Viste" href="/taken/weergaven" description="Condividere una vista delle attività con un gruppo" />
  <Card title="Accedere" href="/inloggen" description="Accedere con Microsoft" />
</Cards>


# Organizzazione (/it-IT/gebruikers/organisaties)

Nella pagina **Impostazioni** (in fondo al menu principale, <UIPath>Assistenza > Impostazioni</UIPath>) gestisci le impostazioni della tua organizzazione. A sinistra passi da una sezione all'altra. Le sezioni che vedi dipendono dai tuoi permessi.

| Sezione | A che cosa serve |
|---|---|
| **Generale** | Profilo dell'organizzazione, fuso orario, paese predefinito e colori dello stile aziendale. Vedi [Generale](#algemeen) |
| **Orari di apertura** | Orario settimanale, stagioni, eccezioni e festività. Vedi [Orari di apertura](#openingsuren) |
| **Fatturazione** | PDF, scadenza e aliquote IVA. Vedi [Impostazioni di fatturazione](/gebruikers/instellingen-facturatie) |
| **Stampa** | Stampanti e momenti di stampa. Vedi [Stampa](#afdrukken) |
| **Pagamenti** | Metodo di pagamento Altro e indirizzo mittente. Vedi [Impostazioni dei pagamenti](/gebruikers/instellingen-betalingen) |
| **Periodi di affitto** | Frequenze di locazione per le occupazioni. Vedi [Impostare i periodi di locazione](/gebruikers/instellingen-huurperiodes) |
| **Tariffa piazzola** | La formula della tariffa calcolata. Vedi [Formula della tariffa](/terreinen#tariefformule) |
| **Controllo accessi** | Uscire con una targa scaduta. Vedi [Impostazioni del controllo accessi](/gebruikers/instellingen-toegangscontrole) |
| **Mappa** | Centro e orientamento della mappa. Vedi [Impostare la mappa predefinita](/kaart#kaartstandaard-instellen) |
| **Tipi di terreno** | Tipi per i terreni. Vedi [Tipi di terreno](/terreinen#terreintypes) |
| **Etichette attività** | Etichette per le attività. Vedi [Etichette](/taken/labels) |
| **Gruppi** | Raggruppare i colleghi. Vedi [Gruppi](/gebruikers/groepen) |
| **Campi personalizzati** | Campi extra su clienti, piazzole e altro. Vedi [Campi personalizzati](/eigen-velden) |
| **Apple Wallet** | Sfondo del pass e punto di accesso. Vedi [Apple Wallet](#apple-wallet) |
| **Tablet e chioschi** | Tablet e chioschi. Vedi [Tablet e chioschi](/mobiele-app/tablets-en-kiosken) |
| **Integrazioni** | Collegamenti con altri servizi. Vedi [Integrazioni](#integraties) |
| **Utenti** | Membri, inviti e permessi. Vedi [Gestire i permessi utente](#gebruikersrechten-beheren) |

<Callout type="info" title="Da sapere">
- Le sezioni che vedi dipendono dai tuoi permessi. Le modifiche le salvi in fondo con **Salva impostazioni**
- Circa una settimana prima di una festività legale, Tillor scrive all'indirizzo di supporto se gli orari di apertura di quel giorno sono ancora vuoti
- Dopo aver salvato le impostazioni del wallet, Tillor aggiorna di nuovo tutti i pass wallet attivi. I visitatori di solito lo vedono dopo aver aperto il pass
- Quando la tua organizzazione ha fatture o pagamenti, la valuta non può più cambiare
</Callout>

<Callout type="info">
I dati aziendali sulle fatture (nome, indirizzo, partita IVA, IBAN, logo) vengono impostati durante l'onboarding. Contatta il supporto Tillor se vuoi modificarli.
</Callout>

## Integrazioni [#integraties]

Scegli **Integrazioni** per vedere i collegamenti disponibili, come la telefonia Voys, i conti bancari, Mollie o il software di contabilità (per es. Admisol). In **Integrazioni** nel menu a sinistra trovi le categorie (comunicazione, pagamenti, contabilità, contatori). Fai clic su un'integrazione nell'elenco per aprire la pagina di dettaglio. Lì installi il collegamento o ne modifichi le impostazioni (senza una finestra di dialogo separata). Vedi anche la [panoramica delle integrazioni](/integraties).

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Impostazioni - panoramica delle integrazioni" />

## Generale [#algemeen]

In **Generale** imposti il profilo dell'organizzazione, il fuso orario, il paese predefinito e i colori dello stile aziendale. Per salvare le modifiche ti serve il permesso **Modifica impostazioni**.

## Orari di apertura [#openingsuren]

In **Orari di apertura** modifichi un unico orario settimanale. Con le opzioni colorate passi ai **periodi stagionali** (per esempio dal 1° luglio al 31 agosto) o a un'**eccezione** (una singola data o un periodo come il 24-26 dicembre). Le **festività legali** dei prossimi 12 mesi ci sono già: scegli una festività e inserisci gli orari (o lasciali vuoti se quel giorno sei chiuso). Lascia vuoto un giorno della settimana se quel giorno sei chiuso. L'AI dell'inbox usa questi orari come orari di apertura dell'ufficio. Circa una settimana prima di una festività legale, Tillor invia un'e-mail di promemoria all'**indirizzo di supporto** dell'organizzazione (o all'indirizzo e-mail generale se non c'è un indirizzo di supporto) quando gli orari per quella festività non sono ancora compilati. Se usi Partoo, gli orari di apertura vengono sincronizzati automaticamente. Vedi [Partoo](/integraties/partoo). Un sito web può recuperare gli orari risolti (comprese le etichette stagionali come Estate o Inverno) e le prossime festività tramite l'[API degli orari di apertura](/ontwikkelaars/voorbeelden/opening-hours).

## Stampa [#afdrukken]

In **Stampa** imposti le stampe PDF, gli indirizzi IP delle stampanti e la **pianificazione dei momenti di stampa**. Aggiungi per ogni giorno della settimana uno o più orari (o lascia vuoto il giorno). I pagamenti online, con mandato e con bonifico attendono il momento successivo di quel giorno prima che la fattura vada nella coda della stampante.

## Apple Wallet [#apple-wallet]

In **Apple Wallet** imposti due cose affiancate: a sinistra lo **sfondo del pass**, a destra la **posizione del punto di accesso**.

**Sfondo del pass** (a sinistra): foto opzionale a tutto schermo per il layout Poster Generic su iPhone con **iOS 27**. Carica JPEG, PNG o WebP; i file grandi vengono ridotti automaticamente. Trascina sull'anteprima per scegliere quale parte della foto resta visibile dietro il codice QR. L'anteprima mostra subito la tua scelta; solo dopo **Salva** in fondo a **Impostazioni** la foto (o la sua rimozione) va in linea e Tillor invia il punto focale ai pass di accesso.

Su iPhone con **iOS 26 o precedente** il pass usa il layout generic classico con gli stessi dati (stato, nome del visitatore, validità, codice QR). Senza un'immagine propria tutti i pass ricevono lo sfondo sfumato standard di Tillor. Con una foto propria in alto compare il **logo dell'organizzazione** dai tuoi dati aziendali, a colori sulla foto. Con lo sfumato standard il logo è bianco sullo sfumato scuro.

Sui pass Poster Generic (iOS 27) il codice QR è **quadrato**; sui dispositivi più vecchi è rettangolare, come in un pass generic classico.

**Posizione del punto di accesso** (a destra): fai clic sulla mappa o trascina il segnalino per impostare il punto GPS del punto di accesso principale. **Apple Wallet** e **Google Wallet** usano quella posizione sul pass di accesso. Su iPhone, iOS può proporre il pass sulla schermata di blocco quando un visitatore è nelle vicinanze. Scegli **Usa centro mappa parco** per rimuovere il segnalino e usare il centro della mappa del parco.

Dopo aver salvato le **Impostazioni**, Tillor aggiorna tutti i pass wallet attivi dell'organizzazione (Apple tramite push silenziosa, Google tramite sincronizzazione dell'oggetto). Gli ospiti di solito vedono l'aggiornamento dopo aver aperto il pass in Wallet; a volte serve ancora un aggiornamento manuale nell'app Wallet. L'anteprima in Tillor mostra lo stesso ritaglio del pass: trascina l'immagine in modo che il centro sia nel punto desiderato.

<DocScreenshot src="/screenshots/gebruikers/settings-wallet-barrier-map.png" alt="Impostazioni > Apple Wallet con sfondo del pass e punto di accesso sulla mappa" />

Sul retro del pass wallet ci sono il numero di telefono e l'indirizzo e-mail dell'organizzazione (l'e-mail di supporto se è impostata, altrimenti l'indirizzo generale). Per i pass bloccati, scaduti o revocati questi dati compaiono anche dietro il testo della reception sulla schermata di blocco (Apple) o in Google Wallet.

<DocScreenshot src="/screenshots/gebruikers/settings-dialog.png" alt="Impostazioni > Generale" />

## Gestire i permessi utente [#gebruikersrechten-beheren]

In **Utenti** vedi i **Membri** della tua organizzazione e gli **Inviti in sospeso**. Come invitare e rimuovere colleghi e impostare le loro notifiche lo trovi in [Invitare utenti e assegnare permessi](/gebruikers/gebruikers-en-rechten).

### Modificare i permessi [#rechten-bewerken]

Accanto a un utente fai clic su **Modifica permessi utente**. Tutta la spiegazione, anche su gruppi e permessi bloccati, è in [Modificare i permessi](/gebruikers/gebruikers-en-rechten#rechten-bewerken). Qui sotto trovi i permessi che spesso sollevano domande.

### Conti bancari [#bankrekeningen]

| Permesso | Che cosa può fare l'utente? |
|---|---|
| **Visualizza transazioni bancarie** | Pagina **Amministrazione > Transazioni bancarie** e il blocco **Transazioni conto bancario** in **Amministrazione > Report dei pagamenti** |
| **Sincronizza transazioni bancarie** | Pulsante **Sincronizza conto bancario** (importazione manuale) |

I permessi sono nella finestra dei permessi sotto il gruppo **Transazioni bancarie**.

Vedi anche [Conti bancari](/boekhouden/betalingsrapporten/betaalmethodes/ponto) per il collegamento con l'open banking.

### Assegnare un pagamento [#betaling-koppelen]

| Permesso | Che cosa può fare l'utente? |
|---|---|
| **Assegna pagamento** | **Assegna pagamento** su una fattura contabilizzata, **Assegna** nei gruppi di pagamenti e **Assegna a fattura** nelle transazioni bancarie (non visibile senza permesso) |

Il permesso è nella finestra dei permessi sotto il gruppo **Pagamenti**.

### App OAuth [#oauth-apps]

| Permesso | Che cosa può fare l'utente? |
|---|---|
| **Autorizzare app OAuth** | Dare il consenso a terzi (per es. Cursor, Claude, ChatGPT) tramite OAuth e continuare a usare i token OAuth esistenti |

Gli utenti esistenti mantengono il permesso dopo la migrazione. I nuovi utenti non lo ricevono automaticamente. Attivalo nella finestra dei permessi dell'utente. Disattivalo per impedire a quell'utente di collegare nuove app OAuth; anche i token esistenti di quell'utente smettono allora di funzionare. Gli utenti con questo permesso in almeno un'organizzazione possono autorizzare.

Vedi anche [MCP](/ontwikkelaars/mcp).

## Accordo sul trattamento dei dati [#verwerkersovereenkomst]

Se al posto di Tillor compare una schermata **Accordo sul trattamento dei dati richiesto**, la tua organizzazione deve firmare l'attuale accordo sul trattamento dei dati (DPA) prima di poter proseguire. Puoi prima scaricare il documento con **Scarica documento DPA**. Poi richiedi un codice di verifica. Arriva via SMS al numero di telefono del responsabile. Inserisci il codice e fai clic su **Accetta DPA**.

## Dati sulle fatture [#gegevens-op-facturen]

I dati aziendali come nome, indirizzo, partita IVA e IBAN compaiono automaticamente sulle fatture. Vengono impostati durante l'onboarding. Contatta il supporto Tillor per modificarli.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Utenti" href="/gebruikers" description="Gestire l'accesso degli account" />
  <Card title="Gruppi" href="/gebruikers/groepen" description="Raggruppare i colleghi, anche con autorizzazioni del gruppo" />
  <Card title="Fatture" href="/facturen" description="Creare e inviare fatture" />
</Cards>


# Prova e validità (/it-IT/handtekeningen/bewijs-en-geldigheid)

Per ogni firma Tillor registra chi ha firmato, quando e come, e chiude il PDF in modo che una modifica successiva sia visibile. Il risultato è una firma elettronica semplice, adatta a contratti di locazione, regolamenti interni, liberatorie e condizioni. Per i documenti per cui la legge richiede una firma più forte, Tillor non è lo strumento giusto.

## Cosa c'è sulle pagine di prova? [#wat-staat-er-op-de-bewijspaginas]

Il PDF firmato riceve in fondo una o più pagine **Prova di firma**. Contengono:

- il titolo del documento, la richiesta, la tua organizzazione, il numero di pagine e quando la richiesta è stata creata, inviata e completata
- due impronte del file: quella del PDF così come lo hai caricato e quella delle pagine firmate prima dell'aggiunta delle pagine di prova. Se cambia anche un solo carattere nel file, l'impronta non corrisponde più
- per ogni firmatario: nome, ruolo, tipo, indirizzo e-mail, numero di telefono e lingua, quando è partito il link e quando quella persona ha aperto la pagina per la prima volta, l'ora della firma, l'indirizzo IP e il dispositivo
- come è stato confermato il firmatario: con un codice monouso, su quale canale è stato inviato il codice e quando, oppure accesso effettuato in Tillor per i collaboratori
- la frase con cui il firmatario ha dato il suo consenso, esattamente come appariva sullo schermo
- ciò che il firmatario ha compilato: ogni campo di testo, data e casella di spunta con il suo valore, anche quelli rimasti vuoti
- la firma e la sigla così come sono state tracciate, e in quali pagine compaiono. Una firma digitata appare come immagine del nome digitato, proprio come una firma tracciata
- come è stato firmato: sulla pagina di firma tramite il link, in Tillor da un collaboratore con accesso effettuato, oppure sul tablet alla reception (con codice, oppure con l'identità confermata da un collaboratore)
- il **registro di controllo**: ogni passaggio con ora, chi lo ha fatto e da quale indirizzo IP e dispositivo. Ad esempio *Link di firma inviato*, *Pagina di firma aperta*, *Codice di verifica inviato*, *Codice errato inserito*, *Firmato* e *Completato e sigillato*

Gli orari sono nel fuso orario della tua organizzazione, con accanto l'ora UTC (l'ora standard mondiale). Tillor conserva gli indirizzi IP e i dispositivi in forma cifrata. Li vedi in Tillor e sulle pagine di prova. Le firme e i valori compilati compaiono nel documento nei punti che hai scelto tu. Il tuo caricamento originale resta conservato a parte e non cambia mai.

Gli stessi passaggi li vedi anche nella pagina della richiesta sotto **Cronologia** e nella scheda del cliente sotto **Eventi**.

<Callout type="info" title="Per il lettore tecnico">
Le due impronte sono valori di controllo SHA-256. Un'impronta SHA-256 cambia completamente non appena cambia anche un solo byte di un file, per questo dimostra che il file non è stato modificato. Sulla pagina di prova compare anche l'impronta del certificato di sigillo (vedi sotto).
</Callout>

## Sigillo e marca temporale [#zegel-en-tijdstempel]

Come ultimo passaggio il PDF firmato viene **sigillato** con una firma digitale della tua organizzazione, creata da Tillor. Se lo apri in Adobe Reader o in un altro lettore PDF, vedi un pannello delle firme. Se dopo la sigillatura il file viene modificato, il lettore lo segnala.

Il lettore può indicare il firmatario come **sconosciuto** o **non attendibile**. È normale: il certificato proviene da Tillor e non da un'autorità di certificazione a pagamento. Quale certificato è, è indicato con la sua impronta sulla pagina di prova.

Il sigillo riceve anche una **marca temporale** da un servizio di marcatura temporale indipendente e gratuito (FreeTSA, oppure DigiCert se non risponde). Questo dimostra, indipendentemente da Tillor, quando il file esisteva in questa esatta forma. L'ora è indicata nella pagina della richiesta sotto **Marca temporale**.

## Che tipo di firma è [#welk-soort-handtekening]

È una **firma elettronica semplice** secondo le regole europee eIDAS. Tillor verifica l'indirizzo e-mail o il numero di telefono con un codice, registra il tratto della firma e conserva la prova. È adatta a contratti di locazione, regolamenti interni, liberatorie e condizioni.

Una firma **qualificata**, ad esempio con itsme o una carta eID, non è possibile. Se hai un documento per cui la legge la richiede, fallo firmare al di fuori di Tillor.

## Cosa succede alla prova? [#wat-gebeurt-er-met-het-bewijs]

- Il PDF originale e il PDF firmato restano tra i documenti del cliente. Puoi archiviarli ma non eliminarli.
- La prova fa parte del PDF firmato. Chi ha ricevuto una copia ha quindi anche le pagine di prova.
- Il registro di controllo resta nella pagina della richiesta, anche se la richiesta è stata rifiutata, annullata o è scaduta.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il mio lettore PDF dice che la firma non è attendibile">
È corretto e normale. Il sigillo proviene da Tillor, non da un'autorità di certificazione a pagamento. L'importante è che il lettore non segnali modifiche dopo la sigillatura. Il certificato è indicato con la sua impronta sulla pagina di prova.
</Accordion>
<Accordion title="Il mio lettore PDF segnala che il documento è stato modificato dopo la firma">
Il file è stato modificato dopo la sigillatura, ad esempio salvandolo di nuovo o modificandolo. Scarica di nuovo il PDF firmato dalla pagina di dettaglio della richiesta o dai documenti del cliente. Quel file è inalterato.
</Accordion>
<Accordion title="Un cliente vuole una firma qualificata con itsme o eID">
Non è possibile in Tillor. Fai firmare quel documento al di fuori di Tillor.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Come firma una persona" href="/handtekeningen/ondertekenen" />
  <Card title="Seguire una richiesta" href="/handtekeningen/opvolgen" />
  <Card title="Tutti i termini" href="/begrippen" />
</Cards>


# Richiedere firme (/it-IT/handtekeningen/handtekening-vragen)

Con una richiesta di firma fai firmare online un PDF a una o più persone. La crei in due parti: prima scegli il cliente e il PDF, poi nell'editor imposti i firmatari e i campi. Come seguire in seguito chi ha firmato è spiegato in [Seguire una richiesta](/handtekeningen/opvolgen).

<Requires permission="Gestire le richieste di firma" />

Prima di iniziare:

- Ti serve il permesso **Gestire le richieste di firma**. Se non lo hai, il pulsante **Richiedi firme** è grigio.
- Il file deve essere un PDF, fino a 250 MB. Tillor rifiuta un altro tipo di file con **Questo non è un PDF. Scelga un file PDF.**
- Ogni firmatario ha bisogno di un indirizzo e-mail o di un numero di telefono per ricevere il link o il codice. Per un cliente o un contatto, inseriscilo prima nei suoi dati.
- Ogni firmatario ha bisogno di almeno un campo firma o sigla.

## Creare una richiesta di firma [#een-ondertekenverzoek-maken]

<Steps>
<Step>
### Avvia la richiesta [#start-het-verzoek]
Scegli da dove iniziare.

<Tabs items={["Da Firme", "Dal cliente"]}>
<Tab value="Da Firme">
Vai a <UIPath>Amministrazione > Firme</UIPath> e clicca su **Richiedi firme**. Scegli il **Cliente**.
</Tab>
<Tab value="Dal cliente">
Apri la scheda **Documenti** del cliente e clicca su **Richiedi firme**. Il cliente è già compilato.
</Tab>
</Tabs>

In **Documento** scegli un PDF già presente per quel cliente, oppure lascia **Carica un nuovo PDF** e trascina il PDF nel riquadro (o clicca su **Scegli PDF**). Inserisci un **Titolo**, ad esempio *Contratto di locazione 2027*. Se lo lasci vuoto, Tillor usa il nome del documento. Poi clicca su **Continua**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-create-dialog.png" alt="Finestra Richiedi firme con cliente, titolo e documento" />

Un PDF caricato finisce tra i documenti del cliente. Tillor non lo modifica mai: le firme vanno in una copia separata.
</Step>
<Step>
### Aggiungi i firmatari [#voeg-ondertekenaars-toe]
In **Firmatari** clicca su **Aggiungi firmatario** e scegli:

- **Cliente: [nome]**
- **Contatto del cliente**
- **Collaboratore**
- **Parte esterna**: compila **Nome**, **Indirizzo email** e/o **Numero di cellulare** e **Lingua**. Serve almeno uno dei due dati di contatto. Senza indirizzo e-mail la persona riceve il link via SMS.

<DocScreenshot src="/screenshots/handtekeningen/signatures-add-signer-menu.png" alt="Menu Aggiungi firmatario" />

<DocScreenshot src="/screenshots/handtekeningen/signatures-external-dialog.png" alt="Finestra Aggiungi parte esterna" />

Puoi aggiungere al massimo 10 firmatari. Firmano dall'alto verso il basso, e il successivo riceve il link solo quando il precedente ha firmato. Con **Firma prima** e **Firma dopo** (le frecce) cambi l'ordine, con il cestino togli una persona. Nel campo sotto il nome puoi inserire un **Ruolo** facoltativo, ad esempio *Inquilino* o *Garante*.

Ogni firmatario ha un colore proprio. Lo ritrovi nei suoi campi nel documento.
</Step>
<Step>
### Posiziona i campi [#plaats-de-velden]
In **Campi per** scegli il firmatario per cui posizioni i campi. Poi scegli il tipo di campo e tocca o trascina su una pagina del documento. Trascina un campo per spostarlo e trascina l'angolo per ingrandirlo o ridurlo.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor.png" alt="Editor con firmatari, Campi per e i tipi di campo" />

| Campo | Cosa fa il firmatario |
| --- | --- |
| **Firma** | Appone la firma tracciata toccando il riquadro |
| **Sigla** | Appone la sigla tracciata toccando il riquadro |
| **Nome** | Niente: Tillor inserisce il nome del firmatario |
| **Data di firma** | Niente: Tillor inserisce il giorno della firma |
| **Testo** | Digita una riga, fino a 200 caratteri, ad esempio una targa |
| **Testo lungo** | Digita alcune righe, fino a 2.000 caratteri, ad esempio un'osservazione |
| **Casella di spunta** | Spunta una condizione |
| **Data** | Sceglie una data, ad esempio un giorno di arrivo |

Clicca su un campo posizionato per selezionarlo. Sotto i pulsanti vedi allora:

- **Firmatario**: assegna il campo a un altro firmatario, senza ridisegnarlo.
- Per **Testo**, **Testo lungo**, **Casella di spunta** e **Data** anche una **Domanda o etichetta** (il firmatario la vede accanto al campo da compilare) e **Obbligatorio**. Un campo non obbligatorio può restare vuoto.
- La croce sul campo lo elimina.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor-fields.png" alt="Ultima pagina con i campi dell'inquilino, del co-inquilino e del locatore, ciascuno nel proprio colore" />

Se qualcuno ha bisogno di una sigla su ogni pagina, usa **Sigla su ogni pagina**. Tillor mette allora un campo sigla su tutte le pagine per quel firmatario. Finché un firmatario non ha un campo firma o sigla, vedi **Ancora nessun campo firma** accanto a quella persona.
</Step>
<Step>
### Imposta messaggio e scadenza [#stel-bericht-en-termijn-in]
In **Richiesta** compili:

- **Titolo**: come lo vedono i firmatari.
- **Messaggio ai firmatari**: facoltativo, compare nell'e-mail e nella pagina di firma.
- **Firmare entro il**: la data limite. Di default sono 14 giorni dopo la creazione. Si può firmare fino alla fine di quel giorno.
- **Promemoria dopo**: dopo quanti giorni (da 1 a 14) un firmatario di turno riceve un promemoria. Di default 3 giorni.
</Step>
<Step>
### Invia la richiesta [#verstuur-het-verzoek]
Clicca su **Invia** e conferma. Il primo firmatario riceve il link.

<DocScreenshot src="/screenshots/handtekeningen/signatures-send-dialog.png" alt="Conferma Inviare la richiesta?" />

Se vuoi continuare più tardi, clicca su **Salva bozza**. Con il cestino accanto (**Elimina bozza**) scarti la richiesta, dopo conferma. Il PDF resta tra i documenti del cliente.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- La richiesta riceve lo stato <Status tone="info">In corso</Status>. La trovi nel cliente sotto **Documenti** e in <UIPath>Amministrazione > Firme</UIPath>. Tillor segnala **Inviata al primo firmatario**.
- Il primo firmatario riceve un'e-mail con un link personale, oppure un SMS se c'è solo un numero di telefono. Ogni firmatario successivo riceve il link appena il precedente ha firmato.
- Un firmatario di turno che non risponde riceve automaticamente un promemoria dopo il numero di giorni indicato in **Promemoria dopo**, al massimo 2 volte. Puoi sempre inviare tu un promemoria, vedi [Seguire una richiesta](/handtekeningen/opvolgen#een-herinnering-sturen).
- Quando tutti hanno firmato, la richiesta diventa <Status tone="success">Completata</Status> e il PDF firmato è nella scheda del cliente.
- Se la scadenza passa senza che tutti abbiano firmato, la richiesta diventa <Status tone="warning">Scaduta</Status>.

Se vuoi ancora cambiare qualcosa mentre nessuno ha ancora firmato, o ha firmato solo tu, clicca su **Torna a modificare**. La richiesta torna bozza: i link inviati non funzionano più e tutti firmano di nuovo quando la reinvii. Se ha già firmato qualcun altro, annulla la richiesta e creane una nuova.

Vuoi che un'automazione reagisca a una richiesta completata, ad esempio con un'attività? Usa il trigger **Richiesta di firma completata**, vedi [Trigger](/automatiseringen/triggers).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il pulsante Richiedi firme è grigio">
Ti manca il permesso **Gestire le richieste di firma**. Chiedi a un amministratore di aggiungerlo in <UIPath>Impostazioni > Utenti</UIPath>.
</Accordion>
<Accordion title="Tillor dice: Questo non è un PDF. Scelga un file PDF.">
Hai scelto un altro tipo di file, ad esempio Word. Salva prima il documento come PDF e scegli quel file.
</Accordion>
<Accordion title="Tillor dice: Scegli un cliente, oppure: Carica un PDF o scegli un documento del cliente">
Nella prima schermata **Cliente** o **Documento** è vuoto. Compila entrambi e clicca di nuovo su **Continua**.
</Accordion>
<Accordion title="Non riesco a inviare">
Tillor controlla la richiesta prima dell'invio e dice cosa manca:

- **Aggiungi almeno un firmatario prima di inviare.**
- Un firmatario non ha ancora un campo firma o sigla. Tillor seleziona quella persona. Poi trascina sul documento per posizionare un campo.
- Un firmatario non ha un indirizzo e-mail né un numero di telefono e quindi non può ricevere un link o un codice. Vale anche per un cliente o un contatto: inserisci prima un indirizzo e-mail o un numero di telefono nei suoi dati. Nell'elenco, accanto a quella persona compare **Nessuna e-mail o numero di telefono**.
- **Dai un titolo alla richiesta.**
</Accordion>
<Accordion title="Tillor dice: Impossibile inviare la richiesta">
La richiesta potrebbe non essere partita. Ricarica la pagina. Se la richiesta è ancora <Status>Bozza</Status>, clicca di nuovo su **Invia**.
</Accordion>
<Accordion title="Tillor dice: Impossibile salvare la bozza">
Le tue modifiche non sono state salvate. Ricarica la pagina e controlla cosa c'è ancora prima di proseguire.
</Accordion>
<Accordion title="Il documento non si carica nell'editor">
Ricarica la pagina. Se non funziona, controlla che il file sia un PDF valido.
</Accordion>
<Accordion title="Ho messo un campo alla persona sbagliata">
Clicca sul campo e in **Firmatario** scegli la persona giusta. Il campo resta dov'è.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Seguire una richiesta" href="/handtekeningen/opvolgen" />
  <Card title="Come firma una persona" href="/handtekeningen/ondertekenen" />
  <Card title="Prova e validità" href="/handtekeningen/bewijs-en-geldigheid" />
</Cards>


# Panoramica (/it-IT/handtekeningen)

Con **Firme** fai firmare online un PDF come un contratto di locazione, un regolamento interno, una liberatoria o una garanzia. I firmatari firmano uno dopo l'altro e sei tu a decidere in che punto delle pagine vanno ogni firma, sigla o campo da compilare. Come procedere è spiegato in [Richiedere firme](/handtekeningen/handtekening-vragen).

Quando tutti hanno firmato, Tillor crea un PDF firmato con le pagine di prova in coda. Poi compare nei **Documenti** del cliente e ogni firmatario riceve una copia. Il tuo PDF originale resta conservato senza modifiche.

<Requires permission="Gestire le richieste di firma" />

Preparare, inviare, sollecitare, ritirare e annullare le richieste di firma richiede il permesso **Gestire le richieste di firma**, nel gruppo **Firme** in <UIPath>Impostazioni > Utenti</UIPath>. Se non hai quel permesso, quei pulsanti sono grigi. Tutti gli utenti della tua organizzazione possono vedere le richieste e firmare di persona quando tocca a loro.

<Callout type="info" title="Da sapere">
- Una richiesta ha al massimo 10 firmatari e accetta solo file PDF, fino a 250 MB.
- Di default si può firmare per 14 giorni, fino alla fine dell'ultimo giorno. Puoi scegliere un'altra data.
- Un firmatario di turno riceve di default un promemoria dopo 3 giorni (puoi scegliere da 1 a 14 giorni), con un massimo di 2 promemoria automatici. Partono con il controllo giornaliero di Tillor.
- Per firmare, il firmatario conferma con un codice di 6 cifre. Il codice è valido 10 minuti e dopo 2 minuti se ne può chiedere uno nuovo.
- Il tuo PDF originale non cambia mai. L'originale e il PDF firmato puoi archiviarli ma non eliminarli, perché sono la prova.
- La richiesta passa allo stato Scaduta durante il controllo giornaliero, non nel momento esatto in cui scade il termine.
</Callout>

## Dove si trova [#waar-vind-je-het]

- <UIPath>Amministrazione > Firme</UIPath> mostra tutte le richieste di firma con il loro stato e quante firme ci sono già.
- Nel profilo di un cliente, nella scheda **Documenti**, c'è il pulsante **Richiedi firme**, con sotto le **Richieste di firma** di quel cliente.

<DocScreenshot src="/screenshots/handtekeningen/signatures-list.png" alt="Elenco delle richieste di firma in Amministrazione > Firme" />

## Come si collega tutto? [#hoe-hangt-dit-samen]

Una richiesta di firma appartiene sempre a un cliente e a un PDF. I firmatari non devono essere per forza il cliente: può firmare anche un contatto, un collega o una parte esterna.

```mermaid
flowchart LR
  A[PDF del cliente] --> B[Richiesta di firma con firmatari e campi]
  B --> C[Il firmatario 1 firma]
  C --> D[Il firmatario 2 firma]
  D --> E[PDF firmato con pagine di prova]
  E --> F[Documenti del cliente]
  E --> G[Copia per ogni firmatario]
```

## Come procede una richiesta [#hoe-een-verzoek-verloopt]

```mermaid
flowchart LR
  A[Bozza] -->|Invia| B[In corso]
  B -->|tutti hanno firmato| C[Completata]
  B -->|il firmatario rifiuta| D[Rifiutata]
  B -->|Annulla richiesta| E[Annullata]
  B -->|termine scaduto| F[Scaduta]
  B -->|Torna a modificare| A
```

## Stati [#statussen]

| Stato | Significato |
|---|---|
| <Status>Bozza</Status> | Stai ancora preparando la richiesta. Non è stato ancora inviato nulla. |
| <Status tone="info">In corso</Status> | La richiesta è stata inviata e si sta firmando. |
| <Status tone="success">Completata</Status> | Tutti hanno firmato e il PDF firmato è nella scheda del cliente. |
| <Status tone="error">Rifiutata</Status> | Un firmatario ha rifiutato. La richiesta è stata interrotta. |
| <Status>Annullata</Status> | Tu o un collega avete ritirato la richiesta. |
| <Status tone="warning">Scaduta</Status> | Non si è firmato in tempo. |

Per ogni firmatario vedi **In attesa** (non ancora di turno), **Link inviato** (di turno), **Firmato** o **Rifiutato**.

## Chi può firmare [#wie-kan-ondertekenen]

| Tipo | Come firma quella persona |
|---|---|
| **Cliente** | Tramite un link personale via e-mail, o via SMS se c'è solo un numero di telefono |
| **Contatto** | Come il cliente, per un contatto di quel cliente |
| **Collaboratore** | In Tillor stesso, senza codice |
| **Parte esterna** | Come il cliente, con un nome e un indirizzo e-mail o numero di telefono che inserisci tu |

Un cliente, un contatto o una parte esterna può firmare anche al banco, su un tablet con l'app Tillor. Vedi [Sul tablet alla reception](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Automatizzare [#automatiseren]

Una richiesta di firma può avviare un'[automazione](/automatiseringen/triggers). Con **Richiesta di firma completata** crei ad esempio un'attività non appena un contratto di locazione è firmato, con **Richiesta di firma modificata** reagisci a ogni cambio di stato. Gli stessi eventi puoi inviarli come [webhook](/ontwikkelaars/webhooks) al tuo sistema.

<Cards>
  <Card title="Richiedere firme" href="/handtekeningen/handtekening-vragen" />
  <Card title="Seguire una richiesta" href="/handtekeningen/opvolgen" />
  <Card title="Come firma una persona" href="/handtekeningen/ondertekenen" />
  <Card title="Prova e validità" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Acquisire un cliente stagionale" href="/praktijk/seizoensklant-binnenhalen" description="Facendo firmare il contratto di locazione" />
</Cards>

## Termini [#begrippen]

- **Richiesta di firma**: l'incarico di far firmare un PDF, con firmatari, campi e una scadenza. Vedi [richiesta di firma](/begrippen#ondertekenverzoek).
- **Firmatario**: chi deve firmare. Un cliente, un contatto, un collaboratore o una parte esterna.
- **Campo**: un punto del PDF in cui un firmatario firma, mette una sigla o compila qualcosa.
- **Bozza**: una richiesta che stai ancora preparando. Non è stato ancora inviato nulla.
- **Pagine di prova**: le pagine in coda al PDF firmato che indicano chi ha firmato, quando e come. Vedi [pagina di prova](/begrippen#bewijspagina).
- **Sigillo**: la firma digitale della tua organizzazione con cui si chiude il PDF firmato. Vedi [sigillo](/begrippen#zegel).


# Come firma una persona (/it-IT/handtekeningen/ondertekenen)

Questa pagina mostra cosa vivono i tuoi firmatari, così puoi rispondere alle loro domande, e come far firmare qualcuno al banco sul tablet. Una richiesta la invii tu stesso tramite [Richiedere firme](/handtekeningen/handtekening-vragen).

Prima di iniziare:

- La richiesta deve avere lo stato <Status tone="info">In corso</Status> e il firmatario deve essere di turno. Se non è ancora il turno di qualcuno, compare **Non è ancora il tuo turno**.
- Per il tablet ti serve il permesso **Gestire le richieste di firma** e l'app Tillor deve essere online su un dispositivo della tua organizzazione.
- Il firmatario ha bisogno di un numero di telefono o di un indirizzo e-mail, perché il codice viene inviato lì. Solo un collaboratore firma senza codice.

## Sul tablet alla reception [#op-de-tablet-aan-de-receptie]

Se la persona è davanti a te, non deve aprire lei il link. Vale per un cliente, un contatto o una parte esterna di turno.

<Steps>
<Step>
### Apri la richiesta [#open-het-verzoek]
Vai a <UIPath>Amministrazione > Firme</UIPath> e apri la richiesta, oppure aprila dalla scheda **Documenti** del cliente.
</Step>
<Step>
### Clicca su Firma sul tablet [#klik-op-op-tablet-tekenen]
Sul firmatario di turno clicca su **Firma sul tablet** e scegli come viene confermata l'identità:

- **Con codice**: il firmatario conferma sul tablet con il codice che arriva via SMS o e-mail, come tramite il link.
- **Senza codice**: hai verificato tu l'identità al banco, ad esempio con una carta d'identità. Non viene chiesto alcun codice. Nella pagina di prova risulta che l'identità è stata confermata da un collaboratore, e nella cronologia chi è stato.

Tillor segnala **Aperto sul tablet**.
</Step>
<Step>
### Fai firmare la persona [#laat-de-persoon-tekenen]
Il documento si apre nell'app sul tablet, con in alto, a caratteri grandi, il nome del firmatario. Controlla quel nome insieme alla persona che hai davanti. I passaggi sono gli stessi del link, vedi sotto. Subito dopo l'invio il tablet può mostrare ancora per un momento **Preparazione del documento…**.
</Step>
</Steps>

Dopo la firma o il rifiuto, il tablet torna alla schermata iniziale dopo alcuni secondi. Con più firmatari, mandi ciascuno al tablet separatamente quando è di turno. Nella pagina di prova risulta che la firma è stata apposta sul tablet.

## Cosa fa il firmatario? [#wat-doet-de-ondertekenaar]

<Tabs items={["Tramite il link", "Sul tablet"]}>
<Tab value="Tramite il link">
Il firmatario riceve un'e-mail, o un SMS se c'è solo un numero di telefono. Contiene un link personale alla pagina di firma, con il tuo messaggio e il nome della tua organizzazione. La pagina funziona su telefono, tablet e computer, nella lingua del firmatario.
</Tab>
<Tab value="Sul tablet">
Il firmatario vede subito il documento nell'app, dopo che hai scelto **Firma sul tablet**. Non servono link né e-mail. Chi firma sul tablet con codice riceve il codice sul proprio telefono o nella propria e-mail.
</Tab>
</Tabs>

Poi i passaggi sono gli stessi.

<Steps>
<Step>
### Iniziare [#beginnen]
Nella prima scheda compare chi altro firma, la posizione in coda (ad esempio *Firmatario 2 di 3*) e i passaggi. A destra c'è il documento, con le firme dei firmatari precedenti già al loro posto. Con **Inizia a firmare** il firmatario comincia. Ogni passaggio ha un pulsante per tornare indietro. Funziona anche il tasto indietro del telefono.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-start.png" alt="Pagina di firma per il garante con la scheda iniziale e il documento" />
</Step>
<Step>
### Disegni la sua firma [#teken-je-handtekening]
Il firmatario traccia una **Firma** con il dito o il mouse, oppure sceglie **Digita** e digita il proprio nome completo. Tillor trasforma poi il nome digitato in un carattere corsivo. Se ci sono campi sigla, segue allo stesso modo una **Sigla** (iniziali tracciate o digitate). Con **Cancella** il firmatario ricomincia. Passare da **Disegna** a **Digita** svuota il riquadro.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-type.png" alt="Passaggio Disegni la sua firma con Digita selezionato" />
</Step>
<Step>
### Apponga la sua firma [#plaats-je-handtekening]
Il firmatario tocca ogni riquadro evidenziato nel documento (**Clicca per firmare** o **Clicca per siglare**). **Campo successivo** salta al riquadro vuoto seguente. Con **Riquadro precedente** e **Riquadro successivo** il firmatario scorre tutti i riquadri. Un secondo tocco su un riquadro già compilato non fa nulla.
</Step>
<Step>
### Compili i suoi dati [#vul-je-gegevens-in]
Solo se hai posizionato dei campi da compilare: testo, data o una spunta. Ogni campo indica **obbligatorio** o **facoltativo**. Un campo obbligatorio vuoto blocca il passaggio. Ciò che si digita compare subito nel documento. Nome e data della firma li compila Tillor stesso.
</Step>
<Step>
### Confermi e firmi [#bevestig-en-onderteken]
Il firmatario spunta di aver letto il documento. Se manca ancora qualcosa, compare un elenco con pulsanti che portano a quel passaggio.

Solo quando è tutto pronto, il firmatario si fa inviare un codice di 6 cifre con **Invia codice di verifica**: via SMS se c'è un numero di telefono, altrimenti via e-mail. Il codice è valido 10 minuti. Se non arriva, dopo 2 minuti si può usare **Invia di nuovo il codice**. Poi il firmatario clicca lui stesso su **Firma**. Non si firma mai automaticamente.
</Step>
</Steps>

## Cosa vedi dopo? [#wat-zie-je-daarna]

- Se non è ancora il turno di qualcuno, compare **Non è ancora il tuo turno** e arriva un messaggio non appena è il suo momento.
- Chi ha già firmato vede **Hai firmato** finché gli altri non hanno finito.
- Quando tutti hanno firmato, ogni firmatario può scaricare il PDF firmato tramite lo stesso link (**Firmato da tutti**).
- Con una richiesta ritirata il firmatario vede **Richiesta ritirata**, con una richiesta scaduta **Periodo di firma terminato** e con una richiesta rifiutata **Firma interrotta**.
- Un collaboratore firma in Tillor, con il pulsante **Firma ora** nella pagina di dettaglio o tramite il link nel messaggio. Non serve un codice, perché quella persona ha già effettuato l'accesso. Anche qui la firma può essere tracciata o digitata.

## Rifiutare [#weigeren]

Con **Rifiuta di firmare** un firmatario può respingere la richiesta e, facoltativamente, indicare un motivo (fino a 500 caratteri). La richiesta si interrompe, a nessun altro viene più chiesto di firmare e chi ha creato la richiesta riceve un messaggio. Vedi [Seguire una richiesta](/handtekeningen/opvolgen#wat-gebeurt-er-daarna).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il pulsante Firma sul tablet non c'è">
Il pulsante compare solo se l'app Tillor su un dispositivo della tua organizzazione ha avuto contatto con Tillor negli ultimi minuti, e solo per un cliente, un contatto o una parte esterna di turno. Apri l'app sul tablet, attendi un momento e ricarica la pagina. Controlla anche che **Mostra ricevute e documenti** sia attivo nelle [impostazioni del dispositivo](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid). Vedi anche [Tablet e kiosk](/mobiele-app/tablets-en-kiosken).
</Accordion>
<Accordion title="Tillor dice: Impossibile aprirlo sul tablet">
Tillor non ha trovato nessun tablet che mostri documenti. Controlla che l'app sia aperta e che il dispositivo sia connesso, e riprova.
</Accordion>
<Accordion title="Il firmatario non riceve il codice">
Il codice va al numero di telefono, o all'indirizzo e-mail se non c'è un numero di telefono. Fai controllare al firmatario la cartella dello spam e usare dopo 2 minuti **Invia di nuovo il codice**. Se il numero o l'indirizzo non è corretto, correggilo nella scheda del cliente o del contatto e invia un promemoria. Per una parte esterna annulli la richiesta e ne crei una nuova con i dati giusti.
</Accordion>
<Accordion title="Tillor dice: Impossibile verificare il codice">
Il codice inserito non è corretto o è scaduto. Un codice è valido 10 minuti. Il firmatario ne richiede uno nuovo con **Invia di nuovo il codice** e lo inserisce. Ogni tentativo errato compare nella cronologia come **Codice errato inserito**.
</Accordion>
<Accordion title="Il firmatario non riesce a cliccare su Firma">
Manca ancora qualcosa. Sotto **Da fare prima di poter firmare:** è indicato cosa resta da fare: tracciare la firma o la sigla, toccare ancora un riquadro oppure compilare un campo obbligatorio. Deve essere attiva anche la spunta che il documento è stato letto.
</Accordion>
<Accordion title="Il link non funziona più">
Se la richiesta è stata riportata in bozza, annullata o è scaduta, il vecchio link non funziona più. Dopo un nuovo invio il firmatario riceve un nuovo link. Per una richiesta annullata o scaduta devi creare una nuova richiesta.
</Accordion>
<Accordion title="Il firmatario vede: Questa richiesta è cambiata nel frattempo">
La pagina era già aperta mentre la richiesta cambiava, ad esempio perché è già firmata. La pagina mostra ora lo stato attuale. Non è andato storto nulla.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Seguire una richiesta" href="/handtekeningen/opvolgen" />
  <Card title="Prova e validità" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Tablet e kiosk" href="/mobiele-app/tablets-en-kiosken" />
</Cards>


# Seguire una richiesta (/it-IT/handtekeningen/opvolgen)

Dopo l'invio segui una richiesta di firma nella pagina di dettaglio: chi ha già firmato, chi è di turno e cosa puoi ancora fare. Qui invii anche un promemoria, annulli una richiesta e scarichi il PDF firmato.

Prima di iniziare:

- Vedere è consentito a tutti. Sollecitare, annullare, riportare in bozza e inviare al tablet richiede il permesso **Gestire le richieste di firma**. Senza quel permesso quei pulsanti sono grigi.
- La richiesta deve essere stata inviata. Una <Status>Bozza</Status> si modifica nell'editor, vedi [Richiedere firme](/handtekeningen/handtekening-vragen).

## Aprire la richiesta [#het-verzoek-openen]

Apri <UIPath>Amministrazione > Firme</UIPath>. L'elenco mostra per ogni richiesta il **Titolo**, il **Cliente**, lo **Stato**, quante sono già **Firmato**, quando è stata **Creata** e fino a quando si può firmare (**Firmare entro il**). Cerca per titolo o nome del cliente, oppure filtra con **Stato**, ad esempio solo le richieste ancora in corso. Clicca su una richiesta per aprirla.

Le stesse richieste sono anche nel cliente, nella scheda **Documenti** sotto **Richieste di firma**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-customer-documents.png" alt="Scheda Documenti di un cliente con il PDF firmato e le richieste di firma" />

## La pagina di dettaglio [#de-detailpagina]

A sinistra vedi i dati della richiesta, i firmatari in ordine e la **Cronologia**. A destra c'è il documento, con le firme già apposte. In alto compare chi si sta aspettando, ad esempio *In attesa della firma di Marc Janssens.*

Per ogni firmatario vedi se deve ancora attendere (**In attesa**), se ha ricevuto il link (**Link inviato**), se ha **Firmato** o **Rifiutato**, con l'orario. La pagina si aggiorna da sola quando qualcuno firma.

### Prima e dopo: da In corso a Completata [#voor-en-na-van-bezig-naar-afgerond]

Ecco come appare lo stesso tipo di richiesta durante la firma e dopo. All'inizio è <Status tone="info">In corso</Status>: l'inquilino ha firmato e tocca al garante.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-in-progress.png" alt="Prima: richiesta In corso, l'inquilino ha firmato e tocca al garante" />

Non appena l'ultimo firmatario ha firmato, è <Status tone="success">Completata</Status>. Tutte le firme sono nel documento, la cronologia è completa e in alto c'è il pulsante per scaricare il PDF firmato.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-completed.png" alt="Dopo: richiesta completata con le firme nel documento e la cronologia" />

## Inviare un promemoria [#een-herinnering-sturen]

Su un firmatario di turno clicca su **Invia promemoria**. Quella persona riceve di nuovo lo stesso link e Tillor segnala **Il link è stato inviato di nuovo**. Anche il link del primo messaggio continua a funzionare. Il pulsante non compare per i collaboratori, che firmano in Tillor, né per i firmatari che devono ancora attendere.

Inoltre Tillor invia promemoria da solo. Un firmatario di turno riceve un promemoria dopo il numero di giorni impostato in **Promemoria dopo** (di default 3), contati dal primo messaggio o dal promemoria precedente. Succede al massimo 2 volte per firmatario, durante il controllo giornaliero di Tillor. Un promemoria può quindi arrivare fino a un giorno dopo il numero di giorni che hai impostato.

## Far firmare sul tablet [#laten-tekenen-op-de-tablet]

Se il firmatario è al banco, clicca su **Firma sul tablet** su quella persona. Come funziona e perché a volte il pulsante manca lo trovi in [Sul tablet alla reception](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Firmare di persona come collaboratore [#zelf-ondertekenen-als-medewerker]

Se tocca a un collega o a te, quella persona riceve un messaggio con un link a Tillor. Nella pagina di dettaglio compare allora il pulsante **Firma ora**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-staff-turn.png" alt="Richiesta in cui tocca al collaboratore, con il pulsante Firma ora" />

## Annullare una richiesta [#een-verzoek-annuleren]

Clicca su **Annulla richiesta** e conferma. I link di firma non funzionano più e le firme già apposte non vengono usate. Se vuoi proseguire comunque, clicca su **Mantieni**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-cancel-dialog.png" alt="Conferma Annullare questa richiesta?" />

Si può annullare solo finché la richiesta è <Status tone="info">In corso</Status>. Una richiesta completata, rifiutata o scaduta è definitiva.

## Torna a modificare [#terug-naar-bewerken]

Se nessuno ha ancora firmato, o ha firmato solo tu, nella pagina di dettaglio compare **Torna a modificare**. La richiesta torna bozza, i link inviati non funzionano più e tutti firmano di nuovo dopo l'invio. Se ha già firmato un altro, il pulsante manca. Annulla allora la richiesta e creane una nuova.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- **Qualcuno firma**: il firmatario passa allo stato **Firmato** e il successivo riceve il link. La pagina si aggiorna da sola.
- **Tutti hanno firmato**: vedi brevemente *Tutti hanno firmato. Il PDF firmato è in preparazione.* La richiesta diventa <Status tone="success">Completata</Status>. Il PDF firmato compare come **[titolo] (firmato)** nei **Documenti** del cliente, con lo stesso tipo di documento del PDF originale. Se quello non aveva un tipo, riceve il tipo **Accordo firmato**. Ogni firmatario riceve una copia.
- **Qualcuno rifiuta**: la richiesta si interrompe con lo stato <Status tone="error">Rifiutata</Status>. Chi ha creato la richiesta riceve una notifica e agli altri firmatari non viene più chiesto di firmare. Sul firmatario compare il motivo, se è stato indicato.
- **Annulli tu**: la richiesta riceve lo stato <Status>Annullata</Status> e i link non funzionano più.
- **La scadenza è passata**: dopo il giorno indicato in **Firmare entro il** nessuno può più firmare. Tillor porta la richiesta a <Status tone="warning">Scaduta</Status> durante il controllo giornaliero. Fino a quel controllo vedi nella pagina di dettaglio che il termine è passato. Se vuoi che qualcuno firmi ancora, crea una nuova richiesta.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-declined.png" alt="Richiesta rifiutata con il motivo del cliente" />

## Il PDF firmato [#de-ondertekende-pdf]

Nella pagina di dettaglio scarichi il PDF con **Scarica PDF firmato**, sotto la cronologia. Lì c'è anche la **Marca temporale**, vedi [Prova e validità](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

Via e-mail il PDF è allegato al messaggio al firmatario. Se non è possibile, c'è un pulsante per scaricarlo. Chi ha solo un numero di telefono riceve un SMS con un link.

Il PDF firmato e il PDF originale sono la prova della firma. Per questo non puoi eliminarli, ma solo archiviarli.

## Cronologia ed eventi [#verloop-en-gebeurtenissen]

Sotto **Cronologia** compare ogni passaggio con orario e chi lo ha eseguito: creata, inviata, link inviato, pagina aperta, codice inviato, codice errato, firmata, rifiutata, riportata in bozza, annullata, scaduta e completata. La stessa linea è nel cliente, nella scheda **Eventi**, e nel [registro attività](/activiteitenlog).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo il pulsante Invia promemoria">
Il pulsante compare solo su un firmatario con lo stato **Link inviato**, cioè di turno. Su un collaboratore non compare mai, perché firma in Tillor. Se compare ma è grigio, ti manca il permesso **Gestire le richieste di firma**.
</Accordion>
<Accordion title="Tillor dice: Impossibile inviare il promemoria">
Riprova. Se continua a non funzionare, controlla l'indirizzo e-mail e il numero di telefono del firmatario. Per un cliente o un contatto li correggi nei suoi dati. Per una parte esterna annulli la richiesta e ne crei una nuova con i dati giusti.
</Accordion>
<Accordion title="Il pulsante Torna a modificare manca">
Ha già firmato qualcuno oltre a te. Allora la richiesta non può più tornare bozza. Annulla la richiesta con **Annulla richiesta** e creane una nuova.
</Accordion>
<Accordion title="Tillor dice: Impossibile annullare la richiesta">
Si può annullare solo una richiesta <Status tone="info">In corso</Status>. Ricarica la pagina e guarda qual è lo stato ora. Una richiesta completata, rifiutata o scaduta non si può più annullare.
</Accordion>
<Accordion title="La richiesta è ancora In corso, ma il termine è passato">
Vedi *Il periodo di firma è terminato; la richiesta scade al prossimo controllo giornaliero.* Ora nessuno può più firmare. Dopo l'esecuzione del controllo la richiesta è <Status tone="warning">Scaduta</Status>.
</Accordion>
<Accordion title="Vedo Tutti hanno firmato, ma ancora nessun PDF firmato">
Tillor sta ancora preparando il PDF. Ricarica la pagina dopo qualche minuto. Appena è pronto, è nei documenti del cliente e compare **Scarica PDF firmato**. Se dopo un quarto d'ora non è ancora pronto, Tillor riprova al prossimo controllo giornaliero.
</Accordion>
<Accordion title="Non riesco a eliminare il documento o il PDF firmato">
È voluto. Il PDF originale e il PDF firmato sono la prova. Puoi però archiviarli.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Come firma una persona" href="/handtekeningen/ondertekenen" />
  <Card title="Prova e validità" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Documenti" href="/documenten" />
</Cards>


# Scansioni di documenti d'identità (/it-IT/identiteitsscans)

Con un lettore di documenti scansioni passaporti, carte d'identità, patenti, visti e documenti di soggiorno. Tillor riconosce il tipo di documento, legge i dati e con essi crea rapidamente un cliente, senza che tu debba ridigitare tutto. Il lettore invia la scansione alla tua organizzazione tramite il [connettore Tillor](/connector) sulla tua rete locale. Come creare poi un cliente è spiegato in [Creare un cliente da una scansione](#klant-aanmaken-vanuit-een-scan).

<Callout type="info" title="Da sapere">
- Una scansione senza cliente collegato viene eliminata automaticamente da Tillor dopo 7 giorni, insieme ai file collegati.
- Una scansione collegata resta conservata finché non la scolleghi o la elimini tu. Il periodo di conservazione lo decidi tu.
- Creare un cliente a partire da una scansione richiede almeno un nome nella scansione.
- Se esiste già un cliente con lo stesso numero di registro nazionale, collega la scansione a quel cliente invece di crearne uno doppio.
- I file della scansione sono conservati in forma cifrata. Sulle immagini delle pagine compare una filigrana **Not valid as ID**. Il ritratto resta senza filigrana.
- Il connettore ascolta di default sulla porta 8765.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  subgraph lokaal[Rete locale]
    R[Lettore di documenti]
    C[Connettore Tillor]
  end
  T[Scansione in sospeso in Tillor]
  K[Cliente o contatto]
  R --> C
  C --> T
  T -->|Crea o collega cliente| K
  T -->|Non collegata dopo 7 giorni| X[Eliminata automaticamente]
```

Una scansione inizia come scansione in sospeso. Se la colleghi a un cliente o a un contatto, resta conservata presso quel cliente.

## Creare un cliente da una scansione [#klant-aanmaken-vanuit-een-scan]

Prima di iniziare:

- La scansione deve essere in Tillor come scansione in sospeso. Se non c'è, vedi Problemi in fondo.
- La scansione ha bisogno di un nome.

<Steps>
<Step>
### Apri l'elenco clienti [#open-de-klantenlijst]
Vai a <UIPath>Clienti > Panoramica</UIPath> e clicca su **Crea nuovo cliente**. Finché ci sono scansioni in sospeso, il pulsante mostra un menu: scegli **Manuale** o una scansione dall'elenco.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Crea nuovo cliente - menu con scansione d'identità in sospeso" />
</Step>
<Step>
### Controlla la scansione [#controleer-de-scan]
Dopo aver scelto una scansione si apre una conferma con un'anteprima del documento e i dati della zona leggibile a macchina. Clicca su **Crea cliente**.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Conferma dopo la scelta di una scansione in sospeso con anteprima del documento" />
</Step>
</Steps>

Lo stesso percorso funziona tramite **Avvia prenotazione** (**Nuovo cliente…**) e tramite il pannello in basso a destra con **Crea cliente dalla scansione**.

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Pannello in basso a destra - scansione d'identità in sospeso con anteprima del documento" />

### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Tillor crea il cliente, collega la scansione e compila, dove possibile, nome, cognome, data di nascita, indirizzo e altri campi.
- Arrivi sul nuovo profilo cliente.
- La scansione non è più in coda e resta conservata presso il cliente.
- Il collegamento compare nella scheda **Eventi** del cliente.

## Collegare a un cliente o a un contatto esistente [#koppelen-aan-een-bestaande-klant-of-contactpersoon]

Oltre a un nuovo cliente, puoi collegare una scansione anche a un cliente o a un contatto esistente.

<Tabs items={["A un cliente", "A un contatto"]}>
<Tab value="A un cliente">
Nel profilo cliente compare una scheda tratteggiata **Assegni una scansione d'identità in attesa** finché ci sono scansioni in sospeso adatte. Scegli una scansione con **Scelga scansione…** e clicca su **Assegna a questo cliente**.
</Tab>
<Tab value="A un contatto">
Nella scheda di un contatto puoi collegare una scansione che non ha ancora un contatto e contiene almeno un nome, con **Collega al contatto**. Puoi anche far creare un nuovo contatto con **Crea contatto dalla scansione**.
</Tab>
</Tabs>

Dopo il collegamento Tillor completa, dove possibile, i dati del cliente o del contatto. Come nome Tillor prende solo la prima parte del nome, ad esempio `Andy` da `Andy Adhemar R`. Sulla scansione restano visibili tutti i nomi.

## Scollegare, esportare o eliminare una scansione [#een-scan-ontkoppelen-exporteren-of-verwijderen]

Per una scansione collegata ci sono le azioni **Scarica**, **Esporta PDF**, **Scollega scansione** ed **Elimina scansione**. Eliminare rimuove definitivamente la scansione e tutti i file cifrati e non si può annullare.

## Periodo di conservazione e tua responsabilità [#bewaartermijn-en-jouw-verantwoordelijkheid]

<Callout type="warn" title="7 giorni per le scansioni in sospeso">
Le scansioni non ancora collegate a un cliente vengono eliminate automaticamente da Tillor dopo 7 giorni (la scansione e i file collegati). Collega o elabora per tempo le scansioni in sospeso tramite **Crea nuovo cliente**, il pannello in basso a destra o la scheda tratteggiata in un profilo cliente.
</Callout>

Per le scansioni collegate vale un'altra regola: restano conservate finché la tua organizzazione non le scollega o le elimina. Sei tu a decidere se, quando e su quale base giuridica scansionare i documenti d'identità e per quanto tempo servono le scansioni collegate. Tillor tratta le scansioni come responsabile del trattamento, su tue istruzioni. Il rispetto della normativa sulla privacy, dei periodi di conservazione per le scansioni collegate e l'eliminazione tempestiva quando la conservazione non serve più sono una tua responsabilità come titolare del trattamento.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Nessuna scansione arriva in Tillor">
Controlla sul lettore l'indirizzo IP del connettore e la porta 8765, e che il connettore sia in funzione. Vedi [Connettore](/connector).
</Accordion>
<Accordion title="La scansione non è nel menu o nel pannello">
Solo le scansioni senza cliente collegato contano come in sospeso. Se la scansione è già collegata, oppure più vecchia di 7 giorni e quindi eliminata, non c'è più.
</Accordion>
<Accordion title="Crea cliente dalla scansione è grigio">
Accanto alla scansione c'è il motivo. Se la scansione non ha un nome, compare *inseriscilo sullo scanner o collega questa scansione manualmente*. Se il documento è ancora valido ed esiste già un cliente con questo numero di registro nazionale, apri il cliente proposto in alto nella scheda oppure collega la scansione a quel cliente.
</Accordion>
<Accordion title="Tillor dice: Impossibile creare il cliente da questa scansione">
Il cliente non è stato creato e la scansione resta in sospeso. Riprova. Se non funziona, crea il cliente manualmente e collega la scansione con **Assegna a cliente**.
</Accordion>
<Accordion title="Tillor dice: Impossibile collegare la scansione al cliente">
Riprova, oppure usa il pannello in basso a destra.
</Accordion>
</Accordions>

## Termini [#begrippen]

- **Scansione d'identità**: i dati e le immagini letti di un singolo documento d'identità.
- **Scansione in sospeso**: una scansione non ancora collegata a un cliente che scompare dopo 7 giorni.
- **Zona leggibile a macchina (MRZ)**: le righe di lettere e cifre in fondo al documento che il lettore interpreta.
- **Connettore**: la scatolina sulla tua rete locale che inoltra le scansioni a Tillor. Vedi [connettore](/begrippen#connector).
- **Cliente**: il record in Tillor. Vedi [cliente](/begrippen#klant).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" description="Creare un cliente, incluso il percorso con una scansione" />
  <Card title="Connettore" href="/connector" description="La scatolina del connettore nel tuo parco" />
  <Card title="Esempi pratici" href="/praktijk" />
</Cards>


# Leggere e rispondere alle conversazioni (/it-IT/inbox/gesprekken)

Nell'inbox trovi tutte le conversazioni dei canali collegati in un unico posto. Qui le leggi, rispondi e le tieni in ordine. Come collegare un canale è spiegato in [Inbox](/inbox).

Prima di iniziare:

- Ti serve il permesso **Visualizza inbox** per leggere le conversazioni e **Gestisci inbox** per rispondere o archiviare. Senza **Visualizza inbox** l'inbox non compare nella barra laterale.
- Deve essere collegato almeno un canale. Altrimenti vedi un link a <UIPath>Impostazioni > Integrazioni</UIPath>.

<Requires permission="Visualizza inbox" />

## Aprire l'inbox [#de-inbox-openen]

<Steps>
<Step>
### Vai all'inbox [#ga-naar-de-inbox]
Nella barra laterale, sotto **Assistenza**, scegli la voce **Posta in arrivo** (indicazione **1** nello screenshot). Se non è ancora collegato alcun canale, Tillor mostra un link a <UIPath>Impostazioni > Integrazioni</UIPath>.
</Step>
<Step>
### Scegli una conversazione [#kies-een-gesprek]
A sinistra trovi l'elenco **Conversazioni** con i thread di tutti i canali. Con **Aperto** e **Archiviato** passi dalle conversazioni attive a quelle concluse. Fai clic su una conversazione per aprirla a destra.
</Step>
</Steps>

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-overview.png" alt="Inbox - elenco delle conversazioni con conversazioni demo e colonna di dettaglio vuota" />

Una conversazione aperta mostra i messaggi in ordine, con nome e orario. In basso c'è il campo di risposta (indicazione **2** nell'esempio).

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-whatsapp.png" alt="Inbox - conversazione WhatsApp con campo di risposta" />

Lo sfondo di una conversazione segue il canale: beige per WhatsApp, nuvolette blu per Messenger, rosa per Instagram e grigio chiaro per la chat del sito web.

## Inviare una risposta [#een-antwoord-sturen]

<Requires permission="Gestisci inbox" />

<Steps>
<Step>
### Apri la conversazione [#open-het-gesprek]
Fai clic sulla conversazione nell'elenco.
</Step>
<Step>
### Scrivi la tua risposta [#typ-je-antwoord]
Scrivi in basso, nel campo di risposta.
</Step>
<Step>
### Invia [#verstuur]
Fai clic su **Invia** oppure premi **Ctrl+Invio**.
</Step>
</Steps>

Accanto all'orario dei tuoi messaggi compare una spunta per inviato, una doppia spunta per consegnato e una doppia spunta blu per letto. Anche le risposte che invii dall'app WhatsApp Business o dall'app Messenger compaiono nella conversazione finché l'integrazione è attiva.

Un messaggio che hai già inviato non si può modificare: i canali non lo permettono. Su Messenger e Instagram, accanto a un tuo messaggio di testo c'è un pulsante di eliminazione. Nasconde il messaggio solo in Tillor; il cliente lo conserva nella sua app.

Le foto in arrivo da Messenger vengono salvate e mostrate nella conversazione; nell'elenco compare allora un'icona di foto al posto del testo. Le reazioni con emoji ai messaggi di Messenger compaiono come contatori sotto il messaggio.

### WhatsApp e la finestra di risposta di 24 ore [#whatsapp-en-het-antwoordvenster-van-24-uur]

Un cliente che ti scrive su WhatsApp apre una finestra di risposta gratuita di 24 ore. Tillor mostra **Finestra di risposta gratuita aperta** con un conto alla rovescia. Quando la finestra è chiusa compare **Finestra 24 ore chiusa** e la tua risposta parte come template WhatsApp a pagamento, finché il cliente non scrive di nuovo.

- Se per il tuo account WhatsApp Business non è stato aggiunto un metodo di pagamento in Meta WhatsApp Manager, Tillor blocca le risposte a pagamento. Le risposte gratuite entro la finestra restano possibili.
- Se Meta non ha ancora approvato il template nella lingua della tua organizzazione, la risposta resta in attesa. Di solito richiede qualche minuto e può arrivare a 48 ore.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- La tua risposta compare nella conversazione con una spunta: inviato, consegnato o letto. Se la consegna non riesce, compare **Non consegnato**.
- Una conversazione archiviata sparisce da **Aperto**. Se il cliente scrive di nuovo, la conversazione ricompare.
- La conversazione compare anche presso il cliente, in <UIPath>Clienti > cliente > Comunicazione</UIPath>.

## Ritrovare e mettere in ordine le conversazioni [#gesprekken-terugvinden-en-opruimen]

- **Cerca**: filtra i thread per nome o numero di telefono, in **Aperto** o **Archiviato**.
- **Non lette**: in **Aperto** le conversazioni non lette sono in grassetto, con un pallino rosso. Fai clic su **Segna tutto come letto** in cima all'elenco per segnare tutto come letto in una volta.
- **Archivia**: fai clic su **Archivia** su una conversazione conclusa in **Aperto**.
- **Ripristina**: apri una conversazione in **Archiviato** e fai clic su **Ripristinare** per rimetterla nell'elenco e poter rispondere di nuovo.
- **Menu contestuale**: fai clic con il tasto destro o tieni premuto su una conversazione per **Segna come letto**, **Segna come non letto**, **Fissa conversazione** o **Rimuovi fissaggio**, **Archivia** e **Ripristinare**.

Il numero accanto a **Posta in arrivo** nella barra laterale conta le conversazioni aperte il cui ultimo messaggio è del cliente e che attendono ancora una risposta. I nuovi messaggi compaiono in tempo reale; il numero si aggiorna da solo.

## Tag [#tags]

Con i tag etichetti le conversazioni per tutto il tuo team.

1. Apri una conversazione e usa il blocco **Tag** nel pannello laterale.
2. Crea un tag con **Nuova etichetta** o scegline uno esistente. Dal menu dei tag modifichi o elimini i tag.
3. Filtra l'elenco con l'icona dei tag accanto al filtro della piattaforma.

I tag con **L'intelligenza artificiale potrebbe applicarsi** possono essere aggiunti da Tillie dopo una risposta automatica. I tag che il tuo team aveva già impostato restano.

## Notifiche [#meldingen]

Gli utenti con **Notifiche messaggi inbox** ricevono una notifica push a ogni nuovo messaggio di un cliente. Le tue risposte non generano notifiche.

Con **Visualizza inbox**, a ogni nuovo messaggio vedi anche una notifica in basso a destra, nello stesso dock delle scansioni di identità in attesa e delle telefonate attive. Mostra il mittente, il canale e un pezzo del testo. Fai clic per aprire la conversazione. La notifica scompare dopo circa dieci secondi, a meno che tu non resti sopra con il mouse. Se la conversazione è già aperta, non compare alcuna notifica.

## Conversazioni e clienti [#gesprekken-en-klanten]

Tillor collega una conversazione a un cliente quando possibile:

- WhatsApp tramite il numero di telefono.
- Messenger tramite un nome corrispondente, oppure tramite un numero di telefono o un indirizzo e-mail che il cliente stesso condivide nella conversazione.
- Instagram tramite un nome corrispondente o un nome utente con `@`.

Meta non trasmette tramite Messenger e Instagram alcun indirizzo e-mail o numero di telefono. Le conversazioni aperte di un cliente compaiono anche in <UIPath>Clienti > cliente > Comunicazione</UIPath>.

Il pannello laterale a destra mostra, per ogni canale, i dati del partecipante, come il numero WhatsApp, il nome utente Instagram con il link al profilo o la pagina nel caso della chat del sito web. Con l'icona del pannello sopra la conversazione nascondi o mostri il pannello.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo l'Inbox nella barra laterale">
Ti serve il permesso **Visualizza inbox**. Chiedi a un amministratore di assegnartelo tramite <UIPath>Impostazioni > Utenti</UIPath>, con **Modifica permessi** accanto al tuo nome.
</Accordion>
<Accordion title="Non riesco a inviare una risposta">
Per rispondere ti serve **Gestisci inbox**. In una conversazione archiviata non puoi rispondere: fai prima clic su **Ripristinare**.
</Accordion>
<Accordion title="Tillor segnala Invio del messaggio non riuscito">
Controlla che la conversazione sia aperta e che tu abbia **Gestisci inbox**. Su WhatsApp la causa può essere anche la finestra di risposta chiusa, vedi sopra. Poi riprova.
</Accordion>
<Accordion title="Accanto al mio messaggio compare Non consegnato">
Il canale non è riuscito a consegnare il messaggio. Su WhatsApp di solito dipende dalla finestra di 24 ore chiusa o da un metodo di pagamento mancante presso Meta.
</Accordion>
<Accordion title="L'inbox è vuota">
Non è ancora stato collegato alcun canale, oppure non è ancora arrivato alcun messaggio. Collega un canale in <UIPath>Impostazioni > Integrazioni</UIPath>.
</Accordion>
<Accordion title="Un cliente ha modificato o eliminato un messaggio">
Tillor adegua automaticamente la conversazione quando un cliente modifica o ritira un messaggio su Messenger o Instagram, oppure lo modifica su WhatsApp (entro 15 minuti).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Panoramica" href="/inbox" description="Canali e permessi" />
  <Card title="Conversazioni tramite chat del sito web" href="/inbox/website-chat-gesprekken" description="Funzioni extra della chat sul tuo sito" />
  <Card title="Assistente IA dell'inbox" href="/inbox/inbox-ai-assistant" description="Tillie su tutti i canali" />
</Cards>


# Assistente IA dell'inbox (Tillie) (/it-IT/inbox/inbox-ai-assistant)

**Tillie** è il nome predefinito dell'assistente IA nell'[inbox di Tillor](/inbox). Risponde alle domande più frequenti, raccoglie i dati per le richieste di prenotazione o di vendita e passa la conversazione al tuo team quando serve un collega. Tillie funziona su **tutti i canali dell'inbox**: [chat del sito web](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) e [Instagram Direct](/inbox/instagram).

<Callout type="info" title="Indipendente dalla chat del sito web">
Installa **Assistente IA della casella di posta** separatamente in **Impostazioni > Integrazioni**. L'assistente appartiene all'inbox, non solo al widget del sito web.
</Callout>

## Installare l'integrazione [#integratie-installeren]

1. Vai a **Impostazioni > Integrazioni** (barra laterale, sotto **Assistenza**)
2. Apri **Assistente IA della casella di posta** nell'elenco
3. Fai clic su **Installare**
4. In **Impostazioni** stabilisci cosa può fare Tillie (vedi i campi qui sotto)

| Campo | Cosa fa? |
|------|----------------|
| **IA della casella di posta attivata** | Interruttore principale di tutte le funzioni IA dell'inbox. Disattivalo per fermarti senza disinstallare |
| **Inviare risposte automatiche** | Se è disattivato, Tillie non invia messaggi ai visitatori. Traduzioni, riconoscimento della lingua e bozze di risposta per il team possono restare attivi separatamente |
| **Attivare automaticamente l'IA per le nuove conversazioni** | Vale solo se le risposte automatiche sono attive. Se è disattivato, ogni nuova conversazione parte senza IA; l'IA si attiva per singola conversazione dalla barra laterale. Se è attivo, le nuove conversazioni dell'inbox su tutti i canali ricevono subito l'IA (con 30 minuti di pausa dopo un messaggio del team) |
| **Generare bozze per il team** | Permette ai colleghi di generare una bozza IA nel campo di composizione. Quella bozza non viene mai inviata automaticamente |
| **Tradurre i messaggi** | Traduce i messaggi in arrivo nella lingua dell'organizzazione e le risposte del team nella lingua del contatto. Le risposte del team ricevono anche punteggiatura corretta, maiuscole e abbreviazioni da chat scritte per esteso (anche quando non serve tradurre) |
| **Rilevare la lingua del contatto** | Usa l'IA per riconoscere la lingua del visitatore quando non è ancora nota e la salva nella conversazione |
| **Nome dell'assistente AI** | Nome usato nelle risposte e nei prompt (predefinito **Tillie**) |
| **Server MCP (JSON)** | Facoltativo. Collegamenti MCP di sola lettura (URL e header) |
| **Strumenti MCP** | Dopo il salvataggio: **Caricamento degli strumenti**, elenca gli strumenti di sola lettura e attivali o disattivali uno per uno |

<Callout type="info" title="Solo traduzione, nessuna risposta automatica">
Attiva **IA della casella di posta attivata**, **Tradurre i messaggi** (ed eventualmente **Rilevare la lingua del contatto**) e disattiva **Inviare risposte automatiche**. Tillie traduce, ma non invia nulla ai visitatori.
</Callout>

### Strumenti MCP (facoltativi) [#mcp-tools-optioneel]

Se il tuo parco ha un server MCP con collegamenti di sola lettura, durante una conversazione Tillor può recuperare **dati del parco in tempo reale**. Pensa ad attività, caravan in vendita o altri dati che il tuo server mette a disposizione.

Tillor **non ha un elenco fisso di nomi di strumenti**. Quali strumenti esistono lo vedi dopo **Caricamento degli strumenti** nelle impostazioni dell'integrazione. Puoi attivare solo gli strumenti che il tuo server MCP contrassegna come di sola lettura.

1. Compila **Server MCP (JSON)** (URL e header).
2. Salva e fai clic su **Caricamento degli strumenti**.
3. Attiva gli strumenti adatti al tuo parco.

A seconda della configurazione IA del tuo ambiente, Tillie sceglie da sola quale strumento attivato è adatto, in base alla descrizione dello strumento fornita dal tuo server. Non richiama mai strumenti che non hai attivato.

I risultati di MCP finiscono nella risposta di Tillie. Non sostituiscono la knowledge base: prezzi, disponibilità e regole non li inventa comunque se non provengono da nessuna parte.

<Callout type="info" title="Tillie non risponde?">
Tillie usa un modello IA che Tillor configura per il tuo ambiente. Se l'assistente non risponde, contatta il supporto di Tillor.
</Callout>

## Cosa fa Tillie dopo un messaggio del visitatore [#wat-tillie-doet-na-een-bezoekersbericht]

Dopo ogni nuovo messaggio in arrivo in una conversazione in cui l'IA è attiva:

1. Tillor mostra un **indicatore di scrittura** sul canale mentre la risposta viene generata
2. Tillor stabilisce l'intento: **prenotazione**, **vendita** o **altro** (per le organizzazioni con il flusso caravan a noleggio anche **caravan a noleggio**)
3. Tillie risponde nella lingua del visitatore; poi l'indicatore di scrittura scompare

Tillie decide da sola, in base alle sue istruzioni, quando rispondere e quando restare in silenzio. A un saluto iniziale ("ciao", "hey", "salve") risponde con un breve benvenuto e chiede come può aiutare. Dopo un ringraziamento conclusivo non risponde di nuovo a un breve "grazie", "ok" o "no" del visitatore, così non nasce un ciclo di ringraziamenti.

| Intento | Comportamento |
|-----------|--------|
| **Prenotazione** | Chiede i dati mancanti: arrivo, partenza, tipo (tenda, mobile home, caravan da viaggio), cani sì/no (e quanti), numero di persone, bambini ed età, poi nome, e-mail e numero di telefono, e facoltativamente la targa per il check-in (si può saltare). I dati che Tillor già conosce (per esempio dal widget del sito web o da WhatsApp) vengono compilati; vengono chiesti solo i campi mancanti. Con un giorno della settimana ("lunedì") Tillie pone prima una domanda di conferma ("Intendi …?") prima di proseguire. Ogni risposta termina con una sola domanda. Risponde a brevi domande sulle politiche dalla knowledge base (per esempio modificare una prenotazione in seguito) e poi continua a raccogliere i dati. Quando è tutto completo, Tillie riassume la **richiesta** e passa la conversazione a un collega - non c'è ancora una prenotazione definitiva |
| **Caravan a noleggio** | Raccoglie nome, e-mail, indirizzo, paese e motivo del soggiorno (su richiesta), poi passa al tuo team |
| **Vendita** | Spiega che il visitatore deve passare in ufficio per una visita o un acquisto e lo comunica al tuo team |
| **Altro** | Risponde solo se la risposta è nella knowledge base. Altrimenti Tillie dice onestamente che non lo sa, si offre di girare la domanda a un collega e passa la conversazione |

Tillie **non inventa prezzi, disponibilità o regole**. Solo ciò che si trova nella knowledge base può essere detto come fatto.

### Modulo di prenotazione sul tuo sito web [#boekingsformulier-op-je-website]

Colleghi un modulo tuo alla [chat del sito web](/inbox/website-chat)? Allora puoi far sì che Tillie si limiti a confermare e passare subito la conversazione, senza domande di raccolta dati. Questo si adatta a un modulo la cui scheda si chiude subito dopo. Vedi [API della chat del sito web - metadata](/ontwikkelaars/website-chat#metadata-boekingsformulier).

## Per conversazione: Automatico, Attivo o Disattivato [#per-gesprek-automatisch-aan-of-uit]

Nei dettagli della conversazione, nella barra laterale, scegli per ogni thread:

| Modalità | Comportamento |
|-------|--------|
| **Automatico** | Tillie risponde, ma si mette in pausa per **30 minuti** dopo ogni messaggio del tuo team |
| **Attivo** | Tillie risponde sempre, anche subito dopo un messaggio del team |
| **Disattivato** | Tillie non risponde a questa conversazione |

Durante la pausa vedi un conto alla rovescia nella barra laterale.

## Tag dopo una risposta IA [#tags-na-een-ai-antwoord]

Nel pannello laterale puoi creare e assegnare **tag** validi per tutta l'organizzazione (permesso **Gestisci inbox**). Usa **Nuova etichetta** per creare un tag. Apri il menu dei tag su una conversazione per assegnarli; modifica ed eliminazione di ogni tag si trovano nello stesso menu. Spunta **L'intelligenza artificiale potrebbe applicarsi** se Tillie può aggiungere quel tag dopo una risposta automatica. Tillie sceglie allora da sola zero o più di quei tag in base alla conversazione; i tag che il tuo team aveva già impostato restano.

Tag tipici sono per esempio **Vendita**, **Prenotazione** e **Urgente**. Tillie riconosce quei nomi e li collega a ciò che ha già stabilito nella conversazione:

| Intento di Tillie | Corrisponde a nomi di tag come |
|---|---|
| Vendita | Verkoop, Sale |
| Prenotazione | Boeking, Reservatie, Booking |
| Caravan a noleggio | Caravan, Verhuur |
| Passaggio urgente | Urgent, Spoed, Dringend |

Il nome del tag non deve corrispondere esattamente: **Boeking aanvragen** conta anch'esso come tag di prenotazione. Vengono presi in considerazione solo i tag con **L'intelligenza artificiale potrebbe applicarsi**.

## Lingua, tono e dati di contatto [#taal-toon-en-contactgegevens]

Le risposte seguono la lingua del visitatore - non solo le quattro lingue del widget (`en`, `nl`, `de`, `fr`), ma qualsiasi lingua in cui Tillie sappia rispondere (per esempio spagnolo, polacco, turco). Se qualcuno chiede esplicitamente un'altra lingua, Tillie passa a quella e salva la lingua scelta nella conversazione.

I **riepiloghi di passaggio** (visibili solo al tuo team) seguono sempre la **lingua dell'organizzazione** impostata in Tillor, per ogni passaggio (prenotazione, caravan a noleggio, vendita, domanda aperta, richiesta esplicita di un collega), indipendentemente dalla lingua della conversazione. Tillie riceve quella lingua dell'organizzazione in ogni prompt.

I messaggi ai visitatori (IA e team) sono sempre **testo semplice**, senza markdown, perché WhatsApp, Instagram, Messenger e il widget non lo supportano. Su WhatsApp Tillie può mettere fino a tre pulsanti di risposta sotto una risposta breve, quando un tocco è una scelta che il messaggio stesso già nomina. Il messaggio resta leggibile se il cliente scrive invece di toccare. Fuori dalla finestra di 24 ore la risposta parte come template senza pulsanti.

Tillie resta calma e professionale, non parla dei concorrenti e non ignora le regole di sicurezza se un visitatore chiede di ignorare le istruzioni. I dati di contatto per il rinvio provengono dal **profilo dell'organizzazione in Tillor** (nome, indirizzo, telefono, e-mail, sito web). Gli **orari di apertura dell'ufficio** li imposti in **Impostazioni > Orari di apertura** (orari settimanali, periodi stagionali, festività ed eccezioni); Tillie usa quegli orari per dire quando un collega può rispondere. Tieni aggiornati quei campi. Circa una settimana prima di una festività legale, Tillor ricorda via e-mail all'indirizzo di supporto se gli orari per quel giorno non sono ancora stati inseriti.

## Eventi nella conversazione (solo per il tuo team) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team]

Durante la raccolta dati di una prenotazione, Tillie aggiorna nome, e-mail e telefono non appena il visitatore li comunica. Nell'inbox compare allora un evento **Dati IA aggiornati** (da → a), visibile solo al tuo team.

Al passaggio compare un evento **Passaggio IA**: una scheda ben visibile con il riepilogo (tabella per i dati di prenotazione o di caravan a noleggio, più note per le domande aperte). Il riepilogo è sempre nella **lingua della tua organizzazione** (nl, en, de o fr), anche quando il visitatore chatta in un'altra lingua. Il visitatore non vede quella scheda.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Inbox - chat del sito web con passaggio IA e dettagli della conversazione" />

## Knowledge base: i fatti che Tillie può usare [#kennisbank-feiten-die-tillie-mag-gebruiken]

Tillie risponde alle domande sulla base di una **knowledge base**: brevi articoli con fatti verificati sul tuo parco, per esempio orari di apertura, regole per gli animali, la piscina, le colonnine di ricarica o come modificare una prenotazione in seguito.

Alcuni articoli valgono per tutte le organizzazioni Tillor, altri sono specifici per il tuo parco. In una conversazione Tillie usa solo gli articoli generali più quelli aggiunti per la tua organizzazione.

Vuoi far aggiungere, modificare o eliminare degli argomenti? Comunicalo al supporto di Tillor. Riempiamo e manteniamo la knowledge base insieme a te, in base a ciò a cui la tua reception vuole poter rispondere.

## Flussi di conversazione: la guida per ogni intento [#gespreksflows-draaiboek-per-bedoeling]

Oltre alla knowledge base, Tillie segue dei **flussi di conversazione**: accordi su quali dati chiede, in quale ordine e quando passa la conversazione al tuo team. Ogni intento (prenotazione, caravan a noleggio, vendita, altro - vedi la tabella sopra) ha un flusso così.

I flussi sono impostati di default, ma Tillor li adatta insieme a te al tuo parco. Vuoi per esempio far chiedere dati diversi per una richiesta di prenotazione, o far passare la conversazione più in fretta? Comunicalo al supporto di Tillor.

<Callout type="warn" title="Prima versione">
Controlla le risposte IA nell'inbox prima di affidarle ai visitatori. La prenotazione via chat resta una **richiesta** - non una prenotazione definitiva.
</Callout>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Una conversazione passata da Tillie compare nell'inbox con un blocco **Tillie ha trasferito questa conversazione al Suo team** e i dati raccolti.
- Il tuo team riceve una notifica. In caso di passaggio urgente arriva tramite la notifica **Escalation AI urgente**. Vedi [Tipi di notifica](/communicatie/notificatietypes).
- Se un collega risponde, Tillie si mette in pausa per 30 minuti nella modalità **Automatico**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillie non risponde">
Controlla che **IA della casella di posta attivata** e **Inviare risposte automatiche** siano attivi in <UIPath>Impostazioni > Integrazioni > Assistente IA della casella di posta</UIPath>. Poi guarda nella barra laterale della conversazione se la modalità non è su **Disattivato**, o se è in corso un conto alla rovescia dopo un messaggio del tuo team.
</Accordion>
<Accordion title="Le nuove conversazioni partono senza Tillie">
**Attivare automaticamente l'IA per le nuove conversazioni** è disattivato. Attiva l'interruttore, oppure scegli **Attivo** per singola conversazione.
</Accordion>
<Accordion title="Tillie dice di non sapere qualcosa">
Tillie usa solo ciò che si trova nella knowledge base e non inventa prezzi, disponibilità o regole. Completa la knowledge base.
</Accordion>
</Accordions>

## Correlati [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Leggere e rispondere alle conversazioni" />
  <Card title="Chat del sito web" href="/inbox/website-chat" description="Live chat sul tuo sito" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="WhatsApp nell'inbox" />
  <Card title="Messenger" href="/inbox/messenger" description="Collegare Facebook Messenger" />
  <Card title="Instagram" href="/inbox/instagram" description="Collegare Instagram Direct" />
</Cards>


# Panoramica (/it-IT/inbox)

Nell'inbox leggi e rispondi ai messaggi di clienti e visitatori che arrivano da WhatsApp, Messenger, Instagram o dalla chat sul tuo sito web, tutto in un unico posto. La trovi nella barra laterale in **Assistenza > Posta in arrivo**. Prima colleghi i canali che vuoi usare, poi lavori ogni giorno in [Leggere e rispondere alle conversazioni](/inbox/gesprekken).

<Callout type="info" title="Non per le notifiche automatiche">
L'inbox serve per la comunicazione in entrambe le direzioni con i clienti. Le notifiche WhatsApp automatiche, per esempio in caso di saldo NFC basso, passano da Twilio e non da queste integrazioni.
</Callout>

<Callout type="info" title="Buono a sapersi">
- Un nuovo messaggio compare come scheda in basso a destra e scompare dopo circa dieci secondi. Il numero accanto a **Posta in arrivo** conta le conversazioni aperte in attesa di risposta
- L'assistente IA Tillie si mette in pausa per 30 minuti dopo che un collega ha risposto
- Un messaggio della chat sul sito web può contenere al massimo 4096 caratteri, senza immagini né file
- Un cliente può modificare un messaggio WhatsApp fino a 15 minuti dopo l'invio, e lo vedi nella conversazione
- Il promemoria via e-mail a un visitatore del sito parte dopo circa 5 minuti di inattività. Il link funziona per 30 giorni
- Un messaggio tuo che elimini in Tillor (Messenger e Instagram) scompare solo in Tillor, non presso il cliente

</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

Ogni canale si installa separatamente. Poi tutte le conversazioni finiscono nello stesso elenco e Tillor le collega, quando possibile, a un cliente.

```mermaid
flowchart LR
  W[WhatsApp] --> I[Inbox]
  M[Messenger] --> I
  G[Instagram] --> I
  C[Chat sul tuo sito web] --> I
  I --> K[Cliente collegato tramite numero di telefono o nome]
  I --> A[Tillie risponde o passa la conversazione]
  A --> T[Il tuo team]
  I --> T
  T -->|risposta| W
  T -->|risposta| M
  T -->|risposta| G
  T -->|risposta| C
```

- Il tuo team risponde in Tillor. La risposta torna al cliente tramite lo stesso canale.
- Tillie, l'assistente IA, può rispondere e passare una conversazione al tuo team. Lo decidi per singola conversazione.
- Le risposte che invii fuori da Tillor, per esempio nell'app WhatsApp Business, compaiono anch'esse nella conversazione.

## Collegare i canali [#kanalen-koppelen]

Installa un'integrazione per ogni canale in <UIPath>Impostazioni > Integrazioni</UIPath>.

<Cards>
  <Card title="Chat del sito web" href="/inbox/website-chat" description="Pulsante di chat sul tuo sito, senza account esterno" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="Collegare un numero WhatsApp tramite Meta" />
  <Card title="Messenger" href="/inbox/messenger" description="Collegare una pagina Facebook tramite Meta" />
  <Card title="Instagram" href="/inbox/instagram" description="Collegare Instagram Direct tramite Meta" />
  <Card title="Assistente IA dell'inbox" href="/inbox/inbox-ai-assistant" description="Tillie risponde e passa la conversazione su tutti i canali" />
</Cards>

Con Messenger, al momento del collegamento Tillor importa le conversazioni esistenti della pagina. Se Messenger è già collegato, puoi avviare questa sincronizzazione anche manualmente dall'inbox.

## Lavorare ogni giorno [#dagelijks-werken]

<Cards>
  <Card title="Leggere e rispondere alle conversazioni" href="/inbox/gesprekken" description="Rispondere, archiviare, tag e notifiche" />
  <Card title="Conversazioni tramite chat del sito web" href="/inbox/website-chat-gesprekken" description="Cosa vedi per un visitatore del sito" />
</Cards>

## Permessi [#rechten]

| Permesso | Cosa può fare l'utente? |
|-----------|------------------------|
| **Visualizza inbox** | Aprire l'inbox e leggere le conversazioni |
| **Gestisci inbox** | Inviare risposte, archiviare, ripristinare e fissare conversazioni, segnarle come non lette ed eliminare in Tillor i propri messaggi (Messenger e Instagram) |
| **Notifiche messaggi inbox** | Ricevere notifiche push per i nuovi messaggi dei clienti |

Imposta i permessi in <UIPath>Impostazioni > Utenti</UIPath>.

## Termini [#begrippen]

- **Conversazione o thread**: tutti i messaggi con un cliente o visitatore su un canale.
- **Aperto e Archiviato**: le due schede dell'elenco delle conversazioni. Archiviare toglie una conversazione da **Aperto**, ripristinare la rimette.
- **Tillie**: il nome predefinito dell'assistente IA nell'inbox. Puoi cambiare il nome.


Altri termini si trovano nel [glossario](/begrippen).


# Instagram (/it-IT/inbox/instagram)

Con **Instagram** ricevi i messaggi di Instagram Direct nell'[inbox di Tillor](/inbox). L'integrazione usa una **pagina Facebook** collegata con un **account Instagram Professional** in Meta Business Suite.

Prima di iniziare:

- Ti serve il permesso **Gestisci integrazioni**.
- Il tuo account Instagram è un account Professional (Business o Creator), collegato a una pagina Facebook.

## Installare l'integrazione [#integratie-installeren]

1. Vai a **Impostazioni** (barra laterale, sotto **Assistenza**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-nav.png" alt="Navigazione verso Impostazioni" />

2. Scegli **Integrazioni** e apri **Instagram** nell'elenco (indicazione **2**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-instagram.png" alt="Impostazioni > Integrazioni - Instagram nell'elenco" />

3. Fai clic su **Installare** (indicazione **1**) e completa il flusso OAuth di Meta (permessi di messaggistica Instagram)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/instagram-install.png" alt="Dettaglio di Instagram - Installare" />

4. Scegli la **pagina Facebook** collegata al tuo account Instagram Professional
5. Controlla il campo del nome utente Instagram sotto la scelta della pagina (Tillor mostra l'account collegato, per esempio `@uwaccount`)
6. Salva le impostazioni

Senza un account Instagram Professional collegato alla pagina selezionata, Tillor non può completare l'integrazione.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Dopo l'installazione, i messaggi in arrivo di Instagram Direct finiscono da soli nell'[inbox](/inbox).
- Le risposte inviate tramite l'app Instagram compaiono anch'esse nell'inbox. I messaggi che invii tramite Tillor non vengono mostrati due volte.
- Se non arriva comunque nessun messaggio, contatta il supporto di Tillor. Il collegamento di Instagram con Meta deve essere configurato per l'intera piattaforma.
- Messenger e Instagram sono integrazioni separate. Se vuoi entrambi i canali nell'inbox, installale tutte e due.

## Problemi? [#problemen]

### Collegamento non riuscito o nessun Instagram sulla pagina [#koppelen-mislukt-of-geen-instagram-op-de-pagina]

Se l'installazione si ferma con *Impossibile collegare l'app* o *Nessun account Instagram Professional*, controlla in Meta:

1. **Instagram Professional** - il tuo account Instagram deve essere Business o Creator (non un account personale).
2. **Collegare la pagina** - in [Meta Business Suite](https://business.facebook.com/) o nelle Business Settings: collega l'account Instagram alla **pagina Facebook** con cui accedi.
3. **Accesso ai messaggi** - nell'app Instagram: **Impostazioni** > **Risposte a post e storie** > **Strumenti connessi** > consenti l'accesso ai messaggi (necessario per Direct nelle app dell'inbox).
4. **Login Meta corretto** - usa un account che sia **amministratore** della pagina Facebook con permessi di messaggistica.


Durante l'installazione Tillor cerca tutte le pagine Facebook del tuo account e sceglie la prima con un account Instagram Professional collegato. Se hai più pagine, dopo l'installazione puoi scegliere un'altra pagina nelle impostazioni dell'integrazione.

<Callout type="info" title="Per il lettore tecnico">
Durante l'installazione Tillor richiede sempre i permessi `instagram_basic`, `instagram_manage_messages` e `pages_read_engagement`. Impostali prima su **Ready for testing** in **Use cases** (Messenger/Instagram) nella Meta Developer Console. **Invalid Scopes** significa che non sono ancora presenti nell'app Meta. I permessi `instagram_business_*` appartengono a un altro metodo di accesso e non sono per Tillor.
</Callout>

## Correlati [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Leggere e rispondere alle conversazioni" />
  <Card
    title="Messenger"
    href="/inbox/messenger"
    description="Collegare Facebook Messenger all'inbox"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Collegare un numero WhatsApp all'inbox"
  />
</Cards>


# Messenger (/it-IT/inbox/messenger)

Con **Messenger** ricevi nell'[inbox di Tillor](/inbox) i messaggi dei clienti tramite una pagina Facebook collegata.

Prima di iniziare:

- Ti serve il permesso **Gestisci integrazioni**.
- Accedi a Meta con un account che sia amministratore della pagina Facebook.

## Installare l'integrazione [#integratie-installeren]

1. Vai a **Impostazioni** (barra laterale, sotto **Assistenza**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-nav.png" alt="Navigazione verso Impostazioni" />

2. Scegli **Integrazioni** e apri **Messenger** nell'elenco (indicazione **2**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-messenger.png" alt="Impostazioni > Integrazioni - Messenger nell'elenco" />

3. Fai clic su **Installare** (indicazione **1**) e completa il flusso OAuth di Meta

<DocScreenshot src="/screenshots/communicatie/providers/messenger/messenger-install.png" alt="Dettaglio di Messenger - Installare" />

4. Nella pagina di dettaglio scegli quale **pagina Facebook** riceve i messaggi di Messenger
5. Salva le impostazioni

Tillor mostra la pagina collegata in **Impostazioni**, nella pagina di dettaglio. Dopo l'installazione Tillor riceve automaticamente i messaggi in arrivo di Messenger. Le risposte che invii anche tramite l'app Messenger compaiono nell'inbox. I messaggi che invii tramite Tillor non vengono mostrati due volte.

Per **Instagram Direct** installa l'integrazione separata [Instagram](/inbox/instagram).

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Tillor importa le conversazioni esistenti della pagina. Puoi avviare questa sincronizzazione anche tu in seguito, dall'inbox.
- I nuovi messaggi finiscono da soli nell'[inbox](/inbox). Tillor li collega a un cliente con lo stesso nome, oppure tramite un numero di telefono o un indirizzo e-mail che il cliente condivide nella conversazione.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non arriva nessun messaggio">
Controlla in <UIPath>Impostazioni > Integrazioni > Messenger</UIPath> che sia stata scelta la **pagina Facebook** giusta e che le impostazioni siano state salvate.
</Accordion>
<Accordion title="Una conversazione non è collegata a un cliente">
Meta non trasmette tramite Messenger alcun indirizzo e-mail o numero di telefono. Tillor collega solo tramite un nome corrispondente o tramite dati che il cliente condivide di sua iniziativa.
</Accordion>
</Accordions>

## Correlati [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Leggere e rispondere alle conversazioni" />
  <Card
    title="Instagram"
    href="/inbox/instagram"
    description="Collegare Instagram Direct all'inbox"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Collegare un numero WhatsApp all'inbox"
  />
</Cards>


# Conversazioni tramite chat del sito web (/it-IT/inbox/website-chat-gesprekken)

Una conversazione compare nell'inbox non appena il visitatore invia il suo primo messaggio, con il canale **Chat sul sito web**. Come rispondere è spiegato in [Leggere e rispondere alle conversazioni](/inbox/gesprekken). Questa pagina spiega cosa c'è in più con la chat del sito web.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Inbox - chat del sito web con dettagli della conversazione" />

Nel pannello laterale a destra c'è un pulsante **Aperto sul sito web** con la pagina in cui il visitatore è stato attivo per ultimo, oltre ai dati del visitatore e della sessione. Anche i campi extra del modulo per i visitatori compaiono lì.

## Chi è il visitatore? [#wie-is-de-bezoeker]

- Tillor riconosce un visitatore dal suo browser. Lo stesso browser sullo stesso dispositivo apre quindi la stessa conversazione.
- Nome, e-mail e telefono del modulo per i visitatori vengono conservati in quel browser dopo il primo messaggio. Se il visitatore torna più tardi, non deve compilare di nuovo nulla.
- Se quell'archivio è vuoto, per esempio in un altro browser o dopo una pulizia, il widget completa i dati dalla conversazione esistente.
- I messaggi sono testo fino a 4096 caratteri. Immagini e file non sono supportati.

## Scrittura e presenza [#typen-en-aanwezigheid]

| Cosa | Chi lo vede | Dove |
|-----|--------------|------|
| **Tipi…** mentre il visitatore scrive | Il tuo team | Sotto la conversazione nell'inbox, anche prima del primo messaggio |
| **Tipi…** mentre scrive un collega | Il visitatore | Nel widget |
| **In linea** (pallino verde) o **Ultimo accesso** con un orario | Il tuo team | Sopra la conversazione |

Il visitatore conta come online finché la scheda è visibile. Il widget segnala di essere attivo circa ogni 20 secondi. Anche recuperare messaggi, scrivere e leggere contano come attività.

## Spunte [#vinkjes]

I visitatori vedono delle spunte accanto ai propri messaggi:

| Spunte | Significato |
|---------|-----------|
| Una | Inviato |
| Due grigie | Il tuo team ha aperto la conversazione e caricato i messaggi |
| Due blu | Il tuo team ha segnato la conversazione come letta |

Nell'inbox vedi le spunte accanto alle tue risposte:

| Spunte | Significato |
|---------|-----------|
| Una | Inviato |
| Due grigie | Il visitatore è sulla pagina e ha recuperato i messaggi, anche con la chat chiusa |
| Due blu | Il visitatore ha la finestra della chat aperta |

Le risposte dall'inbox compaiono automaticamente nel widget, anche se il visitatore lo apre più tardi.

## Attività del visitatore nella conversazione [#bezoekersactiviteit-in-het-gesprek]

Dopo il primo messaggio il tuo team vede nella conversazione dei testi informativi grigi. Il visitatore non li vede. Queste righe non aumentano alcun contatore di non lette e non generano notifiche push.

| Evento | Testo nell'inbox |
|-------------|-------------------|
| Chat chiusa | L'utente ha chiuso la chat |
| Altra scheda o finestra, oppure browser ridotto a icona | L'utente ha cambiato scheda o ridotto a icona il browser |
| Aperta un'altra pagina | L'utente ha navigato verso l'URL della pagina |

La navigazione viene rilevata anche sui siti che cambiano pagina internamente senza ricaricare. Il widget comunica la pagina corrente circa ogni 20 secondi, così il pannello laterale mostra l'ultima pagina attiva.

## Tillie sulla chat del sito web [#tillie-op-website-chat]

Tillie, l'assistente IA, funziona anche nel widget. Per questo installa **Assistente IA della casella di posta** separatamente. Installazione, knowledge base e comportamento si trovano in [Assistente IA dell'inbox (Tillie)](/inbox/inbox-ai-assistant). I messaggi di Tillie nel widget hanno un piccolo robot al posto del logo dell'organizzazione.

<Callout type="info" title="Il primo messaggio">
Appena il visitatore scrive, il tuo team può vedere **Tipi…**. Il primo messaggio parte solo con **Invia**, insieme ai dati di contatto compilati.
</Callout>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Leggere e rispondere alle conversazioni" href="/inbox/gesprekken" description="Rispondere, archiviare, tag" />
  <Card title="Impostazioni della chat del sito web" href="/inbox/website-chat-instellingen" description="Widget e modulo per i visitatori" />
  <Card title="API della chat del sito web" href="/ontwikkelaars/website-chat" description="Costruire una propria interfaccia di chat" />
</Cards>


# Impostazioni della chat del sito web (/it-IT/inbox/website-chat-instellingen)

Trovi le impostazioni in <UIPath>Impostazioni > Integrazioni > Chat sul sito web</UIPath>. Installazione e inserimento dello snippet sono spiegati in [Mettere la chat sul tuo sito web](/inbox/website-chat).

## Widget [#widget]

| Campo | Cosa fa? |
|------|---------------|
| **Widget abilitato** | Nasconde la chat ovunque senza rimuovere l'integrazione. Attivo di default |
| **Mostra sulle pagine pubbliche di Tillor** | Mostra il pulsante di chat sulle pagine pubbliche di Tillor, come il pass di accesso, la fattura in sospeso e la mappa pubblica. Il tuo sito usa lo snippet. Attivo di default |
| **Messaggio di benvenuto** | Testo nell'intestazione della chat e prima del primo messaggio del visitatore. Massimo 500 caratteri. Se lo lasci vuoto compare un testo predefinito nella lingua del widget |
| **Tooltip launcher** | Etichetta del pulsante flottante, pensata per gli screen reader. Massimo 80 caratteri |
| **Messaggio di risposta rapida** | Riga sotto il nome dell'organizzazione nell'intestazione della chat, per esempio "Di solito rispondiamo in fretta" |
| **Icona di avvio** | Icona sul pulsante di chat: **Nuvoletta**, **Chiacchierata completata**, **Punto interrogativo**, **Per cercare** o **Persona** |
| **Colore accento** | Colore del pulsante di chat e dei messaggi del visitatore. Scegli un colore o inserisci un valore esadecimale, per esempio `#2563eb` |
| **Domini consentiti** | Nomi host separati da virgole a cui è permesso caricare la chat. Vuoto significa: qualsiasi dominio |
| **Invia email ai visitatori sulle risposte non lette** | Vedi [qui sotto](#herinnering-per-e-mail). Attivo di default |

L'intestazione della chat mostra automaticamente il logo della tua organizzazione. I messaggi dell'assistente IA hanno un piccolo robot al posto di quel logo. Nessuno dei due è configurabile in Chat sul sito web.

<Callout type="info" title="Che lingua ottiene il visitatore?">
Se non imposti **Messaggio di benvenuto**, **Tooltip launcher** o **Messaggio di risposta rapida**, il widget usa un testo predefinito nella propria lingua. Quella lingua la imposti sullo snippet con `data-locale` (vedi [Opzioni sullo snippet](#opties-op-het-snippet)).
</Callout>

## Modulo per i visitatori [#bezoekersformulier]

Qui stabilisci cosa compila un visitatore prima del primo messaggio. Se ci sono campi obbligatori, compaiono insieme al campo del messaggio in un'unica schermata. Il visitatore compila tutto e fa clic su **Invia**, senza passaggi intermedi.

### Campi standard [#standaardvelden]

| Campo | Cosa fa? |
|------|---------------|
| **Nome richiesto** | I visitatori inseriscono il loro nome. Il nome viene salvato nella conversazione |
| **E-mail richiesta** | I visitatori inseriscono il loro indirizzo e-mail. L'indirizzo viene salvato nella conversazione |
| **Telefono richiesto** | I visitatori inseriscono un numero di telefono. Tillor lo converte in un formato fisso e lo usa per collegare la conversazione a chiamate e clienti |

Ogni campo si attiva o disattiva separatamente. Se è attivo solo il telefono, il visitatore vede solo il campo del telefono.

### Campi extra [#extra-velden]

Fai clic su **Aggiunga campo** per domande tue. Puoi aggiungere al massimo 8 campi extra. Rimuovi un campo con **Rimuovi campo**.

| Opzione | Spiegazione |
|-------|-------------|
| **Etichetta del campo** | Ciò che il visitatore vede nel widget. Massimo 80 caratteri |
| **Chiave di campo** | Nome interno del campo. Inizia con una lettera minuscola e usa solo lettere minuscole, cifre e `_` (massimo 32 caratteri) |
| **Tipo di campo** | **Testo** o **E-mail** |
| **Obbligatorio** | Il visitatore deve compilare il campo prima di poter chattare. Un nuovo campo è obbligatorio di default |
| **Segnaposto** | Suggerimento nel campo di inserimento. Massimo 120 caratteri |

Le risposte ai campi extra compaiono nell'inbox presso la conversazione, accanto al canale e all'id del visitatore.

## Promemoria via e-mail [#herinnering-per-e-mail]

I visitatori spesso chiudono la pagina prima che il tuo team o Tillie risponda. Con **Invia email ai visitatori sulle risposte non lette** il visitatore riceve un'e-mail con il pulsante **Continua la conversazione**, appena c'è una risposta pronta che non ha letto.

- Il visitatore deve aver indicato un indirizzo e-mail, tramite il modulo per i visitatori o precompilato. Senza indirizzo non succede nulla.
- L'e-mail parte solo quando il visitatore non è più attivo da circa 5 minuti. Per ogni serie di risposte non lette riceve una sola e-mail.
- Il pulsante apre la chat e prosegue la conversazione, anche su un altro dispositivo o in un altro browser. Il link funziona per 30 giorni.
- Il visitatore può anche rispondere direttamente all'e-mail. La risposta compare nella stessa conversazione nell'inbox, con una piccola icona di busta accanto al messaggio.
- Le risposte di Tillie contano, come quelle del tuo team.

## Opzioni sullo snippet [#opties-op-het-snippet]

Oltre a `data-org-id` e `data-widget-key` puoi mettere attributi facoltativi sullo script. Questo è pensato per chi inserisce lo snippet nel sito.

| Attributo | Cosa fa? |
|-----------|---------------|
| `data-locale` | Lingua del widget: `en`, `nl`, `de`, `fr`, `pt` o `ro`, eventualmente con regione come `nl-BE`. Predefinito `en`; un'altra lingua ripiega sull'inglese. La regione determina il formato di data e ora |
| `data-accent-color` | Colore accento per questa pagina come esadecimale a 6 cifre. Prevale sul colore in **Impostazioni** |
| `data-messages` | Oggetto JSON per adattare singoli testi, per esempio `{"send":"Invia","messagePlaceholder":"Scrivi il tuo messaggio…"}` |
| `data-sounds` | `false` disattiva i suoni per le nuove risposte del team e per l'invio. Attivo di default |
| `data-launcher` | `false` nasconde il pulsante di chat flottante. Apri poi la chat con un tuo pulsante tramite [l'SDK del widget](/ontwikkelaars/website-chat#widget-sdk) |
| `data-visitor` | Oggetto JSON per precompilare nome, e-mail e telefono, per esempio `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` |
| `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Precompila uno solo di quei campi |
| `data-debug` | `true` mostra righe di log nella console del browser |

Gli attributi completano solo i campi vuoti. Se il visitatore ha già compilato dei dati in questo browser, questi restano.

Un esempio con testi in olandese:

```html
<script
  src="https://tillor.eu/inbox-widget.js"
  data-org-id="org_abc123"
  data-widget-key="iwk_xxx"
  data-locale="nl"
  async
  defer
></script>
```

Si può attivare il debug anche senza modificare lo snippet: esegui nella console del browser `localStorage.setItem('tillor-inbox-debug', '1')` e aggiorna la pagina.

## Protezione dallo spam [#spambeveiliging]

Il widget non usa captcha. Tillor protegge l'invio con la chiave del widget e con **Domini consentiti**. Se sul tuo modulo di contatto c'è un captcha tuo, può restare come livello aggiuntivo.

## Condizioni per i visitatori [#voorwaarden-voor-bezoekers]

Sotto il campo del messaggio c'è un breve avviso che, inviando, il visitatore accetta le [condizioni della chat del sito web](https://tillor.eu/chat-terms). Il link si apre in una nuova scheda e segue la lingua di `data-locale`.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Mettere la chat sul tuo sito web" href="/inbox/website-chat" description="Installare e inserire lo snippet" />
  <Card title="Conversazioni tramite chat del sito web" href="/inbox/website-chat-gesprekken" description="Cosa vedete tu e il visitatore" />
  <Card title="API della chat del sito web" href="/ontwikkelaars/website-chat" description="SDK del widget e interfaccia di chat propria" />
</Cards>


# Mettere la chat sul tuo sito web (/it-IT/inbox/website-chat)

Con l'integrazione Chat sul sito web il tuo sito ottiene un pulsante di chat. I messaggi dei visitatori arrivano nell'[inbox](/inbox), accanto a WhatsApp, Messenger e Instagram.

<Requires permission="Gestisci integrazioni" />

<Steps>
<Step>
### Installa l'integrazione [#installeer-de-integratie]
Vai a <UIPath>Impostazioni > Integrazioni</UIPath> e apri **Chat sul sito web**. Fai clic su **Installare**. Non serve alcun collegamento con un account esterno; Tillor crea da sé la chiave del widget.
</Step>
<Step>
### Configura il widget [#stel-de-widget-in]
In **Impostazioni**, nella stessa pagina, compila almeno il **Messaggio di benvenuto** e il **Colore accento**. Compila anche **Domini consentiti** in modo che solo il tuo sito possa caricare la chat. Tutte le opzioni sono in [Impostazioni della chat del sito web](/inbox/website-chat-instellingen).
</Step>
<Step>
### Copia lo snippet [#kopieer-het-snippet]
In **Incorpora nel tuo sito web** fai clic su **Copi snippet**. Se il blocco non c'è, salva le impostazioni e aggiorna la pagina.
</Step>
<Step>
### Incolla lo snippet sul tuo sito [#plak-het-snippet-op-je-site]
Incolla lo snippet prima del tag di chiusura `</body>` in ogni pagina in cui deve comparire il pulsante di chat. Se il sito ha un template o un footer condiviso, inseriscilo una sola volta in quel template.
</Step>
</Steps>

## Cosa vedi dopo? [#wat-zie-je-daarna]

Apri il tuo sito. In basso a destra c'è un pulsante di chat. Invia tu stesso un messaggio di prova: la conversazione compare nell'inbox con il canale **Chat sul sito web**. La spiegazione di cosa vedete tu e il visitatore è in [Conversazioni tramite chat del sito web](/inbox/website-chat-gesprekken).

<Callout type="info" title="La chiave del widget è pubblica">
La chiave è leggibile nello snippet, come in altri prodotti di chat. Limita gli abusi con **Domini consentiti** (nomi host separati da virgole, per esempio `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Se lasci il campo vuoto, la chat funziona su qualsiasi dominio in cui si trova lo snippet.
</Callout>

## Chat sulle pagine pubbliche di Tillor [#chat-op-publieke-tillor-paginas]

Se **Chat sul sito web** è installata, **Widget abilitato** è attivo e **Mostra sulle pagine pubbliche di Tillor** è attivo, il pulsante di chat compare anche sulle pagine pubbliche della tua organizzazione. Lì non devi inserire alcuno snippet. Si tratta, tra l'altro, delle pagine per un pass di accesso, una fattura in sospeso, un tag NFC, i dati dell'organizzazione e la mappa pubblica.

- Su quelle pagine Tillor usa il **Colore accento** delle impostazioni.
- **Domini consentiti** vale solo per il tuo sito web, non per le pagine di Tillor.
- Se disattivi **Widget abilitato**, il pulsante scompare ovunque. Se disattivi solo **Mostra sulle pagine pubbliche di Tillor**, la chat sul tuo sito continua a funzionare.

## Disattivare temporaneamente la chat [#de-chat-tijdelijk-uitzetten]

Disattiva **Widget abilitato** in <UIPath>Impostazioni > Integrazioni > Chat sul sito web</UIPath>. L'integrazione resta installata e la chiave del widget non cambia. Riattiva l'interruttore per riportare la chat.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il pulsante di chat non compare sul mio sito">
Controlla prima che **Widget abilitato** sia attivo. Se c'è un elenco in **Domini consentiti**, verifica che il nome host della pagina ci sia, compreso `www.` se il tuo sito lo usa. Controlla anche che lo snippet sia davvero in quella pagina e non solo in un template che quella pagina non usa.
</Accordion>
<Accordion title="Lo snippet di incorporamento non si carica nelle impostazioni">
Tillor mostra allora il messaggio che non è stato possibile caricare lo snippet. Salva le impostazioni e aggiorna la pagina.
</Accordion>
<Accordion title="La chat è sulle pagine di Tillor, ma non sul mio sito">
Sulle pagine di Tillor non serve alcuno snippet. Il tuo sito mostra la chat solo con lo snippet del passaggio 3.
</Accordion>
<Accordion title="Voglio collegare un modulo di contatto mio o sostituire il pulsante">
Se ne occupa uno sviluppatore con l'SDK del widget. Vedi [API della chat del sito web](/ontwikkelaars/website-chat).
</Accordion>
<Accordion title="Un visitatore vede You sent a lot of messages in a short time">
Tillor limita quanto un visitatore invia tramite la chat, così uno script non può sommergere la tua inbox e le risposte di Tillie: 10 messaggi al minuto e 200 al giorno per visitatore, e 30 al minuto e 600 al giorno per tutti sulla stessa rete insieme (come il wifi del tuo campeggio). Allegati: 10 all'ora per visitatore e 50 all'ora per rete. Dopo un minuto il visitatore può continuare; nessun messaggio già inviato va perso. Il widget mostra questo avviso in inglese.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni della chat del sito web" href="/inbox/website-chat-instellingen" description="Tutti i campi e le opzioni di incorporamento" />
  <Card title="Conversazioni tramite chat del sito web" href="/inbox/website-chat-gesprekken" description="Cosa vedete tu e il visitatore" />
  <Card title="API della chat del sito web" href="/ontwikkelaars/website-chat" description="Collegare un modulo o un'interfaccia di chat propri" />
  <Card title="Assistente IA dell'inbox" href="/inbox/inbox-ai-assistant" description="Far rispondere Tillie" />
</Cards>


# WhatsApp Business (/it-IT/inbox/whatsapp-business-inbox)

Con **WhatsApp Business** ricevi e rispondi ai messaggi dei clienti via WhatsApp nell'[inbox di Tillor](/inbox). Questo **non** è la stessa cosa delle notifiche WhatsApp tramite Twilio.

<Callout type="info">
Per i messaggi WhatsApp automatici (notifiche) vedi [Twilio](/communicatie/providers/twilio). L'app del marketplace **WhatsApp Business** serve solo per le conversazioni dell'inbox.
</Callout>

Prima di iniziare:

- Ti serve il permesso **Gestisci integrazioni**.
- Hai un account WhatsApp Business presso Meta e accedi con un account che lo gestisce.

## Installare l'integrazione [#integratie-installeren]

1. Vai a **Impostazioni > Integrazioni**
2. Apri **WhatsApp Business** nell'elenco (indicazione **2**)

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/marketplace-whatsapp.png" alt="Impostazioni > Integrazioni - WhatsApp Business nell'elenco" />

3. Fai clic su **Installare** (indicazione **1**) e completa il flusso OAuth di Meta

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/whatsapp-install.png" alt="Dettaglio di WhatsApp Business - Installare" />

4. Scegli quale **numero WhatsApp** riceve i messaggi dell'inbox
5. Salva le impostazioni

Dopo l'installazione Tillor riceve automaticamente i messaggi in arrivo. Le risposte che invii anche tramite l'app WhatsApp Business o un dispositivo collegato compaiono nell'inbox. I messaggi che invii tramite Tillor non vengono mostrati due volte.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- I messaggi in arrivo compaiono da soli nell'[inbox](/inbox), collegati al cliente con lo stesso numero di telefono.
- Le risposte le invii in Tillor. Fuori dalla finestra di 24 ore partono come template a pagamento, vedi [Leggere e rispondere alle conversazioni](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non arriva nessun messaggio">
Controlla in <UIPath>Impostazioni > Integrazioni > WhatsApp Business</UIPath> che sia stato scelto il **numero WhatsApp** giusto e che le impostazioni siano state salvate.
</Accordion>
<Accordion title="Le mie risposte non partono fuori dalla finestra di risposta">
Aggiungi in Meta WhatsApp Manager un metodo di pagamento per il tuo account WhatsApp Business. Senza metodo di pagamento Tillor blocca le risposte a pagamento.
</Accordion>
</Accordions>

## Correlati [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Leggere e rispondere alle conversazioni" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook Messenger per l'inbox" />
</Cards>


# Panoramica (/it-IT/integraties)

Un'integrazione collega Tillor a un altro servizio, per esempio per pagamenti, contabilità, telefonia, telecamere o la tua scheda su Google. Le gestisci tutte in <UIPath>Impostazioni > Integrazioni</UIPath>. Come installarne una è spiegato in [Installare un'integrazione](/integraties/integratie-installeren).

<Requires permission="Visualizza integrazioni" />

## Come si collega tutto? [#hoe-hangt-dit-samen]

Un'integrazione appartiene a tutta la tua organizzazione, non a un singolo utente. Dopo l'installazione il collegamento funziona dove serve: il collegamento delle telecamere sui punti di accesso, il collegamento della posta sul profilo del cliente, il collegamento dei pagamenti sulle fatture. Alcuni collegamenti passano dal connector, un piccolo programma su un computer della tua rete. In quel caso deve essere online.

```mermaid
flowchart LR
  A[Impostazioni > Integrazioni] --> B[Installare un'integrazione]
  B --> C[Pagamenti e fatture]
  B --> D[Profilo cliente e inbox]
  B --> E[Punti di accesso e telecamere]
  E -. tramite .-> F[Connector nella tua rete]
```

<Callout type="info" title="Buono a sapersi">
- Per guardare serve il permesso **Visualizza integrazioni**. Installare, modificare e disinstallare richiede **Gestisci integrazioni**.
- La disinstallazione non si può annullare. Poi reinstalli l'integrazione e inserisci di nuovo i dati.
- Partoo riceve i tuoi orari di apertura dei prossimi 90 giorni e un aggiornamento ogni notte. Vedi [Partoo](/integraties/partoo).
- I pagamenti effettuati più di 24 ore fa non ricevono più l'overlay della telecamera. Vedi [UniFi Protect](/integraties/unifi-protect).
- Quali integrazioni vedi dipende dalla tua organizzazione. Ne manca una? Chiedilo al tuo amministratore Tillor o al supporto.
</Callout>

## Integrazioni disponibili [#beschikbare-integraties]

| Integrazione | A cosa serve | Spiegazione |
|---|---|---|
| Mollie | Pagamenti online e con POS, addebito diretto SEPA | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) |
| Conti bancari | Importare le transazioni bancarie e collegarle alle fatture | [Ponto e conti bancari](/boekhouden/betalingsrapporten/betaalmethodes/ponto) |
| Admisol | Inviare i report dei pagamenti alla tua contabilità | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) |
| Odoo | Esportare clienti e fatture in Odoo | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) |
| ICY | Leggere i contatori | [Gestione contatori](/meterbeheer) |
| Voys | Collegare le telefonate ai clienti | [Voys](/communicatie/providers/voys) |
| WhatsApp Business | Messaggi WhatsApp nell'inbox | [WhatsApp Business](/inbox/whatsapp-business-inbox) |
| Messenger | Conversazioni di Facebook Messenger nell'inbox | [Messenger](/inbox/messenger) |
| Instagram | Conversazioni di Instagram Direct nell'inbox | [Instagram](/inbox/instagram) |
| Chat sul sito web | Live chat sul tuo sito web | [Chat del sito web](/inbox/website-chat) |
| Assistente IA della casella di posta | Rispondere automaticamente alle domande frequenti | [Assistente IA dell'inbox](/inbox/inbox-ai-assistant) |
| UniFi Protect | Collegare le telecamere ai punti di accesso e ai pagamenti | [UniFi Protect](/integraties/unifi-protect) |
| Partoo | Tenere allineati gli orari di apertura su Google e altre schede | [Partoo](/integraties/partoo) |
| Outlook | Vedere la posta di un cliente sul profilo del cliente | [Outlook](/integraties/outlook) |

## Termini [#begrippen]

- **Integrazione**: un collegamento tra Tillor e un servizio esterno.
- **Connector**: il programma nella tua rete che collega a Tillor dispositivi come telecamere e stampanti. Vedi [Connector](/connector).
- **Installare e disinstallare**: attivare o rimuovere un collegamento. La rimozione non si può annullare.
- **Chiave API**: un codice segreto con cui Tillor può operare in un altro servizio.
- **Overlay**: testo che scorre sulle immagini della telecamera, per esempio un pagamento.

Altre spiegazioni si trovano nel [glossario](/begrippen).

<Cards>
  <Card title="Installare un'integrazione" href="/integraties/integratie-installeren" description="Cercare, compilare e collegare" />
  <Card title="UniFi Protect" href="/integraties/unifi-protect" description="Immagini delle telecamere per accessi e pagamenti" />
  <Card title="Partoo" href="/integraties/partoo" description="Inoltrare automaticamente gli orari di apertura" />
  <Card title="Outlook" href="/integraties/outlook" description="Posta del cliente sul profilo del cliente" />
</Cards>


# Installare un'integrazione (/it-IT/integraties/integratie-installeren)

Un'integrazione si installa in <UIPath>Impostazioni > Integrazioni</UIPath>. La cerchi, inserisci i dati del servizio esterno e fai clic su **Installare**. Poi la modifichi nel blocco **Impostazioni** oppure la rimuovi con **Disinstalla**. Cosa è disponibile lo trovi nella [panoramica](/integraties).

<Requires permission="Gestisci integrazioni" />

Prima di iniziare:

- Con il solo permesso **Visualizza integrazioni** vedi l'elenco e le impostazioni, ma non puoi modificare nulla.
- Tieni a portata di mano le credenziali o le chiavi del servizio esterno. Con Outlook vieni reindirizzato per accedere direttamente lì.
- Per un collegamento che passa dal connettore, come UniFi Protect, il connettore deve essere online.

## Installare un'integrazione [#een-integratie-installeren]

<Steps>
<Step>
### Cerca l'integrazione [#zoek-de-integratie]
Usa la barra di ricerca, oppure scegli a sinistra sotto **Integrazioni** una categoria: **Comunicazione**, **Sorveglianza**, **Pagamenti**, **Contabilità** o **Contatori**. **Tutte le integrazioni** mostra tutto. Un'integrazione già collegata ha l'etichetta **Collegato**.

<DocScreenshot src="/screenshots/integraties/integrations-overview.png" alt="Impostazioni > Integrazioni con l'elenco delle integrazioni" />
</Step>
<Step>
### Apri l'integrazione [#open-de-integratie]
Fai clic su di essa. Alcune pagine hanno in alto il link **Visualizza il manuale**.
</Step>
<Step>
### Inserisci i dati e fai clic su Installare [#vul-de-gegevens-in-en-klik-op-installeren]
Cosa inserire dipende dal servizio. Con Outlook vieni reindirizzato al servizio stesso per accedere.
</Step>
</Steps>

## Modificare o rimuovere [#aanpassen-of-verwijderen]

Dopo l'installazione, sulla stessa pagina compare un blocco **Impostazioni**. Modifica lì il collegamento e salva. Con **Disinstalla** rimuovi il collegamento. Questa operazione non può essere annullata.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il collegamento funziona subito per tutta la tua organizzazione.
- Cosa fa il collegamento lo vedi dove serve, per esempio sul profilo del cliente o su un punto di accesso.
- Dopo **Disinstalla** il collegamento si interrompe. Ciò che si trova già nell'altro servizio resta lì.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Vedo Nessuna integrazione trovata">
Non c'è nessuna integrazione che corrisponda al termine di ricerca o alla categoria. Prova un altro termine oppure scegli **Tutte le integrazioni**. Se manca un'integrazione che ti aspetti, non è attiva per la tua organizzazione. Chiedi al supporto.
</Accordion>
<Accordion title="Il pulsante Installare è grigio o manca">
Non hai il permesso **Gestisci integrazioni**. Chiedi al tuo amministratore.
</Accordion>
<Accordion title="Tillor dice Assegnazione non riuscita">
Non è stato possibile collegare l'integrazione. Controlla i dati inseriti e riprova.
</Accordion>
<Accordion title="Tillor dice Disconnessione non riuscita">
Riprova. Se non funziona, scrivi a support@tillor.eu.
</Accordion>
<Accordion title="Tillor dice Impostazioni dell'app non aggiornate">
La modifica non è stata salvata. Prova a salvare di nuovo.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Panoramica delle integrazioni" href="/integraties" description="Tutti i collegamenti disponibili" />
  <Card title="Connettore" href="/connector" description="Il programma nella tua rete" />
</Cards>


# Collegare Outlook (/it-IT/integraties/outlook)

Con il collegamento a Outlook vedi sul profilo del cliente le e-mail che la tua organizzazione ha scambiato con quel cliente. Tillor le recupera in tempo reale da Outlook e non le conserva.

<Requires permission="Gestisci integrazioni" />

Prima di iniziare:

- Ti serve un account Microsoft di cui Tillor può leggere la posta.
- Per vedere la posta sul profilo del cliente ti serve il permesso **Visualizza inbox**. Senza questo permesso manca la scheda **Outlook**.

## Installare [#installeren]

<Steps>
<Step>
### Apri l'integrazione [#open-de-integratie]
Vai su <UIPath>Impostazioni > Integrazioni > Outlook</UIPath>.
</Step>
<Step>
### Fai clic su Installare [#klik-op-installeren]
Vieni reindirizzato a Microsoft.
</Step>
<Step>
### Accedi e dai il consenso [#log-in-en-geef-toestemming]
Accedi con l'account di cui Tillor può leggere la posta.

<DocScreenshot src="/screenshots/integraties/integrations-outlook.png" alt="Installare Outlook" />
</Step>
</Steps>

Dopo il collegamento vedi sotto **Impostazioni** il nome, l'indirizzo e-mail e il nome utente dell'account collegato, e fino a quando la connessione è attiva.

## Scegliere le caselle di posta [#mailboxen-kiezen]

Per impostazione predefinita Tillor cerca solo nella casella dell'account collegato. Sotto **Caselle di posta** scegli altre caselle, per esempio una casella condivisa della reception.

- **Personale** è la casella dell'account collegato.
- **Condivisa** sono le caselle condivise che quell'account può aprire. Tillor le cerca da solo.
- **Aggiunta manualmente** sono gli indirizzi che scrivi tu. Digita l'indirizzo e scegli **Aggiungi [indirizzo]**.

## La posta sul profilo del cliente [#mail-op-het-klantprofiel]

Sul profilo del cliente compare una scheda **Outlook**, tra **Comunicazioni** ed **Eventi**. La scheda c'è solo se Outlook è collegato e hai il permesso **Visualizza inbox**.

- In alto vedi il numero di messaggi e le caselle in cui si è cercato. Con **Aggiorna** recuperi la posta più recente.
- Tillor cerca per indirizzo e-mail del cliente e dei suoi contatti. Se nessuno ha un indirizzo e-mail, compare un avviso che non c'è nulla da cercare.
- Ogni messaggio mostra l'oggetto, se è **Ricevuto** o **Inviato**, da chi a chi, e una graffetta in caso di allegati. Fai clic su un messaggio per aprire il testo e gli allegati. Con **Apri in Outlook** vai al messaggio in Outlook stesso.
- La stessa e-mail presente in più caselle compare una sola volta nell'elenco.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Tillor legge la posta solo in consultazione e non conserva nulla. Se rimuovi il collegamento, la scheda **Outlook** sparisce dal profilo del cliente.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Informazioni sull'account non disponibili">
Tillor non è riuscito a recuperare l'account Microsoft collegato. Aggiorna la pagina oppure ricollega Outlook tramite **Installare**.
</Accordion>
<Accordion title="Ricollega per rilevare le caselle condivise">
Outlook è stato collegato prima che Tillor potesse cercare le caselle condivise. Fai clic su **Ricollega Outlook**, oppure digita tu l'indirizzo della casella condivisa.
</Accordion>
<Accordion title="Impossibile caricare le caselle condivise">
Puoi comunque digitare manualmente l'indirizzo di una casella sotto **Aggiunta manualmente**.
</Accordion>
<Accordion title="Posta di Outlook non disponibile">
Tillor non è riuscito a caricare la posta da Outlook. Riprova con **Aggiorna** oppure controlla il collegamento.
</Accordion>
<Accordion title="Non è stato possibile cercare in alcune caselle">
L'account collegato non ha accesso a quella casella. Controlla le autorizzazioni della casella in Outlook.
</Accordion>
<Accordion title="Non vedo la scheda Outlook sul profilo del cliente">
Outlook non è collegato, oppure ti manca il permesso **Visualizza inbox**.
</Accordion>
<Accordion title="Impossibile caricare questo messaggio">
Prova ad aprire di nuovo il messaggio. Se non basta, vai al messaggio stesso con **Apri in Outlook**.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" description="Il profilo del cliente e le sue schede" />
  <Card title="Integrazioni" href="/integraties" description="Tutti i collegamenti disponibili" />
</Cards>


# Collegare Partoo (/it-IT/integraties/partoo)

Partoo gestisce le tue schede su Google e su altri siti. Con questo collegamento Tillor invia i tuoi orari di apertura alla tua sede Partoo, così non devi aggiornarli in due posti. Gli orari li gestisci in Tillor, vedi [Impostazioni dell'organizzazione](/gebruikers/organisaties#openingsuren).

<Requires permission="Gestisci integrazioni" />

Prima di iniziare:

- Crea in Partoo un utente separato per Tillor, senza accesso in due passaggi. Con l'autenticazione in due passaggi Tillor non può accedere.
- Inserisci i tuoi orari di apertura in Tillor, vedi il paragrafo Orari di apertura nelle impostazioni dell'organizzazione.

## Installare [#installeren]

<Steps>
<Step>
### Apri l'integrazione [#open-de-integratie]
Vai su <UIPath>Impostazioni > Integrazioni > Partoo</UIPath>.
</Step>
<Step>
### Inserisci i dati dell'utente Partoo [#vul-de-gegevens-van-de-partoo-gebruiker-in]
Inserisci l'**E-mail** e la **Password** di quell'utente.
</Step>
<Step>
### Scegli la tua sede [#kies-je-vestiging]
L'elenco delle sedi compare solo dopo aver inserito e-mail e password. Scegli la tua sede sotto **Sede**. Digita per cercare in **Cerca sedi…**.
</Step>
<Step>
### Fai clic su Installare [#klik-op-installeren]

<DocScreenshot src="/screenshots/integraties/integrations-partoo.png" alt="Installare Partoo" />
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Tillor invia i tuoi orari settimanali, le stagioni e i giorni eccezionali dagli [orari di apertura della tua organizzazione](/gebruikers/organisaties#openingsuren):

- Gli orari settimanali sono quelli della settimana corrente. Partoo non conosce le stagioni, quindi Tillor invia gli orari della stagione in corso.
- I giorni dei prossimi 90 giorni con orari diversi, come un'altra stagione, un giorno festivo o un'eccezione, vengono inviati come date separate. Un periodo di chiusura diventa un unico periodo.
- Tillor invia tutto questo ogni notte e subito dopo ogni modifica agli orari di apertura, al fuso orario, al paese predefinito o al collegamento stesso. Viene aggiornato solo ciò che differisce da Partoo.

## Modificare o rimuovere [#aanpassen-of-verwijderen]

Modifica e-mail, password o sede nel blocco **Impostazioni**. Lascia vuota la password per mantenere quella attuale. Con **Disinstalla** l'invio si interrompe. Ciò che si trova già in Partoo resta lì.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Partoo ha rifiutato questa email o password">
Controlla i dati dell'utente Partoo. Se quell'utente ha l'accesso in due passaggi attivo, disattivalo oppure crea un utente separato.
</Accordion>
<Accordion title="Questo utente Partoo non vede nessuna sede">
In Partoo dai all'utente Partoo accesso alla tua sede e poi guarda di nuovo.
</Accordion>
<Accordion title="Impossibile caricare le sedi da Partoo">
Riprova tra poco. Se il problema persiste, scrivi a support@tillor.eu.
</Accordion>
<Accordion title="Gli orari su Google non sono corretti">
Controlla prima gli orari di apertura in Tillor, il fuso orario e il paese predefinito. Dopo una modifica Tillor li invia subito, e poi di nuovo ogni notte.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni dell'organizzazione" href="/gebruikers/organisaties" description="Orari di apertura, stagioni ed eccezioni" />
  <Card title="Integrazioni" href="/integraties" description="Tutti i collegamenti disponibili" />
</Cards>


# Collegare UniFi Protect (/it-IT/integraties/unifi-protect)

Con il collegamento a UniFi Protect, da un tentativo di accesso o da un evento di un punto di accesso arrivi con un clic alla registrazione della telecamera corrispondente. I pagamenti in contanti e con carta possono inoltre scorrere come testo sulle immagini di una telecamera, così in caso di differenza di cassa puoi riguardare le riprese. L'installazione è uguale a quella di ogni integrazione, vedi [Installare un'integrazione](/integraties/integratie-installeren).

<Requires permission="Gestisci integrazioni" />

Prima di iniziare:

- Le telecamere vengono lette tramite il [connettore](/connector) nel tuo parco. Deve essere online. Se non lo è, Tillor segnala **Il connettore Tillor è offline o non raggiungibile.**
- Ti servono i dati della tua console UniFi OS. È il dispositivo o il server su cui gira UniFi Protect.
- Per il collegamento con i punti di accesso, questi devono esistere, vedi [Controllo accessi](/toegangscontrole).

## Installare [#installeren]

<Steps>
<Step>
### Apri l'integrazione [#open-de-integratie]
Vai su <UIPath>Impostazioni > Integrazioni > UniFi Protect</UIPath>.
</Step>
<Step>
### Inserisci la console [#vul-de-console-in]
- **Host console**: l'indirizzo IP locale o il nome host della tua console UniFi OS.
- **Chiave API**: un codice segreto che crei nella console, con cui Tillor può leggere le telecamere.
- **ID console cloud**: il lungo ID dopo `/consoles/` nell'URL unifi.ui.com della tua console.
</Step>
<Step>
### Scegli le telecamere dei pagamenti [#kies-de-betaalcameras]
Sotto **Telecamera pagamenti contanti** e **Telecamera pagamenti POS** scegli una telecamera, oppure lascia **Non registrare**. POS è il terminale di pagamento con carta.
</Step>
<Step>
### Fai clic su Installare [#klik-op-installeren]
Non appena host e chiave API sono inseriti, Tillor carica le telecamere della console.

<DocScreenshot src="/screenshots/integraties/integrations-unifi-protect.png" alt="Installare UniFi Protect" />
</Step>
</Steps>

## Collegare le telecamere ai punti di accesso [#cameras-koppelen-aan-toegangspunten]

Dopo l'installazione, nel blocco **Impostazioni** trovi la tabella **Telecamere per punto di accesso**. Collega ogni **Punto di accesso** a una **Telecamera**. Se l'elenco è vuoto, aggiungi prima dei punti di accesso.

Poi, nei dettagli di un tentativo di accesso e di un evento di un punto di accesso compare il link **Apri in UniFi Protect**. Apre in UniFi Protect, in una nuova scheda, la registrazione di quel momento.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Se hai scelto una telecamera sotto **Telecamera pagamenti contanti** o **Telecamera pagamenti POS**, Tillor invia a quella telecamera ogni pagamento che passa a **Pagato**. I pagamenti in contanti alla telecamera dei contanti, i pagamenti con carta su un terminale alla telecamera POS.
- I pagamenti effettuati più di 24 ore fa non vengono più mostrati come testo sulle immagini.
- I pagamenti tramite Mollie contano solo se appartengono al profilo principale di Mollie.
- Se modifichi i dati, salva. Se lasci vuota la **Chiave API**, resta valida quella esistente. Con **Disinstalla** rimuovi il collegamento.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Nessuna telecamera trovata su questa console UniFi Protect">
La console non ha telecamere, oppure la chiave API non vi ha accesso. Controlla la chiave e se le telecamere sono visibili in UniFi Protect.
</Accordion>
<Accordion title="Impossibile recuperare le telecamere da UniFi Protect">
Controlla l'host, la chiave API e se il connettore è online. Tillor segnala: **Controlla host, chiave API e connettore.**
</Accordion>
<Accordion title="Il connettore Tillor è offline o non raggiungibile">
Le telecamere vengono caricate tramite il connettore sulla tua rete locale. Avvia il connettore o ripristina la connessione, vedi [Connettore](/connector).
</Accordion>
<Accordion title="Non vedo Apri in UniFi Protect in un tentativo di accesso">
A quel punto di accesso non è collegata nessuna telecamera. Collegane una nella tabella **Telecamere per punto di accesso**.
</Accordion>
<Accordion title="Il pagamento non compare sulle immagini">
Controlla che la telecamera sotto **Telecamera pagamenti contanti** o **Telecamera pagamenti POS** non sia su **Non registrare**. Un pagamento effettuato più di 24 ore fa non ha più l'overlay. Un pagamento Mollie conta solo per il profilo principale.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Controllo accessi" href="/toegangscontrole" description="Registro accessi e punti di accesso" />
  <Card title="Connettore" href="/connector" description="Il collegamento con la tua rete locale" />
  <Card title="Integrazioni" href="/integraties" description="Tutti i collegamenti disponibili" />
</Cards>


# Mappa (/it-IT/kaart)

Sulla mappa vedi a colpo d'occhio quali terreni sono liberi, prenotati o occupati, per ogni giorno che scegli. Qui disegni anche i confini dei tuoi terreni, così Tillor ne conosce la superficie, e misuri le distanze. I terreni stessi li gestisci sotto [Terreni](/terreinen).

<Callout type="info" title="Da sapere">
- La mappa si apre sempre sul giorno di oggi. Lo stile, le etichette e i livelli vengono invece conservati.
- Le prenotazioni con check-out effettuato e quelle annullate non contano per il colore, l'etichetta di partenza o la doppia prenotazione.
- Le etichette con notti e partenza scompaiono sotto il livello di zoom 17,5. Il nome del terreno resta.
- Un terreno senza confine disegnato non compare sulla mappa. Si può disegnare solo con la **Modalità modifica** attiva.
- La mappa si apre sul centro mappa che imposti sotto **Impostazioni > Mappa**. Lo stesso punto determina anche il meteo.
</Callout>

## Aprire la mappa [#de-kaart-openen]

Vai su <UIPath>Parco > Mappa</UIPath>. Vedi subito tutti i terreni con il loro stato di occupazione.


<DocScreenshot src="/screenshots/park/map-overview.png" alt="Mappa con il terreno 12 disegnato" />

- **Area verde** - terreno prenotabile libero
- **Area grigia** - il terreno è **non prenotabile** e nella data scelta non ha un soggiorno attivo (nessuna prenotazione o occupazione); mancano le etichette di notti e partenza
- **Area ciano** - prenotazione **prenotata**, check-in non ancora effettuato (anche nei giorni successivi del periodo di soggiorno finché non è stato fatto il check-in)
- **Area blu** - prenotazione con **check-in effettuato** (soggiorno attivo nella data scelta)
- **Area gialla** - il terreno ha un'occupazione attiva (affitto a lungo termine; vale per ogni data scelta finché l'occupazione è in corso)
- **Area rossa** (overlay chiaro, bordo rosso) - doppia prenotazione: periodi di prenotazione sovrapposti sullo stesso terreno

Fai clic su un terreno sulla mappa per aprire un pop-up con il nome, le prenotazioni, l'eventuale occupazione attiva (ospite) e le scorciatoie.

## Scegliere la data [#datum-kiezen]

A destra di **Impostazioni mappa** scegli una **data** (di default oggi). La mappa mostra allora come sono i terreni in quel giorno. Dopo aver aggiornato la pagina la data torna a **oggi**; solo le altre impostazioni della mappa (stile, etichette, livelli) vengono conservate. Le prenotazioni con **check-out effettuato** e quelle **annullate** non contano per il colore, l'etichetta di partenza o la doppia prenotazione (non compaiono nemmeno nel pop-up sulla mappa). Per le piazzole libere, sotto il nome del terreno c'è un'etichetta con l'icona della luna e il numero di notti fino al prossimo check-in. Per una prenotazione o un'occupazione con data di partenza c'è un'etichetta con l'icona di partenza e il numero di notti fino al check-out (0 = oggi). Passa il mouse su un'etichetta per vedere il testo completo. In caso di **doppia prenotazione** (due o più prenotazioni con periodi di soggiorno sovrapposti sullo stesso terreno) il terreno ottiene un bordo rosso e un leggero overlay rosso; davanti al numero del terreno compare un'icona a triangolo rosso. Nel pop-up vedi un avviso con le prenotazioni coinvolte. Sotto il livello di zoom **17,5** la mappa nasconde automaticamente le etichette di notti e partenza; il nome del terreno resta visibile. Ingrandisci almeno fino a **17,5** (oppure disattiva **Notti e check-out** nelle impostazioni della mappa) per vedere quelle etichette. Quando si riduce lo zoom, i nomi dei terreni vengono mostrati più piccoli così si sovrappongono meno.

## Livelli e colori [#lagen-en-kleuren]

In basso a sinistra ci sono tre pulsanti: **Livelli**, **Esporta PDF** e **Impostazioni mappa**, con a destra il selettore della data. Con **Livelli** decidi cosa vedere e come sono colorati i terreni.

<DocScreenshot src="/screenshots/instellingen/map-layers.png" alt="Mappa con il pannello Livelli" />

- Sotto **Colori** scegli **Occupazione** o **Tipo di terreno**. Con **Occupazione** i terreni sono colorati come descritto sopra. Con **Tipo di terreno** ogni terreno ottiene il **Colore mappa** del suo tipo, vedi [Tipi di terreno](/terreinen#terreintypes).
- Con **Occupazione**, sotto **Livelli terreni** c'è una spunta per ogni genere: **Libero**, **Prenotato**, **Check-in effettuato**, **Occupato**, **Non prenotabile** e **Doppia prenotazione**. Togli una spunta per nascondere quei terreni.
- Sotto **Tipi di terreno** scegli quali tipi compaiono sulla mappa. **Nessun tipo** corrisponde ai terreni senza tipo.

Con **Esporta PDF** scarichi un PDF con i terreni che sono ora sulla mappa: nome, superficie, gas e tariffa calcolata, nella data scelta.

## Impostazioni mappa [#kaartinstellingen]

Con **Impostazioni mappa** modifichi la visualizzazione.

<DocScreenshot src="/screenshots/instellingen/map-settings.png" alt="Mappa con il pannello Impostazioni mappa" />

| Impostazione | Descrizione |
|------------|--------------|
| **Stile** | **Satellite**, **Ibrido** o **Strade** |
| **Modalità modifica** | Mostra gli strumenti per disegnare e modificare i confini dei terreni |
| **Nomi terreni** | Mostra i nomi dei terreni sulla mappa. Funziona solo se almeno un livello è attivo |
| **Notti e check-out** | Mostra accanto ai nomi dei terreni quante notti sono libere e quando parte un soggiorno. Funziona solo se **Nomi terreni** è attivo |

Le tue impostazioni vengono salvate automaticamente.

## Impostare il valore predefinito della mappa [#kaartstandaard-instellen]

<Requires permission="Modifica impostazioni" />

Sotto <UIPath>Assistenza > Impostazioni > Mappa</UIPath> stabilisci dove si apre la mappa e come è orientata.

<DocScreenshot src="/screenshots/instellingen/settings-map.png" alt="Impostazioni > Mappa" />

| Impostazione | Descrizione |
|---|---|
| **Centro mappa** | Fai clic sulla mappa o trascina il segnaposto al centro del tuo parco. Sotto trovi le coordinate. |
| **Orientamento mappa** | La direzione della bussola in gradi (0-360) con cui si apre la mappa. |

Il centro mappa conta anche fuori dalla mappa. È il luogo per cui viene recuperato il meteo sotto <UIPath>Parco > Meteo</UIPath>, e i suggerimenti di indirizzo quando inserisci un indirizzo danno la precedenza ai luoghi vicini. Se in **Apple Wallet** non hai impostato una **Posizione sbarra**, Apple Wallet e Google Wallet usano il centro mappa per il pass di accesso. Vedi [Organizzazione](/gebruikers/organisaties#apple-wallet). Se il centro è nel posto sbagliato, anche il meteo non è corretto.

## Disegnare i confini dei terreni [#terreingrenzen-intekenen]

Con la modalità modifica fissi il confine esatto di un terreno sulla mappa. Tillor ne calcola la superficie in m², che viene usata dalla formula della tariffa.

1. Vai su **Parco > Mappa**
2. Fai clic su **Impostazioni mappa** in basso a sinistra
3. Attiva **Modalità modifica**
4. Fai clic sui punti desiderati sulla mappa per disegnare un poligono
5. Chiudi il poligono facendo clic sul punto iniziale
6. Nella finestra di dialogo seleziona il terreno che vuoi collegare

<DocScreenshot src="/screenshots/park/map-terrain-select-dialog.png" alt="Finestra di collegamento del terreno dopo aver disegnato il poligono" />

7. Fai clic su **"Aggiorna"**

Il terreno compare ora come area colorata sulla mappa.

<Callout type="info">
I terreni senza posizione disegnata compaiono in cima all'elenco di scelta, così puoi trovarli e collegarli facilmente.
</Callout>

## Misurare le distanze [#afstanden-meten]

Con la funzione di misura puoi misurare rapidamente distanze e superfici sulla mappa - utile per organizzare il terreno o stimare le distanze tra le posizioni.

1. Fai clic in alto a sinistra sulla mappa su **Misura distanza** o **Misura area**
2. Posiziona dei punti sulla mappa (chiudi una superficie facendo clic sul punto iniziale)
3. La misurazione viene mostrata sulla mappa; usa **Cancella misurazioni** per ricominciare

## Aprire un terreno dalla mappa [#een-terrein-openen-vanaf-de-kaart]

Dalla mappa puoi raggiungere rapidamente un terreno:

1. Fai clic su un terreno sulla mappa
2. Il pop-up mostra il nome, lo stato di occupazione, le prenotazioni attive e, in caso di occupazione, l'ospite
3. Fai clic su **"Visualizza dettagli"** per andare alla pagina dei dettagli
4. Finché non c'è un'occupazione attiva, puoi avviare **"Crea prenotazione"**

## Cosa succede dopo il disegno? [#wat-gebeurt-er-na-het-intekenen]

- Il terreno ottiene un colore sulla mappa e Tillor compila la **Superficie** nella pagina del terreno.
- La **Tariffa calcolata** viene ricalcolata, perché la superficie conta. Vedi [Terreni](/terreinen#hoe-het-tarief-tot-stand-komt).
- La **Superficie totale** in cima all'elenco dei terreni da ora include il terreno.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il mio terreno non compare sulla mappa">
Il terreno non ha ancora un confine disegnato. Attiva la **Modalità modifica**, disegna il terreno e sceglilo nella finestra di dialogo. I terreni senza posizione sono in cima all'elenco di scelta. Se il terreno c'è, controlla sotto **Livelli** se il livello del suo stato è attivo.
</Accordion>
<Accordion title="Mancano le etichette con notti e partenza">
Ingrandisci almeno fino al livello 17,5 e controlla in **Impostazioni mappa** che siano attivi sia **Nomi terreni** sia **Notti e check-out**. I terreni grigi, non prenotabili e senza soggiorno non hanno mai una simile etichetta.
</Accordion>
<Accordion title="La mappa si apre nel posto sbagliato o mostra il meteo sbagliato">
Il centro mappa è sbagliato. Sposta il segnaposto sotto <UIPath>Assistenza > Impostazioni > Mappa</UIPath>.
</Accordion>
<Accordion title="Non vedo Crea prenotazione nel pop-up">
Quella voce c'è solo se il terreno non ha un'occupazione attiva.
</Accordion>
<Accordion title="La mappa mostra la data di oggi, anche dopo la mia scelta">
La data scelta non viene conservata. Dopo un aggiornamento la mappa torna a oggi.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Terreni" href="/terreinen" description="Creare terreni, tariffa e contatori" />
  <Card title="Prenotazioni" href="/reserveringen" description="Pianifica e gestisci i soggiorni" />
  <Card title="Parco" href="/park" description="Panoramica della gestione del parco" />
</Cards>


# Gestione clienti (/it-IT/klantenbeheer)

Un cliente è il posto in Tillor dove confluisce tutto su una persona o un'azienda: dati, persone di contatto, fatture, occupazioni, prenotazioni, documenti e accessi. Crei un cliente, lo ritrovi nell'elenco e aggiorni i suoi dati sul profilo del cliente. Inizia da [Aggiungere un nuovo cliente](#een-nieuwe-klant-toevoegen).

<Callout type="info" title="Da sapere">
- Alla creazione è obbligatorio solo il **Nome di battesimo**. Tutti gli altri dati li completi più tardi sul profilo del cliente.
- Tillor avvisa in caso di **possibile cliente duplicato** se nome e cognome insieme, l'indirizzo e-mail o il numero di telefono sono già presenti per un altro cliente. Un indirizzo e-mail o un numero di telefono contano a partire da 4 caratteri.
- I suggerimenti di indirizzo compaiono a partire da 3 caratteri digitati nel campo **Via**.
- Le scansioni dei documenti d'identità senza cliente collegato vengono eliminate da Tillor dopo 7 giorni.
- Eliminare un cliente rimuove anche tutti i dati correlati e non può essere annullato.
</Callout>

## Come è collegato tutto? [#hoe-hangt-dit-samen]

Tutto ciò che registri in Tillor è legato a un cliente. Un'occupazione collega il cliente a un terreno, e quindi anche ai contatori su quel terreno. Il consumo di quei contatori finisce sulla fattura del cliente.

```mermaid
flowchart LR
  K[Cliente] --> C[Persone di contatto]
  K --> R[Prenotazioni]
  K --> B[Occupazioni]
  B --> T[Terreno]
  T --> M[Contatori]
  M --> V[Consumo]
  V --> F[Fatture]
  K --> F
  F --> P[Pagamenti]
  K --> D[Documenti e richieste di firma]
  K --> O[Commenti e attività]
```

## Aggiungere un nuovo cliente [#een-nieuwe-klant-toevoegen]

Prima di iniziare:

- Una scansione d'identità, se vuoi creare il cliente con quella. Se non c'è nessuna scansione in coda, scegli semplicemente l'inserimento manuale.
- Non sei sicuro che il cliente esista già? Cercalo prima nell'elenco, vedi [Cercare e filtrare i clienti](#klanten-zoeken-en-filteren).

<Steps>
<Step>
### Apri l'elenco dei clienti [#open-de-klantenlijst]
Vai su <UIPath>Clienti > Panoramica</UIPath> e fai clic in alto a destra su **Crea nuovo cliente**. Finché ci sono scansioni d'identità in sospeso, il pulsante mostra un menu con **Manuale** e le scansioni in coda.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Crea nuovo cliente con il menu per una scansione d'identità in sospeso" />
</Step>
<Step>
### Scegli come creare il cliente [#kies-hoe-je-de-klant-aanmaakt]
<Tabs items={["Manualmente", "Da una scansione d'identità"]}>
<Tab value="Manualmente">
Scegli **Manuale**. Si apre un modulo con **Nome di battesimo**, **Cognome**, **Indirizzo e-mail** e **Numero di telefono**. Compila ciò che sai e fai clic su **Crea cliente**. Se esiste forse già un cliente con dati simili, in basso compare un avviso giallo con un link a quel cliente.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Finestra Crea nuovo cliente (Manuale)" />
</Tab>
<Tab value="Da una scansione d'identità">
Scegli una scansione dal menu, per esempio **Lotte Peeters**. Nella conferma vedi un'anteprima del documento (fronte, retro, ritratto) e i dati della zona a lettura ottica. Fai clic su **Crea cliente**. Tillor crea il cliente, collega la scansione e compila i dati dal documento.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Conferma dopo la scelta di una scansione d'identità in sospeso" />

Le scansioni in sospeso compaiono anche nel pannello in basso a destra, con **Crea cliente dalla scansione**. Altro sulle scansioni lo trovi in [Scansioni d'identità](/identiteitsscans).

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Pannello in basso a destra con una scansione d'identità in sospeso" />
</Tab>
</Tabs>
</Step>
<Step>
### Controlla se c'è un cliente duplicato [#controleer-op-een-dubbele-klant]
Se esiste forse già un cliente con lo stesso nome, lo stesso indirizzo e-mail o lo stesso numero di telefono, Tillor mostra **Possibile cliente duplicato** con il nome e il numero cliente. Fai clic su **Usa questo cliente** per aprire quel cliente, oppure su **Crea comunque** se è davvero un'altra persona.
</Step>
</Steps>

<Callout type="warn" title="Periodo di conservazione e responsabilità">
Le scansioni senza cliente collegato vengono eliminate da Tillor **automaticamente dopo 7 giorni**. Elaborale in tempo.

Per le scansioni **collegate**, il periodo di conservazione e la base giuridica li stabilisce **la tua organizzazione**. Tillor le conserva finché non le scolleghi o le elimini. Il rispetto della normativa sulla privacy e i periodi di conservazione adeguati sono **una tua responsabilità** come titolare del trattamento.
</Callout>

### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Arrivi sul nuovo profilo del cliente, dove compili il resto: indirizzo, partita IVA, persone di contatto e campi personalizzati.
- Se il cliente è stato creato da una scansione, quella scansione appartiene al cliente e non è più in coda.
- La creazione compare come prima riga nella scheda **Eventi** del cliente.
- Se vuoi che succeda subito qualcosa con un nuovo cliente, per esempio una e-mail di benvenuto, usa un'[automazione](/automatiseringen).

## Controllare una partita IVA [#een-btw-nummer-controleren]

Nella scheda **Panoramica**, nel blocco **Dati del cliente**, inserisci la **Partita IVA**. Tillor controlla il numero nel registro europeo VIES non appena è compilato anche **Paese** e il numero è abbastanza lungo.

- Se il numero è valido, vedi una spunta verde e una finestra con la ragione sociale ufficiale e l'indirizzo da VIES. Fai clic su **Applicare l'indirizzo dell'azienda** per riportare quell'indirizzo nel modulo.
- Se il numero non è valido, vedi un'icona rossa e un messaggio di errore.

## Il profilo del cliente [#het-klantprofiel]

Quando fai clic su un cliente, vedi il profilo del cliente. In alto ci sono i dati riassuntivi del cliente, con sotto i commenti fissati. Con le schede raggiungi il resto.

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Profilo del cliente - blocco Dati del cliente" />

| Scheda | Cosa trovi |
|---|---|
| **Panoramica** | Dati del cliente (modulo modificabile), comunicazioni recenti, fatture, letture, commenti, occupazioni e notifiche |
| **Fatturazione** | Tutte le fatture di questo cliente e il [saldo per conto](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) |
| **Controllo accessi** | Diritti di accesso e targhe |
| **Contatti** | Persone di contatto aggiuntive |
| **Tag NFC** | Tag NFC collegati |
| **Prenotazioni** | Tutte le prenotazioni |
| **Comunicazioni** | Messaggi e cronologia delle comunicazioni |
| **Outlook** | Posta da e per il cliente dalle tue caselle Outlook. Questa scheda compare solo se [Outlook](/integraties/outlook) è collegato e puoi **Visualizza inbox** |
| **Eventi** | Cronologia con le modifiche, inclusa la creazione di cliente o contatto, l'assegnazione o lo scollegamento di un documento d'identità, e prima/dopo per gli aggiornamenti di cliente, contatto, impostazioni di fatturazione e metodo di accesso |
| **Documenti** | File e allegati salvati, e le [richieste di firma](/handtekeningen) |
| **Attività** | Attività collegate a questo cliente |

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Profilo del cliente - scheda Controllo accessi con i metodi di accesso" />

### A colpo d'occhio [#in-één-oogopslag]

Nella scheda **Panoramica**, in alto a sinistra, c'è la scheda **A colpo d'occhio**. Mostra solo ciò che in quel momento richiede attenzione e si chiude quando non c'è nulla da mostrare:

- **Prenotazioni attive** e **Prossime prenotazioni**, con un pulsante **Visualizza prenotazione**
- **Contatori attivi con allarmi**
- **Attività aperte** di questo cliente
- **Scansioni d'identità** di questo cliente

<DocScreenshot src="/screenshots/klanten/customer-key-info.png" alt="Profilo del cliente - scheda A colpo d'occhio" />

Gli stessi dati li vedi nella scheda di una chiamata in arrivo. Un commento che fissi compare direttamente sotto i dati del cliente in alto nel profilo. Vedi [Commenti](/notities#opmerking-vastzetten).

### Compleanni [#verjaardagen]

Se oggi è il compleanno del cliente o del suo partner, in alto nel profilo del cliente compare un blocco verde **Compleanno oggi**, con il nome e l'età, e sulla pagina cadono dei coriandoli. Per il cliente la data proviene dal campo **Data di nascita**. Il partner è il contatto con la relazione **Partner**. Una data di nascita del 29 febbraio, negli anni senza giorno bisestile, conta il 28 febbraio.

## Modificare i dati del cliente [#klantgegevens-bewerken]

Nella scheda **Panoramica**, nel blocco **Dati del cliente**, modifichi i campi. In fondo al modulo ci sono **Annulla** e **Salva**. Ogni modifica compare nella scheda **Eventi**, con un riepilogo **Prima / dopo** per campo, così puoi vedere esattamente cosa è stato cambiato.

Se la tua organizzazione ha creato dei [campi personalizzati](/eigen-velden) per i clienti, compaiono come campi aggiuntivi nello stesso blocco.

### Compilare l'indirizzo [#adres-invullen]

L'indirizzo è composto da **Via**, **N.** e **Interno**, seguiti da **CAP**, **Luogo** e **Paese**.

<DocScreenshot src="/screenshots/klanten/customer-address-input.png" alt="Campo indirizzo con via, numero e interno" />

- Se digiti almeno tre caratteri della via, Tillor propone degli indirizzi. Scegline uno: vengono compilati via, numero, CAP, luogo e paese. I suggerimenti provengono da OpenStreetMap, un database cartografico gratuito.
- Se digiti **Kerkstraat 5** nel campo **Via**, il numero passa automaticamente a **N.**. Uno spazio dopo il numero ti porta a **Interno**. Se incolli un indirizzo completo, viene suddiviso allo stesso modo. Nei paesi in cui il numero precede la via, il numero non viene spostato automaticamente.
- Se CAP o luogo sono già compilati, Tillor controlla l'indirizzo. Una spunta verde con **Indirizzo trovato** significa che l'indirizzo esiste. Un'icona gialla con **Grafia suggerita** mostra l'ortografia abituale. Fai clic su **Aggiorna indirizzo** per adottarla.
- L'indirizzo viene conservato come un'unica riga, per esempio sulle fatture e nelle esportazioni.

I suggerimenti sono un aiuto, non un obbligo. Puoi sempre compilare tu qualcosa.

## Cercare e filtrare i clienti [#klanten-zoeken-en-filteren]

Vai su <UIPath>Clienti > Panoramica</UIPath>. In alto c'è una barra di ricerca.

<DocScreenshot src="/screenshots/klanten/customers-list.png" alt="Elenco dei clienti con barra di ricerca" />

- Digita un nome, un indirizzo e-mail, un numero di telefono o un numero cliente.
- I risultati si aggiornano mentre digiti, con un breve ritardo.
- Puoi anche filtrare per **Creata** (intervallo di date), **Stato** e **Tipo**.

## Eliminare un cliente [#een-klant-verwijderen]

Usa **Elimini cliente** nel menu in alto nel profilo del cliente. Tillor chiede **È sicuro di voler eliminare questo cliente?** Se confermi, vengono rimossi anche tutti i dati correlati. Questa operazione non può essere annullata.

## Scenari frequenti [#veelvoorkomende-scenarios]

### Un nuovo cliente prenota per la prima volta [#een-nieuwe-klant-boekt-voor-het-eerst]

1. Il cliente telefona o prenota online.
2. Aggiungi il cliente con **Crea nuovo cliente**.
3. Compili indirizzo e altri dati sul profilo del cliente (scheda **Panoramica** > **Dati del cliente**).
4. Crei un'occupazione sul terreno desiderato, vedi [Occupazioni](/bezettingen#een-bezetting-aanmaken).
5. Il consumo dei contatori collegati lo registra Tillor automaticamente. Lo vedi sotto **Letture** in **Panoramica**.

### Modificare i dati del cliente [#klantgegevens-wijzigen]

Apri il profilo del cliente, modifica l'indirizzo nel modulo e fai clic su **Salva**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice: Cliente non creato">
Il messaggio è **Impossibile creare il cliente.** Controlla che il **Nome di battesimo** sia compilato e che l'indirizzo e-mail sia valido, con una chiocciola e un dominio. Poi riprova.
</Accordion>
<Accordion title="Tillor dice: Possibile cliente duplicato">
Esiste già un cliente con lo stesso nome e cognome, lo stesso indirizzo e-mail o lo stesso numero di telefono. Fai clic su **Usa questo cliente** se è la stessa persona, oppure su **Crea comunque** se è un'altra persona.
</Accordion>
<Accordion title="Tillor dice: Qualcosa è andato storto. Impossibile aggiornare il cliente">
Le tue modifiche non sono state salvate. Controlla nel modulo se c'è un indirizzo e-mail non valido o un campo obbligatorio vuoto e fai di nuovo clic su **Salva**.
</Accordion>
<Accordion title="La scansione non è nel menu di Crea nuovo cliente">
Contano come in sospeso solo le scansioni senza cliente collegato. Se la scansione è già collegata a un cliente, o ha più di 7 giorni, non compare più. Vedi [Scansioni d'identità](/identiteitsscans).
</Accordion>
<Accordion title="Crea cliente dalla scansione è grigio">
Accanto alla scansione c'è il motivo. Di solito la scansione non ha un nome: *compilalo sullo scanner oppure collega questa scansione manualmente*. Oppure esiste già un cliente con lo stesso numero di registro nazionale. Apri quel cliente e collega la scansione a lui.
</Accordion>
<Accordion title="Tillor dice: Partita IVA non valida">
Il numero non è valido o non è registrato in VIES. Controlla che il **Paese** sia corretto e che il numero sia completo. Tillor segnala anche **La partita IVA deve contenere almeno ... caratteri** se il numero è troppo corto per il paese scelto, e chiede sia un numero sia un paese se ne manca uno dei due.
</Accordion>
<Accordion title="Non vedo la scheda Outlook">
La scheda compare solo se [Outlook](/integraties/outlook) è collegato e hai il permesso **Visualizza inbox**.
</Accordion>
<Accordion title="Non compaiono suggerimenti di indirizzo">
Digita almeno tre caratteri nel campo **Via**. Se i suggerimenti non compaiono, compila semplicemente l'indirizzo tu.
</Accordion>
</Accordions>

## Glossario [#begrippen]

- **Cliente**: il record in Tillor di una persona o un'azienda. Vedi [cliente](/begrippen#klant).
- **Persona di contatto**: una persona aggiuntiva di un cliente, per esempio un partner o un contatto di emergenza.
- **Occupazione**: un cliente su un terreno per un periodo. Vedi [occupazione](/begrippen#bezetting).
- **Prenotazione**: una prenotazione per un soggiorno. Vedi [prenotazione](/begrippen#reservering).
- **Eventi**: la cronologia con tutte le modifiche di un cliente. Vedi [evento](/begrippen#gebeurtenis).
- **VIES**: il registro europeo in cui Tillor controlla una partita IVA.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Scansioni d'identità" href="/identiteitsscans" description="Creare un cliente da una scansione, periodo di conservazione e connettore" />
  <Card title="Occupazioni" href="/bezettingen" />
  <Card title="Prenotazioni" href="/reserveringen" />
  <Card title="Fatture" href="/facturen" />
  <Card title="Terreni" href="/terreinen" />
  <Card title="Acquisire un cliente stagionale" href="/praktijk/seizoensklant-binnenhalen" />
</Cards>


# Allarmi e stato dei contatori (/it-IT/meterbeheer/alarmen-en-status)

Un contatore genera un allarme quando segnala un'anomalia, come un problema di connessione o un guasto tecnico. Qui leggi dove lo vedi, cosa significa l'indicatore di stato e come cancellare un allarme.

## Seguire un allarme [#een-alarm-opvolgen]

<Steps>
<Step>
### Trova il contatore con un allarme [#zoek-de-meter-met-een-alarm]
Vai su <UIPath>Parco > Contatori</UIPath>. Un contatore con un allarme attivo ha un triangolino.
</Step>
<Step>
### Apri il contatore e leggi l'allarme [#open-de-meter-en-lees-het-alarm]
Nell'elenco degli allarmi vedi, per ogni allarme, il messaggio, **Iniziato il** e se è Attivo o Risolto. Il messaggio dipende dal tipo di contatore e dal provider.
</Step>
<Step>
### Risolvi il problema [#los-het-probleem-op]
Controlla la batteria e il segnale nei dettagli del contatore e, se necessario, vai a controllare il contatore.
</Step>
<Step>
### Cancella l'allarme [#wis-het-alarm]
Nel menu azioni del contatore scegli **Cancella allarmi**.
</Step>
</Steps>

## Cosa significa lo stato [#wat-de-status-betekent]

- **Indicatore di stato**: i contatori intelligenti (ICY e Tillor Hydrodigit) mostrano se hanno comunicato di recente e se ci sono allarmi. L'indicatore cambia colore in caso di allarme attivo o se il contatore non invia nulla da più di un giorno.
- **Livello della batteria** e **qualità del segnale**: in percentuale nei dettagli del contatore, per i contatori che li trasmettono.

## Controller ICY [#icy-controllers]

I moduli ICY sulle piazzole comunicano tramite un controller nel locale contatori. Se un controller si ferma, nessun contatore collegato a quel controller invia più nulla.

Se il tuo parco ha contatori ICY, in <UIPath>Parco > Contatori</UIPath> sopra l'elenco trovi la scheda **Controller ICY**. Indica quanti controller ci sono, quanti non sono stati visti da ICY nell'ultima ora e quanti allarmi sono aperti sui controller. Fai clic su **Mostra** per la tabella:

- **Controller**: il nome del locale contatori in cui si trova la maggior parte dei contatori del controller, con un pallino verde o rosso. Se il nome in ICY è diverso, compare accanto in grigio. Se i contatori non si trovano in nessun locale contatori, vedi solo il nome di ICY.
- **Contatori**: quanti dei tuoi contatori comunicano tramite questo controller. In un contatore stesso, quel nome compare sotto **Controller** nella scheda **Informazioni**.
- **Allarmi**: gli allarmi che ICY segnala sul controller stesso, con l'indicazione da quando. Un allarme scompare dall'elenco non appena ICY non lo segnala più; non devi cancellarlo. Un allarme che Tillor non conosce ancora per nome compare come **Allarme sconosciuto** con il codice di ICY. Chi riceve le notifiche push per gli allarmi dei contatori riceve una notifica anche per un allarme nuovo e per uno risolto su un controller.
- **Ultima connessione**: quando ICY ha visto il controller l'ultima volta. Se è più di un'ora fa, l'ora è in rosso.

Un controller con un allarme o un controller fermo da più di un'ora compare in cima, e in quel caso la scheda si apre da sola.
Tillor aggiorna l'elenco ogni volta che i contatori ICY vengono letti.

## Se tutti i tuoi contatori si fermano insieme [#als-al-je-meters-tegelijk-stilvallen]

I contatori Tillor Hydrodigit e Tillor EM300 inviano la loro lettura a Tillor tramite un ricevitore, il gateway LoRa. Normalmente inviano una misurazione circa due volte al giorno. Se ogni contatore LoRa della tua organizzazione attivo di recente non ha inviato nulla da più di 24 ore, probabilmente il problema è il gateway o la connessione con Tillor e non i contatori. Un singolo contatore silenzioso non genera questa segnalazione: servono almeno due contatori attivi.

In quel caso gli amministratori di Tillor ricevono una segnalazione, con l'ultima misurazione ricevuta e i contatori interessati. Quei contatori non compaiono poi un'altra volta, a parte, come contatore che richiede attenzione. Non devi impostare nulla. Se sui tuoi contatori vedi una **Ultima lettura** comune e vecchia, contatta l'assistenza.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un allarme cancellato non compare più come attivo nell'elenco. Il triangolino accanto al contatore in <UIPath>Parco > Contatori</UIPath> appartiene solo agli allarmi attivi.
- Se il contatore segnala di nuovo il problema, ricevi un nuovo allarme.

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'allarme continua a ripresentarsi">
La causa c'è ancora. Controlla batteria, segnale e posizione del contatore e, se necessario, chiama l'assistenza.
</Accordion>
<Accordion title="Più contatori non hanno una lettura recente">
Controlla se tutti hanno una **Ultima lettura** vecchia. In tal caso la causa è il gateway o la connessione. Contatta l'assistenza.
</Accordion>
<Accordion title="Un gruppo di contatori ICY smette di inviare tutto insieme">
Nella scheda **Controller ICY** controlla se un controller ha un allarme o è in rosso. In tal caso il problema è di quel controller o della sua connessione e non dei contatori. Controlla l'alimentazione e la rete del locale contatori e, se necessario, contatta ICY.
</Accordion>
<Accordion title="Un contatore non invia più nulla, ma non arriva nessuna segnalazione">
La segnalazione del gateway richiede almeno due contatori attivi. Controlla tu stesso lo stato, la batteria e il segnale di quel contatore.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Consultare letture e tendenze" href="/meterbeheer/meterstanden-en-trends" />
  <Card title="Fatturare i consumi" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Batch di consumo (/it-IT/meterbeheer/consumptie-batches)

Questa pagina spiega come Tillor suddivide il consumo di un cliente in periodi, così sai perché un importo ha quell'aspetto. Un **batch di consumo** (o periodo di consumo) è un periodo di consumo del contatore per un cliente e un contatore. Tillor tiene traccia automaticamente di quando un periodo inizia, quando finisce e se è già stato fatturato. Se vuoi solo fatturare, vai a [Fatturare il consumo](/meterbeheer/verbruik-factureren).

## Ciclo di vita di un batch [#levenscyclus-van-een-batch]

```mermaid
flowchart TD
  A[Creato<br/>solo lettura iniziale] -- letture --> B[Aperto<br/>lettura iniziale e finale]
  B -- chiusura --> C[Chiuso<br/>bloccato]
  C -- fatturazione --> D[Fatturato<br/>concluso]
```

### Stati [#statussen]

| Stato | Descrizione |
|--------|--------------|
| **Aperto** | Le nuove letture vengono aggiunte automaticamente al periodo |
| **Chiuso** | Il periodo è chiuso e attende la fatturazione |
| **Fatturato** | Il consumo è stato inserito in una fattura |

## Quando viene creato un batch? [#wanneer-wordt-een-batch-aangemaakt]

- **Con un'occupazione**: quando colleghi un cliente a un terreno con contatori e indichi una lettura iniziale
- **Con una lettura manuale**: quando inserisci una lettura per un contatore su un terreno con un'occupazione attiva e non esiste ancora un batch aperto per quella combinazione cliente-contatore

## Quando viene chiuso un batch? [#wanneer-wordt-een-batch-gesloten]

- **Alla fine dell'occupazione**: quando il cliente lascia il terreno (l'occupazione viene eliminata)
- **Con una correzione o un azzeramento del contatore**: quando la lettura scende (ad es. contatore sostituito o corretto). Il sistema chiude il periodo precedente, crea un batch "di salto" chiuso con consumo negativo (ad es. -90 per 100→10) e la lettura successiva avvia un nuovo batch aperto
- **Con una nuova occupazione**: quando un altro cliente (o lo stesso cliente di nuovo) viene collegato con letture iniziali esplicite

<Callout type="info" title="La lettura scende">
Se una lettura scende (correzione, azzeramento o sostituzione), Tillor chiude automaticamente il batch in corso, crea un batch "di salto" chiuso con consumo negativo e apre subito un nuovo batch alla nuova lettura. Il batch di salto è facile da riconoscere e da segnare come pagato. La lettura successiva viene aggiunta al nuovo batch.
</Callout>

## Esempi [#voorbeelden]

<Accordions type="multiple">
  <Accordion title="Occupazione normale (caso tipico)">
    Il cliente occupa il terreno, consuma e parte. È lo scenario più comune.

    ```
    1. Occupazione creata con lettura iniziale 100 m³ (15 gen)
       → Batch: inizio 100 m³, aperto

    2. Letture: 150 m³ (20 gen), 200 m³ (25 gen)
       → Batch: inizio 100 m³, fine 200 m³, consumo 100 m³

    3. Occupazione terminata con lettura finale 250 m³
       → Batch chiuso: consumo 150 m³, in attesa di fatturazione

    4. Fattura il consumo
       → Batch fatturato, concluso
    ```
  </Accordion>

  <Accordion title="Fatturazione continua (caso tipico)">
    L'occupazione prosegue; fatturi per periodo senza chiudere il batch.

    ```
    1. Batch: 0 → 50 m³ (aperto)
    2. Segna come fatturato
       → Batch 1 chiuso, Batch 2 creato automaticamente: 50 → (aperto)
    3. Nuove letture: 75, 100 m³
       → Batch 2: 50 → 100 m³, consumo 50 m³
    4. Segna di nuovo come fatturato
       → Batch 2 chiuso, Batch 3: 100 → (aperto)
    ```
  </Accordion>

  <Accordion title="La lettura scende - semplice (100 → 10)">
    Solo lettura iniziale, poi una correzione. Batch di salto con consumo -90 m³, poi un nuovo batch aperto.

    ```
    1. Batch: inizio 100 m³ (15 gen), ancora nessuna lettura finale
    2. Lettura del 16 gen: 10 m³ (contatore corretto)
       → Batch 1 chiuso (consumo 0)
       → Batch di salto: inizio 100 m³, fine 10 m³ (consumo -90 m³) - chiuso
       → Nuovo batch aperto: inizio 10 m³
    3. Lettura successiva: 20 m³ → batch: 10 → 20 m³, consumo 10 m³
    ```
  </Accordion>

  <Accordion title="La lettura scende - con consumo (100 → 150 → 10)">
    Prima un consumo normale, poi il contatore viene sostituito. Batch di salto con consumo -140 m³, poi un nuovo batch aperto.

    ```
    1. Batch: inizio 100 m³ (15 gen), fine 150 m³ (20 gen) → consumo 50 m³
    2. Lettura del 25 gen: 10 m³ (contatore sostituito)
       → Batch 1 chiuso con fine 150 m³ (consumo 50 m³)
       → Batch di salto: inizio 150 m³, fine 10 m³ (consumo -140 m³) - chiuso
       → Nuovo batch aperto: inizio 10 m³
    3. Lettura successiva: 20 m³ → batch: 10 → 20 m³, consumo 10 m³
    ```
  </Accordion>

  <Accordion title="Periodo senza consumo">
    Una lettura con lo stesso valore dell'inizio. Tillor adatta la data di inizio.

    ```
    1. Batch: inizio 982 m³ (1 dic), aperto
    2. Lettura del 5 gen: 982 m³ (stesso valore)
       → Inizio adattato automaticamente al 5 gen
       → Il periodo mostra "5 gen → ..." invece di "1 dic → ..."
    3. Lettura del 5 gen (più tardi): 990 m³
       → Consumo 8 m³, periodo "5 gen → 5 gen"
    ```
  </Accordion>

  <Accordion title="Il cliente torna">
    Il cliente lascia il terreno e torna più tardi. Nuovo batch, non collegato al precedente.

    ```
    1. Cliente A: batch 0 → 50 m³, occupazione terminata
    2. Cliente B: batch 55 → 100 m³, occupazione terminata
    3. Il cliente A torna con lettura iniziale 110 m³
       → Nuovo batch: inizio 110 m³ (non 50 m³)
       → Nessun collegamento con il periodo precedente
    ```
  </Accordion>

  <Accordion title="Fattura in bozza eliminata - la prosecuzione torna a essere un unico batch">
    Avevi fatturato il consumo mentre l'occupazione proseguiva; poi elimini la fattura in bozza.

    ```
    1. Batch aperto: 100 m³ (1 feb) → 200 m³ (7 mar), l'occupazione prosegue
    2. Fattura il consumo (fattura in bozza)
       → Batch A: 100 → 200 m³, collegato alla fattura, chiuso per quella fattura
       → Batch B creato automaticamente: inizio 200 m³ (stessa lettura della fine di A), aperto
    3. Nuova lettura: 250 m³ (15 mar)
       → Batch B: 200 → 250 m³
    4. Elimina la fattura in bozza
       → Batch A: non più collegato alla fattura, non fatturato
       → Il batch B (che inizia ancora a 200 m³) viene unito ad A
       → Risultato: un unico batch aperto 100 m³ → 250 m³, pronto per essere fatturato di nuovo
    ```
  </Accordion>

  <Accordion title="Fattura in bozza eliminata - nessuna unione (inizio diverso)">
    Due periodi separati sullo stesso contatore: il secondo batch **non** inizia dalla lettura finale del primo. Tillor **non** li unisce.

    ```
    1. Batch A: 12,49 m³ → 13,21 m³ (lettura finale = lettura X)
    2. Più tardi un altro periodo / salto sul contatore
    3. Batch B: 0,10 m³ → 0,77 m³ (inizio = lettura Y, Y ≠ X)
    4. Stessa fattura o un'altra - per questo esempio non importa
    5. Se elimini una fattura che apparteneva solo ad A:
       → A torna disponibile per la fatturazione
       → Il batch B resta; non viene incorporato in A (l'inizio Y non coincide con la fine X)
    ```
  </Accordion>

  <Accordion title="Fattura in bozza eliminata - prosecuzione già fatturata di nuovo">
    La prima fattura copre il periodo fino alla lettura X; poi arrivano nuove letture e una **seconda** fattura sulla prosecuzione. Eliminare la prima fattura non cambia la seconda.

    ```
    1. Fattura 1: batch A 0 → 50 m³ → dopo la fatturazione batch B: inizio 50 m³, aperto
    2. Letture: 60, 75 m³ sul batch B
    3. Fattura 2: batch B fatturato → batch C: inizio 75 m³
    4. Elimina la fattura 1
       → A torna disponibile
       → B appartiene ancora alla fattura 2 → non viene considerato "prosecuzione aperta di A"
       → Nessuna unione di A con B; C resta la prosecuzione attiva dopo la fattura 2
    ```
  </Accordion>
</Accordions>

## Fatturazione [#facturering]

### Modo 1: con il pulsante di fatturazione (nuova fattura) [#manier-1-via-factuurknop-nieuwe-factuur]

1. Vai su **Clienti** > cliente > scheda **Panoramica** (scheda **Letture**)
2. Fai clic su **Fattura consumo**
3. Il sistema crea una fattura con il consumo come riga, oppure lo aggiunge a una fattura in bozza esistente
4. I batch vengono segnati come fatturati e collegati alla fattura

### Modo 2: segnare manualmente come fatturato [#manier-2-handmatig-als-gefactureerd-markeren]

Se hai fatturato il consumo fuori da Tillor:

1. Apri il batch nella scheda **Letture** (profilo cliente) o **Consumo** (**Parco** > **Contatori** > contatore)
2. Fai clic sull'icona di avviso accanto al periodo
3. Conferma con **Sì, segna come fatturato**
4. Il batch viene chiuso senza collegamento a una fattura

<Callout type="warn" title="Attenzione">
Solo i batch segnati manualmente possono essere "annullati". I batch collegati a una vera fattura non possono essere annullati: prima bisogna eliminare la fattura.
</Callout>

### Nuovo batch automatico [#automatische-nieuwe-batch]

Quando segni un batch come fatturato (e l'occupazione è ancora in corso), Tillor crea automaticamente un **nuovo batch aperto** che parte dalla lettura finale del precedente. Così il consumo prosegue senza buchi.

```
Batch 1: 0 → 50 m³ (fatturato)
         ↓
Batch 2: 50 → (aperto, pronto per nuove letture)
```

## Eliminare una fattura [#factuur-verwijderen]

Se elimini una **fattura in bozza** a cui era collegato del consumo, Tillor adatta automaticamente i batch di consumo.

### Cosa succede sempre? [#wat-gebeurt-er-altijd]

- Il collegamento con quella fattura scompare.
- Il batch torna **non fatturato** e può finire di nuovo su una fattura.

### Quando due batch tornano a essere uno solo? [#wanneer-worden-twee-batches-weer-één]

A volte, dopo la fatturazione, Tillor aveva avviato automaticamente un **nuovo batch aperto** sulla **lettura finale** del periodo fatturato. Se elimini quella fattura, il sistema cerca una prosecuzione di questo tipo:

| Condizione | Conseguenza |
|------------|-------------|
| Esiste un altro batch con la **stessa lettura iniziale** della **lettura finale** del batch fatturato (stessa lettura come punto di collegamento) | Quella prosecuzione viene **unita** al batch originale. Ottieni di nuovo **un unico** periodo continuo. |
| La prosecuzione **non è ancora fatturata** (nessuna fattura associata) | L'unione è **consentita**. |
| La prosecuzione **inizia da una lettura diversa** dalla lettura finale del batch fatturato | **Nessuna** unione: sono due periodi separati. |
| La prosecuzione è **già stata fatturata di nuovo** (un'altra fattura) | **Nessuna** unione: quel periodo resta sull'altra fattura. |

### Lettura finale dopo l'unione [#eindstand-na-samenvoegen]

Dopo l'unione il batch dovrebbe tornare **aperto** (se la prosecuzione era aperta) e la **lettura finale** è quella attuale della prosecuzione, quindi comprese le letture arrivate **dopo** la fattura. Se tecnicamente la prosecuzione non aveva una lettura finale ma sul contatore ci sono letture più recenti, Tillor completa la lettura finale con la **lettura più recente dopo il punto di collegamento** (stessa logica di quando si crea un batch).

<Callout type="info" title="Segnato manualmente come fatturato">
Solo i batch **senza** collegamento a una fattura puoi riportarli manualmente a "non fatturato" con l'icona di ripristino (su **Parco** > **Contatori** > contatore, nei periodi conteggiati). I batch collegati a una vera fattura seguono le regole qui sopra solo **dopo** che hai eliminato quella fattura.
</Callout>

## Situazioni specifiche [#specifieke-situaties]

### Periodo senza consumo [#periode-zonder-verbruik]

Se arriva una lettura con lo stesso valore dell'inizio (consumo = 0), Tillor adatta automaticamente la data di inizio. Il periodo visualizzato mostra solo il periodo in cui c'è stato davvero consumo.

### Il cliente torna [#klant-keert-terug]

Quando un cliente occupa di nuovo un terreno dopo essere partito:

- Viene creato un **batch completamente nuovo**
- Il batch non parte da dove era finito il precedente
- Scegli di nuovo una lettura iniziale (oppure la lettura del contatore in quel momento)

### Contatore collegato a più clienti [#meter-gekoppeld-aan-meerdere-klanten]

Ogni combinazione cliente-contatore ha i propri batch. Lo stesso terreno può avere più occupazioni (ad es. in periodi diversi), ciascuna con i propri periodi di consumo.

## Panoramica nell'applicazione [#overzicht-in-de-applicatie]

Dove vedi i batch:

- **Clienti** > cliente > scheda **Panoramica** > scheda **Letture**: per contatore solo i periodi **in sospeso** (accento arancione) con il pulsante **Fattura consumo** in alto.
- **Parco** > **Contatori** > contatore > scheda **Consumo**: per cliente prima i periodi in sospeso (arancione), sotto i periodi conteggiati (verde con fattura collegata, grigio se segnati manualmente).
- **Clienti** > **Consumi in sospeso**: tabella con i clienti che hanno ancora consumo da fatturare.


<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Clienti > Consumi in sospeso" />

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione contatori" href="/meterbeheer" description="Torna alla panoramica" />
  <Card title="Fatturare il consumo" href="/meterbeheer/verbruik-factureren" description="Fatturare passo dopo passo" />
  <Card title="Fatture" href="/facturen" description="Fatture in bozza e fatturazione" />
  <Card title="Gestione clienti" href="/klantenbeheer" />
</Cards>


# Panoramica (/it-IT/meterbeheer)

Con la gestione contatori leggi a distanza i contatori del tuo parco e vedi chi consuma cosa, senza che nessuno debba passare dai quadri dei contatori. Vedi le letture, il consumo per periodo e gli allarmi, e addebiti il consumo al cliente che in quel momento si trova sul terreno. Trovi i tuoi contatori in <UIPath>Parco > Contatori</UIPath>.

<DocScreenshot src="/screenshots/park/meters-list.png" alt="Parco > Contatori con tutti i contatori del parco" />

## Come funziona? [#hoe-hangt-dit-samen]

Un contatore non appartiene mai direttamente a un cliente. Il contatore è collegato a un **terreno**, e il cliente è collegato a quel terreno tramite un'**occupazione**. Chi ha un'occupazione sul terreno in questo momento riceve il consumo dei contatori di quel terreno.

```mermaid
flowchart LR
  M[Contatore] -->|lo colleghi a| T[Terreno]
  K[Cliente] -->|riceve un'occupazione su| T
  T --> V[Consumo del cliente]
  V --> F[Fattura]
```

Ne derivano tre conseguenze che sorprendono spesso:

- Non c'è un pulsante per collegare un contatore a un cliente. Lo fai in due passaggi: contatore al terreno, cliente al terreno. Vedi [Collegare un contatore a un cliente](/meterbeheer/meter-koppelen).
- Se un cliente si sposta, non sposti il contatore. L'occupazione termina e il cliente successivo riceve il consumo a partire dalla propria lettura iniziale.
- Se sul terreno non c'è un'occupazione, il consumo non appartiene a nessuno e non puoi nemmeno fatturarlo.

<Callout type="info" title="Da sapere">
- Un terreno ha al massimo un'occupazione attiva alla volta. Un terreno con un'occupazione non compare nell'elenco di **Crea occupazione**.
- I contatori su una rete LoRa condivisa inviano una misurazione circa due volte al giorno. Vedi il riquadro qui sotto.
- Tillor segnala un possibile guasto al ricevitore (il gateway) se tutti i tuoi contatori LoRa attivi di recente non inviano nulla da più di 24 ore, e solo con almeno due contatori attivi.
- Se vuoi fatturare il consumo di un cliente e l'importo in sospeso è inferiore all'importo minimo, Tillor aspetta il prossimo giorno di fatturazione.
- Con la fatturazione automatica Tillor blocca una fattura se il consumo di elettricità o acqua è almeno il doppio di quello abituale del cliente.
- Un contatore eliminato non si può recuperare, né con le sue letture né con i suoi periodi di consumo.
</Callout>

<Callout type="info" title="Per il lettore tecnico">
LoRa è una connessione wireless a lungo raggio e a basso consumo. Il contatore invia la sua lettura a un ricevitore nel parco o nelle vicinanze, il gateway, che la inoltra a Tillor. Il Dev EUI è il numero univoco di un contatore LoRa, lungo 16 caratteri (cifre 0-9 e lettere a-f). Inserisci quel numero quando crei il contatore. I contatori ICY si riconoscono dal numero di serie.
</Callout>

## Cosa vuoi fare? [#wat-wil-je-doen]

<Cards>
  <Card title="Collegare un contatore a un cliente" href="/meterbeheer/meter-koppelen" description="Contatore al terreno, cliente al terreno" />
  <Card title="Vedere letture e trend" href="/meterbeheer/meterstanden-en-trends" description="Lettura, consumo per giorno o ora, confronto con la settimana scorsa" />
  <Card title="Fatturare il consumo" href="/meterbeheer/verbruik-factureren" description="Manualmente o automaticamente, con un importo minimo" />
  <Card title="Allarmi e stato del contatore" href="/meterbeheer/alarmen-en-status" description="Nessuna lettura, batteria, segnale e guasti" />
  <Card title="Eliminare un contatore" href="/meterbeheer/meter-verwijderen" description="In tre passaggi, non annullabile" />
  <Card title="Batch di consumo" href="/meterbeheer/consumptie-batches" description="Come i periodi di consumo iniziano, si chiudono e si uniscono" />
</Cards>

## Come arrivano le letture? [#hoe-komen-de-meterstanden-binnen]

I contatori intelligenti inviano da soli la loro lettura, di solito ogni giorno o ogni settimana. Non devi fare nulla: le nuove letture compaiono da sole sul contatore e sul cliente che si trova sul terreno. Se un contatore non ha una connessione intelligente, inserisci tu la lettura.

## Termini [#begrippen]

- **Contatore**: un contatore di acqua, gas o elettricità. Vedi [Glossario](/begrippen#meter).
- **Terreno**: il posto in cui si trova il contatore e dove sta un cliente. Vedi [Glossario](/begrippen#terrein).
- **Occupazione**: un cliente su un terreno per un periodo. Vedi [Glossario](/begrippen#bezetting).
- **Periodo di consumo** (batch di consumo): il consumo di un cliente su un contatore, da una lettura iniziale a una lettura finale.
- **Consumo in sospeso**: consumo non ancora fatturato.
- **Lettura iniziale**: la lettura del contatore con cui un cliente inizia la sua occupazione.


# Collegare un contatore a un cliente (/it-IT/meterbeheer/meter-koppelen)

Un contatore non lo colleghi al cliente stesso. Colleghi il contatore a un terreno e assegni al cliente un'occupazione su quel terreno. Poi il consumo arriva da solo al cliente. Vedi [Come funziona?](/meterbeheer#hoe-hangt-dit-samen) per lo schema.

<Requires permission="Modifica contatori" />

Prima di iniziare:

- Il contatore è già in <UIPath>Parco > Contatori</UIPath>. Un contatore già collegato a un terreno non compare nell'elenco di scelta.
- Il terreno esiste e non ha ancora un'occupazione attiva. Se il terreno è occupato, non compare nell'elenco di **Crea occupazione**; se vedi **Nessun terreno disponibile trovato.**, sono tutti occupati.
- Il cliente esiste.

## Passaggio 1: collegare il contatore al terreno [#stap-1-de-meter-aan-het-terrein-hangen]

<Steps>
<Step>
### Apri il terreno [#open-het-terrein]
Vai su <UIPath>Parco > Terreni</UIPath> e fai clic sul terreno.
</Step>
<Step>
### Fai clic su Aggiungi contatore [#klik-op-meter-toevoegen]
In fondo alla scheda **Contatori** c'è **Aggiungi contatore**. Scegli il contatore dall'elenco.
</Step>
<Step>
### Conferma con Assegna contatore [#bevestig-met-meter-toekennen]
Il contatore ora compare nella scheda **Contatori** del terreno.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Dettaglio del terreno con la scheda Contatori" />

## Passaggio 2: mettere il cliente sul terreno [#stap-2-de-klant-op-het-terrein-zetten]

<Steps>
<Step>
### Apri il cliente [#open-de-klant]
Vai su <UIPath>Clienti > Panoramica</UIPath> e apri il cliente. Nella scheda **Panoramica** trovi il riquadro **Occupazioni**.
</Step>
<Step>
### Fai clic su Crea occupazione [#klik-op-bezetting-aanmaken]
Scegli il terreno. Se sul terreno ci sono contatori, puoi inserire una **lettura iniziale** per ogni contatore. Scegli una lettura esistente oppure digiti un valore. Se non ci sono contatori, vedi **Nessun contatore collegato**.
</Step>
<Step>
### Conferma [#bevestig]
Fai di nuovo clic su **Crea occupazione**.
</Step>
</Steps>

## Scollegare un contatore [#een-meter-loskoppelen]

Apri il terreno, vai alla scheda **Contatori** e nel menu (...) accanto al contatore scegli **Scollega dal terreno**. Il contatore continua a esistere e puoi collegarlo a un altro terreno. Questa voce si trova solo nella pagina del terreno, non nel menu del contatore stesso.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Tillor avvia per ogni contatore sul terreno un periodo di consumo per questo cliente, a partire dalla lettura iniziale. Vedi [Batch di consumo](/meterbeheer/consumptie-batches).
- Le nuove letture vanno su quel periodo. Le vedi sul cliente nella scheda **Letture** e sul contatore nella scheda **Consumo**.
- Se l'occupazione termina, Tillor chiude il periodo. Poi puoi fatturare il consumo, vedi [Fatturare il consumo](/meterbeheer/verbruik-factureren).
- Se in seguito colleghi un contatore in più a un terreno con un'occupazione in corso, per quel contatore inizia un periodo di consumo non appena inserisci una lettura.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo il contatore nell'elenco di Aggiungi contatore">
L'elenco mostra solo i contatori senza terreno. Se il contatore è già collegato a un altro terreno, vai a quel terreno e scegli **Scollega dal terreno**.
</Accordion>
<Accordion title="Nessun terreno disponibile trovato">
Tutti i terreni hanno già un'occupazione attiva. Termina prima l'occupazione sul terreno che vuoi usare, oppure crea un nuovo terreno.
</Accordion>
<Accordion title="Scollega dal terreno non è nel menu del contatore">
Questa voce si trova solo nel menu (...) della pagina del terreno, nella scheda **Contatori**. Tillor segnala **Impossibile scollegare il contatore** se l'operazione non è riuscita; riprova.
</Accordion>
<Accordion title="Il cliente non vede il consumo del contatore">
Controlla tre cose: il contatore è collegato al terreno, il cliente ha un'occupazione attiva su quel terreno e dopo l'inizio è arrivata una lettura? Senza occupazione il consumo non appartiene a nessuno.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Fatturare il consumo" href="/meterbeheer/verbruik-factureren" />
  <Card title="Terreni" href="/terreinen" />
  <Card title="Occupazioni" href="/bezettingen" />
</Cards>


# Eliminare un contatore (/it-IT/meterbeheer/meter-verwijderen)

Un contatore che non esiste più lo elimini in tre passaggi. Non si può annullare. Se vuoi solo toglierlo da un terreno, scollegalo, vedi [Collegare un contatore a un cliente](/meterbeheer/meter-koppelen#een-meter-loskoppelen).

<Requires permission="Modifica contatori" />

<Steps>
<Step>
### Apri il menu azioni [#open-het-actiemenu]
Fai clic sui tre puntini accanto al contatore, nell'elenco o nella pagina del contatore, e scegli **Elimina contatore**.

<DocScreenshot src="/screenshots/meterbeheer/meter-actions-menu.png" alt="Menu azioni di un contatore con Elimina contatore" />
</Step>
<Step>
### Passaggio 1 di 3: Continua [#stap-1-van-3-doorgaan]
Leggi che il contatore scompare per tutti nella tua organizzazione. Fai clic su **Continua**, oppure su **Annulla** per fermarti.

<DocScreenshot src="/screenshots/meterbeheer/meter-delete-dialog.png" alt="Passaggio 1 dell'eliminazione di un contatore" />
</Step>
<Step>
### Passaggio 2 di 3: guarda cosa scompare [#stap-2-van-3-bekijk-wat-verdwijnt]
Vedi tutte le letture con le foto, le note, gli allarmi e le anomalie, e il numero di periodi di consumo. I periodi di consumo non ancora fatturati sono in rosso. Se il contatore è ancora collegato a un terreno, anche questo viene indicato. Fai clic su **Continua**.
</Step>
<Step>
### Passaggio 3 di 3: digita il nome [#stap-3-van-3-typ-de-naam]
Digita il nome del contatore. Solo allora **Elimina definitivamente** diventa attivo.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il contatore, le sue letture, le foto, le note e gli allarmi spariscono, anche per i tuoi colleghi.
- I periodi di consumo non ancora fatturati non si possono più fatturare. Fatturali o segnali quindi prima, vedi [Fatturare il consumo](/meterbeheer/verbruik-factureren).
- Se elimini il contatore dalla sua pagina, poi torni all'elenco dei contatori.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il pulsante Elimina definitivamente è grigio">
Devi riscrivere esattamente il nome del contatore. Controlla maiuscole e spazi.
</Accordion>
<Accordion title="Tillor segnala Impossibile eliminare il contatore">
Il contatore non è stato eliminato. Riprova; se continua a non funzionare, contatta il supporto.
</Accordion>
<Accordion title="Non vedo Elimina contatore nel menu">
Ti serve il permesso **Modifica contatori**. Chiedilo al tuo amministratore.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Collegare un contatore a un cliente" href="/meterbeheer/meter-koppelen" />
  <Card title="Fatturare il consumo" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Vedere letture e trend (/it-IT/meterbeheer/meterstanden-en-trends)

Nella pagina di un contatore vedi l'ultima lettura, chi lo sta usando ora e come evolve il consumo. Così capisci subito se un contatore fa ciò che deve e se c'è qualcosa di strano. Se vuoi addebitare il consumo, vai a [Fatturare il consumo](/meterbeheer/verbruik-factureren).

## Aprire un contatore [#een-meter-openen]

<Steps>
<Step>
### Vai su Parco > Contatori [#ga-naar-park--meters]
Vedi tutti i contatori con **Nome**, **Tipo** (acqua, elettricità o gas), **Provider**, **Modulo** (Campère o PRM, solo per i contatori ICY), **Terreno** e l'**Ultima lettura** con la data. I contatori con un allarme attivo hanno un triangolino.
</Step>
<Step>
### Fai clic sul contatore [#klik-op-de-meter]
In alto vedi i dati del contatore e, tra l'altro, le schede **Informazioni**, **Consumo**, **Consumo e trend**, gli allarmi e l'attività.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Dettaglio del contatore con la scheda Consumo" />

Cosa c'è dove:

- **Informazioni**: numero di serie, tipo, terreno, ultima misurazione e, se il contatore la trasmette, il livello della batteria. Per un contatore ICY c'è anche quale **Modulo** è installato nella postazione (Campère o PRM), tramite quale **Controller** comunica quel modulo (con il nome del quadro di quel controller), il **Tempo di spegnimento** impostato su ICY e, se ICY lo conosce, il **Numero di serie del modulo**.
- **Cliente** nell'intestazione: il cliente con un'occupazione attiva sul terreno del contatore. Se c'è scritto **Nessun cliente**, il terreno non è occupato o il contatore non è collegato a nulla.
- **Consumo**: per cliente il consumo in sospeso e quello conteggiato.
- **Attività**: sotto la scheda **Consumo** la cronologia con la creazione del contatore, le modifiche e le letture inserite, modificate o eliminate manualmente. Ci sono anche le modifiche che Tillor rileva su ICY, come un altro numero di serie o un altro tempo di spegnimento del modulo.

## Leggere consumo e trend [#verbruik-en-trends-lezen]

In cima alla scheda **Consumo e trend** vedi il consumo di **Questa settimana** e della **Settimana scorsa**, la differenza **rispetto alla settimana scorsa** e la media per settimana (**Media / settimana**). Se il contatore ha ancora troppa poca cronologia, vedi **Cronologia insufficiente**.

<DocScreenshot src="/screenshots/meterbeheer/meter-consumption-trends.png" alt="Consumo e trend di un contatore" />

Sotto il grafico trovi gli **Approfondimenti**: la previsione per i prossimi 30 giorni, il totale nel periodo scelto, un giorno di picco, i giorni senza consumo e l'andamento. Se il consumo degli ultimi 7 giorni è nettamente sopra il normale, vedi **Utilizzo elevato**, con il meteo di quei giorni. Vedi [Meteo](/weer).

<Tabs items={["Per giorno o per ora", "Scegliere un periodo"]}>
<Tab value="Per giorno o per ora">
Con i pulsanti in alto a destra nella scheda cambi il **Raggruppamento** tra **Al giorno** e **All'ora**, e il **Tipo di grafico** tra area e barre. All'ora mostra i consumi orari come barre; un'ora ancora in corso riceve l'indicazione **in corso**.

- Se scegli un periodo di due giorni o meno, come **Oggi** o **Ieri**, il grafico mostra automaticamente barre orarie.
- Con un periodo più lungo, **All'ora** mostra gli ultimi 31 giorni.
</Tab>
<Tab value="Scegliere un periodo">
Fai clic sul pulsante del calendario in alto a destra. A sinistra scegli un periodo rapido: **Oggi**, **Ieri**, **Ultimi 7 giorni**, **Ultimo mese**, **Ultimi 3 mesi** o **Tutti**. A destra scegli una **Data di inizio** e una **Data di fine** sul calendario e confermi con **Applica**. Facendo clic su un solo giorno vedi quel giorno. Puoi anche modificare l'ora di inizio e di fine.

<DocScreenshot src="/screenshots/meterbeheer/meter-period-picker.png" alt="Selettore di periodo con periodi rapidi e calendario" />
</Tab>
</Tabs>

## Contatori commutabili [#schakelbare-meters]

Per i contatori che puoi accendere o spegnere a distanza, come ICY, il grafico della cronologia mostra anche lo stato acceso/spento. Una linea verde significa che il contatore era acceso. Una linea rossa con segni tratteggiati significa spento. Se una lettura non ha il dato acceso/spento, conta come acceso.

Per un contatore ICY, nel menu azioni sotto **Amperaggio** scegli quanti ampere riceve la postazione. Vedi solo i valori fino al massimo impostato su ICY per il modulo di quella postazione: se è 16 A, 20 A e 25 A non sono nell'elenco.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Nei tuoi dati non cambia nulla: sono solo visualizzazioni. I trend e il meteo si aggiornano appena arrivano nuove letture.

## Problemi? [#problemen]

<Accordions>
<Accordion title="C'è scritto Cronologia insufficiente">
Il contatore non ha ancora abbastanza giorni con misurazioni per un confronto con la settimana scorsa. Ripassa più tardi.
</Accordion>
<Accordion title="Il grafico è vuoto e c'è scritto Nessun consumo disponibile">
Per il periodo scelto non c'è consumo. Scegli un periodo più lungo, ad esempio **Tutti**.
</Accordion>
<Accordion title="L'ultima lettura è vecchia">
Guarda in [Allarmi e stato del contatore](/meterbeheer/alarmen-en-status) se c'è un allarme o un guasto al ricevitore.
</Accordion>
<Accordion title="Sotto Amperaggio non c'è il valore che voglio">
Tillor non offre valori superiori al massimo impostato su ICY per il modulo di quella postazione. Se quel massimo non è corretto, contatta ICY.
</Accordion>
<Accordion title="Sotto Cliente c'è scritto Nessun cliente">
Sul terreno del contatore non c'è un'occupazione attiva, oppure il contatore non è collegato a nessun terreno (**Nessun terreno**). Vedi [Collegare un contatore a un cliente](/meterbeheer/meter-koppelen).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Allarmi e stato del contatore" href="/meterbeheer/alarmen-en-status" />
  <Card title="Meteo" href="/weer" />
  <Card title="Fatturare il consumo" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Fatturare il consumo (/it-IT/meterbeheer/verbruik-factureren)

Il consumo di un cliente è pronto per essere fatturato non appena esiste un periodo di consumo con consumo. Lo metti su una fattura con un solo pulsante, oppure lasci che Tillor fatturi automaticamente in un giorno fisso. Come un periodo nasce e si chiude lo leggi in [Batch di consumo](/meterbeheer/consumptie-batches).

Prima di iniziare:

- Il cliente ha o aveva un'occupazione su un terreno con contatori. Senza occupazione non c'è consumo da fatturare, vedi [Collegare un contatore a un cliente](/meterbeheer/meter-koppelen).
- C'è consumo in sospeso. Se vedi **Nessun contatore con consumo in sospeso trovato.**, non c'è nulla da fatturare.

## Fatturare il consumo [#verbruik-factureren]

<Tabs items={["Dal cliente", "Da tutti i clienti", "Fatturato fuori da Tillor"]}>
<Tab value="Dal cliente">
<Steps>
<Step>
### Apri il cliente [#open-de-klant]
Vai su <UIPath>Clienti > Panoramica</UIPath>, apri il cliente e guarda nella scheda **Letture**. Lì trovi, per contatore, i periodi in sospeso.
</Step>
<Step>
### Fai clic su Fattura consumo [#klik-op-factureer-verbruik]
Tillor mette per ogni periodo una riga principale con l'importo su una fattura, con sotto una riga informativa con date e letture. Se esiste già una fattura in bozza adatta, Tillor vi aggiunge le righe.
</Step>
<Step>
### Scegli tu quali contatori e quale fattura [#kies-zelf-welke-meters-en-welke-factuur]
Apri la freccia accanto al pulsante e scegli **Aggiungi con selezione...**. In **Fatturazione avanzata** scegli una fattura in bozza esistente sotto **Fattura (facoltativo)**, oppure lasci vuoto per una nuova fattura. Sotto **Selezioni contatori** spunti quali contatori includere.
</Step>
</Steps>
</Tab>
<Tab value="Da tutti i clienti">
Vai su <UIPath>Clienti > Consumi in sospeso</UIPath>. Vedi i clienti con consumo ancora da fatturare, con l'importo totale per cliente. Di default qui ci sono solo clienti senza fatturazione automatica. Fattura direttamente dalla riga.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Clienti > Consumi in sospeso" />
</Tab>
<Tab value="Fatturato fuori da Tillor">
Se hai fatturato il consumo altrove, lo segni senza fattura:

1. Apri il periodo nella scheda **Letture** (profilo cliente) o **Consumo** (<UIPath>Parco > Contatori</UIPath> > contatore).
2. Fai clic sull'icona di avviso accanto al periodo.
3. Conferma con **Sì, segna come fatturato**.

<Callout type="warn" title="Attenzione">
Tillor in questo caso non crea una fattura. Solo i periodi che hai segnato così li riporti indietro con l'icona di ripristino tra i periodi conteggiati. Un periodo collegato a una vera fattura si libera solo quando elimini quella fattura.
</Callout>
</Tab>
</Tabs>

## Fatturare automaticamente [#automatisch-factureren]

Se per un cliente è attiva la fatturazione automatica delle utenze, Tillor crea da solo la fattura nel giorno scelto e la invia. Lo imposti nel profilo cliente.

Due regole decidono se quella fattura viene davvero creata:

- **Importo minimo.** Se l'importo in sospeso è inferiore, Tillor aspetta un successivo giorno di fatturazione. Il minimo per tutti i clienti si trova in **Impostazioni > Fatturazione** come **Importo minimo per le fatture utenze automatiche**. Nel profilo cliente puoi impostare, nelle impostazioni di fatturazione, un **Importo minimo** proprio, che ha la precedenza per quel cliente. Se lasci vuoti entrambi, viene fatturato qualsiasi importo.
- **Consumo molto sopra il solito.** Se il consumo in sospeso di elettricità o acqua è almeno il doppio di quello abituale del cliente, Tillor non crea la fattura. Ricevi un'e-mail all'indirizzo di supporto della tua organizzazione e la fattura non viene emessa finché qualcuno non l'ha controllata.

Tillor confronta ogni tipo con sé stesso: elettricità con elettricità precedente, acqua con acqua precedente. Il consumo abituale è il valore mediano delle ultime fatture di quel tipo. Non c'è un limite fisso in m³ o kWh. Se il cliente non ha ancora una fattura precedente per quel tipo, la fattura parte comunque automaticamente.

Se dopo il controllo la lettura è corretta, fatturi tu il consumo dal profilo cliente o da **Clienti > Consumi in sospeso**. Lì imposta il filtro **Fatturazione automatica** su **Con data** per vedere i clienti bloccati.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- I periodi passano da in sospeso a conteggiati. Se l'occupazione è ancora attiva, Tillor apre subito un nuovo periodo a partire dalla lettura finale, così non ci sono buchi.
- Le righe sono su una fattura in bozza. Registrala e inviala come qualsiasi altra fattura, vedi [Fatture](/facturen).
- Se elimini di nuovo la fattura in bozza, il consumo torna disponibile. Vedi [Eliminare una fattura](/meterbeheer/consumptie-batches#factuur-verwijderen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor segnala Errore di fatturazione">
Non è stato possibile mettere il consumo sulla fattura. Riprova. Se non funziona con una fattura in bozza scelta, scegli **Crea nuova fattura**.
</Accordion>
<Accordion title="La fattura automatica non è stata creata e ho ricevuto un'e-mail">
Il consumo era almeno due volte sopra il solito. Controlla la lettura e fattura tu se tutto è corretto.
</Accordion>
<Accordion title="Il cliente non è in Consumi in sospeso">
Di default l'elenco mostra solo clienti senza fatturazione automatica. Imposta il filtro **Fatturazione automatica** su **Con data** per gli altri clienti. Se il cliente ancora non c'è, non ha consumo in sospeso.
</Accordion>
<Accordion title="Non c'è nulla da fatturare anche se il cliente ha consumato acqua">
Controlla se il cliente ha un'occupazione attiva sul terreno dove si trova il contatore e se dopo la lettura iniziale è arrivata una lettura. Un periodo senza consumo non produce alcun importo.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Batch di consumo" href="/meterbeheer/consumptie-batches" />
  <Card title="Fatture" href="/facturen" />
  <Card title="Gestione clienti" href="/klantenbeheer" />
</Cards>


# Panoramica (/it-IT/nfc)

Un tag NFC è una carta, un braccialetto, un portachiavi o un adesivo che un cliente avvicina a un lettore, come nei pagamenti contactless. Con questo fa una doccia, apre una porta o ricarica la sua auto. In questa pagina vedi come tag, cliente e saldo stanno insieme. I passaggi per collegare o ricaricare un tag sono in [Gestire i tag](/nfc/nfc-tags).

Trovi tutti i tag della tua organizzazione nella pagina **Controller**, nella scheda **Tag NFC**.

<DocScreenshot src="/screenshots/nfc/nfc-tags-list.png" alt="La scheda Tag NFC nella pagina Controller" />

<Callout type="info" title="Da sapere">
- Un tag compare da solo in Tillor appena viene avvicinato a un lettore per la prima volta. Non lo crei tu.
- Un tag appartiene al massimo a un cliente e ha lo stato **Attivo**, **Inattivo** o **Bloccato**.
- Il saldo è in euro sul tag. Una modifica del saldo viene sempre conservata come transazione e non può essere modificata né eliminata.
- Un pagamento che deve ancora essere scritto sul tag resta in sospeso per 2 minuti. Poi scade.
- Un tag bloccato non funziona più presso i lettori.
</Callout>

## Come funziona? [#hoe-hangt-dit-samen]

Il tag stesso non sa nulla. Tillor ricorda chi lo possiede, qual è il saldo e dove può andare. Il lettore lo chiede a Tillor nel momento in cui il cliente avvicina il tag.

```mermaid
flowchart TD
  K[Cliente] --> T[Tag NFC]
  T --> G[Gruppi di accesso<br/>dove può andare il tag?]
  T --> S[Saldo<br/>quanto credito c'è sopra?]
  L[Lettore alla doccia, porta o colonnina] -->|il cliente avvicina il tag| T
  L --> TR[Transazione<br/>importo, motivo e lettore]
  S --> TR
```

- Senza cliente il lettore rifiuta il tag. Sullo schermo compare **Tag non associato**.
- Senza il gruppo di accesso giusto il lettore rifiuta il tag con **Nessun accesso**.
- Senza saldo sufficiente compare **Saldo insufficiente**. Tutti i messaggi dello schermo sono in [Messaggi dello schermo](/controllers/troubleshooting/scherm).
- Ogni addebito o ricarica diventa una riga nelle [transazioni](/nfc/nfc-transacties).
- Un tag è anche un metodo di accesso. Lo aggiungi a un cliente in [Controllo accessi](/toegangscontrole#een-toegangsmethode-toevoegen).

## Sezioni [#onderdelen]

<Cards>
  <Card title="Gestire i tag" href="/nfc/nfc-tags" description="Collegare i tag ai clienti e modificare il saldo" />
  <Card title="Transazioni" href="/nfc/nfc-transacties" description="Tutti gli usi e le modifiche del saldo" />
  <Card title="Controller" href="/controllers" description="I lettori a cui i clienti avvicinano il tag" />
</Cards>

## Termini [#begrippen]

- **Tag**: la carta, il braccialetto, l'adesivo o il portachiavi.
- **UID**: il numero univoco del tag.
- **Saldo**: il credito sul tag.
- **Gruppo di accesso**: stabilisce per quali lettori vale un tag.
- **Transazione**: un addebito o una ricarica del saldo.

Altre spiegazioni sono nel [glossario](/begrippen).


# Gestire i tag (/it-IT/nfc/nfc-tags)

Un tag NFC è utilizzabile solo quando è collegato a un cliente. Allora quel cliente può farci la doccia, aprire una porta o ricaricare, e tu puoi tenere traccia del saldo. Tutti i passaggi qui sotto li fai nel profilo cliente. Cosa succede a ogni lettura lo leggi in [Transazioni](/nfc/nfc-transacties).

Prima di iniziare:

- Il tag deve già essere in Tillor. Succede da solo appena viene avvicinato a un lettore per la prima volta.
- Il tag non deve essere già collegato a un altro cliente. Altrimenti non compare nell'elenco.
- Se non c'è nessun tag libero, l'elenco dice **Nessun tag disponibile trovato**.

## Collegare un tag a un cliente [#een-tag-koppelen-aan-een-klant]

<Steps>
<Step>
### Apri la scheda Tag NFC [#open-het-tabblad-nfc-tags]
Vai su <UIPath>Clienti > cliente > Tag NFC</UIPath>. Vedi tutti i tag di questo cliente. Sopra la tabella filtri per **UID** e **Tipo** (**Carta**, **Braccialetto**, **Adesivo** o **Portachiavi**).
</Step>
<Step>
### Scegli il tag [#kies-de-tag]
Fai clic su **Selezioni una carta** e scegli il tag. Puoi cercare nell'elenco.
</Step>
<Step>
### Fai clic su Assegna [#klik-op-toewijzen]
Tillor segnala **Carta assegnata al cliente** e il tag compare nella tabella.
</Step>
</Steps>

Nella tabella vedi per ogni tag l'**UID** (l'icona indica il tipo), lo **Stato**, il **Saldo**, quando è stato **Ultimo utilizzo** e i **Gruppi di accesso**.

## Cosa puoi fare con un tag? [#wat-kun-je-met-een-tag-doen]

Apri il menu azioni (tre puntini) accanto al tag.

<DocScreenshot src="/screenshots/nfc/nfc-tag-actions-menu.png" alt="Menu azioni di un tag NFC" />

| Azione | Cosa fa |
|---|---|
| **Modifica saldo** | Aggiunge un importo o imposta il saldo, vedi sotto. |
| **Blocca** / **Sblocca** | Imposta lo stato su **Bloccata** o lo ripristina. |
| **Gruppi di accesso** | Stabilisce per quali gruppi di accesso vale il tag. |
| **Invia notifica di saldo basso** | Invia al cliente una notifica che il saldo è basso. |
| **Copia URL personale** | Copia il link alla pagina personale del tag. |
| **Rimuovi dal cliente** | Scollega il tag dal cliente. |
| **Visualizza dettagli** | Apre la pagina di dettaglio con transazioni e attività. |

### Modificare il saldo [#het-saldo-aanpassen]

<Steps>
<Step>
### Scegli Modifica saldo [#kies-saldo-bewerken]
Apri il menu azioni e scegli **Modifica saldo**.
</Step>
<Step>
### Scegli come cambiare il saldo [#kies-hoe-je-het-saldo-wijzigt]
<DocScreenshot src="/screenshots/nfc/nfc-tag-topup-dialog.png" alt="Finestra Modifica saldo" />

Sotto **Opzione** scegli **Aggiungi saldo** (un importo in più) o **Imposta saldo** (un importo esatto). In fondo vedi il risultato, ad esempio **Attuale: ... → Nuovo: ...**.
</Step>
<Step>
### Conferma [#bevestig]
Inserisci l'importo e fai clic su **Aggiungi** o **Imposta**. L'importo deve essere positivo. Tillor segnala **Saldo aggiornato** o **Saldo impostato**.
</Step>
</Steps>

### Bloccare un tag [#een-tag-blokkeren]

Un tag smarrito o rubato lo blocchi con **Blocca**. Lo stato diventa **Bloccata** e il tag non funziona più presso i lettori. Con **Sblocca** nello stesso menu togli il blocco. Il cliente può anche bloccare lui stesso il suo tag nella pagina personale.

### Scegliere i gruppi di accesso [#toegangsgroepen-kiezen]

Scegli **Gruppi di accesso** e spunta o togli i gruppi. La modifica vale subito. Se vedi **Nessun gruppo di accesso disponibile**, per la tua organizzazione non sono ancora stati configurati gruppi.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un tag collegato compare nella tabella e sul cliente. Quando il cliente lo avvicina a un lettore, il lettore chiede a Tillor se è consentito.
- Ogni modifica del saldo diventa una [transazione](/nfc/nfc-transacties), anche se modifichi il saldo a mano. Il motivo è allora **Modifica manuale**.
- In **Attività** nella pagina di dettaglio vedi il prima e il dopo di ogni modifica (saldo, blocco, collegamento al cliente).
- Con **Rimuovi dal cliente** il tag continua a esistere. È di nuovo libero di essere assegnato a un altro cliente. Le transazioni vengono conservate.
- Con **Copia URL personale** il cliente ottiene una pagina propria. Lì può bloccare la sua carta e, se hai impostato i pagamenti online, ricaricarla da solo. Questo genera una fattura per il cliente.

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'elenco dei tag è vuoto">
Tillor dice **Nessun tag disponibile trovato**. Nell'elenco ci sono solo tag che non appartengono ancora a nessuno. Scollega il tag dall'altro cliente con **Rimuovi dal cliente**, oppure avvicina un nuovo tag a un lettore perché compaia in Tillor.
</Accordion>
<Accordion title="Tillor dice: Aggiornamento non riuscito">
Non è stato possibile salvare il saldo o i gruppi di accesso. Riprova. Se non funziona, aggiorna la pagina e controlla che il tag sia ancora collegato al cliente.
</Accordion>
<Accordion title="Il cliente viene rifiutato dal lettore">
Leggi il motivo sullo schermo del controller, vedi [Messaggi dello schermo](/controllers/troubleshooting/scherm). Di solito il tag è **Bloccata**, non è collegato a un cliente, il gruppo di accesso giusto non è attivo o il saldo è troppo basso.
</Accordion>
<Accordion title="Tillor dice: L'importo deve essere positivo">
L'importo deve essere inserito e maggiore di zero. Altrimenti Tillor segnala **L'importo è obbligatorio**, **Importo non valido** o **L'importo deve essere positivo**.
</Accordion>
<Accordion title="Il cliente non può ricaricare da solo">
La ricarica dalla pagina personale funziona solo se la tua organizzazione ha impostato i pagamenti online e se il tag è collegato a un cliente. Vedi [Elaborazione dei pagamenti](/betalingsverwerking).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Transazioni" href="/nfc/nfc-transacties" description="Vedere la cronologia delle transazioni" />
  <Card title="Controllo accessi" href="/toegangscontrole" description="Sbarre e metodi di accesso" />
  <Card title="Gestione clienti" href="/klantenbeheer" description="Gestire i profili cliente" />
</Cards>


# Transazioni (/it-IT/nfc/nfc-transacties)

Ogni modifica del saldo di un tag NFC viene registrata come transazione, anche una modifica manuale. Così vedi esattamente quando e per quale motivo il saldo è cambiato. Le transazioni non possono essere modificate né eliminate.

## Vedere le transazioni [#transacties-bekijken]

<Steps>
<Step>
### Apri il tag [#open-de-tag]
Vai su <UIPath>Clienti > cliente > Tag NFC</UIPath>, apri il menu azioni (tre puntini) accanto al tag e scegli **Visualizza dettagli**.
</Step>
<Step>
### Guarda in Transazioni [#kijk-bij-transacties]
La scheda **Transazioni** si trova nella pagina di dettaglio. La più recente è in alto. Con più di cinque transazioni sfogli in fondo.

<DocScreenshot src="/screenshots/nfc/nfc-tag-detail.png" alt="Pagina di dettaglio di un tag NFC con transazioni" />
</Step>
</Steps>

Sopra la tabella ci sono i filtri per **Data**, **Stato**, **Origine** e **Motivo di annullamento**. Di default sono attivi **In attesa** e **Confermata**. Se vuoi vedere anche le transazioni annullate e scadute, fai clic su **Cancelli filtri**.

## Colonne [#kolommen]

| Colonna | Significato |
|---|---|
| **Importo** | La modifica del saldo. Positiva con la ricarica, negativa con l'uso. |
| **Motivo** | La causa, ad esempio **Utilizzo doccia presso** un controller, **Addebito POS**, **Ricarica POS**, **Modifica manuale** o **Aggiunto perché la fattura ... è stata pagata**. |
| **Controller** | Il controller che ha causato la transazione. Se c'è **Sistema**, non c'era un controller: una modifica manuale, l'app della reception o una fattura pagata. |
| **Data** | Data e ora. |
| **Stato** | Vedi sotto. |
| **Origine** | **Online** oppure **Offline**. |
| **Descrizione**, **Motivo di annullamento** | Spiegazione aggiuntiva e, per una transazione annullata, il motivo. |

## Stati [#statussen]

| Stato | Significato |
|---|---|
| <Status tone="info">In attesa</Status> | L'addebito è riservato e deve ancora essere scritto sul tag. |
| <Status tone="success">Confermata</Status> | La transazione è conclusa e il saldo è stato aggiornato. |
| <Status tone="error">Annullata</Status> | La transazione non è andata a buon fine. Il motivo è in **Motivo di annullamento**. |
| <Status>Scaduta</Status> | Il tag non è stato avvicinato al lettore in tempo. Una prenotazione resta aperta 2 minuti. |

I possibili motivi di annullamento sono **Saldo insufficiente**, **Non autorizzato**, **Scrittura sulla carta non riuscita** e **Scaduto**.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Una transazione in attesa diventa <Status tone="success">Confermata</Status> appena il tag ha ricevuto il nuovo saldo. Se non succede entro 2 minuti, diventa <Status>Scaduta</Status> e il saldo non cambia.
- In **Origine** c'è **Offline** se la transazione non è passata in tempo reale da Tillor.
- Un addetto alla reception può fare nell'app Tillor lo stesso addebito o la stessa ricarica. Il saldo viene allora aggiornato solo in Tillor. Compare come **Addebito POS** o **Ricarica POS**, senza controller.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il saldo non corrisponde a quello che si aspetta il cliente">
Apri le transazioni e guarda il motivo e la data delle ultime righe. Una riga con **Modifica manuale** è stata inserita da un collega. Se vedi transazioni **Scaduta** o **Annullata**, per quelle non è stato addebitato nulla.
</Accordion>
<Accordion title="C'è una transazione In attesa che non scompare">
Aspetta che passino i 2 minuti. La transazione diventa poi <Status>Scaduta</Status>. Fai avvicinare di nuovo il tag al lettore dal cliente.
</Accordion>
<Accordion title="La scheda Transazioni è vuota">
Il tag non è ancora stato usato e il saldo non è stato modificato. Non c'è quindi nulla da mostrare.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestire i tag" href="/nfc/nfc-tags" description="Collegare le carte e modificare il saldo" />
  <Card title="Gestione clienti" href="/klantenbeheer" description="Vedere i profili cliente" />
</Cards>


# Notifiche (/it-IT/notificaties)

Il riepilogo delle notifiche mostra ogni messaggio che Tillor ha inviato a clienti e colleghi, per e-mail, SMS, posta, WhatsApp o push. Vede a colpo d'occhio quali messaggi sono arrivati, quali sono ancora in viaggio e quali non sono riusciti. Inviare un messaggio di fattura da sé è spiegato in [Inviare una fattura o un sollecito](/communicatie/e-mails).

Apra il riepilogo da <UIPath>Comunicazione > Notifiche</UIPath>.

<Callout type="info" title="Da sapere">
- Se un messaggio resta fermo per più di 5 minuti senza essere stato inoltrato, Tillor riprova automaticamente
- Se dopo 2 giorni non c'è stato alcun invio, Tillor imposta il messaggio su **Non riuscito**. Vale anche per un SMS che resta così a lungo su **In attesa**
- L'elenco **Comunicazioni recenti** mostra per impostazione predefinita 50 messaggi per pagina
- Il clic su un link in un'e-mail o in un SMS viene conteggiato solo se avviene almeno circa un secondo e mezzo dopo l'invio. In questo modo i programmi di posta che scaricano i link in anticipo non vengono contati come clic
- I messaggi di fattura non partono da soli quando registra una fattura. È Lei ad avviare l'invio
- Una scheda con una nuova notifica in Tillor scompare dopo alcuni secondi. La notifica resta nella campanella finché non la legge
- Le notifiche che vengono sempre inviate non si possono disattivare
</Callout>

## Come funziona? [#hoe-hangt-dit-samen]

Un messaggio nasce da un motivo. Poi Tillor sceglie il canale e conserva il risultato nel riepilogo.

```mermaid
flowchart LR
  A[Lei fa clic su Invia notifica] --> D[Messaggio]
  B[Succede qualcosa, come un allarme contatore] --> D
  C[Un'automazione invia un messaggio] --> D
  D --> E{Per chi?}
  E -- Cliente --> F[E-mail, SMS, posta o WhatsApp]
  E -- Collega --> G[Push, e-mail o telefono, secondo le sue preferenze]
  F --> H[Notifiche: stato per canale]
  G --> H
  G --> I[Campanella in Tillor]
  H --> J[Visibile anche dal cliente e sulla fattura]
```

- **A un cliente** di solito sceglie Lei stesso il canale, per esempio nella finestra **Invia notifica** su una fattura. Anche un'[automazione](/begrippen#automatisering) può inviare un messaggio a un cliente.
- **A un collega** è il collega stesso a decidere come Tillor lo raggiunge, per tipo di notifica. Vedi [Notifiche nell'app](#meldingen-in-de-app).
- **Il risultato** lo vede qui, e anche dal cliente e sulla fattura a cui il messaggio appartiene. La colonna **Origine** La porta direttamente lì.

## Consultare le notifiche [#notificaties-bekijken]

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Riepilogo delle notifiche con statistiche ed elenchi" />

In alto ci sono quattro statistiche:

- **Notifiche totali**: tutti i tentativi di invio
- **Notifiche inviate**: messaggi che sono stati consegnati
- **Notifiche non riuscite**: messaggi che non è stato possibile consegnare
- **Notifiche respinte**: messaggi rimbalzati, soprattutto e-mail

Sotto ci sono quattro elenchi: **Notifiche respinte**, **Notifiche in attesa** (ancora in coda o in viaggio), **Comunicazioni recenti** (tutti gli stati) e **Notifiche non riuscite**. Con i filtri **Tipo** e **Canale** sopra ogni elenco restringe ciò che vede. I tipi disponibili sono descritti in [Tipi di notifica](/communicatie/notificatietypes).

Ogni riga mostra:

| Colonna | Cosa vede |
|---|---|
| **Tipo** | Che tipo di messaggio è, per esempio Nuova fattura o Allarme contatore o controller |
| **Origine** | La fattura, il cliente o il pagamento a cui appartiene il messaggio |
| **Canale** | Email, SMS, Posta, WhatsApp o Push |
| **Stato** | Lo stato di consegna |
| **Destinatario** | L'indirizzo e-mail, il numero di telefono, l'indirizzo postale o l'utente |
| **Data** | Quando è stato creato il tentativo di invio |

### Consultare i dettagli di consegna [#leveringsdetails-bekijken]

Faccia clic sul canale in una riga per vedere cosa è stato inviato esattamente e cosa è successo.

<DocScreenshot src="/screenshots/notificaties/notifications-delivery-detail.png" alt="Dettagli di consegna dell'e-mail Nuova fattura" />

La finestra mostra lo stato di consegna, un eventuale messaggio di errore, il destinatario (**A**), l'indirizzo del mittente (**Da**) e, per l'e-mail, l'**Oggetto**. Vede inoltre quando il messaggio era pronto (**Creato il**) e quando è partito davvero (**Inviato il**). **Inviato da** mostra l'utente che ha avviato l'invio, oppure **Sistema** se è avvenuto in automatico. In fondo ci sono il **Contenuto** ed eventuali **Allegati**.

Per l'e-mail e WhatsApp vede anche **Letto il**, e nell'elenco un'icona a forma di occhio accanto ai messaggi letti. Per l'e-mail e gli SMS compare **Cliccato il** se il cliente ha fatto clic su un link.

Per la posta ci sono campi aggiuntivi: **Riferimento corriere**, **Stato tracciamento** e **Ultimo aggiornamento tracciamento** (l'ultimo evento del servizio postale), **Affrancatura** al momento dell'invio e, per un invio raccomandato, l'etichetta **Raccomandata** con i costi aggiuntivi e una spiegazione su come vengono addebitati.

<DocScreenshot src="/screenshots/notificaties/notifications-post-registered-detail.png" alt="Dettagli di consegna di un sollecito raccomandato per posta" />

### Stati [#statussen]

| Stato | Significato |
|---|---|
| <Status tone="info">In attesa</Status> | Il messaggio è in elaborazione o in coda |
| <Status tone="success">Inviato</Status> | Il messaggio è stato consegnato |
| <Status tone="error">Non riuscito</Status> | La consegna non è riuscita |
| <Status>Ignorato</Status> | Il messaggio non è (più) stato inviato, per esempio perché il push non era disponibile o perché una lettera è stata annullata presso il servizio postale |
| <Status tone="info">Ritardato</Status> | Il messaggio è pianificato e partirà più tardi |
| <Status tone="warning">Respinto</Status> | Il messaggio non ha raggiunto l'indirizzo e-mail o il numero |
| <Status tone="error">Segnalato</Status> | Il destinatario ha contrassegnato il messaggio come spam |

Una lettera per posta parte su **In attesa**. Non appena il servizio postale conferma che la lettera è in viaggio o consegnata, passa a **Inviato**. La posta non recapitabile diventa **Non riuscito**. Una lettera annullata diventa **Ignorato**. Quella riga la trova soprattutto sotto **Comunicazioni recenti**.

## Notifiche nell'app [#meldingen-in-de-app]

Tutto ciò che Tillor invia a Lei come collega, come un'attività assegnata, una menzione in un commento o un allarme contatore, lo ritrova anche in Tillor stesso. Ogni notifica compare una sola volta, anche se è stata inviata sia per e-mail sia per push. Non deve impostare nulla.

- **Campanella**: in alto a destra nella barra e in basso a sinistra nel menu (**Notifiche**) c'è una campanella con il numero di notifiche non lette. Faccia clic per vedere le più recenti. Con **Segna tutto come letto** aggiorna l'elenco in un colpo solo
- **Vedere l'e-mail**: faccia clic su una notifica per aprire l'e-mail che ha ricevuto, con in alto un pulsante verso la pagina corrispondente (per esempio **Apri attività**). Una notifica senza e-mail La porta subito a quella pagina. Poi la notifica risulta letta
- **Scheda in basso a destra**: se arriva una notifica mentre ha Tillor aperto, compare come scheda in basso a destra, nello stesso punto di una conversazione in arrivo. Faccia clic sulla scheda o la chiuda con la X. Una scheda chiusa resta non letta nella campanella. Se si trova già sulla pagina a cui si riferisce la notifica, non riceve alcuna scheda
- **Resta visibile**: le notifiche per le quali viene anche chiamato, come un connector non più raggiungibile, restano finché non le chiude
- **Inbox**: i nuovi messaggi nell'inbox hanno la propria scheda e il proprio contatore in **Inbox**. Nella campanella risultano subito come letti. Vale anche per il riepilogo giornaliero dei contatori che richiedono attenzione
- **Per giorno**: nell'elenco le notifiche sono raggruppate per giorno, con la categoria accanto. Con i pulsanti in alto mostra una sola categoria

Le notifiche sono personali: vede solo le proprie, per organizzazione.

In un'[automazione](/begrippen#automatisering), nel passaggio **Avvisa i colleghi** sceglie con **Mostra in Tillor** se la notifica ottiene una scheda e un contatore dei non letti. Se è disattivato, nell'elenco risulta già come letta.

### Disattivare le notifiche [#meldingen-uitzetten]

<Steps>
<Step>
### Apra il Suo account [#open-je-account]
Nel menu faccia clic sul Suo nome e scelga **Account**.
</Step>
<Step>
### Vada su Notifiche [#ga-naar-meldingen]
Per ogni tipo di notifica attivi o disattivi i canali. Nella riga **Tutte le notifiche** disattiva un canale in una volta per tutto.
</Step>
</Steps>

Un canale che disattiva in **Tutte le notifiche** resta disattivato per ogni notifica sottostante, tranne quelle che vengono sempre inviate. Un tipo di cui disattiva tutti i canali non compare più nemmeno nell'app. Per un collega lo gestisce in <UIPath>Impostazioni > Utenti</UIPath>, vedi [Impostare le notifiche di un collega](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen).

## Notifiche esterne [#externe-notificaties]

Un sistema esterno collegato, per esempio il Suo software di newsletter o di prenotazione, può far registrare in Tillor le e-mail che ha inviato da sé a un cliente. Le trova dal cliente, sulla fattura e sotto **Comunicazioni recenti**, tra i messaggi di Tillor. Le riconosce dall'etichetta **Esterna** con il nome del sistema.

- Tillor non ha inviato il messaggio e non può verificarne lo stato. Lo stato proviene dal sistema esterno
- Le notifiche esterne non vengono conteggiate nelle statistiche in alto e non compaiono negli elenchi **Notifiche respinte**, **Notifiche in attesa** e **Notifiche non riuscite**
- Nella finestra di dettaglio le immagini sono bloccate per impostazione predefinita. In questo modo il mittente non si accorge che apre il messaggio. Faccia clic su **Carica immagini** per mostrarle comunque
- Il sistema esterno può aggiornare o eliminare più tardi le proprie notifiche. Lo vede nel [registro attività](/activiteitenlog) del cliente o della fattura

Chi può registrare notifiche esterne si imposta con i permessi **Registrare notifiche esterne** e **Gestire le notifiche esterne di altri**. La spiegazione tecnica per gli integratori è in [Sviluppatori > Notifiche esterne](/ontwikkelaars/externe-notificaties).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Un messaggio è su Respinto">
L'indirizzo e-mail o il numero del cliente non esiste o non può ricevere messaggi. Apra il messaggio dall'elenco **Notifiche respinte** e legga il messaggio di errore. Tramite la colonna **Origine** vada al profilo del cliente, corregga l'indirizzo e-mail e invii di nuovo il messaggio con **Invia notifica** sulla fattura.
</Accordion>
<Accordion title="Un SMS o un messaggio WhatsApp non è riuscito">
Apra il messaggio da **Notifiche non riuscite** e legga il messaggio di errore. Di solito il numero di telefono non è corretto o manca il prefisso internazionale. Modifichi il numero nel profilo del cliente e invii di nuovo.
</Accordion>
<Accordion title="Un SMS resta su In attesa">
L'operatore telefonico a volte comunica la consegna con ritardo. Dopo 2 giorni Tillor imposta automaticamente l'SMS su **Non riuscito**. Apra la finestra di dettaglio per il messaggio di errore e controlli il numero.
</Accordion>
<Accordion title="Una lettera per posta non è riuscita o non è recapitabile">
Apra il messaggio da **Notifiche in attesa** o **Notifiche non riuscite**. Controlli l'indirizzo postale nel profilo del cliente (via, CAP e comune) e invii di nuovo la lettera con **Invia notifica** o **Invia promemoria** sulla fattura.
</Accordion>
<Accordion title="Una lettera è su Ignorato">
La lettera è stata annullata presso il servizio postale. Cerchi la spedizione sotto **Comunicazioni recenti** e guardi in **Stato tracciamento** cosa è successo. Invii di nuovo solo se il cliente deve ancora ricevere la lettera.
</Accordion>
<Accordion title="Non vedo il pulsante Invia notifica su una fattura">
Il pulsante compare solo su una fattura registrata, e solo se il cliente ha un indirizzo e-mail, un numero di telefono o un indirizzo postale completo. Completi uno di questi dati nel profilo del cliente.
</Accordion>
<Accordion title="Non ricevo più una notifica in Tillor">
Controlli in **Account**, sotto **Notifiche**, se ha disattivato tutti i canali per quel tipo. Un tipo senza canali non compare più nemmeno nella campanella.
</Accordion>
</Accordions>

## Concetti [#begrippen]

- **[Notifica](/begrippen#notificatie)**: un messaggio che Tillor invia a un cliente o a un collega, per e-mail, SMS, posta, WhatsApp o push.
- **Canale**: la via attraverso cui parte un messaggio. Una notifica può passare da più canali.
- **Consegna**: un tentativo di invio tramite un canale, con un proprio stato.
- **Respinto**: il messaggio è tornato indietro perché l'indirizzo o il numero non esiste.
- **Avviso**: una notifica per un [utente](/begrippen#gebruiker) di Tillor, visibile nella campanella.
- **Esterna**: un messaggio che un sistema collegato ha inviato da sé e che è registrato solo in Tillor.

Altri termini sono nel [glossario](/begrippen).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Inviare una fattura o un sollecito" href="/communicatie/e-mails" description="Inviare un messaggio da una fattura" />
  <Card title="Tipi di notifica" href="/communicatie/notificatietypes" description="Tutti i tipi di messaggio e quando partono" />
  <Card title="Inviare una fattura" href="/facturen/versturen" description="Fatture e solleciti per posta" />
  <Card title="Automazioni" href="/automatiseringen" description="Far inviare messaggi da un'automazione" />
</Cards>


# Commenti (/it-IT/notities)

Con i commenti i colleghi collaborano su clienti, fatture, prenotazioni e altri record, senza che il cliente veda nulla. Scrive un commento nella pagina di dettaglio del record, menziona un collega con una @ e fissa i commenti importanti. Inizi da [Aggiungere un commento](#een-opmerking-toevoegen).

<Callout type="info" title="Da sapere">
- I commenti sono sempre interni. Non diventano mai visibili ai clienti, nemmeno sulle fatture o nelle e-mail.
- Un collega che menziona con @ riceve una notifica.
- Un commento risolto non si può più modificare né fissare.
- Risolvere un commento rimuove automaticamente il fissaggio di un commento fissato.
- L'eliminazione di un commento non si può annullare.
- Un commento fissato resta visibile in alto nel record, senza dover scorrere fino alla scheda **Commenti**.
</Callout>

## Come funziona? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  R[Record: cliente, fattura, prenotazione...] --> O[Commento]
  O -->|@ menzione| M[Notifica per il collega]
  O -->|Fissa| P[In alto nel record]
  O -->|Promemoria| T[Attività da seguire]
  O -->|Risolvi| X[Risolto e compresso]
```

Tutti i commenti della Sua organizzazione si trovano anche insieme in <UIPath>Comunicazione > Commenti</UIPath>, con un rimando al record a cui appartengono.

## Dove trovo i commenti? [#waar-vind-je-opmerkingen]

Nelle pagine di dettaglio c'è una scheda **Commenti**. A seconda del record:

- <UIPath>Clienti > Riepilogo</UIPath> o <UIPath>Clienti > Comunicazione</UIPath>: nel profilo del cliente
- <UIPath>Amministrazione > Fatture</UIPath>: nella pagina di dettaglio della fattura
- <UIPath>Clienti > Prenotazioni</UIPath>: nella pagina di dettaglio della prenotazione
- <UIPath>Parco > Terreni</UIPath>: nella pagina di dettaglio del terreno
- <UIPath>Parco > Contatori</UIPath>: nella pagina di dettaglio del contatore
- <UIPath>Amministrazione > Report dei pagamenti</UIPath>: nel report dei pagamenti

## Aggiungere un commento [#een-opmerking-toevoegen]

<Steps>
<Step>
### Apra il record [#open-het-record]
Apra per esempio un profilo cliente o una fattura e vada alla scheda **Commenti**.

<DocScreenshot src="/screenshots/notities/invoice-comments.png" alt="Scheda dei commenti nel dettaglio della fattura" />
</Step>
<Step>
### Faccia clic su Aggiungi commento [#klik-op-reactie-toevoegen]
Scriva il commento nel campo **Scriva un commento...**.

- Digiti **@** e scelga un collega dall'elenco per menzionarlo. Riceverà una notifica.
- Digiti **/** per collegare un cliente, una fattura, un contatore, un terreno o un altro record.
- Aggiunga un allegato con **Allega file**, incollandolo o trascinando i file.
</Step>
<Step>
### Faccia clic su Invia [#klik-op-verzenden]
Il commento compare ora nella scheda. Con **Rispondi** su un commento esistente avvia una discussione.
</Step>
</Steps>

### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il commento compare nel record e nel riepilogo centrale.
- Un collega menzionato riceve una notifica.
- Se vuole essere certo che qualcuno risponda, faccia clic sull'orologio accanto al commento (**Imposta un promemoria di follow-up**). Tillor crea allora un'attività, così potrà verificare più tardi se è stata presa in carico.

## Gestire i commenti [#opmerkingen-beheren]

Accanto a ogni commento ci sono pulsanti di azione in alto a destra, se si dispone dei permessi.

### Modificare o eliminare un commento [#opmerking-bewerken-of-verwijderen]

- **Modifica**: cambi il testo. È possibile per i propri commenti, e non per quelli risolti.
- **Elimina**: elimina il commento, dopo conferma. Non si può annullare.

### Fissare un commento [#opmerking-vastzetten]

Vuole mantenere visibile in alto un commento importante?

1. Faccia clic sull'icona della puntina (**Fissa**).
2. Il commento riceve l'etichetta **Fissato** e si trova in cima all'elenco.
3. Faccia di nuovo clic sull'icona della puntina per sbloccarlo (**Rimuovi fissaggio**).

I commenti risolti non si possono fissare.

#### Dove si trova un commento fissato [#waar-staat-een-vastgezette-opmerking]

- In un profilo cliente si trova subito sotto i dati del cliente, in alto, sopra le schede.
- In una fattura, prenotazione, terreno o contatore si trova nella scheda **A colpo d'occhio** in alto, insieme alle attività aperte. Quella scheda si comprime se è vuota.

### Contrassegnare un commento come risolto [#opmerking-als-opgelost-markeren]

Per le discussioni concluse:

1. Faccia clic sul segno di spunta (**Risolvi**).
2. Il commento viene contrassegnato come **Risolto** e scompare dall'elenco dei commenti aperti.
3. In una pagina di dettaglio i commenti risolti si trovano in fondo, in una sezione comprimibile.
4. Faccia di nuovo clic sul segno di spunta per annullare (**Riapri**).

### Scaricare i commenti come PDF [#opmerkingen-als-pdf-downloaden]

Con l'icona di stampa scarica tutti i commenti di un record come PDF (**Scarica tutti i commenti come PDF**), oppure una sola discussione (**Scarica questo thread di commenti come PDF**).

## Riepilogo di tutti i commenti [#overzicht-van-alle-opmerkingen]

Vada su <UIPath>Comunicazione > Commenti</UIPath> per un riepilogo centrale. In alto vede le statistiche (totale, aperti, risolti e fissati). Sotto:

<DocScreenshot src="/screenshots/notities/comments-overview.png" alt="Riepilogo centrale dei commenti - Commenti aperti" />

- **Commenti aperti**: commenti ancora aperti.
- **Commenti risolti**: commenti chiusi, per riferimento.

Ogni commento mostra l'**Origine** (per esempio cliente o fattura), così può andare direttamente al record.

### Filtrare [#filteren]

- **Ultima settimana**, **Ultimo mese** o **Tutti**: filtra per data di creazione.
- **Mostra solo menzioni**: solo i commenti in cui è stato menzionato.
- Cerchi con **Cerca commenti...**, oppure filtri per autore, menzionato, risolto, fissato e commento principale o risposta.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice: Commento non creato">
Il commento non è stato salvato. Controlli che il campo di testo non sia vuoto e riprovi con **Invia**.
</Accordion>
<Accordion title="Non vedo nessun collega quando digito @">
Se compare **Nessun utente trovato**, provi con un altro nome o con un indirizzo e-mail. Nell'elenco compaiono solo gli utenti della Sua organizzazione.
</Accordion>
<Accordion title="Non riesco a modificare o fissare un commento">
Un commento risolto è bloccato. Faccia prima clic sul segno di spunta per riaprirlo (**Riapri**). La modifica è possibile solo per i propri commenti.
</Accordion>
<Accordion title="Il commento fissato è scomparso">
Risolvere un commento ne rimuove il fissaggio. Lo riapra con il segno di spunta e poi lo fissi di nuovo.
</Accordion>
<Accordion title="Tillor dice: Impossibile fissare/rimuovere il commento o Impossibile risolvere/riaprire il commento">
La modifica non è stata applicata. Ricarichi la pagina e riprovi.
</Accordion>
<Accordion title="Tillor dice: Impossibile creare il PDF">
Riprovi. Se il PDF non compare, il browser sta bloccando un pop-up. Consenta i pop-up per questo sito.
</Accordion>
</Accordions>

## Concetti [#begrippen]

- **Commento**: un testo interno su un record, con eventuali allegati. Vedi [commento](/begrippen#opmerking).
- **Menzione**: un collega che nomina con @. Riceve una notifica.
- **Fissare**: mantenere un commento in alto nel record.
- **Risolto**: un commento concluso che scompare dall'elenco dei commenti aperti.
- **Origine**: il record a cui appartiene un commento.
- **Attività**: un'azione da svolgere che può nascere da un promemoria su un commento. Vedi [attività](/begrippen#taak).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" description="Gestire i profili dei clienti" />
  <Card title="Fatture" href="/facturen" description="Gestire le fatture" />
</Cards>


# Parco (/it-IT/park)

Sotto **Parco** trova tutto ciò che riguarda il luogo fisico: la mappa con l'occupazione di oggi, l'elenco dei terreni, i contatori e i quadri contatori, e il meteo. Inizi dai [Terreni](/terreinen), perché un'occupazione, un contatore e una tariffa dipendono tutti da essi.

## Cosa trovo dove? [#wat-vind-je-waar]

| Menu | A cosa serve | Spiegazione |
|---|---|---|
| <UIPath>Parco > Mappa</UIPath> | La mappa del parco, colorata per giorno in base all'occupazione | [Mappa](/kaart) |
| <UIPath>Parco > Terreni</UIPath> | Tutti i terreni, la loro tariffa e i contatori collegati | [Terreni](/terreinen) |
| <UIPath>Parco > Contatori</UIPath> | Tutti i contatori di acqua, gas ed elettricità | [Gestione contatori](/meterbeheer) |
| <UIPath>Parco > Quadri contatori</UIPath> | I quadri in cui sono installati i contatori e quali contatori contengono | Gestisca i quadri contatori e i contatori assegnati |
| <UIPath>Parco > Meteo</UIPath> | Il meteo per giorno nella posizione del Suo parco | [Meteo](/weer) |

<DocScreenshot src="/screenshots/park/map-overview.png" alt="Mappa del parco con terreni colorati" />

## Quadri contatori [#meterkasten]

In <UIPath>Parco > Quadri contatori</UIPath> gestisce i quadri contatori e i contatori che vi sono assegnati. Con **Nuovo quadro contatori** aggiunge un quadro, con un nome e una descrizione.

## Come funziona? [#hoe-hangt-dit-samen]

Il **terreno** è il punto di riferimento. Al terreno collega i contatori. Un cliente arriva su un terreno tramite un'**occupazione**, e un ospite per un soggiorno breve tramite una **prenotazione**. Il consumo dei contatori sul terreno va al cliente con l'occupazione attiva.

```mermaid
flowchart LR
  M[Contatori] --> T[Terreno]
  T --> K[Mappa]
  B[Occupazione<br/>cliente per un periodo lungo] --> T
  R[Prenotazione<br/>soggiorno con data di check-in e check-out] --> T
  T --> V[Tariffa e consumo in fattura]
```

Un terreno ottiene un colore sulla mappa solo quando ne ha tracciato il confine. Vedi [Tracciare i confini dei terreni](/kaart#terreingrenzen-intekenen).

<Callout type="info" title="Da sapere">
- Un terreno ha al massimo un'occupazione attiva alla volta.
- Un nuovo terreno per impostazione predefinita non è prenotabile. Spunti **Prenotabile** se i clienti possono prenotarlo online.
- La superficie non si può digitare. Tillor la calcola non appena traccia il terreno sulla mappa, e la usa per la tariffa.
- La mappa si apre sempre sul giorno di oggi. Le altre impostazioni della mappa (stile, etichette, livelli) vengono conservate.
- Le etichette con notti e partenza compaiono solo a partire dal livello di zoom 17,5.
- Il meteo viene recuperato ogni notte per il centro mappa della Sua organizzazione.
</Callout>

## Concetti [#begrippen]

- **Terreno**: un posto nel Suo parco con un nome, una tariffa ed eventualmente dei contatori. Vedi [Concetti](/begrippen#terrein).
- **Mappa**: la mappa interattiva sotto Parco.
- **Quadro contatori**: un quadro con dei contatori. Vedi [Concetti](/begrippen#meterkast).
- **Occupazione**: un cliente su un terreno per un periodo. Vedi [Concetti](/begrippen#bezetting).
- **Prenotabile**: un terreno che i clienti possono prenotare online.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Terreni" href="/terreinen" description="Creare terreni, tariffa e contatori" />
  <Card title="Mappa" href="/kaart" description="Mappa, livelli e confini dei terreni" />
  <Card title="Gestione contatori" href="/meterbeheer" />
  <Card title="Meteo" href="/weer" />
</Cards>


# Impostazioni di stampa (/it-IT/printer/afdrukinstellingen)

Questo è l'elenco di tutte le impostazioni in <UIPath>Impostazioni > Stampa</UIPath>. Le impostazioni valgono per l'intera organizzazione. L'impostazione passo per passo è in [Impostare le stampanti](/printer/printers-instellen).

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Impostazioni > Stampa" />

| Impostazione | Significato |
| ---------- | --------- |
| **Stampa PDF** | Attiva la stampa di fatture e documenti su stampanti fisiche. Senza di essa Tillor non stampa nulla. |
| **Stampa automatica fattura al pagamento** | Le fatture pagate vanno automaticamente nella coda di stampa. Per ogni tipo di pagamento sceglie se ciò avviene subito, al prossimo orario programmato o mai. |
| **Stampa automatica documento d'identità al collegamento** | Se collega una scansione d'identità a un cliente o a un contatto (anche quando crea un cliente da una scansione), il riepilogo va in PDF alla stampante A4. Richiede: **Stampa PDF** attiva e un **IP stampante PDF** compilato. |
| **IP stampante PDF** | Indirizzo di rete della stampante A4 per fatture e documenti, per esempio `192.168.1.100`. |
| **IP stampante termica** | Indirizzo di rete della stampante di scontrini, per esempio `192.168.1.101`. |
| **Larghezza carta scontrini** | Larghezza del rotolo: **80 mm** (predefinito) o **58 mm**. Tillor adatta a questa misura la lunghezza delle righe e il logo dello scontrino. |
| **IP stampante etichette** | Indirizzo di rete della stampante di etichette, per esempio `192.168.1.102`. |
| **Orari di stampa programmati** | Per ogni giorno della settimana uno o più orari al minuto, per esempio 09:00 e 13:30. Vuoto significa che quel giorno non ci sono orari programmati. |
| **Tempistica stampa automatica per tipo di pagamento** | Per canale (terminale/banco, manuale, online, mandato, bonifico): **Stampa immediata**, **Prossimo orario programmato** o **Non stampare automaticamente**. Per impostazione predefinita terminale e manuale stampano subito. Online, mandato e bonifico attendono l'orario programmato. |
| **Sospendi stampa fino al** | Trattiene la coda di stampa fino al momento scelto. **Cancella pausa** rimuove la pausa. Può anche mettere in pausa dalla [coda di stampa](/printer/printwachtrij). |

Faccia clic in fondo su **Salva impostazioni** per applicare le modifiche. Valgono subito.

<Callout type="info">
Le stampanti devono trovarsi nella stessa rete del connector e avere un indirizzo IP fisso. Assegni alla stampante un indirizzo fisso nel router, altrimenti l'indirizzo può cambiare.
</Callout>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostare le stampanti" href="/printer/printers-instellen" description="I passaggi per iniziare" />
  <Card title="Stampare documenti" href="/printer/documenten-afdrukken" description="Stampare una fattura o uno scontrino" />
  <Card title="Connector" href="/connector" description="Il programma che controlla la stampante" />
</Cards>


# Stampare una fattura o uno scontrino (/it-IT/printer/documenten-afdrukken)

Stampa una fattura dalla pagina della fattura, sulla stampante A4 o sulla stampante di scontrini. Per i pagamenti Tillor può stampare gli scontrini anche da solo. Può anche mostrare una fattura sul tablet senza stamparla.

<Requires permission="Modifica impostazioni" />

Prima di iniziare:

- Le stampanti sono impostate, vedi [Impostare le stampanti](/printer/printers-instellen).
- Per la Sua organizzazione è attivo un connector. Senza di esso le opzioni **Invia a stampante A4** e **Invia a stampante ricevute** non compaiono nel menu.

## Stampare una fattura [#een-factuur-afdrukken]

<Steps>
<Step>
### Apra la fattura [#open-de-factuur]
Vada su <UIPath>Amministrazione > Fatture</UIPath> e apra la fattura.
</Step>
<Step>
### Scelga come stampare [#kies-hoe-je-afdrukt]
<Tabs items={["Su carta tramite il browser", "A una stampante in rete"]}>
<Tab value="Su carta tramite il browser">
Faccia clic su **Stampa**. Il browser apre la propria finestra di stampa.
</Tab>
<Tab value="A una stampante in rete">
Faccia clic sulla freccia accanto a **Stampa** e scelga **Invia a stampante A4** o **Invia a stampante ricevute**. Tillor mette un lavoro nella coda di stampa.
</Tab>
</Tabs>

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Dettaglio fattura - azioni di stampa e di pagamento" />
</Step>
</Steps>

## Scontrini dopo un pagamento [#bonnen-na-een-betaling]

In <UIPath>Impostazioni > Stampa</UIPath> attivi **Stampa automatica fattura al pagamento**. Le fatture pagate vanno allora alla stampante A4 ed eventualmente alla stampante di scontrini, subito o al prossimo orario programmato, a seconda del canale di pagamento.

Per ogni prodotto può inoltre attivare **Stampa termica** e **Stampa A4** e impostare il numero di copie nella pagina del prodotto. Quelle copie escono in più non appena quel prodotto si trova su una fattura pagata.

## Mostrare una fattura sul tablet [#een-factuur-op-de-tablet-tonen]

Vuole mostrare una fattura senza stamparla? Nel menu con i tre puntini accanto alla fattura scelga **Anteprima su iPad**, oppure faccia clic su **Anteprima su iPad** nella finestra di pagamento di un pagamento in contanti. Il PDF compare sul tablet collegato e Tillor segnala **PDF inviato a iPad**. Vedi [Tablet e chioschi](/mobiele-app/tablets-en-kiosken).

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un lavoro verso una stampante si trova nella [coda di stampa](/printer/printwachtrij) con uno stato. All'orario di stampa va alla stampante.
- Se la stampa non riesce, nella maggior parte dei casi Tillor riprova automaticamente. Poi il lavoro resta su **Non riuscito** finché non lo riprova o lo annulla.
- La fattura in sé non cambia: stampare non registra né invia nulla.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Invia a stampante A4">
Non c'è un connector attivo per la Sua organizzazione, oppure **Stampa PDF** è disattivata. Vedi [Impostare le stampanti](/printer/printers-instellen).
</Accordion>
<Accordion title="Tillor dice Stampa non riuscita">
Il messaggio è **Impossibile inviare il documento alla stampante.** Apra la [coda di stampa](/printer/printwachtrij) per il motivo sotto **Ultimo errore**, per esempio una stampante offline o senza carta.
</Accordion>
<Accordion title="Tillor dice Download non riuscito">
Non è stato possibile scaricare il PDF. Riprovi.
</Accordion>
<Accordion title="Tillor dice PDF non inviato">
Il PDF non è arrivato al tablet. Significa che nessun tablet è raggiungibile. Apra l'app Tillor sul tablet e verifichi che in <UIPath>Impostazioni > Tablet e chioschi</UIPath> risulti **Collegato**.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestire la coda di stampa" href="/printer/printwachtrij" description="Seguire i lavori e riprovarli" />
  <Card title="Fatture" href="/facturen" description="Gestire e inviare le fatture" />
  <Card title="Prodotti" href="/producten" description="Impostare le copie per prodotto" />
</Cards>


# Panoramica (/it-IT/printer)

Con il collegamento alle stampanti stampa fatture, scontrini ed etichette direttamente da Tillor su una stampante del Suo parco, senza prima scaricare il documento. Imposta le stampanti una sola volta in [Impostare le stampanti](/printer/printers-instellen) e poi stampa con un clic o lascia fare a Tillor al momento di un pagamento.

## Come funziona? [#hoe-hangt-dit-samen]

Tillor non invia un lavoro di stampa direttamente alla stampante. Il lavoro va prima nella coda di stampa. All'orario di stampa Tillor lo passa al connector, un piccolo programma su un computer della Sua rete, che fa stampare la stampante.

```mermaid
flowchart LR
  A[Stampa una fattura oppure<br/>arriva un pagamento] --> B[Coda di stampa in Tillor]
  B -- subito o all'orario di stampa --> C[Connector nella Sua rete]
  C --> D[Stampante]
  B -- non riuscito --> E[Tillor riprova]
```

Per questo il connector deve essere online e la stampante raggiungibile nella stessa rete. Senza un connector attivo le opzioni per inviare a una stampante non compaiono. Vedi [Connector](/connector).

<Callout type="info" title="Da sapere">
- Esistono tre tipi di stampanti: una stampante A4 per fatture e documenti, una stampante termica per gli scontrini e una stampante di etichette.
- La larghezza del rotolo è 80 mm (predefinito) o 58 mm.
- Un lavoro non riuscito viene riprovato automaticamente da Tillor dopo 10 secondi, 5 minuti e 15 minuti. Poi resta su **Non riuscito**. Se la carta è finita o la stampante è offline, va subito su **Non riuscito**.
- Ogni lunedì mattina Tillor riprova ancora una volta tutti i lavori che sono su **Non riuscito**.
- La stampa si può mettere in pausa per 15 minuti, 1 ora, 4 ore, 6 ore, 1 giorno oppure finché non la riprende da sé.
- Per impostazione predefinita i pagamenti con terminale e i pagamenti manuali stampano subito. I pagamenti online, i mandati e i bonifici attendono il prossimo orario di stampa.
</Callout>

## Cosa vuole fare? [#wat-wil-je-doen]

<Cards>
  <Card title="Impostare le stampanti" href="/printer/printers-instellen" description="Inserire gli indirizzi di rete e scegliere gli orari di stampa" />
  <Card title="Stampare documenti" href="/printer/documenten-afdrukken" description="Stampare una fattura o scontrini dopo il pagamento" />
  <Card title="Gestire la coda di stampa" href="/printer/printwachtrij" description="Mettere in pausa, riprovare o annullare i lavori" />
  <Card title="Impostazioni di stampa" href="/printer/afdrukinstellingen" description="Tutte le impostazioni in un colpo d'occhio" />
</Cards>

## Concetti [#begrippen]

- **Coda di stampa**: l'elenco dei lavori di stampa che Tillor deve ancora inviare.
- **Orario di stampa**: un orario fisso in un giorno della settimana in cui Tillor invia i lavori raggruppati, detto anche orario programmato.
- **Stampante termica**: la stampante per gli scontrini.
- **Connector**: il programma nella Sua rete che controlla la stampante. Vedi [Connector](/connector).
- **Indirizzo IP**: l'indirizzo di rete di una stampante, per esempio `192.168.1.100`.

Altre spiegazioni sono nel [glossario](/begrippen).


# Impostare le stampanti (/it-IT/printer/printers-instellen)

Perché Tillor possa stampare, deve sapere quali stampanti ha e dove si trovano nella rete. Lo imposta una sola volta per l'intera organizzazione. Poi può [stampare documenti](/printer/documenten-afdrukken). Ogni impostazione con spiegazione è in [Impostazioni di stampa](/printer/afdrukinstellingen).

<Requires permission="Modifica impostazioni" />

Prima di iniziare:

- Il connector è in esecuzione su un computer nella stessa rete delle stampanti. Vedi [Connector](/connector). Se non è attivo, più avanti non vedrà opzioni per inviare a una stampante.
- Conosce l'indirizzo IP di ogni stampante, cioè l'indirizzo di rete, per esempio `192.168.1.100`. Assegni alla stampante un indirizzo fisso nel router, altrimenti l'indirizzo può cambiare e la stampa si interrompe.

## Aggiungere una stampante [#een-printer-toevoegen]

<Steps>
<Step>
### Apra Stampa [#open-afdrukken]
Vada su <UIPath>Impostazioni > Stampa</UIPath>.

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Impostazioni > Stampa" />
</Step>
<Step>
### Attivi Stampa PDF [#zet-pdf-afdrukken-aan]
Senza questo interruttore Tillor non stampa nulla.
</Step>
<Step>
### Inserisca gli indirizzi delle stampanti [#vul-de-printeradressen-in]
In **Indirizzi IP delle stampanti** inserisca l'indirizzo dell'**IP stampante PDF** (A4), dell'**IP stampante termica** (scontrini) e dell'**IP stampante etichette**. Lasci vuoto ciò che non ha. In **Larghezza carta scontrini** scelga 80 mm o 58 mm, in base al Suo rotolo.
</Step>
<Step>
### Scelga quando stampare [#kies-wanneer-er-afgedrukt-wordt]
In **Orari di stampa programmati** imposti per ogni giorno della settimana uno o più orari (per esempio 09:00 e 13:30). In **Tempistica stampa automatica per tipo di pagamento** scelga per ogni canale di pagamento: **Stampa immediata**, **Prossimo orario programmato** o **Non stampare automaticamente**.
</Step>
<Step>
### Faccia clic su Salva impostazioni [#klik-op-instellingen-opslaan]
Le impostazioni valgono subito per l'intera organizzazione.
</Step>
</Steps>

## Stampa automatica al pagamento [#automatisch-afdrukken-bij-betaling]

Se vuole che una fattura pagata arrivi su carta senza interventi, attivi **Stampa automatica fattura al pagamento**. Per ogni canale di pagamento stabilisce con l'orario di stampa indicato sopra se ciò avviene subito o al prossimo orario programmato.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- A ogni stampa Tillor mette un lavoro nella [coda di stampa](/printer/printwachtrij), che il connector passa alla stampante.
- Le fatture pagate vanno automaticamente alla stampante A4, ed eventualmente alla stampante di scontrini, se lo ha attivato.
- Se per un canale sceglie un orario programmato, Tillor raggruppa i lavori fino a quel momento. Se quel giorno non c'è un orario di stampa, non c'è nemmeno un momento di invio.
- Provi con una fattura, vedi [Stampare documenti](/printer/documenten-afdrukken).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Invia a stampante A4 su una fattura">
Le opzioni compaiono solo se **Stampa PDF** è attiva e per la Sua organizzazione c'è un connector attivo. Controlli entrambi.
</Accordion>
<Accordion title="Tillor dice La stampante è offline o non risponde">
La stampante è spenta, non ha connessione di rete oppure l'indirizzo IP non è più corretto. Controlli l'indirizzo in <UIPath>Impostazioni > Stampa</UIPath> e che il connector sia online.
</Accordion>
<Accordion title="Tillor dice Carta, toner o inchiostro esaurito">
Rifornisca la stampante e riprovi il lavoro dalla coda di stampa.
</Accordion>
<Accordion title="Tillor dice La stampante non ha risposto in tempo">
Il connector non ha ricevuto risposta dalla stampante. Controlli che il connector sia in esecuzione e che la stampante sia raggiungibile. Verifichi nella coda di stampa se il lavoro è stato riprovato.
</Accordion>
<Accordion title="Gli scontrini non escono subito">
Controlli in **Tempistica stampa automatica per tipo di pagamento** se quel canale è su **Prossimo orario programmato**. In tal caso lo scontrino attende l'orario scelto in **Orari di stampa programmati**. Se ha messo in pausa la stampa, guardi nella [coda di stampa](/printer/printwachtrij).
</Accordion>
<Accordion title="Lo scontrino non entra nella carta">
Controlli la **Larghezza carta scontrini**: 80 mm o 58 mm.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni di stampa" href="/printer/afdrukinstellingen" description="Tutte le impostazioni in un colpo d'occhio" />
  <Card title="Connector" href="/connector" description="Il programma che controlla la stampante" />
  <Card title="Gestire la coda di stampa" href="/printer/printwachtrij" description="Mettere in pausa o riprovare i lavori" />
</Cards>


# Gestire la coda di stampa (/it-IT/printer/printwachtrij)

Nella coda di stampa vede quali lavori di stampa sono in attesa, in corso o non riusciti. Qui mette in pausa la stampa, fa procedere i lavori e risolve quelli che non sono andati a buon fine. L'elenco si aggiorna da solo non appena un lavoro cambia stato.

<Requires permission="Modifica impostazioni" />

Prima di iniziare: le stampanti sono impostate, vedi [Impostare le stampanti](/printer/printers-instellen).

## Consultare la coda [#de-wachtrij-bekijken]

Vada su <UIPath>Amministrazione > Coda di stampa</UIPath>. Gli elenchi sono:

- **In coda, programmati e in elaborazione**: lavori ancora in elaborazione. Un lavoro con stato **Programmato per dopo** attende il proprio orario **Programmato** e poi viene stampato da solo, a meno che la stampa non sia in pausa.
- **Non riusciti**: lavori definitivamente falliti, con il motivo in **Ultimo errore**.
- **Tutti i lavori di stampa**.

## Mettere in pausa la stampa [#het-afdrukken-pauzeren]

<Steps>
<Step>
### Scelga Metti in pausa la stampa [#kies-afdrukken-pauzeren]
Faccia clic su **Metti in pausa la stampa** e scelga una durata: 15 minuti, 1 ora, 4 ore, 6 ore, 1 giorno oppure **Finché non lo riattiviamo**.

<DocScreenshot src="/screenshots/printer/print-pause-menu.png" alt="Menu con la durata della pausa" />
</Step>
<Step>
### Riprenda quando ha finito [#hervat-wanneer-je-klaar-bent]
Faccia clic su **Riprendi la stampa**. Altrimenti riprende da sola dopo la durata scelta.
</Step>
</Steps>

Durante la pausa attendono sia i lavori diretti sia quelli programmati. I nuovi lavori restano in coda. Accanto all'icona della pausa è indicato fino a quando dura. Può impostare la pausa anche in **Sospendi stampa fino al** in <UIPath>Impostazioni > Stampa</UIPath>.

## Far procedere o ripristinare i lavori [#opdrachten-doorzetten-of-herstellen]

<Tabs items={["I lavori restano bloccati", "Un lavoro non è riuscito"]}>
<Tab value="I lavori restano bloccati">
Nella barra degli strumenti dell'elenco faccia clic su **Elabora coda**. I lavori programmati vengono allora elaborati subito. Il pulsante è grigio finché la stampa è in pausa, con il suggerimento **Riprendi la stampa per elaborare la coda**.
</Tab>
<Tab value="Un lavoro non è riuscito">
Apra il menu con i tre puntini sulla riga e scelga **Riprova** per inviarlo ancora una volta, oppure **Annulla**. Un lavoro annullato ottiene lo stato **Annullato** e non viene più stampato.
</Tab>
</Tabs>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un lavoro non riuscito viene riprovato da Tillor dopo 10 secondi, poi dopo 5 minuti e poi dopo 15 minuti. Se anche allora non riesce, resta su **Non riuscito**.
- Gli errori che un nuovo tentativo non risolve non vengono riprovati: carta, toner o inchiostro esauriti, una stampante offline o in pausa, o una coda della stampante disattivata. Vanno subito su **Non riuscito**.
- Ogni lunedì mattina Tillor rimette in coda ancora una volta tutti i lavori che sono su **Non riuscito**.
- Un lavoro che resta su **Non riuscito** non fa nulla finché non lo riprova o lo annulla.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il lavoro è su Non riuscito con La stampante è offline o non risponde">
Accenda la stampante, controlli la connessione di rete e che il connector sia online. Poi scelga **Riprova**.
</Accordion>
<Accordion title="Il lavoro dice Carta, toner o inchiostro esaurito">
Rifornisca la stampante e scelga **Riprova**.
</Accordion>
<Accordion title="Il lavoro dice La stampa è in pausa. Controlli carta, toner o inchiostro.">
La stampante stessa è in pausa, per esempio per un inceppamento della carta. Lo risolva alla stampante e riprovi.
</Accordion>
<Accordion title="Il lavoro dice Il lavoro di stampa è andato perso o non è stato completato sulla stampante">
Il lavoro è stato inviato alla stampante ma non è stato completato. Controlli se è già uscito qualcosa prima di riprovare, altrimenti ottiene un doppione.
</Accordion>
<Accordion title="Il lavoro dice La coda di stampa è disabilitata">
La coda sulla stampante stessa è disattivata. La attivi alla stampante e riprovi.
</Accordion>
<Accordion title="Elabora coda è grigio">
La stampa è in pausa. Scelga **Riprendi la stampa**.
</Accordion>
<Accordion title="Tillor dice Impossibile avviare l'elaborazione della coda di stampa">
Non è stato possibile far procedere la coda. Riprovi. Se non riesce, controlli che il connector sia online.
</Accordion>
<Accordion title="Tillor dice Impossibile riprovare il lavoro di stampa">
Riprovi, oppure annulli il lavoro e stampi di nuovo il documento dalla fattura.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostare le stampanti" href="/printer/printers-instellen" description="Indirizzi di rete e orari di stampa" />
  <Card title="Stampare una fattura o uno scontrino" href="/printer/documenten-afdrukken" description="Creare lavori" />
</Cards>


# Collegare azioni a un prodotto (/it-IT/producten/acties-instellen)

Con le azioni automatizza ciò che accade dopo la registrazione o il pagamento di una fattura: ricaricare un tag NFC, estendere un'occupazione, stampare uno scontrino o creare un metodo di accesso. Un prodotto può avere più azioni contemporaneamente.

<Requires permission="Modifica prodotti" />

Prima di iniziare: il prodotto esiste già. Vedi [Creare un prodotto](/producten/product-aanmaken). Uno schema di cosa fa Tillor e quando è in [Come funziona?](/producten#hoe-hangt-dit-samen).

<Steps>
<Step>
### Apra il prodotto [#open-het-product]

Vada su <UIPath>Amministrazione > Prodotti</UIPath> e apra il prodotto.
</Step>
<Step>
### Spunti le azioni [#vink-de-acties-aan]

Cerchi a destra la scheda **Azioni riga fattura**. Spunti le azioni desiderate. Per alcune azioni compaiono poi campi aggiuntivi. Cosa fa ogni azione e quali campi le appartengono è spiegato in [Azioni dei prodotti](/producten/productacties).

Lasci tutte le caselle vuote per una normale tariffa senza seguito.
</Step>
<Step>
### Salvi [#sla-op]

Faccia clic su **Salva** in fondo alla scheda **Righe fattura extra**. Le azioni sono ora sul prodotto e vengono riprese nelle nuove righe di fattura.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Quando sceglie il prodotto su una riga di fattura, Tillor riprende nella riga le azioni con i valori impostati. Quale azione fa cosa e quando dipende dal tipo. Alcune azioni scattano alla registrazione della fattura, la maggior parte al pagamento.

| Momento | Azioni |
|--------|--------|
| Alla registrazione | **Estendi periodo occupazione** (modifica **Fatturato fino al**), **Richiedi dati di contatto** (la registrazione è possibile solo quando i campi obbligatori sono compilati), creare una prenotazione con **Periodo** e **Chiedere la piazzola** |
| Al pagamento | **Ricarica tag NFC**, **Periodo**, **Estendi periodo occupazione** (modifica **Pagato fino al**), **Estendi metodo di accesso**, **Crea metodo di accesso**, **Stampa termica** e **Stampa A4** |
| Nessun effetto | **Consumo contatore** (determina la tariffa), **Mostra avviso** (mostra un testo) |
| Blocca la registrazione | **Impedisci prenotazione** |

Nell'elenco dei prodotti vede nella colonna **Azione** quali azioni ci sono su un prodotto.

<Callout type="info">
Una modifica alle azioni di un prodotto vale per le righe di fattura che aggiunge dopo.
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo il campo che cerco">
I campi aggiuntivi compaiono solo dopo aver spuntato l'azione corrispondente. **Registra l'arrivo alla conferma** e **Registra l'arrivo al pagamento** li vede solo se **Chiedere la piazzola** è attivo.
</Accordion>
<Accordion title="L'azione non scatta al pagamento">
Controlli che l'azione sia compilata sulla riga di fattura stessa. In **Crea metodo di accesso**, per esempio, deve essere scelto un tipo. Senza tipo Tillor non crea nulla, e con una riga non facoltativa non può registrare la fattura.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Azioni dei prodotti" href="/producten/productacties" description="Tutte le azioni e le loro impostazioni" />
  <Card title="Impostare righe di fattura extra" href="/producten/bundel-instellen" />
</Cards>


# Impostare righe di fattura extra (/it-IT/producten/bundel-instellen)

Alcuni prodotti sono più di una riga su una fattura: Posto fisso con supplementi, una spiegazione, noleggio contatore o tag NFC. Per questo imposta sul prodotto principale un bundle di righe extra. Quando qualcuno sceglie quel prodotto come riga principale su una fattura in bozza, Tillor aggiunge le righe figlie sotto quella riga principale, nell'ordine che ha impostato.

```mermaid
flowchart TD
  hoofd[Riga principale: prodotto con bundle] --> stap1[Passaggio 1 nel bundle]
  stap1 --> kind1[Riga figlia in fattura]
  hoofd --> stap2[Passaggio 2 nel bundle]
  stap2 --> kind2[Riga figlia in fattura]
```

<Requires permission="Modifica prodotti" />

## Creare o modificare un bundle [#een-bundel-aanmaken-of-bewerken]

<Steps>
<Step>
### Apra il prodotto principale [#open-het-hoofdproduct]

Vada su <UIPath>Amministrazione > Prodotti</UIPath> e apra il prodotto, per esempio Posto fisso.
</Step>
<Step>
### Avvii il bundle [#start-de-bundel]

Cerchi la scheda **Righe fattura extra** sotto **Generale**. Se il prodotto non ha ancora un bundle, faccia clic su **Configura bundle**.
</Step>
<Step>
### Aggiunga passaggi [#voeg-stappen-toe]

Faccia clic su **Passaggio prodotto** per una riga con un prodotto e un importo, oppure su **Passaggio info** per una riga con solo testo. Compili i campi di ogni passaggio. Cosa fa ogni campo è spiegato in [Passaggi del bundle](/producten/bundel-velden).
</Step>
<Step>
### Metta i passaggi nell'ordine giusto [#zet-de-stappen-in-de-juiste-volgorde]

Con le frecce **Sposta passaggio su** e **Sposta passaggio giù** stabilisce l'ordine in fattura. **Rimuovi passaggio** elimina un passaggio.
</Step>
<Step>
### Salvi [#sla-op]

Faccia clic su **Salva** in fondo alla scheda.
</Step>
</Steps>

<Callout type="info">
**Salva** sotto **Righe fattura extra** salva l'intera pagina del prodotto, comprese le modifiche in **Generale** e **Azioni riga fattura**. Ogni passaggio prodotto deve avere un prodotto e ogni passaggio info un testo. Altrimenti Tillor non conserva il bundle.
</Callout>

Con **Rimuovi intero bundle** disattiva il bundle. Un bundle può avere al massimo 40 passaggi.

## Esempio: un bundle Posto fisso [#voorbeeld-een-staangeld-bundel]

Un tipico bundle per Posto fisso è composto da cinque passaggi. I passaggi con una formula incollano la formula da [Passaggi del bundle](/producten/bundel-velden#voorbeelden) nel campo **Formula**.

<Steps>
<Step>
### Spiegazione [#toelichting]

Un **Passaggio info** con il testo "Incluse tasse turistiche, comunali e provinciali".
</Step>
<Step>
### Primo NFC incluso [#eerste-nfc-inbegrepen]

Un **Passaggio prodotto** con il prodotto supplemento NFC e una formula che restituisce il primo tag NFC attivo del cliente con quantità 0 e prezzo 0. Attivi **Moltiplica per quantità riga ancora** e **Una volta per fattura**, scelga **Stile riga** **INFO** e in **Giorni extra dopo la fine della riga principale (metodi di accesso)** inserisca per esempio `20`.
</Step>
<Step>
### Tag NFC aggiuntivi [#extra-nfc-tags]

Lo stesso passaggio prodotto con una formula che restituisce il secondo, il terzo e così via tag NFC attivo alla tariffa del prodotto, con le stesse opzioni di scala e di estensione. Attivi anche qui **Una volta per fattura**.
</Step>
<Step>
### Noleggio contatore [#meterhuur]

Un **Passaggio prodotto** con il prodotto di noleggio contatore e una formula che sceglie da `{meters}` i contatori che contano, per esempio solo i contatori elettrici ICY con supply attivo, e restituisce una riga per contatore con il nome del contatore nella descrizione.
</Step>
<Step>
### Cani [#honden]

Un **Passaggio prodotto** con il prodotto cani e una formula che legge il numero di cani da un campo personalizzato del cliente e restituisce una riga con quel numero, oppure nessuna riga se non ci sono cani.
</Step>
</Steps>

## Estendere l'NFC tramite il bundle [#nfc-verlengen-via-de-bundel]

Per Posto fisso con tag NFC tre cose vanno insieme:

1. Sul prodotto principale c'è l'azione **Estendi periodo occupazione**, e sulla riga di fattura è scelto un terreno.
2. Nel bundle c'è almeno un passaggio con **Giorni extra dopo la fine della riga principale (metodi di accesso)** compilato, per esempio i passaggi NFC dell'esempio qui sopra.
3. Sul prodotto principale c'è l'azione **Estendi metodo di accesso** con i tipi, gli stati desiderati ed eventualmente un giorno della settimana e un'ora di fine.

Al pagamento di una riga di un tale passaggio Tillor imposta la validità dei metodi di accesso del cliente sulla data di fine della riga principale Posto fisso più i giorni extra. Per impostazione predefinita dura fino alle 23:59 nel fuso orario dell'organizzazione, oppure fino al giorno della settimana e all'ora impostati in **Estendi metodo di accesso**. Se la riga principale non ha una data di fine, Tillor non estende nulla.

<Callout type="warn" title="Attenzione">
**Giorni extra dopo la fine della riga principale (metodi di accesso)** funziona solo se il prodotto ha come azione **Estendi periodo occupazione**. Se sotto il campo compare l'avviso che è necessario, spunti a destra in **Azioni riga fattura** **Estendi periodo occupazione**.
</Callout>

## Cosa succede su una fattura in bozza? [#wat-gebeurt-er-op-een-conceptfactuur]

- Le righe figlie compaiono sotto la riga principale solo dopo che in **Estendi periodo occupazione** ha scelto un terreno.
- Tillor ricostruisce le righe figlie se sulla riga principale modifica il prodotto, la quantità o il terreno. Negli altri casi le righe figlie modificate a mano restano. Se per esempio elimina una riga di contatore, non ricompare da sola.
- Nell'editor della fattura vede un'anteprima delle righe figlie, compreso l'effetto di **Una volta per fattura**, così corrisponde a ciò che c'è dopo il salvataggio.
- Una riga principale la sposta con le frecce solo come blocco intero. Le righe figlie le sposta solo all'interno del loro bundle. Se elimina la riga principale, scompaiono anche le righe figlie.
- Nel PDF le normali righe figlie ottengono spesso una **↳** davanti alla descrizione. Le righe info compaiono come righe grigie senza importi.
- I passaggi senza un prodotto scelto Tillor li salta. Un prodotto nel frattempo eliminato o mancante non produce quindi alcuna riga.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Le righe figlie non compaiono sotto la riga principale">
Con un prodotto principale con **Estendi periodo occupazione** deve prima scegliere un terreno sulla riga principale. Per l'estensione NFC al pagamento la riga principale ha inoltre bisogno di una data di fine.
</Accordion>
<Accordion title="Lo stesso supplemento compare due volte in fattura">
Se su una fattura ci sono due o più righe principali con un bundle, ogni riga principale riceve le righe del bundle. Attivi **Una volta per fattura** nei passaggi che devono comparire una sola volta. Il passaggio appartiene allora solo alla prima riga principale nell'ordine della fattura.
</Accordion>
<Accordion title="Il bundle non viene conservato">
Controlli che ogni passaggio prodotto abbia un **Prodotto** e ogni passaggio info un **Testo riga info**.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Passaggi del bundle" href="/producten/bundel-velden" description="Campi, chiavi dinamiche e segnaposto" />
  <Card title="JSON del bundle" href="/producten/bundel-json" />
  <Card title="Azioni dei prodotti" href="/producten/productacties" />
</Cards>


# JSON del bundle (/it-IT/producten/bundel-json)

La scheda **Righe fattura extra** salva un bundle come JSON sul prodotto, sotto la chiave `invoiceBundle`. Per le importazioni usi la stessa struttura. Per l'uso normale questa pagina non ti serve: i campi e la loro spiegazione sono in [Passaggi del bundle](/producten/bundel-velden).

## Struttura [#structuur]

| Campo | Significato |
|------|-----------|
| `invoiceBundle.version` | Sempre `1` |
| `invoiceBundle.steps` | Elenco di passaggi, al massimo 40. L'ordine è quello delle righe figlie sulla fattura |

Ogni passaggio è un passaggio prodotto o un passaggio info.

### Passaggio prodotto [#productstap]

| Campo | Significato |
|------|-----------|
| `productId` | Un prodotto esistente nella tua organizzazione. Obbligatorio |
| `quantity` | Numero maggiore di 0, per impostazione predefinita `1`. La quantità della riga senza formula, o quando la formula restituisce `true` |
| `quantityScale` | Facoltativo. `"anchor_line_quantity"` moltiplica ogni quantità calcolata per la quantità della riga principale |
| `description` | Facoltativo. Testo per la riga di fattura al posto del nome del prodotto; una formula può dare a ogni riga una propria `description` |
| `style` | Facoltativo. `DEFAULT` o `INFO` |
| `billOncePerInvoice` | Facoltativo. `true` lega il passaggio alla prima riga principale quando una fattura ne contiene diverse |
| `extendAccessMethod` | Facoltativo. `{ "daysAfterPeriodEnd": <numero intero, da 0 a 3660> }`, vedi [Estensione NFC](#nfc-verlenging) |
| `formula` | Facoltativo. TypeScript che stabilisce quali righe produce il passaggio, vedi [Formula](#formule) |

### Passaggio info [#inforestap]

```json
{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}
```

`description` è obbligatoria e un passaggio info non ha `productId`. Con `style` (`DEFAULT` o `INFO`) scegli lo stile della riga, per impostazione predefinita è `INFO`. Una `formula` che restituisce `false` omette la riga info.

## Formula [#formule]

`formula` è TypeScript che, al salvataggio di una fattura, restituisce `true` (una riga con `quantity`), `false` (nessuna riga), un numero (la quantità) oppure un elenco di righe `{ "quantity", "description", "unitPrice", "accessMethodValue" }`. Quali campi ed elenchi puoi leggere e cosa fa ogni forma è spiegato in [Formula per passaggio](/producten/bundel-velden#formule-per-stap). Una formula che non compila viene rifiutata al salvataggio del prodotto. In JSON la formula è una sola stringa con `\n` per gli a capo.

```json
"formula": "return {customer.customFields.exemptFromSurcharges} !== true;"
```

## Estensione NFC [#nfc-verlenging]

Ha senso solo se il prodotto principale ha **Estendi periodo occupazione** come azione.

```json
"extendAccessMethod": { "daysAfterPeriodEnd": 20 }
```

Quando viene pagata una riga di un passaggio così, Tillor porta la validità dei metodi di accesso del cliente alla data di fine della riga principale più `daysAfterPeriodEnd` giorni di calendario. Per impostazione predefinita arriva fino alle 23:59 nel fuso orario dell'organizzazione, oppure fino al giorno della settimana e all'ora di **Estendi metodo di accesso** sul prodotto principale. Anche quali tipi e stati contano lo imposti lì. Senza una data di fine sulla riga principale non succede nulla. Con **Non abbreviare all'estensione** attivo, Tillor salta i metodi la cui validità è già alla nuova data o dopo. Un `accessMethodValue` sulla riga indica il metodo di quella riga; l'estensione stessa segue le impostazioni del prodotto principale.

Dopo un'estensione riuscita, sulla cronologia della fattura compare una riga che rimanda al pagamento.

## Esempio: nota, supplemento NFC, noleggio contatore e cani [#voorbeeld-toelichting-nfc-toeslag-meterhuur-en-honden]

```json
{
  "invoiceBundle": {
    "version": 1,
    "steps": [
      {
        "stepKind": "info",
        "description": "Inclusief toeristen-, gemeente- en provincietaksen"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "style": "INFO",
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(0, 1).map((a) => ({ quantity: 0, unitPrice: 0, accessMethodValue: a.value, description: `Toegangsmethode inclusief: ${a.label}` }));"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(1).map((a) => ({ quantity: 1, accessMethodValue: a.value, description: `Toeslag extra toegangsmethode: ${a.label}` }));"
      },
      {
        "productId": "prd_meterhuur",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "formula": "return {meters}.filter((m) => m.provider === \"ICY\" && m.type === \"ELECTRICITY\" && m.icyMetadata?.switchState === true).map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));"
      },
      {
        "productId": "prd_hond",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "billOncePerInvoice": true,
        "formula": "const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));\nreturn dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];"
      }
    ]
  }
}
```

<Callout type="warn" title="Attenzione">
Controlla che tutti i valori `productId` dei passaggi prodotto esistano nel tuo catalogo. Tillor salta i passaggi con un prodotto sconosciuto.
</Callout>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Passaggi del bundle" href="/producten/bundel-velden" />
  <Card title="Impostare righe di fattura extra" href="/producten/bundel-instellen" />
</Cards>


# Passaggi del bundle (/it-IT/producten/bundel-velden)

Questa pagina descrive i campi della scheda **Righe fattura extra** nella pagina del prodotto. Come costruire un bundle è spiegato in [Impostare righe di fattura extra](/producten/bundel-instellen).

## Passaggio prodotto [#productstap]

Tillor trasforma un passaggio prodotto in zero, una o più righe di fattura con quel prodotto. Senza formula è una riga con la quantità impostata; con una [formula](#formule-per-stap) stabilisci tu se, quante e quali righe compaiono.

| Campo | Cosa fa |
|------|--------------|
| **Prodotto** | Il prodotto che finisce sulla riga figlia, per esempio un supplemento NFC o il noleggio di un contatore. Obbligatorio |
| **Quantità** | La quantità della riga se il passaggio non ha formula, o se la formula restituisce `true`. Maggiore di 0 |
| **Moltiplica per quantità riga ancora** | Moltiplica ogni quantità calcolata per la quantità della riga principale, per esempio 0,5 per mezzo anno di Posto fisso. Il risultato viene arrotondato a due decimali. Tillor omette le righe che così arrivano a 0; una riga che la formula stessa restituisce con quantità 0 resta |
| **Descrizione (facoltativo)** | Sostituisce il nome del prodotto sulla riga di fattura. Una formula che restituisce righe può dare a ogni riga una descrizione propria |
| **Stile riga** | **Predefinito (prodotto)**, **DEFAULT** o **INFO**. Con **INFO** la riga figlia diventa una nota grigia nel PDF e nell'editor |
| **Una volta per fattura** | Rilevante solo se sulla stessa fattura ci sono due o più righe principali con un bundle. Il passaggio appartiene allora solo alla prima riga principale nell'ordine della fattura |
| **Giorni extra dopo la fine della riga principale (metodi di accesso)** | Ha senso solo se il prodotto principale ha **Estendi periodo occupazione** come azione. Quando viene pagata una riga di questo passaggio, Tillor estende i metodi di accesso del cliente fino alla data di fine della riga principale più questo numero di giorni; tipi e stati vengono da **Estendi metodo di accesso** sul prodotto principale, vedi [Estendere l'NFC tramite il bundle](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) |
| **Formula** | Facoltativa. TypeScript che stabilisce se il passaggio compare sulla fattura, con quale quantità o quali righe esattamente, vedi [Formula per passaggio](#formule-per-stap) |

## Passaggio info [#inforestap]

Un passaggio info è solo testo, senza prodotto e importo. Tillor lo mostra come riga di nota.

| Campo | Cosa fa |
|------|--------------|
| **Testo riga info** | Il testo visibile, per esempio "Inclusief toeristen-, gemeente- en provincietaksen". Obbligatorio |
| **Stile riga** | Per impostazione predefinita **INFO**. Puoi scegliere **DEFAULT** se vuoi mostrare la riga come una riga normale |
| **Formula** | Facoltativa. Se la formula restituisce `false`, la riga info viene omessa |

Se un passaggio info sta sotto una riga principale, il PDF mette automaticamente **↳** davanti al testo.

## Formula per passaggio [#formule-per-stap]

Ogni passaggio può avere una **Formula**: TypeScript, come la [formula tariffaria](/terreinen#tariefformule), che Tillor esegue al salvataggio di una fattura con questo bundle. Così un passaggio può dipendere dal cliente, dall'occupazione, dalla piazzola, dai contatori o dai metodi di accesso, per esempio tramite un [campo personalizzato](/eigen-velden) in cui registri un'eccezione.

### Cosa restituisce la formula [#wat-de-formule-teruggeeft]

| Valore restituito | Effetto |
|---------------------|--------|
| `true` | Una riga con la **Quantità** impostata |
| `false` o `null` | Nessuna riga |
| Un numero maggiore di 0 | Una riga con quel numero come quantità |
| Un elenco di righe | Esattamente quelle righe, in quell'ordine. Un elenco vuoto significa nessuna riga |

Una riga in un elenco simile è un oggetto con questi campi:

| Campo | Significato |
|------|-----------|
| `quantity` | Obbligatorio. La quantità, 0 o più. Una riga con 0 resta, anche con **Moltiplica per quantità riga ancora** |
| `description` | Facoltativo. La descrizione di questa riga; altrimenti la **Descrizione** del passaggio, altrimenti il nome del prodotto |
| `unitPrice` | Facoltativo. Prezzo unitario IVA inclusa, come la tariffa del prodotto; altrimenti la tariffa del prodotto. `0` crea una riga gratuita |
| `accessMethodValue` | Facoltativo. Il valore del metodo di accesso a cui si riferisce questa riga (l'UID del tag NFC), per l'estensione al pagamento |

### Cosa può leggere la formula [#wat-de-formule-kan-lezen]

I campi si leggono con le parentesi graffe, come nelle automazioni. Il menu **Variabile** accanto al campo mostra tutto ciò che è disponibile, compresi i tuoi campi personalizzati.

| Variabile | Cos'è |
|------------|-----------|
| `{customer.…}` | Il cliente sulla fattura, per esempio `{customer.createdAt}` o `{customer.customFields.meterhuurVrijgesteld}` |
| `{occupation.…}` | L'occupazione della riga principale. Se il prodotto principale non ha **Estendi periodo occupazione**, è l'unica occupazione del cliente; vuota (`null`) se il cliente occupa più piazzole |
| `{terrain.…}` | La piazzola di quell'occupazione |
| `{anchor.…}` | La riga principale: `{anchor.quantity}` (per esempio 0,5 per mezzo anno), `{anchor.terrainId}`, `{anchor.occupationId}` e `{anchor.endDate}` |
| `{meters}` | L'elenco dei contatori nell'ambito: sulla piazzola della riga principale con **Estendi periodo occupazione**, altrimenti su tutte le piazzole occupate dal cliente. Ogni contatore ha `name`, `provider` (per esempio `ICY`), `type` (per esempio `ELECTRICITY`, `GAS`), i metadati del suo provider (per esempio `icyMetadata.switchState` per l'alimentazione attiva), la sua `terrain` e `customFields` |
| `{accessMethods}` | L'elenco dei metodi di accesso del cliente, dal più vecchio, di ogni tipo e stato. Ogni metodo ha `type` (per esempio `NFC`), `status` (per esempio `ACTIVE`), `value`, un `label` leggibile (il nome noto del tag NFC, altrimenti il valore) e `customFields` |

Tillor carica gli elenchi `{meters}` e `{accessMethods}` solo se la formula li usa.

### Esempi [#voorbeelden]

Saltare un passaggio per i clienti esenti:

```ts
if ({customer.customFields.exemptFromSurcharges} === true) return false;
return true;
```

Una riga per ogni contatore elettrico ICY con alimentazione attiva, e per i clienti dal 2026 anche con alimentazione spenta:

```ts
const newCustomer = new Date({customer.createdAt} ?? 0) >= new Date("2026-01-01T00:00:00+01:00");
return {meters}
  .filter((m) => m.provider === "ICY" && m.type === "ELECTRICITY")
  .filter((m) => m.icyMetadata?.switchState === true || newCustomer)
  .map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));
```

Il primo tag NFC gratis come nota, ogni successivo alla tariffa del prodotto (due passaggi con lo stesso prodotto, oppure un solo passaggio che restituisce entrambi i tipi di riga):

```ts
const nfc = {accessMethods}.filter((a) => a.type === "NFC" && a.status === "ACTIVE");
return nfc.map((a, i) => ({
  quantity: i === 0 ? 0 : 1,
  unitPrice: i === 0 ? 0 : undefined,
  accessMethodValue: a.value,
  description: i === 0 ? `Toegangsmethode inclusief: ${a.label}` : `Toeslag extra toegangsmethode: ${a.label}`,
}));
```

Una riga con il numero di cani da un campo personalizzato del cliente, nessuna riga senza cani:

```ts
const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));
return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];
```

Con **Inserisci esempio** sotto il campo ottieni un punto di partenza con queste forme in commento.

### Errori [#fouten]

Una formula che non compila non si può salvare; il messaggio sotto il campo dice cosa non va. Se una formula si blocca al salvataggio di una fattura, o restituisce qualcosa di diverso da `true`, `false`, un numero o righe valide, il salvataggio fallisce con il nome del passaggio nel messaggio d'errore, così una formula rotta non aggiunge né omette mai una riga in silenzio.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostare righe di fattura extra" href="/producten/bundel-instellen" />
  <Card title="JSON del bundle" href="/producten/bundel-json" />
  <Card title="Gestione contatori" href="/meterbeheer" />
</Cards>


# Panoramica (/it-IT/producten)

Un prodotto è una tariffa o un servizio che metti su una riga di fattura: una notte su una piazzola, un abbonamento mensile, un tag NFC o un kWh di corrente. Ogni prodotto ha un prezzo IVA inclusa. Puoi anche collegargli azioni che Tillor esegue automaticamente, come estendere un'occupazione o stampare uno scontrino. Gli utenti con il permesso **Modifica prodotti** possono creare e modificare i prodotti.

Trovi tutti i prodotti in <UIPath>Amministrazione > Prodotti</UIPath>.

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Elenco dei prodotti con un prodotto demo per una notte" />

<Callout type="info" title="Da sapere">
- Il prezzo è sempre IVA inclusa. Scegli tra 0%, 6%, 9%, 12% o 21%.
- Una modifica a prezzo, conto o azioni vale per le righe che aggiungi dopo. Le fatture esistenti non cambiano.
- Puoi pianificare un nuovo prezzo da oggi o da un giorno successivo, non per il passato.
- Un prodotto disattivato non si può più scegliere sulle fatture, ma resta sulle fatture esistenti.
- Un prodotto eliminato non si può recuperare. Meglio disattivarlo.
- Per ogni combinazione di tipo cliente e tipo contatore esiste un solo prodotto con l'azione **Consumo contatore**.
- Un **Mostra avviso** può contenere al massimo 4000 caratteri.
- Per ogni stampante imposti al massimo 10 copie nella stampa automatica.
- Con **Estendi metodo di accesso** conti al massimo 3660 giorni dopo la data di fine.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

Un prodotto non fa nulla finché non è su una fattura. Se il prodotto ha delle azioni, Tillor le riporta sulla riga di fattura. Contabilizzare e pagare avviano quelle azioni, e così il risultato arriva all'occupazione, al tag o alla stampante.

```mermaid
flowchart TD
  P[Prodotto con azioni] --> R[Riga di fattura su una bozza]
  R -- Contabilizza --> G[Fattura contabilizzata]
  G --> G1[Occupazione: Fatturato fino al avanza]
  G --> G2[Prenotazione creata con Chiedere la piazzola]
  G --> G3[Contabilizzazione bloccata o dati di contatto richiesti]
  G -- Paga --> B[Fattura pagata]
  B --> B1[Occupazione: Pagato fino al avanza]
  B --> B2[Tag NFC ricaricato]
  B --> B3[Metodo di accesso creato o esteso]
  B --> B4[Scontrino o A4 stampato]
```

Un esempio con **Estendi periodo occupazione**: fatturi l'affitto mensile a un cliente. Alla contabilizzazione l'occupazione risulta fatturata fino alla fine del mese. Appena il cliente paga, **Pagato fino al** avanza. Così sull'occupazione vedi cosa è già fatturato e cosa è già pagato. Ne trovi di più in [Occupazioni](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).

Una nota di credito inverte il processo: la contabilizzazione riporta **Fatturato fino al** all'inizio della riga, il pagamento riporta **Pagato fino al**. Vedi [Storno interno](/betalingsverwerking/interne-overboeking) per il caso in cui una nota di credito viene compensata solo con la fattura originale.

## Cosa vedi nell'elenco [#wat-je-in-de-lijst-ziet]

| Colonna | Contenuto |
|---------|-----------|
| **Nome** e **Descrizione** | Nome e spiegazione come li hai inseriti nel prodotto |
| **Info** | Tipo cliente e tipo contatore, solo per i prodotti con l'azione **Consumo contatore** |
| **Azione** | Le azioni presenti sul prodotto. Con più azioni la colonna mostra un riepilogo |
| **Prezzo (IVA incl.)** | Prezzo per unità |
| **IVA %** | L'aliquota IVA |
| **Conto** | Il numero di conto, se lo hai inserito |

Nella riga trovi un'icona a matita per aprire il prodotto e un'icona cestino per eliminarlo. Entrambe sono disattivate se non hai il permesso **Modifica prodotti**.

### Cercare e filtrare [#zoeken-en-filteren]

Scrivi nella barra di ricerca per filtrare subito l'elenco. Puoi inoltre filtrare per **IVA**, **Tipo cliente**, **Tipo contatore**, **Tipo azione**, **Stato** (<Status tone="success">Attiva</Status> o <Status>Disattivato</Status>) e **Conti**. Con **Reimposta** cancelli i filtri in un colpo solo.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Creare un prodotto" href="/producten/product-aanmaken" description="Impostare nome, prezzo, IVA e conto" />
  <Card title="Modificare o eliminare un prodotto" href="/producten/product-bewerken" description="Modificare i dati, disattivare o eliminare" />
  <Card title="Pianificare una modifica di prezzo" href="/producten/prijzen-plannen" description="Un nuovo prezzo da una data e il calcolatore IVA" />
  <Card title="Collegare azioni a un prodotto" href="/producten/acties-instellen" description="Far fare qualcosa a Tillor alla contabilizzazione o al pagamento" />
  <Card title="Azioni del prodotto" href="/producten/productacties" description="Tutte le azioni e le loro impostazioni" />
  <Card title="Impostare righe di fattura extra" href="/producten/bundel-instellen" description="Mettere automaticamente supplementi e note sotto una riga principale" />
  <Card title="Passaggi del bundle" href="/producten/bundel-velden" description="Campi, chiavi dinamiche e segnaposto" />
  <Card title="JSON del bundle" href="/producten/bundel-json" description="La struttura del bundle per le importazioni" />
  <Card title="Esempi pratici" href="/praktijk" description="Esempi svolti dalla pratica" />
</Cards>

## Termini [#begrippen]

- **Prodotto**: un prezzo e una descrizione che possono finire su una riga di fattura.
- **Azione**: qualcosa che Tillor fa automaticamente quando una riga di fattura con questo prodotto viene contabilizzata o pagata.
- **Bundle**: una serie di righe di fattura extra che Tillor mette sotto una riga principale, per esempio supplementi sul Posto fisso.
- **Riga principale e riga figlia**: la riga principale è quella con il prodotto bundle, le righe figlie sono quelle che Tillor aggiunge sotto.
- **Fatturato fino al** e **Pagato fino al**: fino a quando un'occupazione è fatturata, rispettivamente pagata. Vedi [Occupazione](/begrippen#bezetting).
- **Conto**: il numero di conto nella tua contabilità su cui registra un prodotto.


# Pianificare una modifica di prezzo (/it-IT/producten/prijzen-plannen)

Se il prezzo di un prodotto cambia da un certo giorno, lo pianifichi in anticipo. In quel giorno Tillor adegua da sé il prezzo del prodotto. Le fatture esistenti mantengono i loro prezzi.

<Requires permission="Modifica prodotti" />

## Pianificare un prezzo [#een-prijs-plannen]

<Steps>
<Step>
### Apri il prodotto [#open-het-product]
Vai su <UIPath>Amministrazione > Prodotti</UIPath> e apri il prodotto. In fondo alla pagina c'è la scheda **Prezzi pianificati**.

<DocScreenshot src="/screenshots/producten/product-price-changes.png" alt="Scheda Prezzi pianificati con un prezzo pianificato e uno applicato" />
</Step>
<Step>
### Scegli la data [#kies-de-datum]
In **A partire dal** scegli il giorno in cui entra in vigore il nuovo prezzo. Va bene anche oggi, non un giorno nel passato.
</Step>
<Step>
### Inserisci il prezzo [#vul-de-prijs-in]
Scrivi il **Nuovo prezzo (IVA incl.)**. In **Aliquota IVA** lascia **Aliquota IVA attuale** oppure scegli un'altra aliquota che vale da quel giorno. Puoi scegliere anche un [regime senza IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), come **Inversione contabile (servizi UE)**; da quel giorno il prodotto è allo 0% sotto quel regime.
</Step>
<Step>
### Pianifica il prezzo [#plan-de-prijs]
Clicca su **Pianifica prezzo**. Il prezzo compare nell'elenco con lo stato <Status tone="info">Pianificato</Status>.
</Step>
</Steps>

Se scegli oggi come data, il nuovo prezzo vale subito. Per una data successiva il prezzo vale dall'inizio di quel giorno. Tillor usa il fuso orario della tua organizzazione.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

Il prodotto riceve il nuovo prezzo ed eventualmente la nuova aliquota IVA. La riga nell'elenco passa allo stato <Status tone="success">Applicato</Status>. Tillor invia un'e-mail all'indirizzo di assistenza della tua organizzazione, oppure all'indirizzo e-mail generale se manca. La notifica si chiama **Prezzo prodotto pianificato applicato** e mostra il prezzo vecchio e quello nuovo. Vedi anche [Notifiche](/notificaties).

Le fatture già esistenti non cambiano. Solo le righe che aggiungi dopo ricevono il nuovo prezzo.

## Modificare o rimuovere un prezzo pianificato [#een-geplande-prijs-wijzigen-of-verwijderen]

- Se pianifichi di nuovo un prezzo per lo stesso giorno mentre c'è ancora un prezzo pianificato, quello nuovo sostituisce il vecchio.
- Clicca sull'icona cestino accanto a un prezzo pianificato e conferma con **Rimuovi prezzo pianificato**. Il prodotto mantiene in quella data il suo prezzo attuale.
- Un prezzo con lo stato <Status tone="success">Applicato</Status> resta come storico e non lo puoi rimuovere.

## Il calcolatore IVA [#de-btw-calculator]

Accanto al campo del prezzo, sia in **Nuovo prezzo (IVA incl.)** sia in **Prezzo (IVA incl.)** in **Generale**, c'è una piccola calcolatrice. Con quella apri il **Calcolatore IVA**.

<DocScreenshot src="/screenshots/producten/product-vat-calculator.png" alt="Calcolatore IVA con aliquota IVA, importo IVA esclusa e inclusa e modifica del prezzo con percentuale" />

Nel calcolatore puoi:

- inserire l'importo **IVA esclusa** o **IVA inclusa**. L'altro importo e l'IVA vengono calcolati subito.
- scegliere un'altra **Aliquota IVA**. Il prezzo IVA inclusa viene allora ricalcolato partendo dall'importo IVA esclusa.
- in **Modifica prezzo del %** inserire una percentuale, per esempio 5 per aggiungere il cinque percento o -5 per toglierlo, e cliccare su **Applica**.

Clicca su **Usa questo prezzo** per mettere il prezzo e l'aliquota IVA nel modulo. Poi devi ancora salvare o pianificare il prezzo.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a scegliere una data nel passato">
Un prezzo può valere solo da oggi in poi. Se vuoi modificare un prezzo con effetto retroattivo, modifica le fatture stesse.
</Accordion>
<Accordion title="Pianifica prezzo è grigio">
Per questo serve il permesso **Modifica prodotti**.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Modificare o eliminare un prodotto" href="/producten/product-bewerken" />
  <Card title="Notifiche" href="/notificaties" />
</Cards>


# Creare un prodotto (/it-IT/producten/product-aanmaken)

Un nuovo prodotto è subito disponibile sulle fatture. Azioni e righe di fattura extra le imposti poi nella pagina del prodotto.

<Requires permission="Modifica prodotti" />

<Steps>
<Step>
### Apri la finestra di dialogo [#open-het-dialoogvenster]

Vai su <UIPath>Amministrazione > Prodotti</UIPath> e clicca in alto a destra su **Nuovo prodotto**.
</Step>
<Step>
### Compila i dati di base [#vul-de-basisgegevens-in]

<DocScreenshot src="/screenshots/producten/product-create-dialog.png" alt="Finestra Crea prodotto con i campi di base" />

| Campo | Cosa inserisci |
|------|---------------|
| **Nome** (obbligatorio) | Il nome come compare sulle fatture |
| **Descrizione** | Una breve spiegazione (facoltativa) |
| **Prezzo (IVA incl.)** | L'importo per unità, IVA inclusa |
| **IVA %** | Scegli tra 0%, 6%, 9%, 12% o 21%, oppure un regime senza IVA come **Inversione contabile (servizi UE)**. Vedi [Inversione contabile e altri regimi](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) |
| **Conto** | Il numero di conto per la tua contabilità (facoltativo) |
| **Controlla il saldo del cliente su questo conto** | Per le cauzioni: rifiuta le fatture che porterebbero il saldo del cliente sotto zero. Vedi [Controllare il saldo del cliente](#het-saldo-van-de-klant-bewaken) |
</Step>
<Step>
### Crea il prodotto [#maak-het-product-aan]

Clicca su **Crea**. Tillor apre la pagina del prodotto, dove puoi aggiungere azioni e righe di fattura extra.
</Step>
</Steps>

<Callout type="info">
Il prezzo è sempre IVA inclusa. Tillor calcola l'importo dell'IVA con la percentuale scelta e lo mostra a parte sulla fattura.
</Callout>

## Numero di conto [#grootboeknummer]

Con il numero di conto colleghi un prodotto a un conto della tua contabilità. Il numero viene usato nell'esportazione verso il software di contabilità. Lascia il campo vuoto se non vuoi collegare il prodotto a un conto proprio.

Una modifica del numero di conto vale per le nuove righe di fattura. Le fatture contabilizzate non cambiano.

## Controllare il saldo del cliente [#het-saldo-van-de-klant-bewaken]

Per le cauzioni attivi **Controlla il saldo del cliente su questo conto**. Tillor somma allora per ogni cliente tutte le righe di fattura contabilizzate su quel conto e rifiuta ogni fattura che porterebbe quel saldo sotto zero. Così una cauzione non si può rimborsare per errore due volte. Questa opzione richiede un numero di conto.

Sulla fattura vedi sotto la riga il saldo del cliente su quel conto e quello che diventa dopo questa fattura. Le bozze non contano. Anche riportare in bozza una fattura di cauzione contabilizzata o spostarla su un altro cliente non è possibile se il saldo andrebbe sotto zero.

Nella scheda **Fatturazione** di un cliente, sotto **Fatture**, c'è la tabella **Conti**: ogni conto su cui per quel cliente è stato registrato qualcosa o su cui c'è un [saldo iniziale](#beginsaldi-van-voor-tillor), con il saldo. Anche un conto netto a zero resta visibile. Un conto controllato su cui il cliente non ha ancora registrato nulla non compare.

Se almeno un prodotto controlla un conto, il filtro **Protezione** è per impostazione predefinita su **A** e vedi solo i conti controllati. Cancella il filtro per vedere anche gli altri conti, come i conti di ricavo. Senza prodotti controllati il filtro è spento e vedi subito tutti i conti. Con il filtro **Saldo** tieni solo i conti che non sono a zero. Uno scudo accanto al numero mostra quali conti sono controllati.

Apri un conto e vedi le fatture contabilizzate con una riga su quel conto, dalla più vecchia alla più recente, con l'importo e il **Saldo progressivo**: il saldo dopo quella fattura. Se sul conto ci sono più di 100 fatture, vedi le ultime 100. Il saldo progressivo conta comunque anche le fatture più vecchie.

Con il permesso **Ignorare il saldo del conto** puoi contabilizzare comunque. Indichi allora una motivazione, che finisce nella cronologia della fattura. Senza quel permesso **Contabilizza** resta grigio finché il saldo andrebbe sotto zero.

<Requires permission="Ignorare il saldo del conto" />

## Saldi iniziali di prima di Tillor [#beginsaldi-van-voor-tillor]

Una cauzione che il cliente ha pagato prima che iniziassi con Tillor non è su una fattura in Tillor. Inserisci un importo simile come **saldo iniziale** sul conto del cliente. Conta nel saldo e nel controllo, quindi più avanti rimborsi quella cauzione normalmente, senza motivazione. Un saldo iniziale non è una fattura: non riceve numero né IVA, e non va alla tua contabilità, perché la tua vecchia contabilità lo ha già.

**Un cliente:** apri il cliente, scheda **Fatturazione**, scheda **Conti**, e clicca su **Saldo iniziale**. Inserisci il conto (per es. 428002), l'importo, la data del vecchio saldo e un riferimento, per esempio il documento del tuo vecchio sistema. Un importo negativo è un importo che il cliente deve ancora. Apri il conto e vedi il saldo iniziale in cima al saldo progressivo, con i pulsanti per modificarlo o rimuoverlo. Sotto il saldo vedi quanto ne è saldo iniziale.

**Tutti i clienti in una volta:** vai su <UIPath>Amministrazione > Fatture</UIPath> e clicca su **Importa saldi iniziali**. Incolla le righe da un foglio di calcolo o scegli un file CSV, con una riga di intestazione e le colonne cliente (il numero cliente di Tillor), conto, importo, data, riferimento ed eventualmente nota. Clicca su **Controlla**: vedi quali righe sono nuove, quali Tillor aggiorna e quali clienti non sono stati trovati, più il totale per conto. Confronta quel totale con il bilancio della tua vecchia contabilità e poi clicca su **Importa**. Una riga con un riferimento che il cliente ha già su quel conto aggiorna quel saldo iniziale invece di aggiungerlo due volte, quindi puoi tranquillamente rifare un'importazione.

Un saldo iniziale già rimborsato normalmente non si può più rimuovere né ridurre: il saldo andrebbe sotto zero. Se hai il permesso **Ignorare il saldo del conto**, Tillor in quel caso chiede una motivazione ed esegue comunque la modifica, per esempio per togliere un vecchio saldo iniziale accorpato a un cliente che in Tillor ha già ricevuto indietro la sua cauzione. Vale anche per un'importazione che porta un saldo sotto zero. Ogni modifica finisce nella cronologia del cliente, con la tua motivazione se hai ignorato il controllo.

<Requires permission="Gestire i saldi iniziali" />

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il prodotto è subito nell'elenco e lo puoi scegliere sulle fatture in bozza.
- Nella pagina del prodotto imposti poi [azioni](/producten/acties-instellen), [righe di fattura extra](/producten/bundel-instellen) e [prezzi pianificati](/producten/prijzen-plannen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a creare o modificare un prodotto">
Creare e modificare richiede il permesso **Modifica prodotti**. Chiedi a un amministratore della tua organizzazione di aggiungere quel permesso al tuo ruolo.
</Accordion>
<Accordion title="Mi manca un'aliquota IVA">
Puoi scegliere solo tra 0%, 6%, 9%, 12% e 21%. Altre aliquote non si possono impostare.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Modificare o eliminare un prodotto" href="/producten/product-bewerken" />
  <Card title="Collegare azioni a un prodotto" href="/producten/acties-instellen" />
  <Card title="IVA e imposte" href="/boekhouden/belasting" />
</Cards>


# Modificare o eliminare un prodotto (/it-IT/producten/product-bewerken)

Nella pagina del prodotto modifichi tutto ciò che lo riguarda. Le modifiche valgono per le nuove righe di fattura.

<Requires permission="Modifica prodotti" />

## Modificare un prodotto [#een-product-bewerken]

<Steps>
<Step>
### Apri il prodotto [#open-het-product]

Vai su <UIPath>Amministrazione > Prodotti</UIPath> e clicca sul nome del prodotto o sull'icona a matita nella riga.
</Step>
<Step>
### Modifica i dati [#pas-de-gegevens-aan]

<DocScreenshot src="/screenshots/producten/product-detail.png" alt="Pagina di dettaglio del prodotto con Generale, Righe fattura extra, Azioni riga fattura ed Eventi" />

A sinistra trovi le schede **Generale** e **Righe fattura extra**. A destra ci sono **Azioni riga fattura** ed **Eventi**. In **Generale** ci sono gli stessi campi della creazione, più l'opzione **Disattiva prodotto**.
</Step>
<Step>
### Salva [#sla-op]

In fondo alla scheda **Righe fattura extra** clicca su **Salva**. Quel pulsante salva tutte le modifiche della pagina, anche quelle in **Generale** e in **Azioni riga fattura**. Il pulsante è attivo solo dopo che hai modificato qualcosa.
</Step>
</Steps>

Se vuoi che un nuovo prezzo valga solo da una data successiva, usa la scheda **Prezzi pianificati**. Vedi [Pianificare una modifica di prezzo](/producten/prijzen-plannen).

Sotto **Eventi** vedi una cronologia delle modifiche al prodotto, come prezzo, conto e azioni. Per ogni modifica ci sono l'ora, l'utente e, dove possibile, la differenza tra prima e dopo.

## Disattivare un prodotto [#een-product-uitschakelen]

Attiva **Disattiva prodotto** e salva. Un prodotto disattivato non si può più scegliere sulle fatture, ma resta nell'elenco e sulle fatture esistenti. Nell'elenco e nella pagina del prodotto lo vedi come <Status>Disattivato</Status>. Così conservi lo storico senza usare più il prodotto.

## Eliminare un prodotto [#een-product-verwijderen]

<Steps>
<Step>
### Scegli elimina [#kies-verwijderen]

Nell'elenco clicca sull'icona cestino accanto al prodotto. Nella pagina del prodotto apri il menu con i tre puntini nell'intestazione e scegli **Elimina prodotto**.
</Step>
<Step>
### Conferma [#bevestig]

<DocScreenshot src="/screenshots/producten/product-delete-dialog.png" alt="Finestra di conferma per eliminare il prodotto" />

Nella finestra clicca su **Elimina**.
</Step>
</Steps>

<Callout type="warn" title="Attenzione">
Eliminare non si può annullare. Le fatture su cui il prodotto compare già restano invariate. Se il prodotto è un passaggio nel bundle di un altro prodotto, Tillor da quel momento salta quel passaggio. Se non vuoi solo più usare il prodotto, meglio disattivarlo.
</Callout>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un nuovo prezzo, un altro conto o un'altra azione valgono per le righe che aggiungi dopo. Le fatture esistenti restano come erano.
- Un prodotto disattivato sparisce dall'elenco di scelta sulle fatture, ma resta visibile nell'elenco dei prodotti.
- Ogni modifica finisce nella cronologia **Eventi** del prodotto, con utente e ora.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Salva è grigio">
Il pulsante funziona solo dopo che hai modificato qualcosa, e solo con il permesso **Modifica prodotti**.
</Accordion>
<Accordion title="Il bundle non viene salvato">
Ogni passaggio prodotto nel bundle deve avere un prodotto e ogni passaggio info deve avere un testo. Completa e salva di nuovo. Vedi [Impostare righe di fattura extra](/producten/bundel-instellen).
</Accordion>
<Accordion title="Il salvataggio non riesce con un prodotto con Consumo contatore">
Per ogni combinazione di tipo cliente e tipo contatore può esistere un solo prodotto con l'azione **Consumo contatore**. Se quella combinazione è già su un altro prodotto, il salvataggio viene rifiutato. Modifica quell'altro prodotto o scegli un'altra combinazione.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Collegare azioni a un prodotto" href="/producten/acties-instellen" />
  <Card title="Pianificare una modifica di prezzo" href="/producten/prijzen-plannen" />
  <Card title="Impostare righe di fattura extra" href="/producten/bundel-instellen" />
</Cards>


# Azioni del prodotto (/it-IT/producten/productacties)

Attivi le azioni nella pagina del prodotto, nella scheda **Azioni riga fattura**. Come si fa è spiegato in [Collegare azioni a un prodotto](/producten/acties-instellen). Questa pagina descrive ogni azione. Come le azioni si collegano a occupazioni, tag e stampanti alla contabilizzazione e al pagamento lo vedi in [Come si collega tutto?](/producten#hoe-hangt-dit-samen).

## Ricarica tag NFC [#nfc-tag-opladen]

Quando una fattura con questo prodotto viene pagata, Tillor ricarica automaticamente un tag NFC. Usalo per prodotti con cui i clienti ottengono credito o accesso su un tag. Il prodotto non ha campi aggiuntivi.

## Periodo [#periode]

Il prodotto rappresenta un servizio su un periodo di tempo, come una tariffa giornaliera, un abbonamento settimanale o una tariffa mensile.

| Campo | Significato |
|------|-----------|
| **Per unità** | Numero di unità per periodo, minimo 1 |
| **Unità periodo** | **Giorno**, **Settimana** o **Mese** |
| **Estendi automaticamente metodi di accesso** | Al pagamento Tillor estende tutti i metodi di accesso del cliente fino alla data di fine del periodo |
| **Chiedere la piazzola** | Sulla riga di fattura scegli una piazzola. Alla contabilizzazione Tillor crea una prenotazione per quel soggiorno |
| **Registra l'arrivo alla conferma** | Solo con **Chiedere la piazzola**. Appena la fattura è contabilizzata, Tillor porta la prenotazione a <Status tone="success">Check-in effettuato</Status> |
| **Registra l'arrivo al pagamento** | Solo con **Chiedere la piazzola**. Appena la fattura è pagata, Tillor porta la prenotazione a <Status tone="success">Check-in effettuato</Status> |
| **Adulti inclusi** | Solo con **Chiedere la piazzola**. Numero di adulti sulla prenotazione, 2 per impostazione predefinita. Puoi inserire da 0 a 99 |

### Prenotazioni con Chiedere la piazzola [#reserveringen-bij-terrein-vragen]

- La prenotazione riceve lo stesso arrivo e la stessa partenza della riga di fattura e la piazzola scelta come preferenza. Il gruppo lo modifichi poi sulla prenotazione stessa.
- Se riporti la fattura in bozza e modifichi le date o la piazzola, alla nuova contabilizzazione Tillor aggiorna la stessa prenotazione.
- Se togli la piazzola o disattivi **Chiedere la piazzola**, la prenotazione viene annullata. Una prenotazione già con check-out resta.
- Una nota di credito annulla la prenotazione della fattura originale.
- Senza check-in la prenotazione resta su <Status tone="info">Prenotato</Status>. Così funziona un acconto di prenotazione: una piazzola e date nel futuro, senza arrivo.
- Se sono attive entrambe le opzioni di check-in, vale la contabilizzazione.
- Se la fattura è già pagata nel momento in cui contabilizzi di nuovo, Tillor registra di nuovo il check-in.

Sulla cronologia della fattura e della prenotazione vedi la creazione, la modifica, l'annullamento e il check-in, con un rimando all'altra.

## Estendi periodo occupazione [#bezetting-verlengen]

Con questa azione una fattura estende l'occupazione di un cliente su una piazzola, per esempio per il Posto fisso.

- Alla **contabilizzazione** Tillor modifica **Fatturato fino al** dell'occupazione.
- Al **pagamento** Tillor modifica **Pagato fino al**.

Sulla riga di fattura scegli una piazzola. Alla contabilizzazione e al pagamento Tillor collega l'occupazione attiva del cliente su quella piazzola. Tillor conserva anche una copia di quell'occupazione sulla riga, così in seguito vedi quale occupazione era intesa, anche se nel frattempo è stata rimossa. Con **Arrotonda al prossimo confine periodo** sulla riga di fattura allinei i clienti a termine sullo stesso ciclo, secondo la **Frequenza affitto** dell'occupazione.

Se scegli una piazzola su cui il cliente non ha ancora un'occupazione, fai un'offerta. Una riga simile la puoi contabilizzare solo quando il cliente ha la piazzola in occupazione.

| Campo | Significato |
|------|-----------|
| **Scadenza da inizio occupazione** | Alla contabilizzazione Tillor mette la scadenza alla data di inizio del periodo di occupazione sulla riga del Posto fisso, invece del termine di pagamento standard o del termine nella finestra di contabilizzazione. Alla nuova contabilizzazione resta la scadenza originale |

Se il prodotto ha righe di fattura extra, Tillor aggiunge righe figlie sotto la riga principale. Vedi [Impostare righe di fattura extra](/producten/bundel-instellen).

## Estendi metodo di accesso [#toegangsmethode-verlengen]

Con questa azione il pagamento di una fattura estende la validità dei metodi di accesso del cliente. Funziona in due modi:

- **Insieme a Periodo** sulla stessa riga, per esempio un affitto mensile. Tillor estende i metodi scelti fino alla data di fine del periodo.
- **Tramite un bundle** con una riga principale di Posto fisso e passaggi NFC. La base è allora la data di fine della riga principale del Posto fisso. Le impostazioni qui sotto vengono dal prodotto principale, non dal prodotto di supplemento del passaggio NFC. Vedi [Estendere l'NFC tramite il bundle](/producten/bundel-instellen#nfc-verlengen-via-de-bundel).

| Campo | Significato |
|------|-----------|
| **Giorni dopo la data di fine** | Giorni di calendario oltre la data di fine. 0 significa la data di fine stessa, al massimo 3660. Nei bundle lo imposti per ogni passaggio NFC |
| **Giorno della settimana** | Facoltativo. La validità termina nel giorno della settimana più vicino alla data di destinazione. Per impostazione predefinita **Ogni giorno** |
| **Ora** | Facoltativo. Ora nel fuso orario dell'organizzazione. Vuoto significa 23:59 |
| **Tipi metodo di accesso** | Scegli almeno un tipo tra NFC, Codice QR, Riconoscimento targa e Codice PIN. Vedi solo i tipi attivati per la tua organizzazione |
| **Stati** | Vengono estesi solo i metodi con uno di questi stati: <Status tone="success">Attivo</Status> o <Status tone="warning">Bloccato soft</Status>. Per impostazione predefinita solo **Attivo** |
| **Non abbreviare all'estensione** | I metodi il cui **Valido fino a** è già alla nuova data o dopo vengono saltati. Nell'annullamento tramite nota di credito Tillor imposta sempre la data calcolata |

Sotto il campo c'è una riga **Risultato** che spiega in quale momento arriva la validità, per esempio "martedì più vicino alla data di fine + 10 giorni, alle 13:00".

Non è la stessa cosa di **Estendi automaticamente metodi di accesso** in **Periodo**. Quell'interruttore estende al pagamento di un prodotto con solo **Periodo**, senza la azione separata **Estendi metodo di accesso**.

## Crea metodo di accesso [#toegangsmethode-aanmaken]

Al pagamento della fattura Tillor crea un nuovo metodo di accesso per il cliente. L'operatore di cassa sceglie il tipo sulla riga di fattura. Se la riga ha anche l'azione **Periodo**, il periodo diventa la validità del metodo di accesso.

| Campo | Significato |
|------|-----------|
| **Tipi di metodo di accesso** | Tipi tra cui sceglie l'operatore di cassa: Codice QR, Riconoscimento targa o Codice PIN. Con un solo tipo Tillor lo sceglie automaticamente |
| **Il metodo di accesso è facoltativo** | La contabilizzazione non viene mai bloccata da questa riga. Senza un tipo scelto Tillor non crea nulla |
| **Metodo di accesso predefinito** | Solo con più tipi. Questo tipo è selezionato per impostazione predefinita sulle nuove righe di fattura, modificabile per riga. **Nessun predefinito (scegli per riga)** lascia aperta la scelta |
| **Stampa automaticamente il codice QR** | Solo con Codice QR. Tillor stampa il biglietto d'accesso QR sulla stampante di scontrini appena viene creato |
| **Converti automaticamente i codici in targa** | I nuovi codici QR e PIN vengono sostituiti dalla targa rilevata quando vengono usati a una sbarra con telecamera. Modificabile per riga |

Una riga si può contabilizzare solo se è stato scelto un tipo, a meno che l'azione sia facoltativa. Con il Riconoscimento targa deve essere inserita anche la targa.

## Richiedi dati di contatto [#contactgegevens-vragen]

Sulla riga di fattura compaiono campi per indirizzo e-mail e numero di telefono. Tillor li richiede alla contabilizzazione.

| Campo | Significato |
|------|-----------|
| **Chiedi indirizzo e-mail** | Mostra un campo e-mail sulla riga di fattura |
| **Indirizzo e-mail obbligatorio** | Solo se chiedi un indirizzo e-mail. La contabilizzazione è bloccata finché il campo non è compilato |
| **Chiedi numero di telefono** | Mostra un campo telefono sulla riga di fattura |
| **Numero di telefono obbligatorio** | Solo se chiedi un numero di telefono. La contabilizzazione è bloccata finché il campo non è compilato |

## Impedisci prenotazione [#boeken-blokkeren]

Usalo per prodotti che devono stare solo su fatture in bozza. Se una riga simile è su una fattura in bozza, non puoi rendere la fattura definitiva. Non c'è un campo aggiuntivo. Tillor blocca la contabilizzazione finché la riga è presente.

## Mostra avviso [#melding-tonen]

Mostra un avviso sotto la riga di fattura, per esempio "Attenzione: usare solo per turisti giornalieri". Alla contabilizzazione o al pagamento non succede nulla.

| Campo | Significato |
|------|-----------|
| **Stile dell’avviso** | **Informativo**, **Avviso**, **Errore**, **Riuscito** o **Neutro** |
| **Testo dell’avviso** | Il testo, al massimo 4000 caratteri. Il Markdown è supportato (grassetto, elenchi, link) |

Sotto il testo vedi subito un'anteprima dell'avviso. Il testo viene copiato sulla riga di fattura. Le modifiche successive al prodotto non cambiano le fatture esistenti.

## Consumo contatore [#meterverbruik]

Con questa azione il prodotto diventa la tariffa per il consumo dei contatori. Tillor lo usa per i consumi in sospeso e per la fatturazione automatica delle letture dei contatori. Scegli due campi.

| Campo | Opzioni |
|------|-------|
| **Tipo cliente** | **Standard**, **Roulotte a noleggio per lavoratori**, **Roulotte di traino del lavoratore** |
| **Tipo contatore** | **Elettricità**, **Acqua**, **Gas** |

Per ogni combinazione di tipo cliente e tipo contatore può esistere un solo prodotto. Nell'elenco entrambi i valori sono nella colonna **Info**. Se un cliente non ha un prodotto proprio per il suo tipo cliente, Tillor usa il prodotto per **Standard** con lo stesso tipo contatore.

## Stampa termica e stampa A4 [#thermisch-printen-en-a4-printen]

Attiva **Stampa termica** e **Stampa A4** separatamente. Appena almeno una delle due è attiva, compare il blocco **Stampa automatica**. Lì imposti per ogni stampante cosa viene stampato al pagamento della fattura.

| Campo | Significato |
|------|-----------|
| **Copie stampa termica** | Numero di copie sulla stampante termica (stampante di scontrini). 0 spegne quella stampante |
| **Copie stampa A4** | Numero di copie sulla stampante A4. 0 spegne l'A4 |
| **Tempistica stampa** | **Usa impostazioni (per tipo pagamento)** (predefinito), **Stampa immediata** o **Prossimo orario cutoff** |

Puoi impostare al massimo 10 copie per stampante. Con **Usa impostazioni (per tipo pagamento)** vale l'impostazione della tua organizzazione per tipo di pagamento.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Collegare azioni a un prodotto" href="/producten/acties-instellen" />
  <Card title="Impostare righe di fattura extra" href="/producten/bundel-instellen" />
  <Card title="Gestione contatori" href="/meterbeheer" />
  <Card title="NFC" href="/nfc" />
</Cards>


# Prenotazioni (/it-IT/reserveringen)

Con le prenotazioni tieni traccia dei soggiorni nel tuo parco: chi arriva quando, su quale piazzola e con quanti ospiti. Da una prenotazione gestisci anche il check-in e il check-out. Vedi tutte le prenotazioni su una cronologia sotto **Prenotazioni** e per cliente nella scheda **Prenotazioni**. Inizia da [Creare una prenotazione](#een-reservering-aanmaken).

<Callout type="info" title="Da sapere">
- Ogni prenotazione appartiene a un cliente e riceve automaticamente un **Numero prenotazione** unico. Quel numero non si può modificare.
- La data di check-out deve essere dopo la data di check-in. Lo stesso giorno o prima Tillor lo rifiuta.
- Una targa è fatta di lettere e cifre, al massimo 10 caratteri, senza spazi né trattini.
- Check-in e annullamento sono possibili solo dallo stato **Prenotato**. Annullare non si può più dopo il check-in.
- Una prenotazione non è la stessa cosa di un'occupazione: una prenotazione è una riserva per un soggiorno, un'occupazione collega un cliente a una piazzola per un periodo, vedi [Occupazioni](/bezettingen).
- Le note di una prenotazione sono interne e non vengono mai condivise con il cliente.
</Callout>

## Come si collega tutto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Cliente] --> R[Prenotazione]
  R -->|Check-in| I[Ospite sulla piazzola]
  I -->|Check-out| U[Soggiorno concluso]
  R -->|Annulla prenotazione| A[Annullata]
  R --> F[Fatture del cliente]
```

Trovi le fatture del cliente nel profilo cliente sotto **Fatturazione**.

## La cronologia [#de-tijdlijn]

Vai su **Prenotazioni** nel menu principale. La cronologia mostra le prenotazioni per piazzola su un calendario. Con la vista scegli giorno, settimana, mese, trimestre o anno, e salti a una data con **Vai alla data**.

<DocScreenshot src="/screenshots/reserveringen/reservations-list.png" alt="Cronologia delle prenotazioni" />

- Clicca o trascina su un tratto libero per aggiungere una prenotazione. In alto a destra c'è anche **Nuova prenotazione**.
- Se trascini una prenotazione su altre date, Tillor chiede **Aggiornare le date della prenotazione?** Solo dopo la tua conferma la prenotazione cambia.
- Il menu contestuale di una prenotazione contiene **Visualizza prenotazione**, **Copia link** e **Annulla prenotazione**.

## Creare una prenotazione [#een-reservering-aanmaken]

Prima di iniziare:

- Ti serve un cliente. Se non esiste ancora, lo crei mentre inizi, vedi [Gestione clienti](/klantenbeheer).
- Sai quale piazzola vuole l'ospite? Allora la scegli. Altrimenti lasci il campo vuoto.

<Steps>
<Step>
### Avvia la prenotazione [#start-de-reservering]
<Tabs items={["Da Prenotazioni", "Dal profilo cliente"]}>
<Tab value="Da Prenotazioni">
Clicca in alto a destra su **Nuova prenotazione**. Scegli un cliente esistente o creane uno nuovo.
</Tab>
<Tab value="Dal profilo cliente">
Apri il cliente tramite **Clienti**, vai alla scheda **Prenotazioni** e clicca su **Nuova prenotazione**.
</Tab>
</Tabs>
</Step>
<Step>
### Compila il modulo [#vul-het-formulier-in]
Vedi [Il modulo di prenotazione](#het-reserveringsformulier) qui sotto per tutti i campi.
</Step>
<Step>
### Crea la prenotazione [#maak-de-reservering-aan]
Clicca su **Crea prenotazione**.
</Step>
</Steps>

### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- La prenotazione riceve lo stato <Status tone="info">Prenotato</Status> e un numero di prenotazione.
- Se **E-mail di conferma automatica** è attiva, il cliente riceve una conferma.
- Trovi la prenotazione sulla cronologia e nella scheda **Prenotazioni** del cliente.
- Se vuoi che un'automazione reagisca a una prenotazione nuova o modificata, usa un trigger, vedi [Trigger](/automatiseringen/triggers).

## Il modulo di prenotazione [#het-reserveringsformulier]

### Date e durata del soggiorno [#datums-en-verblijfsduur]

- **Check-in**: scegli la data di arrivo.
- **Check-out**: scegli la data di partenza. Dopo la data di check-in il selettore del check-out si apre da solo. La data di partenza deve essere dopo la data di arrivo.
- **Numero di notti**: lo calcola Tillor da sé.

### Numeri e animali [#aantallen-en-dieren]

Indica il numero di **Adulti** (minimo 1), **Bambini**, **Neonati** e **Animali** con i pulsanti più e meno.

### Piazzola [#terrein]

- **Piazzola**: scegli una piazzola se l'ospite ha una preferenza. L'elenco mostra solo piazzole prenotabili senza occupazione attiva che sono libere nel periodo scelto. Tillor esclude le prenotazioni attive sovrapposte sulla stessa piazzola. Se modifichi le date, l'elenco si aggiorna. Nessuna preferenza? Lascia il campo vuoto.
- **Includi piazzole non prenotabili**: mostra anche le piazzole che non si possono prenotare online, per esempio i posti annuali fissi. Se la prenotazione è già su una piazzola simile, questa spunta è attiva da sola.
- **Includi terreni occupati**: mostra anche le piazzole che hanno già un'occupazione.

### Targhe [#nummerplaten]

Scrivi una targa, premi **Invio** e ripeti per ogni targa. Una crocetta su una targa la rimuove. Le targhe possono contenere solo lettere e cifre, al massimo 10 caratteri.

Le targhe di una prenotazione si trovano con la ricerca. L'accesso alla sbarra lo gestisci a parte, nel cliente nella scheda **Controllo accessi**, vedi [Controllo accessi](/toegangscontrole).

### Note [#notities]

Usa il campo note per osservazioni interne, come richieste speciali o accordi.

### Preferenze comunicazione [#communicatievoorkeuren]

- **E-mail di conferma automatica**: invia una conferma dopo la creazione.
- **Pagamento online**: consente al cliente di pagare la prenotazione online.

## Visualizzare e modificare una prenotazione [#een-reservering-bekijken-en-bewerken]

Clicca su una prenotazione sulla cronologia o nel profilo cliente per aprire la pagina di dettaglio.

<DocScreenshot src="/screenshots/reserveringen/reservation-detail.png" alt="Pagina di dettaglio di una prenotazione" />

- **Dettagli prenotazione** (a sinistra): il modulo completo. Modifica ciò che vuoi e clicca su **Salva**. Con **Annulla** ripristini i valori originali. Accanto al titolo c'è **Copia link prenotazione**, utile per incollare un link cliccabile in un documento.
- **Azioni prenotazione** (a destra): i pulsanti qui sotto.
- **Note** (a destra): discussione interna su questa prenotazione.
- **Attività** (a destra): una cronologia con creazione, check-in, check-out, annullamento, annullamenti di azioni e dati modificati, con ora e utente. Per una modifica vedi quali campi sono stati cambiati (prima / dopo).

## Check-in, check-out e annullamento [#inchecken-uitchecken-en-annuleren]

Nella pagina di dettaglio le azioni sono in **Azioni prenotazione**. Ogni azione chiede una conferma.

| Azione | Quando è possibile | Risultato |
|---|---|---|
| **Check-in** | Stato <Status tone="info">Prenotato</Status> | Stato <Status tone="success">Check-in effettuato</Status> |
| **Check-out** | Stato <Status tone="success">Check-in effettuato</Status> | Stato <Status>Check-out effettuato</Status> |
| **Annulla prenotazione** | Solo prima del check-in | Stato <Status>Annullato</Status> |
| **Annulla annullamento** | Solo prima del check-in | Torna a <Status tone="info">Prenotato</Status> |
| **Annulla check-in** | In caso di check-in sbagliato. Se l'ospite aveva già fatto il check-out, annulla prima il check-out | Torna a <Status tone="info">Prenotato</Status> |
| **Annulla check-out** | In caso di check-out sbagliato | Torna a <Status tone="success">Check-in effettuato</Status> |

Inoltre ci sono **Invia modulo di conferma al cliente (SMS)** e **Crea attività**. Con l'ultima crei un'attività da questa prenotazione.

Una prenotazione annullata non si può sottoporre a check-in né a check-out. Annulla prima l'annullamento.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice: Prenotazione non creata">
Il messaggio è **Impossibile creare la prenotazione.** Controlla che sia stato scelto un cliente e che la data di check-out sia dopo quella di check-in. Lo stesso giorno o prima viene rifiutato.
</Accordion>
<Accordion title="Tillor dice: Prenotazione non aggiornata">
Le tue modifiche non sono state salvate. Controlla le date (il check-out deve essere dopo il check-in), le targhe e il numero di adulti, e clicca di nuovo su **Salva**.
</Accordion>
<Accordion title="Tillor dice: Check-in non riuscito">
La prenotazione deve avere lo stato Prenotato. Se ha già fatto il check-in o il check-out, o è annullata, il check-in non è possibile. Ricarica la pagina e guarda qual è ora lo stato. Se è annullata, fai prima **Annulla annullamento**.
</Accordion>
<Accordion title="Tillor dice: Check-out non riuscito">
Il check-out è possibile solo per una prenotazione con check-in effettuato. Se l'ospite non ha ancora fatto il check-in o ha già fatto il check-out, non funziona.
</Accordion>
<Accordion title="Tillor dice: Impossibile annullare">
Annullare è possibile solo prima del check-in. Se l'ospite ha già fatto il check-in, annulla prima il check-in con **Annulla check-in** e poi annulla la prenotazione.
</Accordion>
<Accordion title="La piazzola non è nell'elenco">
L'elenco mostra solo piazzole prenotabili senza occupazione che sono libere nel periodo scelto. Controlla le date. Attiva **Includi piazzole non prenotabili** o **Includi terreni occupati** se intendi una piazzola simile.
</Accordion>
<Accordion title="Una targa non viene aggiunta">
Una targa può contenere solo lettere e cifre ed essere lunga al massimo 10 caratteri. Togli spazi e trattini.
</Accordion>
</Accordions>

## Termini [#begrippen]

- **Prenotazione**: una riserva per un soggiorno. Vedi [prenotazione](/begrippen#reservering).
- **Prenotato, Check-in effettuato, Check-out effettuato, Annullato**: i quattro stati di una prenotazione.
- **Numero prenotazione**: il numero automatico con cui ritrovi una prenotazione.
- **Occupazione**: un cliente su una piazzola per un periodo, indipendentemente da una prenotazione. Vedi [occupazione](/begrippen#bezetting).
- **Cronologia**: la panoramica delle prenotazioni per piazzola su un calendario.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione clienti" href="/klantenbeheer" />
  <Card title="Occupazioni" href="/bezettingen" />
  <Card title="Controllo accessi" href="/toegangscontrole" />
  <Card title="Elaborazione pagamenti" href="/betalingsverwerking" />
  <Card title="Esempi pratici" href="/praktijk" />
</Cards>


# Condividere le attività (/it-IT/taken/delen)

Vuoi mostrare le attività a qualcuno che non lavora in Tillor, o vederle nel tuo calendario? Allora crei un link di condivisione. Ce ne sono di due tipi.

| Tipo | Che cos'è |
|---|---|
| **Pagina condivisibile** | Una bacheca di sola lettura con ciò che c'è da fare. Segue le attività, quindi le modifiche fatte in Tillor vi compaiono |
| **Calendario (ICS)** | Un abbonamento al calendario, ad esempio per Google Calendar, Outlook o Calendario di Apple |

## Creare un link [#een-link-maken]

1. Clicca sull'icona di condivisione in alto a destra nella pagina delle attività (tooltip **Condividi questa vista**). Trovi la stessa icona anche nella scheda della dashboard **Attività per Lei**
2. In **Tipo di link** scegli **Pagina condivisibile** o **Calendario (ICS)**
3. In **Contenuto** scegli che cosa condividere: **Le mie attività assegnate** o una delle tue viste. Se apri la finestra da una vista, questa è già selezionata
4. Se vuoi, limita il contenuto con i **Filtri**: **Stato**, **Priorità**, **Assegnato a**, **Etichetta**, **Vista**, **Collegato a** e **Bloccata**. I filtri vengono salvati nel link e restringono soltanto ciò che la fonte mostra già
5. Clicca su **Crea link**

<DocScreenshot src="/screenshots/taken/task-share-dialog.png" alt="Finestra Condividi le attività con tipo di link, contenuto e filtri" />

In **Link precedenti** trovi tutti i link che hai creato per questa fonte. Per ogni link puoi:

- **Copia link**
- Per un link di calendario, **Aggiungi al calendario**, che apre subito l'abbonamento nella tua app di calendario
- **Revoca** (dopo conferma). Il link smette di funzionare. Gli altri link restano validi. Un link revocato resta nell'elenco con il contrassegno **Revocato**

<Callout type="warn">
Un link di condivisione è privato, ma chiunque lo abbia può vedere le attività, anche senza accedere. Condividilo solo con chi ne ha il diritto e revocalo non appena non serve più.
</Callout>

## La pagina condivisibile [#de-deelbare-pagina]

La pagina mostra le attività per gruppo, con per ogni attività il nome, lo stato, la priorità, la scadenza, le etichette e i nomi dei colleghi assegnati. Non ci sono pulsanti per modificare qualcosa. Se un gruppo è grande, vedi **[numero] di [totale]** attività.

Per impostazione predefinita compaiono solo le attività aperte, a meno che tu non imposti un filtro sullo stato o condivida una vista. Se non c'è nulla da fare, vedi **Al momento non c'è nulla da fare.**

## Il calendario [#de-agenda]

Nel calendario compaiono le attività con una **scadenza** o un **promemoria**. Le attività senza data non ci sono.

- I promemoria ricorrenti compaiono come una serie e ricevi un avviso a ogni promemoria
- Senza promemoria ricevi un avviso un'ora prima della scadenza
- Le attività completate restano visibili ancora per due settimane, come completate, e poi scompaiono
- Con una vista, il calendario segue la vista, a prescindere da chi sia assegnato alle attività. Se chi ha creato il link non può più vedere la vista, il link smette di funzionare

<Callout type="info">
In Google Calendar, per un calendario sottoscritto devi attivare anche le notifiche predefinite, altrimenti gli avvisi non arrivano.
</Callout>

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il link funziona subito e continua a funzionare finché non lo revochi. Chiunque abbia il link può vedere le attività, anche senza accedere.
- Una pagina condivisibile segue le attività: le modifiche fatte in Tillor vi compaiono.
- Un abbonamento al calendario si aggiorna da solo nella tua app di calendario e ti avvisa un'ora prima della scadenza o a ogni promemoria.
- Se revochi un link, smette di funzionare solo quel link. Gli altri link restano validi e il link revocato resta nell'elenco con il contrassegno **Revocato**.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice Impossibile creare il link">
Il link non è stato creato. Controlla di aver scelto una fonte in **Contenuto** e riprova. Il messaggio **Impossibile caricare i link.** significa che l'elenco dei link precedenti non si è aperto. Riapri la finestra.
</Accordion>
<Accordion title="La pagina mostra Al momento non c'è nulla da fare">
Non ci sono attività che corrispondono alla fonte e ai filtri. Per impostazione predefinita una pagina condivisibile mostra solo le attività aperte.
</Accordion>
<Accordion title="Il calendario non mostra le mie attività">
Nel calendario compaiono solo le attività con una scadenza o un promemoria. Se chi ha creato il link non può più vedere la vista, anche il link smette di funzionare.
</Accordion>
<Accordion title="Non ricevo avvisi in Google Calendar">
Attiva in Google Calendar anche le notifiche predefinite per il calendario sottoscritto.
</Accordion>
<Accordion title="Non voglio più che il link funzioni">
Scegli **Revoca** accanto al link e conferma in **Revocare questo link?**. Se non riesce, compare **Impossibile revocare il link**: riprova.
</Accordion>
</Accordions>


# Filtrare (/it-IT/taken/filteren)

Sopra le attività c'è una barra di ricerca con i pulsanti dei filtri accanto. I filtri appartengono alla vista: se li salvi, determinano quali attività mostra la vista. In una vista filtrata sono le attività che corrispondono ai filtri. In un elenco sono le attività aggiunte manualmente che corrispondono anche ai filtri.

<DocScreenshot src="/screenshots/taken/task-filter-status.png" alt="Il filtro per stato con le scelte Includi ed Escludi e i quattro stati" />

## Filtri sempre visibili [#altijd-zichtbare-filters]

| Filtro | Che cosa scegli |
|---|---|
| **Stato** | Uno o più stati |
| **Priorità** | Una o più priorità |
| **Assegnato a** | Uno o più colleghi, oppure **Io** per te stesso |
| **Etichetta** | Una o più etichette |
| **Vista** | Attività che si trovano in un'altra vista (manuale) |
| **Bloccata** | **Bloccata** o **Non bloccata** |
| **Collegato a** | Il tipo di record a cui è collegata l'attività, ad esempio un cliente, una piazzola, una fattura o una prenotazione |
| **Testo** | Parole che il nome o la descrizione contiene oppure non contiene, vedi sotto |
| **Scadenza** | Un periodo, vedi sotto |

Nei filtri con un elenco scegli in alto **Includi** (attività con i valori scelti) o **Escludi** (attività senza quei valori). In **Collegato a** scegli il tipo di elemento: **Cliente**, **Fattura**, **Prenotazione**, **Contatore**, **Piazzola**, **Nota**, **Conversazione**, **Chiamata**, **Transazione bancaria** o **Prodotto**.

## Filtrare per testo [#filteren-op-tekst]

Con **Testo** mostri solo le attività il cui nome o la cui descrizione contiene, oppure non contiene, un pezzo di testo. Maiuscole e minuscole non contano.

1. Clicca su **Testo**
2. Scegli **Contiene** o **Non contiene**
3. Scrivi il testo in **Testo nel nome o nella descrizione**, ad esempio `Verzekering vervallen:`
4. Clicca su **Aggiungi** o premi Invio

Ripeti per ogni testo che vuoi aggiungere. Ogni testo è un filtro a sé, quindi puoi combinare **Contiene** e **Non contiene**: ad esempio `caravan`, ma non `Verzekering vervallen:`. Con la crocetta accanto a un testo lo togli. Sul pulsante compare il testo stesso, oppure il numero di testi se sono di più.

<Callout>
Se un'attività deve soddisfare **tutti** i testi o **uno** di essi dipende dalla scelta in [Combinare più filtri](#meerdere-filters-combineren). Se vuoi escludere più testi, lascia la scelta su **Tutti i filtri**.
</Callout>

## Filtrare per data [#filteren-op-datum]

**Scadenza** funziona con scelte fisse che si spostano con i giorni, oppure con un periodo personalizzato.

- **Scadute**, **Oggi**, **Domani**, **Questa settimana**, **Settimana prossima**, **Questo mese**
- **Senza data** (attività senza scadenza) e **Con data**
- **Periodo personalizzato**: scegli una data di inizio e una di fine sul calendario e clicca su **Applica periodo**. Il giorno finale è incluso per intero

<DocScreenshot src="/screenshots/taken/task-filter-deadline.png" alt="Il filtro per scadenza con scelte fisse e un calendario per un periodo personalizzato" />

Se clicchi di nuovo su un'opzione scelta, il filtro scompare.

## Combinare più filtri [#meerdere-filters-combineren]

Appena hai due o più filtri compare un menu di scelta:

- **Tutti i filtri**: un'attività deve corrispondere a ogni filtro
- **Almeno un filtro**: basta che un'attività corrisponda a uno dei filtri

Con **Cancelli filtri** rimuovi tutti i filtri in una volta.

## Esempi [#voorbeelden]

- *Tutto ciò che va finito oggi ed è ancora aperto*: filtra **Scadenza** su **Oggi** e **Stato** su tutto tranne **Completato**
- *Attività per cui devo aspettare*: filtra **Stato** su **In attesa di risposta** e **Assegnato a** su **Io**
- *Tutto tranne le notifiche sulle assicurazioni scadute*: filtra **Testo** su **Non contiene** `Verzekering vervallen:`
- *Tutto ciò che riguarda un cliente*: apri il cliente. Nella scheda **Attività** della pagina del cliente trovi tutte le attività collegate a quel cliente

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- I filtri sul tuo schermo restringono ciò che vedi. Solo quando li salvi con **Salva vista** appartengono alla vista e i colleghi vedono la stessa selezione.
- Puoi salvare i filtri anche nella vista integrata **Tutte**. Valgono allora per tutti nella tua organizzazione. Per farlo ti serve il permesso **Gestire etichette e viste condivise**.
- In una vista filtrata le attività compaiono e scompaiono da sole, a seconda che corrispondano o meno ai filtri.
- La barra di ricerca non viene mai salvata.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo più nessuna attività">
Controlla se c'è un filtro attivo, ad esempio un filtro sullo stato che esclude **Completato**, oppure **Tutti i filtri** quando intendevi uno solo dei filtri. Con **Cancelli filtri** ricominci da capo.
</Accordion>
<Accordion title="Dopo l'aggiornamento il filtro è sparito">
Non l'avevi salvato. Scegli **Salva vista** nella barra **Modifiche non salvate**.
</Accordion>
<Accordion title="Non riesco a salvare i filtri in Tutte">
**Salva vista** è disattivato se non hai il permesso **Gestire etichette e viste condivise**, perché **Tutte** vale per l'intera organizzazione. Chiedilo a un amministratore, oppure crea una vista tua con gli stessi filtri.
</Accordion>
<Accordion title="Un'attività di un collega non compare">
Vedi solo le attività che puoi vedere. Un'attività in una vista personale di un collega per te è invisibile. Vedi [Attività private](/taken/prive-taken).
</Accordion>
<Accordion title="Il filtro Scadenza con un periodo personalizzato non mostra nulla">
Dopo aver scelto una data di inizio e una di fine, clicca su **Applica periodo**.
</Accordion>
</Accordions>


# Tabella, bacheca e calendario (/it-IT/taken/indelingen)

Puoi guardare le stesse attività in tre modi. In alto a destra apri **Visualizzazione** per scegliere:

- **Layout**: **Tabella**, **Bacheca** o **Calendario**. Questa scelta c'è solo nelle viste salvate, non in **Tutte**
- **Raggruppa per**: come le attività vengono divise in gruppi o colonne
- **Ordina per** e **Ordine**: **Crescente** o **Decrescente**
- **Tipo**: se la vista è un **Elenco** o una **Vista filtrata**, vedi [Viste](/taken/weergaven#twee-soorten-weergaven). Anche questo c'è solo nelle viste salvate
- **Completato**: per quanto tempo restano visibili le attività completate

<DocScreenshot src="/screenshots/taken/task-view-display-options.png" alt="Il menu Visualizzazione con layout, tipo, raggruppamento, ordinamento e attività completate" />

Le modifiche restano una proposta finché non le salvi, vedi [Salvare o scartare le modifiche](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

## Nascondere le attività completate [#voltooide-taken-verbergen]

In **Completato**, nel menu **Visualizzazione**, decidi per quanto tempo un'attività completata resta nella vista:

| Scelta | Che cosa vedi |
|---|---|
| **Mostra tutte** | Tutte le attività completate (predefinito) |
| **Nascondi** | Nessuna attività completata |
| **Ultimo giorno** | Attività completate nell'ultimo giorno |
| **Ultima settimana** | Attività completate nell'ultima settimana |
| **Ultimo mese** | Attività completate nell'ultimo mese |

Il conteggio parte dal momento in cui l'attività è stata impostata su **Completato**. Un commento o un nuovo nome non cambia nulla. Se riapri un'attività, torna subito nella vista. Se la vista ha già un filtro sullo stato che esclude le attività completate, quel filtro continua a valere.

## Raggruppare [#groeperen]

| Raggruppamento | Risultato |
|---|---|
| **Nessun raggruppamento** | Tutte le attività in un elenco |
| **Stato** | Un gruppo per stato |
| **Priorità** | Un gruppo per priorità |
| **Assegnato a** | Un gruppo per collega |
| **Etichetta** | Un gruppo per etichetta |
| **Cliente** | Un gruppo per cliente |
| **Scadenza** | Gruppi come **In ritardo**, **Oggi**, **Questa settimana**, **Più tardi** e **Nessuna scadenza** |
| **Colonne personalizzate** | Colonne che crei tu, solo nelle viste salvate |

Un'attività con più colleghi assegnati o più etichette compare nel gruppo di ciascuno di loro.

## Ordinare [#sorteren]

Puoi ordinare per **Manuale**, **Scadenza**, **Priorità**, **Stato**, **Nome**, **Creato** o **Aggiornato**. Con **Manuale** decidi tu l'ordine trascinando le schede. Con le altre scelte l'ordine lo decide il campo e trascinare all'interno di una colonna non ha effetto, tranne che con le colonne personalizzate.

## Tabella [#tabel]

La tabella mostra una riga per attività. Con un raggruppamento ottieni un blocco per gruppo. In **Colonne**, nel menu della vista, attivi o disattivi le colonne: **Attività**, **Stato**, **Priorità**, **Scadenza**, **Viste**, **Assegnato a**, **Collegato** e **Etichetta**. La colonna **Collegato** mostra tutti gli elementi a cui è collegata l'attività. La colonna **Attività** resta sempre visibile.

Con molte attività Tillor ne carica prima una parte. Scorri verso il basso o clicca su **Carica altro** per il resto.

## Bacheca [#bord]

La bacheca mostra ogni gruppo come colonna, in stile kanban. In alto in una colonna clicca su **Nuova attività** per crearvi un'attività. Questa riceve automaticamente il valore della colonna, come lo stato o il collega assegnato.

Trascina una scheda in un'altra colonna e l'attività assume il valore di quella colonna:

- in una bacheca per **Stato** cambia lo stato
- con **Priorità** cambia la priorità
- con **Assegnato a** cambia il collega assegnato
- con **Etichetta** e **Cliente** cambia l'etichetta o il cliente
- con **Colonne personalizzate** l'attività si sposta in quella colonna

In una bacheca per **Scadenza** non puoi trascinare le schede in un'altra colonna, perché bisognerebbe inventare una scadenza. Modifica la scadenza nell'attività stessa.

Se in una colonna ci sono più attività di quelle mostrate, in fondo compare **Altri [numero]**. Una scheda bloccata da altre attività o che ne blocca altre lo mostra, ad esempio **Bloccata da 1 attività**.

### Colonne personalizzate [#eigen-kolommen]

Con **Colonne personalizzate** crei tu le colonne, ad esempio *Da pianificare*, *Ordinato* e *Pronto*:

1. In **Visualizzazione**, in **Raggruppa per**, scegli **Colonne personalizzate** (oppure sceglilo già alla creazione)
2. A destra nella bacheca clicca su **Nuova colonna** e dai un nome alla colonna
3. Dal menu di una colonna scegli **Modifica** per cambiare il nome o **Elimina**
4. Trascina le colonne dal titolo per cambiarne l'ordine

<DocScreenshot src="/screenshots/taken/task-view-own-columns.png" alt="Bacheca con colonne personalizzate Da pianificare, Ordinato e Pronto, più Nuova colonna" />

Le nuove colonne personalizzate partono vuote. Ogni attività nella vista si trova allora prima in **Nessuna colonna** finché non la assegni a una colonna. In un elenco puoi nascondere queste attività con la casella **Mostra attività senza colonna**. In una vista filtrata restano visibili, altrimenti non potresti mai assegnarle.

<Callout type="warn">
Se passi da **Colonne personalizzate** a un altro raggruppamento e lo salvi, le colonne personalizzate di quella vista vengono eliminate, insieme alla posizione di ogni attività al loro interno. Non si può annullare. Tillor mostra prima un avviso.
</Callout>

### Assegnare attività a un elenco [#taken-toewijzen-aan-een-lijst]

Nella bacheca di un elenco, finché ci sono attività che non vi si trovano ancora, compare il pulsante **Assegna attività**. Apre una colonna aggiuntiva **Non in questa vista** con le attività che corrispondono ai filtri della vista ma non ne fanno ancora parte. Cerca con **Filtra attività...** e trascina un'attività in una colonna per aggiungerla alla vista. Clicca di nuovo sul pulsante per chiudere la colonna.

## Calendario [#kalender]

Il calendario mostra una griglia mensile con le attività nel giorno della loro **scadenza**. La settimana inizia di lunedì e i giorni seguono il fuso orario della tua organizzazione. Le attività senza scadenza non compaiono nel calendario.

- Con le frecce vai al mese precedente o successivo, con **Oggi** torni al mese corrente
- Per ogni giorno vedi al massimo tre attività. Clicca su **+[numero] altri** per vedere il resto del giorno
- Clicca su un'attività per aprirne i dettagli
- Trascina un'attività in un altro giorno per spostare la scadenza. L'orario resta lo stesso, cambia solo il giorno
- Le attività completate sono barrate, stanno sotto quelle aperte del giorno e non si possono trascinare

Il raggruppamento nel calendario non ha effetto: tutte le attività sono nella stessa griglia.

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Le tue modifiche in **Visualizzazione** sono prima una proposta sul tuo schermo. Solo dopo **Salva vista** valgono per chiunque veda la vista.
- Se trascini una scheda in un'altra colonna, cambia l'attività stessa. In una bacheca per **Stato** cambia lo stato e i colleghi lo vedono subito.
- Trascinare una scheda in un calendario sposta la scadenza a quel giorno. L'orario resta uguale.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non riesco a trascinare una scheda in un'altra colonna">
In una bacheca per **Scadenza** non è possibile, perché Tillor dovrebbe inventare una scadenza. Modifica la scadenza nell'attività. Le attività in un calendario le trascini in un altro giorno, tranne quelle completate.
</Accordion>
<Accordion title="Tillor dice che l'attività non può essere spostata">
Vedi **Impossibile spostare l'attività**. La scheda torna al posto precedente. Riprova.
</Accordion>
<Accordion title="Manca la scelta Layout o Tipo">
Ci sono solo nelle viste salvate, non in **Tutte**.
</Accordion>
<Accordion title="Un'attività non compare nel calendario">
Il calendario mostra le attività nella loro scadenza. Un'attività senza scadenza non c'è.
</Accordion>
<Accordion title="Le mie attività sono in Nessuna colonna">
Con le nuove colonne personalizzate tutte le attività partono in **Nessuna colonna** finché non le assegni. Trascinale nella colonna giusta.
</Accordion>
<Accordion title="Le mie colonne personalizzate sono sparite">
Sei passato a un altro raggruppamento e l'hai salvato. In tal caso Tillor elimina le colonne personalizzate e non si può annullare. Tillor avvisa prima.
</Accordion>
</Accordions>


# Panoramica (/it-IT/taken)

Con il sistema delle attività tieni traccia di ciò che va fatto nel tuo parco e da chi. Un'attività può avere una scadenza, un promemoria, uno o più colleghi o gruppi assegnati, etichette, allegati, sottoattività, tempo dedicato e clienti, piazzole, fatture, prenotazioni, contatori, conversazioni o transazioni bancarie collegati.

Le attività si consultano tramite le **viste**. Una vista è un modo salvato di guardare le tue attività, ad esempio *Attività aperte*, *Le mie attività* o *Manutenzione*. Ogni vista compare come scheda in alto nella pagina.

## Dove trovi le attività [#waar-vind-je-taken]

- **Attività** nel menu laterale: la pagina principale con tutte le tue viste
- **Dashboard**: la scheda **Attività per Lei** mostra le attività assegnate a te, o la tua vista preferita
- **Clienti > [cliente] > Attività**: tutte le attività collegate a un cliente
- **Attività aperte**: un blocco nella pagina di un cliente, una prenotazione, una fattura, una piazzola e un contatore

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Pagina delle attività con schede per vista e una bacheca per stato" />

In alto ci sono le viste come schede. Sotto ci sono la barra di ricerca e i filtri e a destra i pulsanti **Visualizzazione**, **Segui** e condivisione. Più in basso vedi le attività, qui come bacheca per stato. Passa sopra i segni ℹ per una spiegazione.

## Come è tutto collegato? [#hoe-hangt-dit-samen]

Un'attività è una sola cosa e le viste sono modi di guardare le attività. Le attività nascono dai colleghi o dalle automazioni. Un'automazione può anche aspettare un'attività.

```mermaid
flowchart LR
  A["Un collega crea un'attività<br/>nella pagina delle attività o da un cliente, una fattura o un contatore"] --> T["Attività"]
  B["Un'automazione crea un'attività<br/>passaggio Crea attività, a nome di Flusso di lavoro"] --> T
  T --> L["Elenco<br/>mostra solo le attività che vi aggiungi tu"]
  T --> G["Vista filtrata<br/>mostra ogni attività che corrisponde ai filtri"]
  L --> Z["La visibilità della vista<br/>decide chi vede l'attività"]
  T -- "Un collega sceglie un pulsante nell'attività" --> W["L'automazione non aspetta più<br/>e prosegue"]
  T -- "Stato o assegnazione cambiano" --> S["Un'automazione può partire da questo"]
```

- Se metti un'attività in una vista, l'attività in sé non cambia. È solo la vista che la acquisisce.
- Una vista filtrata non toglie attività: compaiono o scompaiono da sole a seconda che corrispondano o meno ai filtri.
- Un'attività creata da un'automazione è un'attività normale. Se ha pulsanti di scelta (passaggio **Chiedi una decisione**), l'automazione aspetta finché qualcuno sceglie un pulsante. Vedi [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen) e [Attività nelle automazioni](/automatiseringen/acties/taken).

## Per iniziare subito [#snel-aan-de-slag]

1. Apri **Attività** nel menu laterale
2. Clicca su **Nuova vista**. Inserisci un **Nome** e scegli in **Visibilità**, **Contenuto**, **Colonne** e **Inizia con** ciò che vuoi. Poi clicca su **Nuova vista** in fondo alla finestra
3. In alto in una colonna clicca su **Nuova attività**, dai un nome all'attività e clicca su **Crea**
4. Clicca su un'attività per aprirne i dettagli: stato, priorità, scadenza, colleghi assegnati e altro
5. Spunta la casella a sinistra di un'attività quando è finita

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Finestra Nuova vista con nome, visibilità, contenuto, colonne e filtro iniziale" />

Senza viste tue puoi sempre ripiegare sulla vista integrata **Tutte**, che mostra tutte le attività che puoi vedere. I filtri salvati in **Tutte** valgono per l'intera organizzazione.

## Stati [#statussen]

| Stato | Significato |
|---|---|
| **In attesa** | L'attività è pianificata ma non è ancora iniziata |
| **In corso** | Si sta lavorando attivamente all'attività |
| **In attesa di risposta** | Puoi proseguire solo quando qualcun altro, come un cliente o un fornitore, ha fatto qualcosa o ha risposto |
| **Completato** | L'attività è conclusa |

Ecco come appare lo stesso tipo di attività prima e dopo la spunta. In alto un'attività aperta, sotto una completata: il titolo è barrato e lo stato è **Completato**.

<DocScreenshot src="/screenshots/taken/task-card-open.png" alt="Prima: un'attività aperta con lo stato In corso" />

<DocScreenshot src="/screenshots/taken/task-card-done.png" alt="Dopo: un'attività completata con titolo barrato e lo stato Completato" />

Un'attività completata scende in fondo in un elenco o in una colonna ordinati manualmente. Se imposti un'attività principale su **Completato**, vengono completate anche le sottoattività aperte. Se poi riapri l'attività, le sottoattività restano completate.

Una vista può nascondere le attività completate dopo un certo tempo, vedi [Nascondere le attività completate](/taken/indelingen#voltooide-taken-verbergen).

## Priorità [#prioriteiten]

Un'attività ha la priorità **Bassa**, **Media**, **Alta** o **Urgente**.

## Sezioni [#onderdelen]

<Cards>
  <Card
    title="Viste"
    href="/taken/weergaven"
    description="Creare, condividere, duplicare e seguire elenchi e viste filtrate"
  />
  <Card
    title="Tabella, bacheca e calendario"
    href="/taken/indelingen"
    description="Scegli come vengono mostrate le attività, raggruppale e ordinale"
  />
  <Card
    title="Filtrare"
    href="/taken/filteren"
    description="Ritrovare le attività per stato, scadenza, cliente, elemento collegato e altro"
  />
  <Card
    title="Dettagli dell'attività"
    href="/taken/taakdetails"
    description="Tutto ciò che puoi registrare in un'attività, da sottoattività e tempo dedicato alla stampa"
  />
  <Card
    title="Attività private"
    href="/taken/prive-taken"
    description="Chi vede un'attività dipende dalle viste in cui si trova"
  />
  <Card
    title="Etichette"
    href="/taken/labels"
    description="Gestire le etichette e far impostare automaticamente una scadenza"
  />
  <Card
    title="Notifiche"
    href="/taken/meldingen"
    description="Promemoria, scadenze e il riepilogo giornaliero di una vista"
  />
  <Card
    title="Condividere le attività"
    href="/taken/delen"
    description="Creare una pagina di sola lettura o un abbonamento al calendario"
  />
  <Card
    title="Attività in altre pagine"
    href="/taken/taken-op-andere-paginas"
    description="Creare attività da clienti, fatture, conversazioni e altro"
  />
</Cards>

<Callout type="info" title="Da sapere">
- Non ci sono permessi separati per le attività. Chi lavora in Tillor può creare e modificare attività. Quali attività vedi dipende dalle viste in cui si trovano. Vedi [Attività private](/taken/prive-taken)
- Una nuova attività può avere fino a 50 sottoattività. Le sottoattività hanno un solo livello
- Se imposti un'attività su **Completato**, vengono completate anche le sottoattività aperte
- Chi segue una vista riceve ogni mattina alle 07:00 un riepilogo, con al massimo 15 attività per elenco
- Un timer in corso va in pausa dopo dieci minuti senza mouse o tastiera
- Un'etichetta con un **Obiettivo di scadenza (giorni)** assegna automaticamente una scadenza alle attività che non ne hanno
- Un'attività che elimini non può essere ripristinata
</Callout>

## Termini [#begrippen]

- **Attività**: un lavoro che tieni traccia, con stato, priorità, scadenza ed eventualmente colleghi assegnati
- **Vista**: una scheda nella pagina delle attività con un proprio modo di mostrare le attività, vedi [Viste](/taken/weergaven)
- **Elenco**: una vista che mostra solo le attività che vi aggiungi tu
- **Vista filtrata**: una vista che mostra ogni attività che corrisponde ai filtri
- **Sottoattività**: una parte di un'attività, come checklist
- **Blocco**: un'attività che deve essere finita prima che un'altra possa iniziare
- **Flusso di lavoro**: l'utente a nome del quale un'[automazione](/begrippen#automatisering) crea attività

Altri termini si trovano nel [glossario](/begrippen).


# Etichette (/it-IT/taken/labels)

Con le etichette dai alle attività una categoria, ad esempio *Manutenzione*, *Reclami* o *Stagione*. Puoi filtrare e raggruppare per etichetta. Un'etichetta ha un nome, un colore ed eventualmente una descrizione.

## Gestire le etichette [#labels-beheren]

Vai su <UIPath>Impostazioni > Etichette attività</UIPath>. Vedi quella pagina se puoi visualizzare o modificare le impostazioni generali della tua organizzazione. Il riepilogo ha le colonne **Etichetta**, **Descrizione** e **Attività** (il numero di attività con quell'etichetta).

<DocScreenshot src="/screenshots/taken/task-labels-settings.png" alt="Impostazioni, pagina Etichette attività con le etichette Amministrazione, Manutenzione e Reception" />

- **Nuova etichetta** crea un'etichetta con un **Nome**, una **Descrizione**, un **Colore** ed eventualmente un **Obiettivo di scadenza (giorni)**
- **Modifica etichetta** cambia quei dati in seguito
- **Elimina etichetta** rimuove l'etichetta e mostra prima su quante attività si trova. L'etichetta scompare da tutte quelle attività

Puoi creare un'etichetta anche mentre modifichi un'attività: digita il nome nel campo **Etichette** e scegli **Crea [nome]**.

## Impostare automaticamente una scadenza [#een-deadline-automatisch-instellen]

<DocScreenshot src="/screenshots/taken/task-label-dialog.png" alt="Finestra Crea etichetta con nome, descrizione, colore e obiettivo di scadenza" />

In un'etichetta puoi compilare l'**Obiettivo di scadenza (giorni)**, ad esempio *7*. Un'attività senza scadenza che riceve quell'etichetta ottiene allora una scadenza: tanti giorni dopo il momento in cui l'attività è stata creata o l'etichetta è stata aggiunta.

- Succede quando crei un'attività con l'etichetta, o quando aggiungi l'etichetta in un secondo momento
- Se l'attività ha già una scadenza, resta com'è
- Se un'attività ha più etichette con un obiettivo, vale il numero di giorni più breve
- Se lasci il campo vuoto, l'etichetta non imposta nessuna scadenza

È utile per etichette come *Reclamo* (entro 2 giorni) o *Seguito preventivo* (entro 7 giorni).

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Una nuova etichetta puoi darla subito alle attività, nell'attività stessa e nel menu rapido.
- Un'etichetta con un **Obiettivo di scadenza (giorni)** da quel momento assegna automaticamente una scadenza alle attività che non ne hanno.
- Se elimini un'etichetta, scompare da tutte le attività su cui era. Le attività restano.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo la pagina Etichette attività">
Non hai il permesso di visualizzare le impostazioni generali della tua organizzazione. Chiedi a un amministratore di modificare i tuoi diritti.
</Accordion>
<Accordion title="Tillor dice Creazione dell'etichetta non riuscita">
Inserisci un **Nome** (al massimo 50 caratteri) e riprova. Per la modifica e l'eliminazione i messaggi sono **Aggiornamento dell'etichetta non riuscito** ed **Eliminazione dell'etichetta non riuscita**.
</Accordion>
<Accordion title="La mia attività non ha ricevuto la scadenza dall'etichetta">
Una scadenza dell'etichetta viene applicata solo alle attività senza scadenza. Se l'attività ne ha già una, resta quella. Con più etichette con un obiettivo vale il numero di giorni più breve.
</Accordion>
</Accordions>


# Notifiche (/it-IT/taken/meldingen)

Tillor ti tiene aggiornato sulle attività tramite e-mail e notifiche push.

## Promemoria e scadenze [#herinneringen-en-deadlines]

Se un'attività ha un **Promemoria** o una **Scadenza**, nella finestra dei dettagli, in **Notifiche**, scegli se vuoi un'**E-mail** e/o una **Notifica push**. Entrambe sono attive per impostazione predefinita. Se le disattivi tutte e due, nessuno riceve una notifica per quell'attività.

- Un promemoria scatta al momento impostato, con il titolo *Promemoria attività*
- Una notifica di scadenza scatta non appena la scadenza è raggiunta e l'attività non è ancora completata
- Le attività completate non generano più promemoria né notifiche di scadenza
- Un promemoria ricorrente scatta a ogni ripetizione, finché l'attività non è completata o la pianificazione termina

La notifica va ai colleghi assegnati, anche ai membri di un gruppo assegnato. Se nessuno è assegnato, va a chi ha creato l'attività. L'e-mail mostra un'anteprima dell'attività, con lo stato e un pulsante per aprirla.

## Assegnare, scollegare e completare [#toewijzen-ontkoppelen-en-voltooien]

- Se un'attività ti viene assegnata, anche tramite un gruppo di cui fai parte, ricevi una notifica (**Nuova attività assegnata**). Se assegni un'attività a te stesso, non ricevi nessuna notifica
- Se qualcuno ti toglie da un'attività, ricevi una notifica che l'attività è stata **scollegata** (**Attività non più assegnata**)
- Quando un'attività viene completata, i colleghi assegnati e chi l'ha creata ricevono una notifica, tranne chi ha completato l'attività. La notifica viene inviata con un ritardo di circa un minuto. Se qualcuno riapre l'attività entro quel tempo, non viene più inviata

## Seguire una vista [#een-weergave-volgen]

Con **Segui** (in alto a destra in una vista salvata) ricevi ogni mattina alle 07:00 un'e-mail con un riepilogo di quella vista. L'e-mail ha come oggetto *Riepilogo giornaliero* con il nome della vista e contiene tre elenchi:

- **Scadute**: attività aperte la cui scadenza è trascorsa
- **In scadenza oggi**: attività aperte che vanno finite oggi
- **Modificate dall'ultimo riepilogo**: attività aperte che sono state modificate dal tuo riepilogo precedente

Ogni elenco mostra al massimo 15 attività con la scadenza accanto. In fondo c'è il pulsante **Apri vista**, che porta direttamente alla vista.

- Se non c'è nulla in tutti e tre gli elenchi, quel giorno non ricevi nessuna e-mail
- Il pulsante diventa **Seguita**. Cliccaci per smettere di seguire. Puoi seguire ogni vista che puoi vedere, anche le viste dei colleghi
- Se perdi l'accesso alla vista, ad esempio perché il proprietario la rende solo per sé o la elimina, smetti automaticamente di seguirla
- Vedi solo le attività che puoi vedere anche tu

<Callout type="info">
La vista integrata **Tutte** non puoi seguirla, perché non è una vista salvata.
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non ricevo nessun promemoria né notifica di scadenza">
Controlla nell'attività, in **Notifiche**, se **E-mail** o **Notifica push** è attivo. Una notifica va ai colleghi assegnati, o a chi ha creato l'attività se nessuno è assegnato. Le attività completate non generano più notifiche.
</Accordion>
<Accordion title="Non ricevo nessuna notifica quando assegno un'attività a me stesso">
È corretto. Una notifica **Nuova attività assegnata** la ricevi solo se qualcun altro ti assegna l'attività.
</Accordion>
<Accordion title="Non ricevo il riepilogo giornaliero">
Non segui la vista (il pulsante **Segui** deve mostrare **Seguita**), oppure non c'è nulla in **Scadute**, **In scadenza oggi** e **Modificate dall'ultimo riepilogo**. In tal caso quel giorno non inviamo nessuna e-mail. Smetti anche automaticamente di seguire se non puoi più vedere la vista.
</Accordion>
<Accordion title="Tillor dice Impossibile aggiornare il follow">
La modifica non è stata salvata. Clicca di nuovo su **Segui**.
</Accordion>
</Accordions>


# Attività private (/it-IT/taken/prive-taken)

Un'attività è privata se si trova solo in viste personali. Non devi impostare nulla: le viste in cui si trova un'attività decidono chi la vede.

## Le regole [#de-regels]

| Dove si trova l'attività | Chi la vede |
|---|---|
| In nessuna vista | Tutti gli utenti dell'organizzazione |
| In almeno una vista **Pubblica** | Tutti gli utenti dell'organizzazione |
| Solo in viste personali (**Solo tu** o **Condivisa**) | Chi ha creato l'attività, i colleghi e i gruppi assegnati, e il proprietario e le persone e i gruppi scelti di quelle viste |

Le sottoattività seguono l'attività principale. Un'attività che non puoi vedere non compare da nessuna parte: né negli elenchi, né nei risultati di ricerca, nei filtri, nella dashboard, presso un cliente, nel calendario o nelle notifiche, e non puoi nemmeno aprirla tramite un link.

## Esempio [#voorbeeld]

Jan crea la vista personale *Le mie idee* con visibilità **Solo tu**. Aggiunge l'attività *Richiedere preventivo nuova sbarra* a quell'elenco.

- Solo Jan vede l'attività. I suoi colleghi non la vedono da nessuna parte
- Jan assegna l'attività a Piet. Ora anche Piet vede l'attività, anche se non ha mai visto la vista di Jan
- Jan condivide *Le mie idee* con Els (**Condivisa**). Ora anche Els vede l'attività
- Jan aggiunge l'attività alla vista *Manutenzione*, che è **Pubblica**. Da ora tutto il team vede l'attività
- Se Jan toglie di nuovo l'attività da *Manutenzione* e non si trova altrove in una vista pubblica, torna privata

Se Jan non avesse messo l'attività in nessuna vista, tutti l'avrebbero vista.

## Chi decide la visibilità di una vista [#wie-bepaalt-de-zichtbaarheid-van-een-weergave]

Solo il proprietario di una vista personale può cambiare con chi è condivisa la vista, o renderla **Pubblica**. Un collega con cui condividi la vista può modificare le attività nella vista, ma non cambiare la visibilità e nemmeno eliminare la vista. Vedi [Viste](/taken/weergaven#wie-ziet-een-weergave).

<Callout type="warn">
Aggiungere un'attività privata a una vista pubblica la rende visibile a tutti. Tillor chiede prima di confermarlo con **Rendere pubblica questa attività?**. Puoi scegliere **Tieni privata** o **Rendi pubblica**. La stessa domanda compare quando togli l'attività dalla sua ultima vista pubblica. Se rendi **Pubblica** una vista personale che contiene attività, quelle attività diventano visibili a tutti senza una domanda a parte.
</Callout>

## Suggerimenti [#tips]

- Se vuoi passare un'attività privata a un collega, assegnagliela oppure condividi la vista con quel collega
- Un'attività conta come "in una vista" non appena la aggiungi a un elenco o la metti in una colonna personalizzata della vista. Mostrarla solo tramite un filtro non fa sì che si trovi nella vista
- Le notifiche su un'attività privata, come una scadenza, vanno solo alle persone che possono vedere l'attività

## Problemi? [#problemen]

<Accordions>
<Accordion title="Un collega non vede la mia attività">
L'attività si trova solo in viste personali. Assegnala al collega, condividi la vista con lui, oppure metti l'attività in una vista pubblica.
</Accordion>
<Accordion title="Tillor chiede Rendere pubblica questa attività?">
Stai aggiungendo un'attività privata a una vista pubblica, o la stai togliendo dalla sua ultima vista pubblica. Scegli **Tieni privata** o **Rendi pubblica**.
</Accordion>
<Accordion title="Non vedo più un'attività che avevo ancora ieri">
Forse l'attività è stata collegata a un'altra vista, oppure la vista in cui si trovava non è più visibile per te. Chiedi a chi ha creato l'attività o al proprietario della vista.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Viste" href="/taken/weergaven" />
  <Card title="Dettagli dell'attività" href="/taken/taakdetails" />
</Cards>


# Dettagli dell'attività (/it-IT/taken/taakdetails)

Nella finestra di dettaglio di un'attività registri tutto: chi la svolge, entro quando va completata, quanto tempo richiede e a che cosa è collegata. Clicca su un'attività per aprire la finestra. A sinistra trovi il nome, la descrizione e le parti come sottoattività e commenti. A destra trovi le proprietà, come stato, priorità e scadenza. Le modifiche a un'attività esistente vengono salvate subito. Solo la descrizione la salvi tu con **Salva**.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Finestra dell'attività con descrizione, sottoattività, commenti e, a destra, le proprietà, i campi personalizzati, gli elementi collegati e gli allegati" />

Puoi anche aprire un'attività direttamente con un link. Copialo dal menu con i tre puntini in alto a destra nella finestra, vedi [Il menu dell'attività](#het-menu-van-de-taak).

## Creare un'attività [#een-taak-aanmaken]

Le attività si creano in vari punti: in cima a una colonna di una bacheca (**Nuova attività**), nella scheda **Attività per Lei** della dashboard, nella pagina del cliente, oppure da una conversazione, una fattura o un altro elemento, vedi [Attività in altre pagine](/taken/taken-op-andere-paginas).

1. Clicca su **Nuova attività**
2. Inserisci un **Nome**. Il resto è facoltativo
3. Se vuoi, aggiungi sottoattività in **Aggiungi una sottoattività**: digita un nome e premi Invio. Puoi inserirne fino a 50
4. Clicca su **Crea**, oppure premi Cmd o Ctrl insieme a Invio

<DocScreenshot src="/screenshots/taken/task-create-dialog.png" alt="Finestra Nuova attività con un nome e due sottoattività" />

In cima alla finestra trovi la vista in cui finisce l'attività. Se crei l'attività da una colonna di una bacheca, riceve automaticamente quella vista e quella colonna. Puoi sceglierne un'altra o togliere la vista.

Sei già indicato tu come persona assegnata. Se ti rimuovi e non scegli nessuno, l'attività non ha una persona assegnata. I blocchi e il tempo impiegato si aggiungono dopo la creazione dell'attività.

## Proprietà [#eigenschappen]

- **Stato** e **Priorità** - vedi la [panoramica](/taken#statussen)
- **Assegnato a** - uno o più colleghi o [gruppi](/gebruikers/groepen). Cerca con **Cerca persone o gruppi...**. Se assegni un gruppo, l'attività vale per tutti coloro che in quel momento fanno parte del gruppo
- **Clienti** - collega uno o più clienti con **Aggiungi un cliente**
- **Etichette** - vedi [Etichette](/taken/labels). Un'etichetta mancante la crei subito digitando il nome e scegliendo **Crea [nome]**
- **Scadenza** - la data limite, con l'ora. Se la scadenza è passata, il tempo relativo diventa rosso
- **Promemoria** - una data e un'ora in cui vuoi ricevere un avviso, anche ripetuto
- **Notifiche** - non appena imposti un promemoria o una scadenza, scegli se vuoi un'**E-mail** e/o un **Notifica push**. Entrambi sono attivi per impostazione predefinita
- **Creata da** - chi ha creato l'attività
- **Campi personalizzati** - campi che la tua organizzazione ha aggiunto alle attività. Le modifiche vengono salvate subito. Vedi [Campi personalizzati](/eigen-velden)
- **Vista** - clicca in alto a sinistra sul nome della vista per scegliere in quali elenchi si trova l'attività e in quale colonna. In una vista filtrata scegli solo una colonna
- **Privata** - se c'è un lucchetto con **Privata**, l'attività compare solo nelle viste personali, vedi [Attività private](/taken/prive-taken)

Un'attività può avere anche una **Descrizione**. Supporta Markdown per la formattazione.

## Promemoria ripetuti [#herhalende-herinneringen]

Un promemoria può ripetersi finché l'attività non è completata:

1. Imposta prima un **Promemoria** (data e ora)
2. Clicca sul campo di ripetizione sotto (per impostazione predefinita **Non si ripete**)
3. Scegli **Ogni giorno**, **Ogni giorno feriale (lun – ven)**, **Ogni settimana**, **Ogni mese**, **Ogni anno** o **Personalizzato…**

Con **Personalizzato…** componi una pianificazione tutta tua:

- **Ripeti ogni** - un numero di giorni, settimane, mesi o anni
- **Ripeti il** - in una pianificazione settimanale, i giorni della settimana in cui il promemoria può arrivare
- **Termina** - **Mai**, **In una data** o **Dopo** un certo numero di volte

Se un promemoria cade in un giorno che hai escluso, slitta senza avviso al primo giorno consentito successivo. La ripetizione si ferma non appena l'attività è su **Completato** o la pianificazione termina.

## Elementi collegati [#gekoppelde-items]

In **Elementi collegati** vedi a che cosa è legata l'attività. Puoi collegarne più di ogni tipo: terreni, fatture, prenotazioni, contatori, telefonate, transazioni bancarie, prodotti e conversazioni della inbox. Un'attività può anche essere collegata a un commento. Un'attività su una transazione bancaria la crei dal menu della transazione in **Transazioni bancarie** con **Crea attività**. Un'attività su un prodotto, ad esempio il controllo del conto contabile, la crei nella pagina del prodotto dal menu **⋯** con **Crea attività**; le attività aperte del prodotto compaiono in cima a quella pagina.

Colleghi un elemento aggiuntivo con il segno più in **Elementi collegati** (tooltip **Collega elemento**). Cerca un cliente, un terreno, un contatore, una fattura, una prenotazione o un prodotto. Se l'elemento scelto appartiene a un cliente, Tillor chiede **Collegare anche [cliente]?**:

- **Collega entrambi** - l'attività compare anche presso il cliente
- **Solo questo elemento** - il cliente non viene collegato all'attività

Con **Scollega** rimuovi di nuovo un collegamento. Le attività collegate ancora aperte compaiono nella pagina dell'elemento in **Attività aperte**.

## Allegati [#bijlagen]

In **Allegati** aggiungi file all'attività. Clicca sul segno più, oppure incolla un file con Cmd o Ctrl e V in un punto qualsiasi della finestra.

## Sottoattività [#subtaken]

Un'attività può avere sottoattività, una checklist nella finestra di dettaglio. C'è un solo livello: una sottoattività non può avere a sua volta sottoattività.

1. Apri l'attività principale, oppure compilale già mentre crei un'attività
2. In **Aggiungi una sottoattività** digita un nome e premi Invio
3. Spunta una sottoattività per impostarla su **Completato**. Spuntala di nuovo per riportarla indietro
4. Clicca sul nome per rinominarla, oppure sul cestino per eliminarla
5. Trascina una sottoattività dalla maniglia per cambiare l'ordine. Con **Aggiungi descrizione** puoi dare una descrizione anche a una sottoattività

In una nuova attività, le sottoattività vengono create insieme all'attività, nell'ordine in cui le hai inserite. Le sottoattività non compaiono come scheda a parte nelle bacheche, nelle tabelle o nel calendario. Sull'attività vedi un contatore come **2/5**. Se imposti l'attività principale su **Completato**, vengono completate anche tutte le sottoattività aperte. Il contrario non vale: puoi concludere l'attività principale anche se ci sono sottoattività aperte.

## Blocchi e dipendenze [#blokkades-en-afhankelijkheden]

A volte un'attività può iniziare o concludersi solo quando un'altra è pronta. Lo registri nella finestra di dettaglio:

- **Bloccata da** - attività che devono essere completate prima. Aggiungile con **Aggiungi attività bloccante**
- **Blocca altre attività** - attività che aspettano questa. Aggiungile con **Aggiungi attività bloccata**

Per ogni gruppo vedi quante attività sono ancora aperte (ad esempio **2 ancora aperte**). Cerca le attività con **Cerca attività...** e rimuovi un collegamento con **Rimuovi collegamento**. Sulla scheda dell'attività, sotto il nome, c'è una riga come **Bloccata da 1 attività**. Puoi filtrare per attività bloccate, vedi [Filtrare](/taken/filteren).

Un blocco non ti ferma. Se provi a spuntare un'attività bloccata, Tillor chiede **Completare un'attività bloccata?** e la conclude solo se scegli **Completa comunque**.

Un blocco lo aggiungi anche dal menu con i tre puntini in alto a destra nella finestra, con **Aggiungi attività bloccante** e **Aggiungi attività bloccata**.

## Tempo impiegato [#bestede-tijd]

Accanto a **Tempo impiegato** nella finestra di dettaglio vedi il totale. Cliccaci sopra per registrare il tempo.

<DocScreenshot src="/screenshots/taken/task-time-popover.png" alt="Tempo impiegato con il pulsante Avvia, un campo per una registrazione manuale e le registrazioni dei colleghi" />

Hai due modi:

- Un **timer**. Clicca su **Avvia**, lavora all'attività e clicca sul pulsante di stop quando hai finito. Il tempo viene aggiunto all'attività, secondi compresi
- **Compilare in seguito**. Inserisci la durata, ad esempio **1:30**, **90** (minuti), **1u 30m** o **1.5h**. Tutti e quattro significano un'ora e mezza. Se vuoi, aggiungi una nota in **Cosa hai fatto? (facoltativo)** e clicca su **Registra**

Il tempo viene registrato nel giorno di oggi. Nell'elenco vedi per ogni registrazione chi l'ha fatta, la data, la nota e la durata. I colleghi vedono le registrazioni degli altri, ma puoi eliminare solo le tue, con il cestino che compare quando passi il mouse sulla riga.

### Il timer [#de-timer]

- Un timer in corso continua anche se passi a un'altra pagina. Compare allora come piccola scheda in basso a destra, con i pulsanti per mettere in pausa (**Metti in pausa**), riprendere (**Riprendi**), **Segna** e fermare (**Termina**). Clicca sul nome dell'attività per tornarci
- Con **Segna** salvi la parte di tempo trascorsa finora, con una breve nota su ciò a cui stavi lavorando, e poi il timer continua
- Puoi tenere traccia del tempo su una sola attività alla volta. Finché il tuo timer è in corso, **Avvia** è disattivato sulle altre attività
- Se per dieci minuti non usi il mouse né la tastiera, il timer si mette in pausa nell'ultimo momento in cui eri attivo
- I colleghi vedono nella finestra dell'attività che stai lavorando (**In corso**) o sei in pausa (**In pausa**). Quel tempo conta nel totale solo dopo il salvataggio

## Commenti e attività [#opmerkingen-en-activiteit]

In fondo alla finestra c'è la sezione **Commenti**. Con **Aggiungi commento** scrivi un commento. Puoi menzionare dei colleghi in un commento, così ricevono una notifica. Sotto trovi l'**attività**: una cronologia di creazione e modifiche, con in caso di modifica ciò che c'era prima e dopo.

## Il menu dell'attività [#het-menu-van-de-taak]

In alto a destra nella finestra c'è un menu con tre puntini.

<DocScreenshot src="/screenshots/taken/task-dialog-menu.png" alt="Menu dell'attività con aggiunta di blocchi, Stampa, Copia link ed Elimina" />

- **Aggiungi attività bloccante** e **Aggiungi attività bloccata** registrano una dipendenza
- **Stampa** ha tre scelte. **Stampa (A4)** apre la finestra di stampa del browser con un PDF dell'attività. **Invia alla stampante A4** e **Invia alla stampante termica (POS)** inviano l'attività alla tua stampante, ad esempio una stampante di scontrini. Queste due le puoi scegliere solo se la tua organizzazione ha un [connector](/connector) con stampante, vedi [Stampante](/printer)
- **Copia link** copia un link che apre direttamente l'attività. Chi apre il link deve poter vedere l'attività
- **Elimina** è in fondo, vedi [Eliminare un'attività](#een-taak-verwijderen)

La stampa mostra il nome, lo stato, la priorità, la scadenza e la descrizione e, in **Elementi collegati**, i clienti, le fatture, le prenotazioni, i terreni e i contatori a cui è legata l'attività. Se l'attività ha dei blocchi, compaiono anche le attività che la bloccano e quelle che essa stessa blocca. Un gruppo senza elementi viene omesso.

## Attività con pulsanti di scelta [#taken-met-keuzeknoppen]

Alcune attività, ad esempio da un'[automazione con il passaggio Chiedi una decisione](/automatiseringen/logica#vraag-om-een-beslissing), richiedono una decisione. Al posto di una spunta ci sono dei pulsanti sull'attività, con sopra **Scegli un'azione per completare questa attività**. Clicchi su un pulsante e l'attività è conclusa.

- Se la scelta richiede un motivo, Tillor apre prima una finestra con **Perché questa scelta?** in cui inserisci una nota
- Se la scelta richiede una conferma, Tillor mostra prima una finestra. Una scelta fatta non si può più annullare dall'attività
- Poi sull'attività compare quale scelta è stata fatta e da chi
- Può scegliere chi è assegnato all'attività e un amministratore. Se nessuno è assegnato, può scegliere chiunque veda l'attività

Ecco come sono legate l'attività e l'automazione:

```mermaid
flowchart TD
  A["L'automazione raggiunge il passaggio<br/>Chiedi una decisione"] --> B["Tillor crea un'attività con i tuoi pulsanti<br/>e l'automazione aspetta"]
  B --> C{"Un collega sceglie un pulsante"}
  C -- "Un'opzione" --> D["L'attività è su Completato<br/>l'automazione prosegue tramite quell'opzione"]
  C -- "Nessuno sceglie entro il tempo di attesa" --> E["L'automazione prosegue tramite Scaduto<br/>l'attività resta"]
  C -- "L'attività viene eliminata" --> E
```

Un'attività creata da un'automazione e che può essere conclusa solo dal flusso mostra, al posto della spunta, il testo **Completata dalla sua automazione**. Non puoi quindi completarla e nel menu non ha **Elimina**.

## Cambiare rapidamente lo stato e spuntare [#status-snel-wijzigen-en-afvinken]

Senza aprire la finestra puoi:

- Spuntare la casella a sinistra del nome dell'attività per impostarla su **Completato**. Se togli la spunta, torna a **In corso**
- Cliccare sui tre puntini della scheda dell'attività, o usare il tasto destro sulla scheda, per un menu rapido con **Modifica**, **Stato**, **Priorità**, **Promemoria**, **Scadenza**, **Etichette**, **Viste** ed **Elimina**. **Etichette** compare solo se esistono etichette e **Viste** solo se ci sono elenchi a cui aggiungi tu stesso le attività

<DocScreenshot src="/screenshots/taken/task-actions-menu.png" alt="Menu rapido di una scheda di attività" />

## Eliminare un'attività [#een-taak-verwijderen]

Scegli **Elimina** nel menu rapido dell'attività, oppure nel menu con i tre puntini nella finestra dell'attività, e conferma. Non si può annullare e le eventuali sottoattività scompaiono con essa. L'eliminazione viene registrata nel [registro delle attività](/activiteitenlog).

Per un'attività che può essere conclusa solo da un'automazione, **Elimina** non compare nel menu. Se un'attività del genere viene comunque eliminata in un altro modo, l'automazione che aspettava il completamento fallisce.

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Le modifiche a un'attività esistente vengono salvate subito. Solo la descrizione la salvi tu con **Salva**.
- Se assegni l'attività, quel collega (o i membri del gruppo) riceve una notifica. Vedi [Notifiche](/taken/meldingen).
- Se imposti l'attività su <Status tone="success">Completato</Status>, anche le sottoattività aperte vengono completate e i colleghi assegnati e chi l'ha creata ricevono una notifica, tranne te. L'attività scende in fondo in un elenco ordinato manualmente.
- Un promemoria o una scadenza genera una notifica finché l'attività non è completata.
- Un'attività creata da un'[automazione](/automatiseringen/acties/taken) può a sua volta avviare un'automazione, ad esempio a un cambio di stato o quando qualcuno sceglie un pulsante di scelta.
- L'eliminazione non si può annullare. L'eliminazione compare nel [registro delle attività](/activiteitenlog).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor chiede Completare un'attività bloccata?">
L'attività sta ancora aspettando una o più attività non concluse (vedi **Bloccata da**). Concludi prima quelle attività, oppure scegli **Completa comunque**.
</Accordion>
<Accordion title="Vedo un testo al posto di una spunta">
Con **Completata dalla sua automazione** non puoi completare tu l'attività. La conclude l'automazione. Se l'attività ha dei pulsanti sotto **Scegli un'azione per completare questa attività**, clicca su un pulsante.
</Accordion>
<Accordion title="Non riesco a usare i pulsanti di un'attività">
Può scegliere chi è assegnato all'attività e un amministratore. Se nessuno è assegnato, può scegliere chiunque veda l'attività. Con il messaggio di errore **Impossibile salvare la scelta** riprova.
</Accordion>
<Accordion title="Il pulsante Avvia del timer è grigio">
Il tuo timer è già in corso su un'altra attività. Puoi tenere traccia del tempo su una sola attività alla volta. Ferma prima quel timer.
</Accordion>
<Accordion title="Il mio timer si è fermato mentre lavoravo">
Dopo dieci minuti senza mouse né tastiera il timer si mette in pausa nell'ultimo momento in cui eri attivo. Usa **Riprendi** per continuare.
</Accordion>
<Accordion title="La registrazione del tempo non riesce">
Inserisci una durata che Tillor capisce, come **1:30**, **90**, **1u 30m** o **1.5h**. Se non funziona comunque, compare il messaggio **Impossibile registrare il tempo** e riprova. Puoi eliminare solo le tue registrazioni.
</Accordion>
<Accordion title="Non riesco a stampare sulla stampante">
**Invia alla stampante A4** e **Invia alla stampante termica (POS)** puoi sceglierle solo se la tua organizzazione ha un connector con stampante. **Stampa (A4)** funziona sempre. Se qualcosa va storto, compare il messaggio **Impossibile generare il PDF dell'attività**.
</Accordion>
<Accordion title="Tillor dice Impossibile aggiornare l'attività">
La modifica non è stata salvata. Riprova o aggiorna la pagina.
</Accordion>
<Accordion title="Non riesco a eliminare un'attività">
Per un'attività che può essere conclusa solo da un'automazione, **Elimina** non compare nel menu. Per il resto, ogni collega che vede l'attività può eliminarla.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Viste" href="/taken/weergaven" />
  <Card title="Etichette" href="/taken/labels" />
  <Card title="Attività nelle automazioni" href="/automatiseringen/acties/taken" />
</Cards>


# Attività in altre pagine (/it-IT/taken/taken-op-andere-paginas)

Le attività non vivono su un'isola. Le crei dall'elemento di cui parlano e le ritrovi anche lì.

## Creare un'attività da un altro elemento [#een-taak-maken-vanuit-een-ander-item]

L'attività viene collegata automaticamente all'elemento. Se c'è di mezzo un cliente, puoi collegare anche lui. Per impostazione predefinita l'attività viene assegnata a te.

| Dove | Pulsante |
|---|---|
| Pagina del cliente | **Crea attività** nel menu delle azioni del cliente |
| Fattura | **Crea attività** nel menu delle azioni |
| Contatore | **Crea attività** nel menu delle azioni |
| Prenotazione | **Crea attività** |
| Terreno | **Crea attività** |
| Conversazione nella inbox | **Crea attività** |
| Telefonata | **Crea attività** |
| Commento | L'icona dell'attività accanto al commento (tooltip **Crea un'attività da questo commento**) |
| Transazione bancaria | **Crea attività** nel menu delle azioni della transazione in <UIPath>Amministrazione > Transazioni bancarie</UIPath> |

## Un promemoria di follow-up per un commento [#een-opvolgherinnering-bij-een-opmerking]

Accanto a un commento c'è anche un orologio per ricordare a te stesso (o ai colleghi menzionati) di dare seguito al commento. Con questo crei un'attività come *Dare seguito a questo commento* o *Controllare se [nome] se n'è accorto*. Se in seguito segni il commento come gestito, l'attività di follow-up viene completata automaticamente.

## Attività aperte presso un elemento [#openstaande-taken-bij-een-item]

Nella pagina di un cliente, di una prenotazione, di una fattura, di un terreno e di un contatore c'è un blocco **Attività aperte** con le attività non ancora completate collegate a quell'elemento. Se non ci sono attività aperte, il blocco non compare.

Nella pagina <UIPath>Clienti > [cliente] > Attività</UIPath> trovi tutte le attività del cliente. La apri dalla scheda **Attività** nella pagina del cliente. Le attività completate sono compresse sotto **Attività completate**, con il numero accanto.

<DocScreenshot src="/screenshots/taken/customer-tasks.png" alt="Scheda Attività in una pagina cliente con Nuova attività e le attività del cliente" />

## Nella dashboard [#op-het-dashboard]

La scheda **Attività per Lei** mostra le attività a te assegnate. Con la stella scegli una vista preferita da vedere al suo posto, vedi [Viste](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). Puoi anche creare direttamente un'attività o condividere le attività da lì.

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- L'attività è collegata all'elemento da cui l'hai creata. La vedi in **Elementi collegati** nell'attività.
- Finché l'attività non è completata, compare nel blocco **Attività aperte** nella pagina di quell'elemento e del cliente collegato.
- Un'attività di follow-up per un commento viene completata da sola quando segni il commento come gestito.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non vedo Crea attività">
In alcune pagine il pulsante è nel menu delle azioni, come per un cliente, una fattura o un contatore. Cerca lì i tre puntini.
</Accordion>
<Accordion title="Il blocco Attività aperte manca">
Il blocco compare solo se all'elemento sono ancora collegate attività non concluse.
</Accordion>
<Accordion title="Tillor dice Impossibile creare l'attività">
L'attività non è stata salvata. Inserisci un nome e riprova.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Dettagli dell'attività" href="/taken/taakdetails" />
  <Card title="Viste" href="/taken/weergaven" />
</Cards>


# Viste (/it-IT/taken/weergaven)

In cima alla pagina **Attività** c'è una riga di schede. Ogni scheda è una vista. La prima scheda, **Tutte**, è integrata: mostra ogni attività e non puoi modificarla, spostarla o eliminarla. Puoi però salvarci filtri e impostazioni della vista per l'intera organizzazione. Tutte le altre viste le crei tu.

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Schede con le viste in cima alla pagina delle attività" />

## Due tipi di viste [#twee-soorten-weergaven]

Quando la crei, scegli il tipo di vista in **Contenuto**.

| Tipo | Che cosa fa |
|---|---|
| **Vista filtrata** | Mostra ogni attività che soddisfa i filtri, come una ricerca salvata. Le nuove attività che corrispondono compaiono da sole |
| **Elenco** | Mostra solo le attività che aggiungi tu |

Un elenco è utile per una raccolta fissa, ad esempio *Preparazione stagione*. Una vista filtrata è utile per tutto ciò che soddisfa una regola, ad esempio *Tutte le attività urgenti che aspettano il cliente*.

Puoi cambiare il tipo in seguito in **Vista** (in alto a destra) alla voce **Tipo**. Questo non si fa in **Tutte**. Se trasformi un elenco in una vista filtrata, le attività che vi avevi aggiunto a mano vengono scollegate. Tillor chiede prima conferma, perché non si può annullare.

## Creare una vista [#een-weergave-aanmaken]

1. Clicca su **Nuova vista**, a destra delle schede
2. Inserisci un **Nome** e, se vuoi, una **Descrizione**
3. In **Visibilità** scegli chi vede la vista: **Pubblica**, **Solo tu** o **Condivisa**. Con **Condivisa** scegli in **Condividi con** i colleghi e i gruppi
4. In **Contenuto** scegli una **Vista filtrata** o un **Elenco**
5. In **Colonne** scegli come vengono suddivise le attività: **Colonne personalizzate**, **Stato**, **Assegnato a** o **Nessun raggruppamento**
6. In **Inizia con** scegli un filtro iniziale: **Tutte le attività**, **Attività aperte** o **Le mie attività**
7. Clicca su **Nuova vista** in fondo alla finestra

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Finestra Nuova vista" />

In partenza la vista è su **Pubblica**, **Vista filtrata**, **Stato** e **Attività aperte**. Se scegli **Nessun raggruppamento**, ottieni una tabella. Con le altre scelte inizi con una bacheca. Lo modifichi in seguito, vedi [Tabella, bacheca e calendario](/taken/indelingen).

Una vista filtrata impostata come tabella si presenta così. I filtri sono sopra la tabella e qui sono già salvati.

<DocScreenshot src="/screenshots/taken/task-view-filtered.png" alt="Vista filtrata Attività urgenti come tabella, con filtri su priorità e stato" />

## Chi vede una vista [#wie-ziet-een-weergave]

| Scelta | Chi vede la vista |
|---|---|
| **Pubblica** | Tutti gli utenti dell'organizzazione (una vista dell'organizzazione) |
| **Solo tu** | Solo tu (una vista personale). Sulla scheda c'è un lucchetto |
| **Condivisa** | Tu e i colleghi e i gruppi che scegli in **Condividi con**. Sulla scheda c'è l'icona di più persone |

In **Condividi con** scegli persone e gruppi dallo stesso elenco. Un [gruppo](/gebruikers/groepen) conta com'è composto in quel momento: chi entra più tardi nel gruppo vede anche la vista, e chi esce dal gruppo non la vede più.

Solo il proprietario di una vista personale può cambiare con chi è condivisa o renderla visibile a tutti. I colleghi con cui condividi la vista possono lavorarci, ma non decidere chi altro la vede e non possono eliminarla. Se rendi una vista **Pubblica**, l'elenco delle persone e dei gruppi scelti decade.

<Callout type="warn">
La visibilità di una vista determina anche chi vede le attività in quella vista. Leggi [Attività private](/taken/prive-taken) prima di inserire attività in una vista personale.
</Callout>

## Modificare, duplicare o eliminare una vista [#een-weergave-bewerken-dupliceren-of-verwijderen]

Clicca con il tasto destro sulla scheda della vista e scegli:

- **Modifica** - cambia nome, descrizione, visibilità e colonne. Filtri, ordinamento e disposizione restano come erano stati salvati. **Contenuto** e **Inizia con** li scegli solo alla creazione; il tipo lo cambi in seguito in **Vista**
- **Duplica** - crea una copia con il nome *[nome] (copia)* e la apre subito
- **Elimina** - dopo la conferma la vista scompare. Le attività restano e perdono solo questa vista

Trascina le schede per cambiare l'ordine. Il nuovo ordine viene salvato subito.

## Salvare o scartare le modifiche [#wijzigingen-opslaan-of-verwerpen]

Se modifichi i filtri o le impostazioni della vista, restano prima solo sul tuo schermo. In alto a destra compare una barra con **Modifiche non salvate** e due pulsanti:

- **Salva vista** conserva le modifiche nella vista
- **Annulla modifiche** riporta tutto alla versione salvata

Nella vista integrata **Tutte** salvi le modifiche per tutti nella tua organizzazione, come per una vista pubblica. Per farlo ti serve il permesso **Gestire etichette e viste condivise**. Senza questo permesso, in **Tutte** puoi solo usare **Annulla modifiche**.

La barra di ricerca (**Cerca attività...**) non viene mai salvata con la vista: restringe soltanto ciò che vedi ora.

## Una vista preferita per la dashboard [#een-favoriete-weergave-voor-het-dashboard]

<DocScreenshot src="/screenshots/taken/dashboard-tasks-card.png" alt="Scheda della dashboard Attività per Lei con i pulsanti per la vista preferita e la condivisione" />

Nella dashboard la scheda **Attività per Lei** mostra per impostazione predefinita le attività assegnate a te. Puoi invece collegarle una vista:

1. Clicca sulla stella in alto a destra nella scheda
2. Scegli una vista dall'elenco. Scegli **Attività per Lei** per tornare alle tue attività assegnate

Puoi avere una sola vista preferita alla volta, e vale solo per te. Se la vista viene eliminata in seguito o non è più visibile per te, la dashboard mostra di nuovo le tue attività.

## Seguire una vista [#een-weergave-volgen]

Con il pulsante **Segui** in alto a destra ricevi ogni mattina un'e-mail con ciò che in quella vista richiede attenzione. Il funzionamento è descritto in [Notifiche](/taken/meldingen#een-weergave-volgen).

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- La nuova vista compare come scheda in cima alla pagina delle attività. Una vista filtrata mostra subito tutte le attività che corrispondono, e le nuove attività che corrispondono si aggiungono da sole.
- Con **Pubblica** tutti gli utenti della tua organizzazione vedono la vista. Con **Solo tu** la vedi solo tu, e con **Condivisa** tu e i colleghi e i gruppi scelti.
- Se elimini una vista, le attività restano. Perdono solo quella vista.
- Se trasformi un elenco in una vista filtrata, le attività che vi avevi aggiunto a mano vengono scollegate.
- Una vista che segui ti invia ogni mattina un riepilogo. Vedi [Notifiche](/taken/meldingen#een-weergave-volgen).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice che la vista non ha potuto essere creata">
Vedi **Impossibile creare la vista**. Controlla di aver inserito un **Nome** e riprova. Se ancora non funziona, verifica che la tua connessione a internet sia a posto. Nella duplicazione il messaggio è **Impossibile duplicare la vista** e vale lo stesso.
</Accordion>
<Accordion title="Non riesco a modificare né eliminare la scheda Tutte">
**Tutte** è integrata e mostra ogni attività che puoi vedere. Nome, posizione e visibilità sono fissi. Puoi però salvarci filtri e impostazioni della vista, per l'intera organizzazione. Crea una vista tutta tua se vuoi una selezione solo per te.
</Accordion>
<Accordion title="Un collega non riesce a rendere pubblica o a eliminare la vista">
Solo il proprietario di una vista personale decide con chi è condivisa e può renderla pubblica o eliminarla. I colleghi con cui la condividi possono però modificarne le attività.
</Accordion>
<Accordion title="Vedo la barra Modifiche non salvate">
Hai modificato filtri o impostazioni della vista, e restano ancora solo sul tuo schermo. Scegli **Salva vista** per conservarli o **Annulla modifiche** per tornare indietro. In **Tutte** ti serve per questo il permesso **Gestire etichette e viste condivise**; senza questo permesso lì puoi solo annullare.
</Accordion>
<Accordion title="Un'attività non compare nel mio elenco">
Un elenco mostra solo le attività che aggiungi tu. Se vuoi che tutto ciò che soddisfa una regola vi entri da solo, scegli in **Tipo** una vista filtrata.
</Accordion>
<Accordion title="L'ordine delle schede non viene salvato">
Allora Tillor mostra **Impossibile riordinare le viste**. Trascina di nuovo le schede.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Tabella, bacheca e calendario" href="/taken/indelingen" />
  <Card title="Filtrare" href="/taken/filteren" />
  <Card title="Attività private" href="/taken/prive-taken" />
</Cards>


# Terreni (/it-IT/terreinen)

Un terreno è un posto nel tuo parco: un lotto, uno chalet, una piazzola per camper o un posto fisso. Qui crei i tuoi terreni, dai loro un tipo e una tariffa e ci colleghi i contatori. Poi ci metti sopra i clienti con un'[occupazione](/bezettingen) o una [prenotazione](/reserveringen). Li trovi in <UIPath>Parco > Terreni</UIPath>.

<DocScreenshot src="/screenshots/park/terrains-list.png" alt="Panoramica dei terreni con il terreno demo 12" />

## Come si collega tutto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  T[Terreno] --> M[Contatori]
  T --> Tar[Tariffa calcolata]
  K[Cliente] -->|occupazione| T
  Tar --> F[Fatture]
  M --> V[Consumo del cliente]
  V --> F
```

A un terreno è legato tutto ciò che riguarda quel posto. La tariffa deriva dalla superficie e dai campi personalizzati del terreno. I contatori sul terreno forniscono il consumo, e quel consumo va al cliente con un'occupazione attiva. Vedi anche [Gestione dei contatori](/meterbeheer#hoe-hangt-dit-samen).

<Callout type="info" title="Da sapere">
- Il nome è obbligatorio e può avere al massimo 255 caratteri.
- **Prenotabile** è disattivato per impostazione predefinita in un nuovo terreno.
- Tillor calcola la superficie non appena disegni il terreno sulla mappa. Non la digiti tu.
- **Terreni recenti** conta i terreni degli ultimi 7 giorni.
- Un terreno ha al massimo un'occupazione attiva alla volta.
- La tariffa calcolata viene ricalcolata non appena salvi un terreno, e per tutti i terreni non appena salvi la formula della tariffa.
- Se elimini un tipo di terreno, i terreni restano, ma non hanno più un tipo.
</Callout>

## Creare un nuovo terreno [#een-nieuw-terrein-aanmaken]

Prima di iniziare: se ti servono tipi di terreno (come **Piazzola** o **Chalet**) o campi personalizzati, creali prima. Vedi [Tipi di terreno](#terreintypes) e [Campi personalizzati](/eigen-velden).

<Steps>
<Step>
### Clicca su Crea nuovo terreno [#klik-op-nieuw-terrein-aanmaken]
Trovi il pulsante in alto a destra in <UIPath>Parco > Terreni</UIPath>.

<DocScreenshot src="/screenshots/park/terrain-create-dialog.png" alt="Finestra di creazione del terreno" />
</Step>
<Step>
### Compila i dati [#vul-de-gegevens-in]
Solo il **Nome** è obbligatorio. Per il resto puoi inserire:

- **Descrizione**, una spiegazione.
- **Tipo di terreno**, oppure lascia **Nessun tipo**.
- **Campi personalizzati** che la tua organizzazione ha aggiunto, come un supplemento o un numero del contatore del gas.
- **Prenotabile**, se i clienti possono prenotare il terreno online.
- **Posizione**, per indicare subito il terreno sulla mappa.
</Step>
<Step>
### Clicca su Crea terreno [#klik-op-terrein-aanmaken]
Il terreno compare nell'elenco. Se non hai disegnato la posizione, lo fai in seguito sulla pianta, vedi [Mappa](/kaart#terreingrenzen-intekenen).
</Step>
</Steps>

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il terreno compare nell'elenco e nelle statistiche in cima: **Terreni totali**, **Terreni recenti**, **Terreni prenotabili**, **Terreni non prenotabili** e **Superficie totale** (solo dei terreni con una posizione disegnata).
- Tillor calcola la **Tariffa calcolata** dalla formula della tariffa della tua organizzazione.
- Nella pagina di dettaglio puoi collegare contatori, aggiungere commenti e vedere la cronologia.

## Vedere e modificare un terreno [#een-terrein-bekijken-en-bewerken]

Clicca su un terreno nell'elenco. In cima trovi il nome, la descrizione, la superficie, il numero di contatori, se è prenotabile, il **Cliente** con un'occupazione attiva e la data di creazione e di modifica. Nel modulo **Aggiorna terreno** modifichi:

- **Nome**, **Tipo di terreno**, **Descrizione**, **Prenotabile** e i **Campi personalizzati**.
- **Superficie** e **Tariffa calcolata** sono di sola lettura.

Salva con **Aggiorna terreno**. Accanto al modulo trovi **Posizione**, **Contatori** e **Storico occupazioni**. Sotto trovi **Commenti** (visibili solo ai tuoi colleghi), **Eventi** con un confronto prima/dopo per ogni campo modificato, e **Prenotazioni**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Dettaglio del terreno con i contatori collegati" />

## Collegare contatori a un terreno [#meters-aan-een-terrein-hangen]

Nella scheda **Contatori** scegli **Aggiungi contatore** e poi **Assegna contatore**. Nell'elenco compaiono solo i contatori senza terreno. Per ogni contatore vedi il tipo, un indicatore di stato e l'ultima lettura. Con il menu (...) scegli **Scollega dal terreno**; questa scelta c'è solo qui. Il percorso completo fino al cliente è descritto in [Collegare un contatore a un cliente](/meterbeheer/meter-koppelen).

## Tipi di terreno [#terreintypes]

Con i tipi di terreno suddividi i terreni, ad esempio **Piazzola**, **Chalet** o **Piazzola per camper**. Il tipo lo vedi nell'elenco dei terreni (colonna **Tipo**, con un filtro), puoi colorare la mappa in base ad esso e compare nell'esportazione. Li gestisci in <UIPath>Assistenza > Impostazioni > Tipi di terreno</UIPath>.

<Requires permission="Modifica impostazioni" />

<DocScreenshot src="/screenshots/instellingen/settings-terrain-types.png" alt="Impostazioni > Tipi di terreno" />

La tabella **Tutti i tipi di terreno** mostra per ogni tipo il **Nome**, il **Colore mappa**, la **Descrizione** e il numero di **Terreni**. Cerca con **Cerca tipi di terreno...**. Con la matita modifichi un tipo, con il cestino lo elimini.

<Steps>
<Step>
### Clicca su Nuovo tipo di terreno [#klik-op-nieuw-terreintype]
</Step>
<Step>
### Compila i dati [#vul-de-gegevens-in-1]
Indica un **Nome**, se vuoi una **Descrizione**, e scegli un **Colore mappa**. Il blu è preselezionato.
</Step>
<Step>
### Clicca su Crea [#klik-op-aanmaken]
</Step>
</Steps>

<DocScreenshot src="/screenshots/instellingen/terrain-type-create-dialog.png" alt="Finestra Crea tipo di terreno" />

Un tipo lo colleghi a un terreno tramite il campo **Tipo di terreno**. Il colore della mappa lo vedi sulla pianta quando in **Livelli** imposti i colori su **Tipi di terreno**, vedi [Mappa](/kaart#lagen-en-kleuren).

## Esportare i terreni [#terreinen-exporteren]

Clicca su **Esporta tutti i terreni** (in alto a destra) per scaricare un file Excel. Contiene per ogni terreno i dati di base, il tipo di terreno, i campi personalizzati e il calcolo della tariffa (subtotale, supplementi e totale). Usalo ad esempio per il controllo annuale delle tariffe.

## Come si arriva alla tariffa [#hoe-het-tarief-tot-stand-komt]

La **Tariffa calcolata** deriva dalla formula della tariffa della tua organizzazione. La formula calcola con la superficie e con i campi personalizzati del terreno. Quali campi personalizzati siano lo decidi tu. La formula predefinita usa i campi con le chiavi `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` e `staticPrice`. Se li hai creati in <UIPath>Assistenza > Impostazioni > Campi personalizzati</UIPath>, funzionano così:

1. **Superficie**: la superficie disegnata, a scaglioni per m².
2. **Supplemento contatore gas**: si aggiunge se il campo con il numero del contatore del gas è compilato.
3. **Supplemento posizione**: l'importo che inserisci.
4. **Supplemento elettricità**: l'importo che inserisci.
5. **Prezzo statico**: se questo campo è compilato, quell'importo sostituisce la tariffa calcolata e Tillor salta la formula.

Se vuoi cambiare la tariffa di un anno, modifica i campi personalizzati, controlla in **Tariffa calcolata** che sia corretta e salva con **Aggiorna terreno**.

### Formula della tariffa [#tariefformule]

<Requires permission="Modificare la formula della tariffa piazzola" />

In <UIPath>Impostazioni > Tariffa piazzola</UIPath> decidi tu come viene calcolata la tariffa. Chi poteva già modificare le impostazioni ha ricevuto il permesso **Modificare la formula della tariffa piazzola**. La formula è un pezzo di TypeScript (un linguaggio di programmazione) che restituisce la tariffa annua in euro, oppure parti con nome che insieme formano la tariffa, come `Subtotaal` e `Toeslag gasmeter`. Ogni parte ha una propria colonna nell'esportazione.

- I campi del terreno li leggi con `{terrain.veld}`, come `{terrain.surfaceArea}` o `{terrain.customFields.locationSurcharge}`. Con il pulsante **Variabile** o digitando `{` scegli tra tutti i campi, anche i tuoi.
- A destra della formula la provi subito su uno dei tuoi terreni. Un errore lo vedi lì con il numero di riga. Una formula che non funziona non si può salvare.
- Con **Ripristina predefinita** torni alla formula con cui ogni organizzazione è partita.
- Nelle automazioni leggi la tariffa come `{terrain.calculatedTariff.total}`.

<Callout type="warn" title="Attenzione">
La formula viene eseguita in modo isolato: può calcolare solo con i campi del terreno, senza altri dati né internet. Una formula che impiega troppo tempo viene interrotta e non produce alcuna tariffa.
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice Terreno non creato">
Il terreno non è stato salvato. Controlla che il **Nome** sia compilato e non superi i 255 caratteri, e riprova.
</Accordion>
<Accordion title="La superficie è vuota o a 0">
La superficie deriva solo dalla posizione sulla mappa. Disegna il terreno in <UIPath>Parco > Mappa</UIPath>, vedi [Mappa](/kaart#terreingrenzen-intekenen). I terreni senza posizione non contano in **Superficie totale**.
</Accordion>
<Accordion title="La Tariffa calcolata non è corretta">
Controlla i campi personalizzati del terreno (supplementi e numero del contatore del gas). Se è compilato un **Prezzo statico**, questo sostituisce la tariffa calcolata. Se la formula è stata modificata, controlla in Tariffa piazzola che il test su questo terreno sia corretto.
</Accordion>
<Accordion title="Non vedo Tariffa piazzola nelle impostazioni">
Ti serve il permesso **Modificare la formula della tariffa piazzola**. Chiedilo al tuo amministratore.
</Accordion>
<Accordion title="Il contatore non è nell'elenco di Aggiungi contatore">
Quel contatore è già collegato a un altro terreno. Scollegalo prima da lì.
</Accordion>
<Accordion title="Non riesco a creare un'occupazione su questo terreno">
Un terreno con un'occupazione attiva non compare nell'elenco di scelta. Termina prima l'occupazione in corso.
</Accordion>
</Accordions>

## Termini [#begrippen]

- **Terreno**: un posto nel tuo parco. Vedi [Termini](/begrippen#terrein).
- **Tipo di terreno**: una suddivisione come **Piazzola** o **Chalet**, con un colore sulla mappa.
- **Prenotabile**: i clienti possono prenotare il terreno online.
- **Tariffa calcolata**: la tariffa che Tillor calcola dalla formula.
- **Campo personalizzato**: un campo che la tua organizzazione aggiunge. Vedi [Termini](/begrippen#eigen-veld).
- **Occupazione**: un cliente su un terreno per un periodo. Vedi [Termini](/begrippen#bezetting).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestione dei contatori" href="/meterbeheer" description="Collegare i contatori ai terreni e fatturare il consumo" />
  <Card title="Occupazioni" href="/bezettingen" description="Mettere i clienti su un terreno" />
  <Card title="Mappa" href="/kaart" description="Disegnare i confini dei terreni" />
</Cards>


# Controllo accessi (/it-IT/toegangscontrole)

Con il Controllo accessi decidi chi può entrare nel tuo parco e segui chi è all'interno. Dai a un cliente un metodo di accesso (targa, tag NFC, codice QR o PIN), comandi le sbarre dal tuo schermo e rileggi chi è passato, quando e da quale punto di accesso. Un metodo di accesso lo crei dal profilo del cliente, vedi [aggiungere un metodo di accesso](#een-toegangsmethode-toevoegen).

<DocScreenshot src="/screenshots/toegangscontrole/stats-overview.png" alt="Controllo accessi con le statistiche in alto" />

Le cifre in alto contano tutti gli accessi, le ultime 24 ore, i tentativi consentiti e bloccati e i tuoi punti di accesso attivi. Sotto trovi le azioni rapide, i veicoli nel parco, il registro accessi e le operazioni dei controller.

<Callout type="info" title="Da sapere">
- Un veicolo diventa **Fantasma** se per 7 giorni non è stato visto a un punto di accesso mentre risultava **All'interno**.
- Un metodo di accesso QR lo crei fino a 100 alla volta, ciascuno con un proprio codice.
- Un PIN è composto da 4 a 8 cifre e deve essere univoco all'interno della tua organizzazione.
- Ogni targa, ogni tag NFC e ogni codice QR può comparire una sola volta nella tua organizzazione.
- Un metodo di accesso che non rientra nel periodo **Data inizio** e **Data fine** non dà accesso.
- Una targa con stato **Blocco soft** è bloccata solo durante gli orari di apertura della reception.
- Una targa scaduta può ancora uscire per 2 giorni di default fuori dagli orari di apertura (al massimo 30). Vedi [Impostazioni del controllo accessi](/gebruikers/instellingen-toegangscontrole).
- Un veicolo compare nel profilo del cliente tramite una targa registrata, oppure tramite il tag NFC o il codice QR con cui il cliente è entrato.
</Callout>

## Come è collegato tutto? [#hoe-hangt-dit-samen]

Un metodo di accesso è la chiave di un cliente. Il punto di accesso (la sbarra o il cancello) è la porta. In mezzo ci sono le apparecchiature del tuo parco: una telecamera che legge le targhe o una scatolina che legge tag e codici QR (un controller di accesso), e il [connettore](/connector). Il connettore è la scatolina che collega Tillor ai dispositivi del tuo parco.

```mermaid
flowchart TD
  K[Cliente] --> M[Metodo di accesso<br/>targa, tag NFC, codice QR o PIN]
  M -->|Tillor invia l'elenco| C[Connettore nel tuo parco]
  C --> L[Telecamera o lettore di carte<br/>all'ingresso]
  L -->|consentito| P[Il punto di accesso si apre]
  L -->|rifiutato| W[Il punto di accesso resta chiuso]
  L -->|ogni tentativo viene segnalato| LOG[Registro accessi in Tillor]
```

Cosa significa per te:

- Se modifichi o elimini un metodo di accesso in Tillor, Tillor lo invia alle apparecchiature tramite il connettore. Il risultato lo vedi in **Operazioni controller**.
- Se il connettore è offline, i metodi di accesso nuovi o modificati restano **In attesa** finché non si ricollega.
- Anche una sbarra che apri da Tillor riceve di solito il comando tramite il connettore. Se è offline, la sbarra non si apre.

La sezione Controller nel menu principale riguarda un'altra cosa: i piccoli schermi con lettore di tag presso docce, porte e punti di ricarica. Vedi [Controller](/controllers). Le apparecchiature presso le sbarre le configura l'assistenza Tillor durante l'avvio.

## Comandare i punti di accesso [#toegangspunten-bedienen]

Sotto **Azioni rapide** c'è un pulsante per ogni punto di accesso attivo. Vedi questo blocco solo se è configurato almeno un punto di accesso o un controller di accesso.

<DocScreenshot src="/screenshots/toegangscontrole/quick-actions.png" alt="Azioni rapide con punti di accesso e pulsanti di gestione" />

<Steps>
<Step>
### Clicca sul pulsante del punto di accesso [#klik-op-de-knop-van-het-toegangspunt]
L'etichetta è **Apri [nome]**.
</Step>
<Step>
### Conferma [#bevestig]
Si apre una finestra che chiede se sei sicuro di voler aprire il punto di accesso. Clicca su **Sì, apri [nome]**.

<DocScreenshot src="/screenshots/toegangscontrole/barrier-confirm-dialog.png" alt="Conferma per aprire un punto di accesso" />
</Step>
</Steps>

Tillor segnala **Punto di accesso aperto**. Chiudere è possibile solo se il punto di accesso lo supporta. In tal caso accanto al pulsante di apertura c'è una freccia verso il basso: scegli lì **Chiudi [nome]** e conferma con **Sì, chiudi [nome]**.

### Pulsanti di gestione in Azioni rapide [#beheerknoppen-in-snelle-acties]

Accanto ai punti di accesso ci sono, a seconda delle tue apparecchiature, pulsanti per la manutenzione. Usali solo se qualcosa non va.

| Pulsante | Cosa fa | Quando |
|---|---|---|
| **Reimposta APB** | Cancella la memoria di chi è entrato o uscito per ultimo, per tipo: **Per pass NFC…** o **Per codici QR…**. | Le persone non passano più perché il cancello pensa che siano già dentro (o fuori). APB sta per anti-passback. |
| **Sincronizza log dispositivo** | Fa recuperare al connettore tutte le nuove righe dei controller di accesso. | Nel registro accessi mancano i passaggi recenti. |
| **Reimposta cache del connettore** | Il connettore cancella i suoi dati locali e riscarica tutto da Tillor. | Le apparecchiature si comportano diversamente dai metodi di accesso in Tillor. |
| **Pulisci letture LPR spazzatura** | Elimina solo le righe fantasma sicure dall'elenco targhe. Le targhe registrate e collegate restano. | Nell'elenco ci sono targhe che non appartengono a nulla. |

## Gestire i metodi di accesso dal profilo del cliente [#toegangsmethoden-beheren-via-het-klantprofiel]

I metodi di accesso li aggiungi, modifichi ed elimini nel profilo del cliente.

### Aggiungere un metodo di accesso [#een-toegangsmethode-toevoegen]

Un metodo di accesso appartiene a un cliente e gli dà accesso al parco. Li gestisci nel profilo del cliente.

Prima di iniziare:

- Il cliente esiste in Tillor.
- Per NFC ti serve un tag che non appartiene ancora a nessuno. Se non c'è un tag libero, l'elenco dice **Nessuna carta NFC disponibile; tutte le carte sono già assegnate.**
- Il tipo **Codice PIN** compare nell'elenco solo se è abilitato per la tua organizzazione.

<Steps>
<Step>
### Apri la scheda Controllo accessi [#open-het-tabblad-toegangscontrole]
Vai su <UIPath>Clienti > cliente > Controllo accessi</UIPath>. In alto c'è la tabella **Metodi di accesso** (indicatore **1** nello screenshot qui sotto).

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Profilo cliente Controllo accessi con tabella Metodi di accesso e targa 1-DOC-2026" />
</Step>
<Step>
### Clicca su Aggiungi e scegli il tipo [#klik-op-toevoegen-en-kies-het-type]
<DocScreenshot src="/screenshots/toegangscontrole/access-method-create-dialog.png" alt="Finestra per un nuovo metodo di accesso" />

Il tipo non puoi più modificarlo in seguito. Se ti serve un altro tipo, aggiungi un nuovo metodo di accesso.
</Step>
<Step>
### Compila i dati [#vul-de-gegevens-in]
Cosa compili dipende dal tipo:
</Step>
</Steps>

<Tabs items={["Targa", "NFC", "Codice QR", "Codice PIN"]}>
<Tab value="Targa">
In **Targa** inserisci la targa. Tillor la converte in maiuscolo. Marca, modello e colore sono facoltativi.
</Tab>
<Tab value="NFC">
In **Carte NFC** scegli un tag libero dall'elenco. Puoi cercare per numero del tag.
</Tab>
<Tab value="Codice QR">
Il codice lo crea Tillor stesso. Con **Quantità** crei fino a 100 metodi di accesso QR distinti in una volta, ciascuno con un proprio codice. Spunta **Stampa subito ticket termico** per inviare ogni nuovo QR subito come ticket d'ingresso alla stampante termica. L'indirizzo della stampante lo imposti nelle impostazioni dell'organizzazione. Sul ticket compaiono **Valido dal** e **Valido fino al** nel fuso orario della tua organizzazione.
</Tab>
<Tab value="Codice PIN">
Inserisci da 4 a 8 cifre, oppure clicca su **Genera**. Il PIN deve essere univoco all'interno della tua organizzazione. Per un PIN manca l'azione **Sincronizza con sistema varchi**.
</Tab>
</Tabs>

Per ogni tipo puoi inoltre compilare:

| Campo | Significato |
|---|---|
| **Data inizio**, **Data fine** | Il periodo in cui il metodo di accesso funziona. Vuoto significa nessun limite. |
| **Stato** | **Attivo**, **Inattivo**, **Bloccato** o **Blocco soft** (vedi [stati](#statussen-van-toegangsmethoden)). |
| **Converti automaticamente in targa** | Solo per codice QR e PIN. Se qualcuno usa il codice a un cancello con telecamera, Tillor sostituisce il codice con la targa letta. Di default è disattivato. |
| **Non prolungare automaticamente** | La data di fine non cambia quando viene pagata una fattura con rinnovo automatico. |
| **Note** | Appunti interni. |

Poi clicca su **Aggiungi** per salvare.

#### Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il metodo di accesso compare nella tabella e Tillor lo invia alle apparecchiature tramite il connettore. Lo segui in **Operazioni controller**, con lo stato <Status tone="info">In attesa</Status>, <Status tone="warning">In elaborazione</Status>, <Status tone="success">Completato</Status> o <Status tone="error">Non riuscito</Status>.
- Un metodo di accesso modificato o eliminato viene trasmesso allo stesso modo.
- Ogni tentativo di entrare compare nel registro accessi, anche quelli rifiutati.
- Un veicolo viene collegato al cliente tramite una targa registrata, oppure perché il cliente è entrato con un tag NFC o un codice QR mentre la telecamera leggeva anche la targa. Quest'ultimo funziona anche se la targa non è registrata.

#### Modificare, inviare o eliminare un metodo di accesso [#een-toegangsmethode-bewerken-versturen-of-verwijderen]

Clicca sui tre puntini a destra del metodo di accesso.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-actions-menu.png" alt="Menu azioni di un metodo di accesso" />

| Azione | A cosa serve |
|---|---|
| **Modifica** | Modificare periodo, stato o dati del veicolo. |
| **Sincronizza con sistema varchi** | Inviare di nuovo alle apparecchiature. Tillor segnala **Sincronizzazione richiesta**. Non per un PIN. |
| **Invia notifica** | Invia al cliente il link QR personale via e-mail, SMS o WhatsApp (finestra **Invia codice QR**). |
| **Copia URL personale** | Copia il link al pass del cliente, vedi [Wallet digitale](#digitale-wallet-qr-code). |
| **Scarica codice QR**, **Stampa ticket termico** | Solo per un codice QR. |
| **Elimina** | Rimuove il metodo di accesso. Non si può annullare. Con le spunte nella tabella ne elimini più di uno insieme. |

#### Stati dei metodi di accesso [#statussen-van-toegangsmethoden]

| Stato | Significato |
|---|---|
| <Status tone="success">Attivo</Status> | Dà accesso, finché il periodo è corretto. |
| <Status>Inattivo</Status> | Non dà accesso. Funziona come Bloccato, con un nome più chiaro. |
| <Status tone="error">Bloccato</Status> | Non dà accesso. |
| <Status tone="warning">Blocco soft</Status> | Per una targa è bloccata solo durante gli orari di apertura della reception. Fuori da questi il veicolo può ancora entrare e uscire. |

## Wallet digitale (codice QR) [#digitale-wallet-qr-code]

Per un metodo di accesso QR copi un link personale per l'ospite. Apre la pagina **Pass di accesso** con il codice QR. Se Apple Wallet o Google Wallet sono configurati per il tuo ambiente, ci sono anche pulsanti per salvare il pass.

<Steps>
<Step>
### Copia il link [#kopieer-de-link]
Apri i tre puntini del metodo di accesso QR e clicca su **Copia URL personale**. Tillor segnala **Link copiato**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-personal-url-menu.png" alt="Menu azioni di un metodo di accesso QR con Copia URL personale" />
</Step>
<Step>
### Invia il link all'ospite [#stuur-de-link-naar-de-gast]
L'ospite vede il codice QR, la validità e, se disponibili, **Aggiungi ad Apple Wallet** e **Aggiungi a Google Wallet**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-public-view-wallet.png" alt="Pagina ospite Pass di accesso con codice QR e pulsanti wallet" />
</Step>
</Steps>

Il pass wallet usa lo stesso codice QR, la stessa validità e lo stesso stato di Tillor. Su un iPhone con iOS 27 il pass compare come Poster Generic, con facoltativamente uno sfondo personalizzato e un codice QR quadrato. Gli iPhone più vecchi mostrano il layout classico. Su iOS 27 ci sono anche scorciatoie sul pass: **Indicazioni stradali** apre Apple Maps verso la posizione del punto di accesso (o il centro della mappa del parco), e se hai inserito un sito web nei dati della tua azienda, compare un pulsante verso quel sito. Sfondo e posizione li imposti in **Impostazioni**, vedi [Organizzazione](/gebruikers/organisaties). Su un iPhone il pass può comparire nella schermata di blocco quando l'ospite è nelle vicinanze. Su Android l'ospite salva il pass in Google Wallet.

### Vedere dove è salvato il pass [#zien-waar-de-pas-is-opgeslagen]

Se un ospite ha aggiunto il pass, accanto al valore QR compare una piccola icona wallet, con un numero se i dispositivi sono più di uno. Passaci sopra con il mouse per vedere:

- se il pass è in **Apple Wallet su iPhone** o **Google Wallet su Android**, e su quanti dispositivi
- la data di **Ultima aggiunta** e di **Pass aggiornato** del pass, per Apple anche **Ultima sincronizzazione**
- se il pass è **Emesso tramite** un **Collaboratore** o un **Link personale**

Google non segnala quando un ospite rimuove il pass. Con Google Wallet il pass resta quindi indicato come salvato.

### Inviare di nuovo un pass wallet [#een-wallet-pas-opnieuw-versturen]

Se un pass QR cambia, ad esempio la validità, Tillor invia da solo l'aggiornamento ai wallet. Se c'è comunque una versione vecchia, scegli **Sincronizza pass Wallet** nel menu. Tillor segnala quanti dispositivi hanno ricevuto l'aggiornamento. Se il pass non è ancora registrato da nessuna parte, vedi **Nessun dispositivo registrato per gli aggiornamenti.** La voce di menu compare solo quando il pass è stato aggiunto a un wallet.

## Veicoli nel parco [#voertuigen-in-het-park]

La tabella **Veicoli nel parco** tiene traccia, per ogni targa, se un veicolo è all'interno. Una lettura a un ingresso mette il veicolo su **All'interno**, una lettura a un'uscita su **Uscito**.

Ogni riga mostra la targa, lo stato, il cliente, il momento dell'ingresso, l'ultimo momento in cui il veicolo è stato visto a un punto di accesso e quel punto di accesso. La tabella mostra di default i veicoli che sono **All'interno** o **Fantasma**. Con i filtri mostri anche i veicoli usciti, filtri per punto di accesso o cerchi per targa o nome del cliente.

| Stato | Significato |
|---|---|
| <Status tone="success">All'interno</Status> | Entrato da un ingresso e non ancora uscito. |
| <Status tone="warning">Fantasma</Status> | Risultava All'interno, ma non è stato più visto a un punto di accesso da 7 giorni. |
| <Status>Uscito</Status> | Uscito da un'uscita. |

Un veicolo fantasma nasce di solito perché la telecamera non ha letto la targa all'uscita, o l'ha letta male all'ingresso. Se la targa viene vista di nuovo a un ingresso, torna su **All'interno**.

### Occupazione del parco [#parkbezetting]

La scheda **Occupazione parco** mostra quanti veicoli ci sono all'interno: **Attualmente all'interno**, il **Picco** nel periodo scelto, e il numero di **Ingressi** e **Uscite**. Il primo grafico mostra l'andamento, per ora fino a una settimana e per giorno per un periodo più lungo. **Ore più frequenti** mostra per ogni ora del giorno il numero medio di veicoli e di arrivi. Così vedi, ad esempio, quando c'è abbastanza gente per aprire il bar-ristorante. Con il selettore di periodo in alto a destra scegli oggi, 7 giorni, 30 giorni, 90 giorni, tutto o un intervallo personalizzato.

## Registro accessi [#toegangslogboek]

Il registro accessi mostra ogni tentativo di entrare, con data, metodo di accesso, cliente (se noto), punto di accesso e stato.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Registro accessi con targhe, cliente e stato" />

Filtra e cerca per targa o valore (per NFC anche per etichetta della carta), intervallo di date, stato, tipo di metodo di accesso, punto di accesso o cliente. Con **Esporta** a destra nella barra degli strumenti scarichi il registro come file Excel.

| Stato | Significato |
|---|---|
| Consentito | L'accesso è stato concesso. |
| Bloccato | L'accesso è stato rifiutato. |
| Inattivo | Il metodo di accesso è inattivo. |
| Scaduto | Il metodo di accesso è scaduto. |
| Non valido | Il metodo di accesso non è valido. |
| Negato | L'accesso è stato attivamente negato. |
| Blocco soft | L'accesso è bloccato in modo soft. |
| Errore dispositivo | C'è stato un problema con il dispositivo. |
| Nessun veicolo | Non è stato rilevato alcun veicolo. |
| APB - Direzione non corrispondente | Il cancello blocca il passaggio perché la direzione non è corretta (anti-passback). |
| Sconosciuto | Non è stato possibile determinare lo stato. |
| Messaggio di sistema | Un messaggio del sistema stesso. |

## Cronologia stato barriere [#hekstatusgeschiedenis]

Sotto il registro accessi c'è anche la **Cronologia stato barriere**: quando un punto di accesso era **Aperto**, **Chiuso** o **In movimento**, con la **Fonte** della segnalazione. Se la posizione non è nota, compare **Sconosciuto**. Filtra per stato o punto di accesso. Se l'elenco è vuoto, non sono ancora state ricevute segnalazioni di posizione.

## Operazioni controller [#controller-operaties]

Sotto c'è **Operazioni controller**. Sono i comandi che Tillor invia ai controller di accesso, come **Crea**, **Aggiorna**, **Elimina** e **Sincronizza**. Così vedi quando un pass o un codice QR è arrivato al punto di accesso.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Operazioni controller con comandi e relativo stato" />

Un comando è <Status tone="info">In attesa</Status>, <Status tone="warning">In elaborazione</Status>, <Status tone="success">Completato</Status> o <Status tone="error">Non riuscito</Status>. Con l'icona a forma di occhio a destra nella riga apri i dettagli.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Manca il blocco Azioni rapide">
Il blocco compare solo se è configurato un punto di accesso o un controller di accesso. Se non c'è nulla, l'assistenza Tillor non ha ancora collegato le apparecchiature.
</Accordion>
<Accordion title="Tillor dice: Impossibile aprire la sbarra">
Il punto di accesso non ha risposto. Di solito il connettore è offline o il dispositivo non è raggiungibile. Controlla il connettore, vedi [Connettore non collegato](/connector#problemen), e riprova.
</Accordion>
<Accordion title="Tillor dice: Questo valore credenziale è già in uso">
Ogni targa, ogni tag NFC e codice QR può comparire una sola volta nella tua organizzazione. Per una targa Tillor indica a quale cliente è già assegnata. Elimina o modifica prima quel metodo di accesso.
</Accordion>
<Accordion title="Un cliente non entra con una targa valida">
Guarda nel registro accessi quale stato ha avuto il tentativo. **Scaduto** o **Inattivo**: controlla **Data inizio**, **Data fine** e **Stato** del metodo di accesso. **Blocco soft**: la targa è bloccata durante gli orari di apertura della reception. **Errore dispositivo** o **Nessun veicolo**: la telecamera non ha letto nulla, controlla le apparecchiature. Se il metodo di accesso è corretto ma il cancello rifiuta ancora, guarda in **Operazioni controller** se l'ultima modifica è **Completato**.
</Accordion>
<Accordion title="Un nuovo metodo di accesso non funziona ancora al cancello">
Guarda in **Operazioni controller** se il comando è <Status tone="success">Completato</Status>. Se è **In attesa**, probabilmente il connettore è offline. Se è **Non riuscito**, scegli **Sincronizza con sistema varchi** sul metodo di accesso.
</Accordion>
<Accordion title="Le persone vengono rifiutate con APB - Direzione non corrispondente">
Il cancello pensa che siano già dentro (o fuori). Clicca su **Reimposta APB** in Azioni rapide e scegli **Per pass NFC…** o **Per codici QR…**. Conferma con **Reimposta**.
</Accordion>
<Accordion title="L'elenco dei tag NFC è vuoto">
Nell'elenco ci sono solo i tag che non appartengono ancora a nessuno. Rimuovi prima un tag dall'altro cliente, vedi [Gestire i tag](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen).
</Accordion>
<Accordion title="Un veicolo risulta come Fantasma">
Il veicolo non viene visto da 7 giorni. Di solito se n'è andato senza che la telecamera lo vedesse. Torna da solo **All'interno** quando la targa viene letta di nuovo a un ingresso.
</Accordion>
</Accordions>

## Termini [#begrippen]

- **Metodo di accesso**: la chiave di un cliente, una targa, un tag NFC, un codice QR o un PIN.
- **Punto di accesso**: la sbarra, il cancello o la porta che si apre.
- **Controller di accesso**: la scatolina presso il punto di accesso che legge tag e codici QR.
- **Connettore**: la scatolina nel tuo parco che collega Tillor alle apparecchiature. Vedi [Connettore](/connector).
- **APB (anti-passback)**: la regola per cui non puoi passare due volte nella stessa direzione da un cancello.
- **Veicolo fantasma**: un veicolo che risulta all'interno ma non viene visto da 7 giorni.

Altre spiegazioni sono nel [glossario dei termini](/begrippen).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Connettore" href="/connector" description="La scatolina che collega Tillor alle tue apparecchiature" />
  <Card title="NFC" href="/nfc" description="Collegare i tag e gestire il saldo" />
  <Card title="Impostazioni del controllo accessi" href="/gebruikers/instellingen-toegangscontrole" description="Tolleranza per le targhe scadute" />
  <Card title="Gestione clienti" href="/klantenbeheer" />
</Cards>


# Meteo (/it-IT/weer)

Nella pagina **Meteo** vedi, giorno per giorno, il tempo che fa nella località del tuo parco, così puoi mettere un picco di consumi o di affluenza accanto al meteo. Tillor usa questi dati anche per i contatori e le prenotazioni.

<Callout type="info" title="Da sapere">
- Il meteo dipende dal centro mappa della tua organizzazione. Se è sbagliato, anche il meteo non corrisponde.
- Tillor recupera il meteo ogni notte e completa i giorni mancanti del passato.
- Di default vedi gli ultimi 14 giorni.
- Un giorno con **Archivio** è definitivo. Un giorno con **Previsione** può ancora cambiare.
</Callout>

## Aprire la pagina [#de-pagina-openen]

Vai su <UIPath>Parco > Meteo</UIPath>.

<DocScreenshot src="/screenshots/weer/weather-overview.png" alt="Parco > Meteo con le previsioni giornaliere" />

Sotto **Previsioni giornaliere** trovi la località, ad esempio **Centro mappa: 50.8503, 4.3517**. È il centro mappa del tuo parco. Lo imposti in <UIPath>Impostazioni > Mappa</UIPath>. Se lo sposti, il meteo segue la nuova posizione. Vedi [Mappa](/kaart).

Vedi:

- una scheda grande per il giorno più recente, con temperatura, condizione, temperatura massima e minima e quantità di pioggia. Accanto al giorno c'è **Archivio** per un giorno già definitivo, oppure **Previsione** per un giorno che può ancora essere aggiornato
- sotto, una scheda per ogni giorno, con la condizione come **Sereno**, **Parzialmente nuvoloso**, **Coperto**, **Nebbia**, **Pioggerella**, **Pioggia**, **Rovesci**, **Neve** o **Temporale**, la temperatura massima e minima e la pioggia in mm. Oggi ha un bordo colorato
- **Nessun dato per questo giorno** in un giorno per cui Tillor non ha nulla

## Scegliere un altro periodo [#een-andere-periode-kiezen]

Di default vedi gli ultimi 14 giorni. Clicca in alto a destra su **Seleziona un periodo** per sceglierne un altro: **Oggi**, **Ieri**, **Ultimi 7 giorni**, **Ultimo mese**, **Ultimi 3 mesi**, **Tutti** o un **Intervallo personalizzato** sul calendario. Conferma un intervallo personalizzato con **Applica**.

## Ancora nessun dato meteo [#nog-geen-weergegevens]

Se vedi **Nessun dato meteo ancora**, il meteo non è ancora stato recuperato. Tillor lo recupera ogni notte per il centro mappa della tua organizzazione e completa anche i giorni mancanti del passato. Prova un altro periodo o torna il giorno dopo. Controlla anche che il centro mappa sia corretto.

## Dove vedi ancora il meteo [#waar-zie-je-het-weer-nog-meer]

- Nella pagina del contatore, in **Consumo e trend**: in un giorno di picco compare la temperatura e, in caso di consumo elevato, un riepilogo degli ultimi 7 giorni. Vedi [Gestione contatori](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).
- Nella timeline delle prenotazioni e nei grafici dei veicoli nel parco, con il meteo di quel giorno.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Compare Nessun dato meteo ancora">
Il meteo non è ancora stato recuperato. Prova un altro periodo o torna il giorno dopo, e controlla che il centro mappa sia corretto.
</Accordion>
<Accordion title="Il meteo non corrisponde al mio parco">
Il centro mappa si trova in un altro punto. Spostalo in <UIPath>Impostazioni > Mappa</UIPath>, vedi [Mappa](/kaart#kaartstandaard-instellen). Il meteo segue la nuova posizione.
</Accordion>
<Accordion title="Un giorno mostra Nessun dato per questo giorno">
Per quel giorno Tillor non ha nulla. Viene completato automaticamente quando i dati diventano disponibili.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Mappa" href="/kaart" description="Impostare il centro mappa del tuo parco" />
  <Card title="Gestione contatori" href="/meterbeheer" description="Consumo e trend per contatore" />
</Cards>


# Panoramica (/it-IT/api-referentie)

Questo riferimento è generato direttamente dall'API di Tillor. Ogni endpoint ha una pagina propria con parametri, corpo della richiesta, possibili risposte ed esempi di codice. Nella barra laterale gli endpoint sono raggruppati per argomento.

## Inviare una richiesta [#een-request-versturen]

Ogni richiesta richiede la tua chiave API nell'header `x-api-key`. Gli endpoint sotto `/orgs/{organizationId}` lavorano all'interno di una singola organizzazione.

```http
GET https://api.tillor.eu/orgs/org_abc123/customers
x-api-key: tkn_xxx
```

Crei una chiave API nell'app, nel tuo account. Come funziona, quali rate limit valgono e come conservare le chiavi in modo sicuro lo leggi in [API HTTP](/ontwikkelaars/http).

## Chi può chiamare un endpoint [#wie-mag-een-endpoint-aanroepen]

Ogni pagina di endpoint mostra in alto, sotto **Accesso**, chi può chiamarlo. Per la maggior parte degli endpoint è un membro dell’organizzazione con un determinato permesso, come `customers:read`. Una chiave API funziona con i permessi della persona che l’ha creata; se la chiave ha degli scope, il permesso deve esserci anche lì. Altrimenti l’API risponde `403`.

La specifica riporta la stessa informazione per ogni endpoint in `x-tillor-access`, con `access` (chi) e `permissions` (ne basta uno).

## Provare nel playground [#uitproberen-in-de-playground]

In ogni pagina di endpoint puoi inviare subito la richiesta. Se hai effettuato l'accesso a Tillor nello stesso browser, il playground usa la tua sessione e non ti serve una chiave API. Altrimenti inserisci la tua chiave API in **Authorization**. Modifica i parametri e clicca **Send**.

Il playground comunica con la vera API della tua organizzazione: un `POST`, `PUT` o `DELETE` modifica quindi dati reali.

<Callout type="warn" title="Usa un'organizzazione di prova">
Prova gli endpoint di scrittura su un'organizzazione di prova, non sul tuo parco in uso.
</Callout>

## Scaricare la specifica [#specificatie-downloaden]

La specifica completa è disponibile come OpenAPI 3.1 su [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Importala in Postman o Insomnia, oppure generaci un client.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="API HTTP" description="Autenticazione, rate limit e convenzioni" href="/ontwikkelaars/http" />
  <Card title="Webhook" description="Ricevere eventi sul tuo URL" href="/ontwikkelaars/webhooks" />
</Cards>


# Gestire un controller (/it-IT/controllers/controller-beheren)

Nella pagina di un controller modifichi i suoi dati ed esegui la manutenzione. Impostazioni come ACL, rete e aggiornamenti si trovano a parte in [Impostazioni controller](/controllers/settings).

Prima di iniziare:

- Il controller è approvato, vedi [Collegare un controller](/controllers/controller-koppelen).

## Cambiare nome, tipo e gruppo [#naam-type-en-groep-wijzigen]

<Steps>
<Step>
### Apri il controller [#open-de-controller]
Vai su <UIPath>Controller > Panoramica</UIPath> e clicca sul controller.
</Step>
<Step>
### Modifica il modulo [#pas-het-formulier-aan]
In **Impostazioni controller** scegli il **Nome**, il **Tipo** (**Doccia**, **Accesso** o **Punto di ricarica**) e il **Gruppo**.
</Step>
<Step>
### Clicca su Salva [#klik-op-opslaan]
Tillor segnala **Controller aggiornato** e invia le impostazioni al controller.
</Step>
</Steps>

## Riavviare un controller [#een-controller-herstarten]

Se un controller non risponde bene, riavvialo da Tillor.

<Tabs items={["Nella pagina di dettaglio", "Nella panoramica"]}>
<Tab value="Nella pagina di dettaglio">
Apri il menu azioni (i tre puntini) e scegli **Riavvia controller**.

<DocScreenshot src="/screenshots/controllers/controller-actions-menu.png" alt="Menu azioni di un controller con Riavvia controller" />
</Tab>
<Tab value="Nella panoramica">
Clicca sull'icona di riavvio nella riga del controller.
</Tab>
</Tabs>

Lo schermo mostra **Riavvio in corso** e poi il controller si ricollega.

Il menu azioni contiene anche **Visualizza log in Grafana**. Apre i registri del controller in un altro programma, pensato per l'assistenza. Nella pagina del controller stessa trovi i log recenti nella scheda **Console**.

## Aggiornare a una nuova versione [#bijwerken-naar-een-nieuwe-versie]

Se accanto al numero di versione c'è una freccia verso l'alto, è disponibile un <Term term="firmware">firmware</Term> (software) più recente. Passaci sopra per vedere la versione (**Aggiornamento disponibile**) e clicca per avviare l'aggiornamento. Tillor segnala **Aggiornamento OTA avviato**. Quando i controller si aggiornano da soli, lo leggi in [Aggiornamenti firmware](/controllers/updates).

## Eliminare un controller [#een-controller-verwijderen]

Nel menu azioni scegli **Elimina controller** e conferma in **Elimina controller**. Il controller scompare dalla tua lista. In seguito può richiedere di nuovo l'adozione.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Dopo un riavvio il controller si ricollega a Tillor. Ci vuole un attimo.
- Dopo l'aggiornamento il controller si riavvia da solo. Lascia l'alimentazione accesa mentre lo schermo mostra **Aggiornamento in corso** con una percentuale.
- Un controller eliminato non dà più accesso.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice: Riavvio non riuscito">
Non è stato possibile riavviare il controller, di solito perché è offline. Controlla alimentazione e rete, vedi [Problemi di connessione](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="Tillor dice: Aggiornamento OTA non riuscito">
Non è stato possibile avviare l'aggiornamento. Controlla che il controller sia online e che **Salta aggiornamenti OTA** sia su **No**, vedi [Aggiornamenti firmware](/controllers/updates).
</Accordion>
<Accordion title="Tillor dice: Aggiornamento non riuscito">
Non è stato possibile salvare il modulo. Riprova e controlla che il nome sia compilato.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni controller" href="/controllers/settings" description="ACL, rete, aggiornamenti e relè" />
  <Card title="Aggiornamenti firmware" href="/controllers/updates" description="Finestra e frequenza degli aggiornamenti" />
</Cards>


# Collegare un controller (/it-IT/controllers/controller-koppelen)

Un nuovo controller funziona per la tua organizzazione solo dopo la tua approvazione. Si chiama adozione: dici a Tillor che quella scatolina appartiene al tuo parco. Poi puoi assegnargli un tipo e un gruppo, vedi [Gestire un controller](/controllers/controller-beheren).

Prima di iniziare:

- Hai alimentazione e una rete (cavo o Wi-Fi) nel punto in cui andrà il controller.
- Se usi il Wi-Fi, hai a portata di mano il nome della rete e la password.
- Apri Tillor possibilmente sulla stessa rete del controller. Altrimenti a volte non vedi la sua richiesta.

## Collegare e approvare il controller [#de-controller-aansluiten-en-goedkeuren]

<Steps>
<Step>
### Collega il controller [#sluit-de-controller-aan]
Inserisci l'alimentazione. Lo schermo mostra **Connessione in corso...** e poi cosa manca ancora.
</Step>
<Step>
### Dagli una rete [#geef-hem-een-netwerk]
<Tabs items={["Cavo di rete", "Wi-Fi"]}>
<Tab value="Cavo di rete">
Inserisci il cavo di rete. Il controller si collega da solo, non devi impostare nulla.
</Tab>
<Tab value="Wi-Fi">
Tocca sullo schermo **Configura Wi-Fi**, scegli la tua rete, digita la password e conferma. Lo schermo mostra **Connesso**. Vedi [Configurare il Wi-Fi sullo schermo](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).
</Tab>
</Tabs>
</Step>
<Step>
### Apri Controller in Tillor [#open-controllers-in-tillor]
Vai su <UIPath>Controller > Panoramica</UIPath>. Appena il controller ha una connessione, compare nella lista con l'avviso **In attesa di approvazione**. Lo schermo del controller mostra **Attiva controller** con il numero del dispositivo. Quel numero è l'<Term term="eFuse ID">eFuse ID</Term>, il numero di serie della scatolina. Controlla che sia lo stesso della lista.
</Step>
<Step>
### Clicca su Approva [#klik-op-goedkeuren]
Clicca sulla spunta (**Approva**) nella riga. Tillor segnala **Approvato** e il controller viene aggiunto alla tua organizzazione.
</Step>
</Steps>

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Lo schermo del controller mostra **Scansiona QR** e **Scansiona il tuo tag**. È pronto all'uso.
- Tillor invia automaticamente al controller i dati di connessione e le impostazioni. Non devi compilare nulla.
- La sua prima scansione crea il tag in Tillor, se non esisteva ancora.
- Con la croce (**Rifiuta**) rifiuti una richiesta. Il controller non ottiene allora accesso alla tua organizzazione.
- Se in seguito metti via un controller o lo sostituisci, eliminalo, vedi [Gestire un controller](/controllers/controller-beheren#een-controller-verwijderen). Può poi fare di nuovo una richiesta.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il controller non compare nella lista">
Lo schermo deve mostrare **Attiva controller** prima che compaia. Se c'è ancora **Configura Wi-Fi** o **Connessione in corso...**, non è ancora online. Apri Tillor anche dalla stessa rete del controller e aggiorna la pagina. Altri passaggi sono in [Il controller non compare in Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor).
</Accordion>
<Accordion title="Tillor dice: Approvazione non riuscita">
Non è stato possibile approvare l'adozione. Riprova. Se continua a non funzionare, controlla che l'orologio del controller sia corretto e contatta l'assistenza. Vedi [Adozione non riuscita](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd).
</Accordion>
<Accordion title="Lo schermo resta su Connessione in corso...">
Attendi da 1 a 2 minuti. Se non cambia, controlla il cavo o il segnale Wi-Fi. Vedi [Lo schermo resta su Connessione in corso...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Gestire un controller" href="/controllers/controller-beheren" description="Nome, gruppo, riavvio ed eliminazione" />
  <Card title="Messaggi sullo schermo" href="/controllers/troubleshooting/scherm" description="Cosa mostra il controller" />
</Cards>


# Panoramica (/it-IT/controllers)

Un controller è una piccola scatola con uno schermo tattile rotondo nel tuo parco, presso una doccia, una porta o un punto di ricarica. Un ospite avvicina un tag <Term term="NFC">NFC</Term> oppure scansiona il codice QR sullo schermo, e Tillor decide se è consentito. Qui leggi cosa fa un controller e come si collega a clienti e saldo. Un nuovo controller lo metti in servizio con [Collegare un controller](/controllers/controller-koppelen).

I controller si trovano nel menu principale sotto **Controller**. Le sbarre e i controller di accesso presso il tuo cancello non ne fanno parte, vedi [Controllo accessi](/toegangscontrole).

<Callout type="info" title="Da sapere">
- Un controller si annuncia a Tillor ogni 15 secondi. Dopo circa 35 secondi senza contatto Tillor lo mostra come offline.
- Dopo 5 minuti senza contatto il team Tillor riceve una notifica.
- Un controller ricorda al massimo 8 reti Wi-Fi.
- Il controllo accessi tramite il controller (ACL) è disattivato di default. Attiva **ACL abilitato** nelle [impostazioni](/controllers/settings) per far verificare i tag.
- Di default controlla ogni giorno se c'è una nuova versione del software. Un aggiornamento parte solo entro la finestra di aggiornamento, se l'hai impostata.
- Di default attende 1000 millisecondi (1 secondo) la risposta di Tillor prima di passare oltre, nell'impostazione **Timeout API ACL**.
- In caso di breve interruzione il pagamento con un tag funziona ancora. Il pagamento tramite codice QR per un po' non funziona.
</Callout>

## Come è collegato tutto? [#hoe-hangt-dit-samen]

Il controller non decide da solo chi può passare. Legge il tag e lo chiede a Tillor. Lì risulta a quale cliente appartiene il tag, per quali gruppi di accesso vale e quanto saldo contiene.

```mermaid
flowchart TD
  G[L'ospite avvicina il tag allo schermo] --> C[Controller]
  C -->|chiede se è consentito| T[Tillor]
  T --> K[Cliente del tag]
  T --> A[Gruppi di accesso e saldo]
  T -->|consentire o rifiutare| C
  C -->|mostra il risultato| G
  T --> TR[Transazione nella cronologia del tag]
```

- Ogni controller ha un **Tipo** (**Doccia**, **Accesso** o **Punto di ricarica**) ed eventualmente un **Gruppo**. Quali tag possono usarlo lo gestisci con i gruppi di accesso del tag, vedi [Gestire i tag](/nfc/nfc-tags).
- Se il controller non riesce a raggiungere Tillor per un momento, con **Locale prima** usa i dati che ha memorizzato lui stesso, vedi [Impostazioni](/controllers/settings).
- Un tag che non è ancora in Tillor viene creato appena viene avvicinato a un controller per la prima volta.

## Cosa vedi in Tillor? [#wat-zie-je-in-tillor]

- **Panoramica controller**: tutti i controller con versione, tipo, gruppo, utilizzo e quando sono stati visti l'ultima volta (**Ultimo contatto**). I controller che vogliono essere collegati sono in **In attesa di approvazione**.
- **Dettaglio controller**: stato, rete, carico del controller, reti Wi-Fi, eventi e la scheda **Console** con i log.
- **Gestione**: riavviare, aggiornare ed eliminare, vedi [Gestire un controller](/controllers/controller-beheren).

## Argomenti [#onderdelen]

<Cards>
  <Card title="Collegare un controller" href="/controllers/controller-koppelen" description="Collegare e approvare" />
  <Card title="Gestire un controller" href="/controllers/controller-beheren" description="Nome, gruppo, riavvio ed eliminazione" />
  <Card title="Configurare le reti Wi-Fi" href="/controllers/wifi-netwerken" description="Fino a 8 reti in ordine di priorità" />
  <Card title="Impostazioni controller" href="/controllers/settings" description="ACL, rete, aggiornamenti e relè" />
  <Card title="Aggiornamenti firmware" href="/controllers/updates" description="Finestra e frequenza degli aggiornamenti" />
  <Card title="Messaggi sullo schermo" href="/controllers/troubleshooting/scherm" description="Cosa significa il messaggio sullo schermo?" />
  <Card title="Problemi di connessione" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, connessione a Tillor e adozione" />
  <Card title="Glossario" href="/controllers/lexicon" description="Termini come OTA, adozione e ACL" />
</Cards>

## Termini [#begrippen]

- **Controller**: la scatolina con schermo e lettore di tag.
- **Tag**: la carta, il braccialetto o il portachiavi di un ospite. Vedi [NFC](/nfc).
- **Adozione**: colleghi un nuovo controller alla tua organizzazione.
- **ACL**: l'elenco che stabilisce se un tag è consentito. Vedi [il glossario](/controllers/lexicon).
- **Firmware**: il software nella scatolina.

Altre spiegazioni sono nel [glossario dei termini](/begrippen).


# Glossario (/it-IT/controllers/lexicon)

Una panoramica dei termini che incontri lavorando con i controller. Per ogni termine c'è una spiegazione e, in un blocco di citazione, cosa intendiamo in parole semplici.

## A [#a]

<LexiconList>
<LexiconEntry
  term="ACL"
  termAlt="(Access Control List)"
  definition="Controllo accessi tramite il controller. Con ACL attivo verifica se una carta NFC è consentita; con ACL disattivo le carte vengono scansionate ma non validate. La priorità ACL stabilisce se guarda prima in locale o se consulta Tillor online."
  simple="Il controller controlla in un elenco se la tua carta è consentita. Quell'elenco si chiama ACL."
/>
<LexiconEntry
  term="Adozione"
  definition="Il collegamento di un controller alla tua organizzazione in Tillor. Dopo l'adozione il controller riceve le impostazioni corrette e può connettersi a Tillor."
  simple="In Tillor dici 'questo controller è nostro'. Poi il controller conosce la tua organizzazione e collabora."
/>
<LexiconEntry
  term="API"
  definition="La consultazione online di Tillor durante il controllo accessi. Con API prima il controller chiede sempre a Tillor; con Locale prima lo fa solo se la carta non è presente in locale."
  simple="Il controller chiede a Tillor online se una carta è consentita. Questa richiesta online la chiamiamo API."
/>
</LexiconList>

## C [#c]

<LexiconList>
<LexiconEntry
  term="Controller"
  definition="La scatolina fisica che si trova nel tuo parco. Il controller legge le carte NFC, verifica l'accesso e comunica con Tillor."
  simple="La scatolina presso la doccia o la porta a cui avvicini il tag."
/>
<LexiconEntry
  term="Credentials"
  definition="Dati di accesso o di connessione. Dopo l'adozione il controller riceve automaticamente le credentials giuste per connettersi a Tillor."
  simple="I dati di accesso con cui il controller, dopo l'adozione, si collega a Tillor in modo sicuro. Li riceve automaticamente: non devi compilare nulla."
/>
</LexiconList>

## E [#e]

<LexiconList>
<LexiconEntry
  term="eFuse ID"
  termAlt="(Electronic Fuse ID)"
  definition="Un numero di identificazione univoco memorizzato nell'hardware del controller. Ogni controller ha un eFuse ID diverso: così Tillor riconosce di quale scatolina si tratta."
  simple="Il numero d'impronta digitale della scatolina. Come un numero di serie, ma impresso nel chip."
/>
</LexiconList>

## F [#f]

<LexiconList>
<LexiconEntry
  term="Firmware"
  definition="Il software che gira sul controller. Con gli aggiornamenti firmware il controller riceve nuove funzioni e miglioramenti."
  simple="Il programma nella scatolina. Come il tuo telefono quando riceve un aggiornamento."
/>
</LexiconList>

## N [#n]

<LexiconList>
<LexiconEntry
  term="NFC"
  definition="Near Field Communication: la tecnica con cui il controller legge carte, braccialetti e portachiavi. Per scansionare avvicini il tag allo schermo."
  simple="Il modo in cui il controller legge il tuo tag. Lo avvicini e basta: niente codice a barre né PIN."
/>
</LexiconList>

## O [#o]

<LexiconList>
<LexiconEntry
  term="OTA"
  termAlt="(Over-The-Air)"
  definition="Aggiornamenti via internet, senza dover collegare nulla. Il controller scarica e installa automaticamente il nuovo firmware."
  simple="La scatolina scarica da sola il nuovo software via internet. Non devi fare nulla: succede da sé."
/>
</LexiconList>

## R [#r]

<LexiconList>
<LexiconEntry
  term="Relè"
  definition="Un interruttore nel controller con cui puoi comandare un punto di accesso o un altro dispositivo."
  simple="Un pulsante nella scatolina che può aprire o chiudere il tuo punto di accesso."
/>
</LexiconList>

## S [#s]

<LexiconList>
<LexiconEntry
  term="Schermo"
  definition="Lo schermo tattile rotondo del controller. Mostra lo stato in parole semplici (pronto, pagato, rifiutato, nessuna connessione), il codice QR per pagare online, e ci configuri il Wi-Fi. Il lettore di tag si trova dietro lo schermo."
  simple="Il piccolo schermo rotondo a cui avvicini il tag. Dice cosa sta succedendo."
/>
</LexiconList>

## T [#t]

<LexiconList>
<LexiconEntry
  term="Tag"
  definition="Il supporto NFC che un ospite riceve: una carta, un braccialetto, un portachiavi o un adesivo. In Tillor il tag è collegato a un cliente e può avere un saldo."
  simple="La tessera, il braccialetto o il portachiavi con cui fai la doccia o entri."
/>
<LexiconEntry
  term="Tillor"
  definition="La piattaforma di gestione del parco. Il controller si collega a Tillor per verificare l'accesso e scambiare dati."
  simple="Il programma in cui lavori tu, sul computer o sul tablet. Il controller parla con quello."
/>
</LexiconList>

## U [#u]

<LexiconList>
<LexiconEntry
  term="Finestra di aggiornamento"
  definition="L'intervallo di tempo in cui il controller può aggiornarsi (ad es. tra le 02:00 e le 04:00). Fuori da questa finestra non vengono eseguiti aggiornamenti."
  simple="Scegli tu quando la scatolina può aggiornarsi. Ad esempio solo di notte, così di giorno nessuno ne è disturbato."
/>
</LexiconList>


# Impostazioni controller (/it-IT/controllers/settings)

Questa è una pagina di riferimento per le impostazioni di un controller. Le trovi in <UIPath>Controller > Panoramica > [nome controller]</UIPath>, nel modulo sotto l'intestazione. Clicca su **Salva** per applicare le modifiche. Tillor poi invia le impostazioni al controller. Nome, tipo e gruppo li modifichi in [Gestire un controller](/controllers/controller-beheren).

## Configurazione ACL [#acl-configuratie]

L'<Term term="ACL">ACL</Term> (Access Control List) stabilisce come il controller verifica l'accesso. *Ovvero: come la scatolina controlla se una carta è consentita.*

| Impostazione | Significato |
| ------------ | ----------- |
| **ACL abilitato** | Imposta su **Sì** per usare il controllo accessi tramite il controller. Su **No** le carte vengono scansionate ma non validate. Di default è su **No**. |
| **Priorità ACL** | **Locale prima**: il controller controlla prima la propria memoria, poi Tillor. *Utile se internet cade per un momento.* **API prima**: chiede sempre direttamente a Tillor. Di default **Locale prima**. |
| **Timeout <Term term="API">API</Term> ACL** | Per quanto tempo (in millisecondi) il controller attende Tillor prima di passare oltre. Di default 1000 ms (1 secondo). |

<Callout type="info" title="Quando scegliere Locale prima?">
Scegli **Locale prima** se vuoi che il controller funzioni anche in caso di interruzioni temporanee di internet. Il controller memorizza i diritti di accesso in locale.
</Callout>

## Configurazione internet [#internetconfiguratie]

| Impostazione | Significato |
| ------------ | ----------- |
| **Connessione di rete principale** | **WiFi** o **Ethernet** (cavo di rete). È la connessione che il controller prova per prima. Di default **WiFi**. |
| **Reti Wi-Fi** | L'elenco delle reti Wi-Fi che il controller conosce, con un massimo di 8. Vedi [Configurare le reti Wi-Fi](/controllers/wifi-netwerken). |

## Configurazione aggiornamenti [#updateconfiguratie]

Vedi [Aggiornamenti <Term term="firmware">firmware</Term>](/controllers/updates) per una spiegazione completa su frequenza degli aggiornamenti, finestra di aggiornamento e salto degli aggiornamenti OTA.

| Impostazione | Significato |
| ------------ | ----------- |
| **Frequenza aggiornamenti** | Con quale frequenza la scatolina controlla se c'è una nuova versione: **Ogni ora**, **Giornaliero** o **Settimanale**. |
| **Periodo aggiornamento da/a** | *Quando può aggiornarsi la scatolina?* Ad es. 02:00-04:00 = solo di notte. |
| **Salta aggiornamenti <Term term="OTA">OTA</Term>** | Imposta su **Sì** se la scatolina non deve più scaricare aggiornamenti. *Utile temporaneamente, ma normalmente lo lasci su No.* |

## Controllo del relè [#relais-aansturing]

Il <Term term="relais">relè</Term> è un interruttore nella scatolina. *Puoi usarlo, ad esempio, per aprire o chiudere un punto di accesso.*

| Impostazione | Significato |
| ------------ | ----------- |
| **Tipo relè** | Al momento è supportato solo **Interno**. |
| **Porta relè** | Numero di porta del relè. Di default 1. |

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Configurare le reti Wi-Fi" href="/controllers/wifi-netwerken" description="Reti e priorità" />
  <Card title="Aggiornamenti firmware" href="/controllers/updates" description="Finestra di aggiornamento e impostazioni OTA" />
  <Card title="Messaggi sullo schermo" href="/controllers/troubleshooting/scherm" description="Cosa mostra lo schermo del controller" />
</Cards>


# Messaggi sullo schermo (/it-IT/controllers/troubleshooting/scherm)

Il controller ha uno <Term term="scherm">schermo tattile</Term> rotondo. Mostra in parole semplici cosa sta facendo il controller: un titolo, una riga di spiegazione sotto e un bordo colorato. *Non devi quindi più ricordare i colori: c'è scritto.* Qui sotto trovi ogni messaggio e cosa fare.

## Pronto all'uso [#klaar-voor-gebruik]

| Sullo schermo | Significato |
| ------------- | ----------- |
| **Scansiona QR** e **Scansiona il tuo tag**, con **Da pagare** e un importo | Il controller è pronto. L'ospite avvicina un tag allo schermo o scansiona il codice QR con il cellulare. |
| Codice QR grigio e barrato | Il controller non ha temporaneamente connessione con Tillor. Il pagamento con un tag continua a funzionare, il pagamento online tramite codice QR per un po' no. |

## Scansionare un tag [#een-tag-scannen]

Un tag <Term term="NFC">NFC</Term> si scansiona avvicinandolo brevemente allo schermo, come nei pagamenti contactless.

| Sullo schermo | Significato |
| ------------- | ----------- |
| **Un attimo di pazienza** - Pagamento in elaborazione | Il tag è stato letto, il controller chiede a Tillor se è consentito. Tieni il tag ancora un momento contro lo schermo. |
| **Pagamento riuscito!** con l'importo addebitato e il saldo | Pagato. La doccia o l'apparecchio si avvia. |
| **Benvenuto** con il nome dell'ospite | Accesso consentito, presso una porta o una struttura senza pagamento. |

Se un tag viene rifiutato, il motivo è scritto sullo schermo:

| Sullo schermo | Cosa succede | Cosa fai |
| ------------- | ------------ | -------- |
| **Tag non riconosciuto** - Questo tag non appartiene a qui | Il tag non è del tuo parco. | Dai all'ospite un tag del parco. |
| **Tag non riconosciuto** - Questo non è un tag valido | Il controller non riesce a leggere questo tipo di tag. | Usa un tag che hai ricevuto tramite Tillor. |
| **Scansione non riuscita** - Tag letto male | Il tag è stato tolto troppo in fretta. | Avvicina di nuovo il tag allo schermo, un po' più a lungo. |
| **Pagamento rifiutato** - Nessun accesso | Il tag non può usare questo controller. | Controlla in Tillor il gruppo di accesso del tag. |
| **Pagamento rifiutato** - Tag non collegato | Il tag non è ancora collegato a un cliente. | Collega il tag al cliente in Tillor. |
| **Pagamento rifiutato** - Saldo insufficiente | Sul tag c'è troppo poco. Il saldo è indicato. | Ricarica il tag alla reception. |
| **Server non raggiungibile** | Non è stato possibile elaborare il pagamento. | Riprova più tardi; vedi [Problemi di connessione](/controllers/troubleshooting/verbinding). |
| **Aggiornamento del tag non riuscito** | Non è stato possibile salvare il saldo sul tag. | Avvicina di nuovo il tag allo schermo e lascialo lì finché il messaggio non scompare. |

<Callout type="info" title="Una scansione per presentazione">
Lasciare il tag contro lo schermo non ha effetto: ogni presentazione conta come una scansione. Se vuoi scansionare di nuovo, allontana il tag e avvicinalo di nuovo allo schermo.
</Callout>

## Avvio e connessione [#opstarten-en-verbinden]

| Sullo schermo | Bordo | Significato | Cosa fai |
| ------------- | ----- | ----------- | -------- |
| **Connessione in corso...** | Blu | Il controller si avvia e cerca la connessione a internet e a Tillor. | Attendi 1-2 minuti. |
| **Configura Wi-Fi** - Scegli una rete Wi-Fi sullo schermo | Viola | Il controller non ha ancora una rete. | Tocca **Configura Wi-Fi** e scegli la tua rete; vedi [Configurare il Wi-Fi sullo schermo](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). |
| **Configura Wi-Fi** - Dati Wi-Fi rifiutati | Viola | La password non è (più) corretta. | Inserisci di nuovo la password sullo schermo. |
| **Attiva controller** - Attiva il dispositivo … in Tillor | Viola | Il controller attende l'<Term term="adoptie">adozione</Term>. | In Tillor vai su **Controller** e clicca su **Approva** (✓). |
| **Connessione persa** - nuovo tentativo | Rosso | La connessione internet è assente. Il controller riprova da solo. | Vedi [Problemi di connessione](/controllers/troubleshooting/verbinding#verbinding-verbroken). |
| **Connessione persa** - Offline da troppo tempo | Rosso | Il controller è senza connessione da troppo tempo. I pagamenti restano disattivati finché la connessione non torna. | Ripristina la connessione di rete. |

## Aggiornamenti e riavvii [#updates-en-herstarten]

| Sullo schermo | Bordo | Significato |
| ------------- | ----- | ----------- |
| **Aggiornamento in corso** con una percentuale | Ambra | Un aggiornamento del <Term term="firmware">firmware</Term> viene scaricato e installato. Lascia l'alimentazione accesa. |
| **Riavvio in corso** | Giallo | Il controller si riavvia, dopo un aggiornamento o perché hai cliccato su **Riavvia controller** in Tillor. |

## Guasti [#storingen]

| Sullo schermo | Significato | Cosa fai |
| ------------- | ----------- | -------- |
| **Lettore di tag non disponibile** | Il lettore di tag non si avvia. Il controller cerca di ripristinarlo da solo. | Attendi un minuto. Se il messaggio resta, [riavvia il controller](/controllers/controller-beheren#een-controller-herstarten). |
| **Nessuna connessione** - Connessione al controller | Lo schermo non riceve segnale dal resto del controller. | Riavvia il controller. Se resta così, contatta l'assistenza Tillor. |
| Lo schermo resta nero | Il controller non ha alimentazione. | Controlla l'alimentatore e il cablaggio. |

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Problemi di connessione" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, connessione a Tillor e adozione" />
  <Card title="Impostazioni controller" href="/controllers/settings" description="ACL, rete, aggiornamenti e relè" />
</Cards>


# Problemi di connessione (/it-IT/controllers/troubleshooting/verbinding)

Se il controller non si connette bene, il suo <Term term="scherm">schermo</Term> ti dice dove sta il problema. Qui sotto trovi, per ogni messaggio, cosa succede e cosa fare. Tutti i messaggi sono elencati in [Messaggi sullo schermo](/controllers/troubleshooting/scherm).

## Configurare il Wi-Fi sullo schermo [#wifi-instellen-op-het-scherm]

Se sullo schermo c'è **Configura Wi-Fi**, il controller non ha ancora una rete. Con un cavo di rete (Ethernet) non devi fare nulla; per il Wi-Fi imposti la rete direttamente sul controller:

1. Tocca **Configura Wi-Fi**
2. Scegli la tua rete nell'elenco. Accanto a ogni rete c'è l'intensità del segnale: verde è buono, arancione è medio, rosso è debole
3. Digita la password sulla tastiera dello schermo e conferma
4. Lo schermo mostra **Connesso**: il Wi-Fi è configurato

Se la tua rete non è nell'elenco, tocca per cercare di nuovo. Per cambiare la rete in seguito, tieni premuto a lungo il dito sullo schermo mentre il controller è pronto, oppure modificala nelle [impostazioni](/controllers/settings#internetconfiguratie) in Tillor.

| Messaggio | Soluzione |
| --------- | --------- |
| **Connessione non riuscita** - Controlla la password | Digita di nuovo la password, facendo attenzione alle maiuscole. |
| **Connessione non riuscita** - Rete non trovata | Avvicina il controller all'access point o scegli un'altra rete. |
| **Connessione non riuscita** - Ricerca delle reti non riuscita | Tocca per cercare di nuovo. Se resta così, riavvia il controller. |
| **Configura Wi-Fi** - Dati Wi-Fi rifiutati | La password salvata non è più corretta. Inseriscila di nuovo sullo schermo. |

## Attiva controller [#controller-activeren]

**Significato:** il controller attende l'<Term term="adoptie">adozione</Term>: non è ancora collegato a Tillor. *La scatolina è pronta, ma non sa ancora a quale organizzazione appartiene.* Sullo schermo c'è **Attiva controller** con il numero del dispositivo.

**Soluzione:**
1. In Tillor vai su **Controller**
2. Cerca la riga **In attesa di approvazione** con lo stesso numero (l'<Term term="eFuse ID">eFuse ID</Term>)
3. Clicca su **Approva** (✓) per collegare il controller alla tua organizzazione

## Connessione persa [#verbinding-verbroken]

**Significato:** la connessione a internet è assente. Il controller prova a riconnettersi da solo. *La scatolina ha perso il contatto con Tillor e cerca di riaverlo.*

Finché l'interruzione è breve, gli ospiti possono continuare a pagare con il tag; il codice QR è allora grigio e barrato. Se sullo schermo c'è **Offline da troppo tempo**, i pagamenti sono disattivati finché la connessione non torna.

In Tillor il controller risulta offline dopo circa 35 secondi senza contatto. Dopo 5 minuti il team Tillor riceve una segnalazione.

**Possibili cause:**
- **Il Wi-Fi è caduto**: controlla che la rete Wi-Fi sia raggiungibile
- **Guasto di internet**: il controller non riesce a raggiungere Tillor
- **Tillor è temporaneamente irraggiungibile**

**Soluzione:**
- Attendi qualche minuto: il controller prova a riconnettersi da solo
- Controlla se gli altri dispositivi sulla stessa rete hanno internet
- Controlla le [impostazioni Wi-Fi](/controllers/settings) del controller (nome della rete, password)
- Assicurati che il controller sia nel raggio dell'access point Wi-Fi, oppure usa un cavo di rete

## Lo schermo resta su Connessione in corso... [#scherm-blijft-op-verbinden]

**Significato:** il controller si sta ancora avviando o connettendo. Sotto il titolo c'è il passaggio in cui si trova, per esempio *Configurazione della connessione a internet* o *Ricerca di aggiornamenti*.

**Soluzione:**
- Attendi 1-2 minuti: all'avvio ci vuole un po'
- Se resta su *Configurazione della connessione a internet*: controlla il cavo di rete oppure [imposta di nuovo il Wi-Fi](#wifi-instellen-op-het-scherm)
- Controlla che il segnale Wi-Fi sia abbastanza forte

## Il controller non compare in Tillor [#controller-verschijnt-niet-in-tillor]

**Significato:** il controller non è ancora visibile per l'adozione.

**Possibili cause:**
- Il controller non ha una connessione a internet (non raggiunge Tillor)
- Il controller si sta ancora avviando
- Apri Tillor da una rete diversa da quella a cui è collegato il controller: in quel caso le richieste di adozione a volte non sono visibili

**Soluzione:**
1. Controlla che il controller sia alimentato e che lo schermo sia acceso
2. Guarda cosa mostra lo schermo: con **Configura Wi-Fi** o **Connessione in corso...** non è ancora online
3. Attendi che lo schermo mostri **Attiva controller** e che nell'elenco compaia la riga **In attesa di approvazione**: può volerci un po'
4. Apri Tillor dalla stessa rete del controller, oppure contatta l'assistenza
5. Aggiorna la pagina Controller in Tillor (le nuove richieste compaiono anche automaticamente)

## Adozione non riuscita o credenziali rifiutate [#adoptie-mislukt-of-credentials-worden-geweigerd]

L'<Term term="adoptie">adozione</Term> è il collegamento del controller alla tua organizzazione; le <Term term="credentials">credenziali</Term> sono i dati di connessione che ne fanno parte.

**Significato:** il collegamento con Tillor non è riuscito. *La scatolina non è stata collegata alla tua organizzazione.*

**Soluzione:**
- Controlla che l'orologio del controller sia corretto (un grande scarto di orario può bloccare il collegamento)
- Dopo un flash del firmware o una nuova chiave, il controller deve essere approvato di nuovo
- Riprova l'adozione con **Approva** (✓)
- Se il problema persiste, contatta l'assistenza: ha accesso ai log

## L'aggiornamento OTA si blocca o fallisce [#ota-update-blijft-hangen-of-faalt]

Un aggiornamento <Term term="OTA">OTA</Term> è un aggiornamento del <Term term="firmware">firmware</Term> via internet. Durante un aggiornamento lo schermo mostra **Aggiornamento in corso** con una percentuale.

**Significato:** l'aggiornamento del firmware non è stato completato. *La scatolina ha provato a installare un nuovo software, ma non è andata bene.*

**Soluzione:**
- Attendi che la [<Term term="updatevenster">finestra di aggiornamento</Term>](/controllers/updates) sia attiva: gli aggiornamenti avvengono solo in quella finestra
- Controlla che il controller abbia una connessione internet stabile
- Attiva temporaneamente [Salta aggiornamenti OTA](/controllers/updates#ota-updates-overslaan) se vuoi prima rendere stabile il controller

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Messaggi sullo schermo" href="/controllers/troubleshooting/scherm" description="Cosa significa il messaggio sullo schermo?" />
  <Card title="Impostazioni controller" href="/controllers/settings" description="Configurare Wi-Fi e rete" />
</Cards>


# Aggiornamenti firmware (/it-IT/controllers/updates)

Un controller scarica da solo il nuovo software via internet, come il tuo telefono. Quel software si chiama <Term term="firmware">firmware</Term>. Decidi tu **quando** e **con quale frequenza** può farlo. Di default controlla ogni giorno se c'è qualcosa di nuovo. Se vuoi avviare subito un aggiornamento, lo fai dalla pagina del controller, vedi [Gestire un controller](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie).

## Frequenza degli aggiornamenti [#updatefrequentie]

Il controller verifica periodicamente se è disponibile una nuova versione del firmware:

| Opzione | Significato |
| ------- | ----------- |
| **Ogni ora** | Controlla gli aggiornamenti ogni ora. |
| **Giornaliero** | Controlla una volta al giorno (predefinito). |
| **Settimanale** | Controlla una volta alla settimana. |

Dopo il controllo, un aggiornamento viene eseguito solo se c'è una versione più recente. Se hai impostato una finestra di aggiornamento, anche l'orario attuale deve rientrare in quella finestra. *In pratica: la scatolina controlla se c'è qualcosa di nuovo, ma lo installa solo negli orari che hai impostato.*

## Finestra di aggiornamento [#updatevenster]

La finestra di aggiornamento è la fascia oraria in cui il controller può aggiornarsi. Se hai compilato **Periodo aggiornamento da** e **Periodo aggiornamento a**, gli aggiornamenti vengono eseguiti solo in quegli orari. *In breve: scegli tu quando la scatolina può aggiornarsi, per esempio solo di notte.*

**Esempio:** se imposti **Periodo aggiornamento da** su 02:00 e **Periodo aggiornamento a** su 04:00, un aggiornamento avviene solo tra le 02:00 e le 04:00. Così eviti che il controller si riavvii in pieno giorno, nelle ore di punta.

### Impostare [#instellen]

1. Vai su <UIPath>Controller > Panoramica > [nome controller]</UIPath>
2. Scorri fino a **Configurazione aggiornamenti**
3. Scegli **Frequenza aggiornamenti** (Ogni ora, Giornaliero o Settimanale)
4. Compila **Periodo aggiornamento da** (ad es. 02:00)
5. Compila **Periodo aggiornamento a** (ad es. 04:00)
6. Clicca su **Salva**

## Saltare gli aggiornamenti OTA [#ota-updates-overslaan]

<Term term="OTA">OTA</Term> sta per Over-The-Air: aggiornamenti via internet. Se imposti **Salta aggiornamenti OTA** su **Sì**, il controller non installa più nuovo firmware. Il controller resta sulla versione attuale. *Ovvero: la scatolina non si aggiorna più da sola via OTA.*

**Quando usarlo?**

- Temporaneamente, se non vuoi modifiche durante un periodo di punta
- Per controller di test o demo che devono restare su una versione fissa

<Callout type="info" title="Consiglio">
Lascia **Salta aggiornamenti OTA** su **No** come impostazione normale. Gli aggiornamenti contengono spesso miglioramenti e correzioni di sicurezza.
</Callout>

## Cosa succede durante un aggiornamento? [#wat-gebeurt-er-tijdens-een-update]

1. Il controller rileva una nuova versione del <Term term="firmware">firmware</Term>
2. Il firmware viene scaricato
3. Lo schermo mostra **Aggiornamento in corso** con una percentuale: il controller si sta aggiornando
4. Il controller si riavvia automaticamente; lo schermo mostra **Riavvio in corso**
5. Dopo il riavvio la nuova versione è attiva

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Un aggiornamento parte solo se c'è una versione più recente e l'orario rientra nella tua finestra di aggiornamento.
- Durante l'aggiornamento e il riavvio lo schermo mostra **Aggiornamento in corso** e **Riavvio in corso**. Per questo conviene fissare la finestra di notte.
- Se imposti **Salta aggiornamenti OTA** su **Sì**, il controller resta sulla versione attuale finché non lo rimetti come prima.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il controller non si aggiorna">
Controlla che **Salta aggiornamenti OTA** sia su **No** e che l'orario rientri nella tua finestra di aggiornamento. Controlla anche la connessione internet del controller. Trovi di più in [L'aggiornamento OTA si blocca o fallisce](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt).
</Accordion>
<Accordion title="Lo schermo resta su Aggiornamento in corso">
Lascia l'alimentazione accesa e attendi qualche minuto. Se resta così, riavvia il controller e contatta l'assistenza.
</Accordion>
<Accordion title="Tillor dice: Aggiornamento OTA non riuscito">
Non è stato possibile avviare l'aggiornamento. Controlla che il controller sia online e riprova.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni controller" href="/controllers/settings" description="Panoramica di tutte le impostazioni" />
  <Card title="Messaggi sullo schermo" href="/controllers/troubleshooting/scherm" description="Aggiornamento in corso e Riavvio in corso" />
</Cards>


# Configurare le reti Wi-Fi (/it-IT/controllers/wifi-netwerken)

Un controller può conoscere più reti Wi-Fi e passa da solo a quella migliore. È utile se il tuo parco ha un access point in punti diversi. Le imposti nella pagina del controller. Se il controller è ancora senza rete, è meglio configurare il Wi-Fi direttamente sullo schermo, vedi [Configurare il Wi-Fi sullo schermo](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).

Prima di iniziare:

- Il controller è approvato, vedi [Collegare un controller](/controllers/controller-koppelen).
- Conosci, per ogni rete, il nome (SSID) e la password. Una rete aperta non ha password.

## Aggiungere le reti [#netwerken-toevoegen]

<Steps>
<Step>
### Apri il controller [#open-de-controller]
Vai su <UIPath>Controller > Panoramica</UIPath> e clicca sul controller. Scorri fino a **Reti Wi-Fi**.
</Step>
<Step>
### Aggiungi una rete [#voeg-een-netwerk-toe]
Clicca su **Aggiungi rete** e compila **Nome della rete (SSID)** e **Password**. Lascia vuota la password per una rete aperta. Ripeti per ogni rete.
</Step>
<Step>
### Mettile in ordine [#zet-ze-in-volgorde]
Trascina una riga dalla maniglia a sinistra. L'ordine è la priorità: il controller prova le reti che ha nel raggio dall'alto verso il basso.

<DocScreenshot src="/screenshots/controllers/controller-wifi-networks.png" alt="Reti Wi-Fi con due reti in ordine di priorità" />
</Step>
<Step>
### Clicca su Salva [#klik-op-opslaan]
Il pulsante **Salva** si trova in fondo al modulo. Tillor poi invia l'elenco al controller.
</Step>
</Steps>

Una rete si toglie con il pulsante meno (**Rimuovi rete**).

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il controller controlla ogni rete separatamente. Se la prima rete cade o la password non è corretta, usa la successiva.
- Nella pagina di dettaglio, sotto **Reti Wi-Fi conosciute, per priorità**, vedi come va ogni rete:

| Stato | Significato |
|---|---|
| <Status tone="success">Connessa</Status> | Il controller usa questa rete in questo momento. |
| <Status>Verificata</Status> | La rete funziona, ma il controller ora usa un'altra rete. |
| <Status tone="info">Non ancora verificata</Status> | Il controller non ha ancora potuto provare questa rete. |
| <Status tone="warning">Non riuscita</Status> | La rete non funziona. Accanto c'è il motivo, per esempio password errata, rete non trovata o nessun accesso a internet. |

- Per ogni rete è indicato se è **nel raggio** o **fuori portata**, a volte con l'intensità del segnale in dBm. Le reti inserite sullo schermo hanno l'indicazione **aggiunta sul display**.
- Se l'elenco è vuoto, in Tillor non è impostata nessuna rete. Le reti che qualcuno ha aggiunto sullo schermo restano memorizzate sul controller.
- I controller più vecchi che conoscono una sola rete mostrano invece un unico avviso sull'ultima modifica, come **Modifica Wi-Fi non ancora confermata** o **Credenziali Wi-Fi rifiutate**. Il controller resta allora connesso alla rete precedente.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Aggiungi rete è grigio">
Un controller memorizza al massimo 8 reti. Tillor lo dice con **Un controller memorizza fino a 8 reti.** Rimuovi prima una rete che non ti serve più.
</Accordion>
<Accordion title="Tillor dice: Inserisci un nome di rete">
Una riga non ha il nome della rete. Compila il nome oppure rimuovi la riga.
</Accordion>
<Accordion title="Tillor dice: Questa rete è già nell'elenco">
Ogni nome di rete può comparire una sola volta. Rimuovi la riga doppia.
</Accordion>
<Accordion title="Una rete risulta Non riuscita">
Leggi il motivo accanto alla rete. Controlla il nome e la password. Il controller riprova da solo e le altre reti continuano a funzionare.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Problemi di connessione" href="/controllers/troubleshooting/verbinding" description="Wi-Fi e connessione a Tillor" />
  <Card title="Impostazioni controller" href="/controllers/settings" description="Preferenza di rete e altre impostazioni" />
</Cards>


# Manuale di Tillor (/it-IT)

<HomeHero title="Come si fa in Tillor?">
  Istruzioni per compito, per la reception, l'amministrazione e il servizio tecnico. Cerca ciò che vuoi fare, oppure parti dal tuo ruolo.
</HomeHero>

<HomeSection title="Di cosa ti occupi?" description="Per ogni ruolo, i compiti più frequenti.">

<RoleCard title="Reception" description="Accogliere gli ospiti, fare il check-in e rispondere alle domande." href="/reserveringen" icon={<ConciergeBellIcon />}>

- [Cercare o creare un cliente](/klantenbeheer)
- [Creare una prenotazione](/reserveringen)
- [Far fare il check-in a un ospite con una presenza](/bezettingen#een-bezetting-aanmaken)
- [Rispondere ai messaggi nella inbox](/inbox)

</RoleCard>

<RoleCard title="Amministrazione" description="Fatture, pagamenti e il collegamento con la tua contabilità." href="/facturen" icon={<LandmarkIcon />}>

- [Creare e registrare una fattura](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken)
- [Registrare un pagamento](/facturen/betalingen-registreren)
- [Prolungare una presenza tramite fattura](/bezettingen#facturatie-bezetting-verlengen)
- [Report dei pagamenti verso la tua contabilità](/boekhouden/betalingsrapporten)

</RoleCard>

<RoleCard title="Servizio tecnico" description="Sbarre, contatori, controller e tablet nel parco." href="/controllers" icon={<CpuIcon />}>

- [Aprire o chiudere un punto di accesso](/toegangscontrole#toegangspunten-bedienen)
- [Collegare un contatore a una piazzola](/meterbeheer/meter-koppelen)
- [Cosa significa il messaggio sullo schermo?](/controllers/troubleshooting/scherm)
- [Configurare un chiosco](/mobiele-app/kiosk-inrichten)

</RoleCard>

<RoleCard title="Sviluppatori" description="Collega Tillor ai tuoi sistemi o al tuo sito web." href="/ontwikkelaars" icon={<BracesIcon />}>

- [Creare una chiave API](/ontwikkelaars/http)
- [Ricevere webhook](/ontwikkelaars/webhooks)
- [Eventi in tempo reale via SSE](/ontwikkelaars/sse)
- [Collegare strumenti di IA con MCP](/ontwikkelaars/mcp)

</RoleCard>

</HomeSection>

<HomeSection title="Altro">

<HomeLink title="Nuovo su Tillor?" description="Accedere, orientarsi e configurare il tuo parco." href="/aan-de-slag" icon={<RocketIcon />} />

<HomeLink title="Nella pratica" description="Quattro esempi completi che combinano più moduli." href="/praktijk" icon={<RouteIcon />} />

<HomeLink title="Glossario" description="Le parole che incontri in Tillor, spiegate in breve." href="/begrippen" icon={<RocketIcon />} />

<HomeLink title="Novità" description="Le modifiche recenti di Tillor, mese per mese." href="/wat-is-nieuw" icon={<SparklesIcon />} />

<HomeLink title="Tablet e chioschi" description="L'app Tillor su tablet alla reception o all'aperto." href="/mobiele-app" icon={<TabletSmartphoneIcon />} />

<HomeLink title="Stato del sistema" description="Funziona tutto? Guarda guasti e manutenzione." href="https://status.tillor.eu" icon={<ActivityIcon />} />

</HomeSection>


# Inviare un comando a un tablet (/it-IT/mobiele-app/acties-op-afstand)

A destra nella pagina del dispositivo c'è il pannello **Azioni da remoto**, qualunque scheda tu abbia aperto. Da lì invii un comando al dispositivo e richiedi una schermata. Ciò che il dispositivo comunica da solo lo leggi in [Diagnostica e cronologia](/mobiele-app/diagnose-en-geschiedenis).

<Requires permission="Modifica impostazioni" />

Prima di iniziare:

- Il dispositivo deve essere connesso. Un comando passa dalla connessione live con l'app. Se il dispositivo è offline, il pannello dice **Il dispositivo è offline: i comandi arrivano solo quando sarà di nuovo connesso.** Tillor segnala comunque che il comando è stato inviato, ma il tablet non lo vede.
- **Riavvia il dispositivo** funziona solo se Tillor è il proprietario del tablet. Vedi [Configurare un chiosco](/mobiele-app/kiosk-inrichten).

## Inviare un comando [#een-opdracht-versturen]

<Steps>
<Step>
### Apri il dispositivo [#open-het-toestel]
Vai su <UIPath>Impostazioni > Tablet e chioschi</UIPath> e clicca sulla riga del dispositivo.
</Step>
<Step>
### Scegli il comando [#kies-de-opdracht]
Nel pannello **Azioni da remoto** clicca sul comando. Compare il messaggio **Inviato al dispositivo**, oppure **Impossibile raggiungere il dispositivo** se non è partito.

<DocScreenshot src="/screenshots/tablets/remote-actions.png" alt="Azioni da remoto e il riquadro Schermata" />
</Step>
</Steps>

I comandi:

- **Mostra il nome sullo schermo** mostra per un momento il nome del dispositivo a caratteri grandi. Utile quando ci sono due tablet affiancati e vuoi sapere quale hai aperto.
- **Riproduci suono di prova** riproduce il suono di notifica, al volume della scheda **Scontrini e suono**.
- **Riattiva schermo** porta il dispositivo fuori dal riposo notturno o da **Metti lo schermo in standby**.
- **Metti lo schermo in standby** rende lo schermo nero, anche fuori dal riposo notturno.
- **Dormi per 30 secondi** fa lo stesso e poi riattiva lo schermo da solo. Così verifichi che lo schermo si riaccenda, senza aspettare fino al mattino.
- **Riavvia il dispositivo** riavvia il tablet. Su un tablet di cui Tillor non è proprietario, il pulsante resta grigio.
- **Installa aggiornamento** installa un aggiornamento dell'app già pronto.
- **Riavvia l'app** riavvia solo l'app Tillor, non il tablet.

## Richiedere una schermata [#een-schermafbeelding-opvragen]

<Steps>
<Step>
### Clicca su Richiedi schermata [#klik-op-schermafbeelding-opvragen]
Nel riquadro **Schermata** questo invia la richiesta al tablet.
</Step>
<Step>
### Attendi l'immagine [#wacht-op-het-beeld]
Tillor attende un breve momento e aggiorna l'immagine non appena il tablet l'ha caricata. Sotto la foto c'è l'orario in cui è stata acquisita.
</Step>
</Steps>

L'immagine è ciò che l'app mostra in quel momento: schermata iniziale, presentazione, scontrino o schermata di riposo. Non è un video in diretta.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il tablet esegue subito il comando. Ogni comando, tranne quelli di riposo, riattiva anche lo schermo.
- Ogni comando finisce nella [cronologia del dispositivo](/mobiele-app/diagnose-en-geschiedenis#geschiedenis).
- Una schermata resta nel pannello finché non ne richiedi una nuova.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Tillor dice Impossibile raggiungere il dispositivo">
Il comando non è arrivato al dispositivo. Di solito è offline. Attendi che lo stato torni **Connesso** e invialo di nuovo.
</Accordion>
<Accordion title="Il pulsante Riavvia il dispositivo è grigio">
Tillor non è proprietario del tablet. Configuralo prima come descritto in [Configurare un chiosco](/mobiele-app/kiosk-inrichten). Fino ad allora puoi usare solo **Riavvia l'app**.
</Accordion>
<Accordion title="Non arriva nessuna schermata">
Il dispositivo è offline oppure l'app è troppo vecchia. In quest'ultimo caso Tillor lo dice in anticipo: **L'app su questo dispositivo è troppo vecchia per gli screenshot.** Installa una versione più recente. Finché non hai mai richiesto un'immagine, c'è scritto **Nessuna schermata richiesta finora.**
</Accordion>
<Accordion title="Lo schermo resta nero dopo Riattiva schermo">
La riattivazione da remoto riesce solo se l'app è anche nell'eccezione per la batteria. Vedi [Batteria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Diagnostica e cronologia" href="/mobiele-app/diagnose-en-geschiedenis" description="Ciò che il dispositivo comunica da solo" />
  <Card title="Gestire un tablet o un chiosco" href="/mobiele-app/tablets-en-kiosken" description="Inviare le impostazioni" />
</Cards>


# Diagnostica e cronologia (/it-IT/mobiele-app/diagnose-en-geschiedenis)

Sotto il pannello **Azioni da remoto** ci sono due riquadri che ti aiutano a controllare un tablet: **Diagnostica** (ciò che il dispositivo ha comunicato l'ultima volta) e **Cronologia** (il registro). Puoi inviare un comando dallo stesso pannello, vedi [Inviare un comando a un tablet](/mobiele-app/acties-op-afstand).

<DocScreenshot src="/screenshots/tablets/diagnostics.png" alt="Diagnostica e cronologia nella pagina del dispositivo" />

## Diagnostica [#diagnose]

**Diagnostica** è l'ultimo messaggio del dispositivo, non una misurazione in tempo reale. Un trattino significa che l'app non ha inviato quel dato.

| Dato | Significato |
|---|---|
| **Ultimo contatto** | Quando il dispositivo ha avuto contatto per l'ultima volta |
| **Connessione** | Wi-Fi o rete mobile |
| **Schermo** | **Acceso** o **In standby** |
| **Spazio libero** | Spazio libero sul tablet, in GB |
| **Lingua del dispositivo** e **Fuso orario** | La lingua e il fuso orario di Android o iOS. Non è la lingua che hai scelto per l'app nella scheda **Dispositivo** |
| **Build**, **Versione del runtime** | Quale versione dell'app è sul tablet |
| **Ultimo aggiornamento dell'app** e **Ultimo controllo aggiornamenti** | Quando l'app è stata aggiornata o controllata per l'ultima volta |
| **Errore di aggiornamento** | Compare se l'ultimo controllo o l'ultima installazione non è riuscita |
| **Registrato** | Quando questo dispositivo è comparso per la prima volta nell'elenco |

## Cronologia [#geschiedenis]

**Cronologia** mostra, per ogni dispositivo:

- quando il dispositivo si è collegato
- quando hai inviato impostazioni o un comando
- quando l'app è stata aggiornata
- quando il dispositivo è andato offline e quando è tornato online

Il registro si aggiorna da solo. **Ancora nessun evento.** significa che non è stato ancora registrato nulla.

## Notifiche [#meldingen]

Un avviso di offline o di batteria arriva solo se **Avvisi** è attivo nella scheda **Dispositivo**, e non durante il riposo notturno.

- Avviso di offline: il dispositivo non ha comunicato nulla per 10 minuti.
- Avviso di batteria: sotto il 15% senza caricabatterie. Tillor non lo invia di nuovo finché il dispositivo non è stato di nuovo collegato al caricabatterie o si è caricato in modo evidente.

L'avviso va alle persone che gestiscono le impostazioni. Vedi [Notifiche](/notificaties).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Inviare un comando a un tablet" href="/mobiele-app/acties-op-afstand" description="Riattivare, riavviare e una schermata" />
  <Card title="Impostazioni del dispositivo" href="/mobiele-app/toestelinstellingen" description="La scheda Dispositivo con Avvisi" />
</Cards>


# Panoramica (/it-IT/mobiele-app)

L'app Tillor gira su un tablet, un chiosco o un telefono nel tuo parco, per **iOS** e **Android**. Ospiti e colleghi vi vedono la schermata iniziale, gli scontrini e le richieste di firma. Da Tillor nel tuo browser invii impostazioni e comandi a quei dispositivi. Un tablet che deve restare fisso come chiosco lo configuri con [Configurare un chiosco](/mobiele-app/kiosk-inrichten).

<Callout type="warn" title="Non è una web app completa">
L'app non sostituisce Tillor nel browser. Gestire prenotazioni, creare fatture o registrare pagamenti si fa nel browser.
</Callout>

## Come funziona il tutto? [#hoe-hangt-dit-samen]

Un dispositivo compare da solo in Tillor non appena qualcuno apre l'app e accede. Ciò che imposti poi in Tillor arriva al dispositivo tramite la connessione live. Al contrario, il dispositivo si segnala regolarmente a Tillor, così vedi se è ancora connesso.

```mermaid
flowchart LR
  A[Qualcuno apre l'app<br/>e accede] --> B[Il dispositivo è in<br/>Impostazioni > Tablet e chioschi]
  B --> C[Tu scegli le impostazioni<br/>e clicchi Salva e invia]
  C --> D[Il tablet le applica]
  E[Tu invii uno scontrino,<br/>un PDF o una richiesta di firma] --> D
  D --> F[Il dispositivo comunica batteria,<br/>connessione e versione]
  F --> B
```

Se un dispositivo è offline, impostazioni e comandi arrivano solo quando torna connesso. Vedi [Tablet e chioschi](/mobiele-app/tablets-en-kiosken).

<Callout type="info" title="Da sapere">
- Un nuovo dispositivo compare nell'elenco entro un minuto da quando qualcuno ha effettuato l'accesso.
- Tillor segnala un dispositivo come offline dopo 10 minuti senza messaggi. Succede solo se **Avvisi** è attivo e non durante il riposo notturno.
- L'avviso di batteria arriva sotto il 15% senza caricabatterie.
- Una presentazione ha al massimo 20 foto. Puoi mettere sei pulsanti aggiuntivi nella schermata iniziale.
- Non esiste una password separata per l'app. Accedi come nel browser, con Microsoft, Google o Apple.
</Callout>

## Installare l'app e accedere [#de-app-installeren-en-inloggen]

La tua organizzazione condivide il file di installazione o il link (build interna, TestFlight o app store, a seconda della vostra distribuzione). Se non hai ancora accesso, chiedilo al tuo amministratore o all'assistenza Tillor.

1. Apri l'app dopo l'installazione.
2. Accedi con **Microsoft**, **Google** o **Apple**. È lo stesso account del browser, vedi [Accedere](/inloggen).
3. Scegli la tua organizzazione se ne hai più di una.

## Cosa sa fare l'app [#wat-de-app-kan]

- **Mostrare PDF e immagini**: direttamente nella schermata iniziale non appena Tillor invia un documento al dispositivo.
- **Scansionare carte prepagate**: leggere una carta NFC e vedere i dati della carta e del cliente.
- **Far sentire i pagamenti**: un segnale acustico quando una fattura viene pagata.
- **Chiosco**: tenere lo schermo acceso, regolare la luminosità e mostrare il logo della tua organizzazione.

## Cosa vede Tillor del dispositivo [#wat-tillor-van-het-toestel-ziet]

L'app invia regolarmente a Tillor il nome, il modello, il sistema operativo, la versione dell'app, la batteria e la connessione di rete (Wi-Fi o mobile). Lo vedi nell'elenco dei dispositivi e nella pagina del dispositivo. In **Account** > **Sessioni attive** trovi gli stessi dispositivi come sessioni dell'app, con **Metadati app**. Lì puoi anche terminare una sessione.

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'app non si connette">
Controlla il Wi-Fi o la rete mobile, e che tu abbia effettuato l'accesso all'organizzazione giusta. Aggiorna l'app all'ultima versione. Se non basta, esci e accedi di nuovo. Se continua a non funzionare, contatta il tuo amministratore.
</Accordion>
<Accordion title="Il dispositivo non è nell'elenco">
Apri l'app, accedi e scegli l'organizzazione giusta. Il dispositivo compare entro un minuto in **Impostazioni** > **Tablet e chioschi**. Se lì vedi **Ancora nessun dispositivo**, significa che nessun dispositivo si è ancora collegato.
</Accordion>
</Accordions>

## Concetti [#begrippen]

- **Tablet**: un tablet con l'app Tillor, per esempio alla reception.
- **Chiosco**: un tablet bloccato sull'app Tillor, così gli ospiti non possono uscirne.
- **Dispositivo**: ogni installazione dell'app che compare in Tillor, di qualunque tipo.
- **Riposo notturno**: le ore in cui lo schermo è spento o nero.
- **Blocco schermo**: una sequenza o un PIN sul tablet stesso, diverso dal blocco del chiosco.

Altre spiegazioni sono nel [glossario](/begrippen).

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Tablet e chioschi" href="/mobiele-app/tablets-en-kiosken" description="Dispositivi nell'elenco, salvare e inviare le impostazioni" />
  <Card title="Configurare un chiosco" href="/mobiele-app/kiosk-inrichten" description="Bloccare un tablet Android" />
  <Card title="Impostazioni del dispositivo" href="/mobiele-app/toestelinstellingen" description="Tutte le impostazioni per scheda" />
  <Card title="Azioni da remoto" href="/mobiele-app/acties-op-afstand" description="Riattivare, riavviare e una schermata" />
  <Card title="Accedere" href="/inloggen" description="Accesso all'account tramite Microsoft, Google o Apple" />
  <Card title="Controller" href="/controllers" description="Hardware nel tuo parco" />
</Cards>


# Configurare un chiosco (/it-IT/mobiele-app/kiosk-inrichten)

Con un chiosco blocchi un tablet Android sull'app Tillor. Gli ospiti vedono la schermata iniziale, una presentazione o uno scontrino, e non arrivano alle impostazioni di Android. Dopo un'interruzione di corrente il tablet riparte in Tillor. Questa pagina percorre la configurazione una tantum. Gli interruttori che imposti dopo si trovano in [Impostazioni del dispositivo](/mobiele-app/toestelinstellingen#kiosk).

Senza i passaggi qui sotto puoi comunque attivare **Blocca l'app**, ma Android usa allora solo il blocco dello schermo. Chiede una conferma sul tablet e un ospite può uscirne. Lo stato nella scheda **Chiosco** dice allora **Blocco schermo. Questo tablet non è un chiosco configurato.**

Il blocco completo vale solo se Tillor è il proprietario del dispositivo. Nella scheda **Chiosco** lo leggi come **Chiosco configurato: il blocco è completo.**

<Callout type="warn">
Questo funziona su Android. Su iOS puoi usare l'app come chiosco per scontrini e schermata iniziale, ma non impostarla come proprietaria del dispositivo. I pulsanti sotto **Gestione Android** restano allora disattivati, con il messaggio **Disponibile quando questo tablet è configurato come chiosco.**
</Callout>

## Prima di iniziare [#voor-je-begint]

Ti serve un computer con `adb`. È un programma gratuito di Google con cui controlli un tablet Android tramite un cavo USB. È un lavoro una tantum per ogni tablet, pensato per chi ha un po' di competenze tecniche. Se non riesci, chiedi all'assistenza Tillor.

Prima di iniziare:

- Riporta il tablet alle impostazioni di fabbrica, oppure usa un tablet su cui non c'è ancora un account Google aggiuntivo. Android rifiuta un'app come proprietaria se sul dispositivo c'è già un account.
- L'app Tillor deve essere installata e con l'accesso effettuato alla tua organizzazione.
- Nelle impostazioni di Android attiva **Debug USB** (Opzioni sviluppatore).
- Collega il tablet al computer con un cavo. `adb devices` deve mostrare il tablet come `device`, non come `unauthorized`.

## Tillor come proprietario del tablet [#tillor-als-eigenaar-van-de-tablet]

Il proprietario di un dispositivo Android può fare cose che un'app normale non può, come bloccare davvero il tablet. Dai a Tillor quel ruolo con questo comando sul computer:

```bash
adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver
```

Se il comando riesce, Android risponde che il proprietario è stato impostato. Se fallisce con un messaggio sugli account, elimina gli account o ricomincia da un ripristino di fabbrica. Questo comando si può impostare una sola volta. Un altro proprietario richiede di nuovo un ripristino.

Poi, in Tillor, apri **Impostazioni** > **Tablet e chioschi**, imposta il tipo su **Chiosco** e salva. Nella scheda **Chiosco** il riquadro **Dispositivo chiosco** dovrebbe ora essere verde. Gli altri due riquadri seguono non appena hai inviato **App come schermata Home** e **Rimuovi il blocco schermo**. La spiegazione di quei riquadri è in [Chiosco](/mobiele-app/toestelinstellingen#kiosk).

## Batteria: non far addormentare l'app [#batterij-de-app-niet-laten-inslapen]

Android, e soprattutto Xiaomi con HyperOS, interrompe la connessione di un'app che secondo il sistema "dorme". Il chiosco va allora offline in piena notte, anche se lo schermo dovrebbe essere spento per il riposo notturno.

Se Tillor è il proprietario, l'app chiede da sola di disattivare l'ottimizzazione della batteria. Sulla maggior parte dei tablet è una finestra in cui tocchi **Consenti**. Su Xiaomi, HyperOS apre invece la pagina della batteria di Tillor: scegli lì **Nessuna restrizione**. Se la salti, l'app lo chiede di nuovo dopo il riavvio successivo, e la connessione di notte resta inaffidabile.

Nessuna app può impostare da sola questa eccezione, nemmeno come proprietaria del dispositivo. Resta quindi un tocco per tablet, oppure il comando qui sotto.

Se quella finestra non compare, imposta l'eccezione durante la configurazione dal computer:

```bash
adb shell dumpsys deviceidle whitelist +eu.tillor.app
```

Dopo, l'app dovrebbe continuare a comunicare con Tillor in background, anche a schermo spento.

## Togliere il blocco schermo [#schermvergrendeling-weghalen]

Una sequenza o un PIN sul tablet significa che Android, dopo ogni riavvio, attende nella schermata di blocco. Il chiosco resta nero finché non passa qualcuno. Il riquadro **Blocco schermo** avvisa: **È impostata una sequenza o un PIN.**

1. Apri la scheda **Chiosco**.
2. Sotto **Gestione Android** imposta **Rimuovi il blocco schermo** su **Attivo**.
3. Scegli **Salva e invia**.

Il tablet non lo chiede da sé. Il blocco scompare la prossima volta che qualcuno inserisce la sequenza o il PIN, per esempio dopo un riavvio. Dopo, un riavvio termina in Tillor.

Se non vuoi aspettare, rimuovi tu la sequenza nelle impostazioni di Android del tablet. Il riquadro diventa **Nessuna sequenza o PIN: un riavvio termina in Tillor.**

<Callout type="info" title="Xiaomi: pulsanti di navigazione">
Finché Tillor è la schermata Home, HyperOS passa la navigazione dai gesti ai pulsanti. Tillor nasconde quella barra finché qualcuno non tocca tre volte la schermata iniziale. Se scegli **Sblocca temporaneamente** nell'app, torni alla schermata Home di Xiaomi. Se lì vuoi di nuovo i gesti, impostali nelle impostazioni di Android.
</Callout>

## Cosa attivare dopo [#wat-je-daarna-aanzet]

Per un tablet in un alloggiamento alla reception o all'ingresso, questo è un insieme utile. Tutto si trova nella scheda **Chiosco**, salvo diversa indicazione.

| Impostazione | Valore | Perché |
| --- | --- | --- |
| **App come schermata Home** | Attivo | Il pulsante Home apre Tillor. Orologio e batteria restano visibili. |
| **Blocca l'app** | Attivo | Gli ospiti non possono uscire dall'app. |
| **Nascondi l'interfaccia di sistema** | Attivo | Niente notifiche, niente app recenti, niente menu di accensione. |
| **Proteggi il dispositivo** | Attivo | Niente ripristino di fabbrica, niente modalità provvisoria, niente trasferimento USB, niente disinstallazione. |
| **Resta acceso in carica** | Attivo | Lo schermo resta acceso negli orari di apertura finché il caricabatterie è collegato. Il riposo notturno ha la precedenza. |
| **Ora automatica** | Attivo | Il riposo notturno segue l'orologio dell'organizzazione, non un orologio sballato del tablet. |
| **Orientamento dello schermo** | Verticale o orizzontale | In **Schermo e riposo**, in base all'alloggiamento. **Predefinito** è la rotazione automatica. |

**Blocca il volume** mantiene il volume della scheda **Scontrini e suono**, così un ospite non può usare i pulsanti sul lato.

Salva e controlla i tre riquadri in cima a **Chiosco**. Verde significa che il tablet lo comunica così. Un avviso significa che quel passaggio non è ancora riuscito.

## Una nuova versione dell'app via USB [#een-nieuwe-app-versie-over-usb]

**Proteggi il dispositivo** disattiva il debug USB e il trasferimento di file. **Blocca l'app** tiene il tablet nell'app, per cui una finestra di installazione non si può confermare.

Prima di installare una build via cavo:

1. Imposta **Blocca l'app** su **Disattivo**.
2. Imposta **Proteggi il dispositivo** su **Disattivo**.
3. Scegli **Salva e invia** e attendi che il tablet rilasci il blocco.
4. Installa la nuova versione. Su Xiaomi, HyperOS chiede sul tablet di confermare l'installazione via USB: tocca **Installa**.
5. Rimetti entrambe le impostazioni su **Attivo** e salva di nuovo.

Se lasci attivo **Proteggi il dispositivo**, `adb` non vede più il tablet. L'eccezione per la batteria e la proprietà restano con un normale aggiornamento. Con un ripristino di fabbrica no: allora ricominci dal comando `dpm`.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Dopo un riavvio o un'interruzione di corrente il tablet riparte in Tillor, nella schermata iniziale.
- Gli ospiti non possono uscire dall'app e non vedono notifiche né app recenti.
- I tre riquadri in cima alla scheda **Chiosco** mostrano ciò che il tablet comunica da solo. Dopo una modifica può volerci un po' prima che i riquadri diventino verdi, perché il tablet si segnala ogni 30-60 secondi.
- Un normale aggiornamento dell'app mantiene la proprietà e l'eccezione per la batteria. Un ripristino di fabbrica no.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il comando dice che ci sono già account sul dispositivo">
Android rifiuta un proprietario se sul tablet c'è un account. Elimina gli account o ricomincia da un ripristino di fabbrica.
</Accordion>
<Accordion title="adb devices mostra unauthorized, o niente">
Conferma sul tablet la finestra che chiede l'autorizzazione per il computer, e controlla che **Debug USB** sia attivo. Se **Proteggi il dispositivo** è attivo, `adb` non vede più il tablet: disattivalo come per l'aggiornamento USB qui sopra.
</Accordion>
<Accordion title="La scheda Chiosco dice Blocco schermo. Questo tablet non è un chiosco configurato.">
Tillor non è ancora proprietario del tablet, quindi Android usa solo il blocco dello schermo. Esegui il comando del proprietario e poi scegli **Salva e invia**.
</Accordion>
<Accordion title="I pulsanti sotto Gestione Android sono disattivati">
Accanto c'è il messaggio **Disponibile quando questo tablet è configurato come chiosco.** Configura il tablet come sopra, oppure usa un tablet Android: su iOS non è possibile.
</Accordion>
<Accordion title="Il chiosco è nero dopo un riavvio">
Sul tablet c'è una sequenza o un PIN. Attiva **Rimuovi il blocco schermo** e inserisci una volta la sequenza o il PIN, oppure rimuovi il blocco nelle impostazioni di Android.
</Accordion>
<Accordion title="Il chiosco va offline di notte">
Android ha fatto addormentare l'app. Disattiva l'ottimizzazione della batteria per Tillor, come nel paragrafo Batteria qui sopra.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni del dispositivo" href="/mobiele-app/toestelinstellingen#kiosk" description="Gli interruttori nella scheda Chiosco" />
  <Card title="Impostare il riposo notturno dello schermo" href="/mobiele-app/nachtrust-instellen" description="Lo schermo spento di notte" />
  <Card title="Gestire un tablet o un chiosco" href="/mobiele-app/tablets-en-kiosken" description="Inviare le impostazioni" />
</Cards>


# Impostare il riposo notturno dello schermo (/it-IT/mobiele-app/nachtrust-instellen)

Un tablet acceso tutta la notte consuma corrente e può bruciare lo schermo. Con il riposo notturno, lo schermo si spegne o diventa nero nelle ore in cui il parco è chiuso. Le altre opzioni dello schermo, come l'attenuazione, sono in [Impostazioni del dispositivo](/mobiele-app/toestelinstellingen#scherm-en-slaap).

<Requires permission="Modifica impostazioni" />

Prima di iniziare:

- Se vuoi che lo schermo si spenga davvero e possa essere riattivato da remoto, configura prima il tablet come chiosco e metti l'app nell'eccezione per la batteria. Vedi [Configurare un chiosco](/mobiele-app/kiosk-inrichten).
- Se scegli gli orari di apertura della tua organizzazione, compilali prima. Vedi [Organizzazione](/gebruikers/organisaties#openingsuren).

## Impostare il riposo notturno [#de-nachtrust-instellen]

<Steps>
<Step>
### Apri la scheda Schermo e riposo [#open-het-tabblad-scherm-en-slaap]
Apri il dispositivo da <UIPath>Impostazioni > Tablet e chioschi</UIPath> e clicca sul riquadro **Schermo e riposo**. Cerca il gruppo **Riposo notturno**.
</Step>
<Step>
### Scegli la Modalità notte [#kies-de-nachtstand]
<Tabs items={["Orario fisso", "Quando l'organizzazione è chiusa"]}>
<Tab value="Orario fisso">
Scegli **Orario fisso** e compila **Dalle** e **Alle**. Va bene anche un orario che supera la mezzanotte, come dalle 22:00 alle 07:00.
</Tab>
<Tab value="Quando l'organizzazione è chiusa">
Lo schermo segue gli orari di apertura della tua organizzazione. Li modifichi in un unico punto, e tutti i dispositivi li seguono.
</Tab>
</Tabs>
Con **Disattivata** Tillor non pianifica alcun riposo.
</Step>
<Step>
### Scegli lo Stile di sonno [#kies-de-slaapstijl]
**Velo nero** mette un velo nero sull'immagine, e un tocco lo riattiva subito. **Schermo spento** spegne davvero il pannello.
</Step>
<Step>
### Clicca su Salva e invia [#klik-op-opslaan-en-versturen]
In alto a destra nel gruppo c'è scritto quando cade il prossimo riposo.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Scheda Schermo e riposo, riposo notturno dalle 22:00 alle 07:00" />

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Durante il riposo notturno lo schermo si spegne o diventa nero, anche se **Mantieni lo schermo acceso** è attivo. Il riposo notturno ha la precedenza.
- Toccare lo schermo lo riattiva per un momento.
- Alla fine dell'orario lo schermo torna normale.
- Durante il riposo notturno Tillor non invia avvisi che il dispositivo è offline.
- Se vuoi riattivare lo schermo o metterlo in standby fuori dall'orario, usa [Azioni da remoto](/mobiele-app/acties-op-afstand).

## Problemi? [#problemen]

<Accordions>
<Accordion title="Di notte lo schermo non si riattiva con Riattiva schermo">
**Schermo spento** funziona completamente su un tablet configurato come chiosco. La riattivazione da remoto riesce solo se l'app è anche nell'eccezione per la batteria. Vedi [Batteria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
<Accordion title="Il tablet si spegne troppo presto o troppo tardi">
Un orologio sballato sul tablet sposta l'orario. Nella scheda **Chiosco** attiva **Ora automatica**, così il tablet segue l'orologio dell'organizzazione.
</Accordion>
<Accordion title="Il tablet è offline di notte">
Android fa addormentare l'app. Disattiva l'ottimizzazione della batteria per Tillor, vedi [Configurare un chiosco](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Configurare un chiosco" href="/mobiele-app/kiosk-inrichten" description="Proprietario del dispositivo e batteria" />
  <Card title="Azioni da remoto" href="/mobiele-app/acties-op-afstand" description="Riattivare lo schermo o metterlo in standby" />
</Cards>


# Impostare la schermata iniziale e una presentazione (/it-IT/mobiele-app/startscherm-en-diavoorstelling)

La schermata iniziale è ciò che gli ospiti vedono quando non c'è uno scontrino sullo schermo: un testo di benvenuto, il tuo logo, pulsanti ed eventualmente una presentazione con locandine o foto del parco. Qui la imposti. Ogni singola impostazione con i suoi limiti è in [Impostazioni del dispositivo](/mobiele-app/toestelinstellingen#startscherm).

<Requires permission="Modifica impostazioni" />

Prima di iniziare:

- Il dispositivo è in <UIPath>Impostazioni > Tablet e chioschi</UIPath>, vedi [Gestire un tablet o un chiosco](/mobiele-app/tablets-en-kiosken).
- Le foto sono file JPEG, PNG o WebP, oppure un link `https` a un'immagine.

## Modificare il testo di benvenuto [#de-welkomsttekst-aanpassen]

<Steps>
<Step>
### Apri la scheda Schermata iniziale [#open-het-tabblad-startscherm]
Apri il dispositivo e clicca sul riquadro **Schermata iniziale**. Il campo **Titolo di benvenuto** (massimo 60 caratteri) e **Sottotitolo di benvenuto** (massimo 120) sono in cima.
</Step>
<Step>
### Compila il testo e invia [#vul-de-tekst-in-en-verstuur]
Lascia vuoto un campo se l'app può tenere il suo testo. Clicca su **Salva e invia**.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Scheda Schermata iniziale, con Aspetto e Pulsanti evidenziati" />

## Aggiungere una presentazione [#een-diavoorstelling-toevoegen]

<Steps>
<Step>
### Apri la scheda Presentazione e pulsanti [#open-het-tabblad-diavoorstelling-en-knoppen]
Clicca su quel riquadro. In **Visualizzazione** scegli come compaiono le foto.
</Step>
<Step>
### Scegli la visualizzazione [#kies-de-weergave]
<Tabs items={["Come sfondo", "Schermo intero in caso di inattività"]}>
<Tab value="Come sfondo">
Le foto si alternano dietro al logo e ai pulsanti, al posto dello sfondo della tua organizzazione. Gli ospiti possono intanto toccare i pulsanti.
</Tab>
<Tab value="Schermo intero in caso di inattività">
Le foto occupano tutto lo schermo non appena nessuno lo tocca. Un tocco riporta la schermata iniziale. Quanto dura l'attesa lo imposti in **Avvia dopo**.
</Tab>
</Tabs>
</Step>
<Step>
### Aggiungi le foto [#voeg-fotos-toe]
Clicca su **Carica foto**, oppure incolla un indirizzo `https` con **Aggiungi link**. Puoi aggiungere fino a 20 foto. A una foto puoi aggiungere una didascalia di massimo 80 caratteri.
</Step>
<Step>
### Imposta i tempi [#stel-de-timing-in]
**Tempo per foto** va da 3 a 600 secondi. **Avvia dopo** da 10 a 3600 secondi. In **Adattamento** scegli **Riempi lo schermo** (i bordi vengono ritagliati) o **Mostra la foto intera** (con bande nere).
</Step>
<Step>
### Clicca su Salva e invia [#klik-op-opslaan-en-versturen]
Il tablet mostra la presentazione non appena ha le impostazioni.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Scheda Presentazione e pulsanti, con la visualizzazione e due pulsanti aggiuntivi" />

## Aggiungere pulsanti aggiuntivi [#extra-knoppen-toevoegen]

I pulsanti aggiuntivi sono scorciatoie nella schermata iniziale, per esempio verso una mappa o la rete per gli ospiti. Puoi averne sei.

<Steps>
<Step>
### Clicca su Aggiungi pulsante [#klik-op-knop-toevoegen]
Compare una riga vuota.
</Step>
<Step>
### Compila il pulsante [#vul-de-knop-in]
Inserisci un testo, una breve descrizione e un indirizzo web (solo `https`). Scegli un'icona dalla fila e, in **Quando mostrare**, se il pulsante è sempre visibile o solo dopo un tocco.
</Step>
<Step>
### Clicca su Salva e invia [#klik-op-opslaan-en-versturen-1]
</Step>
</Steps>

L'icona del cestino rimuove un pulsante. **Lascia decidere il dispositivo** scarta l'elenco di Tillor, così il tablet usa i propri pulsanti.

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il tablet adatta la schermata iniziale non appena riceve le impostazioni. Un tablet offline lo fa non appena torna connesso.
- Se hai impostato **Pulsante prepagato** o **Pulsante impostazioni** su **Dopo un tocco**, il pulsante scompare dopo il numero di secondi che hai indicato in **Nascondi dopo**.
- Uno scontrino, un documento o una richiesta di firma che Tillor invia al tablet compare sopra la schermata iniziale e poi scompare.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Carica foto non funziona e Tillor dice Caricamento non riuscito">
Il file non è un JPEG, PNG o WebP, oppure il caricamento è stato interrotto. Prova un'altra foto, oppure usa **Aggiungi link** con l'indirizzo dell'immagine.
</Accordion>
<Accordion title="Non riesco ad aggiungere foto">
I pulsanti compaiono solo se **Visualizzazione** non è su **Disattivata**. Se l'elenco è a 20 foto, rimuovine prima una con **Rimuovi foto**.
</Accordion>
<Accordion title="La presentazione non parte">
Con **Schermo intero in caso di inattività** parte solo dopo il numero di secondi di **Avvia dopo** senza tocchi. Il valore predefinito per una nuova presentazione è 60 secondi. Controlla anche che il tablet abbia già le nuove impostazioni.
</Accordion>
<Accordion title="Il mio pulsante non apre nulla">
L'indirizzo deve iniziare con `https`. Controlla che il link funzioni in un browser.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni del dispositivo" href="/mobiele-app/toestelinstellingen" description="Tutte le impostazioni e i limiti" />
  <Card title="Gestire un tablet o un chiosco" href="/mobiele-app/tablets-en-kiosken" description="Inviare le impostazioni" />
</Cards>


# Gestire un tablet o un chiosco (/it-IT/mobiele-app/tablets-en-kiosken)

Ogni tablet, chiosco o telefono su cui qualcuno apre l'app Tillor e sceglie un'organizzazione compare in Tillor. Da lì vedi se il dispositivo è ancora connesso e gli invii la schermata iniziale, il suono e il blocco chiosco. Ciò che puoi impostare, scheda per scheda, lo trovi in [Impostazioni del dispositivo](/mobiele-app/toestelinstellingen).

<Requires permission="Modifica impostazioni" />

Prima di iniziare:

- Il dispositivo deve avere l'app Tillor e qualcuno deve aver effettuato l'accesso alla tua organizzazione. In caso contrario vedi **Ancora nessun dispositivo**.
- Inviare le impostazioni è possibile solo con il permesso **Modifica impostazioni**.

## Inviare le impostazioni a un dispositivo [#instellingen-naar-een-toestel-sturen]

<Steps>
<Step>
### Apri l'elenco [#open-de-lijst]
Vai su <UIPath>Impostazioni > Tablet e chioschi</UIPath>. Ogni riga è un'installazione dell'app. Vedi il nome, il tipo (**Tablet**, **Chiosco** o **Telefono**), il modello, la versione dell'app, la percentuale di batteria e se il dispositivo è connesso. **Visto l'ultima volta** significa che l'app non comunica nulla da un po'.

<DocScreenshot src="/screenshots/tablets/devices-list.png" alt="Impostazioni > Tablet e chioschi con il chiosco Chiosco self-service" />
</Step>
<Step>
### Apri il dispositivo [#open-het-toestel]
Clicca sulla riga del dispositivo. In alto ci sono il nome e lo stato. Sotto trovi una casella di ricerca e una fila di riquadri, uno per scheda.

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Pagina del dispositivo Chiosco self-service con i riquadri delle schede e la barra di salvataggio" />

Su un riquadro è indicato quante impostazioni arrivano da Tillor. **Tutto resta sul dispositivo** significa che in quella scheda non hai ancora fissato nulla. A destra resta il pannello **Azioni da remoto**, vedi [Azioni da remoto](/mobiele-app/acties-op-afstand).
</Step>
<Step>
### Modifica le impostazioni [#pas-de-instellingen-aan]
Scegli una scheda e cambia ciò che vuoi. Quasi ogni interruttore ha tre posizioni: **Dispositivo**, **Attivo** e **Disattivo**. **Dispositivo** lascia valere la scelta fatta sul tablet stesso. **Attivo** e **Disattivo** la sovrascrivono non appena salvi. Sotto la descrizione trovi cosa fa l'app quando nessuno ha scelto nulla, ad esempio **Predefinito: Attivo**.
</Step>
<Step>
### Clicca su Salva e invia [#klik-op-opslaan-en-versturen]
Nulla arriva al dispositivo finché non clicchi qui. Finché c'è qualcosa di modificato, nella barra compare **Modifiche non inviate** e la scheda ha un puntino verde. **Annulla le modifiche** riporta il modulo a ciò che c'è ora sul dispositivo.

Prima e dopo una modifica che non hai ancora inviato:

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Prima: pagina del dispositivo senza modifiche" />

<DocScreenshot src="/screenshots/tablets/device-page-unsaved.png" alt="Dopo: un'impostazione modificata con Modifiche non inviate e un puntino verde sulla scheda" />
</Step>
</Steps>

## Lo stesso per tutti i dispositivi [#hetzelfde-voor-alle-toestellen]

Se hai più dispositivi dello stesso tipo, non serve configurarli uno per uno.

<Tabs items={["Un dispositivo", "Tutti i dispositivi di questo tipo"]}>
<Tab value="Un dispositivo">
Clicca su **Salva e invia**. Solo questo dispositivo riceve le impostazioni.
</Tab>
<Tab value="Tutti i dispositivi di questo tipo">
Clicca su **Applica a tutti i chioschi** (o **tablet**, o **telefoni**, a seconda del tipo). Tillor copia le impostazioni di questo dispositivo sugli altri dello stesso tipo e le invia subito, con il messaggio **Impostazioni copiate sugli altri dispositivi**. Il nome, il tipo e gli avvisi restano propri di ogni dispositivo. La lingua invece viene copiata.
</Tab>
</Tabs>

## Cercare in tutte le schede [#zoeken-over-alle-tabbladen]

Non sai in quale scheda si trova un'impostazione? La casella **Cerca impostazioni** cerca in tutte le schede contemporaneamente. I riquadri restano visibili, ma sotto compare un elenco di risultati, raggruppati per scheda.

<DocScreenshot src="/screenshots/tablets/device-search.png" alt="Ricerca di luminosità, con i risultati di Schermo e riposo" />

Una ricerca come `luminosità` mostra le righe sulla luminosità di **Schermo e riposo**, e sotto le altre schede che contengono la stessa parola. **Apri scheda** chiude la ricerca e apre quella scheda, così vedi anche il resto del gruppo. Se non trovi nulla, compare **Nessuna impostazione corrisponde a** il tuo termine di ricerca.

## Dimenticare un dispositivo [#een-toestel-vergeten]

Il menu con i tre puntini in alto a destra nella pagina del dispositivo contiene **Dimentica dispositivo**. Usalo per un tablet che non è più in uso.

<DocScreenshot src="/screenshots/tablets/device-menu.png" alt="Menu con Dimentica dispositivo" />

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Tillor segnala **Impostazioni inviate**. Il tablet le applica subito se è connesso. Se è offline, le riceve non appena torna in contatto con Tillor. L'app si fa sentire ogni 30-60 secondi.
- Nella pagina del dispositivo e nell'elenco è indicato se il dispositivo è connesso. Il dispositivo comunica anche batteria, versione dell'app e connessione, vedi [Diagnostica e cronologia](/mobiele-app/diagnose-en-geschiedenis).
- Ogni modifica finisce nella cronologia del dispositivo e nel [registro attività](/activiteitenlog) della tua organizzazione.
- Un dispositivo dimenticato scompare dall'elenco e le impostazioni inviate vanno perse con lui. Se l'app è ancora in esecuzione e qualcuno ha effettuato l'accesso, ricompare entro un minuto, senza quelle impostazioni. Dovrai impostarle di nuovo.
- Se attivi **Avvisi** nella scheda **Dispositivo**, chi gestisce le impostazioni riceve un messaggio quando il dispositivo è offline da 10 minuti o la batteria scende sotto il 15% senza caricabatterie.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Vedo Ancora nessun dispositivo">
Nessun tablet si è ancora registrato. Apri l'app Tillor sul tablet, accedi e scegli l'organizzazione giusta. Il dispositivo compare entro un minuto.
</Accordion>
<Accordion title="Tillor dice Impossibile salvare le impostazioni">
Il salvataggio non è riuscito, spesso per una connessione instabile o perché ti manca il permesso **Modifica impostazioni**. Riprova. Se ancora non funziona, chiedi il permesso al tuo amministratore.
</Accordion>
<Accordion title="Tillor dice Impossibile copiare le impostazioni">
**Applica a tutti i chioschi** non è riuscito. Clicca ancora una volta. Se non funziona, salva il dispositivo con **Salva e invia** e apri gli altri dispositivi uno alla volta.
</Accordion>
<Accordion title="Il tablet non fa nulla con la mia modifica">
Controlla che il dispositivo sia **Connesso**. Se è offline, applica le impostazioni non appena torna in contatto. Se l'interruttore è su **Dispositivo**, decide il tablet stesso. Scegli **Attivo** o **Disattivo** per imporre la tua scelta.
</Accordion>
<Accordion title="Il dispositivo è tornato dopo Dimentica dispositivo">
L'app è ancora in esecuzione e qualcuno ha effettuato l'accesso, quindi si registra di nuovo. Esci dall'app sul tablet se vuoi davvero liberartene. In **Account** > **Sessioni attive** puoi terminare la sessione dell'app.
</Accordion>
<Accordion title="Tillor dice Usa da 4 a 6 cifre">
Il **Codice impostazioni** nella scheda **Schermata iniziale** deve essere composto da 4 a 6 cifre, oppure essere vuoto. Solo allora puoi salvare.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Impostazioni del dispositivo" href="/mobiele-app/toestelinstellingen" description="Cosa c'è in ogni scheda" />
  <Card title="Configurare un chiosco" href="/mobiele-app/kiosk-inrichten" description="Bloccare un tablet Android in modo che gli ospiti non possano uscirne" />
  <Card title="Azioni da remoto" href="/mobiele-app/acties-op-afstand" description="Riattivare lo schermo, riavviare e richiedere una schermata" />
</Cards>


# Impostazioni del dispositivo (/it-IT/mobiele-app/toestelinstellingen)

Qui trovi tutte le impostazioni di un dispositivo, scheda per scheda, con i loro valori predefiniti e i limiti. Sono sei, ciascuna un riquadro sopra i moduli. Come arrivarci, come funziona la ricerca e quando qualcosa viene inviato al dispositivo lo trovi in [Gestire un tablet o un chiosco](/mobiele-app/tablets-en-kiosken). La schermata iniziale, passo per passo, è in [Impostare la schermata iniziale e una presentazione](/mobiele-app/startscherm-en-diavoorstelling) e il riposo notturno in [Impostare un riposo notturno per lo schermo](/mobiele-app/nachtrust-instellen).

Ogni riga ha un'icona, una breve spiegazione e, dove ha senso, il valore predefinito dell'app. Scegli **Dispositivo** (o lascia vuoto un numero su **Predefinito**) se il tablet può tenere la propria scelta. **Attivo** e **Disattivo** la sovrascrivono.

Le righe che funzionano solo su un chiosco configurato mostrano un avviso finché il tablet non lo è: **Disponibile quando questo tablet è configurato come chiosco.** Quei passaggi sono in [Configurare un chiosco](/mobiele-app/kiosk-inrichten).

## Schermata iniziale [#startscherm]

Testo di benvenuto, sfondo e i pulsanti che gli ospiti vedono quando sullo schermo non c'è uno scontrino.

### Testo di benvenuto [#welkomsttekst]

**Titolo di benvenuto** (massimo 60 caratteri) e **Sottotitolo di benvenuto** (massimo 120) compaiono in cima alla schermata iniziale. Lascia vuoto un campo se l'app può tenere il proprio testo.

### Aspetto [#uiterlijk]

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Scheda Schermata iniziale, con Aspetto e Pulsanti evidenziati" />

**Aspetto** (indicatore **1**):

- **Foto di sfondo** mostra lo sfondo dell'organizzazione dietro al logo. Attivo per impostazione predefinita.
- **Scurimento dello sfondo** è una percentuale da 0 a 90. Predefinito 45, così il logo e i pulsanti restano leggibili su una foto chiara.
- **Stile del logo** è **Sagoma bianca** (il valore predefinito) oppure **A colori su una scheda**.

### Pulsanti [#knoppen]

**Pulsanti** (indicatore **2**):

- **Pulsante prepagato** apre saldo, ricarica e pagamento con una carta NFC. Attivo per impostazione predefinita.
- **Pulsante impostazioni** mostra un pulsante verso le impostazioni sul dispositivo stesso. Se è disattivato, ci arrivi toccando tre volte la schermata iniziale.
- **Quando mostrare** è **Sempre**, oppure **Dopo un tocco**. Con **Dopo un tocco** compili **Nascondi dopo**, in secondi. Poi il pulsante scompare di nuovo finché qualcuno non tocca lo schermo.
- **Codice impostazioni** è di 4-6 cifre. Il dispositivo chiede quel codice prima di aprire le proprie impostazioni. Vuoto significa nessun codice. Qualcosa di diverso da 4-6 cifre non puoi salvarlo.

## Presentazione e pulsanti [#diavoorstelling-en-knoppen]

Foto che la schermata iniziale alterna, e pulsanti aggiuntivi verso una pagina web.

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Scheda Presentazione e pulsanti, con la visualizzazione e due pulsanti aggiuntivi" />

### Presentazione [#diavoorstelling]

**Visualizzazione** (indicatore **1**) ha tre posizioni:

- **Disattivata** non mostra foto.
- **Come sfondo** alterna le foto dietro al logo e ai pulsanti, al posto dello sfondo dell'organizzazione.
- **Schermo intero in caso di inattività** occupa tutto lo schermo non appena nessuno lo tocca.

Quando la visualizzazione non è su **Disattivata**, puoi aggiungere fino a 20 foto. **Carica foto** accetta JPEG, PNG o WebP. **Aggiungi link** incolla un indirizzo `https` di un'immagine. Per ogni foto puoi inserire una didascalia di massimo 80 caratteri.

- **Tempo per foto** è per quanto tempo resta ogni foto, da 3 a 600 secondi. Una nuova presentazione parte da 10.
- **Avvia dopo** vale solo per lo schermo intero: secondi senza tocco prima che parta la presentazione, da 10 a 3600. Una nuova presentazione parte da 60.
- **Adattamento**: **Riempi lo schermo** ritaglia i bordi, **Mostra la foto intera** mantiene tutta la foto con bande nere. Una nuova presentazione parte da **Mostra la foto intera**.

Un tocco su una presentazione a schermo intero riporta alla schermata iniziale.

### Pulsanti aggiuntivi [#extra-knoppen]

I **Pulsanti aggiuntivi** (indicatore **2**) sono collegamenti rapidi sulla schermata iniziale, ad esempio una mappa o la rete per gli ospiti. Puoi averne sei.

Per ogni pulsante compili il testo del pulsante, una breve descrizione, l'indirizzo web e un'icona. L'icona la scegli dalla fila: mappa, sito web, informazioni, calendario, cibo e bevande, Wi-Fi, telefono o biglietti. **Quando mostrare** funziona come per il pulsante prepagato: sempre, oppure solo dopo un tocco e poi di nuovo nascosto.

**Aggiungi pulsante** crea una riga vuota. L'icona del cestino rimuove quel pulsante. **Lascia decidere il dispositivo** scarta l'elenco di Tillor, così il tablet usa i propri pulsanti. Finché non hai ancora salvato pulsanti, compare anche questa frase: da Tillor non è stato impostato nessun pulsante.

## Schermo e riposo [#scherm-en-slaap]

Luminosità, orientamento, colori e quando lo schermo si spegne di notte.

### Luminosità [#helderheid]

Se cerchi un'impostazione, prova `luminosità` nella casella di ricerca, vedi [Cercare in tutte le schede](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen).

- **Modalità chiosco** tiene lo schermo acceso, con scontrini, firma e controllo della luminosità. Attivo per impostazione predefinita su un tablet o un chiosco, disattivo su un telefono.
- **Mantieni lo schermo acceso** impedisce allo schermo di andare in standby. Attivo per impostazione predefinita, su un telefono disattivo.
- **Attenua quando inattivo** passa alla luminosità piena al tocco e poi attenua. Attivo per impostazione predefinita, su un telefono disattivo.
- **Attenua dopo** è il numero di secondi senza tocco, da 5 a 3600. Predefinito 15.
- **Luminosità attenuata** è la percentuale in quello stato attenuato, da 0 a 100. Predefinito 0,5%.

Il riposo notturno qui sotto ha la precedenza su **Mantieni lo schermo acceso**: durante le ore di riposo lo schermo si spegne o diventa nero comunque.

### Visualizzazione [#weergave]

- **Orientamento dello schermo** è **Ruota automaticamente** (il valore predefinito), **Verticale** oppure **Orizzontale**. Fissa un chiosco in un alloggiamento, altrimenti l'immagine ruota quando qualcuno inclina il tablet.
- **Aspetto** è **Segui il dispositivo**, **Chiaro** o **Scuro**.

### Riposo notturno [#nachtrust]

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Scheda Schermo e riposo, riposo notturno dalle 22:00 alle 07:00" />

**Modalità notte** (indicatore **1**) ha tre posizioni:

- **Disattivata** non programma nessun riposo.
- **Orario fisso** usa **Dalle** e **Alle**. È consentita una fascia che attraversa la mezzanotte, come dalle 22:00 alle 07:00. Lo schermo si spegne in quel blocco, anche se per il resto della giornata deve restare acceso. Toccarlo lo riattiva per poco.
- **Quando l'organizzazione è chiusa** segue gli orari di apertura dell'organizzazione.

In alto a destra nel gruppo compare quando cade il prossimo riposo.

**Stile di sonno**:

- **Velo nero** appoggia un velo nero sull'immagine. Lo schermo resta toccabile, quindi un tocco lo riattiva subito.
- **Schermo spento** spegne davvero il pannello. Si riattiva alla fine dell'orario, oppure con **Riattiva schermo** in [Azioni da remoto](/mobiele-app/acties-op-afstand). Funziona completamente su un tablet configurato come chiosco. La riattivazione da remoto riesce solo se l'app è anche nell'eccezione per la batteria, vedi [Batteria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).

## Scontrini e suono [#kassabonnen-en-geluid]

Cosa fa il tablet quando Tillor invia un documento, e quali suoni riproduce.

<DocScreenshot src="/screenshots/tablets/tab-sound.png" alt="Scheda Scontrini e suono" />

### Ricevute e documenti [#kassabonnen-en-documenten]

Indicatore **1**:

- **Mostra ricevute e documenti** mette PDF, immagini e richieste di firma su questo dispositivo. Attivo per impostazione predefinita, su un telefono disattivo. Disattivalo su un tablet che deve essere solo una schermata iniziale e non deve mostrare scontrini.
- **Cancella dopo** è il numero di secondi in cui uno scontrino resta sullo schermo prima che il dispositivo lo tolga da solo, da 5 a 900. Lascialo vuoto per attendere che Tillor cancelli lo schermo.

### Suono [#geluid]

Indicatore **2**. Tutto ciò che segue è attivo per impostazione predefinita, volume al 100%.

- **Suono all'avvio** suona quando l'app si avvia o si riavvia.
- **Suono per ricevute e documenti** suona quando arriva uno scontrino, un'immagine o una richiesta di firma.
- **Suono per i pagamenti online** suona quando una fattura è pagata online, o tramite bonifico automatico.
- **Suono batteria scarica** riproduce un avviso quando la batteria è quasi scarica e il caricabatterie non è collegato.
- **Volume audio** va da 0 a 100. Su un chiosco puoi bloccarlo con **Blocca il volume** nella scheda **Chiosco**.

**Riproduci suono di prova** si trova in [Azioni da remoto](/mobiele-app/acties-op-afstand), non in questa scheda.

## Chiosco [#kiosk]

Ha senso solo su Android. La configurazione (proprietario del dispositivo, batteria, USB) è in [Configurare un chiosco](/mobiele-app/kiosk-inrichten). Questa scheda è dove poi imposti gli interruttori.

<DocScreenshot src="/screenshots/tablets/tab-kiosk.png" alt="Scheda Chiosco con i riquadri di stato e il blocco" />

### Stato [#status]

Tre riquadri (indicatore **1**) mostrano ciò che il tablet ha comunicato nell'ultimo messaggio. Non sono impostazioni.

- **Dispositivo chiosco** è verde con **Chiosco configurato: il blocco è completo.** Un avviso significa blocco schermo (l'app non è il proprietario) oppure che l'app non è affatto bloccata. Un trattino significa che questa versione dell'app non comunica ancora lo stato.
- **Schermata iniziale** è verde se Tillor è la schermata Home. Altrimenti c'è scritto che Tillor non lo è ancora, oppure che l'app non l'ha ancora comunicato.
- **Blocco schermo** avvisa se sul tablet c'è una sequenza o un PIN. Dopo un riavvio il dispositivo resta in attesa nella schermata di blocco. Verde significa che un riavvio termina in Tillor.

### Blocco [#vergrendeling]

Indicatore **2**. Per impostazione predefinita questi tre sono disattivati, finché non li attivi tu.

- **App come schermata Home** rende Tillor la schermata iniziale. Orologio e batteria restano visibili. Solo Android, e solo con una build dell'app che lo supporta.
- **Blocca l'app** tiene il tablet nell'app Tillor. Su un chiosco configurato un ospite non può uscirne. Senza quella configurazione Android ripiega sul blocco schermo: qualcuno sul tablet deve confermarlo, e si può abbandonare.
- **Nascondi l'interfaccia di sistema** toglie notifiche, app recenti e il menu di accensione. Orologio e batteria restano. Funziona solo quando il tablet è configurato come chiosco.

### Gestione Android [#android-beheer]

<DocScreenshot src="/screenshots/tablets/tab-kiosk-android.png" alt="Gestione Android nella scheda Chiosco" />

Tutto in questo gruppo (indicatore **1**) vale solo per un chiosco configurato. Su un altro dispositivo vedi l'avviso a ogni riga e i pulsanti sono disattivati. Per impostazione predefinita gli interruttori sono disattivati. I due numeri sono vuoti: il tablet tiene la propria luminosità e il proprio time-out.

- **Proteggi il dispositivo** blocca il ripristino, la modalità provvisoria, i nuovi utenti, il trasferimento USB, la disinstallazione e l'arresto forzato. Disattivalo prima di installare un aggiornamento via USB.
- **Rimuovi il blocco schermo** toglie la sequenza o il PIN. Ha effetto dopo che quella sequenza o quel PIN sono stati inseriti ancora una volta.
- **Resta acceso in carica** tiene lo schermo acceso durante gli orari di apertura finché il caricabatterie è collegato. Il riposo notturno lo spegne comunque.
- **Blocca il volume** mantiene il volume di **Suono**.
- **Aggiornamenti durante il sonno** installa gli aggiornamenti di sistema mentre lo schermo riposa, e li rimanda finché il tablet è in uso.
- **Ora automatica** richiede data, ora e fuso orario automatici, così il riposo segue gli orari di apertura.
- **Luminosità dello schermo** è una luminosità fissa del tablet stesso, da 1 a 100, con la luminosità automatica disattivata. Lasciandola vuota si mantiene l'impostazione del tablet.
- **Spegnimento dello schermo** è il numero di secondi (da 15 a 3600) dopo i quali Android spegne lo schermo se l'app non lo tiene acceso. Lasciandolo vuoto si mantiene l'impostazione del tablet.

## Dispositivo [#toestel]

Nome, tipo, lingua e avvisi. **Applica a tutti i chioschi** porta la lingua sugli altri dispositivi dello stesso tipo, e lascia stare nome, tipo e avvisi.

<DocScreenshot src="/screenshots/tablets/tab-general.png" alt="Scheda Dispositivo con nome, tipo, lingua e avvisi" />

Indicatore **1**:

- **Nome** è ciò che vedi nell'elenco e sul dispositivo, ad esempio `Zelfbedieningskiosk`. Massimo 80 caratteri.
- **Tipo** è **Tablet**, **Chiosco** o **Telefono**. Il tipo determina il testo di **Applica a tutti …** e alcuni valori predefiniti: su un telefono modalità chiosco, scontrini, schermo acceso e attenuazione partono disattivati.
- **Lingua** è l'unico elenco che si richiude, perché le opzioni sono più di quante ne stiano in una fila di pulsanti. **Predefinito** segue la lingua del tablet. Altrimenti scegli una lingua dell'app Tillor. I nomi sono scritti nella lingua stessa.
- **Avvisi** avvisa chi gestisce le impostazioni se questo dispositivo è offline da 10 minuti, o se la batteria scende sotto il 15% senza caricabatterie. Durante il riposo notturno non arriva nessun avviso di offline. Disattivato per impostazione predefinita.

<Callout type="info">
La lingua qui è la lingua dell'app sul tablet. La lingua del sistema Android la vedi in **Diagnostica**, come **Lingua del dispositivo**.
</Callout>


# Automazioni (/it-IT/ontwikkelaars/automatiseringen)

Le automazioni fanno eseguire azioni a Tillor stesso, come creare attività o richiamare il tuo sistema. La guida per gli utenti è in [Automazioni](/automatiseringen). Questa pagina descrive ciò che vede un integratore: il messaggio del passaggio **Invia webhook**, la **Richiesta API** verso un URL personalizzato o verso l'API di Tillor, e come è costruito un flusso se lo gestisci tramite l'API.

## Invia webhook [#webhook-versturen]

Il passaggio **Invia webhook** consegna un messaggio proprio a uno dei [webhook](/ontwikkelaars/webhooks) dell'organizzazione. È la stessa consegna degli eventi webhook normali, con la stessa firma.

### Il messaggio [#het-bericht]

Il passaggio fa una `POST` con `Content-Type: application/json` e questi header:

| Header | Contenuto |
|---|---|
| `X-Webhook-Event-ID` | Un ID univoco per questa consegna. Nei nuovi tentativi il valore resta lo stesso, quindi puoi usarlo per eliminare i duplicati |
| `X-Webhook-Signature` | `sha256=<hex>`, l'HMAC-SHA256 del body con la signing secret del webhook |

Il body ha la stessa busta del payload del webhook:

```json
{
  "event": "automation.invoice_unpaid",
  "data": {
    "invoice": "2026-0042",
    "amountOutstanding": 125.5
  },
  "timestamp": 1735689600000,
  "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d",
  "triggeredBy": null
}
```

| Campo | Descrizione |
|---|---|
| `event` | Il **Nome dell'evento** che hai compilato nel passaggio. È consentito qualsiasi testo, il nome non deve per forza essere nell'elenco delle event-key |
| `data` | Il **Payload** del passaggio, dopo la sostituzione delle variabili, come JSON |
| `timestamp` | Tempo Unix in millisecondi della consegna |
| `traceId` | Un UUID casuale per ogni consegna. A differenza degli eventi del sistema, non è un trace-id di un'azione di Tillor |
| `triggeredBy` | Sempre `null` |

Non c'è nessun `spanId`. Il webhook non deve essere iscritto a una event-key: un messaggio di un'automazione viene sempre consegnato all'endpoint scelto, finché esiste ed è attivo.

Come verificare la firma è spiegato in [Verificare la firma](/ontwikkelaars/webhooks#handtekening-verifiëren).

### Tentativi ed esito [#pogingen-en-uitkomst]

Tillor fa fino a 5 tentativi all'interno del passaggio, con 1, 2, 4 e 8 secondi di attesa tra l'uno e l'altro. Un tentativo conta come riuscito con uno stato 2xx. Anche una destinazione bloccata, ad esempio un indirizzo interno, conta come tentativo fallito.

- Se uno dei tentativi riesce, il flusso prosegue dall'uscita **Riuscito**
- Se tutti e cinque falliscono, il flusso prosegue da **Fallito**. Il messaggio viene poi ritentato in background secondo lo schema in [Comportamento di consegna e retry](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Se un tentativo successivo riesce, non risulta più nell'esecuzione, perché questa è già andata avanti

Se il webhook non esiste più o è disattivato, il passaggio non passa da **Fallito**. L'esecuzione si ferma allora con lo stato **Fallito**.

## Richiesta API verso un URL personalizzato [#api-verzoek-naar-een-eigen-url]

Con **Richiesta API** e **Invia a** su **URL personalizzato**, un'automazione invia una richiesta HTTP al tuo server.

| Elemento | Comportamento |
|---|---|
| Metodo | `GET`, `POST`, `PUT`, `PATCH` o `DELETE` |
| URL | Deve iniziare con `https://`. Le variabili vengono inserite codificate |
| Body | JSON. Con `GET` e `DELETE` non viene inviato. Con un body Tillor imposta `Content-Type: application/json` |
| Header | Liberi. I valori possono contenere variabili. `Host`, `Content-Length`, `Transfer-Encoding` e `Connection` vengono ignorati |
| Destinazione | Gli indirizzi privati e interni vengono rifiutati, anche se un normale nome di dominio punta a essi |
| Reindirizzamenti | Non vengono seguiti. Una risposta 3xx conta come fallita |
| Time-out | 15 secondi |

<Callout type="warn" title="Nessuna firma">
A differenza di **Invia webhook**, Tillor non firma questa richiesta. Se vuoi verificare che una richiesta provenga dalla tua automazione, metti un segreto in un header e controllalo dal tuo lato. Gli header vengono salvati cifrati, quindi una chiave o un token al loro interno è al sicuro.
</Callout>

Una risposta con stato 2xx prosegue da **Riuscito**, qualsiasi altro stato da **Fallito**. Se il server non è raggiungibile, o supera il time-out, l'esecuzione si ferma con lo stato **Fallito**.

## Richiesta API verso l'API di Tillor [#api-verzoek-naar-de-tillor-api]

Con **Invia a** su **Tillor API**, l'automazione richiama l'API della propria organizzazione. Indichi solo un percorso, ad esempio `/tasks`, e Tillor lo mette dopo `/api/orgs/{orgId}`. Il tuo riferimento API è su [OpenAPI](https://tillor.eu/api/openapi.json).

- **Identità**: la richiesta viene eseguita come utente Workflow dell'organizzazione. Questo ha tutti i permessi all'interno di quell'organizzazione e in nessun altro posto. Le modifiche risultano quindi a nome di **Workflow**
- **Nessuna chiave necessaria**: Tillor esegue la chiamata da sé, senza chiave API e senza passare da internet
- **Percorso**: deve iniziare con un solo `/`. `//`, `..` e `\` non sono consentiti. È ammessa una query string, ad esempio `/tasks?terrainId=…&limit=1`. Le variabili nel percorso vengono inserite codificate
- **Bloccato**: i percorsi `/automations` e `/automation-runs` vengono rifiutati, anche con una query string, lettere maiuscole, un `/` finale o una codifica percentuale. Un'automazione non può gestire automazioni
- **Body**: JSON, per `POST`, `PUT` e `PATCH`. Con `GET` e `DELETE` non viene inviato
- **Menu di scelta**: nell'editor c'è **Scegli un endpoint API** con le operazioni della specifica OpenAPI. Le operazioni interne non ci sono. Se ne scegli una, Tillor compila metodo, percorso e un body di esempio
- **Fallimento**: una risposta 2xx prosegue da **Riuscito**. Uno stato di errore, anche un 404 per un percorso che non esiste, passa da **Fallito**

### La risposta nei passaggi successivi [#het-antwoord-in-latere-stappen]

Dopo la richiesta sono disponibili queste variabili:

| Variabile | Contenuto |
|---|---|
| `{response.status}` | Il codice di stato HTTP |
| `{response.body}` | I primi 4000 caratteri della risposta come testo |
| `{response.data}` | La risposta come JSON. `null` se non è JSON, o se supera i 100.000 caratteri. Gli elenchi si indirizzano con un indice, ad esempio `{response.data.items.0.id}` |

Una seconda richiesta API nello stesso flusso sostituisce `response`. Le variabili funzionano come in [Variabili e modelli](/automatiseringen/variabelen).

## La struttura di un flusso [#de-opbouw-van-een-flow]

Puoi anche creare e modificare le automazioni tramite l'API. Le operazioni sono in [OpenAPI](https://tillor.eu/api/openapi.json) sotto il tag `automations`. Leggere richiede il permesso `automations:read`, creare e modificare `automations:write` (o tutti i permessi). L'utente Workflow stesso non può mai richiamarle. Può essere più comodo costruire un flusso nell'editor e leggerlo come esempio.

Una nuova automazione è sempre disattivata. Attivarla tramite `enabled` non riesce finché il flusso ha problemi aperti, e un flusso attivo non puoi salvarlo con dei problemi.

La `definition` è composta da passaggi (`nodes`), linee (`edges`) e facoltativamente note (`notes`). Al massimo 100 passaggi, 200 linee e 50 note.

```json
{
  "nodes": [
    {
      "id": "trigger",
      "type": "trigger",
      "label": "",
      "position": { "x": 0, "y": 0 },
      "config": { "source": "event", "eventKey": "occupation:ended" }
    },
    {
      "id": "task",
      "type": "taskCreate",
      "label": "",
      "position": { "x": 0, "y": 190 },
      "config": { "title": "Controleer {occupation.terrain.name}", "priority": "HIGH" }
    }
  ],
  "edges": [
    { "id": "trigger:out:task", "source": "trigger", "target": "task", "sourceHandle": "out" }
  ],
  "notes": [
    {
      "id": "note_1",
      "text": "Maakt na elk vertrek een controletaak.",
      "position": { "x": 340, "y": 0 },
      "width": 240,
      "height": 140
    }
  ]
}
```

Una nota (`notes`) è una spiegazione sulla tela. Non viene mai eseguita e non ha linee. `text` è al massimo di 2000 caratteri, `width` e `height` sono in pixel.

Una linea ha un `sourceHandle`: l'uscita del passaggio da cui parte.

| Passaggio (`type`) | Uscite (`sourceHandle`) |
|---|---|
| `trigger`, `delay`, `waitUntilOpen`, `waitUntilClosed`, `taskCreate`, `taskSetStatus`, `taskSetPriority`, `taskUpdate`, `invoiceReminderSend`, `invoiceSend`, `invoicePrint`, `occupationExtendInvoice`, `staffNotify`, `commentCreate`, `inboxReply`, `inboxTag`, `customerUpdate`, `accessMethodCreate`, `accessMethodUpdate`, `accessMethodSendQr`, `accessPointControl`, `meterSwitch`, `nfcTagUpdate`, `deviceCommand`, `deviceDisplay`, `deviceSlideshow`, `controllerRelay`, `controllerCommand` | `out` |
| `customerMessageSend`, `reservationSetStatus`, `invoiceBook`, `paymentLinkCreate`, `mandateRequest`, `mandateCollect`, `consumptionInvoice` | `out`, `skipped` |
| `condition` | `yes`, `no` |
| `switch` | L'`id` di ogni ramo, più `default` |
| `openingHours` | `open`, `closed` |
| `throttle` | `pass`, `blocked` |
| `taskFind`, `documentFind`, `recordLookup` | `found`, `notFound` |
| `forEach` | `each`, `done` |
| `waitUntil` | `met`, `timeout` |
| `waitForEvent` | `received`, `timeout` |
| `approval` | `approved`, `rejected`, `timeout` |
| `webhookSend`, `httpRequest` | `success`, `failed` |

Ogni azione tranne `webhookSend` e `httpRequest` riceve un'uscita aggiuntiva `error` non appena `continueOnError` nel `config` è su `true`. Senza questa impostazione un'azione fallita ferma l'esecuzione. Con l'impostazione il flusso prosegue da `error`, con `{error.message}` e `{error.step}` come variabili per i passaggi successivi. L'uscita `skipped` viene usata quando un passaggio non aveva nulla da fare, e `out` è allora l'uscita normale.

Con `forEach`, l'uscita `each` avvia per ogni elemento un'esecuzione propria per i passaggi successivi, e l'uscita `done` è il proseguimento normale del flusso stesso.

Un'uscita può portare a più passaggi. L'esecuzione prosegue da sé con la prima linea e per ogni altra linea avvia un'esecuzione propria con gli stessi dati, che corre in parallelo (come l'uscita `each` di `forEach`). Le linee che formano un ciclo vengono rifiutate nell'editor. Un flusso ha esattamente un `trigger`.

### Impostazioni per passaggio [#instellingen-per-stap]

I campi sotto `config` sono i campi dell'editor. I campi di testo accettano variabili tra parentesi graffe.

| Passaggio | Campi in `config` |
|---|---|
| `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` o `cron`), `webhookVersion` (con `webhook`: testo, aumentalo per sostituire l'indirizzo), `eventKey`, `date` (con `dateReached`: un percorso `record.campo` verso una colonna `DateTime` di un modello che un evento invia per intero, come `reservation.checkIn` o `contact.birthday`, oppure verso una chiave data dichiarata in una colonna JSON, come `document.userMetadata.insuranceExpiryDate`; i vecchi nomi come `reservationCheckIn` continuano a funzionare), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` o `after`), `dateTime` (`exact`: l'ora nella data, oppure `fixed`: il giorno di calendario della data nel fuso orario dell'organizzazione, con `dateHour` e `dateMinute`, testo come `"9"` e `"0"`; lo spostamento conta sull'orologio, quindi anche attraverso l'ora legale e quella solare), `repeatYearly` (boolean: contano solo giorno e mese, ogni anno), `hour` e `minute` (testo, ad esempio `"8"` e `"0"`, minuto da 0 a 59), `cron` (cinque campi; il giorno della settimana può essere `1#2` o `1L`, un sesto campo `W2:2026-10-05` si ripete ogni due settimane), `conditions`, `oncePerRecord` (boolean) |
| `condition` | `conditions` |
| `switch` | `field` (un percorso di variabile senza parentesi graffe), `cases`: un elenco di `{ "id", "key", "value" }` con `key` come nome del ramo e `value` come valore a cui il campo deve essere uguale. Al massimo 8 rami |
| `delay` | `mode` (`duration` o `untilDate`), `duration` e `offset` come `{ "amount", "unit" }` con `unit` che è `seconds`, `minutes`, `hours`, `days` o `weeks`, `dateField` (percorso di variabile), `direction` (`before` o `after`) |
| `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` o `URGENT`), `viewId`, `laneId`, `subtasks` (una per riga), `dueIn` (`{ "amount", "unit" }`), `linkRecords` |
| `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` o `COMPLETED`) |
| `taskFind` | `title` (titolo esatto), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (boolean) |
| `documentFind` | `customerId` (modello), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` o vuoto), `onlyActive`, `onlyValid` (boolean). Risultato sotto `foundDocument` |
| `documentUpdate` | `documentId` (modello), `documentType` (vuoto mantiene il tipo), `status` (`ACTIVE`, `ARCHIVED` o vuoto) |
| `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` o `set`), `priority` (con `set`), `maxPriority` (con `raise`) |
| `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` o `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }` con `unit` che è `minutes`, `hours`, `days` o `weeks`) |
| `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` |
| `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` o `tablet`) |
| `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` o `PAYCONIQ`) |
| `mandateRequest` | `customerId`, `mode` (`request` o `reminder`) |
| `mandateCollect` | `invoiceId`, `delayDays` (testo, predefinito `"0"`, al massimo 7) |
| `consumptionInvoice` | `customerId`, `sendEmail`, `sendSms` |
| `occupationExtendInvoice` | `occupationId`, `includeConsumption` |
| `customerMessageSend` | `customerId`, `subject`, `body`, `sendEmail`, `sendSms`, `sendWhatsApp` |
| `staffNotify` | `userIds`, `notifyActor`, `title`, `body`, `sendPush`, `sendEmail` |
| `commentCreate` | `content`, `target` (`event` o `task`), `taskId` (con `task`) |
| `inboxReply` | `threadId`, `body`, `keepAssistant` |
| `inboxTag` | `threadId`, `tagIds`, `archive` |
| `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` o `BLACKLISTED`), `notes` |
| `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` o `cancel`) |
| `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` o `NFC`), `value`, `periodFrom`, `periodTo` (variabili con una data, vuoto significa nessun limite) |
| `accessMethodUpdate` | `scope` (`one` o `customer`), `accessMethodId` (con `one`), `customerId` (con `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` o `INACTIVE`), `periodTo` |
| `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` o `thermal`) |
| `accessPointControl` | `accessPointId`, `action` (`open` o `close`) |
| `meterSwitch` | `target` (`terrain` o `meter`), `terrainId` (con `terrain`), `meterId` (con `meter`), `state` (`on` o `off`) |
| `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` o `lowBalance`), `amount` (con `topUp`, in euro per tag) |
| `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` o `playSound`), `url` (con `playSound`: il percorso di un suono caricato, come lo compila l'editor, oppure un link https a un file mp3, wav o m4a) |
| `deviceDisplay` | `kind` (`pdf` o `image`), `url` (link https). Compare su ogni tablet impostato come display, come il PDF di una fattura |
| `controllerRelay` | `target` (`controller` o `event`: il controller dell'evento `controller:input:changed` che ha avviato il flusso), `controllerId` (con `controller`), `relay` (testo da `"1"` a `"6"`), `action` (`pulse`, `on` o `off`), `durationSeconds` (con `pulse`, testo, da 0.001 a 3600 con decimali come `"0.5"`; il relè si diseccita da solo) |
| `controllerCommand` | `target` e `controllerId` come per `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` o `refreshSettings`) |
| `deviceSlideshow` | `scope` (`displays` o `device`), `mode` (`screensaver` o `background`), `source` (`feed` o `urls`). Con `feed`: `itemsPath`, `imageField`, facoltativamente campi di filtro e ordinamento |
| `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Nessun campo |
| `throttle` | `window` (`{ "amount", "unit" }` con `unit` che è `minutes`, `hours`, `days` o `weeks`), `key` (vuoto significa per record che ha avviato il flusso) |
| `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` o `InboxMessage`), `recordId`. Il risultato è sotto `found` più il modello, come `foundCustomer` |
| `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (solo `ACTIVE`) o `terrainMeters`), `parentId` (id del cliente o del terreno). Al massimo 100 elementi, l'elemento è sotto `item` |
| `waitUntil` | `conditions`, `interval` e `timeout` (`{ "amount", "unit" }` con `unit` che è `minutes`, `hours`, `days` o `weeks`; l'intervallo è di almeno 5 minuti) |
| `waitForEvent` | `eventKey`, `sameRecord` (boolean), `timeout` (`{ "amount", "unit" }`) |
| `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). L'attività è sotto `approvalTask.id` |
| Ogni azione tranne `webhookSend` e `httpRequest` | `continueOnError` (boolean) |
| `webhookSend` | `webhookId`, `event`, `payload` (JSON come testo) |
| `httpRequest` | `target` (`tillor` o `custom`), `method`, `path` (con `tillor`), `url` (con `custom`), `headers` (elenco di `{ "id", "key", "value" }`), `body` (JSON come testo) |

`conditions` ha la forma `{ "match": "all" o "any", "rules": [...] }`. Ogni regola è `{ "id", "field", "operator", "value", "values" }`. `operator` è `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` o `isNotEmpty`. `values` lo usi solo con `isOneOf`. Un elenco vuoto di regole lascia passare tutto.

## Avviare un'automazione con un webhook [#een-automatisering-starten-met-een-webhook]

Un'automazione con trigger `webhook` parte con una `POST` al proprio indirizzo:

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/automation-hooks/aut_xxx/<token>?bron=website" \
  -H "Content-Type: application/json" \
  -d '{"email":"jan@voorbeeld.nl","aankomst":"2026-07-14"}'
```

- L'indirizzo completo è nell'editor presso il trigger, oppure tramite `GET /automations/{id}/webhook-url` (con `automations:read`). Il token è il segreto; non serve un header per l'autenticazione
- Il body JSON diventa la variabile `body`, la query string `query` e l'istante `receivedAt`
- Risposta `200` con `{ "accepted": true }` non appena l'esecuzione è partita. Un indirizzo errato, sostituito o disattivato dà `404`, un body oltre i 100 KB dà `400`
- Molte chiamate ravvicinate non vengono rifiutate: ogni chiamata valida avvia un'esecuzione. Usa **Ignora le ripetizioni** nel trigger se la stessa chiamata può arrivare due volte, vedi [Ignora le ripetizioni](/automatiseringen/triggers#herhalingen-negeren)

Un'automazione non può richiamare il proprio webhook tramite una **Richiesta API** verso l'API di Tillor.

## Scegliere una decisione tramite l'API [#een-beslissing-kiezen-via-de-api]

L'attività di un passaggio **Chiedi una decisione** ha un'azione per ogni opzione che hai impostato nel passaggio. Recupera l'attività per vedere le `actions` con il loro `id`, e scegline una con `POST /tasks/{id}/actions/{actionId}/choose`. Se l'opzione richiede una nota, inviala insieme come `{ "note": "..." }`. La scelta è definitiva: chiude l'attività e fa proseguire l'automazione dall'uscita di quell'opzione. Possono scegliere i colleghi assegnati (anche tramite un gruppo) e gli amministratori. Vedi [OpenAPI](https://tillor.eu/api/openapi.json) per i dettagli.

## Per saperne di più [#meer-lezen]

- [Webhook](/ontwikkelaars/webhooks) per firma, retry ed elenco degli eventi
- [API HTTP](/ontwikkelaars/http) per autenticazione e contesto dell'organizzazione
- [Variabili e modelli](/automatiseringen/variabelen) per la guida per gli utenti


# Event-index (/it-IT/ontwikkelaars/events)

{/* Gegenereerd door bun run --cwd apps/next generate:registry uit de realtime.ts-bestanden. Niet met de hand aanpassen. */}

Deze pagina wordt automatisch opgebouwd uit de code: elk event dat Tillor via [SSE](/ontwikkelaars/sse) of [webhooks](/ontwikkelaars/webhooks) verstuurt, staat hier. In de payload hieronder zie je alleen `event` en `data`; `timestamp`, `traceId` en de andere velden van de [envelop](/ontwikkelaars/webhooks#webhook-payload) komen er altijd bij.

De voorbeeldwaarden zijn verzonnen. De velden en hun types komen rechtstreeks uit het datamodel; een event kan extra relaties meesturen die hier niet staan.

Je ontvangt een event alleen als je organisatielid één van de genoemde permissies heeft. Events met "geen webhook" komen te vaak voor om als webhook te versturen; je kunt ze alleen via SSE volgen.

## Overzicht [#overzicht]

| Event | Beschrijving | Permissie | Levering |
|-------|--------------|-----------|----------|
| `*` | Alle events | volledige toegang (`*`) | SSE + webhook |
| [`accessLogEntry:coupled`](#accesslogentry-coupled) | Toegangslogregel gekoppeld | `access-control:read` | SSE + webhook |
| [`accessLogEntry:processed`](#accesslogentry-processed) | Toegangslogregel verwerkt | `access-control:read` | SSE + webhook |
| [`accessMethod:created`](#accessmethod-created) | Toegangsmethode aangemaakt | `access-control:read` | SSE + webhook |
| [`accessMethod:deleted`](#accessmethod-deleted) | Toegangsmethode verwijderd | `access-control:read` | SSE + webhook |
| [`accessMethod:updated`](#accessmethod-updated) | Toegangsmethode gewijzigd | `access-control:read` | SSE + webhook |
| [`accessMethodOperation:created`](#accessmethodoperation-created) | Bewerking op toegangsmethode gestart | `access-control:read` | SSE + webhook |
| [`accessMethodOperation:updated`](#accessmethodoperation-updated) | Bewerking op toegangsmethode gewijzigd | `access-control:read` | SSE + webhook |
| [`accessPoint:created`](#accesspoint-created) | Toegangspunt aangemaakt | `access-control:read` | SSE + webhook |
| [`accessPoint:deleted`](#accesspoint-deleted) | Toegangspunt verwijderd | `access-control:read` | SSE + webhook |
| [`accessPoint:openTooLong`](#accesspoint-opentoolong) | Toegangspunt te lang open | `access-control:access-point-open:alert` | SSE + webhook |
| [`accessPoint:physicalStateChanged`](#accesspoint-physicalstatechanged) |  | `access-control:read` | SSE, geen webhook |
| [`accessPoint:updated`](#accesspoint-updated) | Toegangspunt gewijzigd | `access-control:read` | SSE + webhook |
| [`bankAccountTransaction:imported`](#bankaccounttransaction-imported) | Banktransactie geïmporteerd | `bank-transactions:read` of `bank-transactions:sync` | SSE + webhook |
| [`call:created`](#call-created) | Telefoongesprek gestart | `calls:read` | SSE + webhook |
| [`call:updated`](#call-updated) | Telefoongesprek gewijzigd | `calls:read` | SSE + webhook |
| [`comment:created`](#comment-created) | Opmerking toegevoegd | `comments:read` | SSE + webhook |
| [`comment:deleted`](#comment-deleted) | Opmerking verwijderd | `comments:read` | SSE + webhook |
| [`comment:mentioned`](#comment-mentioned) | Iemand genoemd in een opmerking | `comments:read` | SSE + webhook |
| [`comment:pinned`](#comment-pinned) | Opmerking vastgezet | `comments:read` | SSE + webhook |
| [`comment:resolved`](#comment-resolved) | Opmerking opgelost | `comments:read` | SSE + webhook |
| [`comment:unresolved`](#comment-unresolved) | Opmerking heropend | `comments:read` | SSE + webhook |
| [`comment:updated`](#comment-updated) | Opmerking bewerkt | `comments:read` | SSE + webhook |
| [`controller:adoption:approved`](#controller-adoption-approved) | Adoptie van besturingseenheid goedgekeurd | `controllers:read` | SSE + webhook |
| [`controller:adoption:rejected`](#controller-adoption-rejected) | Adoptie van besturingseenheid afgewezen | `controllers:read` | SSE + webhook |
| [`controller:adoption:requested`](#controller-adoption-requested) | Besturingseenheid vraagt om adoptie | `controllers:read` | SSE + webhook |
| [`controller:created`](#controller-created) | Besturingseenheid aangemaakt | `controllers:read` | SSE + webhook |
| [`controller:deleted`](#controller-deleted) | Besturingseenheid verwijderd | `controllers:read` | SSE + webhook |
| [`controller:input:changed`](#controller-input-changed) | Ingang van controller veranderd | `controllers:read` | SSE + webhook |
| [`controller:io:changed`](#controller-io-changed) |  | `controllers:read` | SSE (`?channel=controller-io`), geen webhook |
| [`controller:logs:submitted`](#controller-logs-submitted) |  | `controllers:logs` | SSE (`?channel=controller-logs`), geen webhook |
| [`controller:updated`](#controller-updated) | Besturingseenheid gewijzigd | `controllers:read` | SSE + webhook |
| [`customEnum:created`](#customenum-created) |  | elk lid | SSE, geen webhook |
| [`customEnum:deleted`](#customenum-deleted) |  | elk lid | SSE, geen webhook |
| [`customEnum:updated`](#customenum-updated) |  | elk lid | SSE, geen webhook |
| [`customer:contact:created`](#customer-contact-created) | Contactpersoon toegevoegd aan een klant | `customers:read` | SSE + webhook |
| [`customer:contact:deleted`](#customer-contact-deleted) | Contactpersoon verwijderd bij een klant | `customers:read` | SSE + webhook |
| [`customer:contact:updated`](#customer-contact-updated) | Contactpersoon van klant gewijzigd | `customers:read` | SSE + webhook |
| [`customer:created`](#customer-created) | Klant aangemaakt | `customers:read` | SSE + webhook |
| [`customer:deleted`](#customer-deleted) | Klant verwijderd | `customers:read` | SSE + webhook |
| [`customer:updated`](#customer-updated) | Klant gewijzigd | `customers:read` | SSE + webhook |
| [`customFieldDefinition:created`](#customfielddefinition-created) |  | elk lid | SSE, geen webhook |
| [`customFieldDefinition:deleted`](#customfielddefinition-deleted) |  | elk lid | SSE, geen webhook |
| [`customFieldDefinition:updated`](#customfielddefinition-updated) |  | elk lid | SSE, geen webhook |
| [`document:created`](#document-created) | Document ontvangen | `documents:read` | SSE + webhook |
| [`document:deleted`](#document-deleted) | Document verwijderd | `documents:read` | SSE + webhook |
| [`document:updated`](#document-updated) | Document gewijzigd | `documents:read` | SSE + webhook |
| [`event-log:created`](#event-log-created) | Gebeurtenis gelogd | `audit-logs:read` | SSE + webhook |
| [`identityDocumentScan:completed`](#identitydocumentscan-completed) | ID-scan voltooid | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:deleted`](#identitydocumentscan-deleted) | ID-scan verwijderd | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:linked`](#identitydocumentscan-linked) | ID-scan gekoppeld aan een klant | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:pendingQueueChanged`](#identitydocumentscan-pendingqueuechanged) | Wachtrij voor ID-scans gewijzigd | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:unlinked`](#identitydocumentscan-unlinked) | ID-scan ontkoppeld | `identity-document-scans:read` | SSE + webhook |
| [`img:clear-tablet`](#img-clear-tablet) | Afbeelding gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`img:to-tablet`](#img-to-tablet) | Afbeelding naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`inbox:message-created`](#inbox-message-created) | Bericht ontvangen in de inbox | `inbox:read` | SSE + webhook |
| [`inbox:participant-reaction`](#inbox-participant-reaction) | Reactie op een inboxbericht | `inbox:read` | SSE + webhook |
| [`inbox:thread-updated`](#inbox-thread-updated) | Inboxgesprek gewijzigd | `inbox:read` | SSE + webhook |
| [`inbox:typing-changed`](#inbox-typing-changed) |  | `inbox:read` | SSE, geen webhook |
| [`inbox:urgent-handoff`](#inbox-urgent-handoff) | Dringende overdracht door de assistent | `inbox:read` | SSE + webhook |
| [`integration-alarm:created`](#integration-alarm-created) | Meteralarm afgegaan | `meters:read` | SSE + webhook |
| [`integration-alarm:resolved`](#integration-alarm-resolved) | Meteralarm opgelost | `meters:read` | SSE + webhook |
| [`invoice:created`](#invoice-created) | Factuur aangemaakt | `invoices:read` | SSE + webhook |
| [`invoice:deleted`](#invoice-deleted) | Factuur verwijderd | `invoices:read` | SSE + webhook |
| [`invoice:moved-to-customer`](#invoice-moved-to-customer) | Factuur naar een andere klant verplaatst | `invoices:read` | SSE + webhook |
| [`invoice:paid`](#invoice-paid) | Factuur betaald | `invoices:read` | SSE + webhook |
| [`invoice:updated`](#invoice-updated) | Factuur gewijzigd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:created`](#ledgeropeningbalance-created) | Beginsaldo toegevoegd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:deleted`](#ledgeropeningbalance-deleted) | Beginsaldo verwijderd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:updated`](#ledgeropeningbalance-updated) | Beginsaldo gewijzigd | `invoices:read` | SSE + webhook |
| [`mandate-agreement:activated`](#mandate-agreement-activated) | Mandaat actief | `payments:read` | SSE + webhook |
| [`mandate-agreement:expired`](#mandate-agreement-expired) | Mandaataanvraag verlopen | `payments:read` | SSE + webhook |
| [`mandate-agreement:failed`](#mandate-agreement-failed) | Mandaat geweigerd | `payments:read` | SSE + webhook |
| [`mandate-agreement:signed`](#mandate-agreement-signed) | Mandaat ondertekend | `payments:read` | SSE + webhook |
| [`mandate-agreement:updated`](#mandate-agreement-updated) | Mandaataanvraag gewijzigd | `payments:read` | SSE + webhook |
| [`mandate:created`](#mandate-created) | Mandaat aangemaakt | `payments:read` | SSE + webhook |
| [`mandate:deleted`](#mandate-deleted) | Mandaat verwijderd | `payments:read` | SSE + webhook |
| [`mandate:updated`](#mandate-updated) | Mandaat gewijzigd | `payments:read` | SSE + webhook |
| [`meter:created`](#meter-created) | Meter aangemaakt | `meters:read` | SSE + webhook |
| [`meter:updated`](#meter-updated) | Meter gewijzigd | `meters:read` | SSE + webhook |
| [`meterAnomaly:detected`](#meteranomaly-detected) | Meterafwijking vastgesteld | `meters:read` | SSE + webhook |
| [`meterAnomaly:resolved`](#meteranomaly-resolved) | Meterafwijking opgelost | `meters:read` | SSE + webhook |
| [`meterConsumptionBatch:created`](#meterconsumptionbatch-created) | Verbruiksperiode gestart | `meters:read` | SSE + webhook |
| [`meterConsumptionBatch:updated`](#meterconsumptionbatch-updated) | Verbruiksperiode gewijzigd | `meters:read` | SSE + webhook |
| [`meterReading:created`](#meterreading-created) | Meterstand ingevoerd | `meters:read` | SSE + webhook |
| [`meterReading:deleted`](#meterreading-deleted) | Meterstand verwijderd | `meters:read` | SSE + webhook |
| [`meterReading:synced`](#meterreading-synced) | Meterstand gesynchroniseerd | `meters:read` | SSE + webhook |
| [`meterReading:updated`](#meterreading-updated) | Meterstand gewijzigd | `meters:read` | SSE + webhook |
| [`nativeDevice:command`](#nativedevice-command) |  | `native-devices:read` | SSE, geen webhook |
| [`nativeDevice:config`](#nativedevice-config) |  | `native-devices:read` | SSE, geen webhook |
| [`nativeDevice:deleted`](#nativedevice-deleted) | Tablet of kiosk verwijderd | `native-devices:read` | SSE + webhook |
| [`nfc-tag-transaction:changed`](#nfc-tag-transaction-changed) | NFC-tagtransactie gewijzigd | `nfc-tag-transactions:read` | SSE + webhook |
| [`nfc-tag:blocked`](#nfc-tag-blocked) | NFC-tag geblokkeerd | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:presented`](#nfc-tag-presented) | NFC-tag aangeboden | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:unblocked`](#nfc-tag-unblocked) | NFC-tag gedeblokkeerd | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:updated`](#nfc-tag-updated) | NFC-tag gewijzigd | `nfc-tags:read` | SSE + webhook |
| [`notification-delivery:deleted`](#notification-delivery-deleted) | Melding verwijderd | `notifications:deliveries:read` | SSE + webhook |
| [`notification-delivery:updated`](#notification-delivery-updated) | Status van melding gewijzigd | `notifications:deliveries:read` | SSE + webhook |
| [`notificationInbox:created`](#notificationinbox-created) |  | elk lid | SSE, geen webhook |
| [`notificationInbox:read`](#notificationinbox-read) |  | elk lid | SSE, geen webhook |
| [`occupation:ended`](#occupation-ended) | Bezetting beëindigd | `terrains:read` | SSE + webhook |
| [`organizationSettings:updated`](#organizationsettings-updated) | Instellingen gewijzigd | `organization:settings:read` of `organization:settings:write` | SSE + webhook |
| [`payment-group:assigned-to-invoice`](#payment-group-assigned-to-invoice) | Betalingsgroep gekoppeld aan een factuur | `payments:read` | SSE + webhook |
| [`payment-group:created`](#payment-group-created) | Betalingsgroep aangemaakt | `payments:read` | SSE + webhook |
| [`payment-group:deleted`](#payment-group-deleted) | Betalingsgroep verwijderd | `payments:read` | SSE + webhook |
| [`payment-group:payments-added`](#payment-group-payments-added) | Betalingen toegevoegd aan een groep | `payments:read` | SSE + webhook |
| [`payment-group:payments-removed`](#payment-group-payments-removed) | Betalingen verwijderd uit een groep | `payments:read` | SSE + webhook |
| [`payment-group:unassigned-from-invoice`](#payment-group-unassigned-from-invoice) | Betalingsgroep ontkoppeld van een factuur | `payments:read` | SSE + webhook |
| [`payment-group:updated`](#payment-group-updated) | Betalingsgroep gewijzigd | `payments:read` | SSE + webhook |
| [`payment-report:created`](#payment-report-created) | Betalingsrapport aangemaakt | `payment-reports:read` | SSE + webhook |
| [`payment-report:updated`](#payment-report-updated) | Betalingsrapport gewijzigd | `payment-reports:read` | SSE + webhook |
| [`payment:created`](#payment-created) | Betaling aangemaakt | `payments:read` | SSE + webhook |
| [`payment:deleted`](#payment-deleted) | Betaling verwijderd | `payments:read` | SSE + webhook |
| [`payment:updated`](#payment-updated) | Betaling gewijzigd | `payments:read` | SSE + webhook |
| [`pdf:clear-tablet`](#pdf-clear-tablet) | Pdf gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`pdf:to-tablet`](#pdf-to-tablet) | Pdf naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`print-queue-job:updated`](#print-queue-job-updated) | Printopdracht gewijzigd | `printing:read` | SSE + webhook |
| [`product:created`](#product-created) | Product aangemaakt | `products:read` | SSE + webhook |
| [`product:deleted`](#product-deleted) | Product verwijderd | `products:read` | SSE + webhook |
| [`product:updated`](#product-updated) | Product gewijzigd | `products:read` | SSE + webhook |
| [`productPriceChange:applied`](#productpricechange-applied) | Geplande productprijs toegepast | `products:read` | SSE + webhook |
| [`productPriceChange:created`](#productpricechange-created) | Productprijs gepland | `products:read` | SSE + webhook |
| [`productPriceChange:deleted`](#productpricechange-deleted) | Geplande productprijs verwijderd | `products:read` | SSE + webhook |
| [`reservation:created`](#reservation-created) | Reservering aangemaakt | `reservations:read` | SSE + webhook |
| [`reservation:updated`](#reservation-updated) | Reservering gewijzigd | `reservations:read` | SSE + webhook |
| [`sign:clear-tablet`](#sign-clear-tablet) | Ondertekening gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`sign:to-tablet`](#sign-to-tablet) | Ondertekening naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`signatureRequest:completed`](#signaturerequest-completed) | Ondertekenverzoek afgerond | `signature-requests:read` | SSE + webhook |
| [`signatureRequest:deleted`](#signaturerequest-deleted) | Ondertekenverzoek verwijderd | `signature-requests:read` | SSE + webhook |
| [`signatureRequest:updated`](#signaturerequest-updated) | Ondertekenverzoek gewijzigd | `signature-requests:read` | SSE + webhook |
| [`task-time-tracker:changed`](#task-time-tracker-changed) |  | `tasks:read` | SSE, geen webhook |
| [`task-view:created`](#task-view-created) | Takenweergave aangemaakt | `tasks:read` | SSE + webhook |
| [`task-view:deleted`](#task-view-deleted) | Takenweergave verwijderd | `tasks:read` | SSE + webhook |
| [`task-view:membership-changed`](#task-view-membership-changed) | Taken in een weergave gewijzigd | `tasks:read` | SSE + webhook |
| [`task-view:updated`](#task-view-updated) | Takenweergave gewijzigd | `tasks:read` | SSE + webhook |
| [`task:action-chosen`](#task-action-chosen) | Taakactie gekozen | `tasks:read` | SSE + webhook |
| [`task:assigned`](#task-assigned) | Taak toegewezen | `tasks:read` | SSE + webhook |
| [`task:created`](#task-created) | Taak aangemaakt | `tasks:read` | SSE + webhook |
| [`task:deleted`](#task-deleted) | Taak verwijderd | `tasks:read` | SSE + webhook |
| [`task:status-changed`](#task-status-changed) | Taakstatus gewijzigd | `tasks:read` | SSE + webhook |
| [`task:unassigned`](#task-unassigned) | Taaktoewijzing opgeheven | `tasks:read` | SSE + webhook |
| [`task:updated`](#task-updated) | Taak gewijzigd | `tasks:read` | SSE + webhook |
| [`terrain:updated`](#terrain-updated) | Terrein gewijzigd | `terrains:read` | SSE + webhook |
| [`vehiclePresence:updated`](#vehiclepresence-updated) |  | `access-control:read` | SSE, geen webhook |

## accessLogEntry [#accesslogentry]

### `accessLogEntry:coupled` [#accesslogentry-coupled]

Toegangslogregel gekoppeld.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessLogEntry:coupled",
  "data": {
    "nfcQrEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lprEntryId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `accessLogEntry:processed` [#accesslogentry-processed]

Toegangslogregel verwerkt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessLogEntry:processed",
  "data": {
    "organizationId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## accessMethod [#accessmethod]

### `accessMethod:created` [#accessmethod-created]

Toegangsmethode aangemaakt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessMethod:deleted` [#accessmethod-deleted]

Toegangsmethode verwijderd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessMethod:updated` [#accessmethod-updated]

Toegangsmethode gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## accessMethodOperation [#accessmethodoperation]

### `accessMethodOperation:created` [#accessmethodoperation-created]

Bewerking op toegangsmethode gestart.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `accessMethodOperation:updated` [#accessmethodoperation-updated]

Bewerking op toegangsmethode gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethodOperation:updated",
  "data": {
    "operationId": "cm4k7x2pq0001abcd1234efgh",
    "status": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

## accessPoint [#accesspoint]

### `accessPoint:created` [#accesspoint-created]

Toegangspunt aangemaakt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:deleted` [#accesspoint-deleted]

Toegangspunt verwijderd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:openTooLong` [#accesspoint-opentoolong]

Toegangspunt te lang open.

- **Permissie:** `access-control:access-point-open:alert`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:openTooLong",
  "data": {
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "accessPointName": "Voorbeeld",
    "openSince": "2026-01-15T09:30:00.000Z",
    "afterMinutes": 12.5
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:physicalStateChanged` [#accesspoint-physicalstatechanged]

- **Permissie:** `access-control:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:physicalStateChanged",
  "data": {
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "state": "OPEN",
    "previousState": "OPEN",
    "changedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:updated` [#accesspoint-updated]

Toegangspunt gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## bankAccountTransaction [#bankaccounttransaction]

### `bankAccountTransaction:imported` [#bankaccounttransaction-imported]

Banktransactie geïmporteerd.

- **Permissie:** `bank-transactions:read` of `bank-transactions:sync`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "bankAccountTransaction:imported",
  "data": {
    "transactionsProcessed": 12.5,
    "accountsProcessed": 12.5
  }
}
```

</Accordion>
</Accordions>

## call [#call]

### `call:created` [#call-created]

Telefoongesprek gestart.

- **Permissie:** `calls:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "call:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "to": "Voorbeeld",
    "from": "Voorbeeld",
    "state": "CREATED",
    "direction": "INBOUND",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "duration": 1,
    "recordingS3Path": "Voorbeeld",
    "recordingStatus": "PENDING",
    "maybeCallerName": "Voorbeeld",
    "currentTranscriptionId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `call:updated` [#call-updated]

Telefoongesprek gewijzigd.

- **Permissie:** `calls:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "call:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "to": "Voorbeeld",
    "from": "Voorbeeld",
    "state": "CREATED",
    "direction": "INBOUND",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "duration": 1,
    "recordingS3Path": "Voorbeeld",
    "recordingStatus": "PENDING",
    "maybeCallerName": "Voorbeeld",
    "currentTranscriptionId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## comment [#comment]

### `comment:created` [#comment-created]

Opmerking toegevoegd.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:deleted` [#comment-deleted]

Opmerking verwijderd.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:mentioned` [#comment-mentioned]

Iemand genoemd in een opmerking.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:mentioned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:pinned` [#comment-pinned]

Opmerking vastgezet.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:pinned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:resolved` [#comment-resolved]

Opmerking opgelost.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:resolved",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:unresolved` [#comment-unresolved]

Opmerking heropend.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:unresolved",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:updated` [#comment-updated]

Opmerking bewerkt.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## controller [#controller]

### `controller:adoption:approved` [#controller-adoption-approved]

Adoptie van besturingseenheid goedgekeurd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:approved",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "controllerId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "organizationId": "cm4k7x2pq0001abcd1234efgh",
    "takeover": false
  }
}
```

</Accordion>
</Accordions>

### `controller:adoption:rejected` [#controller-adoption-rejected]

Adoptie van besturingseenheid afgewezen.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:rejected",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:adoption:requested` [#controller-adoption-requested]

Besturingseenheid vraagt om adoptie.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:requested",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "requestedFromIp": "Voorbeeld",
    "isNew": false
  }
}
```

</Accordion>
</Accordions>

### `controller:created` [#controller-created]

Besturingseenheid aangemaakt.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "publicKeyPem": "Voorbeeld",
    "model": "Voorbeeld",
    "type": "ACCESS",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "lastSeenAt": "2026-01-15T09:30:00.000Z",
    "lastSyncAt": "2026-01-15T09:30:00.000Z",
    "version": "Voorbeeld",
    "metadata": {},
    "commandManifest": {},
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:deleted` [#controller-deleted]

Besturingseenheid verwijderd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:input:changed` [#controller-input-changed]

Ingang van controller veranderd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:input:changed",
  "data": {
    "controller": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "efuseId": "cm4k7x2pq0001abcd1234efgh",
      "publicKeyPem": "Voorbeeld",
      "model": "Voorbeeld",
      "type": "ACCESS",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "lastSeenAt": "2026-01-15T09:30:00.000Z",
      "lastSyncAt": "2026-01-15T09:30:00.000Z",
      "version": "Voorbeeld",
      "metadata": {},
      "commandManifest": {},
      "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
      "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
    },
    "input": 12.5,
    "active": false
  }
}
```

</Accordion>
</Accordions>

### `controller:io:changed` [#controller-io-changed]

- **Permissie:** `controllers:read`
- **Levering:** SSE (`?channel=controller-io`), geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:io:changed",
  "data": {
    "controllerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:logs:submitted` [#controller-logs-submitted]

- **Permissie:** `controllers:logs`
- **Levering:** SSE (`?channel=controller-logs`), geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:logs:submitted",
  "data": {
    "controllerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:updated` [#controller-updated]

Besturingseenheid gewijzigd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "publicKeyPem": "Voorbeeld",
    "model": "Voorbeeld",
    "type": "ACCESS",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "lastSeenAt": "2026-01-15T09:30:00.000Z",
    "lastSyncAt": "2026-01-15T09:30:00.000Z",
    "version": "Voorbeeld",
    "metadata": {},
    "commandManifest": {},
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## customEnum [#customenum]

### `customEnum:created` [#customenum-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customEnum:deleted` [#customenum-deleted]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customEnum:updated` [#customenum-updated]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## customer [#customer]

### `customer:contact:created` [#customer-contact-created]

Contactpersoon toegevoegd aan een klant.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:contact:deleted` [#customer-contact-deleted]

Contactpersoon verwijderd bij een klant.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:contact:updated` [#customer-contact-updated]

Contactpersoon van klant gewijzigd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:created` [#customer-created]

Klant aangemaakt.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

### `customer:deleted` [#customer-deleted]

Klant verwijderd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

### `customer:updated` [#customer-updated]

Klant gewijzigd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

## customFieldDefinition [#customfielddefinition]

### `customFieldDefinition:created` [#customfielddefinition-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customFieldDefinition:deleted` [#customfielddefinition-deleted]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customFieldDefinition:updated` [#customfielddefinition-updated]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## document [#document]

### `document:created` [#document-created]

Document ontvangen.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

### `document:deleted` [#document-deleted]

Document verwijderd.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

### `document:updated` [#document-updated]

Document gewijzigd.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

## event-log [#event-log]

### `event-log:created` [#event-log-created]

Gebeurtenis gelogd.

- **Permissie:** `audit-logs:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "event-log:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "type": "INVOICE_CREATED",
    "metadata": {},
    "translationKey": "Voorbeeld",
    "translationData": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredById": "cm4k7x2pq0001abcd1234efgh",
    "userId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "occupationId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "meterReadingId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "organizationSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "organizationMembershipId": "cm4k7x2pq0001abcd1234efgh",
    "nativeDeviceId": "cm4k7x2pq0001abcd1234efgh",
    "oauthClientId": "cm4k7x2pq0001abcd1234efgh",
    "oauthConsentId": "cm4k7x2pq0001abcd1234efgh",
    "accessMethodId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "customerInvoicingSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "nfcTagId": "cm4k7x2pq0001abcd1234efgh",
    "identityDocumentScanId": "cm4k7x2pq0001abcd1234efgh",
    "documentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "signatureRequestId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerId": "cm4k7x2pq0001abcd1234efgh",
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "accessControllerId": "cm4k7x2pq0001abcd1234efgh",
    "organizationId": "cm4k7x2pq0001abcd1234efgh",
    "organizationInvitationId": "cm4k7x2pq0001abcd1234efgh",
    "apiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "integrationInstallationId": "cm4k7x2pq0001abcd1234efgh",
    "dpaAcceptanceId": "cm4k7x2pq0001abcd1234efgh",
    "webhookId": "cm4k7x2pq0001abcd1234efgh",
    "automationId": "cm4k7x2pq0001abcd1234efgh",
    "staffGroupId": "cm4k7x2pq0001abcd1234efgh",
    "terrainTypeId": "cm4k7x2pq0001abcd1234efgh",
    "meterCabinetId": "cm4k7x2pq0001abcd1234efgh",
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "customFieldDefinitionId": "cm4k7x2pq0001abcd1234efgh",
    "customEnumId": "cm4k7x2pq0001abcd1234efgh",
    "customerCommunicationSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "taskLabelId": "cm4k7x2pq0001abcd1234efgh",
    "inboxTagId": "cm4k7x2pq0001abcd1234efgh",
    "taskViewId": "cm4k7x2pq0001abcd1234efgh",
    "customerLedgerOpeningBalanceId": "cm4k7x2pq0001abcd1234efgh",
    "auditLogId": "cm4k7x2pq0001abcd1234efgh",
    "actorKind": "USER",
    "actorApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "actorOauthClientId": "cm4k7x2pq0001abcd1234efgh",
    "actorImpersonatedById": "cm4k7x2pq0001abcd1234efgh",
    "originKind": "Voorbeeld",
    "originId": "cm4k7x2pq0001abcd1234efgh",
    "ipAddress": "Voorbeeld",
    "userAgent": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## identityDocumentScan [#identitydocumentscan]

### `identityDocumentScan:completed` [#identitydocumentscan-completed]

ID-scan voltooid.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `identityDocumentScan:deleted` [#identitydocumentscan-deleted]

ID-scan verwijderd.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:deleted",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `identityDocumentScan:linked` [#identitydocumentscan-linked]

ID-scan gekoppeld aan een klant.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:linked",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `identityDocumentScan:pendingQueueChanged` [#identitydocumentscan-pendingqueuechanged]

Wachtrij voor ID-scans gewijzigd.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `identityDocumentScan:unlinked` [#identitydocumentscan-unlinked]

ID-scan ontkoppeld.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:unlinked",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## img [#img]

### `img:clear-tablet` [#img-clear-tablet]

Afbeelding gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `img:to-tablet` [#img-to-tablet]

Afbeelding naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "img:to-tablet",
  "data": {
    "imageUrl": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

## inbox [#inbox]

### `inbox:message-created` [#inbox-message-created]

Bericht ontvangen in de inbox.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:message-created",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "messageId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `inbox:participant-reaction` [#inbox-participant-reaction]

Reactie op een inboxbericht.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:participant-reaction",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "emoji": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `inbox:thread-updated` [#inbox-thread-updated]

Inboxgesprek gewijzigd.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:thread-updated",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `inbox:typing-changed` [#inbox-typing-changed]

- **Permissie:** `inbox:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:typing-changed",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "participantTyping": false,
    "staffTyping": false
  }
}
```

</Accordion>
</Accordions>

### `inbox:urgent-handoff` [#inbox-urgent-handoff]

Dringende overdracht door de assistent.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:urgent-handoff",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## integration-alarm [#integration-alarm]

### `integration-alarm:created` [#integration-alarm-created]

Meteralarm afgegaan.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "integration-alarm:created",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "alarm": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "externalId": "cm4k7x2pq0001abcd1234efgh",
      "message": "Voorbeeld",
      "startedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "metadata": {},
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "icyControllerId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `integration-alarm:resolved` [#integration-alarm-resolved]

Meteralarm opgelost.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "integration-alarm:resolved",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "alarm": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "externalId": "cm4k7x2pq0001abcd1234efgh",
      "message": "Voorbeeld",
      "startedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "metadata": {},
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "icyControllerId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

## invoice [#invoice]

### `invoice:created` [#invoice-created]

Factuur aangemaakt.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `invoice:deleted` [#invoice-deleted]

Factuur verwijderd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `invoice:moved-to-customer` [#invoice-moved-to-customer]

Factuur naar een andere klant verplaatst.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:moved-to-customer",
  "data": {
    "invoice": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "displayId": "2026-00123",
      "status": "DRAFT",
      "type": "INVOICE",
      "paymentStatus": "UNPAID",
      "invoiceDate": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "paidDate": "2026-01-15T09:30:00.000Z",
      "amountSubtotal": 12.5,
      "amountTax": 12.5,
      "amountPaid": 12.5,
      "amountTotal": 12.5,
      "amountOutstanding": 12.5,
      "note": "Voorbeeld",
      "internalNote": "Voorbeeld",
      "currency": "EUR",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "structuredCommunication": "Voorbeeld",
      "originalDisplayId": "2026-00123",
      "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
      "bookedById": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
      "excludeFromAutomatedReminders": false,
      "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
      "peppolProvider": "SCRADA",
      "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
      "peppolUblFolder": "Voorbeeld",
      "peppolUblKey": "Voorbeeld"
    },
    "priorCustomerId": "cm4k7x2pq0001abcd1234efgh",
    "targetCustomerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `invoice:paid` [#invoice-paid]

Factuur betaald.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "displayId": "2026-00123",
      "status": "DRAFT",
      "type": "INVOICE",
      "paymentStatus": "UNPAID",
      "invoiceDate": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "paidDate": "2026-01-15T09:30:00.000Z",
      "amountSubtotal": 12.5,
      "amountTax": 12.5,
      "amountPaid": 12.5,
      "amountTotal": 12.5,
      "amountOutstanding": 12.5,
      "note": "Voorbeeld",
      "internalNote": "Voorbeeld",
      "currency": "EUR",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "structuredCommunication": "Voorbeeld",
      "originalDisplayId": "2026-00123",
      "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
      "bookedById": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
      "excludeFromAutomatedReminders": false,
      "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
      "peppolProvider": "SCRADA",
      "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
      "peppolUblFolder": "Voorbeeld",
      "peppolUblKey": "Voorbeeld"
    },
    "payment": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "amount": 12.5,
      "amountRefunded": 12.5,
      "amountRemaining": 12.5,
      "currency": "EUR",
      "description": "Voorbeeld",
      "reference": "Voorbeeld",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "expiresAt": "2026-01-15T09:30:00.000Z",
      "paidAt": "2026-01-15T09:30:00.000Z",
      "delayUntil": "2026-01-15T09:30:00.000Z",
      "errorMessage": "Voorbeeld",
      "errorMessageTranslationKey": "Voorbeeld",
      "status": "PENDING",
      "method": "UNKNOWN",
      "channel": "MANUAL",
      "provider": "MOLLIE",
      "channelInfo": {},
      "accountingSoftwareProvider": "ADMISOL",
      "accountingSoftwareMetadata": {},
      "createdById": "cm4k7x2pq0001abcd1234efgh",
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
      "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
    }
  }
}
```

</Accordion>
</Accordions>

### `invoice:updated` [#invoice-updated]

Factuur gewijzigd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

## ledgerOpeningBalance [#ledgeropeningbalance]

### `ledgerOpeningBalance:created` [#ledgeropeningbalance-created]

Beginsaldo toegevoegd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

### `ledgerOpeningBalance:deleted` [#ledgeropeningbalance-deleted]

Beginsaldo verwijderd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

### `ledgerOpeningBalance:updated` [#ledgeropeningbalance-updated]

Beginsaldo gewijzigd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

## mandate-agreement [#mandate-agreement]

### `mandate-agreement:activated` [#mandate-agreement-activated]

Mandaat actief.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:activated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:expired` [#mandate-agreement-expired]

Mandaataanvraag verlopen.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:expired",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:failed` [#mandate-agreement-failed]

Mandaat geweigerd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:failed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:signed` [#mandate-agreement-signed]

Mandaat ondertekend.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:signed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:updated` [#mandate-agreement-updated]

Mandaataanvraag gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## mandate [#mandate]

### `mandate:created` [#mandate-created]

Mandaat aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `mandate:deleted` [#mandate-deleted]

Mandaat verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `mandate:updated` [#mandate-updated]

Mandaat gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## meter [#meter]

### `meter:created` [#meter-created]

Meter aangemaakt.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `meter:updated` [#meter-updated]

Meter gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## meterAnomaly [#meteranomaly]

### `meterAnomaly:detected` [#meteranomaly-detected]

Meterafwijking vastgesteld.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterAnomaly:detected",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "anomaly": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "kind": "FLAT_WHILE_PRESENT",
      "detectedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "flatSince": "2026-01-15T09:30:00.000Z",
      "lastReadingAt": "2026-01-15T09:30:00.000Z",
      "lastReadingValue": 12.5,
      "presenceDays": 1,
      "expectedConsumption": 12.5,
      "observedConsumption": 12.5,
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `meterAnomaly:resolved` [#meteranomaly-resolved]

Meterafwijking opgelost.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterAnomaly:resolved",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "anomaly": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "kind": "FLAT_WHILE_PRESENT",
      "detectedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "flatSince": "2026-01-15T09:30:00.000Z",
      "lastReadingAt": "2026-01-15T09:30:00.000Z",
      "lastReadingValue": 12.5,
      "presenceDays": 1,
      "expectedConsumption": 12.5,
      "observedConsumption": 12.5,
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

## meterConsumptionBatch [#meterconsumptionbatch]

### `meterConsumptionBatch:created` [#meterconsumptionbatch-created]

Verbruiksperiode gestart.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterConsumptionBatch:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "startReadingId": "cm4k7x2pq0001abcd1234efgh",
    "endReadingId": "cm4k7x2pq0001abcd1234efgh",
    "consumption": 12.5,
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "closed": false,
    "invoiced": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `meterConsumptionBatch:updated` [#meterconsumptionbatch-updated]

Verbruiksperiode gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterConsumptionBatch:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "startReadingId": "cm4k7x2pq0001abcd1234efgh",
    "endReadingId": "cm4k7x2pq0001abcd1234efgh",
    "consumption": 12.5,
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "closed": false,
    "invoiced": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## meterReading [#meterreading]

### `meterReading:created` [#meterreading-created]

Meterstand ingevoerd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:deleted` [#meterreading-deleted]

Meterstand verwijderd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:synced` [#meterreading-synced]

Meterstand gesynchroniseerd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:synced",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:updated` [#meterreading-updated]

Meterstand gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## nativeDevice [#nativedevice]

### `nativeDevice:command` [#nativedevice-command]

- **Permissie:** `native-devices:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nativeDevice:command",
  "data": {
    "installationId": "cm4k7x2pq0001abcd1234efgh",
    "url": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

### `nativeDevice:config` [#nativedevice-config]

- **Permissie:** `native-devices:read`
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `nativeDevice:deleted` [#nativedevice-deleted]

Tablet of kiosk verwijderd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nativeDevice:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## nfc-tag-transaction [#nfc-tag-transaction]

### `nfc-tag-transaction:changed` [#nfc-tag-transaction-changed]

NFC-tagtransactie gewijzigd.

- **Permissie:** `nfc-tag-transactions:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag-transaction:changed",
  "data": {
    "transactionId": "cm4k7x2pq0001abcd1234efgh",
    "nfcTagId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING"
  }
}
```

</Accordion>
</Accordions>

## nfc-tag [#nfc-tag]

### `nfc-tag:blocked` [#nfc-tag-blocked]

NFC-tag geblokkeerd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:blocked",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:presented` [#nfc-tag-presented]

NFC-tag aangeboden.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:presented",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:unblocked` [#nfc-tag-unblocked]

NFC-tag gedeblokkeerd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:unblocked",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:updated` [#nfc-tag-updated]

NFC-tag gewijzigd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## notification-delivery [#notification-delivery]

### `notification-delivery:deleted` [#notification-delivery-deleted]

Melding verwijderd.

- **Permissie:** `notifications:deliveries:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notification-delivery:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "notificationName": "Voorbeeld",
    "metadata": {},
    "source": "INTERNAL",
    "externalSource": "Voorbeeld",
    "externalReference": "Voorbeeld",
    "createdByApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "createdByApiKeyName": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredByUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientReadAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `notification-delivery:updated` [#notification-delivery-updated]

Status van melding gewijzigd.

- **Permissie:** `notifications:deliveries:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notification-delivery:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "notificationName": "Voorbeeld",
    "metadata": {},
    "source": "INTERNAL",
    "externalSource": "Voorbeeld",
    "externalReference": "Voorbeeld",
    "createdByApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "createdByApiKeyName": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredByUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientReadAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## notificationInbox [#notificationinbox]

### `notificationInbox:created` [#notificationinbox-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notificationInbox:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "title": "Voorbeeld",
    "body": "Voorbeeld",
    "url": "https://example.com",
    "urgent": false,
    "hasEmail": false,
    "readAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `notificationInbox:read` [#notificationinbox-read]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notificationInbox:read",
  "data": {
    "readAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## occupation [#occupation]

### `occupation:ended` [#occupation-ended]

Bezetting beëindigd.

- **Permissie:** `terrains:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "occupation:ended",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "occupationType": "OWN_ACCOMMODATION",
    "rentPeriod": {},
    "price": 12.5,
    "description": "Voorbeeld",
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "invoicedUntil": "2026-01-15T09:30:00.000Z",
    "customFields": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## organizationSettings [#organizationsettings]

### `organizationSettings:updated` [#organizationsettings-updated]

Instellingen gewijzigd.

- **Permissie:** `organization:settings:read` of `organization:settings:write`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": false
  }
}
```

</Accordion>
</Accordions>

## payment-group [#payment-group]

### `payment-group:assigned-to-invoice` [#payment-group-assigned-to-invoice]

Betalingsgroep gekoppeld aan een factuur.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:assigned-to-invoice",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    },
    "invoiceId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:created` [#payment-group-created]

Betalingsgroep aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "OPEN",
    "metadata": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "assignedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:deleted` [#payment-group-deleted]

Betalingsgroep verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:payments-added` [#payment-group-payments-added]

Betalingen toegevoegd aan een groep.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:payments-added",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `payment-group:payments-removed` [#payment-group-payments-removed]

Betalingen verwijderd uit een groep.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:payments-removed",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `payment-group:unassigned-from-invoice` [#payment-group-unassigned-from-invoice]

Betalingsgroep ontkoppeld van een factuur.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:unassigned-from-invoice",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    },
    "previousInvoiceId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:updated` [#payment-group-updated]

Betalingsgroep gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "OPEN",
    "metadata": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "assignedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## payment-report [#payment-report]

### `payment-report:created` [#payment-report-created]

Betalingsrapport aangemaakt.

- **Permissie:** `payment-reports:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-report:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "reportDate": "2026-01-15T09:30:00.000Z",
    "status": "CONCEPT",
    "totalAmount": 12.5,
    "paymentCount": 1,
    "mollieSettlementId": "cm4k7x2pq0001abcd1234efgh",
    "mollieSettlement": {},
    "metadata": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `payment-report:updated` [#payment-report-updated]

Betalingsrapport gewijzigd.

- **Permissie:** `payment-reports:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-report:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "reportDate": "2026-01-15T09:30:00.000Z",
    "status": "CONCEPT",
    "totalAmount": 12.5,
    "paymentCount": 1,
    "mollieSettlementId": "cm4k7x2pq0001abcd1234efgh",
    "mollieSettlement": {},
    "metadata": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## payment [#payment]

### `payment:created` [#payment-created]

Betaling aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment:deleted` [#payment-deleted]

Betaling verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment:updated` [#payment-updated]

Betaling gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## pdf [#pdf]

### `pdf:clear-tablet` [#pdf-clear-tablet]

Pdf gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `pdf:to-tablet` [#pdf-to-tablet]

Pdf naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "pdf:to-tablet",
  "data": {
    "pdfUrl": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

## print-queue-job [#print-queue-job]

### `print-queue-job:updated` [#print-queue-job-updated]

Printopdracht gewijzigd.

- **Permissie:** `printing:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "print-queue-job:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "type": "INVOICE_A4",
    "referenceId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "accessMethodId": "cm4k7x2pq0001abcd1234efgh",
    "identityDocumentScanId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "documentId": "cm4k7x2pq0001abcd1234efgh",
    "pdfUrl": "https://example.com",
    "scheduledAt": "2026-01-15T09:30:00.000Z",
    "attemptCount": 1,
    "lastError": "Voorbeeld",
    "claimedAt": "2026-01-15T09:30:00.000Z",
    "finishedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## product [#product]

### `product:created` [#product-created]

Product aangemaakt.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `product:deleted` [#product-deleted]

Product verwijderd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `product:updated` [#product-updated]

Product gewijzigd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## productPriceChange [#productpricechange]

### `productPriceChange:applied` [#productpricechange-applied]

Geplande productprijs toegepast.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:applied",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `productPriceChange:created` [#productpricechange-created]

Productprijs gepland.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `productPriceChange:deleted` [#productpricechange-deleted]

Geplande productprijs verwijderd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## reservation [#reservation]

### `reservation:created` [#reservation-created]

Reservering aangemaakt.

- **Permissie:** `reservations:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "reservation:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "BOOKED",
    "note": "Voorbeeld",
    "checkIn": "2026-01-15T09:30:00.000Z",
    "checkOut": "2026-01-15T09:30:00.000Z",
    "checkedInAt": "2026-01-15T09:30:00.000Z",
    "checkedOutAt": "2026-01-15T09:30:00.000Z",
    "canceledAt": "2026-01-15T09:30:00.000Z",
    "numberOfToddlers": 1,
    "numberOfChildren": 1,
    "numberOfAdults": 1,
    "numberOfAnimals": 1,
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "preferredTerrainId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "customFields": {},
    "allowOnlinePayments": false,
    "sendConfirmationEmails": false
  }
}
```

</Accordion>
</Accordions>

### `reservation:updated` [#reservation-updated]

Reservering gewijzigd.

- **Permissie:** `reservations:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "reservation:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "BOOKED",
    "note": "Voorbeeld",
    "checkIn": "2026-01-15T09:30:00.000Z",
    "checkOut": "2026-01-15T09:30:00.000Z",
    "checkedInAt": "2026-01-15T09:30:00.000Z",
    "checkedOutAt": "2026-01-15T09:30:00.000Z",
    "canceledAt": "2026-01-15T09:30:00.000Z",
    "numberOfToddlers": 1,
    "numberOfChildren": 1,
    "numberOfAdults": 1,
    "numberOfAnimals": 1,
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "preferredTerrainId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "customFields": {},
    "allowOnlinePayments": false,
    "sendConfirmationEmails": false
  }
}
```

</Accordion>
</Accordions>

## sign [#sign]

### `sign:clear-tablet` [#sign-clear-tablet]

Ondertekening gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `sign:to-tablet` [#sign-to-tablet]

Ondertekening naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## signatureRequest [#signaturerequest]

### `signatureRequest:completed` [#signaturerequest-completed]

Ondertekenverzoek afgerond.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:completed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `signatureRequest:deleted` [#signaturerequest-deleted]

Ondertekenverzoek verwijderd.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `signatureRequest:updated` [#signaturerequest-updated]

Ondertekenverzoek gewijzigd.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task-time-tracker [#task-time-tracker]

### `task-time-tracker:changed` [#task-time-tracker-changed]

- **Permissie:** `tasks:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-time-tracker:changed",
  "data": {
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "previousTaskId": "cm4k7x2pq0001abcd1234efgh",
    "cleared": false,
    "id": "cm4k7x2pq0001abcd1234efgh",
    "userId": "cm4k7x2pq0001abcd1234efgh",
    "note": "Voorbeeld",
    "accumulatedMs": 12.5,
    "runningSince": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task-view [#task-view]

### `task-view:created` [#task-view-created]

Takenweergave aangemaakt.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `task-view:deleted` [#task-view-deleted]

Takenweergave verwijderd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `task-view:membership-changed` [#task-view-membership-changed]

Taken in een weergave gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:membership-changed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task-view:updated` [#task-view-updated]

Takenweergave gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task [#task]

### `task:action-chosen` [#task-action-chosen]

Taakactie gekozen.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:action-chosen",
  "data": {
    "task": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "PENDING",
      "priority": "LOW",
      "sortOrder": 1,
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "completedAt": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "remindAt": "2026-01-15T09:30:00.000Z",
      "reminderSentAt": "2026-01-15T09:30:00.000Z",
      "remindByEmail": false,
      "remindByPush": false,
      "remindRrule": "Voorbeeld",
      "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
      "commentId": "cm4k7x2pq0001abcd1234efgh",
      "parentId": "cm4k7x2pq0001abcd1234efgh",
      "metadata": {},
      "customFields": {},
      "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
      "actionChosenAt": "2026-01-15T09:30:00.000Z",
      "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
      "actionNote": "Voorbeeld",
      "completionLocked": false,
      "createdById": "cm4k7x2pq0001abcd1234efgh"
    },
    "action": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "taskId": "cm4k7x2pq0001abcd1234efgh",
      "label": "Voorbeeld",
      "color": "Voorbeeld",
      "icon": "Voorbeeld",
      "position": 1,
      "key": "Voorbeeld",
      "requiresNote": false,
      "requiresConfirmation": false,
      "confirmTitle": "Voorbeeld",
      "confirmDescription": "Voorbeeld",
      "confirmLevel": "Voorbeeld",
      "automationId": "cm4k7x2pq0001abcd1234efgh"
    },
    "note": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `task:assigned` [#task-assigned]

Taak toegewezen.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:assigned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:created` [#task-created]

Taak aangemaakt.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:deleted` [#task-deleted]

Taak verwijderd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:status-changed` [#task-status-changed]

Taakstatus gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:status-changed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:unassigned` [#task-unassigned]

Taaktoewijzing opgeheven.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:unassigned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:updated` [#task-updated]

Taak gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## terrain [#terrain]

### `terrain:updated` [#terrain-updated]

Terrein gewijzigd.

- **Permissie:** `terrains:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "terrain:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "bookable": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "geoJson": {},
    "surfaceArea": 12.5,
    "metadata": {},
    "customFields": {},
    "calculatedTariff": {},
    "terrainTypeId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## vehiclePresence [#vehiclepresence]

### `vehiclePresence:updated` [#vehiclepresence-updated]

- **Permissie:** `access-control:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "vehiclePresence:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "plate": "Voorbeeld",
    "status": "INSIDE",
    "lastSeenAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>


# Notifiche esterne (/it-IT/ontwikkelaars/externe-notificaties)

Il tuo sistema invia da sé e-mail ai clienti (newsletter, conferma di prenotazione, promemoria)? Registrale allora in Tillor. Il personale le vede nella scheda del cliente, sulla fattura e nel riepilogo **Notifiche**, accanto alle notifiche che Tillor invia in prima persona.

Tillor **non invia nulla**: registri un messaggio già spedito. Nell'app le notifiche esterne portano sempre l'etichetta **Esterna** con il nome della tua origine, così non passano mai per una notifica di Tillor.

## Accesso [#toegang]

L'utente dietro la [chiave API](/ontwikkelaars/http) ha bisogno di uno di questi permessi nell'organizzazione. Un amministratore li assegna nei permessi utente dell'organizzazione, nel gruppo **Notifiche** (**Registrare notifiche esterne** e **Gestire le notifiche esterne di altri**).

| Permesso | Cosa puoi fare |
|-----------|------------|
| `notifications:external:write` | Registrare notifiche e aggiornare o eliminare le registrazioni **proprie** |
| `notifications:external:manage-others` | Aggiornare o eliminare anche le registrazioni di altri utenti o integrazioni |

<Callout type="info" title="Un utente per integrazione">
La proprietà dipende dall'utente della chiave API. Usa per ogni integrazione un utente (di servizio) proprio, così un'integrazione non potrà mai modificare le notifiche dell'altra.
</Callout>

## Endpoint [#endpoints]

Tutti i percorsi sono sotto `/api/orgs/:orgId`. Schemi esatti: [OpenAPI](https://tillor.eu/api/openapi.json), tag `notifications`.

| Method | Percorso | Descrizione |
|--------|-----|--------------|
| POST | `/notifications/external` | Registrare una notifica |
| PATCH | `/notifications/external/{id}` | Aggiornare stato, orari o contenuto |
| DELETE | `/notifications/external/{id}` | Eliminare definitivamente |
| GET | `/notifications?source=EXTERNAL` | Elencare le notifiche registrate (filtra anche per `externalSource`, `externalReference`, `customerId`, `invoiceId`) |
| GET | `/notifications/{id}` | Recuperare una notifica |

Le notifiche che Tillor ha inviato da sé non puoi modificarle né eliminarle tramite questi endpoint; danno `404`.

## Registrare [#registreren]

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/notifications/external" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "externalSource": "mailchimp",
    "externalReference": "campaign-42:member-9f3a",
    "name": "Boekingsbevestiging",
    "customerId": "clx789...",
    "channel": "EMAIL",
    "status": "SENT",
    "sentAt": "2026-09-19T08:15:00Z",
    "email": {
      "to": "jan@voorbeeld.nl",
      "from": "Recreatiepark Het Meer <info@recreatiepark-het-meer.be>",
      "subject": "Je boeking is bevestigd",
      "htmlBody": "<p>Dag Jan, ...</p>",
      "attachments": [{ "filename": "bevestiging.pdf", "contentType": "application/pdf", "size": 48211 }]
    }
  }'
```

Tutti i campi e i limiti sono in [OpenAPI](https://tillor.eu/api/openapi.json). Questi campi hanno regole che devi conoscere in anticipo:

| Campo | Regola |
|------|-------|
| `externalSource` | Nome del tuo sistema in minuscolo, cifre, `.`, `_` o `-` (es. `mailchimp`). Il personale vede questo nome presso la notifica |
| `externalReference` | Il tuo ID per questo messaggio, univoco all'interno di `externalSource` |
| `name` | Breve etichetta per il personale (es. "Boekingsbevestiging"). Si può cercare per questo |
| `customerId` / `invoiceId` | Almeno uno dei due. Determina dove compare la notifica. Se invii solo `invoiceId`, Tillor collega anche il cliente di quella fattura. Un ID sconosciuto, o una fattura di un altro cliente, dà `400` |
| `status` | `SENT`, `FAILED`, `BOUNCED` o `COMPLAINED`. Senza `sentAt` con `SENT` Tillor usa il momento della registrazione |
| `sentAt`, `readAt`, `clickedAt` | ISO 8601 con fuso orario, es. `2026-09-19T08:15:00Z`. Altri valori vengono rifiutati |
| `email.attachments` | Solo metadati (`filename`, `contentType`, `size`). I file in sé non vengono salvati |

### Riprovare in sicurezza [#veilig-opnieuw-proberen]

`POST` è idempotente su `externalSource` + `externalReference`. Se invii di nuovo la stessa combinazione (ad esempio dopo un time-out), ottieni la notifica **esistente** e non viene modificato nulla. Se vuoi cambiare qualcosa, usa `PATCH`.

<Callout type="warn" title="Nessun dato personale in externalReference o name">
`externalSource`, `externalReference` e `name` vengono salvati non cifrati perché vi si può cercare. Usa un ID tecnico, non un indirizzo e-mail o un nome. Un `externalReference` con `@` viene rifiutato. Destinatario, oggetto, contenuto e allegati vengono invece salvati cifrati.
</Callout>

## Aggiornare ed eliminare [#bijwerken-en-verwijderen]

Con `PATCH` invia solo i campi che cambiano, ad esempio quando un'e-mail rimbalza in seguito:

```bash
curl -X PATCH "https://tillor.eu/api/orgs/org_abc123/notifications/external/NOTIFICATION_ID" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "status": "BOUNCED", "errorMessage": "Mailbox bestaat niet" }'
```

`DELETE` elimina la notifica in modo definitivo, contenuto compreso. Usalo anche per soddisfare una richiesta di cancellazione (GDPR).

Un `PATCH` che non cambia nulla non fa nulla: nessuna modifica, nessun evento. Se modifichi il contenuto (etichetta, destinatario, mittente, oggetto, testo, HTML o allegati) o elimini una notifica, risulta nel registro attività del cliente o della fattura, con l'utente che l'ha fatto. Gli aggiornamenti di stato, `readAt` o `clickedAt` non vi compaiono, così puoi continuare a sincronizzare aperture e clic.

## HTML e privacy [#html-en-privacy]

Tillor mostra l'HTML al personale come lo ha ricevuto il cliente, ma lo tratta come contenuto non attendibile:

- Al salvataggio vengono rimossi script, moduli, iframe, embed e attributi di evento (`onclick`, ...). I link si aprono in una nuova scheda
- L'anteprima gira in un frame isolato senza script e senza accesso alla sessione di Tillor
- Immagini e caratteri esterni **non si caricano automaticamente**, così aprire una notifica non attiva un pixel di tracciamento. Il membro del personale può caricare le immagini per ogni notifica

Non contare quindi sul fatto che il tracciamento "aperto" nel tuo sistema scatti quando un membro del personale guarda la notifica.

## Cosa Tillor non fa con le notifiche esterne [#wat-tillor-niet-doet-met-externe-notificaties]

- Non le invia (di nuovo) né le ritenta automaticamente
- Non recupera aggiornamenti di stato dal tuo provider di posta: sei tu a tenere aggiornato lo stato con `PATCH`
- Non le conta negli elenchi **Notifiche non riuscite**, **Notifiche respinte** e **Notifiche in attesa** né nei contatori in cima al riepilogo delle notifiche, perché Tillor non può verificare il tuo stato. Compaiono invece sotto **Comunicazioni recenti**

## Webhook e SSE [#webhooks-en-sse]

| Evento | Quando |
|-------|-------|
| `notification-delivery:updated` | Alla registrazione e a ogni `PATCH` che cambia qualcosa. Contiene la notifica completa |
| `notification-delivery:deleted` | Con `DELETE`. Contiene solo `id`, `source`, `externalSource`, `externalReference`, `customerId` e `invoiceId` |

Il campo `source` è `EXTERNAL` per le tue registrazioni e `INTERNAL` per le notifiche di Tillor. Filtra su di esso se vuoi saltare i tuoi eventi. Vedi [Webhook](/ontwikkelaars/webhooks) e [SSE](/ontwikkelaars/sse).

## Correlati [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - Chiavi API, header e rate limit
- [Webhook](/ontwikkelaars/webhooks) - Ricevere eventi tramite HTTP POST
- [OpenAPI](https://tillor.eu/api/openapi.json) - Schemi completi


# API HTTP (/it-IT/ontwikkelaars/http)

L'API di Tillor è una REST API. Autenticati con una chiave API e invia gli header giusti a ogni richiesta. Le chiavi API sono **per account** - una chiave vale per tutte le organizzazioni a cui hai accesso.

## Riferimento API e OpenAPI [#api-referentie-en-openapi]

- **[Riferimento API](/api-referentie)** - Ogni endpoint con parametri ed esempi; prova le richieste direttamente nel browser
- **[Specifica OpenAPI](https://tillor.eu/api/openapi.json)** - Documentazione completa dell'API in formato JSON per la generazione di codice o l'importazione in Postman/Insomnia

---

## Chiavi API [#api-sleutels]

### Creare [#aanmaken]

Le chiavi API le crei nell'app Tillor dal menu utente in **Account > Chiavi API** (indicatore **1** = menu, indicatore **2** = Chiavi API nello screenshot). Puoi crearle anche tramite l'API con una sessione effettuata (senza chiave API). Vedi la [specifica OpenAPI](https://tillor.eu/api/openapi.json) sotto il tag `api-keys` per percorsi e schemi di richiesta e risposta.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Chiavi API nelle impostazioni dell'account" />

La chiave in chiaro viene restituita **una sola volta** alla creazione o alla rigenerazione. Conservala con cura; dopo non potrai più recuperarla.

### Limitare i permessi [#rechten-beperken]

Per impostazione predefinita una chiave può fare tutto ciò che puoi fare tu, in ogni organizzazione di cui sei membro. Nella finestra della chiave attiva **Limita alle autorizzazioni selezionate** e scegli i permessi di cui il collegamento ha bisogno, ad esempio solo la lettura delle fatture. Una chiave limitata ottiene in ogni organizzazione l'intersezione dei suoi permessi e della tua appartenenza lì: una chiave non può mai fare più di te. Una chiamata al di fuori dei permessi scelti riceve `403 Forbidden`, proprio come un utente senza quel permesso. Una modifica dei permessi vale entro un minuto. Tramite l'API: `scopes` (elenco di id di permessi come `invoices:read`, oppure `null` per tutto) alla creazione e all'aggiornamento di una chiave.

### Utilizzo [#gebruik]

Invia la chiave API nell'header `x-api-key`:

```http
x-api-key: tkn_xxx
```

Le chiavi usano il prefisso `tkn_`. Negli endpoint dell'organizzazione l'ID dell'organizzazione è nel percorso (`/orgs/org_abc123/...`); non serve un header a parte.

### Rate limit [#rate-limits]

- **Predefinito:** 5000 richieste ogni 60 secondi per chiave
- In caso di superamento: `429 Too Many Requests` con `Retry-After`
- Ogni risposta con chiave API contiene gli header IETF `RateLimit-*`:

```http
RateLimit-Limit: 5000
RateLimit-Remaining: 4999
RateLimit-Reset: 58
RateLimit-Policy: 5000;w=60
```

`RateLimit-Reset` è il numero di secondi prima che la finestra attuale ricominci. I client browser possono leggere questi header tramite CORS (`Access-Control-Expose-Headers`).

### Sicurezza [#beveiliging]

<Callout type="warn" title="Attenzione">
- **Mai** esporre le chiavi API nel codice lato client o in repository pubblici
- Rigenera periodicamente le chiavi con **Rigenera** nell'app (OpenAPI: `POST /api/api-keys/:id/renew`)
- Elimina le chiavi inutilizzate con `DELETE /api/api-keys/:id`
</Callout>

---

## Base URL e contesto dell'organizzazione [#base-url-en-organisatie-context]

**Base URL:** `https://tillor.eu` (o l'URL del tuo deployment; OpenAPI indica `{APP_URL}/api`)

**Percorsi dell'organizzazione:** aggiungi l'ID dell'organizzazione nel percorso:

```
/api/orgs/:orgId/...
```

**Esempio:**

```
GET https://tillor.eu/api/orgs/org_abc123/customers
```

**Header richiesto per gli endpoint dell'organizzazione:** `x-api-key: tkn_xxx`. L'ID dell'organizzazione è nel percorso.

---

## Esempio: cURL [#voorbeeld-curl]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/customers" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json"
```

---

## Integrazioni (marketplace) [#integraties-marketplace]

Le integrazioni dell'organizzazione (prima "apps" nell'API) usano una risorsa per tipo sotto `/api/orgs/:orgId/integrations/{integrationType}`. I permessi richiesti sono `organization:integrations:read` e `organization:integrations:write` (sostituisce `organization:apps:*`).

| Method | Percorso | Descrizione |
|--------|------|-------------|
| GET | `/integrations/{integrationType}` | Stato (`installed`, `available`) e `settings` oscurate |
| POST | `/integrations/{integrationType}` | Installare (`settings` facoltative nel body; OAuth può restituire `redirectUrl`) |
| PUT | `/integrations/{integrationType}` | Aggiornare le impostazioni (`settings` nel body) |
| DELETE | `/integrations/{integrationType}` | Disinstallare |

Con `GET` e dopo `PUT`, `settings` contiene solo campi **pubblici** più, per ogni campo segreto, `{ configured: true }`. Password, chiavi API e token OAuth non vengono restituiti. Lascia vuoti i campi segreti con `PUT` per mantenere il valore esistente.

Vedi la [specifica OpenAPI](https://tillor.eu/api/openapi.json) (tag `integrations`) per gli schemi esatti.

---

## Correlati [#gerelateerd]

- [Riferimento API](/api-referentie) - Ogni endpoint, da provare nel browser
- [OpenAPI](https://tillor.eu/api/openapi.json) - Specifica API (JSON)
- [MCP](/ontwikkelaars/mcp) - Collegare Cursor, Claude, ChatGPT o Gemini tramite OAuth
- [Notifiche esterne](/ontwikkelaars/externe-notificaties) - Registra le e-mail inviate dal tuo sistema
- [Webhook](/ontwikkelaars/webhooks) - Ricevi eventi tramite HTTP POST
- [Webhook in ingresso di un'automazione](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Avvia un'automazione con una POST, senza chiave API
- [SSE](/ontwikkelaars/sse) - Ricevi eventi in streaming con Server-Sent Events
- [Esempi](/ontwikkelaars/voorbeelden) - Esempi di codice e di payload


# Panoramica (/it-IT/ontwikkelaars)

L'API di Tillor offre accesso programmatico ai dati della tua organizzazione. Usa le chiavi API per l'autenticazione, i webhook per gli eventi in uscita, SSE o MQTT per lo streaming in tempo reale, oppure MCP per collegare a Tillor strumenti AI come Cursor, Claude, ChatGPT e Gemini.

## Cosa puoi costruire? [#wat-kun-je-bouwen]

- **Integrazioni** - Collega Tillor ai tuoi sistemi tramite la REST API
- **Webhook** - Ricevi messaggi HTTP POST quando avvengono eventi (fattura pagata, cliente creato, ecc.)
- **Avviare automazioni** - Avvia un'automazione dal tuo sistema con una POST al suo [webhook in ingresso](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook)
- **Dashboard in tempo reale** - Ricevi eventi in streaming via SSE o MQTT per aggiornamenti live nella tua applicazione
- **Strumenti AI** - Lascia che Cursor, Claude, ChatGPT o Gemini richiamino l'API tramite [MCP](/ontwikkelaars/mcp) (`https://mcp.tillor.dev`)

## Per iniziare subito [#snel-aan-de-slag]

1. **Crea una chiave API** in Tillor sotto *Account > Chiavi API*
2. **Invia la chiave** nell'header `x-api-key` a ogni richiesta
3. **Metti l'ID della tua organizzazione nel percorso** degli endpoint dell'organizzazione: `/orgs/org_abc123/...`

<Callout type="info" title="Stessi eventi">
Webhook e SSE consegnano esattamente gli stessi eventi. La differenza: i webhook inviano una HTTP POST al tuo URL; SSE è una connessione lunga su cui ricevi gli eventi.
</Callout>

**Link utili:** [Riferimento API](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json)

**Ambito:** le chiavi API sono per account (tutte le organizzazioni); i webhook sono per organizzazione.

<Callout type="idea" title="Documentazione per strumenti AI">
Puoi usare questo sito anche come testo per strumenti AI: [`/llms.txt`](/llms.txt) (indice), [`/llms-full.txt`](/llms-full.txt) (tutte le pagine insieme), e per singola pagina aggiungendo `.mdx` al percorso (ad esempio [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **Chiedi all'AI (locale)** nel layout della documentazione carica quell'esportazione completa (`/llms-full.txt`) nell'AI integrata di Chrome, così non devi trovarti su una pagina specifica.
</Callout>

## Vedi anche [#zie-ook]

<Cards>
  <Card
    title="API HTTP"
    href="/ontwikkelaars/http"
    description="Chiavi API, autenticazione, base URL e contesto dell'organizzazione"
  />
  <Card
    title="MCP"
    href="/ontwikkelaars/mcp"
    description="Collega Cursor, Claude, ChatGPT o Gemini a Tillor tramite OAuth"
  />
  <Card
    title="Notifiche esterne"
    href="/ontwikkelaars/externe-notificaties"
    description="Registra le e-mail che il tuo sistema ha inviato ai clienti"
  />
  <Card
    title="Webhook"
    href="/ontwikkelaars/webhooks"
    description="Ricevi eventi tramite HTTP POST sul tuo endpoint"
  />
  <Card
    title="Automazioni"
    href="/ontwikkelaars/automatiseringen"
    description="Il messaggio webhook, la richiesta API, i webhook in ingresso e la struttura di un flusso"
  />
  <Card
    title="SSE"
    href="/ontwikkelaars/sse"
    description="Ricevi eventi in tempo reale con Server-Sent Events"
  />
  <Card
    title="MQTT"
    href="/ontwikkelaars/mqtt"
    description="Pub/sub via MQTT con accesso rigoroso ai topic e JWT o credenziali statiche"
  />
  <Card
    title="Metadati Mollie"
    href="/ontwikkelaars/mollie-metadata"
    description="Namespace tillor sui pagamenti Mollie"
  />
  <Card
    title="API chat del sito web"
    href="/ontwikkelaars/website-chat"
    description="Interfaccia di chat propria tramite REST e SSE"
  />
  <Card
    title="Esempi"
    href="/ontwikkelaars/voorbeelden"
    description="Esempi di codice e di payload per HTTP, webhook e SSE"
  />
</Cards>


# MCP (/it-IT/ontwikkelaars/mcp)

Con MCP (Model Context Protocol) strumenti come Cursor, Claude, ChatGPT e Gemini possono chiamare l'API di Tillor al posto tuo. Accedi una sola volta tramite OAuth; nella tua configurazione non deve comparire nessuna chiave API.

**URL:** `https://mcp.tillor.dev`

## Cosa puoi fare [#wat-je-ermee-kunt]

Dopo il collegamento, nello strumento di AI puoi:

1. Consultare le categorie API e gli endpoint (dalla specifica OpenAPI)
2. Chiamare gli endpoint con i tuoi diritti nell'organizzazione scelta

Il tutto passa dalla stessa API REST dell'[API HTTP](/ontwikkelaars/http). Ciò che puoi fare dipende dal tuo account Tillor e dai tuoi permessi in quell'organizzazione. Il collegamento tramite OAuth richiede il permesso **Autorizzare app OAuth** (`oauth:consent`) in almeno un'organizzazione. Senza questo permesso il consenso non riesce e i token OAuth esistenti smettono di funzionare.

## Autenticazione [#authenticatie]

1. Lo strumento si collega a `https://mcp.tillor.dev` senza token
2. Discovery e registrazione OAuth passano dall'host MCP; login e consenso avvengono su Tillor
3. Approvi l'accesso nel browser
4. Lo strumento invia poi un token Bearer con le chiamate MCP

Invia la tua organizzazione come header quando lo strumento lo supporta (Cursor, Gemini CLI):

```http
X-Tillor-Org-Id: org_abc123
```

Senza quell'header (ChatGPT, app Gemini, Claude) indichi `organizationId` in `call_api_endpoint`. Le route dell'organizzazione si trovano sotto `/orgs/{organizationId}`; l'API compila allora l'header da sola.

<Callout type="info" title="Nessuna chiave API necessaria">
Per il server MCP ospitato usi OAuth (Connect / Authorize nello strumento). Per script e integrazioni proprie continui a usare le [chiavi API](/ontwikkelaars/http).
</Callout>

## Collegamento [#koppelen]

Scegli il tuo strumento:

<McpProviderGuide />

Oppure apri il [selettore di installazione](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) per Cline, Zed, Warp, Codex e tutti gli altri.

## Strumenti [#tools]

| Strumento | Scopo |
|------|------|
| `list_api_categories` | Elenca le categorie API |
| `list_api_endpoints` | Endpoint di una categoria, con schema di input |
| `get_api_endpoint_schema` | Schema di un singolo endpoint per nome |
| `call_api_endpoint` | Chiama un endpoint |

I nomi degli endpoint non sono strumenti a sé: usa `call_api_endpoint`.

Il riferimento REST completo resta [OpenAPI](https://tillor.eu/api/openapi.json). MCP è un livello costruito sopra, non un'API di prodotto separata.

## Correlati [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - chiavi API, header e base URL
- [OpenAPI](https://tillor.eu/api/openapi.json) - specifica completa dell'API
- [Riferimento API](/api-referentie) - ogni endpoint, da provare nel browser


# Metadati Mollie (/it-IT/ontwikkelaars/mollie-metadata)

Mollie salva dei metadati per ogni pagamento. Tillor legge e scrive i campi nel namespace `tillor`. Collegamento nell'app: [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).

Tre tipi:

1. **Metadati di collegamento** - Tillor li riscrive su Mollie, così il pagamento è riconoscibile
2. **Suggerimenti di acquisizione** - li imposti tu quando crei il pagamento Mollie
3. **Metadati contabili diretti** - bypass da Tillor verso la contabilità

## Metadati di collegamento [#koppelingsmetadata]

```json
{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "clxgrp..."
  }
}
```

Tillor riscrive `paymentId`, `invoiceId`, `customerId` e `paymentGroupId` su Mollie non appena un pagamento è collegato a una fattura, a un cliente o a un [gruppo di pagamento](/betalingsverwerking/groepen). I metadati esistenti non provenienti da Tillor restano invariati.

| Campo | Descrizione |
|------|---------------|
| `paymentId` | Pagamento Tillor |
| `invoiceId` | Fattura Tillor |
| `customerId` | Cliente Tillor |
| `paymentGroupId` | Gruppo di pagamento, anche se il gruppo non è ancora collegato a una fattura |

## Suggerimento di acquisizione: `descriptionSuffix` [#ingestie-hint-descriptionsuffix]

Lo imposti tu quando crei il pagamento Mollie. Tillor lo usa per la descrizione del pagamento non appena esiste un collegamento a una fattura.

```json
{
  "tillor": {
    "descriptionSuffix": "Parkeerplaats P1"
  }
}
```

Formato in Tillor: `INV/XXXX/XXXX - {suffix}`.

## Suggerimenti di acquisizione per i gruppi di pagamento [#ingestie-hints-voor-betalingsgroepen]

Utile per i turni POS o le attività: raggruppa più pagamenti prima di registrare una fattura.

```json
{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}
```

Basta uno dei due campi. Meglio usarli entrambi se l'etichetta può cambiare ma l'ID resta stabile.

| Campo | Descrizione |
|------|---------------|
| `paymentGroupName` | Etichetta visibile in Tillor. Corrisponde ai gruppi aperti esistenti per nome, oppure diventa l'etichetta di un nuovo gruppo |
| `paymentGroupExternalId` | Chiave stabile del tuo sistema. La corrispondenza avviene su questa invece che sul nome; l'etichetta segue `paymentGroupName` |

1. Tillor cerca un gruppo **aperto** con questo ID esterno (o, senza ID, con questo nome).
2. Nessuna corrispondenza? Nuovo gruppo aperto. Il nome è `paymentGroupName`, altrimenti `paymentGroupExternalId`.
3. Il pagamento entra nel gruppo non appena in Tillor risulta **pagato**.
4. I gruppi già collegati a una fattura non vengono riutilizzati.

I suggerimenti non erano ancora sul pagamento Mollie quando Tillor ha visto il pagamento per la prima volta? Il gruppo viene comunque riempito non appena il pagamento è **pagato**, **non** è collegato a una fattura e **non** è ancora in un gruppo. Succede alla sincronizzazione successiva o con una notifica Mollie in arrivo.

<Callout type="info" title="Quando usarli?">
Assegna in anticipo i tag a ogni pagamento Mollie dal tuo POS. Il gruppo compare in *Amministrazione > Pagamenti*, nella sezione *Gruppi di pagamento*.
</Callout>

<Callout type="warn" title="Da non combinare con invoiceId">
Un pagamento raggruppato non può essere collegato singolarmente a una fattura. Se invii sia i suggerimenti di gruppo sia `invoiceId`, vince il gruppo.
</Callout>

## Metadati contabili diretti (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping]

I pagamenti Mollie sconosciuti vanno per impostazione predefinita sul conto transitorio **499000**. Con `tillor.bookkeeping` Tillor li registra sul cliente indicato:

```json
{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}
```

| Campo | Descrizione |
|------|---------------|
| `customerCode` | Codice cliente nella contabilità - obbligatorio |
| `documentType` | Ad es. INV, UF |
| `department` | Reparto |
| `fiscalYear` | Anno contabile |
| `documentNumber` | Numero documento |

Se `bookkeeping` è presente, il pagamento **non** arriva come normale pagamento Tillor. I metadati vengono usati nella creazione del report contabile.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Mollie (app)" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Gruppi di pagamento" href="/betalingsverwerking/groepen" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
</Cards>


# MQTT (/it-IT/ontwikkelaars/mqtt)

Le credenziali MQTT danno alle integrazioni accesso pub/sub nel namespace dei topic della tua organizzazione. Crei le credenziali in Tillor sotto **Account > Sviluppatori** (per organizzazione). L'accesso ai topic è limitato a `tillor/{env}/{orgId}/integration` e ai sotto-topic (`{env}` = `prod`, `staging` o `local`), a meno che una credenziale statica abbia `topicPrefix: null`.

Per gli stessi eventi in tempo reale dei [webhook](/ontwikkelaars/webhooks) e di [SSE](/ontwikkelaars/sse) usa quei canali, non MQTT.

## Gestione [#beheer]

| Metodo | Percorso | Descrizione |
|--------|------|---------------|
| POST | `/api/orgs/:orgId/mqtt/credentials` | Genera credenziali JWT (temporanee) |
| GET | `/api/orgs/:orgId/mqtt/static-credentials` | Recupera le credenziali statiche |
| POST | `/api/orgs/:orgId/mqtt/static-credentials` | Crea una credenziale statica |
| DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Elimina una credenziale statica |

Autenticazione: `x-api-key`, con l'ID dell'organizzazione nel percorso (come per l'[API HTTP](/ontwikkelaars/http)). Per gli schemi completi di richiesta e risposta vedi la [specifica OpenAPI](https://tillor.eu/api/openapi.json).

## Credenziali [#credentials]

Esistono due varianti:

### JWT (temporaneo) [#jwt-tijdelijk]

- **Uso:** sessioni brevi, accesso temporaneo
- **Scadenza:** per impostazione predefinita 1 ora; configurabile da 1 minuto a 24 ore tramite `expiresInSeconds`
- **Ideale per:** test, connessioni temporanee, o quando recuperi i token dinamicamente
- **Creazione:** in Tillor sotto **Account > Sviluppatori**, oppure tramite `POST /api/orgs/:orgId/mqtt/credentials` con, facoltativamente, `{ "clientId": "...", "expiresInSeconds": 3600 }`
- **Risposta:** `token` (da usare come password MQTT), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt`
- **Nome utente:** lascialo vuoto quando ti colleghi; l'autenticazione JWT usa solo il token come password.
- **Client ID:** quando ti colleghi usa esattamente il `clientId` della risposta (incluso il prefisso dell'ambiente, ad es. `prod-`).

Una connessione al broker tramite **mqtts** verifica il certificato del server. Se usi un certificato CA **privato** (non la normale catena pubblica), inserisci il PEM di quella CA nell'ambiente del tuo client.

### Credenziali statiche [#statische-credentials]

- **Uso:** integrazioni di lunga durata, connessioni sempre attive
- **Forma:** userName, clientId e password fissi
- **Ideale per:** integrazioni di produzione che restano collegate in continuazione
- **Creazione:** in Tillor sotto **Account > Sviluppatori**, oppure tramite `POST /api/orgs/:orgId/mqtt/static-credentials` con, facoltativamente, `{ "name": "mijn-integratie", "topicPrefix": null }`
- **Risposta:** `userName`, `clientId`, `password` (una sola volta), `topicPrefix` (`null` = nessun prefisso, ACL `#`), facoltativamente `brokerUrl`
- **Attenzione:** la password viene mostrata una sola volta nella risposta e non può essere recuperata in seguito

---

## Accesso ai topic [#topic-toegang]

Le sottoscrizioni ai topic sono **strettamente limitate**, a meno che `topicPrefix` sia `null` (ACL `#`). Per impostazione predefinita puoi pubblicare e sottoscrivere solo su `tillor/{env}/{orgId}/integration` e `tillor/{env}/{orgId}/integration/#`.

- **Topic consentiti** - solo `tillor/{env}/{orgId}/integration` e i sotto-topic (ad es. `tillor/{env}/{orgId}/integration/connector/access-point-operation`)
- **Nessun bypass con wildcard** - anche con `#` o `+` ottieni accesso solo al namespace della tua organizzazione
- **Per organizzazione** - le credenziali valgono per organizzazione; non hai accesso ai topic di altre organizzazioni

---

## Correlati [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - specifica completa dell'API
- [API HTTP](/ontwikkelaars/http) - API REST e chiavi API
- [Webhook](/ontwikkelaars/webhooks) - Gli stessi eventi tramite HTTP POST
- [SSE](/ontwikkelaars/sse) - Eventi in streaming tramite Server-Sent Events


# OAuth-clients (/it-IT/ontwikkelaars/oauth-clients)

Met een OAuth-client meldt een andere applicatie mensen aan met hun Tillor-account. Tillor is daarbij de OpenID Connect-provider: de applicatie stuurt de gebruiker naar Tillor, de gebruiker meldt zich aan en geeft toestemming, en de applicatie krijgt te horen wie het is. Je gebruikt dat voor een eigen applicatie, of voor single sign-on bij een externe dienst die aanmelden via een eigen identiteitsprovider ondersteunt.

Standaard kan elk Tillor-account zich via een client aanmelden. Voor single sign-on bij een externe dienst wil je dat bijna nooit: beperk de client dan tot mensen van je organisatie.

## Wat je nodig hebt [#wat-je-nodig-hebt]

- De **redirect-URI** die de applicatie of dienst opgeeft.
- Wie zich aanmeldt, heeft het recht **OAuth-apps autoriseren** nodig. Zie [OAuth-apps](/gebruikers/organisaties#oauth-apps).
- Om een client tot je organisatie te beperken: het recht **Integraties beheren** in die organisatie.

## Een client aanmaken [#een-client-aanmaken]

<Steps>
<Step>

Klik in de sidebar op je naam en kies <UIPath>Account > OAuth-clients</UIPath>. Klik op **OAuth-client aanmaken**.

</Step>
<Step>

Vul de **Applicatienaam** in en zet elke **Redirect-URI** op een eigen regel. Vink **Publieke client** alleen aan voor een applicatie die geen geheim kan bewaren, zoals een mobiele app.

</Step>
<Step>

Kies wie zich mag aanmelden. Zie [Beperken wie zich mag aanmelden](#beperken-wie-zich-mag-aanmelden).

</Step>
<Step>

Sla op. Tillor toont de **Client-ID** en het **Clientgeheim**. Het geheim zie je alleen nu: kopieer het en bewaar het veilig.

</Step>
</Steps>

In de applicatie of dienst vul je de client-ID, het clientgeheim en het adres van Tillor als provider in: `https://tillor.eu/api/auth`. De meeste diensten lezen de rest zelf uit `https://tillor.eu/api/auth/.well-known/openid-configuration`.

## Beperken wie zich mag aanmelden [#beperken-wie-zich-mag-aanmelden]

Vink **Alleen mensen van (je organisatie) kunnen aanmelden** aan in het venster van de client. De beperking geldt voor de organisatie waarin je op dat moment werkt. Daarna kan je ze verder vernauwen:

| Voorwaarde | Wie voldoet |
|---|---|
| Organisatie (altijd) | Wie lid is van de organisatie |
| **Groepen** (nul of meer) | Wie in **minstens één** van de gekozen [groepen](/gebruikers/groepen) zit |
| **Permissies** (nul of meer) | Wie **alle** gekozen rechten heeft in de organisatie, met de rechten uit groepen meegerekend |

De voorwaarden gelden samen: iemand moet lid zijn, **en** in een van de groepen zitten, **en** alle rechten hebben. Een lege lijst groepen of permissies telt niet mee. Kies je dus geen groepen en geen permissies, dan mag elk lid van de organisatie zich aanmelden.

Een voorbeeld: je kiest de groep "Boekhouding" en het recht om betalingen te bekijken. Alleen wie lid is van je organisatie, in "Boekhouding" zit en betalingen mag bekijken, komt binnen.

De kolom **Wie kan aanmelden** in de lijst van clients toont de beperking van elke client.

<Callout type="info" title="Goed om te weten">
- Kies bij voorkeur **groepen**. Een groep is van jou: je bepaalt zelf wie erin zit. De betekenis van een recht kan in een latere versie van Tillor veranderen, en dan verandert mee wie zich bij de externe dienst kan aanmelden.
- Tillor controleert de voorwaarden bij elke aanmelding en telkens wanneer de applicatie de sessie vernieuwt. Wie de organisatie of de groep verlaat of een recht verliest, krijgt geen nieuwe toegang meer. Toegang die al was uitgereikt, vervalt binnen het uur.
- Voor een beheerder van Tillor zelf gelden dezelfde voorwaarden. Zo iemand is lid van elke organisatie: kies een groep als alleen je eigen mensen binnen mogen.
- Je wijzigt of verwijdert de beperking vanuit de organisatie waarvoor ze geldt. Werk je in een andere organisatie, dan toont het venster alleen voor welke organisatie de client beperkt is.
- Elke wijziging van de beperking en elke geweigerde aanmelding staat in de [activiteitenlog](/activiteitenlog) van de organisatie.
</Callout>

## Problemen? [#problemen]

**Iemand krijgt bij de externe dienst de fout `access_denied`.**
Die persoon voldoet niet aan de voorwaarden van de client. Kijk in de activiteitenlog naar de regel **Toegang geweigerd**: de reden zegt of het om het lidmaatschap, de groep of een recht gaat.

**Iemand ziet op het toestemmingsscherm "Niet beschikbaar voor uw account".**
Zelfde oorzaak: de client is beperkt en dit account voldoet niet. Voeg de persoon toe aan de juiste groep of geef het ontbrekende recht.

**Bij een groep staat "Verwijderde groep".**
De groep bestaat niet meer, en niemand kan er nog in zitten. Was het de enige gekozen groep, dan kan niemand zich aanmelden. Vink ze uit of kies een andere groep.

**Het vakje om te beperken is grijs.**
Je mist het recht **Integraties beheren** in deze organisatie. Vraag het aan een beheerder.

**Na het verlies van een recht blijft iemand nog even aangemeld bij de externe dienst.**
De externe dienst houdt zijn eigen sessie bij. Tillor weigert de volgende vernieuwing; hoe snel de dienst de persoon afmeldt, hangt van die dienst af.


# Server-Sent Events (SSE) (/it-IT/ontwikkelaars/sse)

SSE offre uno stream di lunga durata degli stessi eventi che ricevono i [webhook](/ontwikkelaars/webhooks). Usa SSE quando preferisci una connessione persistente alle callback HTTP.

## Endpoint [#endpoint]

```
GET /api/orgs/:orgId/realtime/subscribe
```

## Autenticazione [#authenticatie]

SSE usa la stessa autenticazione degli altri endpoint API:

- **x-api-key** - la tua chiave API

L'ID dell'organizzazione è nel percorso dell'URL.

## Filtro degli eventi [#event-filtering]

Usa il parametro di query `events` per filtrare per tipo di evento:

```
GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid
```

Usa `events=*` per ricevere tutti gli eventi (come omettere il parametro).

Nell'[indice degli eventi](/ontwikkelaars/events) trovi tutti gli eventi, il permesso per ogni evento e un esempio di payload.

Alcuni eventi hanno un canale proprio (log del controller e I/O del controller). Li ricevi solo con `?channel=controller-logs` o `?channel=controller-io`; l'indice degli eventi indica il canale.

Tillor consegna solo gli eventi per cui il membro dell'organizzazione connesso ha il permesso. Senza `bank-transactions:read` (o sync) non ricevi per esempio gli eventi `bankAccountTransaction:*`, nemmeno se non invii nessun filtro `events`.

I dati collegati di un altro dominio seguono le stesse regole dell'API: senza `customers:read` arriva un `reservation:updated` con `customer: null`, senza `payments:read` un `invoice:paid` con `payment: null`. Un elenco diventa allora `[]`.

---

## Formato dell'evento [#event-formaat]

Il payload ha la stessa struttura delle [consegne dei webhook](/ontwikkelaars/webhooks#webhook-payload):

| Campo | Tipo | Descrizione |
|------|------|--------------|
| `event` | string | Chiave dell'evento (ad es. `invoice:created`) |
| `data` | object | Payload specifico dell'evento |
| `timestamp` | number | Unix timestamp (ms) del momento in cui l'evento è stato emesso |
| `traceId` | string | ID di trace OpenTelemetry dell'azione Tillor che ha causato questo evento (come per i [webhook](/ontwikkelaars/webhooks#webhook-payload)) |
| `spanId` | string (facoltativo) | Span all'interno di quella trace |

Nello stream SSE questo oggetto JSON si trova sulla riga `data:`; la chiave dell'evento compare anche sulla riga `event:`. Vedi gli [esempi SSE](/ontwikkelaars/voorbeelden/sse) per un esempio wire.

---

## Esempio: Node.js [#voorbeeld-nodejs]

```javascript
const orgId = "org_abc123";
const apiKey = "tkn_xxx";

const url = `https://app.tillor.eu/api/orgs/${orgId}/realtime/subscribe?events=invoice:created&events=customer:updated`;

const response = await fetch(url, {
  headers: {
    "x-api-key": apiKey,
    "Accept": "text/event-stream",
  },
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value, { stream: true });
  for (const line of chunk.split("\n")) {
    if (line.startsWith("data: ")) {
      const payload = JSON.parse(line.slice(6));
      console.log(payload.event, payload.data);
    }
  }
}
```

---

## Esempio: cURL [#voorbeeld-curl]

```bash
curl -N -H "x-api-key: tkn_xxx" \
     -H "Accept: text/event-stream" \
     "https://app.tillor.eu/api/orgs/org_abc123/realtime/subscribe"
```

---

## Riconnessione [#herverbinding]

Se la connessione si interrompe, riconnettiti con lo stesso URL e gli stessi header. Lo stream non supporta la ripresa: dopo la riconnessione ricevi solo i nuovi eventi.

---

## Correlati [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - specifica completa dell'API
- [API HTTP](/ontwikkelaars/http) - chiavi API e autenticazione
- [Webhook](/ontwikkelaars/webhooks) - Gli stessi eventi tramite HTTP POST
- [Esempi](/ontwikkelaars/voorbeelden) - esempi di codice e di payload


# Esempi HTTP (/it-IT/ontwikkelaars/voorbeelden/http)

Orari di apertura e festivi per un sito pubblico: [API degli orari di apertura](/ontwikkelaars/voorbeelden/opening-hours).

## Richiesta API con cURL [#api-request-met-curl]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/customers" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json"
```

## Creare una chiave API [#api-sleutel-aanmaken]

```bash
curl -X POST "https://tillor.eu/api/api-keys" \
  -H "Cookie: session=..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Mijn integratie", "description": "Optionele beschrijving"}'
```

## Creare un webhook [#webhook-aanmaken]

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/webhooks" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://jouw-server.com/webhooks/tillor",
    "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
    "enabled": true
  }'
```


# Panoramica (/it-IT/ontwikkelaars/voorbeelden)

Esempi pronti da cui partire. Ogni esempio usa i segnaposto `org_abc123` e `tkn_xxx`; sostituiscili con l'ID della tua organizzazione e la tua chiave API.

<Cards>
  <Card
    title="Esempi HTTP"
    href="/ontwikkelaars/voorbeelden/http"
    description="Esempi di cURL e di richieste per l'API di Tillor"
  />
  <Card
    title="API degli orari di apertura"
    href="/ontwikkelaars/voorbeelden/opening-hours"
    description="Recuperare per un sito web gli orari di apertura risolti e i prossimi festivi"
  />
  <Card
    title="Esempi di webhook"
    href="/ontwikkelaars/voorbeelden/webhooks"
    description="Payload degli eventi ed esempi di POST dei webhook"
  />
  <Card
    title="Esempi SSE"
    href="/ontwikkelaars/voorbeelden/sse"
    description="Node.js e cURL per i Server-Sent Events"
  />
</Cards>


# API degli orari di apertura (/it-IT/ontwikkelaars/voorbeelden/opening-hours)

Usa l'API degli orari di apertura **risolti** se su un sito pubblico mostri orari stagionali (ad esempio **Estate** / **Inverno**) o i prossimi **festivi**. Tillor applica già eccezioni, periodi stagionali e il normale orario settimanale, e aggiunge i festivi legali nell'intervallo richiesto. Non devi implementarlo di nuovo.

**Permesso:** `organization:settings:read` oppure `organization:settings:write`

<Callout type="warn" title="La chiave API resta lato server">
Chiama Tillor solo da un server (Route Handler di Next.js, Server Component o backend). Metti la chiave nelle variabili d'ambiente. Non inviarla mai al browser.
</Callout>

Autenticazione: vedi [API HTTP](/ontwikkelaars/http). Prova l'endpoint nel [riferimento API](/api-referentie) o tramite [OpenAPI](https://tillor.eu/api/openapi.json) (tag `organization-settings`).

## Endpoint [#endpoint]

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours
```

Header:

```http
x-api-key: tkn_xxx
```

Sostituisci `org_abc123` con l'ID della tua organizzazione.

### Parametri di query [#queryparameters]

Usa **o** `date`, **o** `from`/`to`. Non combinarli.

| Parametro | Significato |
|-----------|-----------|
| *(nessuno)* | Oggi nel fuso orario dell'organizzazione |
| `date` | Un singolo giorno di calendario (`YYYY-MM-DD`) |
| `from` | Giorno iniziale (incluso). Senza `to`: solo quel giorno |
| `to` | Giorno finale (incluso). Richiede `from`. Al massimo **366** giorni |
| `languageIsoCode` | Lingua dei nomi dei festivi (`NL`, `FR`, …). Predefinito: locale dell'organizzazione |

## Risposta [#response]

Ogni elemento è un giorno di calendario, già risolto:

| Campo | Significato |
|------|-----------|
| `timeZone` | Fuso orario IANA dell'organizzazione |
| `from` / `to` | Intervallo richiesto |
| `holidays` | Festivi legali che si sovrappongono a `from`–`to` |
| `items[].date` | Giorno di calendario `YYYY-MM-DD` |
| `items[].weekday` | `monday` … `sunday` |
| `items[].source` | `exception`, `period` o `regular` |
| `items[].periodLabel` | Solo con `source: "period"`: l'etichetta da Tillor, ad esempio `"Zomer"` o `"Winter"` |
| `items[].holiday` | Solo se quel giorno è un festivo legale: `{ id, name, startDate, endDate }` |
| `items[].blocks` | Fasce orarie in minuti dalla mezzanotte |
| `items[].closed` | `true` se `blocks` è vuoto |

Priorità: **eccezione** (festivo o intervallo personalizzato) → ultimo **periodo stagionale** corrispondente → normale orario **settimanale**.

Le etichette stagionali provengono da *Impostazioni > Orari di apertura*. I periodi possono attraversare il cambio d'anno (ad esempio dal 1° novembre al 31 marzo). I giorni fuori da ogni periodo ricadono sul normale orario settimanale (`source: "regular"`, nessun `periodLabel`).

### Dai minuti all'ora dell'orologio [#minuten-naar-kloktijd]

`startMinutes` / `endMinutes` sono minuti dalle 00:00.

| Minuti | Ora |
|--------:|------|
| 540 | 09:00 |
| 600 | 10:00 |
| 720 | 12:00 |
| 780 | 13:00 |
| 1020 | 17:00 |
| 1140 | 19:00 |

```ts
function formatMinutes(minutes: number): string {
  const hour = Math.floor(minutes / 60);
  const minute = minutes % 60;
  return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
}
```

## Esempi [#voorbeelden]

### Giorno in un periodo stagionale [#dag-in-een-seizoensperiode]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?date=2026-07-15" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-07-15",
  "to": "2026-07-15",
  "holidays": [],
  "items": [
    {
      "date": "2026-07-15",
      "weekday": "wednesday",
      "source": "period",
      "periodLabel": "Zomer",
      "blocks": [{ "startMinutes": 540, "endMinutes": 720 }],
      "closed": false
    }
  ]
}
```

09:00–12:00, orari estivi.

### Giorno fuori dai periodi stagionali [#dag-buiten-seizoensperiodes]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?date=2026-01-15" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-01-15",
  "to": "2026-01-15",
  "holidays": [],
  "items": [
    {
      "date": "2026-01-15",
      "weekday": "thursday",
      "source": "regular",
      "blocks": [
        { "startMinutes": 540, "endMinutes": 720 },
        { "startMinutes": 780, "endMinutes": 1020 }
      ],
      "closed": false
    }
  ]
}
```

09:00–12:00 e 13:00–17:00.

### Intervallo a cavallo di un confine di periodo [#range-over-een-periodegrens]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?from=2026-03-30&to=2026-04-02" \
  -H "x-api-key: tkn_xxx"
```

| Data | `source` | `periodLabel` |
|-------|----------|---------------|
| 2026-03-30 | `regular` | - |
| 2026-03-31 | `regular` | - |
| 2026-04-01 | `period` | `Zomer` |
| 2026-04-02 | `period` | `Zomer` |

## Prossimi festivi [#komende-feestdagen]

I festivi legali sono nella stessa risposta: `holidays` per un elenco (nome + date), `items[].holiday` se quel giorno di calendario è un festivo. Gli orari restano l'orario risolto; un festivo senza eccezione compilata in Tillor segue l'orario stagionale o settimanale (`source` non è allora `"exception"`).

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?from=2026-08-27&to=2026-12-31&languageIsoCode=NL" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-08-27",
  "to": "2026-12-31",
  "holidays": [
    {
      "id": "0fad0035-6b77-404a-953d-c66dac014483",
      "name": "Allerheiligen",
      "startDate": "2026-11-01",
      "endDate": "2026-11-01"
    },
    {
      "id": "d90e5f53-bc92-4860-bdae-f7e75935848d",
      "name": "Kerstmis",
      "startDate": "2026-12-25",
      "endDate": "2026-12-25"
    }
  ],
  "items": [
    {
      "date": "2026-11-01",
      "weekday": "sunday",
      "source": "regular",
      "holiday": {
        "id": "0fad0035-6b77-404a-953d-c66dac014483",
        "name": "Allerheiligen",
        "startDate": "2026-11-01",
        "endDate": "2026-11-01"
      },
      "blocks": [],
      "closed": true
    }
  ]
}
```

L'esempio di `items` qui sopra è abbreviato; la risposta reale contiene ogni giorno dell'intervallo. Le vacanze scolastiche non sono in questo endpoint; restano `GET /holidays?kind=school`.

## Next.js (server) [#nextjs-server]

Per un widget settimanale o un "ora aperto" su un sito pubblico:

```ts
const TILLOR_API_URL = "https://tillor.eu";
const ORGANIZATION_ID = process.env.TILLOR_ORG_ID ?? "";

type OpeningHoursBlock = {
  startMinutes: number;
  endMinutes: number;
};

type OpeningHoursHoliday = {
  id: string;
  name: string;
  startDate: string;
  endDate: string;
};

type OpeningHoursItem = {
  date: string;
  weekday: string;
  source: "exception" | "period" | "regular";
  periodLabel?: string;
  holiday?: OpeningHoursHoliday;
  blocks: OpeningHoursBlock[];
  closed: boolean;
};

type OpeningHoursResponse = {
  timeZone: string;
  from: string;
  to: string;
  holidays: OpeningHoursHoliday[];
  items: OpeningHoursItem[];
};

export async function getOpeningHours(
  from: string,
  to: string,
): Promise<OpeningHoursResponse> {
  const url = new URL(
    `${TILLOR_API_URL}/api/orgs/${ORGANIZATION_ID}/organization-settings/opening-hours`,
  );
  url.searchParams.set("from", from);
  url.searchParams.set("to", to);
  url.searchParams.set("languageIsoCode", "NL");

  const response = await fetch(url, {
    headers: {
      "x-api-key": process.env.TILLOR_API_KEY ?? "",
    },
    next: { tags: ["opening-hours"], revalidate: 3600 },
  });

  if (!response.ok) {
    throw new Error(`Tillor opening hours ${response.status}`);
  }

  return response.json() as Promise<OpeningHoursResponse>;
}
```

`holidays` è l'elenco per un blocco "prossimi festivi". `items[].holiday` è utile in un calendario settimanale. `items[].periodLabel` è il testo stagionale (ad esempio `"Zomer"` o `"Winter"`). Una cache di 1 ora di solito basta.

## Invalidare la cache (webhook) [#cache-ongeldig-maken-webhook]

A ogni modifica delle impostazioni dell'organizzazione Tillor invia `organizationSettings:updated` (webhook e SSE). Iscriviti a questo evento e recupera di nuovo gli orari di apertura. Il payload è volutamente piccolo (niente IP delle stampanti né l'intero orario):

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

`openingHoursChanged` è `true` se cambiano l'orario di apertura, il fuso orario o il paese predefinito: è ciò che influenza `GET .../opening-hours`. Con `false` puoi lasciare la cache degli orari di apertura com'è.

Esempio di Route Handler di Next.js:

```ts
import { revalidateTag } from "next/cache";

export async function POST(request: Request) {
  const body = (await request.json()) as {
    event?: string;
    data?: { openingHoursChanged?: boolean };
  };
  if (body.event === "organizationSettings:updated" && body.data?.openingHoursChanged) {
    await revalidateTag("opening-hours");
  }
  return new Response(null, { status: 204 });
}
```

Creare un webhook: vedi [Webhook](/ontwikkelaars/webhooks). Chiave dell'evento: `organizationSettings:updated` (permesso `organization:settings:read` oppure `organization:settings:write`).

## Orario completo (facoltativo) [#volledig-rooster-optioneel]

Serve solo se vuoi mostrare tu stesso il calendario stagionale (etichette + `fromMonth`/`untilDay`), senza risolvere giorno per giorno:

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings
```

Leggi `openingHoursSchedule.periods` (etichette come `"Zomer"`) e `openingHoursSchedule.weekdays` (orario normale). Per il sito web stesso `GET .../opening-hours` resta la fonte più semplice.

## MCP [#mcp]

In Cursor o Claude: endpoint `organizationSettings_listOpeningHours` (categoria `organizationSettings`), argomenti `organizationId`, facoltativamente `date` oppure `from`/`to`, facoltativamente `languageIsoCode`.

## Correlati [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - autenticazione e header
- [Esempi HTTP](/ontwikkelaars/voorbeelden/http) - esempi generali di cURL
- [Webhook](/ontwikkelaars/webhooks) - `organizationSettings:updated` per la rivalidazione della cache
- [Impostazioni dell'organizzazione](/gebruikers/organisaties) - impostare gli orari di apertura in Tillor


# Esempi SSE (/it-IT/ontwikkelaars/voorbeelden/sse)

## cURL [#curl]

```bash
curl -N -H "x-api-key: tkn_xxx" \
     "https://app.tillor.eu/api/orgs/org_abc123/realtime/subscribe"
```

## Node.js [#nodejs]

```javascript
const orgId = "org_abc123";
const apiKey = "tkn_xxx";

const url = `https://app.tillor.eu/api/orgs/${orgId}/realtime/subscribe?events=invoice:created&events=customer:updated`;

const response = await fetch(url, {
  headers: {
    "x-api-key": apiKey,
    "Accept": "text/event-stream",
  },
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value, { stream: true });
  for (const line of chunk.split("\n")) {
    if (line.startsWith("data: ")) {
      const payload = JSON.parse(line.slice(6));
      console.log(payload.event, payload.data);
    }
  }
}
```

## Messaggio SSE [#sse-bericht]

Un messaggio SSE (`text/event-stream`) ha questo aspetto:

```
event: message
data: {"event":"invoice:paid","data":{"invoice":{"id":"inv_def456uvw","displayId":"2025-00123","status":"BOOKED","paymentStatus":"PAID","amountTotal":200,"paidDate":"2025-03-09T12:15:00.000Z","customerId":"cust_abc123xyz"},"payment":{"id":"pay_ghi789rst","amount":200,"status":"PAID","method":"BANCONTACT","provider":"MOLLIE","paidAt":"2025-03-09T12:15:00.000Z"}},"timestamp":1735811700000}

```

La riga SSE `event` è `message`. Analizza la riga `data` come JSON: contiene l'evento Tillor (`event`), il payload (`data`) e `timestamp` (ms). Lo stesso oggetto JSON lo ricevi tramite i [webhook](/ontwikkelaars/webhooks).


# Esempi di webhook (/it-IT/ontwikkelaars/voorbeelden/webhooks)

Gli stessi eventi di [SSE](/ontwikkelaars/voorbeelden/sse). La struttura del payload è identica.

## Struttura del wrapper [#wrapper-structuur]

```json
{
  "event": "entity:action",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

`traceId` appartiene all'azione Tillor che ha causato l'evento (ad es. una chiamata API o un'elaborazione interna), non a un successivo nuovo tentativo del webhook.

## Esempio di POST di un webhook [#webhook-post-voorbeeld]

Una richiesta POST completa di un webhook ha questo aspetto:

```http
POST /webhooks/tillor HTTP/1.1
Host: your-server.com
Content-Type: application/json

{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "inv_def456uvw",
      "displayId": "2025-00123",
      "status": "BOOKED",
      "paymentStatus": "PAID",
      "amountTotal": 200.0,
      "paidDate": "2025-03-09T12:15:00.000Z",
      "customerId": "cust_abc123xyz"
    },
    "payment": {
      "id": "pay_ghi789rst",
      "amount": 200.0,
      "status": "PAID",
      "method": "BANCONTACT",
      "channel": "ONLINE",
      "provider": "MOLLIE",
      "paidAt": "2025-03-09T12:15:00.000Z"
    }
  },
  "timestamp": 1735811700000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

## Payload degli eventi [#event-payloads]

### customer:created [#customercreated]

```json
{
  "event": "customer:created",
  "data": {
    "id": "cust_abc123xyz",
    "displayId": 1042,
    "firstName": "Jan",
    "lastName": "Jansen",
    "email": "jan.jansen@voorbeeld.nl",
    "phone": "+31612345678",
    "address": "Hoofdstraat 42",
    "city": "Amsterdam",
    "zipCode": "1012 AB",
    "country": "NL",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "createdAt": "2025-03-09T10:30:00.000Z",
    "updatedAt": "2025-03-09T10:30:00.000Z"
  },
  "timestamp": 1735806600000
}
```

### invoice:paid [#invoicepaid]

```json
{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "inv_def456uvw",
      "displayId": "2025-00123",
      "status": "BOOKED",
      "paymentStatus": "PAID",
      "amountTotal": 200.0,
      "paidDate": "2025-03-09T12:15:00.000Z",
      "customerId": "cust_abc123xyz"
    },
    "payment": {
      "id": "pay_ghi789rst",
      "amount": 200.0,
      "status": "PAID",
      "method": "BANCONTACT",
      "channel": "ONLINE",
      "provider": "MOLLIE",
      "paidAt": "2025-03-09T12:15:00.000Z"
    }
  },
  "timestamp": 1735811700000
}
```

### controller:adoption:requested [#controlleradoptionrequested]

```json
{
  "event": "controller:adoption:requested",
  "data": {
    "adoptionId": "adopt_jkl012mno",
    "efuseId": "a1b2c3d4e5f6",
    "requestedFromIp": "192.168.1.42",
    "isNew": true
  },
  "timestamp": 1735809000000
}
```

### nfc-tag:presented [#nfc-tagpresented]

```json
{
  "event": "nfc-tag:presented",
  "data": {
    "id": "nfc_123abc456",
    "uid": "04A1B2C3D4E5F6",
    "type": "CARD",
    "balance": 25.5,
    "blockedAt": null,
    "customerId": "cust_abc123xyz"
  },
  "timestamp": 1735807500000
}
```

### organizationSettings:updated [#organizationsettingsupdated]

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

Vedi l'[API degli orari di apertura](/ontwikkelaars/voorbeelden/opening-hours) per la rivalidazione della cache su un sito pubblico.

## Enum [#enums]

| Entità | Enum | Valori |
|--------|------|---------|
| Customer | `customerType` | `STANDARD`, `WORKER_RENTAL_CARAVAN`, `WORKER_TOWING_CARAVAN` |
| Invoice | `status` | `DRAFT`, `BOOKED` |
| Invoice | `paymentStatus` | `UNPAID`, `PARTIALLY_PAID`, `PENDING`, `PAID` |
| Payment | `status` | `PENDING`, `AUTHORIZED`, `PAID`, `CANCELED`, `FAILED`, `EXPIRED`, `REFUNDED`, `PARTIALLY_REFUNDED`, `CHARGED_BACK` |
| Payment | `method` | `UNKNOWN`, `BANCONTACT`, `IDEAL`, `CREDITCARD`, `CASH`, … (elenco completo in OpenAPI) |
| Payment | `channel` | `MANUAL`, `BANK_TRANSFER`, `TERMINAL`, `ONLINE`, `MANDATE` |
| Payment | `provider` | `MOLLIE`, `MANUAL`, `PONTO` |
| Controller | `type` | `ACCESS`, `SHOWER`, `CHARGE_POINT` |
| NfcTag | `type` | `CARD`, `BRACELET`, `STICKER`, `KEY_FOB` |


# Webhook (/it-IT/ontwikkelaars/webhooks)

I webhook ricevono eventi in tempo reale tramite HTTP POST su un URL configurato da te. Gli stessi eventi sono disponibili anche tramite [SSE](/ontwikkelaars/sse). I webhook sono configurati **per organizzazione**: ogni organizzazione ha i propri webhook.

## Gestione [#beheer]

Per gli schemi completi di richiesta e risposta vedi la [specifica OpenAPI](https://tillor.eu/api/openapi.json).

| Metodo | Percorso | Descrizione |
|--------|------|-------------|
| GET | `/api/orgs/:orgId/webhooks` | Recupera i webhook |
| GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Recupera le statistiche di consegna |
| POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Riprova le consegne. Body: `mode` (`failed` o `force`) e, facoltativamente, `id` per un singolo webhook. `failed`: solo le consegne definitivamente fallite, subito. `force`: consegne in attesa e definitivamente fallite in background, ignorando i tempi di attesa. |
| GET | `/api/orgs/:orgId/webhooks/:id` | Recupera un webhook per ID |
| POST | `/api/orgs/:orgId/webhooks` | Crea un webhook |
| PATCH | `/api/orgs/:orgId/webhooks/:id` | Aggiorna un webhook |
| DELETE | `/api/orgs/:orgId/webhooks/:id` | Elimina un webhook |

## Creare un webhook [#webhook-aanmaken]

```http
POST /api/orgs/org_abc123/webhooks
Content-Type: application/json
x-api-key: tkn_xxx
```

```json
{
  "url": "https://jouw-server.com/webhooks/tillor",
  "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
  "enabled": true
}
```

- **url** - endpoint HTTPS che accetta richieste POST
- **subscribedEventKeys** - array di chiavi di evento oppure `["*"]` per tutti gli eventi. L'elenco completo si trova in Tillor sotto **Menu del profilo → Sviluppatori**, in **Aggiunga webhook** → **Eventi iscritti**.

Alcuni eventi sono così frequenti che non puoi sceglierli e che non arrivano nemmeno tramite `*`, come lo stato fisico delle barriere, la digitazione nella inbox, i log del controller e la presenza dei veicoli. Non compaiono nell'elenco qui sotto. Quali eventi puoi scegliere dipende anche dai tuoi permessi.
- **enabled** - `true` per attivare la consegna

Puoi scegliere solo eventi per cui il tuo membro dell'organizzazione ha il permesso corretto (ad es. transazioni bancarie per `bankAccountTransaction:*`). Il carattere jolly `*` è disponibile solo per i membri con accesso completo (`*`). Con una combinazione non valida l'API restituisce un errore. Un webhook inoltra il payload completo, con i dati collegati (come il cliente in una prenotazione). Per questo devi poter leggere anche quei domini per creare un webhook, modificarne l'URL o gli eventi, o riattivarlo.

---

## Payload del webhook [#webhook-payload]

Ogni consegna di un webhook è una POST con:

**Header:**
- `Content-Type: application/json`
- `X-Webhook-Event-ID` - ID univoco stabile di questa consegna logica (stesso valore nei nuovi tentativi)
- `X-Webhook-Signature` - firma HMAC-SHA256 del body, formato `sha256=<hex>` (vedi [Verificare la firma](#handtekening-verifiëren))

**Body:**

```json
{
  "event": "invoice:created",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7",
  "triggeredBy": {
    "id": "usr_63x8jp68is",
    "name": "Niels"
  }
}
```

| Campo | Tipo | Descrizione |
|------|------|--------------|
| `event` | string | Chiave dell'evento (ad es. `invoice:created`) |
| `data` | object | Payload specifico dell'evento |
| `timestamp` | number | Unix timestamp (ms) del momento in cui l'evento è stato emesso |
| `traceId` | string | ID di trace OpenTelemetry dell'azione Tillor che ha causato questo evento. Comunicalo al supporto; non è un segreto. |
| `spanId` | string (facoltativo) | Span all'interno di quella trace |
| `triggeredBy` | object \| null | Utente che ha eseguito l'azione (`id`, `name`). `null` per le azioni di sistema (cron, sync bancaria, …) |

Vedi gli [Esempi](/ontwikkelaars/voorbeelden) per esempi completi di payload.

---

## Verificare la firma [#handtekening-verifiëren]

Ogni webhook ha un proprio **signing secret** (64 caratteri esadecimali, visibile nella tabella dei webhook tramite **Mostra la chiave di firma** in *Menu del profilo → Sviluppatori*). Tillor firma ogni POST con quel secret, così puoi verificare che la richiesta provenga davvero da Tillor e che il body non sia stato modificato.

**Come firma Tillor:**

1. Calcola `HMAC-SHA256(signingSecret, raw_request_body)` (esadecimale minuscolo).
2. Lo invia come `X-Webhook-Signature: sha256=<hex>`.

**Come verifichi tu:**

1. Leggi il body **grezzo** della richiesta (prima del parsing JSON, altrimenti l'hash non corrisponde).
2. Calcola tu stesso `HMAC-SHA256(signingSecret, raw_body)` in esadecimale.
3. Confronta con il valore dopo `sha256=` nell'header `X-Webhook-Signature` con un confronto **constant-time**.

```js
import crypto from "node:crypto";

function verifyTillorWebhook(rawBody, headerSignature, signingSecret) {
  const expected = crypto.createHmac("sha256", signingSecret).update(rawBody).digest("hex");
  const received = headerSignature.replace(/^sha256=/, "");
  const a = Buffer.from(expected, "hex");
  const b = Buffer.from(received, "hex");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}
```

<Callout type="warn" title="Tratta il secret come una password">
Puoi mostrare il signing secret in Tillor tramite **Mostra la chiave di firma** nella tabella dei webhook. Conservalo come secret (variabile d'ambiente, vault) e non scriverlo mai nei log. Sospetti una fuga? Elimina il webhook e creane uno nuovo: otterrai un nuovo secret.
</Callout>

---

## Comportamento di consegna e nuovi tentativi [#leveringsgedrag-en-retries]

- Rispondi con uno **stato 2xx** per confermare il successo.
- In caso di consegna fallita (non 2xx, errore di rete o destinazione bloccata) Tillor riprova automaticamente la consegna con intervalli sempre più lunghi. Ogni tentativo riutilizza lo stesso payload, la stessa firma e lo stesso ID evento (idempotente).

| Tentativo | Attesa dal tentativo precedente |
|---|---|
| 1 | subito |
| 2 | 1 secondo |
| 3 | 2 secondi |
| 4 | 4 secondi |
| 5 | 8 secondi |
| 6 | 5 minuti |
| 7 | 30 minuti |
| 8 | 2 ore |
| 9 | 6 ore |
| 10 | 24 ore |

- Se uno dei tentativi riesce (2xx) → la consegna è conclusa.
- Se anche il tentativo 10 (dopo 24 ore) fallisce → la consegna viene **contrassegnata definitivamente come fallita** e non viene più ritentata.
- Se nel frattempo il webhook viene **disattivato**, Tillor smette di riprovare.

```mermaid
flowchart TD
  A[Evento emesso] --> B[Consegna al tuo endpoint]
  B -- 2xx --> Z[Concluso]
  B -- fallita --> C[Ritentata<br/>1s, 2s, 4s, 8s,<br/>5m, 30m, 2h, 6h, 24h]
  C -- 2xx --> Z
  C -- tutti i tentativi falliti --> F[Definitivamente fallita]
```

<Callout type="info" title="Idempotenza">
Ogni nuovo tentativo riutilizza lo stesso `X-Webhook-Event-ID` e lo stesso `X-Webhook-Signature`. Deduplica dal tuo lato su quell'header, così un nuovo tentativo riuscito dopo un 200 lento non causa un'elaborazione doppia.
</Callout>

### Notifiche in caso di errori persistenti [#meldingen-bij-aanhoudende-fouten]

Se le consegne a un endpoint webhook continuano a fallire, Tillor invia **al massimo due notifiche per incidente** (per endpoint):

1. **Dopo 5 minuti di errori persistenti** - e-mail all'indirizzo e-mail dell'organizzazione (`supportEmail`, altrimenti `email`) e ai membri dell'organizzazione con il diritto di modificare le impostazioni dell'organizzazione, più push (se attivato) per quei membri. L'e-mail indica da quando le consegne falliscono. Le date nell'e-mail usano il **fuso orario** di *Impostazioni > Generale* (per impostazione predefinita `Europe/Brussels`).
2. **In caso di fallimento definitivo** - gli stessi destinatari ricevono una notifica quando il primo evento di quell'incidente è stato contrassegnato come definitivamente fallito dopo tutti i tentativi.

**Non** ricevi una notifica per ogni evento fallito. Quando tutte le consegne fallite di un endpoint sono risolte (consegnate con successo), un nuovo incidente ricomincia con le stesse regole.

In **Menu del profilo → Sviluppatori** la tabella dei webhook mostra per endpoint uno stato di consegna compatto (numero di consegne in attesa di un nuovo tentativo e definitivamente fallite). Clicca sull'icona **ℹ** per i dettagli, incluso il messaggio di errore completo e il payload del tentativo più recente.

- **Riprovi non riuscita** (↻): solo le consegne definitivamente fallite di quel webhook.
- **Forza il nuovo tentativo** (⚡): tutte le consegne in attesa e definitivamente fallite di quel webhook, indipendentemente dai tempi di attesa pianificati. Tillor lo avvia in background, così le code grandi (ad es. migliaia di eventi) vengono elaborate in sicurezza.
- **Forza, riprovi tutto** in alto a destra accanto a **Aggiunga webhook**: lo stesso per tutti i webhook attivi dell'organizzazione.

---

## Tipi di evento [#event-types]

Le chiavi degli eventi usano il formato `entity:action` o `entity:subresource:action`. L'elenco completo, con il permesso per ogni evento e un esempio di payload, si trova nell'[indice degli eventi](/ontwikkelaars/events). Quella pagina viene generata dal codice ed è quindi sempre completa. Le stesse chiavi si trovano in Tillor sotto [Menu del profilo → Sviluppatori](https://tillor.eu/orgs/org_abc123/developers), in **Aggiunga webhook** → **Eventi iscritti**.


---

## Webhook vs SSE [#webhooks-vs-sse]

| Caso d'uso | Raccomandazione |
|----------|-------------|
| Integrazione lato server | **Webhook** - il tuo server riceve le POST |
| Logging semplice | **Webhook** - configurazione minima |
| Dashboard in tempo reale, aggiornamenti live nell'app | [SSE](/ontwikkelaars/sse) - una sola connessione, bassa latenza. |
| Molti tipi di evento, filtro lato client | [SSE](/ontwikkelaars/sse) - usa il parametro di query `events` per limitare il traffico. |

---

## Correlati [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - specifica completa dell'API
- [API HTTP](/ontwikkelaars/http) - API REST e chiavi API
- [SSE](/ontwikkelaars/sse) - Gli stessi eventi tramite Server-Sent Events
- [Automazioni](/ontwikkelaars/automatiseringen) - Inviare messaggi propri da un'automazione


# API della chat del sito web (/it-IT/ontwikkelaars/website-chat)

Il widget ufficiale lo installi nell'app: vedi [Mettere la chat sul tuo sito web](/inbox/website-chat). Le opzioni dello snippet sono in [Impostazioni della Chat sul sito web](/inbox/website-chat-instellingen). Questa pagina è per gli sviluppatori: l'SDK del widget per un modulo tuo e il livello REST per una **interfaccia di chat tua**. Vedi [OpenAPI](https://tillor.eu/api/openapi.json), tag `inbox`.

## SDK del widget [#widget-sdk]

Dopo il caricamento dello script del widget, `window.TillorInbox` è pronto. Con esso passi i dati di contatto dal tuo modulo (pagina contatti, dettaglio di una vendita, richiesta di preventivo). Tutti i metodi aspettano che la configurazione del widget sia caricata.

| Metodo | Descrizione |
|---------|--------------|
| `ready()` | Promise che si risolve non appena il widget è caricato |
| `getVisitor()` | Legge i dati di contatto salvati da `localStorage` e i campi del widget compilati; sincrono, senza rete |
| `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Compila i campi della chat senza inviare |
| `open()` | Apre la finestra della chat |
| `close()` | Chiude la finestra della chat |
| `toggle()` | Apre o chiude la finestra della chat |
| `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Invia un messaggio con i dati di contatto |

`getVisitor()` restituisce questo oggetto:

| Campo | Descrizione |
|------|--------------|
| `visitorId` | ID di questo visitatore in questo browser (`localStorage`) |
| `name` | Nome completo (un solo campo nel widget) |
| `firstName` / `lastName` | Ricavati da `name` (prima parola / resto) |
| `email`, `phone` | Dati di contatto |
| `customFields` | Campi aggiuntivi dalle impostazioni del widget |
| `message` | Bozza nel campo del messaggio |
| `detailsSubmitted` | Se il modulo del visitatore risulta compilato |

Usa `getVisitor()` per precompilare un modulo tuo da `localStorage` (stesso browser, anche dopo un aggiornamento della pagina).

Opzioni per `setVisitor` (secondo argomento):

| Opzione | Predefinito | Spiegazione |
|-------|-----------|--------|
| `open` | `false` | Apre subito la finestra della chat |
| `markSubmitted` | `false` | Nasconde il modulo del visitatore se tutti i campi obbligatori sono compilati |
| `onlyEmpty` | `false` | Sovrascrive solo i campi vuoti |
| `persist` | `false` | Conserva i dati in `localStorage` (stesso browser, anche dopo una nuova scheda) |

Opzioni per `send`:

| Opzione | Predefinito | Spiegazione |
|-------|-----------|--------|
| `open` | `false` | Apre la finestra della chat prima dell'invio |
| `silent` | `true` se `open` è false | Nessun suono, nessun messaggio di errore nel widget; usa la Promise per successo o errore |
| `markSubmitted` | `true` | Dopo l'invio i dati di contatto non devono essere reinseriti nel widget |
| `metadata` | - | Suggerimenti facoltativi per Tillie (non visibili nella finestra della chat); vedi [metadata](#metadata-boekingsformulier) |

Con `open: false` (predefinito) il pulsante della chat resta chiuso. Il messaggio arriva comunque a Tillor; il tuo modulo può ringraziare o mostrare un errore. Con `open: true` si apre la finestra della chat e il visitatore vede il normale comportamento di invio (suono, spunte, eventuali errori del widget).

Vuoi usare un pulsante tuo invece del pulsante di chat flottante? Imposta `data-launcher="false"` sullo snippet e chiama `TillorInbox.open()`.

### `metadata` (modulo di prenotazione) [#metadata-boekingsformulier]

Usa `metadata` quando hai un modulo tuo sul sito web e Tillie deve inviare **solo una conferma**, senza domande successive (ad esempio perché la scheda si chiude subito dopo).

| Chiave | Tipo | Spiegazione |
|---------|------|--------|
| `forceHandover` | `boolean` | Messaggio di conferma e passaggio a un collega, senza domande di raccolta dati. Ignora anche la pausa dell'AI dopo un messaggio del team (vedi `ignoreAiPause`) |
| `ignoreAiPause` | `boolean` | Tillie risponde anche quando è in pausa in modalità **Automatico** dopo un messaggio del team (30 minuti). Utile per l'invio silenzioso di moduli; combinalo con `forceHandover` oppure lascia che Tillie faccia normalmente la raccolta dati |
| `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Facoltativo: flusso per il passaggio (predefinito: dedotto automaticamente dal messaggio) |
| `source` | `string` | Etichetta di integrazione facoltativa per il tuo team (lettere minuscole, cifre, `-`, `_`; max. 64 caratteri) |

```javascript
await TillorInbox.send({
  name: "Jan Janssens",
  email: "jan@voorbeeld.be",
  phone: "+32 3 779 81 64",
  body: structuredBookingMessage,
  silent: true,
  metadata: {
    forceHandover: true,
    handoverIntent: "reservation",
    source: "website_booking_form",
  },
});
```

### Sostituire il modulo di contatto (invio silenzioso) [#contactformulier-vervangen-stille-verzending]

Usa questo quando vuoi mantenere il modulo di contatto esistente, ma far passare i messaggi da Tillor senza aprire la finestra della chat.

```html
<form id="site-contact-form">
  <input name="name" type="text" required />
  <input name="email" type="email" required />
  <input name="phone" type="tel" />
  <textarea name="message" required></textarea>
  <button type="submit">Verstuur</button>
  <p id="contact-status" hidden></p>
</form>

<script>
  document.getElementById("site-contact-form").addEventListener("submit", async (event) => {
    event.preventDefault();
    const form = event.currentTarget;
    const status = document.getElementById("contact-status");
    const data = new FormData(form);

    try {
      await TillorInbox.send({
        name: String(data.get("name") ?? ""),
        email: String(data.get("email") ?? ""),
        phone: String(data.get("phone") ?? ""),
        body: String(data.get("message") ?? ""),
      });
      status.textContent = "Bedankt, we nemen snel contact op.";
      status.hidden = false;
      form.reset();
    } catch (error) {
      status.textContent = error instanceof Error ? error.message : "Versturen mislukt.";
      status.hidden = false;
    }
  });
</script>
```

Non devi impostare `open` e `silent`: senza `open: true` la finestra resta chiusa e Tillor tratta la chiamata come invio silenzioso.

### Collegare il modulo di contatto (aprire la chat) [#contactformulier-koppelen-chat-openen]

Passare i campi e aprire la finestra della chat, così il visitatore vede la conversazione:

```html
<form id="site-contact-form">
  <input name="name" type="text" required />
  <input name="email" type="email" required />
  <input name="phone" type="tel" />
  <textarea name="message" required></textarea>
  <button type="submit">Verstuur</button>
</form>

<script>
  document.getElementById("site-contact-form").addEventListener("submit", (event) => {
    event.preventDefault();
    const form = event.currentTarget;
    const data = new FormData(form);
    void TillorInbox.send({
      name: String(data.get("name") ?? ""),
      email: String(data.get("email") ?? ""),
      phone: String(data.get("phone") ?? ""),
      body: String(data.get("message") ?? ""),
      open: true,
    });
  });
</script>
```

Oppure compilare solo i campi e aprire la finestra, senza inviare subito:

```javascript
void TillorInbox.setVisitor(
  {
    name: "Jan Janssens",
    email: "jan@voorbeeld.be",
    phone: "+32 3 779 81 64",
    message: "Ik heb een vraag over de stacaravan te koop.",
  },
  { markSubmitted: true, open: true },
);
```

Una pagina di vendita con invio immediato e apertura della chat:

```javascript
void TillorInbox.send({
  name: "Jan Janssens",
  email: "jan@voorbeeld.be",
  phone: "+32 3 779 81 64",
  body: "Ik heb interesse in deze stacaravan.",
  open: true,
});
```

Sincronizzare in tempo reale mentre qualcuno digita:

```javascript
const form = document.getElementById("site-contact-form");
form.addEventListener("input", () => {
  void TillorInbox.setVisitor({
    name: form.name.value,
    email: form.email.value,
    phone: form.phone.value,
    message: form.message.value,
  });
});
```

### Chiamare in anticipo (prima dello script del widget) [#vroeg-aanroepen-vóór-het-widget-script]

Se chiami un metodo prima che lo script sia caricato, metti la chiamata in coda:

```html
<script>
  window.TillorInbox = window.TillorInbox || { q: [] };
  window.TillorInbox.q.push([
    "setVisitor",
    { name: "Jan", email: "jan@voorbeeld.be" },
    { open: true },
  ]);
</script>
<script src="https://tillor.eu/inbox-widget.js" data-org-id="org_abc123" data-widget-key="iwk_xxx" async defer></script>
```

## Interfaccia di chat propria [#eigen-chat-ui]

Se crei un'interfaccia di chat tua invece del widget, usa il livello REST qui sotto.

Autenticazione: header `X-Tillor-Inbox-Widget-Key` (valore da *Impostazioni > Integrazioni > Chat sul sito web*).

### Digitazione [#typen]

```http
POST /api/orgs/{orgId}/inbox/website/typing
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json

{
  "visitorId": "vis_…",
  "active": true,
  "visitorName": "Jan",
  "visitorEmail": "jan@voorbeeld.nl",
  "visitorPhone": "+32470123456"
}
```

- `active: true` quando il visitatore digita; `false` quando il campo è vuoto o il visitatore smette (il widget invia `false` dopo circa 4 secondi senza input)
- `visitorName` / `visitorEmail` / `visitorPhone` sono facoltativi
- Usa lo stesso `visitorId` di `POST …/inbox/website/messages` e `GET …/inbox/website/messages`

### Tempo reale (SSE) [#realtime-sse]

```http
GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_…
X-Tillor-Inbox-Widget-Key: iwk_xxx
Accept: text/event-stream
```

| Evento | Quando |
|-------|--------|
| `inbox:website:message-created` | Nuovo messaggio del team o dell'AI |
| `inbox:website:message-updated` | Messaggio del team o dell'AI modificato o eliminato |
| `inbox:website:typing-changed` | `data.staffTyping` o `data.staffOutboundSenderType` cambia |

La forma del payload è la stessa dell'[SSE dell'organizzazione](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Riconnettiti dopo un'interruzione; non c'è ripresa.

Il widget ufficiale usa SSE come livello primario e richiede di nuovo `GET …/messages` ogni **5 secondi** come fallback (ogni **1 secondo** con il pannello aperto quando SSE si interrompe per un momento). In questo modo le risposte vengono contrassegnate come **consegnate** finché il visitatore è sulla pagina.

### Attività dei visitatori [#bezoekersactiviteit]

```http
POST /api/orgs/{orgId}/inbox/website/events
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json
```

`event`: `chat_closed`, `tab_hidden` o `navigation` (con la navigazione anche `url`). Il tuo team vede questi eventi come testo informativo grigio nella conversazione, vedi [Conversazioni tramite Chat sul sito web](/inbox/website-chat-gesprekken).

### Limiti [#limieten]

`POST …/inbox/website/messages` e `POST …/inbox/website/attachments/upload` rispondono `429` quando un visitatore o una rete invia troppo. Il corpo contiene `data.reason` = `INBOX_WIDGET_RATE_LIMITED` e `data.retryAfterSeconds`. Limiti per organizzazione:

| Percorso | Per visitatore (`visitorId`) | Per rete (indirizzo IP) |
|----------|------------------------------|-------------------------|
| `messages` | 10 al minuto, 200 al giorno | 30 al minuto, 600 al giorno |
| `attachments/upload` | 10 all'ora | 50 all'ora |

Aspetta `retryAfterSeconds` prima di riprovare e mostra un avviso al visitatore invece di riprovare automaticamente.

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Chat sul sito web (app)" href="/inbox/website-chat" />
  <Card title="Impostazioni della Chat sul sito web" href="/inbox/website-chat-instellingen" />
  <Card title="SSE" href="/ontwikkelaars/sse" />
  <Card title="OpenAPI" href="https://tillor.eu/api/openapi.json" />
</Cards>


# Un ospite alla barriera (/it-IT/praktijk/gast-aan-de-slagboom)

Un ospite arriva alla barriera di Recreatiepark Het Meer e deve poter passare senza l'aiuto della reception. Questo esempio segue Jonas Maes dall'impostazione del suo metodo di accesso fino a cosa succede quando non funziona (più). Vedi come un metodo di accesso, un controller e un punto di accesso lavorano insieme.

```mermaid
flowchart LR
  A[Metodo di accesso del cliente] --> B[Ospite al punto di accesso]
  B --> C{Controller e Tillor verificano}
  C -->|valido| D[Consentito, barriera aperta]
  C -->|scaduto o bloccato| E[Negato, visibile nel registro]
```

Prima di iniziare:

- Il tuo parco ha almeno un punto di accesso collegato a Tillor. Si trova sotto **Azioni rapide** nella pagina **Controllo accessi** con un pulsante **Apri [nome punto di accesso]**.
- Il controller alla barriera è collegato alla tua organizzazione. Un nuovo controller compare sotto **Controller** con **In attesa di approvazione** finché non clicchi su **Approva**. Vedi [Controller](/controllers).
- Per un tag NFC: il tag deve essere già in Tillor. Succede da solo non appena è stato avvicinato a un lettore per la prima volta.

## Il percorso passo per passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Aggiungi un metodo di accesso [#voeg-een-toegangsmethode-toe]
Vai a <UIPath>Clienti > Jonas Maes > Controllo accessi</UIPath> e clicca su **Aggiungi**. Scegli il **Tipo** e, se vuoi, compila una **Data inizio** e una **Data fine**. Quel periodo determina quando il metodo funziona.

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Scheda Controllo accessi con la tabella Metodi di accesso" />

<Tabs items={["Targa", "Codice QR", "Tag NFC"]}>
<Tab value="Targa">
Scegli **Riconoscimento targa** e compila la **Targa**. La telecamera al punto di accesso legge la targa e Tillor trova il cliente corrispondente.
</Tab>
<Tab value="Codice QR">
Scegli **Codice QR**. Tillor crea il codice da sé. Nel menu del metodo copia l'**URL personale** e invialo a Jonas. Lui apre la pagina **Pass di accesso** e può aggiungere il pass ad Apple Wallet o Google Wallet, se è impostato per il tuo ambiente.
</Tab>
<Tab value="Tag NFC">
Scegli **NFC** e seleziona una carta NFC disponibile dall'elenco. Se l'elenco è vuoto, avvicina prima il tag a un lettore. Vedi [Gestire i tag](/nfc/nfc-tags).
</Tab>
</Tabs>

Vedi [Controllo accessi](/toegangscontrole).
</Step>
<Step>
### Controlla controller e punto di accesso [#controleer-controller-en-toegangspunt]
Il controller o la telecamera al punto di accesso riceve da Tillor l'elenco dei metodi validi. Sotto **Operazioni controller** nella pagina **Controllo accessi** vedi quando un pass o un codice QR è stato inoltrato al punto di accesso. Se l'operazione non c'è ancora, la sincronizzazione è ancora in corso.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Operazioni controller con azioni di sincronizzazione e whitelist" />
</Step>
<Step>
### Segui cosa succede alla barriera [#volg-wat-er-aan-de-slagboom-gebeurt]
Il blocco **Registro accessi** mostra ogni tentativo con data, metodo, cliente, punto di accesso e stato. Un ospite che entra compare nella tabella **Veicoli nel parco** con lo stato **All'interno**. Quando esce, diventa **Uscito**.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Registro accessi con targhe, cliente e stato" />
</Step>
<Step>
### Apri tu stesso la barriera se serve [#open-de-slagboom-zelf-als-het-nodig-is]
Sotto **Azioni rapide** clicca su **Apri [nome punto di accesso]** e conferma con **Sì, apri [nome punto di accesso]**. Chiudere è possibile solo se il punto di accesso lo supporta.
</Step>
</Steps>

## Cosa succede con un metodo scaduto? [#wat-gebeurt-er-bij-een-verlopen-methode]

Se la **Data fine** è passata, il metodo non dà più accesso e il tentativo compare nel registro con lo stato **Scaduto**. Altri stati che incontri sono **Bloccato**, **Inattivo** e **Negato**.

Per le targhe esiste una tolleranza, così gli ospiti non si trovano di notte davanti a un'uscita chiusa. Se **Consenti l'uscita alle targhe scadute** è attivo (predefinito), la barriera di uscita si apre ancora durante il periodo di tolleranza. Dura per impostazione predefinita 2 giorni e al massimo 30. Funziona solo fuori dagli orari di apertura. Se la reception è aperta, il personale gestisce il veicolo al banco. Una targa bloccata o inattiva non ha mai tolleranza, e i tag NFC e i codici QR non hanno tolleranza. Lo imposti in <UIPath>Assistenza > Impostazioni > Controllo accessi</UIPath>, vedi [Impostazioni del controllo accessi](/gebruikers/instellingen-toegangscontrole).

## Cosa succede dopo? [#wat-gebeurt-er-daarna]

- Ogni tentativo resta nel registro accessi. Puoi filtrare per cliente, stato e punto di accesso ed esportare in Excel.
- Un veicolo che non è stato visto a un punto di accesso per 7 giorni riceve lo stato **Fantasma**. Se la targa viene rivista più tardi a un ingresso, torna a **All'interno**.
- Se prolunghi la **Data fine** del metodo, questo funziona di nuovo dopo la sincronizzazione successiva con il punto di accesso.

## Problemi? [#problemen]

<Accordions>
<Accordion title="L'ospite è davanti a una barriera chiusa">
Cerca il tentativo nel registro accessi e leggi lo stato. **Scaduto** significa che la **Data fine** è passata, **Bloccato** o **Inattivo** che il metodo è disattivato. Se il metodo è a posto, controlla **Operazioni controller**. Se non riesci a risolvere in fretta, apri la barriera tramite **Azioni rapide**.
</Accordion>
<Accordion title="Nel registro non c'è nessun tentativo">
Allora Tillor non ha ricevuto nulla. Controlla se il controller è online e se lo schermo mostra un messaggio. Vedi [Messaggi sullo schermo](/controllers/troubleshooting/scherm) e [Problemi di connessione](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="La targa non viene riconosciuta">
Controlla che la targa sia stata inserita senza spazi o errori di battitura. Una targa letta male può anche far restare un veicolo come **Fantasma**.
</Accordion>
<Accordion title="Non vedo nessuna carta NFC nell'elenco">
Il tag non è ancora noto a Tillor oppure è già assegnato a un altro cliente. Avvicinalo prima a un lettore, oppure scollegalo dall'altro cliente.
</Accordion>
</Accordions>

## Vedi anche [#zie-ook]

<Cards>
  <Card title="Controllo accessi" href="/toegangscontrole" />
  <Card title="Controller" href="/controllers" />
  <Card title="NFC" href="/nfc" />
  <Card title="Impostazioni del controllo accessi" href="/gebruikers/instellingen-toegangscontrole" />
</Cards>


# Panoramica (/it-IT/praktijk)

Nella maggior parte dei compiti tocchi più di un modulo: un nuovo cliente diventa un'occupazione, un contratto, una fattura e un pagamento. Questi esempi percorrono un simile itinerario dall'inizio alla fine. Usano l'organizzazione demo Recreatiepark Het Meer, con il cliente Jonas Maes e il terreno 12. Ogni passaggio rimanda alla pagina con la spiegazione completa.

<Cards>
  <Card title="Acquisire un cliente stagionale" href="/praktijk/seizoensklant-binnenhalen" description="Cliente, occupazione, contratto di affitto, fattura, pagamento e report dei pagamenti" />
  <Card title="Addebitare i consumi" href="/praktijk/verbruik-aanrekenen" description="Dal contatore al terreno fino alla fattura automatica delle utenze" />
  <Card title="Una casa mobile si libera" href="/praktijk/stacaravan-komt-vrij" description="Chiusura dell'occupazione, attività di follow-up e restituzione della cauzione" />
  <Card title="Un ospite alla barriera" href="/praktijk/gast-aan-de-slagboom" description="Metodo di accesso, controller, punto di accesso e cosa succede alla scadenza" />
</Cards>

## Come si collega tutto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Cliente] --> B[Occupazione]
  T[Terreno] --> B
  M[Contatore] --> T
  B --> V[Consumi]
  K --> O[Richiesta di firma]
  B --> F[Fattura]
  V --> F
  F --> P[Pagamento]
  P --> R[Report dei pagamenti]
  K --> TM[Metodo di accesso]
  TM --> TP[Punto di accesso]
  B -->|termina| A[Automazione]
  A --> TK[Attività]
```

Leggi gli esempi come un itinerario: puoi salire a bordo in qualsiasi punto. Se vuoi rileggere i termini, guarda i [Concetti](/begrippen).

## Concetti [#begrippen]

- **Occupazione**: un cliente su un terreno per un periodo più lungo. Vedi [Occupazione](/begrippen#bezetting).
- **Terreno**: una piazzola del tuo parco. Vedi [Terreno](/begrippen#terrein).
- **Richiesta di firma**: un pdf che viene firmato online. Vedi [Richiesta di firma](/begrippen#ondertekenverzoek).
- **Automazione**: una regola che Tillor esegue da sé. Vedi [Automazione](/begrippen#automatisering).


# Acquisire un cliente stagionale (/it-IT/praktijk/seizoensklant-binnenhalen)

Acquisire un cliente stagionale significa, in Tillor: creare il cliente, assegnargli un terreno, far firmare il contratto di affitto, fatturare il canone di sosta e fare in modo che il pagamento arrivi nella Sua contabilità. Questo esempio percorre l'intero iter per Jonas Maes, che al Recreatiepark Het Meer affitta il terreno 12 per la stagione. Ogni passaggio rimanda alla pagina con la spiegazione completa.

```mermaid
flowchart LR
  A[Creare il cliente] --> B[Occupazione sul terreno 12]
  B --> C[Firma del contratto di affitto]
  C --> D[Fatturare il canone di sosta]
  D --> E[Pagamento]
  E --> F[Report dei pagamenti]
```

Prima di iniziare:

- Il terreno 12 esiste e non ha un'occupazione attiva. Se ne ha una, non compare nell'elenco di scelta di **Crea occupazione**.
- Esiste un prodotto con l'azione **Estendi periodo occupazione**, spesso Canone di sosta. Vedere [Collegare azioni a un prodotto](/producten/acties-instellen).
- Ha il contratto di affitto pronto in PDF.
- Ha il permesso **Gestire le richieste di firma** per far firmare il contratto.
- Per la firma a distanza il cliente ha bisogno di un indirizzo e-mail o di un numero di telefono. Per un mandato SEPA serve un indirizzo e-mail.

## L'iter passo per passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Creare il cliente [#maak-de-klant-aan]
Vada su <UIPath>Clienti > Panoramica</UIPath> e faccia clic su **Crea nuovo cliente**. Se nella coda c'è una scansione di un documento d'identità, scelga quella scansione nel menu a tendina: Tillor compila i dati a partire dal documento. Altrimenti scelga **Manuale** e compili **Nome di battesimo**, **Cognome**, **Indirizzo e-mail** e **Numero di telefono**.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Finestra Crea nuovo cliente" />

Dopo la creazione arriva sul profilo di Jonas. Completi lì l'indirizzo. Per saperne di più, vedere [Gestione clienti](/klantenbeheer) e [Scansioni dei documenti d'identità](/identiteitsscans).
</Step>
<Step>
### Assegnare a Jonas il terreno 12 [#geef-jonas-terrein-12]
Nel suo profilo apra la scheda **Panoramica**, vada alla card **Occupazioni** e faccia clic su **Crea occupazione**. In **Terreno** scelga il terreno 12. Se necessario compili **Pagato fino al**, il **Tipo** e la **Frequenza affitto**. Il prezzo viene preso per impostazione predefinita dal terreno.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Card Occupazioni sul profilo del cliente" />

Se il terreno 12 ha dei contatori, ora può compilare anche le **Letture contatore iniziali**. Vedere [Occupazioni](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Far firmare il contratto di affitto [#laat-het-huurcontract-tekenen]
Vada su <UIPath>Amministrazione > Firme</UIPath> e faccia clic su **Richiedi firme**. Scelga Jonas Maes come **Cliente**, carichi il contratto, aggiunga Jonas come firmatario con **Cliente: Jonas Maes** e inserisca un campo firma. Se vuole, aggiunga un collaboratore come secondo firmatario.

<Tabs items={["A distanza", "Alla reception"]}>
<Tab value="A distanza">
Faccia clic su **Invia**. Jonas riceve un'e-mail con un link personale, oppure un SMS se è disponibile solo un numero di telefono. Firma dal proprio dispositivo e conferma con un codice di 6 cifre.
</Tab>
<Tab value="Alla reception">
Faccia clic su **Invia**, apra la richiesta e faccia clic su **Firma sul tablet** accanto a Jonas. Scelga **Con codice**, oppure **Senza codice** se ha verificato la sua identità al banco. Il contratto si apre sul tablet, con il suo nome a caratteri grandi.
</Tab>
</Tabs>

Tutti i dettagli sono in [Richiedere firme](/handtekeningen/handtekening-vragen) e [Come firma una persona](/handtekeningen/ondertekenen).
</Step>
<Step>
### Contabilizzare il canone di sosta [#boek-het-staangeld]
Torni alla card **Occupazioni** sul profilo di Jonas, apra il menu accanto all'occupazione e scelga **Estendi occupazione (fattura)**. Faccia clic su **Crea bozza fattura**. Tillor crea una bozza di fattura con il prodotto che ha l'azione **Estendi periodo occupazione**. Controlli il periodo sulla fattura e faccia clic su **Contabilizza fattura**.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Bozza di fattura con il pulsante Contabilizza fattura" />

La fattura riceve un numero di fattura e lo stato <Status tone="success">Contabilizzata</Status>. Vedere [Contabilizzare una fattura](/facturen/boeken) e [Estendere l'occupazione](/bezettingen#facturatie-bezetting-verlengen).
</Step>
<Step>
### Scegliere come paga Jonas [#kies-hoe-jonas-betaalt]
La contabilizzazione non invia nulla al cliente. Ora sceglie come deve arrivare il denaro.

<Tabs items={["Link di pagamento", "Addebito con mandato", "Alla reception"]}>
<Tab value="Link di pagamento">
Faccia clic su **Invia notifica** e scelga un canale come **E-mail**. Jonas riceve il pulsante **Visualizza e paga online** e completa il pagamento, per esempio, con iDEAL o Bancontact. Se vuole prima pagare solo una parte, crei un [link per un pagamento parziale](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Vedere [Pagare online](/betalingsverwerking/online).
</Tab>
<Tab value="Addebito con mandato">
Richieda prima un mandato tramite <UIPath>Clienti > Jonas Maes > Fatturazione</UIPath> e **Creare mandato**. Non appena lo stato è <Status tone="success">Attivo</Status>, nella fattura scelga quel mandato in **Mandato di addebito**. Tillor incassa l'importo due giorni dopo la contabilizzazione, oppure due giorni dopo il collegamento se la fattura era già contabilizzata. Vedere [Far firmare un mandato SEPA](/betalingsverwerking/mandaat) e [Incassare una fattura](/betalingsverwerking/incasso).
</Tab>
<Tab value="Alla reception">
Faccia clic su **Effettua pagamento** e scelga **Terminale**, **Contanti** o **Bonifico**. Vedere [Registrare un pagamento](/betalingsverwerking/betaling-registreren).
</Tab>
</Tabs>
</Step>
<Step>
### Vedere arrivare il pagamento [#zie-de-betaling-binnenkomen]
Il pagamento si trova in <UIPath>Amministrazione > Pagamenti</UIPath>. Un pagamento online compare non appena Mollie lo conferma. Un addebito ha dapprima lo stato <Status tone="warning">In attesa</Status> e dopo alcuni giorni diventa <Status tone="success">Pagato</Status>. Quando tutto è incassato, la fattura passa a <Status tone="success">Pagata</Status>.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Panoramica di tutti i pagamenti" />

Per saperne di più, vedere [Ritrovare i pagamenti](/betalingsverwerking/betalingen-bekijken).
</Step>
<Step>
### Vedere il pagamento nel report dei pagamenti [#zie-de-betaling-in-het-betalingsrapport]
Vada su <UIPath>Amministrazione > Report dei pagamenti</UIPath>. I pagamenti di oggi compaiono nel report con lo stato **Bozza**. Tillor rende definitivo il report al successivo controllo giornaliero, nei giorni lavorativi alle 09:00. Se il collegamento con la contabilità è attivo, Tillor inoltra il report da sé.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Elenco dei report dei pagamenti" />

Vedere [Report dei pagamenti](/boekhouden/betalingsrapporten).
</Step>
</Steps>

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- L'occupazione di Jonas è in corso. Il terreno 12 non è più disponibile per altri clienti e il consumo dei contatori sul terreno va a Jonas.
- Quando tutti hanno firmato, la richiesta passa a <Status tone="success">Completata</Status>. Il PDF firmato con le pagine di prova si trova nei suoi **Documenti**. Se vuole che un'automazione faccia qualcosa a quel punto, per esempio creare un'attività, usi il trigger **Richiesta di firma completata**.
- Quando la fattura viene contabilizzata, Tillor imposta **Fatturato fino al** alla fine della riga di fattura. Dopo il pagamento, **Pagato fino al** avanza. Vedere [Pagato fino al, tipo, frequenza di affitto e prezzo](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).
- La stagione successiva estenderà di nuovo la stessa occupazione con **Estendi occupazione (fattura)**, oppure, per tutte le occupazioni di un cliente insieme, con **Estendi tutte**.
- I pagamenti Mollie compaiono nel report in bozza come anticipo su Mollie, finché non è noto l'accredito.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il terreno 12 non compare nell'elenco di Crea occupazione">
Un terreno può essere collegato a un solo cliente alla volta. Se esiste già un'occupazione attiva, non compare nell'elenco. Termini prima quell'occupazione, vedere [Terminare un'occupazione](/bezettingen#een-bezetting-beëindigen).
</Accordion>
<Accordion title="Non riesco a inviare la richiesta di firma">
Tillor controlla la richiesta e indica che cosa manca: un firmatario senza campo firma, un firmatario senza indirizzo e-mail o numero di telefono, oppure un titolo vuoto. Risolva il problema e riprovi. Vedere [Richiedere firme](/handtekeningen/handtekening-vragen#problemen).
</Accordion>
<Accordion title="Il pulsante Contabilizza fattura è grigio">
Passi con il mouse sul pulsante: Tillor mostra il motivo. Spesso manca una data di inizio o di fine su una riga con un'occupazione, oppure l'importo supera il massimo del mandato collegato. Vedere [Quando la contabilizzazione non riesce](/facturen/boeken#problemen).
</Accordion>
<Accordion title="Estendi occupazione (fattura) non produce una fattura utilizzabile">
Deve esistere almeno un prodotto con l'azione **Estendi periodo occupazione**. Senza un prodotto simile Tillor non può costruire la riga. Crei il prodotto o aggiunga l'azione, vedere [Collegare azioni a un prodotto](/producten/acties-instellen).
</Accordion>
<Accordion title="Mandato SEPA è grigio in Effettua pagamento">
Jonas non ha un mandato con lo stato <Status tone="success">Attivo</Status> il cui importo massimo sia abbastanza alto. Controlli la card **Mandati** nella sua scheda **Fatturazione**.
</Accordion>
<Accordion title="La fattura è in attesa">
Il pagamento è stato avviato, ma il denaro non è ancora arrivato in via definitiva. È normale con un addebito. Non appena il pagamento è elaborato, lo stato passa a **Pagata**. Vedere [Stati](/facturen/statussen).
</Accordion>
</Accordions>

## Vedere anche [#zie-ook]

<Cards>
  <Card title="Fatturare il consumo" href="/praktijk/verbruik-aanrekenen" description="Il seguito: ciò che Jonas consuma di acqua ed elettricità" />
  <Card title="Occupazioni" href="/bezettingen" />
  <Card title="Firme" href="/handtekeningen" />
  <Card title="Fatture" href="/facturen" />
  <Card title="Elaborazione dei pagamenti" href="/betalingsverwerking" />
</Cards>


# Una roulotte si libera (/it-IT/praktijk/stacaravan-komt-vrij)

Quando un cliente lascia una roulotte fissa, c'è del lavoro da fare: la roulotte va controllata e la cauzione va restituita al cliente. Questo esempio mostra come Tillor mette insieme tutto. Chiude l'occupazione, un'automazione crea un'attività di controllo finale, un collaboratore porta a termine l'attività e poi sistema la cauzione. Come esempio usiamo Jonas Maes e il terreno 12 del Recreatiepark Het Meer, ora come affittuario di una roulotte fissa.

```mermaid
flowchart LR
  A[Chiudere l'occupazione] --> B[Automazione]
  B --> C[Attività di controllo con sottoattività]
  C --> D[Il collaboratore la completa]
  D --> E[Cauzione restituita con nota di credito]
```

Prima di iniziare:

- Il terreno 12 ha il tipo di terreno **Roulotte** e Jonas vi ha un'occupazione attiva. Vedere [Tipi di terreno](/terreinen#terreintypes).
- Esiste un'automazione che alla fine di un'occupazione crea un'attività. Come costruirla è spiegato in [Esempio: controllo finale della roulotte in affitto](/automatiseringen/voorbeeld-nalopen). Negli ambienti demo è già pronta con il nome **Controllo finale roulotte in affitto**, in pausa, finché non attiva l'interruttore **Attiva**.
- Per la cauzione: il prodotto cauzione ha l'opzione **Controlla il saldo del cliente su questo conto** attivata. Vedere [Controllare il saldo del cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

## L'iter passo per passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Chiudere l'occupazione [#stop-de-bezetting]
Apra il profilo di Jonas, nella scheda **Panoramica** vada alla card **Occupazioni**, apra il menu accanto all'occupazione e scelga **Rimuovi**. In **Data** scelga il giorno in cui parte. Se il terreno ha dei contatori, compili le **Letture contatore finali**. Faccia clic su **Rimuovi**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu delle azioni di un'occupazione" />

Il terreno 12 torna quindi libero per una nuova occupazione. Vedere [Terminare un'occupazione](/bezettingen#een-bezetting-beëindigen).
</Step>
<Step>
### Lasciare che l'automazione crei l'attività di controllo [#laat-de-automatisering-de-nalooptaak-maken]
Non deve fare nulla. L'automazione parte non appena l'occupazione termina e controlla innanzitutto se il terreno ha il tipo di terreno **Roulotte**. Poi cerca se esiste già un'attività aperta **Controllo finale** per questo terreno.

- Se non c'è ancora un'attività aperta, crea un'attività **Controllo finale terreno 12** con cinque sottoattività (**Pulizia**, **Arredi**, **Internet + TV**, **Cornice con codice QR** e **Verifica di piccoli lavori**) e una scadenza a 7 giorni. L'attività va anche al collaboratore che ha chiuso l'occupazione.
- Se c'è già un'attività aperta, per esempio perché la roulotte si è liberata due volte a breve distanza, non ne crea una seconda. La priorità dell'attività esistente sale di un livello, fino a **Alta**.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Passaggio Crea attività di controllo nell'automazione" />

Può seguire ciò che ha fatto l'automazione in [Test ed esecuzioni](/automatiseringen/testen-en-uitvoeringen).
</Step>
<Step>
### Portare a termine l'attività [#werk-de-taak-af]
Il collaboratore trova l'attività nella card **Attività per Lei** della dashboard, nella scheda **Attività** di Jonas, oppure in una vista sotto **Attività**. L'attività è collegata al terreno 12 e a Jonas.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Finestra dell'attività con descrizione, sottoattività e proprietà" />

<Tabs items={["Con sottoattività", "Con pulsanti di scelta"]}>
<Tab value="Con sottoattività">
Apra l'attività e spunti ogni sottoattività non appena è fatta. Accanto all'attività compare un contatore come **2/5**. Quando tutte le sottoattività sono pronte, imposti lo stato su **Completata**. Se imposta l'attività principale su **Completata**, anche le sottoattività aperte vengono completate.
</Tab>
<Tab value="Con pulsanti di scelta">
Se ha esteso l'automazione con il passaggio **Chiedi una decisione**, per esempio per decidere se la cauzione va restituita per intero, sull'attività compaiono dei pulsanti sotto **Scegli un'azione per completare questa attività**. Un clic completa l'attività. Se la scelta richiede un motivo, si apre **Perché questa scelta?**. Una scelta effettuata non può più essere annullata. Vedere [Attività con pulsanti di scelta](/taken/taakdetails#taken-met-keuzeknoppen) e [Chiedi una decisione](/automatiseringen/logica#vraag-om-een-beslissing).
</Tab>
</Tabs>
</Step>
<Step>
### Controllare il saldo della cauzione [#controleer-het-saldo-van-de-waarborg]
Apra il profilo di Jonas e vada alla scheda **Fatturazione**. Nella tabella **Conti** vede il saldo per ogni conto. Il conto della cauzione mostra quanto Jonas ha ancora a credito.
</Step>
<Step>
### Creare la nota di credito per la cauzione [#maak-de-creditnota-voor-de-waarborg]
Apra la fattura della cauzione di Jonas, faccia clic sui tre puntini in alto a destra e scelga **Storna fattura**. Tillor crea una bozza di fattura con le stesse righe in importi negativi. Se trattiene una parte, per esempio per un danno, adegui l'importo. Faccia clic su **Contabilizza fattura**. La fattura diventa una **Nota di credito**.

Tillor rifiuta una fattura che porterebbe il saldo del conto della cauzione sotto zero. In questo modo non è possibile restituire due volte la stessa cauzione. Vedere [Stornare una fattura](/facturen/corrigeren#een-factuur-omkeren).
</Step>
<Step>
### Compensare l'importo [#verreken-het-bedrag]
Se c'è ancora una fattura aperta di Jonas, per esempio per l'ultimo consumo, può compensare l'importo con il metodo di pagamento **Trasferimento interno**. Vedere [Creare un trasferimento interno](/betalingsverwerking/interne-overboeking).
</Step>
</Steps>

<Callout type="info" title="Restituire il denaro">
Tillor registra la nota di credito e la compensazione. Il versamento dell'importo sul conto bancario del cliente va effettuato tramite la Sua banca.
</Callout>

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- Il terreno è di nuovo libero. Un nuovo cliente può prendervi un'occupazione o ricevere una prenotazione.
- I periodi di consumo aperti di Jonas sono chiusi, con le letture finali che ha inserito. Il consumo fino alla data di fine resta registrato e può ancora essere fatturato. Vedere [Fatturare il consumo](/praktijk/verbruik-aanrekenen).
- L'attività e le azioni su di essa compaiono nella cronologia dell'attività e sul profilo di Jonas. Le modifiche all'occupazione compaiono nella sua scheda **Eventi**.
- La nota di credito entra nella contabilità come ogni altra fattura.

## Problemi? [#problemen]

<Accordions>
<Accordion title="Non è stata creata alcuna attività di controllo">
Controlli tre cose. L'interruttore **Attiva** dell'automazione è acceso? Il tipo di terreno del terreno 12 è **Roulotte**? Verifichi in [Test ed esecuzioni](/automatiseringen/testen-en-uitvoeringen) se l'automazione è partita e dove si è fermata.
</Accordion>
<Accordion title="Ci sono due attività di controllo, oppure ce n'è solo una">
L'automazione cerca un'attività aperta con esattamente lo stesso titolo, **Controllo finale** seguito dal nome del terreno, per lo stesso terreno, lo stesso cliente o la stessa prenotazione. Se il titolo non corrisponde, non trova l'attività esistente e ne crea una nuova. Un'attività aperta riceve solo una priorità più alta, non una seconda attività.
</Accordion>
<Accordion title="Non riesco a completare l'attività">
Se compare **Completata dalla sua automazione**, solo l'automazione può completare l'attività e l'attività non ha **Rimuovi**. Vedere [Dettagli dell'attività](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
<Accordion title="Non vedo i pulsanti di scelta">
Può scegliere chi è assegnato all'attività e un amministratore. Se nessuno è assegnato, può scegliere chiunque veda l'attività. Se al posto dei pulsanti compare una spunta, l'attività non proviene da un passaggio **Chiedi una decisione**.
</Accordion>
<Accordion title="Contabilizza fattura è grigio nella nota di credito della cauzione">
Il saldo del conto della cauzione scenderebbe sotto zero. Controlli la tabella **Conti** e l'importo sulla fattura. Con il permesso **Ignorare il saldo del conto** può contabilizzare comunque, con una motivazione che finisce nella cronologia della fattura.
</Accordion>
</Accordions>

## Vedere anche [#zie-ook]

<Cards>
  <Card title="Esempio: controllo finale della roulotte in affitto" href="/automatiseringen/voorbeeld-nalopen" description="Così costruisce da sé l'automazione" />
  <Card title="Attività" href="/taken" />
  <Card title="Correggere una fattura" href="/facturen/corrigeren" />
  <Card title="Occupazioni" href="/bezettingen" />
</Cards>


# Fatturare il consumo (/it-IT/praktijk/verbruik-aanrekenen)

In Tillor il consumo si fattura passando dal terreno: un contatore appartiene a un terreno, un cliente arriva sul terreno tramite un'occupazione e il consumo del contatore va a quel cliente. Questo esempio segue il contatore elettrico sul terreno 12 del Recreatiepark Het Meer, dal collegamento alla fattura di Jonas Maes. Alla fine è spiegato come Tillor può anche creare e inviare da sé quella fattura.

```mermaid
flowchart LR
  A[Contatore] -->|collegare| B[Terreno 12]
  B --- C[Occupazione di Jonas]
  A -->|letture| D[Consumo di Jonas]
  D --> E[Consumo in sospeso]
  E --> F[Fattura]
  F -.->|automatico| G[Fattura delle utenze in un giorno fisso]
```

Prima di iniziare:

- Il contatore esiste già in <UIPath>Parco > Contatori</UIPath> e non è ancora collegato a un terreno. Un contatore già collegato a un terreno non compare nell'elenco di scelta.
- Jonas ha un'occupazione attiva sul terreno 12. Vedere [Acquisire un cliente stagionale](/praktijk/seizoensklant-binnenhalen). Senza occupazione Tillor non sa a chi appartiene il consumo.
- Per la fattura automatica Jonas ha bisogno di un indirizzo e-mail o di un numero di telefono e, per l'incasso automatico, di un mandato attivo.

## L'iter passo per passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Collegare il contatore al terreno 12 [#koppel-de-meter-aan-terrein-12]
Vada su <UIPath>Parco > Terreni</UIPath>, apra il terreno 12 e scorra fino alla card **Contatori**. Faccia clic su **Aggiungi contatore**, scelga il contatore e faccia clic su **Assegna contatore**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Pagina di dettaglio del terreno 12 con la card Contatori" />

Vedere [Gestione dei contatori](/meterbeheer/meter-koppelen) e [Terreni](/terreinen).
</Step>
<Step>
### Registrare la lettura iniziale [#leg-de-beginstand-vast]
Se Jonas è già iscritto sul terreno 12, inserisca la lettura iniziale nell'occupazione. Se crea l'occupazione solo adesso, compili **Letture contatore iniziali**. Se lascia il campo vuoto, Tillor usa l'ultima lettura nota. In questo modo il primo lotto di consumo parte subito dalla lettura giusta. Vedere [Occupazioni](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Seguire le letture [#volg-de-meterstanden]
I contatori intelligenti inviano da soli la loro lettura, di solito ogni giorno o ogni settimana. Un contatore manuale lo legge e lo inserisce Lei stesso. Vedere [Gestione dei contatori](/meterbeheer).

Il consumo si vede in due punti. Nella pagina del contatore, sotto <UIPath>Parco > Contatori</UIPath>, c'è la card **Consumo** con, per ogni cliente, il consumo in sospeso e quello saldato. Nel profilo di Jonas c'è la card **Letture**, con tutti i contatori sui suoi terreni.

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Pagina del contatore con la card Consumo" />

Se qualcuno inserisce una lettura inferiore alla precedente, Tillor avvisa. Se la lettura è comunque corretta (il contatore è stato sostituito), Tillor chiude il periodo in corso e ne inizia uno nuovo. Vedere [Lotti di consumo](/meterbeheer/consumptie-batches).
</Step>
<Step>
### Vedere che cosa è in sospeso [#bekijk-wat-openstaat]
Vada su <UIPath>Clienti > Consumi in sospeso</UIPath>. Vede per ogni cliente l'importo totale, l'**Ultima bolletta** e il numero di contatori. Jonas compare non appena c'è del consumo che non è ancora in una fattura.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Panoramica Clienti con consumo in sospeso" />
</Step>
<Step>
### Creare la fattura [#maak-de-factuur]
Ha due modi.

<Tabs items={["Dall'elenco", "Dal profilo del cliente"]}>
<Tab value="Dall'elenco">
Faccia clic sull'icona di invio alla fine della riga di Jonas. La finestra **Crea fattura** mostra l'importo totale, la ripartizione per tipo e il numero di contatori. Selezioni i canali con cui Tillor invia subito la fattura e faccia clic su **Crea fattura**. Tillor crea la fattura, la contabilizza e la invia. Se Jonas ha un mandato per le fatture delle utenze, questo è già selezionato in **Incassa con mandato**.
</Tab>
<Tab value="Dal profilo del cliente">
Apra il profilo di Jonas e nella card **Letture** faccia clic su **Fattura consumo**. Tillor inserisce per ogni periodo di consumo una riga principale con sotto una riga informativa con la data e le letture. Se esiste già una bozza di fattura adatta, le righe vengono aggiunte a quella. Controlli la fattura, la contabilizzi e la invii Lei stesso. Vedere [Contabilizzare una fattura](/facturen/boeken) e [Inviare una fattura](/facturen/versturen).
</Tab>
</Tabs>
</Step>
<Step>
### Lasciare che sia Tillor a occuparsene [#laat-tillor-het-zelf-doen]
Apra il profilo di Jonas, vada su <UIPath>Clienti > Jonas Maes > Fatturazione</UIPath> e apra la card **Impostazioni di fatturazione**. Lì imposta:

- **Fatturazione automatica delle utenze**: un giorno del mese. Se sceglie 31 e il mese non ha 31 giorni, la fattura viene emessa l'ultimo giorno del mese.
- **Mandato**: il mandato con cui Tillor incassa la fattura delle utenze. Vedere [Incassare una fattura](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
- **Importo minimo**: un limite minimo specifico per Jonas. Se lo lascia vuoto, vale il minimo dell'organizzazione in <UIPath>Assistenza > Impostazioni > Fatturazione</UIPath>.

Nel giorno scelto Tillor crea la fattura da sé e la invia. Se l'importo in sospeso è inferiore al minimo, Tillor aspetta il giorno di fatturazione successivo.
</Step>
</Steps>

## Che cosa succede dopo? [#wat-gebeurt-er-daarna]

- I periodi di consumo fatturati sono conclusi. Se l'occupazione continua, Tillor avvia un nuovo periodo dalla lettura finale del precedente, così non resta alcun buco.
- Una volta contabilizzata, la fattura segue il percorso di ogni altra fattura: pagamento, sollecito e report dei pagamenti. Vedere [Acquisire un cliente stagionale](/praktijk/seizoensklant-binnenhalen).
- Alla fine dell'occupazione Tillor chiude i periodi in sospeso. Il consumo fino alla data di fine resta registrato e può ancora essere fatturato.
- Se elimina una bozza di fattura con consumo, il consumo torna in **Consumi in sospeso**.

<Callout type="info" title="Consumo ben al di sopra del solito">
Se il consumo di elettricità o acqua in sospeso è almeno il doppio di quello abituale di Jonas, Tillor non crea la fattura automatica. Riceve un'e-mail all'indirizzo di assistenza dell'organizzazione. Controlli la lettura del contatore e, se tutto è corretto, fatturi Lei stesso il consumo.
</Callout>

## Problemi? [#problemen]

<Accordions>
<Accordion title="Il contatore non compare nell'elenco di Aggiungi contatore">
L'elenco mostra solo i contatori senza terreno. Se il contatore è già collegato a un altro terreno, lo scolleghi prima dal menu del contatore su quel terreno, con **Scollega dal terreno**.
</Accordion>
<Accordion title="Jonas non ha consumo sul contatore del terreno 12">
Il consumo va al cliente con un'occupazione attiva sul terreno. Controlli che Jonas abbia un'occupazione sul terreno 12 e che il contatore sia collegato al terreno.
</Accordion>
<Accordion title="Jonas non compare in Consumi in sospeso">
Per impostazione predefinita l'elenco mostra solo i clienti senza fatturazione automatica. Imposti il filtro **Fatturazione automatica** su **Con data** per vedere i clienti con un giorno di fatturazione automatica.
</Accordion>
<Accordion title="La fattura automatica non è stata creata">
Ci sono due motivi frequenti. L'importo in sospeso è inferiore al minimo: in tal caso Tillor aspetta il giorno di fatturazione successivo. Oppure il consumo è ben al di sopra del solito: in tal caso riceve un'e-mail all'indirizzo di assistenza e la fattura non viene emessa finché qualcuno non l'ha verificata. Vedere [Gestione dei contatori](/meterbeheer/verbruik-factureren#automatisch-factureren).
</Accordion>
<Accordion title="Ho già fatturato il consumo fuori da Tillor">
Apra il periodo nella card **Letture** o **Consumo**, faccia clic sull'icona di avviso accanto al periodo e confermi con **Sì, segna come fatturato**. Il periodo si chiude quindi senza fattura. Può annullare l'operazione solo per i periodi senza collegamento a una fattura.
</Accordion>
</Accordions>

## Vedere anche [#zie-ook]

<Cards>
  <Card title="Gestione dei contatori" href="/meterbeheer" />
  <Card title="Lotti di consumo" href="/meterbeheer/consumptie-batches" description="Come vengono tenuti e fatturati i periodi di consumo" />
  <Card title="Incassare una fattura" href="/betalingsverwerking/incasso" />
  <Card title="Impostazioni di fatturazione" href="/gebruikers/instellingen-facturatie" />
</Cards>