# Aperçu (/fr-FR/aan-de-slag)

Cette page vous accompagne pendant votre premier jour dans Tillor, de la connexion à votre première facture. L'ordre compte, car chaque élément s'appuie sur le précédent. Une occupation, par exemple, a besoin d'un client et d'un terrain : vous les créez donc en premier. Si vous préférez suivre un exemple tiré de la vie réelle, consultez [Dans la pratique](/praktijk). Si vous rencontrez un mot que vous ne connaissez pas, cherchez-le dans [Glossaire](/begrippen).

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Voici les éléments de base et ce dont ils ont besoin :

```mermaid
flowchart LR
  I[Paramètres] --> T[Terrains]
  T --> B[Occupation]
  T --> R[Réservation]
  K[Clients] --> B
  K --> R
  P[Produits] --> F[Facture]
  K --> F
  B --> F
  R --> F
  F --> Bet[Paiement]
```

Une facture est toujours liée à un client. Un client sur un terrain pour une longue durée s'appelle une occupation ; un séjour avec une date d'arrivée et de départ est une réservation. Les produits ne sont pas obligatoires, mais ils garantissent que le prix, la TVA et les actions de la ligne de facture sont corrects.

<Callout type="info" title="Bon à savoir">
- Si vous avez plus d'une organisation, vous en choisissez une après la connexion. S'il en manque une, demandez à votre administrateur de vous inviter.
- Les éléments de menu que vous voyez dépendent de vos autorisations. Si vous ne voyez pas quelque chose, demandez l'autorisation à votre administrateur.
- Sans terrain, vous ne pouvez pas créer d'occupation. Sans client, vous ne pouvez créer ni réservation, ni occupation, ni facture.
- Les paiements en espèces, par virement et les autres paiements manuels fonctionnent sans liaison. Pour payer en ligne ou par carte, vous connectez Mollie.
- La façon la plus rapide de retrouver quelque chose est de lancer une recherche avec **Ctrl+K** ou **⌘K**.
</Callout>

Avant de commencer :

- Vous avez un compte Microsoft, Google ou Apple et votre administrateur vous a invité dans votre organisation. Sans invitation, vous ne voyez aucune organisation.
- Vous avez les autorisations pour ce que vous voulez faire. Si elles vous manquent, l'élément de menu est absent ou le bouton est grisé.

## Configurer votre parc [#je-park-inrichten]

<Steps>
<Step>
### Connectez-vous et choisissez votre organisation [#log-in-en-kies-je-organisatie]
Connectez-vous avec votre compte Microsoft, Google ou Apple. Si vous avez accès à plus d'une organisation, vous en choisissez une. Si vous n'avez pas encore accès, demandez à votre administrateur de vous inviter. Voir [Connexion](/inloggen).
</Step>
<Step>
### Passez en revue les paramètres de l'organisation [#loop-de-organisatie-instellingen-na]
Ouvrez <UIPath>Support > Paramètres</UIPath>. Sous **Général**, vérifiez le fuseau horaire et le pays par défaut, et sous **Heures d'ouverture**, renseignez vos horaires. Sous **Facturation** se trouvent notamment le délai d'échéance par défaut et les taux de TVA. Vous invitez vos collègues sous **Utilisateurs**. Voir [Organisation](/gebruikers/organisaties).
</Step>
<Step>
### Créez vos terrains [#maak-je-terreinen-aan]
Allez dans <UIPath>Parc > Terrains</UIPath> et ajoutez vos emplacements, comme des parcelles, des chalets et des places fixes. Sans terrain, vous ne pouvez pas créer d'occupation, et vous liez les compteurs à un terrain. Voir [Terrains](/terreinen).
</Step>
<Step>
### Créez vos produits [#maak-je-producten-aan]
Allez dans <UIPath>Administration > Produits</UIPath> et créez les tarifs et les services qui figurent sur les factures, comme les nuitées. Une ligne de facture peut aussi exister sans produit, mais avec un produit, le prix, la TVA et les éventuelles actions sont immédiatement corrects. Voir [Produits](/producten).
</Step>
<Step>
### Ajoutez vos clients [#voeg-je-klanten-toe]
Allez dans <UIPath>Clients > Aperçu</UIPath> et créez un client. Les réservations, les occupations et les factures sont toujours liées à un client. Voir [Gestion des clients](/klantenbeheer).
</Step>
<Step>
### Créez une réservation ou une occupation [#maak-een-reservering-of-bezetting-aan]
Une réservation concerne un séjour avec une date d'arrivée et de départ, et vous pouvez aussi la créer sans terrain fixe. Une occupation lie un client à un terrain pour une longue durée, par exemple une place à l'année. Voir [Réservations](/reserveringen) et [Occupations](/bezettingen).
</Step>
<Step>
### Créez votre première facture [#maak-je-eerste-factuur]
Ouvrez le profil du client et créez-y une nouvelle facture. Ajoutez des lignes, comptabilisez la facture et envoyez-la. Voir [Factures](/facturen).
</Step>
<Step>
### Connectez les paiements [#koppel-betalingen]
Si vous voulez que vos clients paient en ligne ou par carte, connectez Mollie via <UIPath>Support > Paramètres</UIPath> sous **Intégrations**. Les paiements en espèces, par virement et les autres paiements manuels fonctionnent sans liaison. Voir [Traitement des paiements](/betalingsverwerking) et [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).
</Step>
</Steps>

Si vous utilisez des compteurs, des barrières ou des badges NFC, vous les configurez ensuite. Consultez d'abord [Parc](/park) et [Contrôle d'accès](/toegangscontrole).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Vos clients, vos terrains et vos produits sont prêts, de sorte que vous pouvez créer chaque jour des réservations, des occupations et des factures.
- Votre première facture est enregistrée comme brouillon chez le client. Ce n'est qu'après **Comptabiliser** qu'elle reçoit un numéro définitif, et vous pouvez ensuite l'envoyer et la faire payer.
- Si vous avez connecté Mollie, vos clients peuvent payer en ligne ou par carte et le paiement revient automatiquement sur la facture.

## Trouver votre chemin [#je-weg-vinden]

Le menu principal se trouve à gauche. En haut, vous changez d'organisation si vous en avez plus d'une. Les éléments que vous voyez dépendent de vos autorisations.

<DocScreenshot src="/screenshots/inleiding/dashboard-welcome.png" alt="Tableau de bord - écran d'accueil après la connexion" />

| Menu | À quoi il sert |
|------|----------|
| **Tableau de bord** | Écran d'accueil avec les arrivées et les départs du jour |
| **Réservations** | Séjours et calendrier des réservations |
| **Tâches** | Répartir et suivre le travail |
| **Contrôle d'accès** | Points d'accès et journal d'accès |
| **Clients** | **Aperçu** et **Consommation impayée** |
| **Parc** | **Carte**, **Terrains**, **Compteurs**, **Armoires à compteurs** et **Météo** |
| **Communication** | **Appels téléphoniques**, **Notifications** et **Commentaires** |
| **Administration** | **Documents**, **Signatures**, **Factures**, **Paiements**, **Transactions bancaires** (avec l'autorisation de les consulter), **Rapports de paiement**, **File d'impression** et **Produits** |

Sous le titre **Administrateur** se trouvent **Automatisations** (avec l'autorisation de les consulter) et **Contrôleurs**. En bas, sous **Support**, vous trouvez vos alertes, **Boîte de réception** et **Journal d'audit** (avec les autorisations correspondantes), **Paramètres** et **Plus de ressources** avec la documentation. Les éléments que vous voyez dépendent de vos autorisations.

Pour rechercher, utilisez **Recherche** dans l'en-tête, ou **⌘K** (Mac) ou **Ctrl+K** (Windows). Vous accédez ainsi directement à un client, une facture, une réservation ou un terrain. Voir [Recherche](/zoeken).

Vous trouvez votre propre compte, vos sessions et vos clés API via votre nom en bas du menu.


## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je n'arrive pas à entrer dans mon organisation">
Votre administrateur doit d'abord vous inviter. Connectez-vous avec le compte avec lequel il vous a invité. Voir [Connexion](/inloggen).
</Accordion>
<Accordion title="Je ne vois pas un élément de menu mentionné dans ce manuel">
Vous ne voyez que les éléments pour lesquels vous avez des autorisations. Demandez à votre administrateur l'autorisation, ou le rôle qui l'inclut.
</Accordion>
<Accordion title="Je ne peux pas créer d'occupation">
Aucun terrain n'est disponible, ou le client n'existe pas encore. Créez d'abord un terrain et un client. Un terrain avec une occupation en cours ne figure pas dans la liste de choix.
</Accordion>
<Accordion title="Je ne sais pas où trouver quelque chose">
Utilisez **Recherche** dans l'en-tête, ou cherchez dans ce manuel avec la barre de recherche en haut.
</Accordion>
</Accordions>

## Besoin d'aide ? [#hulp-nodig]

- Si vous cherchez quelque chose dans ce manuel, utilisez la barre de recherche en haut ou choisissez dans Tillor **Plus de ressources > Documentation**.
- Tillor ne fonctionne pas comme prévu ? Consultez d'abord l'[état du système](https://status.tillor.eu) pour les pannes et les maintenances planifiées.
- Il vous manque l'accès à une organisation, ou vous voulez modifier les données de l'entreprise sur les factures ? Écrivez à support@tillor.eu.
- Récupérer des données depuis une sauvegarde ? Voir [Données et sauvegardes](/gegevens-backups).

## Glossaire [#begrippen]

- **Organisation** : votre compte Tillor, en général votre entreprise. Voir [Glossaire](/begrippen#organisatie).
- **Parc** : le lieu physique. Voir [Glossaire](/begrippen#park).
- **Client** : une personne ou une entreprise dans Tillor. Voir [Glossaire](/begrippen#klant).
- **Terrain** : un emplacement dans votre parc. Voir [Glossaire](/begrippen#terrein).
- **Occupation** et **réservation** : un client sur un terrain pour une longue durée, ou un séjour avec une date d'arrivée et de départ. Voir [Glossaire](/begrippen#bezetting).
- **Comptabiliser** : rendre une facture définitive. Voir [Glossaire](/begrippen#boeken).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Dans la pratique" href="/praktijk" description="Exemples détaillés d'une journée de travail" />
  <Card title="Glossaire" href="/begrippen" description="Tous les termes en un coup d'œil" />
  <Card title="Connexion" href="/inloggen" description="Méthodes de connexion et votre compte" />
  <Card title="Recherche" href="/zoeken" description="Trouvez rapidement ce que vous cherchez" />
  <Card title="Données et sauvegardes" href="/gegevens-backups" description="Durées de conservation et restauration" />
  <Card title="Nouveautés" href="/wat-is-nieuw" description="Modifications récentes, mois par mois" />
</Cards>


# Glossaire (/fr-FR/begrippen)

Tillor utilise certains mots plus souvent que vous n'en avez l'habitude, et certains se ressemblent. Cette page indique pour chaque terme ce qu'il signifie et où en lire davantage. La liste est classée par ordre alphabétique (selon les termes néerlandais). Si vous cherchez quelque chose sur les contrôleurs eux-mêmes, comme ACL ou firmware, consultez le [lexique des contrôleurs](/controllers/lexicon).

<Callout type="info" title="Deux mots souvent confondus">
Une **occupation** est un client qui reste longtemps sur un terrain, comme un client saisonnier. Une **réservation** est une réservation pour un seul séjour. Par **comptabiliser**, Tillor entend toujours le fait de rendre une facture définitive, jamais le fait de réserver un séjour.
</Callout>

### Rappel de paiement [#aanmaning]

Un rappel envoyé à un client pour lui signaler qu'une facture comptabilisée n'est pas encore payée. Vous l'envoyez par facture, avec le même lien pour payer en ligne. Voir [Envoyer un rappel de paiement](/facturen/versturen#een-aanmaning-versturen).

### Automatisation [#automatisering]

Une règle que Tillor exécute lui-même : quand ceci se produit, fais cela. Par exemple, créer une tâche de suivi lorsqu'une occupation se termine. Les étapes d'une automatisation forment ensemble un flux, le schéma sur le canevas. Voir [Automatisations](/automatiseringen).

### Paiement [#betaling]

Un montant qu'un client paie ou qui est encore en route, avec une méthode, un statut et généralement une facture. Vous les trouvez sous <UIPath>Administration > Paiements</UIPath>. Voir [Retrouver des paiements](/betalingsverwerking/betalingen-bekijken).

### Groupe de paiements [#betalingsgroep]

Un lot de paiements sous un même nom, que vous liez ensuite en une fois à une facture comptabilisée. Par exemple, tous les paiements par carte d'une journée. Voir [Groupes de paiements](/betalingsverwerking/groepen).

### Rapport de paiement [#betalingsrapport]

L'aperçu de tous les paiements d'un jour calendrier, destiné à votre comptabilité. Le rapport du jour est un brouillon et devient définitif une fois la journée terminée. Voir [Rapports de paiement](/boekhouden/betalingsrapporten).

### Page de preuve [#bewijspagina]

Les pages à la fin d'un PDF signé, avec le titre du document, qui a signé et quand, et deux empreintes numériques. Elles s'intitulent **Preuve de signature** et montrent plus tard que le document n'a pas été modifié. Voir [Preuve et validité](/handtekeningen/bewijs-en-geldigheid).

### Occupation [#bezetting]

Un client qui se trouve sur un terrain pour une période prolongée. Tant que l'occupation est en cours, Tillor facture à ce client la consommation des compteurs de ce terrain. Un terrain n'a au plus qu'un client à la fois. Voir [Occupations](/bezettingen).

### Comptabiliser [#boeken]

Rendre définitive une facture brouillon. La facture reçoit un numéro de facture et vous ne pouvez plus la modifier librement. Ce mot n'a rien à voir avec la réservation dans Tillor. Voir [Comptabiliser une facture](/facturen/boeken).

### Brouillon [#concept]

Une facture qui n'est pas encore comptabilisée. Vous pouvez encore modifier les lignes et rien n'est encore parti vers le client ni vers la comptabilité. Voir [Statuts d'une facture](/facturen/statussen).

### Connecteur [#connector]

Un petit boîtier dans le réseau de votre parc qui relie Tillor aux appareils sur place, comme les imprimantes et les contrôleurs d'accès. Tillor le livre préconfiguré et le met à jour lui-même. Voir [Connecteur](/connector).

### Contrôleur [#controller]

Un boîtier avec écran tactile sur votre parc, près d'une douche ou d'une porte. Il lit un badge NFC ou un code QR, et Tillor décide si le client peut passer. Vous gérez les contrôleurs sous **Contrôleurs**. Voir [Contrôleurs](/controllers).

### Note de crédit [#creditnota]

Une facture avec des montants négatifs qui annule une facture précédente. L'application appelle cela une **facture de crédit**. Vous la créez avec **Inverser la facture**. Voir [Inverser une facture](/facturen/corrigeren#een-factuur-omkeren).

### Champ personnalisé [#eigen-veld]

Un champ que votre organisation ajoute elle-même à un client, un terrain, une occupation, un compteur ou une tâche, en plus des champs fournis par Tillor. Vous les gérez sous <UIPath>Paramètres > Champs personnalisés</UIPath>. Voir [Champs personnalisés](/eigen-velden).

### Facture [#factuur]

Ce que vous facturez à un client, avec des lignes par produit. Une nouvelle facture est toujours un brouillon. Vous la créez sur le profil du client et vous gérez toutes les factures sous <UIPath>Administration > Factures</UIPath>. Voir [Factures](/facturen).

### Événement [#gebeurtenis]

Une ligne dans la chronologie d'un client, d'une facture ou d'un autre enregistrement, qui montre ce qui s'est passé, par qui et ce qui a changé. Voir [Journal d'activité](/activiteitenlog).

### Utilisateur [#gebruiker]

Un compte qui a accès à Tillor. Dans le texte courant, nous appelons un autre utilisateur un collègue. Vous gérez les utilisateurs et leurs autorisations sous <UIPath>Paramètres > Utilisateurs</UIPath>. Voir [Organisation](/gebruikers/organisaties).

### Groupe [#groep]

Un ensemble fixe de collègues, par exemple **Réception**. Vous attribuez des tâches à un groupe, partagez des vues avec un groupe et pouvez accorder ou retirer des autorisations à un groupe. Voir [Groupes](/gebruikers/groepen). Un groupe de paiements est autre chose.

### Grand livre [#grootboek]

Le numéro de compte de votre comptabilité sur lequel un produit est comptabilisé. Vous le renseignez dans le produit, et il est transmis lors de l'envoi vers votre comptabilité. Voir [Le numéro de grand livre](/producten/product-aanmaken#grootboeknummer).

### Prélèvement [#incasso]

Tillor prélève lui-même le montant d'une facture sur le compte bancaire du client. Cela n'est possible qu'avec un mandat actif. Voir [Prélever une facture](/betalingsverwerking/incasso).

### Liste de choix [#keuzelijst]

Une liste fixe d'options dans laquelle puise un champ personnalisé de type **Choix** ou **Choix multiple**. Vous créez la liste une fois et l'utilisez dans plusieurs champs. Voir [Listes de choix](/eigen-velden/keuzelijsten).

### Kiosque [#kiosk]

Une tablette Android qui affiche l'application Tillor et y reste, afin que les clients n'accèdent pas aux réglages de l'appareil. Voir [Configurer un kiosque](/mobiele-app/kiosk-inrichten).

### Client [#klant]

L'enregistrement dans Tillor d'une personne ou d'une entreprise : données, factures, occupations, méthodes d'accès et plus encore. Nous n'utilisons le mot hôte que dans le texte courant, pour quelqu'un qui séjourne sur votre parc. Voir [Gestion des clients](/klantenbeheer).

### Mandat [#mandaat]

L'autorisation d'un client de prélever des factures sur son compte bancaire (un mandat SEPA). Le client le signe dans Tillor même. Voir [Faire signer un mandat SEPA](/betalingsverwerking/mandaat).

### Compteur [#meter]

Un appareil pour l'eau, l'électricité ou le gaz. Un compteur appartient à un terrain, pas à un client. La consommation est imputée au client qui a, à ce moment-là, une occupation sur le terrain. Voir [Gestion des compteurs](/meterbeheer).

### Armoire à compteurs [#meterkast]

Une armoire dans laquelle se trouvent des compteurs. Sous <UIPath>Parc > Armoires à compteurs</UIPath>, vous gérez les armoires à compteurs et les compteurs qui leur sont attribués. Voir [Parc](/park#meterkasten).

### Badge NFC [#nfc-tag]

Une carte, un bracelet ou un porte-clés qu'un client approche d'un contrôleur, par exemple pour la douche ou un point d'accès. Un badge peut avoir un solde. Voir [NFC](/nfc).

### Notification [#notificatie]

Un message que Tillor envoie à un client ou à un collègue, par e-mail, SMS, courrier, WhatsApp ou push. Sous <UIPath>Communication > Notifications</UIPath>, vous voyez s'il est arrivé. Voir [Notifications](/notificaties).

### Demande de signature [#ondertekenverzoek]

La demande de faire signer en ligne un PDF, comme un contrat de location, par une ou plusieurs personnes l'une après l'autre. Vous les gérez sous <UIPath>Administration > Signatures</UIPath>. Voir [Signatures](/handtekeningen).

### Consommation impayée [#openstaand-verbruik]

La consommation des compteurs qui ne figure pas encore sur une facture. Vous la voyez par client sous <UIPath>Clients > Consommation impayée</UIPath> et vous la facturez avec **Facturer la consommation**. Voir [Gestion des compteurs](/meterbeheer/verbruik-factureren).

### Remarque [#opmerking]

Une note interne sur un client, une facture, une réservation ou un autre enregistrement. Les remarques ne sont jamais visibles pour le client. Voir [Remarques](/notities).

### Organisation [#organisatie]

Votre compte Tillor, donc votre entreprise avec ses utilisateurs, ses paramètres et ses données. Le parc est le lieu physique. Voir [Organisation](/gebruikers/organisaties).

### Parc [#park]

Le lieu physique : votre camping ou parc de loisirs. Sous **Parc**, vous trouvez la carte, les terrains, les compteurs et les armoires à compteurs. Voir [Parc](/park).

### Peppol [#peppol]

Un réseau européen qui permet d'envoyer des factures électroniquement et directement vers le système comptable du destinataire, sans PDF. Il est obligatoire pour les factures belges adressées à des entreprises disposant d'un numéro de TVA. Voir [Peppol](/boekhouden/peppol).

### Produit [#product]

Un tarif ou un service que vous placez sur une ligne de facture, comme une nuit, un droit de stationnement ou un kWh d'électricité. Un produit peut avoir des actions que Tillor exécute lors de la comptabilisation ou du paiement. Voir [Produits](/producten).

### Action de produit [#productactie]

Quelque chose que Tillor fait automatiquement lorsqu'une ligne de facture comportant ce produit est comptabilisée ou payée, comme prolonger une occupation ou recharger un badge NFC. Voir [Actions de produit](/producten/productacties).

### Autorisation [#recht]

Ce qu'un utilisateur peut faire dans Tillor, par exemple modifier des produits ou rétablir des factures. Vous accordez des autorisations par utilisateur ou via un groupe. Un refus via un groupe l'emporte toujours. Voir [Modifier les autorisations](/gebruikers/organisaties#rechten-bewerken) et [Autorisations de groupe](/gebruikers/groepen#groepsrechten).

### Réservation [#reservering]

Une réservation pour un seul séjour sur un terrain, avec arrivée et départ. Une réservation n'est pas la même chose qu'une occupation. Voir [Réservations](/reserveringen).

### Tâche [#taak]

Un travail pour vous-même ou pour un collègue, avec notamment une échéance, des sous-tâches et des clients ou terrains liés. Vous consultez les tâches dans des vues. Voir [Tâches](/taken).

### Tablette [#tablet]

L'appareil à la réception sur lequel tourne l'application Tillor, par exemple pour faire signer un contrat ou un mandat à un client. Les tablettes, les kiosques et les téléphones sur lesquels quelqu'un est connecté se trouvent sous **Paramètres**. Voir [Tablettes et kiosques](/mobiele-app/tablets-en-kiosken).

### Terrain [#terrein]

Un emplacement de votre parc que vous louez ou sur lequel vous planifiez des séjours, avec un nom et éventuellement des compteurs. Vous liez des compteurs à un terrain, et les clients y arrivent par une occupation ou une réservation. Voir [Terrains](/terreinen).

### Type de terrain [#terreintype]

Une classification de vos terrains, comme **Emplacement**, **Chalet** ou **Place pour camping-car**. Vous utilisez le type pour filtrer la liste, colorer la carte et dans les automatisations. Voir [Types de terrain](/terreinen#terreintypes).

### Méthode d'accès [#toegangsmethode]

La façon dont un client passe un point d'accès : reconnaissance de plaque d'immatriculation, badge NFC ou code QR. Vous les gérez chez le client sous l'onglet **Contrôle d'accès**. Voir [Contrôle d'accès](/toegangscontrole).

### Point d'accès [#toegangspunt]

Une barrière, un portail ou une porte électronique où l'accès est contrôlé. Vous pouvez ouvrir et fermer un point d'accès depuis Tillor et voir dans le journal qui est passé. Voir [Contrôle d'accès](/toegangscontrole).

### Déclencheur [#trigger]

Le début d'une automatisation : l'événement, le moment ou le message qui la fait démarrer. Un déclencheur peut avoir un filtre, de sorte que l'automatisation ne démarre que si une condition est remplie. Voir [Déclencheurs](/automatiseringen/triggers).

### Lot de consommation [#verbruiksbatch]

Une période de consommation de compteur pour un client et un compteur, avec un relevé de début et de fin. L'application appelle cela une **période de consommation** ; dans ce manuel, on trouve aussi le terme lot de consommation. Voir [Lots de consommation](/meterbeheer/consumptie-batches).

### Vue [#weergave]

Une manière enregistrée de consulter vos tâches, par exemple **Tâches ouvertes** ou **Maintenance**. Chaque vue figure comme onglet en haut de la page Tâches. Voir [Vues](/taken/weergaven).

### Sceau [#zegel]

La signature numérique de votre organisation avec laquelle Tillor clôture un PDF signé. Si le fichier change ensuite, un lecteur de PDF le signale. Un horodatage y est également associé. Voir [Sceau et horodatage](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Dans la pratique" href="/praktijk" description="Quatre exemples détaillés qui combinent plusieurs modules" />
  <Card title="Contrôleurs : lexique" href="/controllers/lexicon" description="Termes techniques autour des contrôleurs" />
</Cards>


# Données et sauvegardes (/fr-FR/gegevens-backups)

Tillor effectue automatiquement des sauvegardes des données de votre organisation. Vous n'avez rien à configurer et vous ne les voyez pas dans Tillor. Si vous avez besoin de données du passé ou si quelque chose s'est mal passé, le support Tillor restaure pour vous un état antérieur. Voici comment le demander et jusqu'où vous pouvez remonter.

<Callout type="info" title="Bon à savoir">
- Les sauvegardes remontent jusqu'au premier mois calendrier écoulé, avec une archive par mois. Les détails figurent dans le tableau ci-dessous.
- Vous ne restaurez pas vous-même : cela passe toujours par le support Tillor.
- Vous ne pouvez ni télécharger ni consulter une sauvegarde vous-même.
</Callout>

Avant de commencer : sachez de quelles données vous avez besoin et à partir de quel moment ou de quel mois.

## Combien de temps Tillor conserve-t-il les sauvegardes ? [#hoe-lang-bewaart-tillor-back-ups]

Tillor conserve trois types de sauvegardes côte à côte. Ensemble, elles vous donnent un point de restauration récent et un historique plus long.

| Période | Ce que vous pouvez retrouver |
|---------|-------------------------|
| **Dernières 48 heures** | Une sauvegarde toutes les 4 heures, pour restaurer un moment récent |
| **14 derniers jours** | Une sauvegarde par nuit |
| **Chaque mois calendrier écoulé** | Une archive mensuelle par mois, sans suppression automatique |

Le mois calendrier en cours ne comporte que les sauvegardes nocturnes des 14 derniers jours. Dès qu'un mois est terminé, une sauvegarde de ce mois reste conservée comme archive mensuelle.

Ces durées s'appliquent à toutes les organisations. Si Tillor modifie sa politique, nous adaptons cette page.

## Faire restaurer une sauvegarde [#een-back-up-laten-terugzetten]

Vous ne restaurez pas vous-même dans Tillor. Le support Tillor le fait avec vous, afin que vos données actuelles ne soient pas écrasées par erreur.

<Steps>
<Step>
### Rassemblez ce que vous voulez récupérer [#verzamel-wat-je-wilt-terughalen]
Déterminez de quelles données vous avez besoin, comme des factures, des clients ou des réservations. Notez le moment ou la période à laquelle vous voulez revenir, par exemple « hier vers 14h00 » ou « mars 2026 ».
</Step>
<Step>
### Contactez le support Tillor [#neem-contact-op-met-tillor-support]
Écrivez à support@tillor.eu en indiquant le nom de votre organisation, les données que vous voulez récupérer et le moment ou la période souhaités.
</Step>
<Step>
### Convenez de ce qui sera restauré [#overleg-wat-er-precies-terugkomt]
Le support Tillor recherche la sauvegarde qui correspond à votre demande et discute avec vous de ce qui va se passer avant que la restauration ne commence.
</Step>
</Steps>

<Callout type="warn" title="Attention">
Une restauration peut ramener des données à un état antérieur. Tout ce que vous avez saisi après le moment choisi peut donc disparaître. Discutez-en toujours d'abord avec le support Tillor.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le support Tillor recherche la sauvegarde appropriée et discute avec vous de ce qui sera restauré avant la restauration.
- Pendant la restauration, votre organisation est en mode maintenance et seuls les collaborateurs de Tillor y ont accès. Ensuite, tout est de nouveau disponible.
- Les données que vous avez saisies après le moment choisi peuvent avoir disparu. Discutez-en donc toujours d'abord.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je veux télécharger ou consulter une sauvegarde moi-même">
Ce n'est pas possible dans Tillor. Les sauvegardes ne sont disponibles que pour le support Tillor. Demandez au support de rechercher les données dont vous avez besoin.
</Accordion>
<Accordion title="Je veux des données datant de plus d'un mois">
Pour les mois plus anciens, Tillor conserve une sauvegarde par mois calendrier. Vous pouvez donc revenir à un mois, mais pas à un jour ou une heure précis de ce mois. Pour les 14 derniers jours, c'est possible par jour, pour les dernières 48 heures, toutes les 4 heures.
</Accordion>
<Accordion title="Tillor est inaccessible pendant la restauration">
Pendant une restauration, votre organisation est en mode maintenance et seuls les collaborateurs de Tillor y ont accès. Convenez avec le support Tillor d'un moment qui vous convient.
</Accordion>
<Accordion title="J'ai supprimé une facture ou un client par erreur">
Écrivez au support Tillor en indiquant le nom des données et le moment de la suppression. Regardez d'abord dans le [journal d'activité](/activiteitenlog) qui a modifié quoi et quand.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Premiers pas" href="/aan-de-slag" description="Configurer votre parc étape par étape" />
  <Card title="Journal d'activité" href="/activiteitenlog" description="Voyez qui a modifié quoi et quand" />
</Cards>


# Se connecter à Tillor (/fr-FR/inloggen)

Vous vous connectez à Tillor avec un compte que vous avez déjà chez Microsoft, Google ou Apple. Tillor n'a pas de mot de passe propre : c'est ce fournisseur qui gère votre mot de passe. Après la connexion, vous choisissez votre organisation et vous arrivez sur le tableau de bord. Si c'est votre premier jour, passez à [Premiers pas](/aan-de-slag).

Avant de commencer :

- Il vous faut un compte Microsoft, Google ou Apple.
- Un administrateur doit d'abord vous avoir invité comme utilisateur avec la même adresse e-mail. Si ce n'est pas le cas, vous voyez **Aucune organisation trouvée**.

## Se connecter [#inloggen]

<Steps>
<Step>
### Ouvrez Tillor [#open-tillor]
Dans votre navigateur, allez sur l'application web Tillor. Si vous êtes déjà connecté, Tillor vous redirige aussitôt vers votre organisation.
</Step>
<Step>
### Choisissez votre méthode de connexion [#kies-je-inlogmethode]
Cliquez sur **Connexion avec Microsoft**, **Connexion avec Google** ou **Connexion avec Apple**. La méthode avec laquelle vous vous êtes connecté la dernière fois est repérée par **Dernière utilisation**.
</Step>
<Step>
### Suivez les étapes du fournisseur [#volg-de-stappen-van-de-provider]
Vous arrivez sur l'écran de connexion de Microsoft, Google ou Apple. Avec Microsoft et Google, vous choisissez vous-même le compte à utiliser. Vous revenez ensuite dans Tillor.
</Step>
<Step>
### Choisissez votre organisation [#kies-je-organisatie]
Si vous avez accès à plus d'une organisation, un écran de choix s'affiche. Cherchez votre organisation dans la liste et cliquez sur **Ouvrir**. Si vous n'en avez qu'une, vous allez directement au tableau de bord.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Vous arrivez sur le tableau de bord de votre organisation. Tillor mémorise votre dernière méthode de connexion et la repère la fois suivante par **Dernière utilisation**.
- Vous ne voyez que les éléments pour lesquels vous avez des autorisations.
- Votre session reste active sur cet appareil, jusqu'à 30 jours sans utilisation ou jusqu'à ce que vous vous déconnectiez vous-même.

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une personne a un compte Tillor. Vous pouvez associer ce compte à plusieurs méthodes de connexion. Un administrateur vous ajoute comme utilisateur à une organisation et vous donne des autorisations. Ce que vous voyez ensuite dépend de ces autorisations.

```mermaid
flowchart LR
  A[Votre compte Microsoft, Google ou<br/>Apple] --> B[Votre compte Tillor]
  B --> C[Une ou plusieurs organisations]
  C --> D[Vos autorisations<br/>déterminent ce que vous voyez]
```

<Callout type="info" title="Bon à savoir">
- Vous restez connecté tant que vous utilisez Tillor. Après 30 jours sans utilisation, vous vous reconnectez.
- Un lien de vérification pour votre adresse e-mail est valable 15 minutes. Vous pouvez demander un nouvel e-mail au plus toutes les deux minutes.
- Microsoft est toujours activé comme méthode de connexion. Google et Apple peuvent manquer, selon votre environnement Tillor.
- Vous ne pouvez pas dissocier votre dernière méthode de connexion.
</Callout>

## Donner accès à un collègue [#een-collega-toegang-geven]

Un administrateur disposant des bonnes autorisations invite les collègues.

<Requires permission="Gérer les autorisations utilisateurs" />

<Steps>
<Step>
### Ouvrez les utilisateurs [#open-de-gebruikers]
Allez dans <UIPath>Support > Paramètres</UIPath> et choisissez **Utilisateurs**.
</Step>
<Step>
### Invitez le collègue [#nodig-de-collega-uit]
Cliquez sur **Inviter un utilisateur**, saisissez l'adresse e-mail et cliquez sur **Inviter**.
</Step>
</Steps>

Si un compte Tillor existe déjà avec cette adresse e-mail, le collègue est ajouté directement. Sinon, il reçoit une invitation par e-mail et devient membre à sa première connexion. Vous définissez ensuite les autorisations, voir [Organisation](/gebruikers/organisaties). Le collègue ne verra rien d'utile tant que ces autorisations ne sont pas définies.

## Gérer votre propre compte [#je-eigen-account-beheren]

Cliquez sur votre nom en bas du menu et choisissez **Compte**. Vous y trouvez :

- **E-mail** : si votre adresse e-mail est **Vérifié** ou **Non vérifié**. Si elle est **Non vérifié**, vous voyez le bouton **Vérifier l'adresse e-mail**, voir [Vérifier votre adresse e-mail](#je-e-mailadres-verifiëren).
- **Plateformes liées** : associez Microsoft, Google ou Apple au même compte avec **Associer**, ou supprimez une liaison avec **Dissocier**. Vous ne pouvez pas dissocier votre dernière méthode de connexion.
- **Sessions actives** : voyez sur quels appareils vous êtes connecté. Avec **Se déconnecter**, vous mettez fin à une session, avec **Se déconnecter de tous les autres appareils** à toutes les autres.
- Votre numéro de téléphone et la langue de votre compte.

Vous restez connecté tant que vous utilisez Tillor. Après 30 jours sans utilisation, vous vous reconnectez. Pour vous déconnecter, choisissez **Se déconnecter** dans le menu sous votre nom.

## Vérifier votre adresse e-mail [#je-e-mailadres-verifiëren]

Tillor reprend votre adresse e-mail du fournisseur avec lequel vous vous êtes connecté la première fois. Google et Apple indiquent alors que l'adresse est bien la vôtre. Microsoft ne le fait en général pas, et votre adresse apparaît alors sur la page **Compte** comme **Non vérifié**.

Tant que votre adresse n'est pas vérifiée, Tillor n'associe pas de seconde méthode de connexion à votre compte lors de la connexion. Si, par exemple, vous vous connectez pour la première fois avec Google alors que votre compte a été créé avec Microsoft, vous voyez le message indiquant que l'adresse appartient déjà à un compte qui n'est pas encore vérifié. Vérifiez votre adresse une fois, et ensuite cela fonctionne.

<Steps>
<Step>
### Demandez l'e-mail de vérification [#vraag-de-verificatiemail-aan]
Si vous êtes connecté, cliquez sur la page **Compte** sur **Vérifier l'adresse e-mail**. Si vous n'êtes pas connecté et avez reçu le message sur la page de connexion, saisissez-y votre adresse e-mail et cliquez sur **Envoyer l'e-mail de vérification**. Cette page donne toujours la même confirmation, même s'il n'existe aucun compte avec cette adresse.
</Step>
<Step>
### Ouvrez l'e-mail [#open-de-e-mail]
Vous recevez un e-mail avec l'objet **Vérifiez votre adresse e-mail pour Tillor**. Cliquez sur **Vérifier l'adresse e-mail**. Le lien est valable 15 minutes ; s'il a expiré, demandez-en simplement un nouveau.
</Step>
<Step>
### Connectez-vous [#log-in]
Après avoir cliqué, vous revenez sur la page de connexion ou sur votre page de compte. Connectez-vous avec la méthode de votre choix. À partir de maintenant, Tillor associe à votre compte une nouvelle méthode de connexion utilisant la même adresse e-mail.
</Step>
</Steps>

Vous pouvez demander un nouvel e-mail de vérification au plus toutes les deux minutes. Si vous ne voulez pas attendre l'e-mail, vous pouvez, une fois connecté, associer immédiatement une deuxième méthode sous **Compte > Plateformes liées**.

## Clés API pour les intégrations [#api-sleutels-voor-koppelingen]

Pour les intégrations techniques, vous gérez les clés API sur la page **Compte**. Ouvrez **Développeurs** dans votre menu de profil et cliquez sur **Aller aux clés API**, ou allez dans **Compte** > **Clés API**. Voir [Développeurs](/ontwikkelaars) pour la documentation d'intégration.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Compte - section Clés API" />

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Vous voyez Aucune organisation trouvée">
Votre compte existe, mais n'est pas encore lié à une organisation. Demandez à un administrateur de votre organisation de vous inviter avec la même adresse e-mail que celle de votre compte Microsoft, Google ou Apple.
</Accordion>
<Accordion title="Vous voyez que l'adresse e-mail appartient déjà à un compte qui n'est pas encore vérifié">
Il existe déjà un compte Tillor avec cette adresse, créé avec une autre méthode de connexion, et cette adresse n'est pas encore vérifiée. Sous le message, saisissez votre adresse e-mail et cliquez sur **Envoyer l'e-mail de vérification**, ou connectez-vous avec la méthode que vous utilisiez auparavant et cliquez sur la page **Compte** sur **Vérifier l'adresse e-mail**. Voir [Vérifier votre adresse e-mail](#je-e-mailadres-verifiëren).
</Accordion>
<Accordion title="Le lien de vérification a expiré ou n'est pas valide">
Un lien de vérification est valable 15 minutes. Demandez-en un nouveau sur la page de connexion ou sur la page **Compte** et utilisez l'e-mail le plus récent.
</Accordion>
<Accordion title="Le compte n'a pas pu être associé">
Ce compte est déjà lié à un autre utilisateur, ou l'adresse e-mail ne correspond pas à votre compte actuel. Utilisez la même adresse e-mail, ou connectez-vous avec le compte déjà associé et dissociez-le d'abord à cet endroit.
</Accordion>
<Accordion title="La session de connexion a expiré">
La connexion a pris trop de temps ou la page est restée ouverte trop longtemps. Cliquez de nouveau sur votre méthode de connexion et terminez les étapes plus rapidement.
</Accordion>
<Accordion title="Je ne vois pas tout ce que mon collègue voit">
Ce que vous voyez dépend de vos autorisations. Demandez à un administrateur d'adapter vos autorisations, voir [Organisation](/gebruikers/organisaties).
</Accordion>
<Accordion title="Vous obtenez un autre message d'erreur">
Réessayez. Si cela échoue de nouveau, écrivez à support@tillor.eu et communiquez le message.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Premiers pas" href="/aan-de-slag" description="Configurer votre parc étape par étape" />
  <Card title="Utilisateurs" href="/gebruikers" description="Autorisations des utilisateurs et paramètres de l'organisation" />
</Cards>


# Vraag het Tillie (/fr-FR/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>


# Nouveautés (/fr-FR/wat-is-nieuw)

Tillor reçoit une mise à jour presque tous les jours. Cette page présente les modifications que vous remarquez en tant qu'administrateur. Nous laissons de côté les petites améliorations et les corrections d'erreurs.

## Novembre 2026 [#november-2026]

### Tâches [#taken]

- Filtrez les tâches par **Texte** : n'affichez que les tâches dont le nom ou la description contient, ou justement ne contient pas, un texte, et ajoutez autant de textes que vous voulez (par exemple **Ne contient pas** `Verzekering vervallen:`). Voir [Filtrer par texte](/taken/filteren#filteren-op-tekst).
- Les filtres et les paramètres d'affichage de la vue intégrée **Toutes** peuvent désormais être enregistrés pour toute l'organisation, avec le droit **Gérer les étiquettes et les vues partagées**. Voir [Enregistrer ou abandonner les modifications](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

### Recherche [#zoeken]

- La fenêtre de recherche affiche les résultats par catégorie, avec la catégorie du meilleur résultat en haut et les trois meilleurs résultats par catégorie. Avec le bouton **Tout** au début du champ de recherche, ou avec **⌥1** à **⌥9** (**Alt** sous Windows), vous cherchez dans une seule catégorie, même avant de taper. En bas figurent les raccourcis clavier et les catégories sans résultat. Voir [Recherche](/zoeken).

### Manuel [#handleiding]

- Tillie peut maintenant aussi regarder dans ton compte : donne-lui un accès en lecture à ton organisation et pose des questions sur tes propres clients, factures ou compteurs. Elle propose une modification, qui n'a lieu que lorsque tu la confirmes. Voir [Laisser Tillie regarder dans ton compte](/vraag-het-tillie#tillie-in-je-account-laten-kijken).
- Tu choisis maintenant clair ou sombre une seule fois : le manuel suit le thème choisi dans Tillor, et inversement.
- Nouveau : [Demande à Tillie](/vraag-het-tillie). Pose une question avec tes propres mots en bas à droite, et Tillie répond à partir du manuel, avec les pages qu'elle a utilisées.
- Le manuel existe désormais aussi dans d'autres langues : choisissez votre langue en haut à droite. Il s'ouvre automatiquement dans la langue que vous utilisez dans Tillor. Une page qui n'est pas encore traduite affiche le texte néerlandais.

### Chat du site web [#website-chat]

- Un visiteur peut désormais envoyer 10 messages par minute et 200 par jour via le chat, et tous les visiteurs d'un même réseau ensemble 30 par minute. Au-delà, le visiteur est invité à patienter un instant. Ainsi, un script ne peut pas inonder ta boîte de réception et les réponses de Tillie. Voir [Problèmes ?](/inbox/website-chat#problemen).

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

- Tillor lit désormais ICY via la nouvelle API v2. Sous <UIPath>Paramètres > Intégrations > ICY</UIPath>, renseignez l'identifiant pour l'API v2 et choisissez le numéro de votre parc dans la liste ; sans ces données, les compteurs ICY ne sont plus mis à jour.
- Un compteur ICY indique quel **Module** est installé à cet emplacement (Campère ou PRM) et, si ICY le connaît, le **Numéro de série du module**. Si ce numéro de série change chez ICY, cela apparaît dans l'**Activité** du compteur.
- La carte **Contrôleurs ICY** dans <UIPath>Parc > Compteurs</UIPath> indique, pour chaque contrôleur, quand ICY l'a vu pour la dernière fois, combien de compteurs y sont raccordés. Les alarmes que ICY signale sur un contrôleur y figurent aussi désormais, et vous recevez la même notification push que pour une alarme de compteur. Un contrôleur avec une alarme ou silencieux depuis plus d'une heure apparaît en haut. Un contrôleur porte le nom de votre armoire à compteurs (par exemple **MK6**) au lieu du numéro d'ICY. Voir [Contrôleurs ICY](/meterbeheer/alarmen-en-status#icy-controllers).
- Un compteur ICY affiche désormais aussi son **Contrôleur** et le **Temps de coupure**. Un autre temps de coupure du module apparaît dans l'**Activité** du compteur.
- La liste dans <UIPath>Parc > Compteurs</UIPath> comporte une colonne **Module** (Campère ou PRM), et le fichier Excel de **Exporter tous les compteurs** comporte la colonne `module` sur la feuille ICY.
- Sous **Intensité**, il ne reste que les valeurs jusqu'au maximum réglé chez ICY pour le module à cet emplacement. Auparavant, Tillor proposait sur chaque compteur toute la liste du parc.
- Les alarmes d'ICY reçoivent un nom fixe dans votre langue, comme **Surintensité** ou **Panne de courant**, et les **Avertissements** indiquent désormais combien de fois la limite de commutation a déjà été utilisée.

### Développeurs [#ontwikkelaars]

- **Non rétrocompatible :** dans l'API et dans les événements, les alarmes s'appellent désormais `integration-alarm`, car elles peuvent maintenant aussi se trouver sur un contrôleur ICY. Les événements `meter-alarm:created` et `meter-alarm:resolved` sont remplacés par [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) et [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved), et les chemins REST `/meter-alarms` par `/integration-alarms`. Les anciens noms n'existent plus. Les webhooks et automatisations existants ont été convertis automatiquement vers les nouveaux événements ; adaptez dans votre propre code le nom de l'événement et le chemin. Le champ `meterId` d'une alarme peut être vide ; `icyControllerId` est alors renseigné.
- Un client OAuth peut désormais être limité aux personnes de votre organisation, puis à des groupes et à des permissions : cochez **Seules les personnes de (votre organisation) peuvent se connecter** dans la fenêtre du client sous <UIPath>Compte > Clients OAuth</UIPath>. Prévu pour l'authentification unique auprès d'un service externe. Voir [Clients OAuth](/ontwikkelaars/oauth-clients).
- Chaque point de terminaison de la [référence API](/api-referentie) indique désormais sous **Accès** qui peut l’appeler et quelle autorisation un membre doit avoir. Une clé API avec des scopes doit aussi avoir cette autorisation dans ses scopes. L’[index des événements](/ontwikkelaars/events) indique la même chose par événement.

### Clés API [#api-sleutels]

- Une clé API peut désormais être limitée aux autorisations dont une intégration a besoin : activez **Limiter aux autorisations sélectionnées** dans la fenêtre de la clé sous <UIPath>Compte > Clés API</UIPath>. Une clé limitée ne peut jamais faire plus que vous. Voir [Limiter les autorisations](/ontwikkelaars/http#rechten-beperken).

### Champs personnalisés [#eigen-velden]

- Un champ de liaison vers des compteurs peut se limiter aux compteurs du terrain de l'occupation, et tout champ de liaison vers un enregistrement listable peut filtrer ses options avec son propre TypeScript. Tillor refuse à l'enregistrement un enregistrement hors de cette restriction. Les listes courtes (moins de 50 enregistrements) s'affichent immédiatement dans la liste de choix, sans devoir d'abord saisir 2 caractères. Voir [Filtrer les options](/eigen-velden/veldtypes#opties-filteren).
- Le même filtre peut aussi donner à une option un libellé propre et un titre dans la liste de choix, en renvoyant un texte ou `{ label, group }` au lieu de `true`. Voir [Libellés personnalisés](/eigen-velden/veldtypes#eigen-labels).

### Manuel [#handleiding-1]

- Nouveau dans le manuel : [Glossaire](/begrippen), une liste de tous les termes de Tillor, et [Dans la pratique](/praktijk), quatre exemples détaillés qui suivent toute une façon de travailler à travers les modules, comme accueillir un client saisonnier ou facturer la consommation.
- Chaque module commence désormais par ce que c'est, ce dont vous avez besoin et ce qui se passe ensuite, avec un bloc **Bon à savoir** et une liste **Un problème ?** par tâche. Sont aussi nouveaux : [Inviter des utilisateurs et donner des autorisations](/gebruikers/gebruikers-en-rechten), un aperçu de tous les [types de notification](/communicatie/notificatietypes) et des pages séparées par tâche pour les [compteurs](/meterbeheer), les [contrôleurs](/controllers) et les [imprimantes](/printer).

### Signatures [#handtekeningen]

- Les clients, les personnes de contact et les parties externes peuvent désormais aussi signer un document sur la tablette de la réception. À leur tour, cliquez sur **Signer sur tablette**, avec code ou sans code si vous avez vous-même vérifié l'identité ; la tablette affiche leur nom en grandes lettres, y compris pour un mandat SEPA. Voir [Sur la tablette de la réception](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).
- Avec **Envoyer**, l'éditeur vérifie tout en une fois : un signataire sans champ de signature, ou un client ou une personne de contact sans adresse e-mail ni numéro de GSM, est signalé immédiatement. Voir [Je ne peux pas envoyer](/handtekeningen/handtekening-vragen#problemen).

### Transactions bancaires [#banktransacties]

- Cliquez sur l'icône (i) d'une transaction bancaire pour ouvrir son panneau de détails. Depuis le menu d'actions, vous créez une tâche à son sujet ou vous copiez un lien qui ouvre directement le panneau. Voir [Consulter les transactions bancaires](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken).

### Produits et factures [#producten-en-facturen]

- La TVA autoliquidée est désormais un choix dans **TVA %**, à côté des taux : pour les services UE et le cocontractant, et aussi la livraison intracommunautaire, l'exportation et l'exonéré. La facture reçoit la mention légale, la comptabilisation demande un numéro de TVA lorsque c'est nécessaire, et la ligne arrive dans Admisol dans la bonne grille. Pour Odoo, vous renseignez pour chaque régime le nom de la TVA Odoo dans les [paramètres d'exportation](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes) ; un prix planifié peut aussi faire passer un produit à un autre régime. Voir [TVA autoliquidée et autres régimes sans TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw).
- Enregistrez les montants d'avant Tillor, comme d'anciennes garanties, comme solde d'ouverture sur le compte d'un client : à la main ou avec un import pour tous les clients à la fois. Ils comptent dans le solde et la surveillance, mais ne sont pas une facture et ne partent pas vers la comptabilité. Voir [Soldes d'ouverture d'avant Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor).
- Un lot de produits est désormais du code : chaque étape a un produit, une quantité et une **Formule** facultative en TypeScript qui, à l'enregistrement de la facture, détermine si l'étape y figure, avec quelle quantité, ou précisément quelles lignes (description propre, prix, méthode d'accès). La formule lit le client, l'occupation, le terrain et la ligne principale, champs personnalisés inclus, ainsi que les listes de compteurs et de méthodes d'accès. Les choix fixes par compteur, badge NFC et chien ont disparu ; ce qu'ils faisaient figure comme exemple de formule dans le manuel. Voir [Formule par étape](/producten/bundel-velden#formule-per-stap).
- Surveillez le solde d'un client sur un grand livre, par exemple pour des garanties. Tillor affiche le solde sur la facture et refuse une facture qui le fait passer sous zéro. Avec une autorisation distincte, vous comptabilisez malgré tout, avec une motivation dans la chronologie. Voir [Surveiller le solde du client](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
- Sous l'onglet **Facturation** d'un client se trouve le nouveau tableau **Comptes** : le solde par grand livre sur lequel quelque chose a été comptabilisé, avec en dessous les factures comptabilisées et le compte courant. Si vous avez des grands livres surveillés, vous ne voyez par défaut que ceux-là ; avec un filtre, vous les voyez tous. Voir [Surveiller le solde du client](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

### Factures et paiements [#facturen-en-betalingen]

- Avec **Lien de paiement partiel** dans le menu d'une facture comptabilisée, vous créez un lien de paiement pour une partie du montant restant dû. Voir [Créer un lien pour un paiement partiel](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).
- Un mandat SEPA signé est scellé, de sorte qu'un lecteur de PDF montre toute modification ultérieure. Voir [Mandat SEPA](/betalingsverwerking/mandaat).

### Utilisateurs et autorisations [#gebruikers-en-rechten]

- Un groupe peut autoriser ou refuser des autorisations pour tous ses membres ; un refus l'emporte toujours. Dans **Modifier les autorisations**, vous voyez pour chaque autorisation si elle vient directement ou via un groupe. Voir [Autorisations de groupe](/gebruikers/groepen#groepsrechten).

### Parc et technique [#park-en-techniek]

- Un contrôleur peut connaître plusieurs réseaux Wi-Fi, dans un ordre que vous définissez vous-même. Voir [Paramètres du contrôleur](/controllers/settings).
- Pour un compteur, **Consommation et tendances** affiche la consommation par heure pour une journée, avec un nouveau sélecteur de période. Voir [Gestion des compteurs](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).

### Tâches [#taken-1]

- Imprimez une tâche sur A4 ou sur une imprimante de tickets depuis le menu de la tâche ; l'impression affiche aussi les éléments liés et les blocages. Dans le même menu se trouve **Supprimer**, sauf pour les tâches que seule une automatisation peut clôturer. Voir [Détails de la tâche](/taken/taakdetails#het-menu-van-de-taak).
- Ajoutez des sous-tâches pendant que vous créez une tâche. Voir [Créer une tâche](/taken/taakdetails#een-taak-aanmaken).
- Une vue peut masquer les tâches terminées après un jour, une semaine ou un mois. Voir [Masquer les tâches terminées](/taken/indelingen#voltooide-taken-verbergen).

## Octobre 2026 [#oktober-2026]

### Terrains [#terreinen]

- Le **Tarif calculé** d'un terrain suit désormais une formule que vous écrivez vous-même par organisation sous <UIPath>Paramètres > Tarif d'emplacement</UIPath>, avec les mêmes variables `{terrain.…}` que dans les automatisations. Vous essayez immédiatement la formule sur un terrain, et chaque partie nommée reçoit une colonne dans l'export des terrains. Le résultat est conservé sur le terrain et suit chaque modification du terrain ou de la formule. Voir [Formule de tarif](/terreinen#tariefformule).

### Signatures [#handtekeningen-1]

- Faites signer en ligne un PDF comme un contrat de location, l'un après l'autre, par des clients, des personnes de contact, des collègues et des parties externes. Le PDF signé avec page de preuve arrive dans les documents du client. Voir [Signatures](/handtekeningen).
- Un signataire peut aussi taper sa signature ou son paraphe au lieu de le dessiner. Voir [Comment quelqu'un signe](/handtekeningen/ondertekenen).
- Dans l'éditeur, vous choisissez avec **Champs pour** pour qui vous placez des champs, et vous mettez un champ placé au nom de quelqu'un d'autre avec **Signataire**. Vous placez les champs en touchant ou en glissant. Voir [Placer les champs](/handtekeningen/handtekening-vragen).

### Connexion [#inloggen]

- Si votre adresse e-mail est encore **Non vérifié**, vous la vérifiez en un clic depuis la page **Compte** ou depuis la page de connexion. Ce n'est qu'ensuite que Tillor associe une deuxième méthode de connexion à votre compte. Voir [Vérifier votre adresse e-mail](/inloggen#je-e-mailadres-verifiëren).

### Automatisations [#automatiseringen]

- Avec l'étape **Exécuter du code**, vous écrivez un petit morceau de TypeScript sur les variables du flux, par exemple pour déterminer quelles sous-tâches une tâche reçoit. Vous lisez le résultat dans les étapes suivantes comme `{result}`. Voir [Exécuter du code](/automatiseringen/logica#code-uitvoeren).
- Un flux peut d'abord **Synchroniser les transactions bancaires** puis envoyer un rappel de paiement, de sorte qu'une facture qui vient d'être payée ne reçoive pas de rappel. Enregistrez cette automatisation depuis le réseau du bureau, Tillor retient alors l'IP pour la liaison bancaire. Voir [Synchroniser les transactions bancaires](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren).
- Désactivez les rappels automatiques pour un client ou pour une seule facture. Un flux de rappel saute les clients qui l'ont déjà activé. Voir [Désactiver les rappels automatiques pour un client](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant).
- Avec **Créer une tâche**, vous pouvez régler que seul le flux clôture la tâche. Avec **Supprimer la tâche**, vous retirez cette tâche plus tard. Voir [Tâches](/automatiseringen/acties/taken).
- Sur une action de tâche, vous pouvez activer **Demander une confirmation**. Le collègue confirme alors d'abord son choix, puis le flux continue.
- Construisez vous-même des automatisations sur un canevas : choisissez un déclencheur, ajoutez des étapes, des conditions et des temps d'attente et consultez pour chaque exécution ce qui s'est passé. Voir [Automatisations](/automatiseringen).
- Une automatisation peut avoir plusieurs déclencheurs. Tillor bloque les boucles dans lesquelles une automatisation se relance elle-même.
- L'attente peut désormais aller jusqu'à un moment fixe, un nombre d'heures ou de minutes, ou jusqu'à la fermeture de votre organisation.
- Démarrez une automatisation à une date tirée d'un enregistrement, avec un déclencheur planifié ou depuis votre propre système via un [webhook entrant](/ontwikkelaars/automatiseringen).
- Avec l'étape **Demander une décision**, vous créez vous-même les boutons sur la tâche, avec couleur et icône propres, éventuellement avec une note ou une confirmation obligatoire. Chaque bouton est une sortie de l'étape. Voir [Demander une décision](/automatiseringen/logica#vraag-om-een-beslissing).
- Le déclencheur **Une action de tâche est choisie** démarre une automatisation lorsque quelqu'un choisit un bouton lié sur une tâche. Avec un webhook entrant, vous évitez avec **Ignorer les répétitions** que le même appel démarre le flux deux fois. Voir [Déclencheurs](/automatiseringen/triggers).
- **Attendre un événement** a une sortie **Supprimé** pour le cas où l'enregistrement du flux disparaît. Voir [Logique](/automatiseringen/logica#wachten-op-een-gebeurtenis).
- Dans l'éditeur, vous testez avec un vrai enregistrement, vous placez des **Cadres** autour des étapes et vous rétablissez une version antérieure via **Historique**. Voir [Premiers pas](/automatiseringen/aan-de-slag#de-editor).

### Tâches [#taken-2]

- Dans la liste des tâches, vous voyez tous les enregistrements liés, et vous filtrez par type avec **Lié à**. Voir [Filtrer](/taken/filteren).
- Les e-mails de tâche affichent un aperçu de la tâche. Vous trouvez aussi les tâches via [Recherche](/zoeken).
- Avant qu'une tâche privée devienne visible pour toute l'organisation, Tillor demande si vous voulez la rendre publique. Voir [Tâches privées](/taken/prive-taken).
- Tâches privées, une vue calendrier et un minuteur qui continue de tourner pendant que vous poursuivez votre travail. Voir [Tâches](/taken).
- Partagez une vue comme page en lecture seule ou comme lien de calendrier. Voir [Partager des tâches](/taken/delen).
- Les statuts d'attente sont regroupés en un seul statut **En attente de réponse**.
- Attribuez une tâche à un groupe, et partagez une vue avec des groupes de collègues. Voir [Qui voit une vue](/taken/weergaven#wie-ziet-een-weergave).
- Une tâche peut avoir des boutons de choix, éventuellement avec une note ou une confirmation obligatoire. Voir [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen).
- Collez un fichier dans la fenêtre de la tâche pour l'ajouter en pièce jointe. Les champs personnalisés des tâches figurent aussi dans cette fenêtre.

### Boîte de réception [#inbox]

- L'e-mail de rappel du chat du site web ouvre désormais la conversation aussi sur un autre appareil ou dans un autre navigateur. Voir [Rappel par e-mail](/inbox/website-chat-instellingen#herinnering-per-e-mail).

### Notifications [#meldingen]

- Choisissez pour chaque notification si Tillor vous joint par e-mail ou par push. Vous le réglez sous **Compte** dans **Notifications**, ou pour un collègue via **Paramètres de notification** dans les membres de l'organisation. Voir [Utilisateurs](/gebruikers).

### Tablettes et kiosques [#tablets-en-kiosken]

- Chaque tablette ou kiosque a sa propre page d'appareil avec des actions à distance, un diagnostic, un historique et des paramètres. Voir [Tablettes et kiosques](/mobiele-app/tablets-en-kiosken).
- Verrouillage du kiosque, mode nuit et notifications par appareil pour les tablettes Android.

### Factures et paiements [#facturen-en-betalingen-1]

- Sur une ligne de facture avec une période, choisissez le terrain sur la carte. À la comptabilisation, Tillor crée la réservation et enregistre l'arrivée du client, selon le produit. Voir [Factures](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen).
- Rapports de paiement provisoires pour la journée en cours. Voir [Rapports de paiement](/boekhouden/betalingsrapporten).
- Si Mollie retient une réserve de solde sur un versement, Tillor la comptabilise comme *Réserve de solde* sur le fournisseur Mollie au lieu du compte d'attente, et lors de la libération elle en disparaît. Voir [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve).
- Les clients reçoivent un rappel pour signer leur mandat SEPA avant qu'il n'expire.

### Clients et fichiers [#klanten-en-bestanden]

- Vous consultez les pièces jointes, les documents et les e-mails Outlook dans une seule visionneuse de fichiers, sans télécharger. Vous pouvez lire les vidéos ; les envois peuvent atteindre 250 Mo.
- L'aperçu des clients affiche les séjours actifs et en retard. La facturation automatique se met en pause en cas de consommation d'eau inhabituellement élevée.
- Sur un terrain, vous voyez l'historique des occupations, avec un lien vers le client.

### Champs personnalisés [#eigen-velden-1]

- Ajoutez vous-même des champs aux clients, terrains, occupations, compteurs, tâches, produits, documents, réservations et méthodes d'accès, sous <UIPath>Paramètres > Champs personnalisés</UIPath>. Vous les placez entre les champs standard, vous les faites apparaître sous une condition et vous déterminez qui les voit ou les modifie. Voir [Champs personnalisés](/eigen-velden).

### Produits [#producten]

- Planifiez un nouveau prix à partir d'une date avec **Prix planifiés** ; Tillor l'applique ce jour-là et vous envoie un e-mail. Le **Calculateur de TVA** convertit un prix ou l'adapte avec un pourcentage. Voir [Planifier une modification de prix](/producten/prijzen-plannen).

### Clients [#klanten]

- En haut d'un client se trouve la carte avec les données principales, avec les remarques épinglées. Les anniversaires des clients et des partenaires sont signalés. Voir [Gestion des clients](/klantenbeheer).
- Vous saisissez une adresse avec **Rue**, **N°** et **Boîte**, avec des suggestions d'adresse pendant la saisie. Voir [Gestion des clients](/klantenbeheer#adres-invullen).

### Contrôle d'accès [#toegangscontrole]

- Pour un pass QR, vous voyez dans quel wallet il se trouve, et avec **Synchroniser le pass Wallet** vous le remettez à disposition. Voir [Contrôle d'accès](/toegangscontrole).

### Intégrations [#integraties]

- Connectez Partoo pour transmettre automatiquement vos heures d'ouverture, saisons et exceptions à votre établissement. Voir [Partoo](/integraties/partoo).

## Septembre 2026 [#september-2026]

### Paiements [#betalingen]

- Vous signez les mandats SEPA dans Tillor même, à distance ou sur la tablette de la réception. Voir [Mandat SEPA](/betalingsverwerking/mandaat).
- Une nouvelle page de paiement avec choix de la méthode de paiement, code QR et redirection vers l'application Bancontact. Tillor vous avertit lorsqu'une méthode de paiement connaît une panne.

### Contrôle d'accès [#toegangscontrole-1]

- Nouvelle méthode d'accès : code PIN. Un code PIN peut être converti automatiquement en plaque d'immatriculation. Voir [Contrôle d'accès](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel).

### Tâches [#taken-3]

- Vues enregistrées avec un générateur de filtres, partage avec des collègues et un flux de calendrier par vue. Voir [Vues](/taken/weergaven).
- Dépendances entre tâches, la priorité **Urgent** et des étiquettes que vous créez directement.
- Liez une tâche à plusieurs clients, ou à des terrains, des compteurs, des factures et des réservations.

### Parc et communication [#park-en-communicatie]

- Colorez les terrains sur la carte par type et exportez la carte en PDF A4. Voir [Carte](/kaart).
- Pour la téléphonie Voys : routage par client et messagerie vocale automatique. Voir [Téléphonie Voys](/communicatie/providers/voys).
- Exportez l'aperçu des factures d'un client vers Excel.


# Recherche dans Tillor (/fr-FR/zoeken)

Avec la recherche, vous trouvez en une seule fois un client, une facture, une occupation, une réservation, un appel téléphonique, un terrain, un compteur, une tâche ou un rapport de paiement, depuis n'importe quelle page. Vous n'avez donc pas besoin d'aller d'abord dans la bonne section. Le résultat ouvre directement la bonne page.

<Callout type="info" title="Bon à savoir">
- Avec **Tous les résultats**, Tillor récupère au maximum dix résultats par catégorie et affiche les trois meilleurs. Choisissez une catégorie pour en voir jusqu'à cent.
- Pour les clients, Tillor trouve aussi les résultats avec une petite faute de frappe, de sorte que « Jansen » donne aussi « Janssen ».
- Les notes des appels téléphoniques sont chiffrées et ne sont pas parcourues. Cherchez par numéro de téléphone.
- Les tags NFC et les plaques d'immatriculation n'ont pas de catégorie propre. Vous les trouvez sous **Clients**.
</Callout>

## Rechercher et ouvrir un résultat [#zoeken-en-een-resultaat-openen]

<Steps>
<Step>
### Ouvrez la fenêtre de recherche [#open-het-zoekvenster]
Cliquez sur **Recherche** dans l'en-tête (sur un écran étroit, sur la loupe), ou appuyez sur **⌘K** (Mac) ou **Ctrl+K** (Windows). Le même raccourci ferme à nouveau la fenêtre.

<DocScreenshot src="/screenshots/zoeken/search-dialog-open.png" alt="Recherche globale ouverte" />
</Step>
<Step>
### Saisissez votre terme de recherche [#typ-je-zoekterm]
Les résultats apparaissent dès que vous faites une pause dans la saisie. Ils sont regroupés par catégorie, et la catégorie qui contient le meilleur résultat est en haut : la première ligne est donc toujours le meilleur résultat. Une bonne correspondance dans le titre compte plus qu'une correspondance dans la description. Pour chaque catégorie, vous voyez les trois meilleurs résultats. Avec **Afficher … de plus**, vous ouvrez toute la catégorie. En bas, vous voyez les catégories dans lesquelles rien n'a été trouvé.

<DocScreenshot src="/screenshots/zoeken/search-results.png" alt="Résultats de recherche pour Jonas par catégorie, la catégorie avec le meilleur résultat en haut" />
</Step>
<Step>
### Limitez à une catégorie (facultatif) [#beperk-tot-één-categorie-optioneel]
Pour ne chercher que dans un type de données, choisissez-le avec le bouton **Tout** au début du champ de recherche, par exemple **Clients**. Vous pouvez le faire avant ou après la saisie ; le champ de recherche affiche ensuite **Rechercher dans Clients…**. Vous pouvez aussi cliquer sur le nom d'une catégorie dans les résultats.

Au clavier :
- **Shift+Tab** ouvre la liste des catégories.
- **⌥1** à **⌥9** (**Alt+1** à **Alt+9** sous Windows) choisit directement une catégorie, dans l'ordre de cette liste. Le chiffre figure aussi à côté du nom de chaque catégorie dans les résultats.
- **Tab** parcourt les catégories qui ont des résultats.

Pour revenir à tout : choisissez **Tout** dans la liste, ou appuyez sur **Backspace** dans un champ de recherche vide.
</Step>
<Step>
### Ouvrez le résultat [#open-het-resultaat]
Utilisez les touches fléchées pour choisir et appuyez sur **Entrée**. Avec **Ctrl+Entrée** (**⌘+Entrée** sur Mac), le résultat s'ouvre dans un nouvel onglet. Vous pouvez aussi cliquer avec la souris. **Échap** ferme la fenêtre.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le résultat choisi ouvre le client, la facture ou une autre page dans le même onglet. Avec **Ctrl+Entrée** (**⌘+Entrée** sur Mac), il s'ouvre dans un nouvel onglet.
- Vos données ne changent pas : la recherche est en lecture seule.
- Pour chaque résultat, vous voyez sur quoi il a été trouvé, par exemple **Téléphone:** ou **Facture:** avec la valeur correspondante.

## Ce que Tillor parcourt [#wat-tillor-doorzoekt]

| Catégorie | Ce sur quoi vous pouvez chercher |
|-----------|----------------------------------|
| **Clients** | Nom, numéro de client, e-mail, téléphone, adresse et localité, numéro de TVA, remarques, personnes de contact (nom, e-mail, téléphone) et moyens d'accès tels qu'une carte NFC ou une plaque d'immatriculation |
| **Factures** | Numéro de facture (avec ou sans préfixe, année et séparateurs), montant total, l'ID figurant dans le lien de la facture et les notes (publiques et internes) |
| **Occupations** | Nom du terrain, prénom et nom du client et l'ID de l'occupation |
| **Réservations** | Numéro de réservation (par exemple `RES/2026/0001`, avec ou sans préfixe et année, ou sous forme compacte `20260001`), note, nom du client et l'ID figurant dans le lien |
| **Appels téléphoniques** | Numéro entrant et sortant, ID de l'appel et référence externe |
| **Terrains** | Nom, description, ID et numéro du compteur de gaz du terrain |
| **Compteurs** | Nom, numéro de série et ID du compteur |
| **Tâches** | Titre, description et ID. Un résultat affiche aussi le client ou le terrain lié |
| **Rapports de paiement** | Numéro du rapport |

<Callout type="info" title="NFC et plaque d'immatriculation">
Il n'existe pas de catégorie distincte pour les tags NFC. Les cartes NFC et les autres valeurs d'accès appartiennent à **Clients** et y apparaissent dès qu'elles correspondent à votre terme de recherche.
</Callout>

## Combien de résultats voyez-vous ? [#hoeveel-resultaten-zie-je]

S'il y a dix résultats ou plus dans une catégorie, **10+** s'affiche à côté du nom de cette catégorie. Dans l'aperçu, vous voyez les trois meilleurs résultats par catégorie. Choisissez la catégorie, ou cliquez sur **Afficher … de plus**, pour voir jusqu'à cent résultats. Pour les réservations et les factures, la tolérance aux fautes de frappe joue surtout sur les numéros et les notes.

## Conseils de recherche [#zoektips]

- **Plaque d'immatriculation, NFC ou code QR** : cherchez la valeur enregistrée chez le client. Vous trouvez le client sous **Clients**.
- **Numéro de facture ou de réservation** : saisissez le numéro tel qu'il figure sur le document, ou une partie de celui-ci. Pour `RES/2026/0042`, `2026/0042` et `20260042` fonctionnent aussi.
- **Montant** : vous trouvez aussi une facture par son montant total, par exemple `120,50`.
- **Qui se trouve où** : sous **Occupations**, cherchez par nom du terrain ou du client.
- **Noms partiels** : pour les clients, une partie du nom suffit généralement. Pour les réservations, un mot de la note aide.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Vous voyez Aucun résultat trouvé">
Vérifiez l'orthographe et essayez une partie plus courte du terme. Si vous avez choisi une catégorie, Tillor cherche uniquement dans celle-ci. S'il y a des résultats dans une autre catégorie, la fenêtre l'indique. Choisissez **Tout** avec le bouton au début du champ de recherche, ou cliquez sur **Retirer le filtre**.
</Accordion>
<Accordion title="Vous voyez Recherche indisponible">
Une erreur s'est produite pendant la recherche. Cliquez sur **Réessayer**. Si l'erreur persiste, consultez l'[état du système](https://status.tillor.eu).
</Accordion>
<Accordion title="Je ne trouve pas un client par sa plaque d'immatriculation ou sa carte NFC">
Cherchez la valeur exacte telle qu'elle est enregistrée chez le client. Vous trouvez le client sous **Clients**, et non dans une catégorie distincte.
</Accordion>
<Accordion title="Je ne trouve pas une réservation">
Saisissez le numéro tel qu'il figure sur le document, ou une partie de celui-ci : pour `RES/2026/0042`, `2026/0042` et `20260042` fonctionnent aussi. Sinon, cherchez par nom du client.
</Accordion>
<Accordion title="Un appel téléphonique ne se trouve pas par sa note">
Les notes des appels téléphoniques sont stockées chiffrées et ne sont donc pas parcourues. Cherchez par numéro de téléphone.
</Accordion>
<Accordion title="Le raccourci clavier ne fonctionne pas">
Certains navigateurs ou extensions utilisent eux-mêmes Ctrl+K ou ⌘K. Cliquez alors sur **Recherche** dans l'en-tête.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" description="Gérer les clients" />
  <Card title="Occupations" href="/bezettingen" description="Un client sur un terrain" />
  <Card title="Réservations" href="/reserveringen" description="Gérer les réservations" />
  <Card title="Factures" href="/facturen" description="Gérer les factures" />
</Cards>


# Journal d'activité (/fr-FR/activiteitenlog)

Dans le journal d'activité, vous voyez ce qui a changé dans Tillor, quand, et par qui. Vous l'ouvrez depuis un client, une facture, une tâche ou un autre enregistrement, et de façon centralisée via **Journal d'audit** si vous en avez les droits. C'est une trace en lecture seule que vous utilisez pour vérifier ou prouver quelque chose.

<Callout type="info" title="Bon à savoir">
- Une entrée ne peut être ni modifiée ni supprimée
- Un export contient par défaut les 30 derniers jours, et au maximum un an
- L'ouverture répétée du même document en moins de dix minutes n'est mentionnée qu'une seule fois
- Les heures sont affichées dans votre fuseau horaire
- Les actions d'une automatisation, d'une clé API ou du système y figurent aussi, avec le type d'acteur
</Callout>

## Consulter le journal d'activité [#activiteitenlog-bekijken]

Dans l'application, il s'appelle généralement **Événements** ou **Activité**, selon l'endroit où vous vous trouvez. Qui a le droit *Voir le journal d'audit* peut en outre ouvrir une vue centrale via *Journal d'audit* dans la barre latérale (au-dessus de Paramètres), avec des filtres par utilisateur, type d'événement et date.

| Où | Navigation | Libellé dans l'application |
|------|-----------|-----------------|
| Client (toute l'activité associée) | *Clients > client > Événements* | Événements |
| Facture | *Administration > Factures > facture* | Événements |
| Réservation | *Clients > client > Réservations > réservation* | Activité |
| Terrain | *Parc > Terrains > terrain* | Événements |
| Compteur | *Parc > Compteurs > compteur* | Activité |
| Produit | *Administration > Produits > produit* | Événements |
| Tâche | *Tâches > tâche* ou *Clients > client > Tâches > tâche* | Activité |
| Tag NFC | *Contrôleurs > Tags NFC > tag* | Activité |
| Tablette, borne ou téléphone | *Paramètres > Tablettes et bornes > appareil* | Historique |
| Organisation (central) | *Journal d'audit* (au-dessus de Paramètres, droit *Voir le journal d'audit*) | Journal d'audit |
| Rapport de paiement | *Administration > Rapports de paiement > rapport* | Journal des événements |

Pour chaque activité, vous voyez dans la chronologie :

- **Titre** - type d'événement (par ex. « Facture comptabilisée », « Client mis à jour »)
- **Utilisateur** - collègue qui a effectué l'action (ou Tillor pour les actions automatiques)
- **Heure** - date et heure relative
- **Description** - détails complémentaires ; parfois avec des liens vers des factures ou d'autres enregistrements liés
- **Avant / après** (parfois) - lors de la création, de la modification ou de la suppression de données de client, de contact, de facture, de paiement, de mandat de paiement, de groupe de paiement, de document, de moyen d'accès, de point d'accès, de contrôleur, de terrain, de compteur, de relevé de compteur, de produit, d'occupation, de tâche ou de réaction, ainsi que lors du scan, de l'attribution ou de la dissociation d'une pièce d'identité et lors de modifications des paramètres, des droits des membres, de la facturation ou du NFC : quels champs ont été modifiés. Les codes PIN des points d'accès et les données personnelles d'une pièce d'identité ne sont pas conservés dans le journal
- **Pièces jointes** (parfois) - fichiers téléchargeables, par exemple en cas d'intégrations échouées
- **Connexion / déconnexion** - quand un collègue se connecte ou se déconnecte, visible dans la vue centrale du journal d'audit
- **Applications OAuth et consentement** - création, modification, suppression ou rotation du secret d'applications OAuth, ainsi que consentement accordé, refusé ou révoqué ; visible dans la vue centrale du journal d'audit. Les secrets client ne sont pas conservés dans le journal
- **Gestion et sécurité** - modifications du profil de l'organisation (nom, données juridiques, TVA, IBAN, logo, mode maintenance), invitations et nouveaux membres, clés API personnelles (création, modification, renouvellement, suppression), sessions terminées, webhooks, automatisations, groupes de collègues, types de terrain, armoires de compteurs, groupes de contrôleurs, intégrations installées ou supprimées et l'acceptation de l'accord de traitement des données ; visible dans la vue centrale du journal d'audit. Les clés, les secrets de webhook et les paramètres d'intégration ne sont pas conservés ; pour une intégration, vous voyez seulement quels paramètres ont été modifiés
- **Consultation de données personnelles** - qui a ouvert ou téléchargé un document, consulté ou téléchargé les images ou fichiers d'une pièce d'identité, ou ouvert le PDF d'une facture ou l'a envoyé à la tablette. L'ouverture répétée en moins de dix minutes n'est mentionnée qu'une seule fois ; chaque téléchargement d'une pièce d'identité est mentionné séparément

## Activités par enregistrement [#activiteiten-per-record]

Sur les pages de détail, vous voyez une chronologie de l'activité pour cet enregistrement. Dans l'onglet **Événements** d'un client figurent toutes les activités liées à ce client (factures, paiements, occupations, etc.).


<DocScreenshot src="/screenshots/activiteitenlog/customer-events.png" alt="Événements sur le profil client Jonas Maes" />

Pour les **réservations**, cela comprend notamment la création, l'enregistrement à l'arrivée et au départ, les annulations et les annulations d'opérations liées, ainsi que la mise à jour des données de réservation.

Pour les **groupes de paiement**, vous voyez aussi quels paiements ont été ajoutés à un groupe ou en ont été retirés, et pour les **contrôleurs**, quelles demandes d'adoption ont été approuvées ou refusées.

Pour les **rapports de paiement**, cela comprend notamment la création du rapport, la finalisation d'un rapport brouillon et l'envoi à la comptabilité.

Pour les **demandes de signature**, vous voyez chaque étape : créée et modifiée, envoyée, lien envoyé (à nouveau), rappelée, page de signature ouverte, code envoyé ou saisi de manière incorrecte, signée, refusée, remise en brouillon, annulée, expirée et terminée. Voir [Preuve et validité](/handtekeningen/bewijs-en-geldigheid).

Pour les **notifications externes**, vous voyez quand un système lié a mis à jour ou supprimé une notification qu'il avait enregistrée.

<Callout type="info">
Le journal d'activité est en lecture seule. Les entrées ne peuvent être ni modifiées ni supprimées.
</Callout>

## Qui l'a fait ? [#wie-heeft-het-gedaan]

Chaque ligne indique, à côté de l'utilisateur, **quel type d'acteur** a effectué l'action : un utilisateur connecté, une clé API, une liaison OAuth, une automatisation, le connecteur Tillor ou le système lui-même. Pour une clé API ou une liaison OAuth, l'identifiant de cette clé ou liaison figure dans les détails, de sorte qu'en cas de clé divulguée, vous voyez exactement ce qui a été fait avec elle. Si vous voyez **Inconnu**, Tillor n'a pas pu déterminer l'acteur ; c'est volontairement différent de « Système ».

## Événements de sécurité [#beveiligingsgebeurtenissen]

Les connexions échouées, les clés API et jetons OAuth refusés, les accès refusés (droits manquants), les limites de requêtes dépassées et l'ouverture de votre organisation par un administrateur Tillor sont aussi affichés dans le journal d'activité, avec l'adresse IP et le navigateur. Les membres ayant le droit **Alertes de sécurité** reçoivent chaque heure une notification lorsque des webhooks, des clés API ou des automatisations ont été modifiés ou lorsque l'accès a été refusé à plusieurs reprises.

L'accès à ton compte que tu donnes à [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) ou que tu retires, et chaque modification que tu confirmes via Tillie, figurent aussi ici.

## Exporter pour un audit [#exporteren-voor-een-audit]

Avec **Exporter** dans le journal d'activité, vous téléchargez toutes les lignes de la période choisie (par défaut les 30 derniers jours, au maximum un an) sous forme de ZIP contenant le fichier de données (CSV ou JSON Lines), un `manifest.json` avec le nombre de lignes, la période, la personne qui a exporté et la somme de contrôle SHA-256 du fichier de données, ainsi qu'un fichier `CHECKSUMS.sha256` que vous pouvez vérifier avec `sha256sum -c`. L'export lui-même est également enregistré dans le journal, avec la même somme de contrôle. L'ouverture du journal d'activité complet et les exports en masse de données clients (liste des clients, journal d'accès, terrains, compteurs) sont aussi consignés.

Toutes les heures sont stockées en **UTC** sur des serveurs avec synchronisation horaire NTP et affichées dans votre fuseau horaire ; l'export contient des heures ISO 8601 en UTC.

## À quoi sert le journal ? [#waarvoor-gebruik-je-de-log]

- **Contrôle** - vérifier quel collègue a comptabilisé une facture ou modifié un client
- **Résolution de problèmes** - retrouver quand une erreur s'est produite
- **Audits** - conserver une trace complète pour des contrôles internes ou externes

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Utilisateurs" href="/gebruikers" description="Gérer les utilisateurs et les droits" />
  <Card title="Factures" href="/facturen" description="Consulter l'historique des factures" />
</Cards>


# Premiers pas (/fr-FR/automatiseringen/aan-de-slag)

Sur cette page, vous construisez votre première automatisation et vous découvrez l'éditeur, l'écran où vous dessinez vos flux. Vous avez besoin de l'autorisation **Gérer les automatisations**, ou de **Toutes les autorisations**. Voir l'[Aperçu](/automatiseringen) pour le contexte.

## L'aperçu [#het-overzicht]

Allez dans **Administrateur > Automatisations**. Vous voyez une liste avec une ligne par automatisation :

- le nom et une étiquette telle que **2 problèmes** s'il reste quelque chose à corriger dans le flux (voir [Problèmes et activation](/automatiseringen/problemen))
- la description
- le déclencheur choisi, le nombre d'étapes et la personne qui a créé l'automatisation (**par**)
- une série de petites barres avec les dernières exécutions, accompagnée de l'heure de la dernière exécution ou de **Pas encore exécutée**. Une barre rouge est une exécution échouée
- un interrupteur pour activer ou désactiver l'automatisation, et un menu à trois points

<DocScreenshot src="/screenshots/automatiseringen/overview.png" alt="Aperçu des automatisations avec la liste, les filtres et le champ de recherche" />

En haut de la liste, vous filtrez avec **Toutes**, **Activées** et **En pause**. Si une automatisation a des problèmes, un filtre **Problèmes** s'ajoute. Avec **Rechercher des automatisations**, vous cherchez par nom ou description.

Cliquez sur le nom pour ouvrir l'éditeur. Avec l'interrupteur, vous activez ou désactivez une automatisation. L'activation est impossible tant qu'il y a des problèmes. Le menu **Actions de l'automatisation** propose deux choix :

| Choix | Ce qu'il fait |
|---|---|
| **Dupliquer** | Crée une copie nommée *[nom] (copie)*. La copie est en pause |
| **Supprimer** | Supprime l'automatisation et l'historique des exécutions. Tillor demande d'abord une confirmation |

Les exécutions qui attendent à ce moment-là dans un délai s'arrêtent si vous supprimez l'automatisation.

## Créer une nouvelle automatisation [#een-nieuwe-automatisering-maken]

Cliquez sur **Nouvelle automatisation**. Une galerie s'ouvre avec six points de départ. Vous pouvez ensuite modifier chaque étape.

| Point de départ | Ce qu'il fait |
|---|---|
| **Partir de zéro** | Un flux vide avec uniquement un déclencheur |
| **Contrôler le terrain après le départ** | Crée une tâche de contrôle pour le terrain lorsqu'une occupation se termine, avec une priorité élevée et attribuée à la personne qui a arrêté l'occupation |
| **Suivre les factures impayées** | Attend la fin de la date d'échéance, envoie un rappel de paiement et, une semaine plus tard, crée une tâche pour appeler le client si la facture est toujours ouverte |
| **Envoyer les réservations vers un autre système** | Envoie pour chaque nouvelle réservation une charge utile propre à votre point de terminaison webhook et crée une tâche si l'envoi échoue |
| **Vérifier un compteur qui ne compte plus** | Crée une tâche pour la réception lorsqu'un compteur reste à l'arrêt alors que le terrain a été utilisé, avec des sous-tâches pour la vérification sur place |
| **Appeler la Tillor API** | Ajoute un commentaire à chaque nouvelle tâche via la Tillor API |

<DocScreenshot src="/screenshots/automatiseringen/gallery.png" alt="Galerie Nouvelle automatisation avec les points de départ" />

Dès que vous choisissez, Tillor crée l'automatisation et ouvre l'éditeur. L'automatisation est en pause jusqu'à ce que vous l'activiez.

## L'éditeur [#de-editor]

L'éditeur occupe tout l'écran et comporte trois parties : à gauche la liste des étapes, au milieu le canevas et à droite le panneau. Le nom de l'automatisation figure en haut dans le fil d'Ariane et vous pouvez le modifier directement à cet endroit.

<DocScreenshot src="/screenshots/automatiseringen/editor.png" alt="Éditeur avec la liste des étapes à gauche, le canevas au milieu et le panneau à droite" />

Survolez les repères ℹ pour une courte explication de chaque partie.

**Liste des étapes (à gauche).** Recherchez une étape avec **Rechercher des étapes**. En haut se trouve le groupe **Outils** avec **Commentaire** et **Cadre** (voir [Commentaires et cadres](#opmerkingen-en-kaders)). En dessous figurent les étapes en six groupes, avec **Documents** au milieu :

- **Logique** : le déclencheur **Quand ceci se produit** et les conditions, attentes, recherches et parcours, comme **Si / sinon**, **Aiguillage**, **Délai**, **Ouvert maintenant ?**, **Rechercher un enregistrement**, **Pour chaque** et **Demander une décision**. Voir [Conditions, aiguillages et délais](/automatiseringen/logica)
- **Tâches** : créer, rechercher et mettre à jour des tâches
- **Documents** : rechercher et mettre à jour des documents
- **Clients et messages** : messages aux clients et aux collègues, commentaires, la boîte de réception, les clients et les réservations
- **Factures et paiements** : factures, liens de paiement, mandats et consommation
- **Accès et appareils** : moyens d'accès, barrières, électricité, tags NFC et tablettes
- **Intégrations** : **Envoyer un webhook** et **Requête API**

Ce que fait chaque action est décrit sous [Actions](/automatiseringen/acties). En bas se trouve **Demander une étape** si une étape vous manque.

**Canevas (au milieu).** Vous y voyez le flux. En haut se trouve le déclencheur, en dessous les étapes avec des lignes entre elles. En bas à gauche, vous zoomez avant et arrière.

**Panneau (à droite).** En haut se trouvent l'interrupteur **Actif**, en cas de problèmes un bouton tel que **1 problème**, un bouton **Réorganiser** qui range les étapes proprement les unes sous les autres (les commentaires restent où ils sont) et un bouton **Masquer le panneau**. Si vous masquez le panneau, **Afficher le panneau** le fait réapparaître. En dessous, vous choisissez un onglet :

| Onglet | Ce que vous y faites |
|---|---|
| **Configurer** | Modifier l'étape sélectionnée. Si vous ne sélectionnez rien, vous pouvez saisir une **Description** pour l'automatisation |
| **Exécution de test** | Essayer le flux, voir [Tests et exécutions](/automatiseringen/testen-en-uitvoeringen) |
| **Exécutions** | Revoir ce qu'ont fait les exécutions réelles |
| **Historique** | Consulter et restaurer les versions enregistrées précédentes, voir [Versions précédentes](#eerdere-versies) |

Si vous avez fait des modifications, **Modifications non enregistrées** apparaît en bas du panneau avec les boutons **Annuler les modifications** et **Enregistrer**. **Annuler les modifications** remet le flux dans sa dernière version enregistrée. Si le panneau est masqué, ces boutons se trouvent en haut à droite du canevas.

Tant que vous n'avez sélectionné aucune étape, la personne qui a créé l'automatisation est indiquée sous la description. Les exécutions échouées lui sont envoyées par e-mail, au maximum une fois par heure et par automatisation.

Sur un téléphone, le panneau est d'abord masqué afin que le canevas occupe tout l'écran. Touchez une étape ou **Afficher le panneau** pour l'ouvrir.

### Ajouter et relier des étapes [#stappen-toevoegen-en-verbinden]

Il y a quatre façons d'ajouter une étape :

- Cliquez sur une étape dans la liste à gauche. Elle apparaît au milieu du canevas
- Faites glisser une étape de la liste vers le canevas
- Cliquez sur le petit plus sous une sortie qui ne mène encore nulle part (**Ajouter une étape après "[sortie]"**) et choisissez une étape. La nouvelle étape est reliée immédiatement
- Faites glisser une étape sur une ligne. Elle se place alors entre les deux étapes (**Insérer une étape ici**)

Pour relier des étapes entre elles, faites glisser depuis la sortie sous une étape vers une autre étape. Les règles suivantes s'appliquent :

- Chaque sortie mène à une seule étape. Si vous reliez à nouveau une sortie, la nouvelle ligne remplace l'ancienne
- Une ligne qui formerait une boucle est refusée. S'il y a quand même une boucle, vous ne pouvez pas activer l'automatisation. Une exécution s'arrête dès qu'elle devrait refaire une étape
- Une étape sans ligne entrante n'est jamais exécutée. Tillor le signale comme un problème (**Non connectée, cette étape ne s'exécute donc jamais.**)
- Vous pouvez modifier un déclencheur, le dupliquer et en ajouter d'autres depuis la liste à gauche. Vous ne pouvez pas supprimer le dernier déclencheur. Un déclencheur n'a pas sa place sur une ligne : il lance sa propre exécution

Donnez un nom propre à une étape dans le champ **Nom de l'étape**. Cela aide quand votre flux grandit. Avec les boutons **Dupliquer l'étape** et **Supprimer l'étape** en haut du panneau, vous copiez ou supprimez l'étape sélectionnée.

### Commentaires et cadres [#opmerkingen-en-kaders]

Avec un commentaire, vous expliquez sur le canevas ce que fait une partie du flux, par exemple pourquoi une condition s'y trouve. Un **Cadre** est une ligne en pointillés avec un nom que vous placez autour d'un groupe d'étapes.

- Dans le groupe **Outils**, cliquez sur **Commentaire** ou **Cadre** et saisissez votre texte
- Faites glisser le commentaire ou le cadre vers les étapes qu'ils expliquent. Sélectionnez-les pour les agrandir ou les réduire avec les coins
- Supprimez un commentaire avec **Supprimer le commentaire** ou un cadre avec **Supprimer le cadre**, ou sélectionnez-les et appuyez sur Suppr
- Les commentaires et cadres ne sont jamais exécutés et ne comptent pas dans les problèmes. Vous pouvez en placer au maximum 50 au total. Ils sont conservés avec **Enregistrer**, comme les étapes, et Ctrl/Cmd + Z annule une modification

### Versions précédentes [#eerdere-versies]

Chaque fois que vous enregistrez une modification, Tillor conserve la version précédente. Dans l'onglet **Historique**, vous voyez les versions avec ce qui a changé, par exemple **1 étape ajoutée** ou **Disposition ou connexions modifiées**, et par qui ou par quoi la modification est venue (par exemple **Via l’API**). Avec **Restaurer**, vous placez une version sur le canevas. Cela compte comme une modification non enregistrée : enregistrez pour conserver la version, ou annulez.

### Raccourcis clavier [#sneltoetsen]

| Touche | Ce qu'elle fait |
|---|---|
| Ctrl/Cmd + S | Enregistrer |
| Ctrl/Cmd + Z | Annuler |
| Ctrl/Cmd + Shift + Z ou Ctrl/Cmd + Y | Rétablir |
| Ctrl/Cmd + C, Ctrl/Cmd + V | Copier et coller les étapes sélectionnées |
| Ctrl/Cmd + D | Dupliquer les étapes sélectionnées |
| Ctrl/Cmd + A | Tout sélectionner |
| Suppr ou Retour arrière | Supprimer les étapes ou lignes sélectionnées |
| Échap | Désélectionner |

## Enregistrer et activer [#opslaan-en-inschakelen]

Tillor n'enregistre pas automatiquement. Cliquez sur **Enregistrer** (ou appuyez sur Ctrl/Cmd + S) pour conserver vos modifications. Le bouton est actif dès que quelque chose a été modifié et que le nom n'est pas vide.

<Callout type="warn">
Si l'automatisation est activée, vous ne pouvez enregistrer que s'il n'y a plus de problèmes. Un flux en cours doit toujours rester valide. Corrigez les problèmes, ou mettez d'abord l'automatisation en pause.
</Callout>

Avec l'interrupteur **Actif**, vous activez l'automatisation. Cela enregistre aussi le flux immédiatement. L'interrupteur ne fonctionne pas tant qu'il y a des problèmes, avec l'explication **Corrigez d'abord les problèmes en cours**. Ensuite, l'automatisation démarre à chaque événement correspondant. Il peut falloir une demi-minute pour qu'une modification prenne effet partout.

Si vous modifiez plus tard un flux activé, ces modifications ne valent que pour les nouvelles exécutions. Les exécutions déjà en cours ou en attente dans un délai se terminent avec le flux tel qu'il était à leur démarrage.

## Votre première automatisation : une tâche après le départ [#je-eerste-automatisering-een-taak-na-vertrek]

Cet exemple crée une tâche lorsqu'une occupation se termine.

1. Cliquez sur **Nouvelle automatisation** et choisissez **Contrôler le terrain après le départ**
2. Cliquez sur le déclencheur. Sous **Événement** figure `occupation:ended`
3. Cliquez sur l'étape **Créer une tâche**. Modifiez le **Titre**, la **Description** et la **Priorité**, ou choisissez sous **Ajouter au tableau** un tableau et une **Colonne**
4. Ouvrez l'onglet **Exécution de test** et cliquez sur **Lancer le test**. Vous voyez quelles étapes le flux parcourrait
5. Cliquez sur **Enregistrer** et activez **Actif**
6. Terminez une occupation et consultez dans l'onglet **Exécutions** ce qui s'est passé

## Demander une étape ou un événement [#een-stap-of-gebeurtenis-aanvragen]

Il vous manque un déclencheur, une condition ou une action ? Cliquez sur **Demander une étape** sous la liste des étapes. Dans la liste des événements du déclencheur figure aussi un lien **Il manque un événement ? Demandez-le**.

1. Sous **De quoi avez-vous besoin ?**, choisissez entre **Un déclencheur ou un événement**, **Une condition ou un filtre**, **Une action** ou **Autre chose**
2. Sous **Que doit-elle faire ?**, décrivez ce que vous voulez automatiser. Écrivez au moins 10 caractères, au plus 1000
3. Cliquez sur **Envoyer la demande**

Votre demande part à l'équipe Tillor, avec votre nom et le nom de votre organisation. Vous recevez une notification indiquant que la demande a été envoyée.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une nouvelle automatisation est en pause. Rien ne se passe tant que vous n'activez pas **Actif**.
- Après l'activation, l'automatisation démarre à chaque événement correspondant. Il peut falloir une demi-minute pour qu'une modification prenne effet partout.
- Chaque démarrage est une exécution. Vous les voyez dans l'onglet **Exécutions**, avec le statut **Terminée**, **En attente**, **Échouée** ou **Annulée**.
- Si une exécution échoue, la personne qui a créé l'automatisation reçoit un e-mail, au maximum un par heure et par automatisation.
- Si vous modifiez un flux en cours, les modifications ne valent que pour les nouvelles exécutions. Ce qui est déjà en cours ou en attente se termine avec l'ancien flux.
- Les tâches et commentaires créés par l'automatisation sont au nom de **Flux de travail**. Voir [Qui exécute une automatisation ?](/automatiseringen/workflow-gebruiker).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="L'interrupteur Actif ne fonctionne pas">
Tillor affiche **Corrigez d'abord les problèmes en cours**. Cliquez en haut du panneau sur le bouton indiquant le nombre de problèmes et corrigez-les. Voir [Problèmes et activation](/automatiseringen/problemen).
</Accordion>
<Accordion title="Je ne peux pas enregistrer">
Le bouton **Enregistrer** n'est actif que si quelque chose a été modifié et que le nom n'est pas vide. Si l'automatisation est activée, vous ne pouvez enregistrer que sans problèmes. Corrigez-les ou mettez d'abord en pause.
</Accordion>
<Accordion title="Mon étape n'est jamais exécutée">
Tillor signale **Non connectée, cette étape ne s'exécute donc jamais.** Faites glisser depuis la sortie d'une étape précédente vers cette étape.
</Accordion>
<Accordion title="Je ne peux pas relier une ligne">
Une ligne qui formerait une boucle est refusée. Un flux ne peut aller que vers l'avant.
</Accordion>
<Accordion title="Je ne vois pas Automatisations dans le menu">
Le menu n'apparaît que si vous avez l'autorisation **Voir les automatisations**. Construire et modifier demande **Gérer les automatisations**. Demandez à un administrateur d'ajuster vos autorisations.
</Accordion>
<Accordion title="Le flux ne réagit pas à mon action">
Parcourez les points de [Pourquoi mon automatisation ne démarre-t-elle pas ?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
</Accordions>

## Étapes suivantes [#volgende-stappen]

<Cards>
  <Card
    title="Déclencheurs"
    href="/automatiseringen/triggers"
    description="Choisissez quand une automatisation démarre"
  />
  <Card
    title="Actions"
    href="/automatiseringen/acties"
    description="Tout ce qu'une automatisation peut faire"
  />
  <Card
    title="Exemple : contrôle d'une caravane de location"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Un flux complet avec une recherche, un aiguillage et des sous-tâches"
  />
</Cards>


# Documents (/fr-FR/automatiseringen/acties/documenten)

Ces actions servent à travailler avec les documents d'un client, comme une preuve de paiement de l'assurance. Le type et la date d'expiration d'un document figurent dans les données du document. Dans un flux, vous les lisez sous la forme `{document.userMetadata.documentType}` et `{document.userMetadata.insuranceExpiryDate}`.

## Rechercher un document [#document-zoeken]

Recherche le document le plus récent d'un client. L'étape a deux sorties : **Trouvée** et **Introuvable**.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client, par exemple `{document.customerId}` ou `{customer.id}`. Obligatoire |
| **Type** | Par exemple **Preuve de paiement d'assurance**. Laissez vide pour tous les types |
| **Ignorer les documents archivés** | Activé par défaut |
| **Uniquement les documents non expirés** | La date d'expiration doit être postérieure à maintenant. Les documents sans date d'expiration ne comptent alors pas. Désactivé par défaut |

Si plusieurs documents correspondent, l'étape prend le plus récent. Via **Trouvée**, les étapes suivantes peuvent utiliser `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` et `{foundDocument.userMetadata.insuranceExpiryDate}`.

Vous pouvez ainsi vérifier, par exemple lorsqu'une assurance est expirée, si le client a déjà une nouvelle preuve de paiement valide : recherchez avec **Type** *Preuve de paiement d'assurance* et **Uniquement les documents non expirés** activé, et ne continuez que via **Introuvable**.

## Mettre à jour un document [#document-bijwerken]

Modifie le type d'un document, ou l'archive ou le restaure. Les champs vides restent inchangés.

| Champ | Ce que vous saisissez |
|---|---|
| **Document** | L'identifiant du document. Par défaut `{document.id}`. Obligatoire |
| **Nouveau type** | Laissez vide pour garder le type |
| **Statut** | **Actif** ou **Archivé**. Laissez vide pour garder le statut |

Un type qui exige une date d'expiration, comme **Preuve de paiement d'assurance**, échoue si le document n'a pas de date d'expiration. L'action fournit `{updatedDocument.id}`.


# Factures et paiements (/fr-FR/automatiseringen/acties/facturen-en-betalingen)

Ces étapes se trouvent dans le groupe **Factures et paiements**. Pour savoir comment fonctionnent les sorties, lisez [Sorties d'une action](/automatiseringen/acties#uitgangen-van-een-actie).

## Envoyer un rappel de paiement [#betalingsherinnering-versturen]

Envoie au client le rappel de paiement d'une facture, comme le fait le bouton de rappel sur la facture.

| Champ | Ce que vous saisissez |
|---|---|
| **Facture** | L'identifiant de la facture. Par défaut `{invoice.id}`. Obligatoire |

Notez que le champ attend l'identifiant interne de la facture (`{invoice.id}`) et non le numéro de facture (`{invoice.displayId}`).

L'étape échoue si :

- la facture n'est pas comptabilisée
- il ne reste plus rien à payer, donc la facture est déjà payée
- le client n'a pas d'adresse e-mail, de numéro de téléphone et d'adresse postale complète

L'exécution reçoit alors le statut **Échoué** et le reste du flux n'est pas exécuté. Placez donc avant le rappel un **Si / sinon** qui vérifie si la facture est toujours ouverte, comme dans le modèle **Suivre les factures impayées**.

L'étape ignore aussi une facture si elle a été retirée des rappels automatiques, ou si le client a activé **Exclure des rappels automatiques**.

## Synchroniser les transactions bancaires [#banktransacties-synchroniseren]

Récupère les nouvelles transactions bancaires et attend la fin de l'importation. Placez cette étape avant **Envoyer un rappel de paiement**, afin qu'une facture qui vient d'être payée ne reçoive pas de rappel. Si Ponto n'est pas relié, l'étape est ignorée.

Enregistrez l'automatisation depuis le réseau du bureau. Tillor retient alors l'IP dont la liaison bancaire a besoin. Sans cette IP, la synchronisation ne peut pas démarrer.

## Désactiver les relances automatiques pour le client [#automatische-herinneringen-uitschakelen-voor-klant]

Active **Exclure des rappels automatiques** dans les paramètres de facturation du client. Les flux de rappel ignorent ensuite toutes ses factures. Une relance manuelle reste possible.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client. Obligatoire |

## Désactiver les relances automatiques pour la facture [#automatische-herinneringen-uitschakelen-voor-factuur]

Retire une facture des flux de rappel pour retard et des rappels automatiques. Les collaborateurs peuvent toujours envoyer un rappel manuellement.

| Champ | Ce que vous saisissez |
|---|---|
| **Facture** | L'identifiant de la facture. Obligatoire |

## Envoyer la facture [#factuur-versturen]

Envoie une facture au client, de la même manière que le bouton d'envoi sur la facture.

| Champ | Ce que vous saisissez |
|---|---|
| **Facture** | L'identifiant de la facture. Par défaut `{invoice.id}`. Obligatoire |

L'étape échoue si la facture n'est pas comptabilisée ou si le client n'a pas d'adresse e-mail, de numéro de téléphone et d'adresse postale complète.

## Comptabiliser la facture [#factuur-boeken]

Comptabilise une facture brouillon, de sorte qu'elle reçoive son numéro de facture.

| Champ | Ce que vous saisissez |
|---|---|
| **Facture** | L'identifiant de la facture. Par défaut `{invoice.id}`. Obligatoire |

Si la facture est déjà comptabilisée, rien ne se passe et le flux continue via **Ignoré**. Après la comptabilisation, l'action fournit `{bookedInvoice.displayId}`, le numéro de facture. Vous pouvez l'utiliser dans un message ou une tâche. Combinez l'étape avec **Envoyer la facture** pour comptabiliser et envoyer une facture brouillon en une seule fois.

## Imprimer la facture [#factuur-afdrukken]

Imprime une facture, ou l'affiche sur la tablette de l'accueil.

| Champ | Ce que vous saisissez |
|---|---|
| **Facture** | L'identifiant de la facture. Par défaut `{invoice.id}`. Obligatoire |
| **Où** | **Imprimante A4** (par défaut), **Imprimante à tickets** ou **Tablette** |

Vous configurez les imprimantes dans [Paramètres d'impression](/printer/afdrukinstellingen). Une facture que vous imprimez une deuxième fois avec cette étape est simplement imprimée à nouveau.

## Créer un lien de paiement [#betaallink-aanmaken]

Crée un lien de paiement en ligne pour le montant qui reste dû sur une facture.

| Champ | Ce que vous saisissez |
|---|---|
| **Facture** | L'identifiant de la facture. Par défaut `{invoice.id}`. Obligatoire |
| **Moyen de paiement** | **Laisser le client choisir** (par défaut), **Bancontact**, **iDEAL**, **Carte de crédit** ou **Payconiq** |

Le lien n'existe que pour une facture comptabilisée dont une partie reste due. Si la facture n'est pas comptabilisée ou est déjà payée, le flux continue via **Ignoré**. Ensuite, l'action fournit `{paymentLink.url}`. Placez-le dans un texte, par exemple dans un message via [Envoyer un message à un client](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen).

## Demander un mandat SEPA [#sepa-mandaat-aanvragen]

Envoie à un client par e-mail une demande de signature d'un mandat SEPA, ou un rappel pour une demande encore ouverte. Voir [Mandat](/betalingsverwerking/mandaat) pour le mandat lui-même.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client. Par défaut `{customer.id}`. Obligatoire |
| **Envoyer** | **Une nouvelle demande** (par défaut) ou **Un rappel** |

Une nouvelle demande est ignorée s'il y en a déjà une ouverte. Un rappel est ignoré s'il n'y a pas de demande ouverte, ou si la demande a expiré. Dans les deux cas, le flux continue via **Ignoré**.

## Encaisser par domiciliation [#innen-via-domiciliëring]

Encaisse ce qui reste dû sur une facture avec le mandat SEPA actif du client.

| Champ | Ce que vous saisissez |
|---|---|
| **Délai en jours** | Combien de jours Tillor attend avant d'encaisser. À 0, l'encaissement est immédiat. Le maximum est de 7 jours, un nombre plus élevé devient 7. Par défaut 0 |
| **Facture** | L'identifiant de la facture. Par défaut `{invoice.id}`. Obligatoire |

L'étape encaisse tout le montant restant dû. Si la facture n'est pas comptabilisée ou est déjà payée, ou si le client n'a pas de mandat actif, rien ne se passe et le flux continue via **Ignoré**. Si le client a plus d'un mandat actif, l'étape utilise le plus récent.

## Facturer la consommation [#verbruik-factureren]

Facture la consommation de compteur en attente d'un client, comptabilise la facture et l'envoie.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client. Par défaut `{occupation.customerId}`. Obligatoire |
| **Envoyer par e-mail** | Activé par défaut |
| **Envoyer par SMS** | Désactivé par défaut |

S'il n'y a rien à facturer, aucune facture n'est créée et le flux continue via **Ignoré**. Sinon, l'action fournit `{consumptionInvoice.id}`. Voir [Gestion des compteurs](/meterbeheer) pour savoir comment la consommation est suivie.

## Facture brouillon de prolongation [#conceptfactuur-voor-verlenging]

Crée une facture brouillon qui prolonge une occupation, prête à être vérifiée. La facture n'est pas encore comptabilisée. C'est le même type de facture que celle obtenue avec **Prolonger l'occupation (facture)** sur le profil client.

| Champ | Ce que vous saisissez |
|---|---|
| **Occupation** | L'identifiant de l'occupation. Par défaut `{occupation.id}`. Obligatoire |
| **Ajouter la consommation ouverte** | Place la consommation de compteur en attente du client sur la même facture. Désactivé par défaut |

L'action fournit `{extendInvoice.id}`. Si vous voulez comptabiliser et envoyer la facture immédiatement, utilisez ensuite **Comptabiliser la facture** et **Envoyer la facture** avec `{extendInvoice.id}` comme facture.


# Clients et messages (/fr-FR/automatiseringen/acties/gasten-en-berichten)

Ces étapes se trouvent dans le groupe **Clients et messages**. Pour savoir comment fonctionnent les sorties, lisez [Sorties d'une action](/automatiseringen/acties#uitgangen-van-een-actie).

## Envoyer un message à un client [#gast-een-bericht-sturen]

Envoie votre propre texte à un client par e-mail, SMS ou WhatsApp. Utilisez-le pour les messages qui n'ont pas de modèle fixe dans Tillor, comme un message de bienvenue le jour de l'arrivée.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client, par exemple `{reservation.customerId}`. Obligatoire |
| **Objet** | Uniquement pour l'e-mail. Vide, le nom de votre organisation est utilisé |
| **Message** | Le texte, sans mise en forme. Les variables sont remplies. Obligatoire |
| **Envoyer par e-mail** | Activé par défaut |
| **Envoyer par SMS** | Désactivé par défaut |
| **Envoyer par WhatsApp** | Désactivé par défaut |

À noter :

- Les clients qui n'acceptent aucune communication ne reçoivent rien. Le flux continue alors via **Ignoré**
- En dehors de la fenêtre de 24 heures de WhatsApp, Tillor envoie votre texte sous forme de modèle approuvé. Dans cette fenêtre, il part comme un message ordinaire
- Si le client n'existe pas, l'étape échoue

## Prévenir des collègues [#collegas-verwittigen]

Envoie aux collègues une notification push, un e-mail ou les deux.

| Champ | Ce que vous saisissez |
|---|---|
| **Collègues** | Choisissez un ou plusieurs collègues |
| **Prévenir aussi la personne à l'origine de l'événement** | Prévient aussi le collègue qui a causé l'événement. Si c'est le système qui a causé l'événement, personne n'est ajouté |
| **Titre** | L'en-tête de la notification. Obligatoire |
| **Texte** | Le contenu de la notification |
| **Envoyer comme notification push** | Activé par défaut |
| **Envoyer par e-mail** | Désactivé par défaut |

L'utilisateur **Flux de travail** ne reçoit jamais de notification lui-même. S'il n'y a aucun collègue à prévenir, l'étape ne fait rien et le flux continue normalement.

## Ajouter un commentaire [#opmerking-toevoegen]

Place un [commentaire](/notities), au nom de **Flux de travail**.

| Champ | Ce que vous saisissez |
|---|---|
| **Commentaire** | Le texte du commentaire. Obligatoire |
| **Sur** | **Les enregistrements de l'événement** (par défaut) ou **Une tâche** |
| **Tâche** | Uniquement avec **Une tâche** : l'identifiant de la tâche, par exemple `{createdTask.id}`. Obligatoire |

À noter :

- Mentionnez un collègue avec `@{triggeredBy.name}({triggeredBy.id})`. Ce collègue reçoit alors une notification, comme pour un commentaire que vous saisissez vous-même. Cela ne fonctionne que si un collègue a causé l'événement
- Avec **Les enregistrements de l'événement**, le commentaire est placé sur le client, la facture, la réservation, le paiement, le terrain, le compteur et la tâche concernés par l'événement. Si l'événement n'a aucun de ces enregistrements, l'étape échoue
- L'action fournit `{createdComment.id}`

## Répondre dans la boîte de réception [#antwoorden-in-de-inbox]

Envoie une réponse dans une conversation de la boîte de réception, par le même canal que celui par lequel le client a écrit.

| Champ | Ce que vous saisissez |
|---|---|
| **Conversation** | L'identifiant de la conversation. Par défaut `{threadId}`. Obligatoire |
| **Réponse** | Le texte, sans mise en forme. Les variables sont remplies. Au-delà de 4096 caractères, il est tronqué. Obligatoire |
| **Garder l'assistant IA actif** | Désactivé par défaut |

À noter :

- `{threadId}` existe pour les événements concernant des messages de la boîte de réception, comme `inbox:message-created`
- Cet événement vaut pour chaque nouveau message, y compris votre propre réponse. Vérifiez donc d'abord que le message vient du client, sinon votre réponse relance le flux. Placez avant cette étape un [Rechercher un enregistrement](/automatiseringen/logica#record-opzoeken) sur **Message de la boîte de réception** avec `{messageId}` et un **Si / sinon** qui vérifie si `foundInboxMessage.direction` est égal à `INBOUND`
- Par défaut, votre réponse met en sourdine l'[assistant IA](/inbox/inbox-ai-assistant) dans cette conversation, comme lorsqu'un collègue répond lui-même. Avec **Garder l'assistant IA actif**, l'assistant continue à répondre. Si la conversation est alors archivée, l'étape échoue

## Taguer ou archiver la conversation [#gesprek-taggen-of-archiveren]

Donne des tags à une conversation de la boîte de réception, l'archive, ou les deux.

| Champ | Ce que vous saisissez |
|---|---|
| **Conversation** | L'identifiant de la conversation. Par défaut `{threadId}`. Obligatoire |
| **Ajouter des tags** | Choisissez un ou plusieurs tags. Ils s'ajoutent, les tags existants restent |
| **Archiver la conversation** | Désactivé par défaut |

## Modifier le client [#klant-bijwerken]

Modifie le statut d'un client ou ajoute une note. Les autres données du client restent inchangées.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client, par exemple `{invoice.customerId}`. Obligatoire |
| **Statut** | **Laisser tel quel** (par défaut), **Par défaut**, **Préféré**, **VIP**, **Avertissement** ou **Bloqué** |
| **Ajouter aux notes** | Texte placé sur une nouvelle ligne sous les notes existantes. Vide, rien n'est ajouté |

## Enregistrer l'arrivée, le départ ou annuler [#inchecken-uitchecken-of-annuleren]

Place une réservation dans son statut suivant.

| Champ | Ce que vous saisissez |
|---|---|
| **Réservation** | L'identifiant de la réservation. Par défaut `{reservation.id}`. Obligatoire |
| **Action** | **Enregistrer l'arrivée** (par défaut), **Enregistrer le départ** ou **Annuler** |

La réservation doit pour cela être dans le bon statut. **Enregistrer l'arrivée** et **Annuler** fonctionnent pour une réservation au statut **Réservé**, **Enregistrer le départ** pour une réservation au statut **Arrivé**. Si elle est dans un autre statut, rien ne se passe et le flux continue via **Ignoré**.


# Aperçu (/fr-FR/automatiseringen/acties)

Les actions sont les étapes qui font vraiment quelque chose. Vous les trouvez dans la liste des étapes, dans les groupes **Tâches**, **Documents**, **Clients et messages**, **Factures et paiements**, **Accès et appareils** et **Intégrations**. Les étapes du groupe **Logique** pilotent le flux lui-même. Elles sont décrites sous [Conditions, aiguillages et délais](/automatiseringen/logica). Toutes les actions sont exécutées par l'[utilisateur **Flux de travail**](/automatiseringen/workflow-gebruiker) de votre organisation.

| Groupe | Action | Ce qu'elle fait |
|---|---|---|
| Tâches | [Créer une tâche](/automatiseringen/acties/taken#taak-aanmaken) | Crée une tâche, éventuellement avec des sous-tâches, sur un tableau et liée à un client, un terrain ou une facture |
| Tâches | [Définir le statut](/automatiseringen/acties/taken#taakstatus-zetten) | Modifie le statut d'une tâche existante |
| Tâches | [Rechercher une tâche](/automatiseringen/acties/taken#taak-zoeken) | Recherche une tâche par titre et continue via **Trouvée** ou **Introuvable** |
| Tâches | [Définir la priorité de la tâche](/automatiseringen/acties/taken#taakprioriteit-zetten) | Augmente, diminue ou choisit la priorité d'une tâche existante |
| Tâches | [Modifier la tâche](/automatiseringen/acties/taken#taak-bijwerken) | Renomme une tâche, ajoute des personnes ou des étiquettes ou déplace l'échéance |
| Tâches | [Supprimer la tâche](/automatiseringen/acties/taken#taak-verwijderen) | Supprime une tâche, par exemple la tâche créée par ce flux |
| Documents | [Rechercher un document](/automatiseringen/acties/documenten#document-zoeken) | Recherche le document le plus récent d'un client et continue via **Trouvée** ou **Introuvable** |
| Documents | [Mettre à jour un document](/automatiseringen/acties/documenten#document-bijwerken) | Modifie le type d'un document, ou l'archive ou le restaure |
| Clients et messages | [Envoyer un message à un client](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Envoie un texte personnalisé à un client par e-mail, SMS ou WhatsApp |
| Clients et messages | [Prévenir des collègues](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Envoie aux collègues une notification push ou un e-mail |
| Clients et messages | [Ajouter un commentaire](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Place un commentaire sur les enregistrements de l'événement ou sur une tâche |
| Clients et messages | [Répondre dans la boîte de réception](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Envoie une réponse dans une conversation de la boîte de réception |
| Clients et messages | [Taguer ou archiver la conversation](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Ajoute des tags à une conversation de la boîte de réception ou l'archive |
| Clients et messages | [Modifier le client](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Modifie le statut d'un client ou ajoute une note |
| Clients et messages | [Enregistrer l'arrivée, le départ ou annuler](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Place une réservation dans son statut suivant |
| Factures et paiements | [Envoyer un rappel de paiement](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Envoie au client le rappel de paiement d'une facture |
| Factures et paiements | [Synchroniser les transactions bancaires](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Récupère les nouvelles transactions bancaires avant que le flux continue |
| Factures et paiements | [Désactiver les relances automatiques pour le client](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Ignore toutes les factures d'un client dans les relances automatiques |
| Factures et paiements | [Désactiver les relances automatiques pour la facture](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Retire une facture des flux de rappel automatiques |
| Factures et paiements | [Envoyer la facture](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Envoie une facture au client |
| Factures et paiements | [Comptabiliser la facture](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Comptabilise une facture brouillon |
| Factures et paiements | [Imprimer la facture](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Imprime une facture ou l'affiche sur une tablette |
| Factures et paiements | [Créer un lien de paiement](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Crée un lien de paiement en ligne pour ce qui reste dû |
| Factures et paiements | [Demander un mandat SEPA](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Demande à un client de signer un mandat, ou envoie un rappel |
| Factures et paiements | [Encaisser par domiciliation](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Encaisse ce qui reste dû avec le mandat actif du client |
| Factures et paiements | [Facturer la consommation](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Facture la consommation de compteur en attente d'un client |
| Factures et paiements | [Facture brouillon de prolongation](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Crée une facture brouillon qui prolonge une occupation |
| Accès et appareils | [Créer un moyen d'accès](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Donne accès à un client par code QR, plaque d'immatriculation, code PIN ou NFC |
| Accès et appareils | [Modifier l'accès](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Bloque, débloque ou prolonge des moyens d'accès |
| Accès et appareils | [Envoyer ou imprimer le code QR](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Envoie un code d'accès QR au client ou l'imprime |
| Accès et appareils | [Ouvrir ou fermer la barrière](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Ouvre ou ferme une barrière ou un portail |
| Accès et appareils | [Allumer ou couper le courant](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Allume ou coupe le courant d'un compteur intelligent |
| Accès et appareils | [Modifier les badges NFC](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Bloque, débloque ou recharge les badges NFC d'un client |
| Accès et appareils | [Piloter une tablette ou une borne](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Réveille une tablette ou une borne, la met en veille ou la recharge |
| Accès et appareils | [Régler le diaporama](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Place des photos sur les tablettes et les bornes, depuis une liste ou une demande précédente |
| Intégrations | [Envoyer un webhook](/automatiseringen/acties/integraties#webhook-versturen) | Livre un message personnalisé à l'un de vos points de terminaison webhook |
| Intégrations | [Requête API](/automatiseringen/acties/integraties#api-verzoek) | Appelle la Tillor API ou un autre site web |

Dans tous les champs de texte, vous pouvez utiliser des [variables](/automatiseringen/variabelen), comme `{invoice.displayId}`. En haut à droite de chaque champ se trouve un bouton **Variable** pour en insérer une. Les champs où un client, une facture ou un autre enregistrement est demandé attendent l'identifiant interne de cet enregistrement, comme `{invoice.id}`. Un numéro de facture ou un nom ne fonctionne donc pas.

## Sorties d'une action [#uitgangen-van-een-actie]

Sous une étape se trouvent une ou plusieurs sorties. Vous reliez chaque sortie à une étape suivante. Si vous laissez une sortie non reliée, l'exécution se termine à cet endroit.

| Sortie | Pour quelles actions | Quand |
|---|---|---|
| **Suivant** | La plupart des actions | L'étape a réussi |
| **Terminé** et **Ignoré** | Actions qui n'ont parfois rien à faire | **Terminé** si l'étape a fait son travail. **Ignoré** s'il n'y avait rien à faire, par exemple parce que la facture était déjà comptabilisée. Ce n'est pas une erreur |
| **Trouvée** et **Introuvable** | **Rechercher une tâche** | Si la tâche existe |
| **Trouvée** et **Introuvable** | **Rechercher un document** | Si le client a un tel document |
| **Réussi** et **Échoué** | **Envoyer un webhook** et **Requête API** | Si l'autre partie a accepté le message |

**Terminé** et **Ignoré** existent pour **Envoyer un message à un client**, **Enregistrer l'arrivée, le départ ou annuler**, **Comptabiliser la facture**, **Créer un lien de paiement**, **Demander un mandat SEPA**, **Encaisser par domiciliation** et **Facturer la consommation**. Pour chacune, il est indiqué sous l'action quand une étape est ignorée.

### Continuer si cette étape échoue [#doorgaan-als-deze-stap-mislukt]

Si une action échoue, l'exécution s'arrête normalement avec le statut **Échoué**. Si vous voulez décider vous-même de ce qui se passe alors, activez en bas des paramètres de l'étape **Continuer si cette étape échoue**. C'est possible pour toutes les actions sauf **Envoyer un webhook** et **Requête API**, qui ont déjà leur propre sortie **Échoué**.

L'étape reçoit alors une sortie supplémentaire **Erreur**. Si l'action échoue, le flux continue via **Erreur** au lieu de s'arrêter. Les étapes suivantes peuvent utiliser ces variables :

| Variable | Contenu |
|---|---|
| `{error.message}` | Le message d'erreur. Il peut être en anglais |
| `{error.step}` | Le nom de l'étape qui a échoué, tel que vous l'avez saisi sous **Nom de l'étape** |

Quelques points à savoir :

- Si l'action a réussi ou a été ignorée, rien ne change et **Erreur** n'est pas utilisée
- Si vous laissez **Erreur** non reliée, l'exécution se termine à cet endroit sans autres étapes. L'exécution reçoit alors le statut **Terminée**, mais l'étape elle-même figure dans l'onglet **Exécutions** avec son message d'erreur
- Une deuxième étape échouée dans le même flux remplace `{error.message}` et `{error.step}` de la première

Un exemple : laissez **Envoyer un message à un client** continuer en cas d'échec et créez via **Erreur** une tâche avec `{error.message}` dans la description. Un collègue reprend ainsi lui-même la conversation avec le client.

## Si une étape échoue [#als-een-stap-mislukt]

Un échec peut se dérouler de trois façons.

- **Une sortie Échoué.** Cela se produit avec **Envoyer un webhook** et **Requête API** lorsque l'autre partie renvoie une erreur. Le flux continue via la sortie **Échoué**. Reliez-la à une suite, comme une tâche pour un collègue. Si vous laissez la sortie non reliée, l'exécution se termine simplement à cet endroit
- **Une sortie Erreur.** Si vous activez **Continuer si cette étape échoue** pour une autre action, l'étape reçoit une sortie **Erreur** et vous pouvez utiliser la raison avec `{error.message}`. Voir [Continuer si cette étape échoue](#doorgaan-als-deze-stap-mislukt)
- **L'étape arrête l'exécution.** Si une valeur manque après le remplissage des variables, si une facture ne peut pas être envoyée, si un point de terminaison n'existe plus ou si le JSON est invalide, l'exécution reçoit le statut **Échoué**. Les étapes suivantes ne sont pas exécutées et Tillor ne réessaie pas l'étape. Cela n'arrive que si vous n'avez pas activé **Continuer si cette étape échoue**

Le message d'erreur figure à l'étape dans l'onglet **Exécutions**. Ces messages peuvent être en anglais.

<Callout type="idea" title="Ne manquez pas les échecs">
Vous voulez qu'un échec ne passe jamais inaperçu ? Reliez la sortie **Échoué** d'une **Requête API** ou d'un **Envoyer un webhook**, ou la sortie **Erreur** d'une autre action, à une étape [Créer une tâche](/automatiseringen/acties/taken#taak-aanmaken). Un collègue peut ainsi la reprendre.
</Callout>

## Groupes [#groepen]

<Cards>
  <Card title="Tâches" href="/automatiseringen/acties/taken" description="Créer, rechercher et mettre à jour des tâches" />
  <Card title="Clients et messages" href="/automatiseringen/acties/gasten-en-berichten" description="Messages, commentaires, boîte de réception et réservations" />
  <Card title="Factures et paiements" href="/automatiseringen/acties/facturen-en-betalingen" description="Rappels, factures et paiements" />
  <Card title="Accès et appareils" href="/automatiseringen/acties/toegang-en-toestellen" description="Accès, courant, NFC et tablettes" />
  <Card title="Intégrations" href="/automatiseringen/acties/integraties" description="Webhooks et requêtes API" />
</Cards>


# Intégrations (/fr-FR/automatiseringen/acties/integraties)

Ces étapes se trouvent dans le groupe **Intégrations**. Une livraison échouée continue via **Échoué**. Pour les autres actions, lisez [Quand une étape échoue](/automatiseringen/acties#als-een-stap-mislukt).

## Envoyer un webhook [#webhook-versturen]

Livre un message personnalisé à l'un des endpoints webhook de votre organisation. C'est pratique pour prévenir un autre système, par exemple votre système de caisse ou votre site web.

| Champ | Ce que vous saisissez |
|---|---|
| **Endpoint** | Choisissez l'un de vos endpoints webhook. Vous les reconnaissez à leur adresse. Obligatoire |
| **Nom de l'événement** | Le nom envoyé avec le message pour que le destinataire puisse le reconnaître, par exemple `automation.invoice_unpaid`. Obligatoire |
| **Charge utile** | Le contenu du message, au format JSON. Les variables sont remplacées avant l'envoi du message. Obligatoire |

Vous créez et gérez les endpoints via le menu du profil sous **Développeurs**. L'endpoint doit exister et être activé. Sinon, l'étape échoue et l'exécution s'arrête.

Le message est signé avec la clé propre à l'endpoint, exactement comme les autres webhooks que l'endpoint reçoit. Tillor réessaie plusieurs fois si votre serveur ne répond pas correctement. L'endpoint n'a pas besoin de suivre le nom de votre événement : le message arrive de toute façon.

L'étape a deux sorties :

| Sortie | Quand |
|---|---|
| **Réussi** | Votre serveur a répondu avec un statut de réussite |
| **Échoué** | La livraison a échoué après toutes les tentatives. Le message est ensuite encore réessayé en arrière-plan, comme un webhook ordinaire |

Le modèle **Envoyer les réservations vers un autre système** utilise **Échoué** pour créer une tâche afin que quelqu'un s'en occupe.

Une charge utile ressemble par exemple à ceci :

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

Mettez le texte entre guillemets et les nombres sans guillemets. Les dates sont transmises en JSON sous forme de date et d'heure internationales, comme `2026-10-05T08:00:00.000Z`. Lisez [Variables et modèles](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld) pour les détails. Le côté technique, comme la structure du message, se trouve sous [Développeurs > Automatisations](/ontwikkelaars/automatiseringen).

## Requête API [#api-verzoek]

Appelle la Tillor API de votre propre organisation, ou une autre adresse sur Internet. Vous pouvez ainsi faire presque tout ce que Tillor sait faire, et rechercher des données pour en faire ensuite quelque chose.

Sous **Envoyer à**, vous choisissez entre **Tillor API** et **URL personnalisée**. Sous **Méthode**, vous choisissez **GET** (consulter), **POST** (créer), **PUT** ou **PATCH** (modifier) ou **DELETE** (supprimer).

### Tillor API [#tillor-api]

| Champ | Ce que vous saisissez |
|---|---|
| **Chemin** | La partie de l'adresse après l'API de votre organisation, par exemple `/tasks` ou `/tasks/{task.id}`. Il doit commencer par `/`. Obligatoire |
| **Corps** | Les données que vous envoyez, au format JSON. Laissez vide si vous n'envoyez rien |

En haut du champ se trouve **Choisissez un endpoint API**. Cliquez dessus et cherchez dans la liste, par exemple *tasks*. Quand vous choisissez un endpoint, Tillor remplit la méthode et le chemin. Si le **Corps** est encore vide, vous obtenez aussi un exemple de ce que l'endpoint attend. Remplacez les noms entre accolades dans le chemin par des variables d'étapes précédentes. S'il y a des paramètres de requête, vous les voyez sous le champ.

L'appel est effectué en tant qu'utilisateur **Flux de travail** et ne peut jamais sortir de votre propre organisation. Une automatisation ne peut pas gérer des automatisations : les appels qui touchent aux automatisations ou à leurs exécutions sont refusés.

### URL personnalisée [#eigen-url]

| Champ | Ce que vous saisissez |
|---|---|
| **URL** | L'adresse. Elle doit commencer par `https://`. Obligatoire |
| **En-têtes** | Données supplémentaires pour le destinataire, par exemple une clé. Cliquez sur **Ajouter un en-tête** et remplissez le **Nom** et la **Valeur** |
| **Corps** | Les données que vous envoyez, au format JSON. Laissez vide si vous n'envoyez rien |

Ces règles s'appliquent :

- Les adresses sans `https://` sont refusées
- Les adresses privées et internes sont refusées, même si un nom ordinaire y renvoie
- Les redirections ne sont pas suivies. Si le serveur répond par une redirection, cela compte comme **Échoué**
- Les en-têtes sont stockés chiffrés. Vous pouvez donc y mettre une clé ou un jeton
- Avec **GET** et **DELETE**, aucun corps n'est envoyé

### Sorties et réponse [#uitgangen-en-antwoord]

La requête a deux sorties : **Réussi** (le serveur a répondu avec un statut de réussite) et **Échoué** (le serveur a répondu avec un statut d'erreur). Si Tillor n'atteint pas du tout le serveur, par exemple à cause d'un délai dépassé après 15 secondes ou d'une adresse refusée, l'exécution s'arrête avec le statut **Échoué**.

Trois variables sont disponibles pour les étapes suivantes :

| Variable | Contenu |
|---|---|
| `{response.status}` | Le code de statut, par exemple 200 |
| `{response.body}` | La réponse sous forme de texte, tronquée aux 4000 premiers caractères |
| `{response.data}` | La réponse sous forme de données, pour en extraire des champs avec `{response.data.items.0.id}` |

Vous trouverez comment les utiliser sous [Utiliser une réponse d'API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Un exemple complet avec une recherche se trouve sous [Contrôle d'une caravane de location](/automatiseringen/voorbeeld-nalopen).


# Tâches (/fr-FR/automatiseringen/acties/taken)

Avec ces étapes, une automatisation crée et modifie des tâches pour qu'un collègue s'en occupe. Elles se trouvent dans le groupe **Tâches**. Pour le fonctionnement des sorties, lisez [Les sorties d'une action](/automatiseringen/acties#uitgangen-van-een-actie).

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une tâche d'une automatisation est une tâche ordinaire : vous la trouvez sur la page des tâches, dans les vues qui lui correspondent et chez le client ou l'enregistrement auquel elle est liée.

```mermaid
flowchart LR
  A["Étape Créer une tâche"] --> T["Tâche sur la page des tâches<br/>au nom de Flux de travail"]
  T --> V["Les vues l'affichent<br/>si elle correspond ou figure dans la liste"]
  T --> C["Un collègue la prend en charge"]
  C -- "Le statut ou l'assignation change" --> E["Une autre automatisation peut démarrer"]
  D["Étape Demander une décision"] --> T2["Tâche avec boutons de choix"]
  T2 -- "Un collègue choisit un bouton" --> F["L'automatisation continue via cette option"]
```

Vous en saurez plus sur ce que voient et font les collègues sous [Tâches](/taken) et [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen).

## Créer une tâche [#taak-aanmaken]

Crée une tâche dans le système de tâches. La tâche est au nom de **Flux de travail**.

<DocScreenshot src="/screenshots/taken/automation-task-create-step.png" alt="Automatisation avec l'étape Créer une tâche sélectionnée et les paramètres à droite" />


| Champ | Ce que vous saisissez |
|---|---|
| **Titre** | Le nom de la tâche. Obligatoire |
| **Description** | Une explication de la tâche |
| **Assigner à** | Choisissez un ou plusieurs collègues. Cliquez sur un nom pour l'activer ou le désactiver |
| **Assigner à des groupes** | Choisissez un ou plusieurs [groupes](/gebruikers/groepen). La tâche concerne alors toutes les personnes qui font partie du groupe à ce moment-là |
| **Labels** | Choisissez un ou plusieurs [labels](/taken/labels) |
| **Assigner aussi la personne à l'origine de l'événement** | Assigne aussi la tâche au collègue qui a provoqué l'événement, par exemple celui qui a mis fin à l'occupation. Si le système a provoqué l'événement, personne n'est ajouté |
| **Priorité** | **Faible**, **Moyen**, **Élevé** ou **Urgent**. **Moyen** par défaut |
| **Ajouter au tableau** | Choisissez un tableau sur lequel la tâche apparaîtra, ou laissez vide |
| **Colonne** | Choisissez une colonne du tableau ci-dessus. La liste affiche les colonnes sous la forme *[tableau] · [colonne]* |
| **Sous-tâches** | Une sous-tâche par ligne, ou exactement une variable contenant une liste, comme `{result}` d'une étape [Exécuter du code](/automatiseringen/logica#code-uitvoeren) |
| **Échéance après** | Combien de minutes, d'heures, de jours ou de semaines après l'exécution de l'étape tombe l'échéance. Avec 0, la tâche n'a pas d'échéance. 1 jour par défaut |
| **Lier aux enregistrements** | Lie la tâche aux enregistrements ci-dessous et à leur client, terrain, facture, réservation ou compteur. Activé par défaut |
| **Lier à** | Apparaît quand **Lier aux enregistrements** est activé. Choisissez avec quels enregistrements la tâche apparaît. Tout ce que l'étape connaît est coché d'avance : les enregistrements du déclencheur et ce qu'une étape de recherche précédente a trouvé |
| **Seul le flux peut la terminer** | Les collègues ne peuvent ni terminer ni supprimer la tâche. Plus loin dans le flux, ajoutez une étape **Supprimer la tâche** ou **Définir le statut** pour la terminer |

Faites attention à ceci :

- Si vous ne choisissez personne sous **Assigner à** ou **Assigner à des groupes** et que vous laissez **Assigner aussi la personne à l'origine de l'événement** désactivé, la tâche n'a aucun collègue assigné. **Flux de travail** n'est jamais assigné lui-même
- Les sous-tâches ont le même titre que celui que vous saisissez, aucun collègue assigné et aucune échéance. Les lignes vides sont ignorées. Vous pouvez utiliser des variables dans les lignes
- Sous **Lier à**, il s'agit des clients, terrains, factures, réservations et compteurs. Pour une occupation qui se termine, la tâche est donc liée par défaut au terrain, au client et à la réservation. Si vous retirez un enregistrement de la liste, la tâche reste en dehors de celui-ci. Les enregistrements qui s'ajoutent plus tard au flux ne sont pas ajoutés automatiquement par Tillor dès que vous avez modifié vous-même la liste. Si vous recochez tout, l'étape suit de nouveau tous les enregistrements disponibles
- Si une tâche se trouve uniquement sur un tableau personnel, seules les personnes concernées la voient. Voir [Tâches privées](/taken/prive-taken)

Pour les étapes suivantes, l'action fournit `{createdTask.id}` et `{createdTask.name}`. Vous pouvez par exemple les utiliser ensuite pour définir le statut.

Si vous ne voulez pas de deuxième tâche alors qu'il existe déjà une tâche ouverte pour le même terrain ou le même client, placez d'abord une étape [Rechercher une tâche](#taak-zoeken) et ne créez la tâche que via **Introuvable**. L'[exemple Contrôle d'une caravane de location](/automatiseringen/voorbeeld-nalopen) le fait.

Si vous activez **Seul le flux peut la terminer**, la tâche affiche **Terminée par son automatisation**. Les collègues ne peuvent ni la terminer ni la supprimer.

## Supprimer la tâche [#taak-verwijderen]

Supprime une tâche, par exemple celle que ce flux a créée dès qu'elle n'est plus utile.

| Champ | Ce que vous saisissez |
|---|---|
| **Tâche** | L'identifiant de la tâche. `{createdTask.id}` par défaut. Obligatoire |

Une tâche déjà supprimée est ignorée. Le flux continue alors normalement.

## Définir le statut [#taakstatus-zetten]

Modifie le statut d'une tâche existante, par exemple pour la terminer.

| Champ | Ce que vous saisissez |
|---|---|
| **Tâche** | L'identifiant de la tâche. `{task.id}` par défaut. Obligatoire |
| **Statut** | **En attente**, **En cours**, **En attente de réponse** ou **Terminé**. **Terminé** par défaut |

`{task.id}` fonctionne quand l'automatisation démarre sur un événement de tâche, comme `task:created`. Après une étape **Créer une tâche**, utilisez `{createdTask.id}`. L'action fournit `{updatedTask.id}` et `{updatedTask.status}`.

## Rechercher une tâche [#taak-zoeken]

Recherche une tâche existante par titre. L'étape a deux sorties : **Trouvée** et **Introuvable**. Vous pouvez ainsi modifier une tâche si elle existe déjà, et sinon en créer une nouvelle.

| Champ | Ce que vous saisissez |
|---|---|
| **Titre** | Le titre exact que la tâche doit avoir, par exemple `Contrôle {occupation.terrain.name}`. Les variables sont remplies d'abord. Obligatoire |
| **Liée aux enregistrements de l'événement** | Uniquement les tâches liées à au moins un des mêmes enregistrements, comme le terrain ou le client. Activé par défaut |
| **Uniquement les tâches non terminées** | Ignore les tâches terminées. Activé par défaut |
| **Ignorer les sous-tâches** | Recherche uniquement les tâches principales. Activé par défaut |

Si plusieurs tâches correspondent, l'étape prend la plus récente. Si **Liée aux enregistrements de l'événement** est activé mais que l'événement n'a ni client, ni terrain, ni facture, ni réservation, ni compteur, le flux passe par **Introuvable**.

Via **Trouvée**, les étapes suivantes peuvent utiliser `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` et `{foundTask.status}`.

## Définir la priorité de la tâche [#taakprioriteit-zetten]

Modifie la priorité d'une tâche existante.

| Champ | Ce que vous saisissez |
|---|---|
| **Tâche** | L'identifiant de la tâche. `{foundTask.id}` par défaut. Obligatoire |
| **Modification** | **Un niveau plus haut** (par défaut), **Un niveau plus bas** ou **Vers une priorité fixe** |
| **Priorité** | Uniquement avec **Vers une priorité fixe** : **Faible**, **Moyen**, **Élevé** ou **Urgent** |
| **Augmenter jusqu'à** | Uniquement avec **Un niveau plus haut** : la priorité la plus haute que l'étape peut donner. **Élevé** par défaut. Une tâche qui a déjà cette priorité ou plus reste inchangée |

L'ordre est **Faible**, **Moyen**, **Élevé**, **Urgent**. Un niveau plus bas s'arrête à **Faible**. Si rien ne change, l'étape réussit simplement sans modifier la tâche. L'action fournit `{updatedTask.id}` et `{updatedTask.priority}`.

## Modifier la tâche [#taak-bijwerken]

Modifie une tâche existante. Les champs que vous laissez vides restent inchangés.

| Champ | Ce que vous saisissez |
|---|---|
| **Tâche** | L'identifiant de la tâche. `{foundTask.id}` par défaut. Obligatoire |
| **Nouveau titre** | Le nouveau nom de la tâche. Vide, le titre reste tel quel |
| **Personnes assignées** | Choisissez un ou plusieurs collègues |
| **Groupes** | Choisissez un ou plusieurs [groupes](/gebruikers/groepen) |
| **Assigner aussi la personne à l'origine de l'événement** | Ajoute aussi le collègue qui a provoqué l'événement. Si le système a provoqué l'événement, personne n'est ajouté |
| **Assignation** | **Ajouter aux actuelles** (par défaut) ou **Remplacer les actuelles** |
| **Ajouter des labels** | Choisissez un ou plusieurs [labels](/taken/labels). Ils s'ajoutent, les labels existants restent |
| **Échéance après** | Fixe l'échéance à ce nombre de minutes, d'heures, de jours ou de semaines après l'exécution de l'étape. Avec 0, l'échéance reste telle quelle |

Faites attention à ceci :

- Si vous choisissez **Remplacer les actuelles** et que vous n'indiquez personne, la tâche n'a ensuite plus personne d'assigné
- Si la tâche n'existe plus, l'étape échoue
- L'action fournit `{updatedTask.id}`


# Accès et appareils (/fr-FR/automatiseringen/acties/toegang-en-toestellen)

Ces actions touchent au parc lui-même : qui peut entrer, quels compteurs ont du courant et ce que font les tablettes. Voir [Contrôle d'accès](/toegangscontrole) pour le contexte des moyens d'accès. Pour le fonctionnement des sorties, lisez [Les sorties d'une action](/automatiseringen/acties#uitgangen-van-een-actie).

## Créer un moyen d'accès [#toegangsmiddel-aanmaken]

Donne à un client un accès par code QR, plaque d'immatriculation, code PIN ou NFC.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client, par exemple `{reservation.customerId}`. Obligatoire |
| **Type** | **Code QR** (par défaut), **Plaque d'immatriculation**, **Code PIN** ou **NFC** |
| **Valeur** | La plaque d'immatriculation ou le numéro NFC. Laissez vide pour un code QR ou un code PIN, car Tillor les crée lui-même |
| **Valable à partir du** | Une variable de date, par exemple `{reservation.checkIn}`. Vide signifie aucune limite |
| **Valable jusqu'au** | Une variable de date, par exemple `{reservation.checkOut}`. Vide signifie aucune limite |

Avec **Plaque d'immatriculation** et **NFC**, **Valeur** est obligatoire. L'action fournit `{createdAccessMethod.id}` et `{createdAccessMethod.value}`. La valeur est le code du code QR ou du code PIN. Avec l'identifiant, vous pouvez ensuite envoyer le code via **Envoyer ou imprimer le code QR**.

## Modifier l'accès [#toegang-bijwerken]

Bloque, débloque ou prolonge un moyen d'accès, ou tous les moyens d'accès d'un client.

| Champ | Ce que vous saisissez |
|---|---|
| **Lesquels** | **Un moyen d'accès** (par défaut) ou **Tous ceux d'un client** |
| **Moyen d'accès** | Uniquement avec **Un moyen d'accès** : l'identifiant, par exemple `{createdAccessMethod.id}`. Obligatoire |
| **Client** | Uniquement avec **Tous ceux d'un client** : l'identifiant du client, par exemple `{occupation.customerId}`. Obligatoire |
| **Statut** | **Laisser tel quel** (par défaut), **Actif**, **Bloqué temporairement**, **Bloqué** ou **Inactif** |
| **Valable jusqu'au** | Une variable de date. Vide conserve la date de fin actuelle |

Faites attention à ceci :

- Si vous laissez **Statut** sur **Laisser tel quel** et **Valable jusqu'au** vide, l'étape ne fait rien
- Avec **Tous ceux d'un client**, les moyens d'accès réglés sur **Ne pas prolonger automatiquement** conservent leur date de fin, comme lorsqu'un client paie une facture. Leur statut change bien. Avec **Un moyen d'accès**, l'étape modifie bien la date de fin, même si ce moyen d'accès est réglé sur **Ne pas prolonger automatiquement**

## Envoyer ou imprimer le code QR [#qr-code-versturen-of-afdrukken]

Envoie un code d'accès QR au client, l'imprime, ou les deux.

| Champ | Ce que vous saisissez |
|---|---|
| **Moyen d'accès** | L'identifiant du moyen d'accès. `{createdAccessMethod.id}` par défaut. Obligatoire |
| **Envoyer par e-mail** | Activé par défaut |
| **Envoyer par SMS** | Désactivé par défaut |
| **Envoyer par WhatsApp** | Désactivé par défaut |
| **Imprimer** | **Ne pas imprimer** (par défaut), **Imprimante d'étiquettes** ou **Imprimante à tickets** |

Si vous désactivez les trois canaux et choisissez **Ne pas imprimer**, l'étape ne fait rien.

## Ouvrir ou fermer la barrière [#slagboom-openen-of-sluiten]

Ouvre ou ferme une barrière ou un portail.

| Champ | Ce que vous saisissez |
|---|---|
| **Point d'accès** | Choisissez l'un de vos points d'accès. Obligatoire |
| **Action** | **Ouvrir** (par défaut) ou **Fermer** |

## Allumer ou couper le courant [#stroom-schakelen]

Allume ou coupe le courant d'un compteur intelligent. Par exemple pour couper le courant quand une occupation se termine.

| Champ | Ce que vous saisissez |
|---|---|
| **Quels compteurs** | **Tous les compteurs commutables d'un terrain** (par défaut) ou **Un compteur** |
| **Terrain** | Uniquement avec **Tous les compteurs commutables d'un terrain** : l'identifiant du terrain. `{occupation.terrainId}` par défaut. Obligatoire |
| **Compteur** | Uniquement avec **Un compteur** : choisissez le compteur. Obligatoire |
| **Courant** | **Allumé** ou **Coupé**. **Coupé** par défaut |

Faites attention à ceci :

- Avec **Tous les compteurs commutables d'un terrain**, l'étape ne commute que les compteurs qui peuvent commuter. Si le terrain n'en a aucun, il ne se passe rien
- Si la commutation d'un compteur échoue, l'étape échoue. Avec **Un compteur**, c'est aussi le cas si le compteur ne peut pas commuter. Les compteurs déjà commutés auparavant restent commutés

## Modifier les badges NFC [#nfc-tags-bijwerken]

Modifie tous les [badges NFC](/nfc/nfc-tags) d'un client.

| Champ | Ce que vous saisissez |
|---|---|
| **Client** | L'identifiant du client, par exemple `{occupation.customerId}`. L'action s'applique à chaque badge NFC de ce client. Obligatoire |
| **Action** | **Bloquer** (par défaut), **Débloquer**, **Recharger** ou **Envoyer un message de solde bas** |
| **Montant** | Uniquement avec **Recharger** : le montant en euros, par badge. Doit être supérieur à 0. Obligatoire |

Si le client a deux badges et que vous saisissez 20, chaque badge reçoit 20 euros de plus. Sans badges, l'étape ne fait rien. Avec un montant qui n'est pas un nombre supérieur à 0, l'étape échoue.

## Piloter une tablette ou une borne [#tablet-of-kiosk-bedienen]

Envoie une commande à une [tablette ou une borne](/mobiele-app/tablets-en-kiosken).

| Champ | Ce que vous saisissez |
|---|---|
| **Appareil** | Choisissez l'appareil. Obligatoire |
| **Commande** | **Réveiller** (par défaut), **Mettre en veille**, **Recharger**, **Identifier** ou **Lire un son de test** |

## Régler le diaporama [#diavoorstelling-instellen]

Place le diaporama sur chaque tablette et borne, ou sur un seul appareil. Le reste des paramètres de l'appareil reste en place. Si le même diaporama s'y trouve déjà, cet appareil est ignoré.

Un déclencheur horaire, puis une [requête API](/automatiseringen/acties/integraties#api-verzoek) vers un flux d'activités, et enfin cette étape : c'est ainsi que vous remplacez une synchronisation séparée. Reliez l'étape à la sortie **Réussi** de la requête.

| Champ | Ce que vous saisissez |
|---|---|
| **Appareils** | **Chaque tablette et kiosque** (par défaut) ou **Un seul appareil** |
| **Appareil** | Uniquement avec **Un seul appareil**. Obligatoire |
| **Mode** | **Écran de veille** (par défaut, après un moment sans toucher l'écran) ou **Arrière-plan** |
| **Secondes par photo** | Combien de temps une photo reste affichée. 10 par défaut. De 3 à 600 |
| **Attente avant le démarrage** | Uniquement avec **Écran de veille** : secondes sans toucher l'écran. 15 par défaut |
| **Ajustement** | **Remplir** ou **Ajuster** |
| **Photos** | **Depuis une requête précédente** (par défaut) ou **Adresses** |
| **Adresses des images** | Uniquement avec **Adresses** : une adresse https par ligne. Obligatoire |
| **Liste** | Chemin de la liste JSON, sans accolades. Après une requête API, c'est `response.data`. Obligatoire |
| **Champ de l'image** | Nom du champ contenant l'adresse https, par exemple `signage_image`. Obligatoire |
| **Champ de l'id** | Une même photo garde le même identifiant, de sorte qu'une liste inchangée n'envoie pas de nouveau message à l'appareil |
| **Champ du statut** et **Statut** | Uniquement les lignes dont ce champ a cette valeur, par exemple `CONFIRMED` |
| **Ignorer si renseigné** | Les lignes dont ce champ a une valeur sont écartées, par exemple `deleted_at` |
| **Champ de la date** et **Champ de la date de fin** | Une ligne reste tant que ce moment n'est pas passé. Si la date de fin est vide, la date décide |
| **Champ de tri** | Trie la liste par ordre croissant, par exemple sur `date` |
| **Nombre maximum de photos** | 5 par défaut, 20 au maximum |

Une adresse qui ne commence pas par `https://` est ignorée. Si la liste n'est pas un tableau JSON, l'étape échoue et le diaporama actuel reste en place.


# Aperçu (/fr-FR/automatiseringen)

Avec les automatisations, vous laissez Tillor agir sans qu'un collègue ait à y penser. Vous définissez une règle : *quand ceci se produit, faites cela*. Quelques exemples :

- Une occupation se termine sur une caravane résidentielle, donc Tillor crée une tâche de contrôle avec des sous-tâches et l'assigne au collègue qui a mis fin à l'occupation
- Une facture est échue, donc Tillor envoie un rappel de paiement et, une semaine plus tard, crée une tâche pour appeler le client si la facture est toujours impayée
- Une nouvelle réservation arrive, donc Tillor envoie les données à votre propre système
- Chaque lundi à 08:00, Tillor crée une tâche pour le contrôle hebdomadaire
- Une nouvelle réservation arrive, donc Tillor crée un code QR pour le client et l'envoie par e-mail

Vous construisez une automatisation vous-même sur un canevas, sans code. Vous choisissez un moment de départ, ajoutez des étapes et les reliez par des lignes.

## En termes simples [#in-gewone-woorden]

Une automatisation comporte trois types de blocs. Vous n'avez besoin de connaître les détails techniques que lorsqu'ils vous servent.

- **Le moment de départ (déclencheur)** est le « quand ». Il se passe quelque chose dans Tillor, comme la fin d'une occupation, ou c'est une certaine heure ou une certaine date. Voir [Déclencheurs](/automatiseringen/triggers)
- **La logique** est le « si ». Ici, le flux examine les données et choisit un chemin, ou attend que quelque chose se produise. Par exemple : *la facture est-elle toujours impayée après une semaine ?* Voir [Conditions, aiguillages et délais](/automatiseringen/logica)
- **Les actions** sont le « alors faites ». Créer une tâche, envoyer un message, comptabiliser une facture. Voir [Actions](/automatiseringen/acties)

En plus, les **variables** sont les données du moment lui-même, comme le nom du terrain ou du client. Vous les placez entre accolades dans un texte, et Tillor remplit la vraie valeur. Voir [Variables et modèles](/automatiseringen/variabelen).

## Qui peut l'utiliser [#wie-kan-het-gebruiken]

<Callout type="warn" title="Réservé aux administrateurs">
Les automatisations travaillent avec tous les droits dans votre organisation. Les consulter demande l'autorisation **Voir les automatisations**, les construire et les modifier **Gérer les automatisations**. Les administrateurs avec **Toutes les autorisations** peuvent faire les deux. Voir [Qui peut utiliser les automatisations ?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken).
</Callout>

Vous trouvez la page dans le menu latéral sous <UIPath>Administrateur > Automatisations</UIPath>.

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Chaque automatisation se compose d'étapes que vous reliez pour former un flux. Une automatisation travaille avec les tâches : elle crée des tâches, attend qu'un collègue choisisse un bouton, ou démarre dès qu'une tâche change. Voir [Tâches](/taken#hoe-hangt-dit-samen). Chaque fois qu'une automatisation démarre, nous parlons d'une exécution. Une exécution commence au moment de départ et suit les lignes vers le bas.

| Élément | Ce qu'il fait |
|---|---|
| **Quand ceci se produit** (déclencheur) | Le moment de départ. Un événement dans Tillor, un webhook, une action de tâche choisie, une facture échue, une date comme l'arrivée d'un client, une heure fixe ou un planning personnalisé. Un flux peut avoir plusieurs déclencheurs. Chaque déclencheur lance sa propre exécution |
| **Uniquement si** | Un filtre sur le déclencheur. L'automatisation ne démarre que si les données correspondent, par exemple uniquement pour les caravanes résidentielles |
| **Si / sinon** | Divise le flux en **Oui** et **Non** selon une ou plusieurs conditions |
| **Aiguillage** | Divise le flux en plusieurs branches, selon la valeur d'un champ |
| **Délai** et autres étapes d'attente | Font attendre le flux, jusqu'à une heure, une date, les heures d'ouverture, une condition, un événement ou une décision d'un collègue |
| **Ouvert maintenant ?**, **Rechercher un enregistrement**, **Pour chaque** | Vérifient si vous êtes ouvert, récupèrent un enregistrement ou exécutent les étapes suivantes pour chaque élément d'une liste |
| **Actions** | Font vraiment quelque chose : tâches, messages aux clients et aux collègues, factures, paiements et mandats, accès, compteurs et appareils, webhooks et requêtes API |

Les étapes avec plusieurs sorties, comme **Oui** et **Non**, **Terminé** et **Ignoré** ou **Réussi** et **Échoué**, vous permettent de choisir une suite différente selon le résultat. Pour chaque action, vous pouvez aussi activer une sortie **Erreur**, afin que le flux continue si l'étape échoue.

```mermaid
flowchart TD
  A["Quand ceci se produit<br/>La facture est échue"] --> B["Envoyer un rappel de paiement"]
  B --> C["Délai<br/>7 jours"]
  C --> D{"Si / sinon<br/>toujours impayée ?"}
  D -- Oui --> E["Créer une tâche<br/>appeler le client"]
  D -- Non --> F["Fin"]
```

## Variables [#variabelen]

Les champs de texte d'une étape acceptent des variables entre accolades, comme `{occupation.terrain.name}`. Tillor y remplit le nom du terrain lié à l'événement. Vous créez ainsi des messages et des tâches différents selon le cas. Pour en savoir plus, lisez [Variables et modèles](/automatiseringen/variabelen).

## Pour démarrer rapidement [#snel-aan-de-slag]

1. Allez dans **Administrateur > Automatisations** et cliquez sur **Nouvelle automatisation**
2. Choisissez un modèle ou **Partir de zéro**
3. Réglez le déclencheur et les étapes et cliquez sur **Enregistrer**
4. Essayez le flux dans l'onglet **Exécution de test**. Rien n'est alors réellement envoyé ni créé
5. Activez **Actif** quand vous êtes satisfait

La nouvelle automatisation est en pause tant que vous ne l'activez pas vous-même. Une explication pas à pas se trouve sous [Premiers pas](/automatiseringen/aan-de-slag).

<Callout type="info" title="Bon à savoir">
- Une nouvelle automatisation est en pause tant que vous ne l'activez pas vous-même
- Une automatisation compte au maximum 100 étapes. Les remarques et les cadres sur le canevas comptent à part, 50 au maximum
- Un **Aiguillage** a au maximum 8 branches, et **Demander une décision** au maximum 8 options
- Les plannings et les dates sont vérifiés chaque minute. Un événement démarre immédiatement
- Les modifications peuvent prendre une demi-minute avant de s'appliquer partout
- Une exécution échouée est envoyée par e-mail à la personne qui a créé l'automatisation, au maximum une fois par heure
- L'onglet **Exécutions** affiche les 20 dernières exécutions
- Un flux ne peut pas se lancer lui-même ni lancer un autre flux via ce qu'il crée lui-même
</Callout>

<Callout type="info" title="Les automatisations agissent pour de vrai">
Une automatisation activée envoie de vrais rappels et crée de vraies tâches. Utilisez l'onglet **Exécution de test** et regardez les premières exécutions dans l'onglet **Exécutions** avant d'être certain que tout est correct.
</Callout>

## Éléments [#onderdelen]

<Cards>
  <Card
    title="Premiers pas"
    href="/automatiseringen/aan-de-slag"
    description="L'aperçu, les modèles et l'éditeur, et comment enregistrer et activer une automatisation"
  />
  <Card
    title="Déclencheurs"
    href="/automatiseringen/triggers"
    description="Événements, dates, factures échues et plannings, plus les filtres et le démarrage unique"
  />
  <Card
    title="Conditions, aiguillages et délais"
    href="/automatiseringen/logica"
    description="Diviser le flux et le faire attendre, rechercher des enregistrements, parcourir des listes et demander une décision"
  />
  <Card
    title="Actions"
    href="/automatiseringen/acties"
    description="Tout ce qu'une automatisation peut faire, avec tous les champs"
  />
  <Card
    title="Variables et modèles"
    href="/automatiseringen/variabelen"
    description="Utiliser les données de l'événement dans vos textes"
  />
  <Card
    title="Qui exécute une automatisation ?"
    href="/automatiseringen/workflow-gebruiker"
    description="Pourquoi les tâches et les remarques d'une automatisation sont au nom d'un utilisateur système fixe"
  />
  <Card
    title="Tests et exécutions"
    href="/automatiseringen/testen-en-uitvoeringen"
    description="Faire une exécution de test et revoir les exécutions réelles"
  />
  <Card
    title="Problèmes et activation"
    href="/automatiseringen/problemen"
    description="Pourquoi une automatisation ne peut pas être activée et ce que signifient les messages"
  />
  <Card
    title="Exemple : contrôle d'une caravane de location"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Construire un flux complet pas à pas"
  />
  <Card
    title="Questions fréquentes"
    href="/automatiseringen/veelgestelde-vragen"
    description="Limites, explications sur la mise en pause et que faire quand il ne se passe rien"
  />
  <Card
    title="Pour les développeurs"
    href="/ontwikkelaars/automatiseringen"
    description="La requête API, l'enveloppe du webhook, la signature et la gestion via l'API"
  />
</Cards>

<Cards>
  <Card title="Exemples pratiques" href="/praktijk" description="Exemples détaillés tirés de la pratique" />
</Cards>

## Termes [#begrippen]

- **Automatisation** : une règle du type « quand ceci se produit, faites cela », construite sous forme de flux
- **Flux** : le canevas d'une automatisation, avec ses étapes et ses lignes
- **Déclencheur** : le moment de départ d'un flux
- **Exécution** : une fois où une automatisation démarre et parcourt le flux
- **Action** : une étape qui fait vraiment quelque chose, comme créer une tâche
- **Variable** : une donnée du moment, entre accolades dans un texte
- **Exécution de test** : un essai où rien n'est réellement envoyé ni créé
- **Flux de travail** : l'utilisateur au nom duquel travaille une automatisation

Vous trouverez d'autres termes dans le [glossaire](/begrippen).


# Conditions, aiguillages et délais (/fr-FR/automatiseringen/logica)

Avec les étapes du groupe **Logique**, vous décidez dans quelle direction un flux va et quand : le « si » et le « attends un peu ». Par exemple : *si la facture est toujours impayée après une semaine, créez une tâche*. Elles pilotent les actions qui suivent. Seule l'étape [Demander une décision](#vraag-om-een-beslissing) crée elle-même quelque chose, une tâche.

| Étape | Ce qu'elle fait | Sorties |
|---|---|---|
| [Si / sinon](#als--anders) | Sépare le flux selon des conditions | **Oui**, **Non** |
| [Aiguillage](#schakel) | Choisit une branche selon la valeur d'un champ | Une par branche et **Par défaut** |
| [Délai](#vertraging) | Attend une durée fixe ou jusqu'à une date | **Suivant** |
| [Ouvert maintenant ?](#nu-open) | Vérifie si vous êtes ouvert en ce moment | **Ouvert**, **Fermé** |
| [Attendre l'ouverture](#wachten-tot-open) | Attend la prochaine heure d'ouverture | **Suivant** |
| [Attendre la fermeture](#wachten-tot-gesloten) | Attend la prochaine heure de fermeture | **Suivant** |
| [Au plus une fois par période](#hoogstens-één-keer-per-periode) | Empêche les répétitions | **Continuer**, **Déjà exécuté** |
| [Rechercher un enregistrement](#record-opzoeken) | Récupère un enregistrement grâce à son identifiant | **Trouvée**, **Introuvable** |
| [Pour chaque](#voor-elk) | Exécute les étapes suivantes pour chaque élément d'une liste | **Pour chaque**, **Terminé** |
| [Attendre jusqu'à](#wachten-tot) | Attend que des conditions soient remplies | **Rempli**, **Délai dépassé** |
| [Attendre un événement](#wachten-op-een-gebeurtenis) | Attend qu'il se passe quelque chose dans Tillor | **Reçu**, **Délai dépassé**, parfois **Supprimé** |
| [Demander une décision](#vraag-om-een-beslissing) | Laisse un collègue choisir parmi vos options | Une par option et **Délai dépassé** |

## Si / sinon [#als--anders]

Sépare le flux en deux chemins selon les données. Le principe est le même que le filtre **Uniquement si** du déclencheur, mais au milieu du flux.

L'étape a deux sorties : **Oui** (les conditions sont remplies) et **Non** (elles ne le sont pas).

1. Ajoutez une étape **Si / sinon**
2. Sous **Conditions**, cliquez sur **Ajouter une condition**
3. Choisissez le champ avec le bouton **Variable**, ou saisissez vous-même le chemin, par exemple `invoice.paymentStatus`
4. Choisissez la comparaison (**est**, **n'est pas**, **contient**, **est supérieur à**, **est inférieur à**, **est l'un de**, **est vide** ou **n'est pas vide**) et saisissez la valeur
5. Reliez la sortie **Oui** et éventuellement **Non** à une étape suivante

Une étape **Si / sinon** a besoin d'au moins une condition. Sinon, Tillor affiche **Ajoutez une condition.** Avec plusieurs conditions, vous choisissez entre **Toutes doivent correspondre** et **Au moins une doit correspondre**. Les comparaisons fonctionnent comme décrit sous [Uniquement si](/automatiseringen/triggers#alleen-wanneer).

Vous n'êtes pas obligé de relier les deux sorties. Si une sortie ne mène nulle part, l'exécution se termine à cet endroit. Un flux qui ne fait quelque chose que sur **Oui** convient donc parfaitement.

Vous pouvez aussi utiliser les champs des étapes précédentes. Après une [Requête API](/automatiseringen/acties/integraties#api-verzoek), vous pouvez par exemple regarder `response.status` ou `response.data.paymentStatus`.

## Aiguillage [#schakel]

Choisissez **Aiguillage** quand il vous faut plus de deux chemins. L'étape regarde la valeur d'un seul champ et choisit la branche correspondante.

1. Sous **Champ**, choisissez le champ à examiner, par exemple `occupation.occupationType`
2. Sous **Branches**, cliquez sur **Ajouter une branche**. Saisissez la **Branche** (le nom qui apparaîtra sur la sortie) et **Égal à** (la valeur que le champ doit avoir)
3. Répétez l'opération pour chaque branche
4. Reliez chaque sortie à une étape suivante

Chaque branche reçoit sa propre sortie sous l'étape. Il y a en plus toujours une sortie **Par défaut**, utilisée quand aucune branche ne correspond.

- Le champ doit correspondre exactement à la valeur, majuscules comprises
- Si plusieurs branches correspondent, la première de la liste l'emporte
- Une branche sans valeur sous **Égal à** n'est pas prise en compte
- Vous pouvez configurer au maximum 8 branches, plus **Par défaut**
- Si le champ est vide ou n'existe pas, le flux passe par **Par défaut**

Les valeurs des champs à choix sont écrites selon la notation de Tillor. Une occupation de type caravane de location a par exemple la valeur `RENTAL_CARAVAN`, une facture payée `PAID`.

<Callout type="info">
La liste sous **Champ** affiche les champs de l'événement et des étapes précédentes. Les champs de la réponse d'une requête API n'apparaissent dans la liste que lorsque Tillor connaît un exemple de cette réponse. Voir [Utiliser une réponse d'API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).
</Callout>

## Délai [#vertraging]

Avec **Délai**, vous faites attendre le flux avant qu'il continue. Vous l'utilisez pour des choses comme *revérifier une semaine plus tard*.

Sous **Attendre**, vous choisissez l'une des deux manières.

### Pendant une durée fixe [#een-vaste-tijd]

Choisissez **Pendant une durée fixe** et saisissez sous **Durée** un nombre et une unité : **secondes**, **minutes**, **heures**, **jours** ou **semaines**. Les secondes ne sont pas exactes. Le flux peut continuer quelques secondes plus tard.

Un délai de 0 ne fait rien, c'est pourquoi Tillor affiche **Un délai de 0 ne fait rien.**

### Jusqu'à une date [#tot-een-datum]

Choisissez **Jusqu'à une date** quand la durée d'attente dépend d'une date issue des données, comme l'échéance d'une facture ou la date de fin d'une réservation.

| Champ | Ce que vous saisissez |
|---|---|
| **Date** | Un champ contenant une date, par exemple `invoice.dueDate`. La liste n'affiche que les champs qui sont une date |
| **Par rapport à cette date** | **Avant** ou **Après** |
| **Décalage** | Combien de temps avant ou après cette date, en minutes, heures, jours ou semaines. À 0, le flux continue exactement à cette date |

Exemples :

- **Date** `invoice.dueDate`, **Après**, **Décalage** 1 jour : le flux continue un jour après l'échéance
- **Date** `reservation.checkIn`, **Avant**, **Décalage** 2 jours : le flux continue deux jours avant l'arrivée

Si ce moment est déjà passé, ou si la date est vide, le flux continue immédiatement.

### Ce qui se passe pendant l'attente [#wat-er-tijdens-het-wachten-gebeurt]

- L'exécution prend le statut **En attente**. Dans l'onglet **Exécutions**, vous voyez quand elle reprend (**Reprend …**). Les longues attentes, comme des semaines, ne posent aucun problème
- Après le délai, Tillor relit les données, de sorte que les étapes suivantes voient l'état actuel. Voir ci-dessous
- Si vous mettez l'automatisation en pause pendant l'attente, l'exécution s'arrête dès que le temps d'attente est écoulé. Elle ne continue pas et prend le statut **Annulée**. Si vous réactivez l'automatisation avant la fin du temps d'attente, l'exécution continue normalement
- Si vous supprimez l'automatisation, les exécutions en attente s'arrêtent
- Si vous modifiez le flux pendant qu'une exécution attend, cette exécution se termine avec le flux tel qu'il était à son démarrage

### Les données sont relues [#gegevens-worden-opnieuw-gelezen]

Une exécution retient les données du moment de l'événement, mais relit les enregistrements associés avant de continuer. Il s'agit de l'enregistrement de l'événement (par exemple la facture) et des enregistrements auxquels il renvoie (par exemple le client).

Un exemple : une automatisation envoie une relance pour une facture, attend 7 jours, puis vérifie avec **Si / sinon** que `invoice.paymentStatus` n'est pas `PAID`. Si la facture a été payée dans la semaine, la condition voit la facture payée et le flux passe par **Non**.

Il y a deux exceptions :

- Si l'enregistrement n'existe plus, par exemple parce qu'une occupation a été supprimée, l'exécution garde la copie du moment de l'événement
- Les données produites par une étape précédente, comme la réponse d'une requête API, ne sont pas récupérées à nouveau. Si vous voulez ces données actualisées après un délai, faites une nouvelle requête API

<Callout type="info" title="Dans un test, rien n'est relu">
Une [exécution de test](/automatiseringen/testen-en-uitvoeringen) saute les délais et travaille avec les données d'exemple que vous saisissez vous-même. Ce qui se passe après un vrai délai, vous ne le voyez que dans une exécution réelle.
</Callout>

## Ouvert maintenant ? [#nu-open]

Vérifie si votre organisation est ouverte en ce moment et sépare le flux en **Ouvert** et **Fermé**. Il n'y a rien à configurer. Tillor utilise les heures sous **Paramètres > Heures d'ouverture**, avec les périodes saisonnières, les jours fériés et les exceptions. Voir [Paramètres de l'organisation](/gebruikers/organisaties#openingsuren).

Utilisez-la par exemple pour envoyer un autre texte ou créer une tâche en dehors des heures d'ouverture. Si vous préférez attendre d'être de nouveau ouvert, utilisez [Attendre l'ouverture](#wachten-tot-open). Si vous voulez attendre jusqu'à la fermeture, utilisez [Attendre la fermeture](#wachten-tot-gesloten).

## Attendre l'ouverture [#wachten-tot-open]

Met le flux en pause jusqu'à la prochaine heure d'ouverture, puis il continue. Votre organisation est déjà ouverte ? Alors le flux continue immédiatement. Il n'y a rien à configurer.

- L'heure d'ouverture provient de **Paramètres > Heures d'ouverture**, dans le fuseau horaire de votre organisation
- S'il n'y a aucune heure d'ouverture dans le mois à venir, le flux continue immédiatement au lieu de rester en attente
- Pendant l'attente, l'exécution prend le statut **En attente**. Ce qui se passe alors est décrit sous [Délai](#wat-er-tijdens-het-wachten-gebeurt)

## Attendre la fermeture [#wachten-tot-gesloten]

Met le flux en pause jusqu'à la prochaine heure de fermeture, puis il continue. Votre organisation est déjà fermée ? Alors le flux continue immédiatement. Il n'y a rien à configurer.

- L'heure de fermeture provient de **Paramètres > Heures d'ouverture**, dans le fuseau horaire de votre organisation
- Les plages qui se suivent, comme 9:00–12:00 et 12:00–17:00, comptent pour un seul bloc. Le flux attend la fin de ce bloc
- Pendant l'attente, l'exécution prend le statut **En attente**. Ce qui se passe alors est décrit sous [Délai](#wat-er-tijdens-het-wachten-gebeurt)

## Au plus une fois par période [#hoogstens-één-keer-per-periode]

Ne laisse passer le flux que s'il n'a pas déjà franchi cette étape pour le même enregistrement pendant la période. Ainsi, vous n'envoyez pas chaque jour la même relance à un client.

| Champ | Ce que vous saisissez |
|---|---|
| **Période** | Pendant combien de temps les exécutions précédentes comptent, en minutes, heures, jours ou semaines. 1 jour par défaut |
| **Par** | Sur quoi on compte. Vide signifie par enregistrement qui a démarré le flux, comme la facture ou la réservation. Saisissez une variable, par exemple `{customer.id}`, pour compter par client ou par terrain |

L'étape a deux sorties : **Continuer** si le flux n'est pas encore passé par là pendant la période, et **Déjà exécuté** si c'est le cas. Reliez **Déjà exécuté** à une autre étape, ou laissez-la vide pour que l'exécution se termine à cet endroit.

À noter :

- Seules les exécutions de la même automatisation comptent, et uniquement si elles ont franchi cette étape par **Continuer**
- Si vous ne reliez pas **Supprimé** à quelque chose, Tillor arrête les flux en attente de cet enregistrement et supprime les tâches que le flux a créées et que seul le flux pouvait terminer. Si vous reliez la sortie, le flux continue à cet endroit
- Si le flux démarre sans enregistrement, par exemple avec **Chaque jour à une heure**, saisissez vous-même une variable sous **Par**. Sans cette valeur, chaque exécution est nouvelle et l'étape n'empêche rien
- L'exécution en cours ne compte pas elle-même

Un exemple : **Période** 7 jours et **Par** `{invoice.customerId}` ne laisse passer qu'une relance par semaine au plus pour chaque client, même si ce client a plusieurs factures échues.

## Rechercher un enregistrement [#record-opzoeken]

Charge un enregistrement à partir de son identifiant, afin que les étapes suivantes puissent utiliser ses champs. C'est pratique quand l'événement ne fournit qu'un identifiant, comme le message dans une conversation de la boîte de réception.

| Champ | Ce que vous saisissez |
|---|---|
| **Type d'enregistrement** | **Client**, **Réservation**, **Occupation**, **Facture**, **Paiement**, **Terrain**, **Tâche**, **Document**, **Moyen d'accès**, **Badge NFC**, **Compteur**, **Conversation de la boîte de réception** ou **Message de la boîte de réception**. Par défaut **Message de la boîte de réception** |
| **Identifiant** | L'identifiant de l'enregistrement, par exemple `{messageId}`. Obligatoire |

L'étape a deux sorties : **Trouvée** et **Introuvable**. Si l'enregistrement n'existe pas ou si l'identifiant est vide, le flux passe par **Introuvable**.

Après **Trouvée**, les champs de l'enregistrement se trouvent dans des variables qui commencent par `found` suivi du type : `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Les autres types s'appellent `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` et `foundInboxThread`. Les enregistrements auxquels il renvoie y figurent aussi, sur un niveau de profondeur, comme `{foundReservation.customer.firstName}`. Tout se trouve dans la liste derrière le bouton **Variable**.

Une deuxième recherche du même type remplace la première. Attention pour **Tâche** : elle utilise le même nom `foundTask` que [Rechercher une tâche](/automatiseringen/acties/taken#taak-zoeken), et la dernière des deux l'emporte. Il en va de même pour **Document** et `foundDocument` de [Rechercher un document](/automatiseringen/acties/documenten#document-zoeken).

## Mapper des variables [#variabelen-mappen]

Copie des valeurs vers de nouveaux noms de variables, afin que les étapes suivantes puissent utiliser une seule forme. C'est pratique quand un même flux démarre par **Webhook entrant** (`{body.…}`) et par **Facture échue** (`{invoice.…}`).

| Champ | Ce que vous saisissez |
|---|---|
| **Mappages** | Des lignes avec **Variable cible** (p. ex. `invoice`) et **Source** (p. ex. `{foundInvoice}` ou `{body.invoiceId}`) |

L'étape a une seule sortie : **Suivant**. Si la source est exactement une variable entre accolades, par exemple `{foundInvoice}`, Tillor copie l'enregistrement entier (objet). Sinon, Tillor remplit la source comme du texte, comme `Facture {foundInvoice.displayId}` dans `meta.label`.

Test de webhook moyen : **Webhook entrant** → **Rechercher un enregistrement** (Facture, identifiant `{body.invoiceId}`) → **Mapper des variables** (`invoice` ← `{foundInvoice}`) → les mêmes conditions et la même approbation que pour le déclencheur de planification.

## Exécuter du code [#code-uitvoeren]

Exécute un morceau de TypeScript sur les variables du flux et conserve ce qu'il renvoie dans une nouvelle variable. Pour la logique que vous ne pouvez pas exprimer avec des champs et des conditions : quelles sous-tâches créer, calculer un montant ou une date, remodeler un corps de webhook.

| Champ | Ce que vous saisissez |
|---|---|
| **Code** | TypeScript. Vous écrivez les variables comme dans les textes, avec des accolades : `{customer.firstName}` est lu comme une valeur, non inséré comme du texte. Terminez par `return`. Obligatoire |
| **Variable de sortie** | Le nom sous lequel les étapes suivantes lisent le résultat, comme `result` (alors `{result}`) ou `result.names`. `result` par défaut |

L'étape a une seule sortie : **Suivant**. Voici comment cela fonctionne :

- Le code ne voit que les variables qu'il nomme. Une variable que le flux n'a pas vaut `null` ; une date arrive sous forme de texte (`2026-07-01T10:00:00.000Z`)
- Les formats et décalages de dates (`{bedrag|currency}`, `{datum + 1 day}`) ne fonctionnent pas ici : calculez-les dans le code
- Renvoyez une liste, un texte, un nombre ou un objet. Vous lisez ensuite un objet champ par champ : `{result.total}`
- Le code ne peut rien récupérer ni envoyer : pas d'internet, pas de base de données. Il se contente de calculer. Un calcul trop long (plus de 50 ms) est interrompu
- Si le code lève une erreur, l'exécution s'arrête avec cette erreur et le numéro de ligne. Vous les voyez dans l'onglet **Exécutions**
- À droite du code, vous voyez tout de suite ce qu'il renvoie sur l'exemple ; lors du test, il s'exécute aussi

Un exemple : après un départ, vous voulez des sous-tâches qui dépendent du terrain. Placez une étape **Exécuter du code** avec :

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

Remplissez ensuite, dans **Créer une tâche**, le champ **Sous-tâches** avec uniquement `{result}` : chaque texte de la liste devient une sous-tâche.

## Pour chaque [#voor-elk]

Exécute les étapes après **Pour chaque** une fois pour chaque élément d'une liste, par exemple pour chaque facture impayée d'un client. Le flux lui-même continue par **Terminé**.

| Champ | Ce que vous saisissez |
|---|---|
| **Liste** | **Moyens d'accès d'un client**, **Badges NFC d'un client**, **Factures impayées d'un client**, **Réservations à venir d'un client**, **Occupations d'un client**, **Documents d'un client** (uniquement les actifs) ou **Compteurs d'un terrain**. Par défaut **Moyens d'accès d'un client** |
| **De** | Le client ou le terrain dont vous voulez la liste, par exemple `{customer.id}` ou `{occupation.terrainId}`. Obligatoire |

L'étape a deux sorties qui ont chacune leur sens :

- **Pour chaque** mène aux étapes que vous voulez faire pour chaque élément
- **Terminé** est la façon dont le flux lui-même continue

Voici comment cela fonctionne :

- Chaque élément reçoit sa propre exécution, qui parcourt les étapes après **Pour chaque** jusqu'à la fin de cette branche. Vous les voyez dans l'onglet **Exécutions**, qui n'affiche que les 20 dernières
- L'élément se trouve dans la variable `item`, par exemple `{item.id}`. Les variables de l'événement et des étapes précédentes restent disponibles
- Le flux n'attend pas que les éléments soient terminés. Dès qu'ils sont lancés, il continue par **Terminé**. Vous ne pouvez donc pas utiliser le résultat d'un élément dans les étapes après **Terminé**
- Au maximum 100 éléments sont traités, les plus anciens d'abord. S'il y en a davantage dans la liste, les autres ne sont pas traités
- Si la liste est vide ou si le champ **De** est vide, rien ne démarre et le flux continue immédiatement par **Terminé**
- Les **Factures impayées d'un client** sont des factures comptabilisées dont il reste quelque chose à payer. Les **Réservations à venir d'un client** sont des réservations avec le statut **Réservé**

Un exemple : une facture arrive à échéance et vous voulez créer un lien de paiement pour chaque facture impayée de ce client. Choisissez **Factures impayées d'un client**, saisissez `{invoice.customerId}` sous **De** et placez après **Pour chaque** une étape **Créer un lien de paiement** avec `{item.id}` comme facture.

## Attendre jusqu'à [#wachten-tot]

Vérifie des conditions encore et encore jusqu'à ce qu'elles soient remplies, ou s'arrête après un certain temps. Utilisez-la quand vous ne savez pas quand quelque chose se produira mais que vous savez ce que vous attendez, par exemple qu'une facture soit payée.

| Champ | Ce que vous saisissez |
|---|---|
| **Jusqu'à** | Une ou plusieurs conditions, de la même manière que pour [Si / sinon](#als--anders) |
| **Vérifier toutes les** | À quelle fréquence Tillor regarde à nouveau, en minutes, heures, jours ou semaines. Au moins 5 minutes. 1 heure par défaut |
| **Arrêter d'attendre après** | Combien de temps l'étape attend au maximum. 7 jours par défaut |

L'étape a deux sorties : **Rempli** (les conditions sont remplies) et **Délai dépassé** (le temps d'attente est écoulé sans que les conditions le soient).

À noter :

- La première vérification a lieu immédiatement. Si les conditions sont déjà remplies, le flux continue directement par **Rempli**. Si vous n'avez saisi aucune condition, elle est toujours remplie
- À chaque vérification, Tillor relit les enregistrements de l'événement, comme pour un [délai](#gegevens-worden-opnieuw-gelezen). Une condition comme `invoice.paymentStatus` est `PAID` voit donc le paiement dès qu'il est là
- Un intervalle inférieur à 5 minutes devient 5 minutes
- Pendant l'attente, l'exécution prend le statut **En attente**. Pour la mise en pause et la modification du flux, la même chose s'applique que pour [Délai](#wat-er-tijdens-het-wachten-gebeurt)

## Attendre un événement [#wachten-op-een-gebeurtenis]

Met le flux en pause jusqu'à ce qu'il se passe quelque chose dans Tillor, par exemple que la facture soit payée.

| Champ | Ce que vous saisissez |
|---|---|
| **Événement** | Ce que vous attendez. La même liste que pour le [déclencheur](/automatiseringen/triggers#als-er-iets-gebeurt). Obligatoire |
| **Uniquement pour le même enregistrement** | Ne continue que si l'événement concerne l'enregistrement qui a démarré le flux. Activé par défaut |
| **Arrêter d'attendre après** | Combien de temps l'étape attend au maximum. 7 jours par défaut |

L'étape a deux sorties : **Reçu** (l'événement est arrivé) et **Délai dépassé** (le temps d'attente est écoulé sans événement). Si **Uniquement pour le même enregistrement** est activé, une troisième sortie s'ajoute, **Supprimé**. Vous l'utilisez quand l'enregistrement du flux a été supprimé pendant que le flux attendait.

À noter :

- Avec **Uniquement pour le même enregistrement** activé, seul compte par exemple le paiement de la facture avec laquelle le flux a démarré. Si vous le désactivez, chaque événement de ce type fait continuer le flux
- Si vous ne reliez pas **Supprimé** à quelque chose, Tillor arrête les flux en attente de cet enregistrement et supprime les tâches que le flux a créées et que seul le flux pouvait terminer. Si vous reliez la sortie, le flux continue à cet endroit
- Si le flux démarre sans enregistrement, par exemple avec **Chaque jour à une heure**, chaque événement de ce type compte
- Un événement qu'une étape d'une automatisation provoque elle-même compte aussi. Les flux en attente continuent donc aussi grâce au travail de **Flux de travail**
- Après **Reçu**, les données de l'événement que vous attendiez se trouvent dans les variables, sans le collègue qui l'a provoqué. Si vous attendez `invoice:paid`, `{invoice.paymentStatus}` donne ensuite le nouvel état
- Pendant l'attente, l'exécution prend le statut **En attente**. Pour la mise en pause et la modification du flux, la même chose s'applique que pour [Délai](#wat-er-tijdens-het-wachten-gebeurt)

## Demander une décision [#vraag-om-een-beslissing]

Crée une tâche avec des boutons que vous définissez vous-même, et attend que quelqu'un choisisse un bouton. Vous prévoyez ainsi un moment où un humain vérifie, par exemple avant que le flux bloque un client ou comptabilise une facture. Chaque option est un bouton sur la tâche et une sortie de l'étape.

| Champ | Ce que vous saisissez |
|---|---|
| **Titre de la tâche** | Le titre de la tâche. Obligatoire |
| **Description** | Dites à votre collègue ce qu'il faut décider |
| **Options** | Les boutons sur la tâche. Voir ci-dessous. Au moins une |
| **Assigner à** | Choisissez un ou plusieurs collègues |
| **Assigner à des groupes** | Choisissez un ou plusieurs groupes |
| **Lier à** | Les enregistrements auprès desquels la tâche apparaît, comme le client ou la facture. Pré-rempli avec les enregistrements connus à cette étape |
| **Arrêter d'attendre après** | Combien de temps l'étape attend au maximum. 3 jours par défaut |

### Configurer les options [#opties-instellen]

1. Sous **Options**, cliquez sur **Ajouter une option** et saisissez le nom, par exemple **Approuver**. Ce nom figure sur le bouton et sur la sortie
2. Cliquez sur la petite case colorée à gauche du nom (**Icône et couleur**) pour choisir une couleur et une icône. Une icône n'est pas obligatoire
3. Activez **Demander une note** si le collègue doit indiquer une raison pour ce choix
4. Activez **Demander une confirmation** si le collègue doit d'abord confirmer. Vous saisissez alors un **Titre de confirmation** et un **Message de confirmation**, et vous choisissez sous **Gravité** entre **Info**, **Avertissement** ou **Destructif**. Vous pouvez utiliser des variables dans ces textes
5. Répétez l'opération pour chaque option. Vous pouvez créer au maximum 8 options

Si la liste est encore vide, le bouton **Approuver / Refuser** prépare tout de suite deux options : un **Approuver** vert et un **Refuser** rouge. Chaque option a besoin d'un nom, sinon Tillor affiche **Chaque option a besoin d’un nom.** Sans options, Tillor affiche **Ajoutez au moins une option.**

### Sorties [#uitgangen]

L'étape a une sortie par option, avec le nom et la couleur de cette option, plus toujours **Délai dépassé**.

| Sortie | Quand |
|---|---|
| Le nom d'une option | Quelqu'un a choisi ce bouton sur la tâche |
| **Délai dépassé** | Le temps d'attente est écoulé sans choix, ou la tâche a été supprimée |

À noter :

- Les boutons figurent sur la carte de la tâche, dans la liste des tâches et dans la tâche elle-même. Une telle tâche n'a pas de case à cocher : vous ne pouvez pas simplement la terminer, seulement choisir un bouton. Après le choix, la tâche passe à **Terminée** et indique quelle option a été choisie. Voir [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen)
- Peut choisir toute personne assignée à la tâche, y compris via un groupe, ainsi que les administrateurs. Si vous n'assignez personne, toute personne qui voit la tâche peut choisir
- La tâche reçoit la priorité **Élevé**. Elle est au nom de **Flux de travail**
- Si la tâche est supprimée avant que quelqu'un ait choisi, le flux continue par **Délai dépassé**. Après **Délai dépassé** à cause du temps d'attente, la tâche reste en place
- Les étapes suivantes peuvent utiliser `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` et `{approval.decidedBy.name}`. `{approval.label}` est le nom de l'option choisie et `{approval.note}` la note saisie par le collègue
- Pendant l'attente, l'exécution prend le statut **En attente**. Pour la mise en pause et la modification du flux, la même chose s'applique que pour [Délai](#wat-er-tijdens-het-wachten-gebeurt)

<Callout type="info" title="Dans un test, vous choisissez vous-même la sortie">
Une [exécution de test](/automatiseringen/testen-en-uitvoeringen) ne peut pas savoir si vous êtes ouvert, ce que décide un collègue ni si un enregistrement existe. Sous **Que se passe-t-il à ces étapes ?**, vous choisissez donc vous-même la sortie de **Ouvert maintenant ?**, **Au plus une fois par période**, **Rechercher un enregistrement**, **Pour chaque**, **Attendre jusqu'à**, **Attendre un événement** et **Demander une décision**. Pour **Pour chaque**, le test passe par la sortie que vous choisissez, **Pour chaque** ou **Terminé**, pas par les deux.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une sortie que vous ne reliez pas fait se terminer l'exécution à cet endroit.
- Pour une étape d'attente, l'exécution prend le statut <Status tone="info">En attente</Status> et continue plus tard. Une automatisation en pause arrête les exécutions en attente dès que le temps d'attente est écoulé.
- Après un temps d'attente, Tillor relit les données, de sorte que les étapes voient l'état actuel.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor affiche Ajoutez une condition">
Une étape **Si / sinon** a besoin d'au moins une condition. Cliquez sur **Ajouter une condition**.
</Accordion>
<Accordion title="Tillor affiche Un délai de 0 ne fait rien">
Saisissez sous **Durée** un nombre supérieur à 0.
</Accordion>
<Accordion title="Le flux passe toujours par Par défaut">
Un **Aiguillage** compare la valeur exactement, majuscules comprises. Les valeurs de choix sont écrites selon la notation de Tillor, comme `RENTAL_CARAVAN`. Si le champ est vide, le flux passe aussi par **Par défaut**.
</Accordion>
<Accordion title="Tillor affiche Ajoutez au moins une option ou Chaque option a besoin d’un nom">
Une étape **Demander une décision** a besoin d'au moins une option avec un nom. Sous **Options**, cliquez sur **Ajouter une option**.
</Accordion>
<Accordion title="L'exécution reste sur En attente">
Le flux attend un moment, une condition, un événement ou une décision. Dans l'onglet **Exécutions**, vous voyez quand il continue ou quand le délai est dépassé. Pour **Attendre jusqu'à**, c'est par défaut après 7 jours, pour **Demander une décision** après 3 jours.
</Accordion>
<Accordion title="La tâche de Demander une décision a disparu">
Si la tâche est supprimée avant que quelqu'un ait choisi, le flux continue par **Délai dépassé**. Voir [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
</Accordions>


# Problèmes et activation (/fr-FR/automatiseringen/problemen)

Tillor contrôle votre flux en permanence pendant que vous le construisez. Tant qu'il reste des problèmes ouverts, vous ne pouvez pas activer l'automatisation. Cela évite qu'un flux qui ne peut pas fonctionner essaie d'envoyer de vraies relances ou de créer de vraies tâches.

## Où voir les problèmes [#waar-zie-je-de-problemen]

- Sur chaque étape qui a un problème, un petit nombre d'avertissement s'affiche
- Dans le panneau à droite, les problèmes de l'étape sélectionnée figurent dans un bloc orange au-dessus des paramètres
- En haut du panneau se trouve un bouton avec le total, par exemple **3 problèmes**. Cliquez dessus pour voir la liste, puis cliquez sur un message pour aller à l'étape
- Dans l'aperçu des automatisations, une étiquette telle que **3 problèmes** figure à côté du nom, ainsi qu'un filtre **Problèmes**

<DocScreenshot src="/screenshots/automatiseringen/issues.png" alt="Bouton 1 problème en haut du panneau avec le message Le titre est obligatoire" />

## Pourquoi je ne peux pas activer [#waarom-kan-ik-niet-inschakelen]

L'interrupteur **Actif** ne fonctionne pas tant qu'il y a des problèmes, avec le texte **Corrigez d'abord les problèmes en cours**. Dans l'aperçu, vous ne pouvez donc pas non plus activer l'interrupteur de l'automatisation.

Si l'automatisation est déjà activée, vous ne pouvez pas enregistrer de modifications qui contiennent des problèmes. Un flux qui tourne doit rester valide. Corrigez les problèmes, ou mettez d'abord l'automatisation en pause.

## Ce que signifient les messages [#wat-de-meldingen-betekenen]

| Message | Ce qui se passe | Ce que vous faites |
|---|---|---|
| **Ajoutez un déclencheur pour commencer.** | Le flux n'a pas de déclencheur | Un flux a toujours besoin d'au moins un déclencheur. Faites glisser **Quand ceci se produit** de la liste à gauche vers le canevas |
| **Cet événement n'existe plus. Choisissez-en un autre.** | L'événement du déclencheur n'existe plus | Choisissez-en un autre sous **Événement** |
| **Non connectée, cette étape ne s'exécute donc jamais.** | Aucune ligne n'arrive à l'étape | Reliez l'étape à une sortie d'une autre étape, ou supprimez-la |
| **Cette étape fait partie d'une boucle. Un flux ne peut qu'avancer.** | Une ligne revient sur une étape précédente | Supprimez la ligne qui revient en arrière. Un flux ne peut pas tourner en rond |
| **[Champ] est obligatoire.** | Un champ obligatoire est vide, comme le **Titre** d'une tâche | Remplissez le champ. Les champs obligatoires ont un astérisque |
| **[Champ] : [variable] n'est pas disponible à cette étape.** | Vous utilisez une variable qui n'existe pas à cette étape | Choisissez une variable dans la liste derrière le bouton **Variable**. Vérifiez aussi que l'étape qui fournit la variable se trouve plus tôt dans le flux |
| **[Champ] n'est pas un JSON valide.** | La **Charge utile** ou le **Corps** n'est pas du JSON valide | Vérifiez les accolades, les virgules et les guillemets. Les variables sont autorisées |
| **Ajoutez au moins une option.** | Une étape **Demander une décision** n'a pas d'options | Sous **Options**, cliquez sur **Ajouter une option** |
| **Chaque option a besoin d’un nom.** | Une option de **Demander une décision** n'a pas de nom | Saisissez le nom ou supprimez l'option |
| **Ajoutez une condition.** | Une étape **Si / sinon** n'a pas de conditions | Cliquez sur **Ajouter une condition** |
| **Une condition n'a pas de champ valide.** | Le champ d'une condition est vide ou inconnu | Choisissez ou saisissez un champ qui figure dans la liste derrière **Variable** |
| **Saisissez une valeur pour [variable].** | Une condition a une comparaison mais pas encore de valeur | Saisissez la valeur, ou choisissez une comparaison comme **est vide** qui n'en a pas besoin |
| **[Champ] : [variable] n’est pas un format connu.** | Vous utilisez après le `\|` un format qui n'existe pas | Utilisez `currency`, `number`, `date`, `datetime`, `time`, `upper` ou `lower`. Voir [Mettre une valeur en forme](/automatiseringen/variabelen#een-waarde-opmaken) |
| **[Champ] : [variable] n'est pas une unité.** | Vous écrivez un décalage de date avec une unité qui n'existe pas | Utilisez `minutes`, `hours`, `days`, `weeks` ou `months` |
| **[Champ] : le champ personnalisé [variable] n'existe pas.** | Vous utilisez un champ personnalisé qui n'existe pas (ou plus) | Choisissez un champ existant dans la liste derrière **Variable** |
| **[Champ] : [variable] a un format ou un décalage de date, qui ne fonctionne que dans les textes.** | Vous utilisez un format dans le champ de code de **Exécuter du code** | Calculez-le dans le code |
| **[Champ] : [variable] n'est pas un nom de variable.** | Le nom d'un résultat contient des caractères non autorisés | Utilisez des lettres, des chiffres et des points, comme `result` ou `result.names` |
| **Un délai de 0 ne fait rien.** | Le délai est à 0 | Saisissez une durée supérieure à 0 |
| **Le chemin doit commencer par / et rester dans l'API de votre organisation.** | Le **Chemin** d'une requête API n'est pas autorisé | Faites commencer le chemin par un seul `/` et n'y mettez ni `..` ni `\` |
| **L'URL doit commencer par https://.** | L'**URL** d'une requête API n'est pas sûre | Utilisez une adresse qui commence par `https://` |
| **L'expression cron n'est pas valide. Utilisez cinq champs, par exemple 0 8 * * 1.** | L'expression cron est incorrecte | Voir [Selon une expression cron](/automatiseringen/triggers#volgens-een-cron-expressie) |

## Ce que Tillor ne peut pas contrôler à l'avance [#wat-tillor-niet-vooraf-kan-controleren]

Certaines erreurs n'apparaissent que lorsque le flux tourne réellement.

- Une URL composée de variables ne peut être contrôlée qu'une fois remplie
- Pour les événements dont les données ne sont pas décrites, Tillor ne contrôle pas les variables
- Qu'un enregistrement existe, qu'une facture puisse être envoyée ou qu'un autre serveur soit joignable ne se révèle que pendant une exécution

Un flux sans messages n'est donc pas forcément un flux qui réussit toujours. Testez-le avec [Tests et exécutions](/automatiseringen/testen-en-uitvoeringen) et vérifiez les premières exécutions réelles.

<Callout type="info" title="Un événement qui disparaît">
Si un événement ou un champ sur lequel votre flux s'appuie change, vous le voyez sous forme de message sur l'étape concernée. Modifiez l'étape avant de réactiver l'automatisation.
</Callout>


# Tests et exécutions (/fr-FR/automatiseringen/testen-en-uitvoeringen)

Dans l'éditeur, vous travaillez avec deux onglets pour vérifier qu'un flux fait ce que vous voulez : **Exécution de test** pour un essai et **Exécutions** pour ce qui s'est réellement passé. Vous les ouvrez à droite dans le panneau. Le quatrième onglet, **Historique**, affiche les versions précédentes du flux, voir [Versions précédentes](/automatiseringen/aan-de-slag#eerdere-versies).

## Une exécution de test [#een-testuitvoering]

Choisissez l'onglet **Exécution de test**. Un test parcourt le flux avec des données d'exemple et montre quelles étapes il suivrait.

<Callout type="info" title="Rien de réel ne se passe">
Une exécution de test n'envoie rien, ne crée rien et ne modifie rien. Les délais sont ignorés, afin que vous voyiez tout de suite le résultat final. Les actions montrent seulement ce qu'elles feraient, avec le texte **Non exécuté lors d'un test.**
</Callout>

<DocScreenshot src="/screenshots/automatiseringen/test-run.png" alt="Onglet Exécution de test avec les données d'exemple et le résultat par étape" />

### Données d'exemple [#voorbeeldgegevens]

En haut se trouve **Tester avec un enregistrement réel**. Pour chaque enregistrement du déclencheur, comme **Occupation**, choisissez un enregistrement via **Choisir un enregistrement** (recherche par nom ou numéro). Tillor charge l'enregistrement tel qu'il est actuellement, avec les enregistrements auxquels il renvoie, dans les données d'exemple. Le test n'envoie, ne crée et ne modifie toujours rien.

Sous **Données d'exemple de l'événement** figurent les données avec lesquelles le test travaille, sous forme de JSON. Si l'automatisation a déjà démarré une fois pour de bon, le test commence avec les données de la dernière exécution réelle. Sinon, Tillor remplit un exemple qui a la forme de l'événement : un texte devient *example*, un nombre 1 et une date le moment présent.

Modifiez les valeurs pour essayer d'autres cas, par exemple un autre type de terrain ou une facture avec un autre statut. Si le texte n'est pas du JSON valide, vous voyez **Les données d'exemple ne sont pas un JSON valide.** et vous ne pouvez pas lancer le test.

Si le flux contient une **Requête API**, un champ **Exemple de réponse API** apparaît aussi. Collez-y la réponse que vous attendez de la requête. Le test peut ainsi parcourir les étapes après la requête, et Tillor propose les champs de la réponse comme variables. Voir [Utiliser une réponse d'API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).

### Que se passe-t-il à ces étapes [#wat-gebeurt-er-bij-deze-stappen]

Pour certaines étapes, le résultat dépend du monde extérieur : **Envoyer un webhook**, **Requête API**, les actions avec une sortie **Ignoré** ou **Erreur**, et la logique comme **Ouvert maintenant ?**, **Rechercher un enregistrement**, **Attendre un événement** et **Demander une décision**. Sous **Que se passe-t-il à ces étapes ?**, vous choisissez pour chaque étape la sortie par laquelle le test continue. Vous testez ainsi aussi le chemin à suivre quand quelque chose tourne mal.

### Le résultat [#het-resultaat]

Cliquez sur **Lancer le test**. Vous voyez les étapes dans l'ordre, avec pour chacune :

- les valeurs saisies, par exemple le titre d'une tâche tel qu'il serait créé
- pour une condition, ligne par ligne ce qui a été comparé et si c'était correct. Le vert signifie réussi, le rouge non, avec la valeur réellement présente (*était …*)
- la sortie par laquelle le flux a continué (**Continue sur : Oui**)
- pour un délai, jusqu'à quand on attendrait

Après l'exécution, le bouton s'appelle **Relancer**. Le test rejoue les étapes une par une (**Étape 2 sur 5…**). Avec **Tout afficher**, vous sautez cette lecture. Sur le canevas, le chemin pris par le test se colore, et les étapes qui n'ont pas été atteintes sont estompées. Cliquez sur le nom d'une étape dans le résultat pour aller à cette étape. En bas figure **Terminé après 5 étapes.**

Si le filtre sous **Uniquement si** ne correspond pas à vos données d'exemple, vous voyez **Le filtre du déclencheur ne correspond pas à ces données, le flux ne démarrerait donc pas.** Vérifiez alors quelle condition est en rouge. Avec **Effacer**, vous retirez le résultat du canevas.

### Ce qu'un test ne montre pas [#wat-een-test-niet-laat-zien]

- Si une facture peut réellement être envoyée, si un point de terminaison est joignable ou si un chemin d'API existe
- À quoi ressemblent les enregistrements après un délai. Le test travaille avec vos données d'exemple et ne relit rien
- Les erreurs qui n'apparaissent qu'avec de vraies données, comme un champ vide

Consultez donc toujours les premières exécutions réelles dans l'onglet **Exécutions**.

## Exécutions réelles [#echte-uitvoeringen]

Dans l'onglet **Exécutions** figurent les 20 dernières exécutions réelles de cette automatisation, les plus récentes en haut. La liste s'actualise d'elle-même environ toutes les 15 secondes. Tant que rien n'a démarré, vous voyez **Aucune exécution pour le moment. Activez l'automatisation et attendez son événement.**

Chaque exécution affiche l'heure de démarrage, le nombre d'étapes ou (en cas d'attente) quand elle reprend, et un statut.

| Statut | Ce que cela signifie |
|---|---|
| **En cours** | L'exécution est en cours en ce moment |
| **En attente** | L'exécution est dans un [délai](/automatiseringen/logica#vertraging), attend un événement ou une approbation, et continuera plus tard |
| **Terminée** | Le flux a été parcouru jusqu'au bout |
| **Échouée** | Une étape n'a pas pu être exécutée. Le message figure à côté sous la forme **Échec : …** |
| **Annulée** | L'exécution s'est arrêtée parce que l'automatisation a été mise en pause ou supprimée pendant qu'elle attendait |

Cliquez sur une exécution pour l'ouvrir. Vous voyez alors :

- toutes les étapes effectuées, avec l'heure et ce que l'étape a fait
- les valeurs saisies, par exemple le titre que la tâche a réellement reçu
- pour une condition, quelles lignes étaient correctes
- pour une étape échouée, le message d'erreur, qui peut être en anglais

Sur le canevas, le chemin pris par cette exécution se colore. Les étapes qui n'ont pas été atteintes sont estompées. Cliquez sur le nom d'une étape pour aller à cette étape.

Sous les étapes figure un bouton tel que **3 jeux de données**. Il affiche les données avec lesquelles l'exécution a démarré et ce que chaque action a produit, comme l'identifiant de la tâche créée ou la réponse d'une requête API. Vous pouvez ainsi vérifier quelles valeurs avait une variable.

En bas d'une exécution ouverte figure aussi une **Trace** : un code de lettres et de chiffres. Si quelque chose ne va pas dans une exécution, transmettez ce code au support. Nous retrouvons ainsi précisément cette exécution.

<Callout type="info">
Les événements qui n'ont pas passé le filtre sous **Uniquement si**, ou pour lesquels l'automatisation a déjà tourné avec **Exécuter une fois par enregistrement**, ne démarrent pas d'exécution et ne figurent donc pas dans la liste.
</Callout>

Dans l'aperçu des automatisations, chaque automatisation affiche l'heure de la dernière exécution, avec à côté une petite barre par exécution récente.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Après une exécution de test, rien n'a changé dans Tillor. L'automatisation ne tourne réellement que lorsque vous activez **Actif**.
- Les exécutions réelles restent dans l'onglet **Exécutions**. Il affiche les 20 dernières.
- Une exécution échouée envoie un e-mail à la personne qui a créé l'automatisation, au plus un par heure.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Les données d'exemple ne sont pas un JSON valide">
Tillor affiche **Les données d'exemple ne sont pas un JSON valide.** et ne lance pas le test. Vérifiez les accolades, les virgules et les guillemets.
</Accordion>
<Accordion title="Le filtre du déclencheur ne correspond pas à ces données">
Avec ces données d'exemple, le flux ne démarrerait pas. Regardez quelle condition est en rouge et modifiez les données ou la condition.
</Accordion>
<Accordion title="Je ne vois aucune exécution">
Tillor affiche **Aucune exécution pour le moment. Activez l'automatisation et attendez son événement.** Les événements qui n'ont pas passé le filtre n'y figurent pas. Voir [Questions fréquentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Le test réussit, mais l'exécution réelle échoue">
Un test n'envoie rien et ne relit pas les enregistrements. Qu'une facture puisse être envoyée ou qu'une adresse soit joignable ne se révèle que pour de vrai. Ouvrez l'exécution pour voir le message d'erreur et les données par étape. Besoin de l'aide du support ? Transmettez le code **Trace** de l'exécution.
</Accordion>
</Accordions>

## Une exécution qui ne veut pas démarrer [#een-uitvoering-die-niet-wil-starten]

Voir [Questions fréquentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) pour une liste de contrôle.


# Déclencheurs (/fr-FR/automatiseringen/triggers)

Le déclencheur est le point de départ d'une automatisation : le « quand ». Il se trouve tout en haut de chaque flux, sous le nom **Quand ceci se produit**. Un exemple : *démarrer quand une occupation se termine*. Il détermine aussi les données que les étapes suivantes peuvent utiliser. Un flux peut avoir plusieurs déclencheurs. Chaque déclencheur lance sa propre exécution, avec son propre filtre. Vous en ajoutez un depuis la liste à gauche. Vous ne pouvez pas supprimer le dernier déclencheur.

<DocScreenshot src="/screenshots/automatiseringen/trigger-settings.png" alt="Déclencheur sélectionné avec les champs Démarrer par et Événement, le filtre Uniquement si et les données fournies par l'événement" />

## Ce qui lance l'automatisation [#waar-start-de-automatisering-op]

Avec **Démarrer par**, vous choisissez l'un des sept points de départ.

| Choix | Démarre quand |
|---|---|
| **Quand quelque chose se passe** | Un événement a lieu dans Tillor, par exemple une occupation qui se termine ou une facture qui est payée |
| **Facture échue** | Une facture comptabilisée est toujours ouverte après sa date d'échéance |
| **Webhook entrant** | Un autre système envoie un message à l'adresse propre de l'automatisation |
| **Une action de tâche est choisie** | Quelqu'un choisit, sur une tâche, un bouton de choix lié à cette automatisation |
| **Une date est atteinte** | La date d'un enregistrement est atteinte, éventuellement un certain temps avant ou après. Par exemple un jour avant l'arrivée d'une réservation |
| **Chaque jour à une heure** | Il est l'heure choisie, chaque jour |
| **Selon une expression cron** | C'est le tour du planning que vous indiquez |

Vous choisissez donc d'abord le type de point de départ, puis les détails. Si vous choisissez un autre point de départ, les filtres de **Uniquement si** sont vidés. Ils avaient été écrits pour le choix précédent et ne conviennent plus.

## Quand quelque chose se passe [#als-er-iets-gebeurt]

Choisissez dans **Événement** ce qui doit lancer l'automatisation. Cliquez sur le champ et tapez pour chercher, par exemple *occupation* ou *invoice*. Les événements sont écrits dans la notation de Tillor, comme `occupation:ended` : d'abord de quoi il s'agit, puis ce qui s'est passé.

Voici les événements dont vous avez le plus souvent besoin :

| Événement | Démarre quand |
|---|---|
| `occupation:ended` | Une occupation se termine |
| `reservation:created` | Une réservation est créée |
| `reservation:updated` | Une réservation est modifiée |
| `customer:created` | Un client est créé |
| `customer:updated` | Un client est modifié |
| `invoice:created` | Une facture est créée |
| `invoice:updated` | Une facture est modifiée |
| `invoice:paid` | Une facture est payée |
| `payment:created` | Un paiement arrive |
| `task:created` | Une tâche est créée |
| `task:status-changed` | Le statut d'une tâche change |
| `task:assigned` | Une tâche est assignée à quelqu'un |
| `task:action-chosen` | Quelqu'un choisit un bouton de choix sur une tâche |
| `integration-alarm:created` | Un compteur émet une alarme |
| `comment:created` | Un commentaire est publié |
| `document:created` | Un document est ajouté |
| `signatureRequest:updated` | Une demande de signature est mise à jour |
| `signatureRequest:completed` | Tous les signataires d'une demande de signature ont signé |
| `mandate-agreement:signed` | Un client a signé un mandat SEPA |
| `mandate-agreement:activated` | Un mandat SEPA est devenu actif |
| `mandate-agreement:expired` | Une demande de mandat SEPA a expiré sans signature |
| `mandate-agreement:failed` | L'activation d'un mandat SEPA a été refusée ou a échoué |
| `productPriceChange:applied` | Un [prix de produit planifié](/producten/prijzen-plannen) entre en vigueur |

C'est la même liste que celle des [webhooks](/ontwikkelaars/events). Vous pouvez donc utiliser tout événement pour lequel Tillor peut envoyer un webhook. Quelques événements extrêmement fréquents, comme l'état physique des barrières, la saisie dans la boîte de réception, les journaux de contrôleur et la présence de véhicules, ne figurent pas dans la liste.

<Callout type="info" title="Il vous manque un événement ?">
Sous le champ **Événement** se trouve le lien **Il manque un événement ? Demandez-le**. Voir [Demander une étape ou un événement](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).
</Callout>

### Quelles données vous recevez [#welke-gegevens-krijg-je-mee]

La plupart des événements s'accompagnent d'un enregistrement, comme une occupation, une facture ou une tâche. Cet enregistrement, ainsi que ceux auxquels il renvoie, sont ensuite disponibles comme variables dans les étapes. Avec `occupation:ended`, vous pouvez par exemple utiliser :

- `{occupation.terrain.name}` pour le nom de l'emplacement
- `{occupation.customer.firstName}` pour le prénom du client
- `{occupation.reservation.displayId}` pour le numéro de la réservation. Toutes les occupations n'ont pas de réservation : dans ce cas, la valeur reste vide

Il y a aussi toujours `{triggeredBy.name}` et `{triggeredBy.id}` : le collègue qui a provoqué l'événement. Si l'événement a été provoqué par le système, par exemple par une synchronisation bancaire, ces champs sont vides.

Sous les paramètres du déclencheur se trouve **Données fournies par cet événement**. Vous y voyez précisément quelles variables vous pouvez utiliser. Pour un événement dont les données ne sont pas décrites, Tillor indique qu'il n'y a rien à choisir. Les variables que vous tapez vous-même fonctionnent alors toujours. Voir [Variables et modèles](/automatiseringen/variabelen).

## Une action de tâche est choisie [#er-wordt-een-taakactie-gekozen]

Certaines tâches ont des boutons de choix au lieu d'une case à cocher, par exemple issus de [Demander une décision](/automatiseringen/logica#vraag-om-een-beslissing). Un bouton peut être lié à une automatisation. Avec ce déclencheur, cette automatisation démarre dès que quelqu'un choisit ce bouton. Voir aussi [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen).

Lier un bouton à une automatisation ne se fait pas dans l'éditeur de flux. Si vous en avez besoin, demandez-le à votre administrateur Tillor ou au support.

Les étapes reçoivent les données de la tâche, par exemple `{task.name}` et `{task.id}`, ainsi que `{action.label}` (le nom du bouton choisi) et `{note}` (la note saisie par le collègue, si le bouton la demandait). Sous **Données fournies par cet événement**, vous voyez la liste complète.

## Facture échue [#factuur-is-vervallen]

Ce déclencheur démarre pour chaque facture qui :

- est comptabilisée (les brouillons et les factures annulées ne comptent pas)
- n'est pas une note de crédit
- a encore un montant ouvert
- a une date d'échéance antérieure à aujourd'hui

Pour chacune de ces factures, une exécution propre démarre. Les données de la facture et du client sont disponibles sous la forme `{invoice.…}`, par exemple `{invoice.displayId}`, `{invoice.amountOutstanding}` et `{invoice.customer.firstName}`.

Si vous désactivez **Exécuter une fois par enregistrement**, l'automatisation démarre au plus une fois par jour pour la même facture tant qu'elle est échue. Si vous le laissez activé, elle démarre exactement une fois pour chaque facture. C'est généralement ce que vous voulez pour un rappel.

Avec **À relancer**, vous choisissez depuis combien de temps la facture doit être ouverte, selon la même règle que dans la liste des factures. Activez **Ignorer les clients exclus des relances automatiques** pour ignorer les clients qui l'ont indiqué dans leurs paramètres de facturation. Une facture qui a elle-même été retirée des rappels automatiques ne lance pas non plus le flux.

## Webhook entrant [#inkomende-webhook]

Un webhook est un message qu'un autre système envoie à une adresse. Avec ce déclencheur, ce système lance l'automatisation, par exemple votre site web, un formulaire ou une plateforme de réservation. Chaque automatisation reçoit sa propre adresse secrète.

1. Choisissez **Webhook entrant** dans **Démarrer par**
2. Enregistrez l'automatisation. L'URL apparaît dans **Adresse**
3. Cliquez sur **Copier** et saisissez l'adresse dans l'autre système
4. Activez l'automatisation

L'autre système envoie un `POST` avec du JSON à cette adresse. Le contenu est ensuite disponible sous la forme `{body.…}`, par exemple `{body.email}` ou `{body.reservering.nummer}`, et les paramètres de l'URL sous la forme `{query.…}`. Avec **Uniquement si**, vous pouvez aussi filtrer sur ces champs.

Voici le reste du fonctionnement :

- L'adresse est le secret. Quiconque la connaît peut lancer l'automatisation. Ne la partagez donc qu'avec le système qui en a besoin
- Si l'adresse fuite, cliquez sur **Nouvelle adresse** et enregistrez. L'ancienne adresse ne fonctionne alors plus
- Une automatisation désactivée ou une mauvaise adresse renvoie une erreur `404`
- Le contenu ne doit pas dépasser 100 Ko
- Chaque appel lance une exécution par déclencheur webhook du flux. L'adresse appartient au premier déclencheur webhook. **Nouvelle adresse** sur ce déclencheur la remplace
- Aucun enregistrement n'y est lié, donc **Exécuter une fois par enregistrement** n'a aucun effet

### Ignorer les répétitions [#herhalingen-negeren]

Si l'autre système envoie parfois deux fois le même appel, **Ignorer les répétitions** évite que le flux démarre deux fois. Tillor mémorise une clé de l'appel. Si la même clé revient, rien ne démarre.

| Choix | Ce qu'est la clé |
|---|---|
| **Chaque appel lance le flux** | Il n'y a pas de clé. Par défaut |
| **Depuis un en-tête** | La valeur d'un en-tête que vous choisissez dans **Nom de l'en-tête**, par exemple `Idempotency-Key` |
| **Depuis le corps JSON** | La valeur d'un champ du JSON, que vous choisissez dans **Champ**, comme `id` ou `data.eventId` |
| **Le même corps JSON** | Tout le contenu. Un appel au contenu exactement identique compte comme une répétition |

Avec **Mémoriser la clé pendant**, vous choisissez combien de temps la clé reste valable, en heures, jours ou semaines. Passé ce délai, la même clé lance de nouveau le flux. Avec 0, la clé reste valable jusqu'à la suppression de l'automatisation. Un appel sans l'en-tête choisi ou sans le champ choisi est refusé.

## Une date est atteinte [#een-datum-is-bereikt]

Ce déclencheur démarre à la date d'un enregistrement. Avec **Date**, vous choisissez n'importe quel champ de date d'un enregistrement que Tillor envoie aussi avec les événements, écrit sous la forme enregistrement et champ. Quelques exemples :

| Date | Enregistrement |
|---|---|
| `reservation.checkIn` | La date d'arrivée d'une réservation |
| `reservation.checkOut` | La date de départ d'une réservation |
| `invoice.dueDate` | La date d'échéance d'une facture |
| `task.dueDate` | L'échéance d'une tâche |
| `occupation.paidUntil` | Jusqu'à quand une occupation est payée |
| `accessMethod.periodTo` | La fin de validité d'un code QR, d'une plaque d'immatriculation ou d'un autre moyen d'accès |
| `nfcTag.activatedUntil` | Jusqu'à quand un tag NFC est activé |
| `mandateAgreement.expiresAt` | Quand expire une demande de signature de mandat SEPA |
| `customer.birthday` | La date de naissance d'un client |
| `contact.birthday` | La date de naissance d'une personne de contact |

Par défaut, le déclencheur démarre une seule fois, à la date elle-même. Activez **Répéter chaque année** pour ne tenir compte que du jour et du mois : le flux démarre alors chaque année, comme à l'anniversaire avec `contact.birthday`. Un 29 février tombe le 28 février les autres années.

Vous pouvez aussi choisir des données enregistrées comme champs supplémentaires d'un enregistrement. `document.userMetadata.insuranceExpiryDate` est la date d'échéance d'un document, comme une preuve de paiement de l'assurance. Une telle date sans heure compte comme minuit (UTC, le temps universel). Avec **Uniquement si**, vous limitez alors le déclencheur à un type, par exemple `document.userMetadata.documentType` est `INSURANCE_PAYMENT_PROOF`, et aux documents actifs avec `document.status` est `ACTIVE`.

Avec **Durée** et **Avant ou après**, vous décalez le moment. *1 jour* et **Avant** avec `reservation.checkIn` lancent le flux un jour avant l'arrivée. Avec 0, il démarre à la date elle-même. Une date sans heure compte comme minuit.

Avec **Heure**, vous choisissez à quel moment de la journée le flux démarre. **L'heure de la date** utilise le moment indiqué dans le champ, comme l'heure d'arrivée d'une réservation. **Heure fixe de la journée** démarre le jour de la date à l'heure et à la minute que vous choisissez, dans le fuseau horaire de votre organisation. Ainsi, `contact.birthday` avec **Répéter chaque année** démarre chaque année à 09:00 le jour de l'anniversaire. **Durée** compte alors à partir de cette heure : *1 jour* et **Avant** démarrent la veille à 09:00, même si l'horloge change cette nuit-là.

Pour chaque enregistrement, une exécution propre démarre, avec les données de cet enregistrement comme variables, par exemple `{reservation.displayId}` et `{reservation.customer.firstName}`. Avec **Uniquement si**, vous le limitez, par exemple aux seules réservations au statut comptabilisé.

Voici le reste du fonctionnement :

- Par enregistrement et par moment, le flux démarre une seule fois. Si la date est reportée, par exemple parce qu'un client arrive plus tard, il démarre de nouveau au nouveau moment
- Si le moment était déjà passé quand vous avez enregistré ou activé l'automatisation, elle ne démarre plus pour celui-ci
- Tillor rattrape encore les moments manqués, par exemple pendant une maintenance, jusqu'à une heure plus tard

## Chaque jour à une heure [#elke-dag-op-een-uur]

Choisissez une heure (de 0 à 23) dans **Heure** et une minute de 0 à 59 dans **Minute**. L'heure est celle du fuseau horaire de votre organisation.

Les étapes reçoivent `{now}` : le moment où l'exécution a démarré.

## Selon une expression cron [#volgens-een-cron-expressie]

Choisissez un rythme, comme tous les jours, tous les lundis à 08:00, ou les lundis impairs (les 1er, 3e et 5e). Avec **Personnalisé**, vous réglez l'intervalle, les jours de la semaine et l'heure, à la minute près. Avec **Expression cron**, vous écrivez vous-même le planning.

Une expression cron est une notation courte pour une heure répétée. Elle comporte cinq parties séparées par une espace : **minute**, **heure**, **jour du mois**, **mois** et **jour de la semaine**.

| Expression | Signification |
|---|---|
| `0 8 * * 1` | Tous les lundis à 08:00 |
| `7 8 * * 1` | Tous les lundis à 08:07 |
| `30 7 * * 1-5` | Chaque jour ouvrable à 07:30 |
| `0 9 1 * *` | Le premier de chaque mois à 09:00 |
| `0 8 * * 1#1,1#3,1#5` | Chaque lundi impair (1er, 3e et 5e du mois) à 08:00 |
| `0 8 * * 1L` | Le dernier lundi du mois à 08:00 |
| `0 8 * * 1 W2:2026-10-05` | Toutes les deux semaines le lundi à 08:00, à partir de la semaine du 5 octobre 2026 |
| `*/15 * * * *` | Tous les quarts d'heure |
| `* * * * *` | Chaque minute |

Dans chaque partie, vous pouvez utiliser un nombre, une liste avec des virgules (`8,17`), une plage (`1-5`), un pas (`*/15`) ou une étoile (`*`, toutes les valeurs). Les jours de la semaine 0 et 7 sont tous deux le dimanche. `1#2` est le deuxième lundi, `1L` le dernier. Un sixième champ `W2:2026-10-05` répète toutes les deux semaines, comptées à partir de cette semaine. Les noms comme *MON* ou *JAN* ne fonctionnent pas. Si vous renseignez à la fois un jour du mois et un jour de la semaine, l'automatisation démarre sur l'un ou l'autre.

Si l'expression n'est pas valide, Tillor le signale sur le déclencheur. Les heures s'appliquent dans le fuseau horaire de votre organisation.

## À quelle heure démarre exactement un planning [#hoe-laat-start-een-schema-precies]

<Callout type="warn" title="Un planning démarre dans la minute où c'est son tour">
Tillor vérifie chaque minute quels plannings sont à l'ordre du jour. Une automatisation qui doit démarrer à 08:07 démarre dans cette minute. Cela vaut pour **Facture échue**, **Une date est atteinte**, **Chaque jour à une heure** et **Selon une expression cron**.
</Callout>

Par minute, un planning démarre au plus une fois. Une vérification qui ne s'exécute que la minute suivante ne rattrape pas la minute précédente.

Les événements démarrent immédiatement, sans ce délai.

## Uniquement si [#alleen-wanneer]

Avec **Uniquement si**, l'automatisation ne démarre que si les données correspondent. Vous démarrez ainsi, par exemple, uniquement pour les mobil-homes, ou uniquement pour les factures supérieures à un montant. Laissez vide pour démarrer à chaque événement de ce type.

1. Cliquez sur **Ajouter une condition**
2. Choisissez le champ avec le bouton **Variable** (ou tapez le chemin, par exemple `invoice.status`)
3. Choisissez comment comparer
4. Saisissez la valeur. Pour les champs à choix fixe, comme un statut, un type d'emplacement ou un collègue, vous choisissez dans une liste

Vous pouvez utiliser les comparaisons suivantes :

| Choix | Correspond quand |
|---|---|
| **est** | Le champ est égal à la valeur |
| **n'est pas** | Le champ n'est pas égal à la valeur |
| **contient** | La valeur apparaît quelque part dans le champ |
| **est supérieur à** | Le champ est supérieur à la valeur (pour les nombres et les dates) |
| **est inférieur à** | Le champ est inférieur à la valeur (pour les nombres et les dates) |
| **est l'un de** | Le champ est égal à l'une des valeurs choisies |
| **est vide** | Le champ est vide |
| **n'est pas vide** | Le champ n'est pas vide |

Les majuscules n'ont pas d'importance. Les nombres sont comparés comme des nombres, donc 10 est supérieur à 9.

Si vous avez plus d'une condition, vous choisissez comment elles fonctionnent ensemble : **Toutes doivent correspondre** ou **Au moins une doit correspondre**.

<Callout type="info">
Les événements arrêtés par le filtre ne lancent pas d'exécution et ne laissent donc aucune trace dans l'onglet **Exécutions**. Pour vérifier si votre filtre est correct, utilisez **Tester** : vous y voyez, pour chaque condition, si elle correspondait.
</Callout>

## Exécuter une fois par enregistrement [#eén-keer-per-record-uitvoeren]

Avec **Exécuter une fois par enregistrement**, l'automatisation démarre au plus une fois par facture, réservation ou autre enregistrement, quel que soit le nombre de fois que l'événement se produit pour lui.

C'est surtout utile pour les événements qui reviennent souvent, comme `invoice:updated` : une facture est modifiée des dizaines de fois, mais vous ne voulez envoyer qu'un seul rappel. Tillor retient, par enregistrement, que l'automatisation a déjà démarré. Cette mémoire disparaît si vous supprimez l'automatisation.

Cela ne fonctionne que pour les événements auxquels un enregistrement est lié, ainsi que pour **Facture échue** et **Une date est atteinte**. Avec **Une date est atteinte**, cela signifie : même si la date est reportée ensuite, le flux ne redémarre pas. Avec un planning comme **Chaque jour à une heure**, cela n'a aucun effet.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Chaque fois que le point de départ se produit et que le filtre correspond, une exécution démarre avec les données de ce moment comme variables.
- Un événement démarre immédiatement. Une date, une heure ou un planning démarre dans la minute où c'est son tour.
- Si le filtre ne correspond pas, rien ne démarre et il n'y a aucune trace dans l'onglet **Exécutions**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="L'automatisation ne démarre pas sur mon événement">
Vérifiez que l'automatisation est activée, que vous avez choisi le bon **Événement** et que le filtre de **Uniquement si** n'est pas trop strict. Testez avec les données d'un cas réel dans l'onglet **Exécution de test**. Plus d'informations dans [Questions fréquentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="Tillor affiche L'expression cron n'est pas valide">
Utilisez cinq champs séparés par une espace, comme `0 8 * * 1`. Les noms comme *MON* ne fonctionnent pas.
</Accordion>
<Accordion title="Un webhook entrant renvoie une erreur 404">
L'automatisation est désactivée ou l'adresse est incorrecte. Activez l'automatisation et copiez de nouveau l'adresse.
</Accordion>
<Accordion title="Mon filtre a disparu quand j'ai choisi un autre point de départ">
Avec un autre point de départ, les filtres de **Uniquement si** sont vidés, car ils avaient été écrits pour le point de départ précédent. Ajoutez-les de nouveau.
</Accordion>
<Accordion title="Le flux ne redémarre pas pour la même facture">
**Exécuter une fois par enregistrement** est activé. Il ne démarre alors qu'une fois au plus par facture, réservation ou autre enregistrement.
</Accordion>
</Accordions>

## Pour aller plus loin [#meer-lezen]

<Cards>
  <Card
    title="Conditions, aiguillages et délais"
    href="/automatiseringen/logica"
    description="Faire se diviser le flux et le faire attendre"
  />
  <Card
    title="Variables et modèles"
    href="/automatiseringen/variabelen"
    description="Utiliser les données de l'événement dans vos étapes"
  />
</Cards>


# Variables et modèles (/fr-FR/automatiseringen/variabelen)

Avec les variables, vous créez des textes qui changent selon le cas. Vous écrivez une variable entre accolades et Tillor insère la vraie valeur dès que l'automatisation s'exécute.

Un exemple de titre de tâche :

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

Si l'occupation se termine à l'emplacement 12, la tâche s'appelle *Controleer 12*.

## Insérer une variable [#een-variabele-invoegen]

Au-dessus de chaque champ de texte où les variables fonctionnent se trouve le bouton **Variable**. Cliquez dessus et vous voyez une liste de toutes les données disponibles, regroupées par enregistrement. Tapez pour chercher (**Rechercher des variables**) et cliquez sur une ligne. Tillor place la variable à l'endroit de votre curseur.

<DocScreenshot src="/screenshots/automatiseringen/variables-picker.png" alt="Bouton Variable au-dessus du champ Titre avec la liste des variables disponibles ouverte" />

Vous pouvez aussi simplement taper une variable vous-même. Sous le champ, une zone grise montre à quoi ressemble le texte avec des données d'exemple, pour que vous voyiez tout de suite si c'est correct.

Les variables fonctionnent dans les champs de texte comme les titres, les descriptions, les sous-tâches, les messages, l'identifiant d'un client, d'une facture ou d'un autre enregistrement, le chemin ou l'URL d'une requête API, le corps, la charge utile d'un webhook, le nom de l'événement du webhook et les valeurs des en-têtes. Pour les deux derniers, le bouton **Variable** est absent, mais une variable que vous tapez vous-même est bien remplie. Tillor ne contrôle pas ces deux champs à la recherche d'erreurs et n'y affiche pas d'exemple.

Dans les champs où vous choisissez une donnée à comparer, vous écrivez la variable sans accolades. Cela vaut pour **Uniquement si**, **Si / sinon** et **Jusqu'à** dans **Attendre jusqu'à** (par exemple `invoice.status`), pour le **Champ** d'un **Aiguillage** et pour la **Date** d'un **Délai**.

## Quelles variables existent [#welke-variabelen-zijn-er]

| Variable | Disponible | Contenu |
|---|---|---|
| `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` et autres | Après un événement | Les champs de l'enregistrement concerné par l'événement. Le nom de l'enregistrement est aussi le début de la variable |
| `{occupation.terrain.name}` | Après un événement | Les champs des enregistrements auxquels l'enregistrement renvoie, comme le client ou l'emplacement. Cela fonctionne sur un niveau de profondeur |
| `{triggeredBy.name}`, `{triggeredBy.id}` | Toujours | Le collègue qui a provoqué l'événement. Vide si c'est le système |
| `{invoice.…}` | Avec **Facture échue** | Les champs de la facture échue et du client |
| `{reservation.…}`, `{task.…}` et autres | Avec **Une date est atteinte** | Les champs de l'enregistrement dont la date est atteinte, ainsi que les enregistrements auxquels il renvoie |
| `{now}`, `{today}` | Toujours | Le moment où l'étape s'exécute, et minuit de ce jour dans le fuseau horaire de l'organisation. Avec un décalage (ci-dessous), `{today + 1 day}` donne demain |
| `{threadId}`, `{messageId}` | Pour les événements sur les messages de la boîte de réception, comme `inbox:message-created` | L'identifiant de la conversation et du message |
| Les champs de l'événement | Après **Attendre un événement**, via **Reçu** | Les données de l'événement attendu. Elles remplacent les données des mêmes enregistrements du début du flux |
| `{createdTask.id}`, `{createdTask.name}` | Après **Créer une tâche** | La tâche qui vient d'être créée |
| `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | Après **Rechercher une tâche**, via **Trouvée** | La tâche trouvée par l'étape |
| `{updatedTask.id}`, `{updatedTask.status}` | Après **Définir le statut** | La tâche dont le statut a été modifié |
| `{updatedTask.id}`, `{updatedTask.priority}` | Après **Définir la priorité de la tâche** | La tâche dont la priorité a été modifiée |
| `{updatedTask.id}` | Après **Modifier la tâche** | La tâche qui a été modifiée |
| `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | Après **Rechercher un document**, via **Trouvée** | Le document trouvé par l'étape |
| `{updatedDocument.id}` | Après **Mettre à jour un document** | Le document qui a été modifié |
| `{response.status}`, `{response.body}`, `{response.data.…}` | Après **Requête API** | La réponse de la requête |
| `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` et autres | Après **Rechercher un enregistrement**, via **Trouvée** | Les champs de l'enregistrement trouvé par l'étape, ainsi que les enregistrements auxquels il renvoie. Le nom est `found` plus le type d'enregistrement : `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` ou `foundInboxMessage` |
| `{body.…}`, `{query.…}`, `{receivedAt}` | Après **Webhook entrant** | Le corps JSON, les paramètres de requête et l'heure de réception de l'appel du webhook |
| Chaque nom de cible de **Mapper des variables** | Après **Mapper des variables** | Ce que vous saisissez comme cible dans cette étape, par exemple `{invoice.displayId}` après `invoice` ← `{foundInvoice}` |
| `{item.…}` | Dans les étapes après **Pour chaque** | Les champs de l'élément pour lequel l'étape s'exécute, comme `{item.id}` |
| `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | Après **Demander une décision**, via une option | La tâche, l'option choisie, le nom de cette option, la note et le collègue qui a choisi |
| `{task.…}`, `{action.label}`, `{note}` | Avec **Une action de tâche est choisie** | La tâche, le bouton choisi et la note saisie |
| `{createdComment.id}` | Après **Ajouter un commentaire** | Le commentaire qui vient d'être publié |
| `{bookedInvoice.displayId}` | Après **Comptabiliser la facture**, via **Terminé** | Le numéro de la facture comptabilisée |
| `{paymentLink.url}` | Après **Créer un lien de paiement**, via **Terminé** | Le lien avec lequel le client peut payer en ligne |
| `{consumptionInvoice.id}` | Après **Facturer la consommation**, via **Terminé** | La facture de la consommation du compteur |
| `{extendInvoice.id}` | Après **Facture brouillon de prolongation** | La facture brouillon qui prolonge l'occupation |
| `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | Après **Créer un moyen d'accès** | Le nouveau moyen d'accès et sa valeur, comme le code d'un code QR ou d'un code PIN |
| `{error.message}`, `{error.step}` | Après une action avec **Continuer si cette étape échoue**, via **Erreur** | Le message d'erreur et le nom de l'étape qui a échoué |

Les champs exacts d'un enregistrement apparaissent dans la liste derrière le bouton **Variable**. Sur le déclencheur se trouve aussi l'aperçu **Données fournies par cet événement**.

### Seulement ce qui vient plus tôt dans le flux [#alleen-wat-eerder-in-de-flow-komt]

Une étape ne peut utiliser que les variables du déclencheur qui l'atteint et des étapes situées plus tôt sur le même chemin. Si plusieurs déclencheurs atteignent la même étape, seules sont disponibles les variables que chacun de ces déclencheurs fournit. Un champ d'une étape précédente compte si chacun de ces déclencheurs passe aussi par cette étape. Si vous utilisez une variable qui n'existe pas à ce stade, Tillor affiche **[Champ] : [variable] n'est pas disponible à cette étape.** Un flux avec un tel message ne peut pas être activé.

Certains enregistrements conservent des données supplémentaires dans un seul champ, comme les données du document dans `userMetadata`. Chaque clé en dessous est une variable : `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` ou une autre clé. Les clés connues, comme le type et la date d'échéance d'un document, figurent aussi dans la liste et peuvent être comparées comme date. Une date sans heure, comme `2026-10-07`, apparaît dans un message sous la forme `07-10-2026`.

Les variables de **Pour chaque** (`{item.…}`) n'existent que dans les étapes après la sortie **Pour chaque**, pas après **Terminé**. Les variables d'une sortie que vous n'avez pas empruntée n'existent pas non plus : `{paymentLink.url}` n'existe que si l'étape est passée par **Terminé**, et `{foundTask.id}` seulement après **Trouvée**.

Pour les événements dont les données ne sont pas décrites, Tillor ne peut pas vérifier quelles variables existent. Vous ne recevez alors pas ce message. Contrôlez donc ces flux avec un soin particulier à l'aide d'une exécution de test.

### Une nouvelle valeur remplace l'ancienne [#een-nieuwe-waarde-vervangt-de-oude]

Une deuxième **Requête API** dans le même flux remplace la `response` de la première. Il en va de même pour `createdTask` après une deuxième **Créer une tâche**, pour `foundTask` après une deuxième **Rechercher une tâche** ou **Rechercher un enregistrement** sur **Tâche**, et pour `error` après une deuxième étape échouée. Utilisez donc les données d'une réponse dans l'étape qui la suit directement.

## Comment les valeurs sont insérées [#hoe-waarden-worden-ingevuld]

Tillor adapte la notation au type de champ.

**Dans un texte ordinaire** (titres, descriptions, sous-tâches) :

- Les dates sont dans le fuseau horaire de votre organisation, par exemple `05-10-2026`. Si l'heure n'est pas exactement minuit, une heure est ajoutée, comme `05-10-2026 14:30`
- Un champ vide donne un texte vide
- Une variable que Tillor ne connaît pas reste telle que vous l'avez écrite, par exemple `{occupation.terain.name}`. Une faute de frappe se remarque ainsi tout de suite dans la tâche ou le message
- Si un enregistrement lié n'existe pas, la variable reste vide. Une occupation sans réservation ne donne donc rien pour `{occupation.reservation.displayId}`, et un événement provoqué par le système ne donne rien pour `{triggeredBy.name}`. Si vous voulez un autre texte dans ce cas, placez avant un **Si / sinon** avec **est vide**

**Dans du JSON** (la **Charge utile** d'un webhook et le **Corps** d'une requête API) :

- Le texte est inséré de façon sûre. Les guillemets, les retours à la ligne et autres caractères spéciaux de la valeur ne peuvent pas casser le JSON
- Les nombres et les valeurs oui/non sont insérés sans guillemets, donc n'en mettez pas autour. Le texte, lui, se met entre guillemets
- Les dates sont transmises sous forme de date et heure internationales, comme `2026-10-05T08:00:00.000Z`, pour que le système destinataire les comprenne bien

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

Si le JSON n'est pas valide après l'insertion, par exemple parce qu'un nombre est vide, l'exécution s'arrête avec un message d'erreur.

**Dans un chemin ou une URL** (pour une requête API) :

- Les valeurs sont converties pour tenir dans une adresse. Un nom avec une espace ne donne donc pas une adresse cassée
- Ici aussi, les dates sont transmises sous forme de date et heure internationales
- Ce que vous tapez vous-même reste tel que vous le tapez. Si vous voulez une espace dans un terme de recherche, tapez vous-même `%20`

## Décaler une date [#een-datum-verschuiven]

Après une variable de date, un décalage peut figurer : `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. Les unités sont `minutes`, `hours`, `days`, `weeks` et `months` (le singulier est aussi accepté). Les jours et les semaines ont une longueur fixe, de sorte qu'une validité garde la même durée malgré l'heure d'été et l'heure d'hiver ; les mois suivent le calendrier, donc le 31 janvier plus un mois donne le 28 ou le 29 février. Sur une valeur qui n'est pas une date, le décalage ne fait rien, et une unité qui n'existe pas est une erreur de l'étape. Les champs de date comme **Valable jusqu'au** acceptent la même notation.

## Mettre une valeur en forme [#een-waarde-opmaken]

Ajoutez après la variable un `|` et un format, par exemple `{invoice.amountOutstanding|currency}`. Sans format, un montant apparaît brut, comme `1295.3`. Avec `|currency`, cela devient `€ 1.295,30`.

| Format | Exemple | Résultat |
|--------|-----------|-----------|
| `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` (nombre fixe de décimales) |
| `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` |

- Les nombres et les montants sont toujours en notation belge : un point pour les milliers et une virgule pour les décimales
- Les dates et les heures sont dans le fuseau horaire de votre organisation
- Si le format ne peut pas lire la valeur, par exemple `|currency` sur du texte, la valeur apparaît simplement sans mise en forme
- Un format que Tillor ne connaît pas reste tel que vous l'avez écrit, et l'éditeur affiche un message à ce sujet
- Dans du JSON et dans une URL, la valeur mise en forme est insérée comme texte. En JSON, mettez donc des guillemets autour

## Utiliser une réponse d'API [#een-api-antwoord-gebruiken]

Après une [Requête API](/automatiseringen/acties/integraties#api-verzoek), vous pouvez utiliser des champs de la réponse avec `{response.data.…}`. La réponse d'une recherche de tâches ressemble par exemple à ceci :

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

Alors `{response.data.items.0.id}` donne l'identifiant de la première tâche (la première d'une liste porte le numéro 0) et `{response.data.items.0.priority}` sa priorité.

Tillor ne peut proposer les champs d'une réponse comme variables que s'il sait à quoi ressemble la réponse. Il y a deux façons :

- Laissez l'automatisation s'exécuter une fois pour de bon. Tillor utilise alors la réponse de la dernière exécution
- Collez un exemple dans l'onglet **Exécution de test**, dans le champ **Exemple de réponse API**. Ce champ apparaît dès que le flux contient une **Requête API**. En dessous se trouvent les **Champs de cette réponse**. Cliquez sur un champ pour le copier, accolades comprises

Ensuite, les champs figurent dans la liste derrière le bouton **Variable** et dans la liste de **Champ** d'un **Aiguillage**.

Si vous tapez vous-même un chemin sous `response.data`, il est toujours accepté, même sans exemple. Par ailleurs :

- `{response.body}` contient les 4000 premiers caractères de la réponse. Si la réponse est plus longue, le reste est tronqué
- `{response.data}` est vide si la réponse n'est pas du JSON, ou si la réponse est très volumineuse (plus de 100 000 caractères)
- Pour une recherche sans résultat, `{response.data.items.0.id}` n'existe pas. Un **Aiguillage** sur un tel champ passe alors par **Par défaut**

<Callout type="info" title="Un exemple dans le test">
Dans l'onglet **Exécution de test**, vous saisissez aussi les données d'exemple de l'événement. Vous voyez ainsi dans l'exécution de test quelles valeurs Tillor insérerait. Voir [Tests et exécutions](/automatiseringen/testen-en-uitvoeringen).
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Dès que l'automatisation s'exécute, Tillor remplace chaque variable par la vraie valeur. Une variable que Tillor ne connaît pas reste telle que vous l'avez écrite.
- Si une donnée est vide, l'emplacement reste vide. Si vous voulez alors un autre texte, placez avant un **Si / sinon** avec **est vide**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je vois {occupation.terain.name} dans ma tâche">
Une variable que Tillor ne connaît pas reste affichée telle quelle. Il s'agit généralement d'une faute de frappe. Choisissez la variable avec le bouton **Variable**.
</Accordion>
<Accordion title="Tillor indique qu'une variable n'est pas disponible à cette étape">
Vous utilisez une donnée qui n'existe pas encore à ce point du flux, par exemple d'une étape qui vient plus tard ou d'une sortie que vous n'avez pas empruntée. Placez plus tôt dans le flux l'étape qui fournit la donnée. Tant que le message est là, vous ne pouvez pas activer l'automatisation.
</Accordion>
<Accordion title="Le JSON est incorrect après l'insertion">
Un nombre vide rend le JSON invalide. Le texte se met entre guillemets, les nombres non. Contrôlez les champs avec une exécution de test.
</Accordion>
<Accordion title="Je ne vois pas les champs d'une réponse d'API dans la liste">
Tillor ne connaît pas encore la forme de la réponse. Laissez l'automatisation s'exécuter une fois pour de bon, ou collez un exemple dans **Exemple de réponse API** sur l'onglet **Exécution de test**.
</Accordion>
</Accordions>


# Questions fréquentes (/fr-FR/automatiseringen/veelgestelde-vragen)

## Qui peut utiliser les automatisations ? [#wie-kan-automatiseringen-gebruiken]

Qui a **Voir les automatisations** voit les automatisations et leurs exécutions. Qui a **Gérer les automatisations** peut aussi les créer, les modifier, les activer et les supprimer. Les administrateurs avec **Toutes les autorisations** peuvent tout faire. Vous donnez ces autorisations aux membres de votre organisation.

Soyez prudent avec **Gérer les automatisations** : une automatisation travaille avec toutes les autorisations de votre organisation. Qui peut construire des flux peut donc tout faire par un flux. Ne l'accordez qu'aux personnes en qui vous avez confiance pour cela. Qui n'a aucune des deux autorisations ne voit pas l'élément de menu **Administrateur > Automatisations**.

## Pourquoi mon automatisation ne démarre-t-elle pas ? [#waarom-start-mijn-automatisering-niet]

Passez en revue ces points.

1. **Est-elle activée ?** Une automatisation dont l'interrupteur est désactivé (filtre **En pause**) ne démarre pas. S'il y a des problèmes, vous n'avez pas pu l'activer. Voir [Problèmes et activation](/automatiseringen/problemen)
2. **Est-ce le bon événement ?** Une nouvelle réservation est `reservation:created`, une modification `reservation:updated`. Vérifiez aussi que l'événement se produit réellement avec l'action que vous effectuez
3. **Le filtre l'arrête-t-il ?** Les événements qui ne passent pas le filtre de **Uniquement si** ne laissent aucune exécution. Utilisez l'onglet **Exécution de test** avec les données d'un cas réel pour voir quelle condition ne correspond pas. Faites attention aux valeurs des champs à choix : un statut de facture est par exemple `BOOKED`
4. **Exécuter une fois par enregistrement est-il activé ?** Dans ce cas, l'automatisation ne redémarre pas pour une facture ou une réservation pour laquelle elle s'est déjà exécutée. Voir [Exécuter une fois par enregistrement](/automatiseringen/triggers#eén-keer-per-record-uitvoeren)
5. **Est-ce un planning ?** Alors il démarre dans la minute où c'est son tour. Une heure fixe et un planning utilisent le fuseau horaire de votre organisation
6. **Venez-vous de l'activer ou de la modifier ?** Il peut falloir une demi-minute avant que tout le système le remarque
7. **Y a-t-il beaucoup d'événements en même temps ?** Dans ce cas, les exécutions sont traitées une par une et il peut falloir un moment avant que ce soit le tour de la vôtre

Si l'automatisation démarre mais que quelque chose se passe mal ensuite, regardez dans l'onglet **Exécutions** ce qui s'est passé et où l'exécution s'est bloquée.

## Pourquoi mon planning démarre-t-il en retard ? [#waarom-start-mijn-schema-te-laat]

Les plannings sont vérifiés chaque minute. Une automatisation qui démarre à une date, à une heure ou selon un planning commence dans cette minute. Un événement démarre immédiatement.

## Une automatisation peut-elle se relancer elle-même ? [#kan-een-automatisering-zichzelf-blijven-starten]

Pas au sein d'un même flux. Si vous reliez une sortie de façon à ce que le flux revienne à une étape précédente, Tillor refuse cette ligne. Vous ne pouvez pas activer un flux avec une telle boucle. Si une exécution arrive malgré tout à une étape qu'elle a déjà faite, elle s'arrête au lieu de refaire cette étape.

Pas non plus via des événements. Ce qu'une étape fait est fait par l'utilisateur **Flux de travail**, et les événements provoqués par **Flux de travail** ne lancent pas d'automatisations. Une automatisation qui démarre sur `task:created` et fait une **Créer une tâche** ne redémarre donc pas sur la tâche qu'elle a elle-même créée. Cela vaut aussi entre automatisations : l'une ne peut pas en lancer une autre.

Si beaucoup d'événements arrivent en peu de temps, par exemple à cause d'un grand envoi, chaque événement lance une exécution. Tillor les traite quelques-unes à la fois. Rien ne se perd, mais cela peut prendre un moment.

## Quelles limites s'appliquent ? [#welke-grenzen-gelden-er]

| Quoi | Limite |
|---|---|
| Étapes dans une automatisation | 100 |
| Branches dans un **Aiguillage** | 8, en plus de **Par défaut** |
| Connexions depuis une sortie | 1 étape. Si vous reconnectez, la nouvelle ligne remplace l'ancienne |
| Longueur du nom | 120 caractères |
| Longueur de la description | 500 caractères |
| Commentaires et cadres sur le canevas | 50 au total |
| Options dans **Demander une décision** | 8 |
| Délai d'attente d'une requête API | 15 secondes |
| La réponse dans `{response.body}` | Les 4000 premiers caractères |
| La réponse dans `{response.data}` | Jusqu'à 100 000 caractères, au-delà c'est vide |
| Délai en secondes | Pas exact, peut avoir quelques secondes de retard |
| Plannings | Vérification chaque minute |
| Éléments dans un **Pour chaque** | 100 à la fois |
| Vérification dans **Attendre jusqu'à** | Au plus toutes les 5 minutes |
| Contenu d'un webhook entrant | 100 Ko |
| Exécutions dans l'onglet **Exécutions** | Les 20 dernières |

## Plusieurs automatisations peuvent-elles démarrer sur le même événement ? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten]

Oui. Chaque automatisation activée dont le déclencheur et le filtre correspondent lance sa propre exécution. Ne comptez pas sur un ordre fixe.

## Puis-je faire faire deux choses en même temps après une sortie ? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen]

Non, une sortie mène à une seule étape. Placez les actions l'une après l'autre, ou créez une deuxième automatisation avec le même déclencheur.

## Que se passe-t-il avec les exécutions en cours si je change quelque chose ? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander]

| Ce que vous faites | Ce qui arrive aux exécutions |
|---|---|
| Modifier le flux et l'enregistrer | Les nouvelles exécutions utilisent le nouveau flux. Les exécutions déjà en cours ou en attente se terminent avec le flux tel qu'il était |
| Mettre l'automatisation en pause | Les exécutions qui attendent dans un délai s'arrêtent dès que le temps d'attente est écoulé et reçoivent le statut **Annulée**. Ce qui est déjà en cours à ce moment se termine. Si vous la réactivez avant la fin du temps d'attente, l'exécution continue normalement |
| Supprimer l'automatisation | Les exécutions et l'historique sont supprimés. Les exécutions en attente s'arrêtent |

## Que se passe-t-il si une étape échoue ? [#wat-gebeurt-er-als-een-stap-mislukt]

L'exécution s'arrête avec le statut **Échouée** et les étapes suivantes ne sont pas exécutées. La personne qui a créé l'automatisation reçoit un e-mail à propos de l'exécution échouée, au plus un par heure et par automatisation. Tillor ne réessaie pas l'étape. Avec **Envoyer un webhook** et **Requête API**, vous pouvez rattraper un échec avec la sortie **Échoué**. Pour les autres actions, activez **Continuer si cette étape échoue** : l'étape reçoit alors une sortie **Erreur** et le flux continue à partir de là. Voir [Quand une étape échoue](/automatiseringen/acties#als-een-stap-mislukt).

## Envoie-t-on vraiment quelque chose pendant un test ? [#wordt-er-echt-iets-verstuurd-tijdens-een-test]

Non. Une exécution de test n'envoie rien, ne crée rien et ne modifie rien. Voir [Tests et exécutions](/automatiseringen/testen-en-uitvoeringen).

## Mes données sont-elles stockées en sécurité ? [#zijn-mijn-gegevens-veilig-opgeslagen]

Vos flux et l'historique des exécutions, y compris les en-têtes contenant des clés ou des jetons, sont stockés chiffrés. Pour les adresses sur internet, seul `https` est autorisé et les adresses internes sont refusées.

## Il me manque un événement, une condition ou une action [#ik-mis-een-gebeurtenis-voorwaarde-of-actie]

Utilisez **Demander une étape** dans l'éditeur. Voir [Demander une étape ou un événement](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).

## Puis-je aussi gérer les automatisations depuis mon propre système ? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren]

Oui, si votre intégration dispose de toutes les autorisations. Voir [Pour les développeurs](/ontwikkelaars/automatiseringen).

<Callout type="idea" title="Commencez petit">
Commencez avec un seul déclencheur et une seule action, laissez-les tourner quelques jours et vérifiez les exécutions. Ensuite seulement, développez avec des conditions et des délais.
</Callout>


# Exemple : contrôle d'une caravane de location (/fr-FR/automatiseringen/voorbeeld-nalopen)

Cet exemple construit un flux avec un filtre, **Rechercher une tâche**, **Définir la priorité de la tâche**, un **Si / sinon** et une tâche avec des sous-tâches. Vous n'avez pas besoin d'une requête API pour cela.

Dans les environnements de démonstration de Tillor, ce flux est déjà disponible, en pause, sous le nom **Nalopen huurcaravan**. Vous pouvez le consulter là pendant que vous construisez le vôtre.

## Ce que fait le flux [#wat-de-flow-doet]

Un client quitte un mobil-home. La caravane doit être contrôlée avant le client suivant.

- S'il n'y a pas encore de tâche de contrôle ouverte pour cet emplacement, le flux en crée une, avec cinq sous-tâches et une échéance à 7 jours. La tâche est aussi assignée au collègue qui a arrêté l'occupation
- S'il y a déjà une tâche de contrôle ouverte, par exemple parce que la caravane s'est libérée deux fois à peu d'intervalle, le flux ne crée pas de deuxième tâche. À la place, la priorité de la tâche existante monte d'un niveau

```mermaid
flowchart TD
  A["Occupation arrêtée<br/>uniquement mobil-homes"] --> F{"Tâche de contrôle ouverte ?"}
  F -- Trouvée --> P["Priorité d'un niveau plus haut<br/>jusqu'à Élevé"]
  F -- Introuvable --> B{"Arrêtée par un collègue ?"}
  B -- Oui --> C["Créer la tâche de contrôle<br/>avec le nom du collègue"]
  B -- Non --> D["Créer la tâche de contrôle"]
```

Les deux étapes de tâche en bas sont presque identiques. Seule la description diffère : si c'est le système qui a terminé l'occupation, il n'y a pas de collègue à mentionner.

## Ce dont vous avez besoin [#wat-je-nodig-hebt]

- Vous avez l'autorisation **Gérer les automatisations**, ou **Toutes les autorisations**
- Dans votre organisation, il existe un type d'emplacement pour les mobil-homes, dans cet exemple **Stacaravan**
- Facultatif : un tableau et une colonne pour les tâches de contrôle

## Construire le flux [#de-flow-bouwen]

### 1. Créer un flux vide [#1-een-lege-flow-maken]

1. Allez dans **Administrateur > Automatisations** et cliquez sur **Nouvelle automatisation**
2. Choisissez **Partir de zéro**
3. Dans le fil d'Ariane en haut, saisissez le nom **Nalopen huurcaravan**
4. Cliquez sur le canevas, à côté des étapes, et indiquez dans le panneau, sous **Description**, à quoi sert le flux

### 2. Régler le déclencheur [#2-de-trigger-instellen]

1. Cliquez sur le déclencheur. Laissez **Démarrer par** sur **Quand quelque chose se passe**
2. Choisissez `occupation:ended` dans **Événement**. Tapez *occupation* pour chercher
3. Donnez à l'étape, dans **Nom de l'étape**, le nom *Occupation arrêtée*

Le flux démarre maintenant pour chaque occupation qui se termine. Vous le voulez uniquement pour les mobil-homes :

1. Dans **Uniquement si**, cliquez sur **Ajouter une condition**
2. Cliquez sur **Variable** et choisissez `occupation.terrain.terrainTypeId`
3. Laissez la comparaison sur **est**
4. Dans la valeur, choisissez le type d'emplacement **Stacaravan**

<DocScreenshot src="/screenshots/automatiseringen/trigger-filter.png" alt="Déclencheur avec la condition type d'emplacement est Stacaravan" />

### 3. Chercher une tâche de contrôle ouverte [#3-een-open-nalooptaak-zoeken]

1. Ajoutez une étape **Rechercher une tâche**, reliez-y le déclencheur et nommez-la *Tâche de contrôle ouverte ?*
2. Dans **Titre**, saisissez `Contrôle {occupation.terrain.name}`
3. Laissez activés **Liée aux enregistrements de l'événement**, **Uniquement les tâches non terminées** et **Ignorer les sous-tâches**

L'étape cherche maintenant une tâche principale qui n'est pas encore terminée, qui s'appelle exactement *Contrôle* suivi du nom de l'emplacement et qui est liée au même emplacement, au même client ou à la même réservation. Ensuite, le flux continue via **Trouvée** ou **Introuvable**.

### 4. Augmenter la priorité [#4-de-prioriteit-verhogen]

1. Ajoutez une étape **Définir la priorité de la tâche**, nommez-la *Augmenter la priorité* et reliez-y la sortie **Trouvée**
2. Laissez **Tâche** sur `{foundTask.id}`
3. Laissez **Modification** sur **Un niveau plus haut** et **Augmenter jusqu'à** sur **Élevé**

### 5. Vérifier qui a arrêté l'occupation [#5-nagaan-wie-de-bezetting-stopzette]

1. Ajoutez une étape **Si / sinon**, reliez-y la sortie **Introuvable** de *Tâche de contrôle ouverte ?* et nommez-la *Arrêtée par un collègue ?*
2. Cliquez sur **Ajouter une condition** et choisissez `triggeredBy.id` dans **Variable**
3. Choisissez la comparaison **n'est pas vide**

`{triggeredBy.id}` est vide si c'est le système qui a terminé l'occupation, par exemple une tâche planifiée. Le flux passe alors par **Non**.

### 6. Créer la tâche [#6-de-taak-aanmaken]

Ajoutez une étape **Créer une tâche**, nommez-la *Créer la tâche de contrôle* et reliez-y la sortie **Oui**. Remplissez les champs ainsi :

| Champ | Valeur |
|---|---|
| **Titre** | `Contrôle {occupation.terrain.name}` |
| **Description** | `Généré automatiquement.`, une ligne vide, et `Occupation arrêtée par @{triggeredBy.name}({triggeredBy.id})` |
| **Priorité** | **Faible** |
| **Échéance après** | 7 jours |
| **Assigner aussi la personne à l'origine de l'événement** | Activé |
| **Lier aux enregistrements** | Activé |
| **Sous-tâches** | Cinq lignes : *Nettoyer*, *Inventaire*, *Internet + TV*, *Cadre code QR*, *Vérifier les petits travaux* |

Avec `@{triggeredBy.name}({triggeredBy.id})`, le collègue est mentionné dans la description. Si vous voulez que la tâche arrive sur un tableau, choisissez un tableau dans **Ajouter au tableau** et une colonne dans **Colonne**. Pour la personne qui doit toujours recevoir la tâche, choisissez-la dans **Assigner à**.

Gardez le titre identique à celui de *Tâche de contrôle ouverte ?*. Sinon, l'étape de recherche ne retrouvera pas la tâche la fois suivante.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Étape Créer la tâche de contrôle avec les paramètres dans le panneau" />

### 7. La tâche pour le système [#7-de-taak-voor-het-systeem]

1. Cliquez sur l'étape *Créer la tâche de contrôle* puis sur **Dupliquer l'étape**
2. Donnez à la copie le nom *Créer la tâche de contrôle (système)* et reliez-y la sortie **Non**
3. Réglez la **Description** sur `Généré automatiquement.` seulement

### 8. Tester et activer [#8-testen-en-inschakelen]

1. Vérifiez qu'il n'y a pas de bouton de problèmes (comme **1 problème**) en haut du panneau
2. Ouvrez l'onglet **Exécution de test** et cliquez sur **Lancer le test**. Vous voyez quel chemin le flux emprunte et quels titre et description la tâche recevrait. Rien n'est créé
3. Activez l'interrupteur **Actif**

## Pourquoi deux étapes plutôt qu'une [#waarom-twee-stappen-in-plaats-van-één]

Vous pouvez aussi utiliser séparément les étapes **Rechercher une tâche** et **Définir la priorité de la tâche**. Si vous ne voulez par exemple rien faire quand la tâche existe déjà, ne reliez simplement rien à **Trouvée**. Si vous voulez donner un commentaire ou un autre statut à la tâche existante, placez une autre étape après **Trouvée**, comme **Définir le statut** avec `{foundTask.id}`.

## Ce qui se passe en pratique [#wat-er-in-de-praktijk-gebeurt]

| Situation | Ce que fait le flux |
|---|---|
| Pas de tâche de contrôle ouverte pour cet emplacement | Crée une nouvelle tâche avec cinq sous-tâches |
| Tâche ouverte avec la priorité **Faible** | La passe à **Moyen** |
| Tâche ouverte avec la priorité **Moyen** | La passe à **Élevé** |
| Tâche ouverte avec la priorité **Élevé** ou **Urgent** | Laisse la priorité telle quelle |
| Occupation sur un autre type d'emplacement | Ne démarre pas |

<Callout type="info" title="À quoi ressemble la tâche dans Tillor">
La tâche est au nom de [**Flux de travail**](/automatiseringen/workflow-gebruiker) et est liée à l'emplacement et au client de l'occupation, et à la réservation s'il y en a une. Toutes les occupations n'ont pas de réservation. Le collègue qui a arrêté l'occupation figure comme personne assignée sur la tâche.
</Callout>


# Qui exécute une automatisation ? (/fr-FR/automatiseringen/workflow-gebruiker)

Une automatisation ne travaille pas sous votre nom. Toutes les étapes sont exécutées par un utilisateur fixe de votre organisation, nommé **Flux de travail**.

## Ce que vous en remarquez [#wat-je-ervan-merkt]

- Une tâche créée par une automatisation est enregistrée au nom de **Flux de travail**
- Un commentaire ajouté par une automatisation via une [requête API](/automatiseringen/acties/integraties#api-verzoek) est lui aussi enregistré au nom de **Flux de travail**
- Dans l'éditeur, tant qu'aucune étape n'est sélectionnée, le panneau de droite rappelle que les étapes sont exécutées par l'utilisateur **Flux de travail** de votre organisation, jamais par vous

Ainsi, on voit toujours clairement ce qu'un collègue a fait et ce qu'une automatisation a fait. Votre nom n'apparaît jamais sur quelque chose que vous n'avez pas fait vous-même.

## Ce qu'est **Flux de travail** [#wat-workflow-is]

- Un utilisateur système, pas un collègue. Vous ne pouvez pas vous connecter avec lui et il n'a pas de boîte e-mail
- Il y en a un par organisation. Il n'existe que dans votre organisation et ne peut rien faire ailleurs
- Il dispose de tous les droits dans votre organisation, comme un administrateur. C'est aussi la raison pour laquelle seuls les administrateurs peuvent créer et modifier des automatisations
- Il n'est pas membre de l'organisation, contrairement à un collègue

<Callout type="warn" title="Une automatisation peut beaucoup">
Comme **Flux de travail** a tous les droits, une automatisation peut faire tout ce que l'API Tillor autorise. Une **Requête API** peut donc, par exemple, modifier ou supprimer des données. Gardez donc vos flux petits et testez-les bien.
</Callout>

## Ce que **Flux de travail** ne peut pas faire [#wat-workflow-niet-mag]

Une automatisation ne peut ni créer, ni modifier, ni activer, ni supprimer d'automatisations, et elle ne peut pas consulter leurs exécutions. Une requête API pour cela est refusée. Ainsi, un flux ne peut pas se modifier lui-même ni modifier un autre flux.

## Événement provoqué par **Flux de travail** [#gebeurtenis-veroorzaakt-door-workflow]

Ce que fait **Flux de travail** provoque des événements ordinaires, par exemple une nouvelle tâche. Dans la chronologie et dans les webhooks, **Flux de travail** figure alors comme auteur. De tels événements ne démarrent aucune automatisation : un flux ne peut donc pas se démarrer lui-même ni démarrer un autre flux. Une exécution qui attend avec **Attendre un événement** reprend bien sa course : cela ne peut pas démarrer de nouveau flux, donc pas de boucle non plus. Vous en saurez plus dans la [foire aux questions](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten).

## Qui assigner [#wie-wijs-je-toe]

**Flux de travail** n'est jamais assigné lui-même à une tâche et ne reçoit jamais de notification de **Prévenir des collègues**. Si vous voulez qu'un collègue prenne la tâche en charge, choisissez un collègue dans **Assigner à**, ou cochez **Assigner aussi la personne à l'origine de l'événement**.


# Enregistrer un paiement (/fr-FR/betalingsverwerking/betaling-registreren)

Vous enregistrez un paiement sur une facture comptabilisée avec un solde impayé. L'écran de paiement est le même pour toutes les méthodes. Seuls les champs sous **Méthode de paiement** diffèrent.

<Steps>
<Step>
### Ouvrez la facture [#open-de-factuur]
Allez dans <UIPath>Administration > Factures</UIPath> ou ouvrez la facture depuis <UIPath>Clients > client > Facturation</UIPath>. La facture doit être comptabilisée et avoir un solde impayé.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Facture comptabilisée - Effectuer un paiement" />
</Step>
<Step>
### Cliquez sur Effectuer un paiement [#klik-op-maak-betaling]
L'écran **Nouveau paiement pour** la facture s'ouvre. En haut figurent le total de la facture et le montant impayé.
</Step>
<Step>
### Choisissez la méthode de paiement [#kies-de-betaalmethode]
Choisissez dans **Méthode de paiement** la façon dont le paiement arrive. Les choix affichés dépendent de la facture et de ce que votre organisation a configuré.

- **Terminal** envoie la demande à un terminal de paiement. Voir [Terminal](/betalingsverwerking/terminal).
- **Espèces**, **Virement** et éventuellement **Autres** enregistrent de l'argent reçu en dehors de Tillor. Voir [Espèces et virement](/betalingsverwerking/contant).
- **Virement interne** déplace un solde vers une autre facture du même client. Voir [Virement interne](/betalingsverwerking/interne-overboeking).
- **Mandat SEPA** prélève le montant avec un mandat actif du client. Voir [Encaisser une facture](/betalingsverwerking/incasso).
</Step>
<Step>
### Saisissez le montant [#vul-het-bedrag-in]
**Montant** est par défaut le montant impayé. Avec les boutons 25 %, 50 %, 75 % et 100 %, vous saisissez rapidement une partie, ou vous tapez vous-même un montant. Le montant ne peut pas dépasser le montant impayé.
</Step>
<Step>
### Exécutez le paiement [#voer-de-betaling-uit]
Cliquez sur **Effectuer le paiement**.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Le montant impayé et le statut de paiement de la facture sont mis à jour. Le paiement figure sur la facture sous **Paiements** et dans <UIPath>Administration > Paiements</UIPath>. Pour savoir comment les retrouver, voir [Retrouver des paiements](/betalingsverwerking/betalingen-bekijken).

Le client préfère payer lui-même ? Envoyez alors la facture avec **Envoyer la notification**. Voir [Payer en ligne](/betalingsverwerking/online).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas le bouton Effectuer un paiement">
Le bouton n'apparaît que sur une facture comptabilisée avec un solde impayé. Une facture brouillon, vous la comptabilisez d'abord. Une facture entièrement payée n'a plus de bouton.
</Accordion>
<Accordion title="Mandat SEPA est grisé">
Le client n'a pas de mandat actif dont le montant maximal est assez élevé pour ce montant. Pour une note de crédit, la méthode ne figure pas dans la liste. Voir [Encaisser une facture](/betalingsverwerking/incasso).
</Accordion>
<Accordion title="La méthode Terminal est absente">
Terminal ne figure dans la liste que si Mollie est connecté et que votre organisation peut recevoir des paiements par carte. Voir [Terminal](/betalingsverwerking/terminal).
</Accordion>
</Accordions>


# Retrouver des paiements (/fr-FR/betalingsverwerking/betalingen-bekijken)

Vous voyez les paiements à trois endroits : sur la facture elle-même, dans l'aperçu de tous les paiements et dans l'écran de détail d'un paiement.

## Consulter les paiements d'une facture [#betalingen-van-een-factuur-bekijken]

Ouvrez la facture et faites défiler jusqu'à **Paiements**. Vous ne voyez que les paiements liés à cette facture.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Paiements sur la facture" />

## Parcourir tous les paiements [#alle-betalingen-doorzoeken]

Allez dans <UIPath>Administration > Paiements</UIPath>. Filtrez par date, méthode de paiement, statut ou client, ou recherchez par nom de client ou numéro de facture.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Aperçu des paiements - Tous les paiements" />

Via le menu d'actions (trois points) d'un paiement, vous pouvez, selon le paiement :

| Action | Ce qu'elle fait |
|---|---|
| **Détails** | Ouvre l'écran de détail |
| **PDF de paiement** | Crée un justificatif de paiement |
| **Synchroniser** | Récupère le statut actuel chez Mollie. Uniquement pour les paiements Mollie qui existent déjà chez Mollie |
| **Ignorer le délai** | Envoie dès maintenant à la banque un prélèvement planifié. Voir [Encaisser une facture](/betalingsverwerking/incasso) |
| **Dissocier de la facture** | Retire le paiement de la facture |
| **Annuler** | Annule un paiement qui n'est pas encore terminé |
| **Supprimer** | Supprime le paiement |

## Lire les détails d'un paiement [#de-details-van-een-betaling-lezen]

Cliquez sur **Détails** pour ouvrir l'écran **Détails du paiement**. Vous y voyez le montant, le statut, la méthode, la facture et une chronologie.

- **Date d'échéance** figure pour un prélèvement SEPA en cours. Le statut affiche alors <Status tone="warning">Attendu</Status> avec cette date.
- **Envoyer après** figure pour un prélèvement que Tillor n'a pas encore envoyé à la banque.
- **Rapport de paiement** affiche le rapport dans lequel le paiement arrive. Tant que le paiement ne figure pas encore dans un rapport, le numéro du rapport est suivi de **(prévu)**. Pour un paiement Mollie, on voit **Avec le prochain versement Mollie**, car le rapport n'est connu qu'au moment du versement.

Vous en saurez plus sur les rapports dans [Rapports de paiement](/boekhouden/betalingsrapporten).

## Libellés de statut [#statuslabels]

| Statut | Signification |
|---|---|
| <Status tone="warning">En attente</Status> | Le paiement est encore en cours |
| <Status tone="info">Autorisé</Status> | Approuvé, pas encore terminé |
| <Status tone="success">Payé</Status> | Terminé |
| <Status tone="error">Échoué</Status> | N'a pas abouti |
| <Status>Annulé</Status> | Interrompu avant d'être terminé |
| <Status>Expiré</Status> | La session de paiement a expiré |
| <Status>Remboursé</Status> et <Status>Partiellement remboursé</Status> | Le montant a été rendu en totalité ou en partie |
| <Status tone="error">Remboursé par opposition</Status> | La banque ou l'émetteur de la carte a récupéré le montant |

## Suivre les montants impayés [#openstaande-bedragen-opvolgen]

Allez dans <UIPath>Administration > Factures</UIPath>. La carte **Factures avec solde impayé** affiche les factures comptabilisées qui ne sont pas encore entièrement payées. Dans les tableaux, filtrez sur le statut de paiement **Impayé** et triez par date d'échéance.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Factures avec solde impayé" />

### Envoyer une relance [#een-aanmaning-versturen]

Une relance s'envoie par facture, pas en masse.

<Steps>
<Step>
### Ouvrez la facture [#open-de-factuur]
Choisissez une facture encore impayée.
</Step>
<Step>
### Envoyez la relance [#verstuur-de-aanmaning]
Cliquez sur **Envoyer la notification** et choisissez **Envoyer un rappel**. Confirmez l'envoi.
</Step>
</Steps>

Le client reçoit un rappel avec un lien pour payer en ligne. Voir [Payer en ligne](/betalingsverwerking/online).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le statut ne correspond pas à celui de Mollie">
Utilisez **Synchroniser** dans le menu d'actions du paiement. Tillor récupère alors les données actuelles. Cela aide surtout si une notification de Mollie a été manquée.
</Accordion>
<Accordion title="Je ne vois pas Synchroniser">
L'action n'apparaît que pour les paiements Mollie qui ont déjà une transaction chez Mollie. Pour un prélèvement que Tillor n'a pas encore envoyé, il n'y a rien à récupérer.
</Accordion>
</Accordions>


# Enregistrer un paiement en espèces ou par virement (/fr-FR/betalingsverwerking/contant)

Avec **Espèces**, **Virement** et éventuellement **Autres**, vous notez qu'un client a payé en dehors de Tillor. Tillor n'envoie alors rien. Il met à jour le solde impayé de la facture.

- **Espèces** : le client paie en liquide à l'accueil.
- **Virement** : vous avez reçu un virement bancaire qui n'a pas été lié automatiquement à la facture.
- **Autres** : pour d'autres paiements avec une description propre, comme un chèque ou un échange. La méthode n'apparaît que si votre organisation l'a activée.

## Enregistrer un paiement [#een-betaling-registreren]

<Steps>
<Step>
### Ouvrez l'écran de paiement [#open-het-betaalscherm]
Ouvrez une facture comptabilisée avec un solde impayé et cliquez sur **Effectuer un paiement**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Boîte de dialogue de paiement - Espèces" />
</Step>
<Step>
### Choisissez la méthode [#kies-de-methode]
Dans **Méthode de paiement**, choisissez **Espèces** ou **Virement**.
</Step>
<Step>
### Saisissez le montant [#vul-het-bedrag-in]
Tapez un montant ou utilisez les boutons 25 %, 50 %, 75 % et 100 %.
</Step>
<Step>
### Vérifiez la date de réception [#controleer-de-datum-van-ontvangst]
**Date de réception** est par défaut aujourd'hui. Modifiez-la si l'argent est arrivé un autre jour.
</Step>
<Step>
### Ajoutez éventuellement une remarque [#voeg-eventueel-een-opmerking-toe]
Dans **Remarque**, vous pouvez indiquer un numéro de référence ou une note. Pour **Autres**, une description est obligatoire.
</Step>
<Step>
### Exécutez le paiement [#voer-de-betaling-uit]
Cliquez sur **Effectuer le paiement**.
</Step>
</Steps>

<Callout type="idea" title="Date de réception">
La date détermine dans quel rapport de paiement le paiement arrive. Si vous enregistrez aujourd'hui un paiement d'hier, mettez la date d'hier afin que le bon rapport soit complété.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Le paiement figure immédiatement sur la facture et dans <UIPath>Administration > Paiements</UIPath>. Voir [Retrouver des paiements](/betalingsverwerking/betalingen-bekijken).

Pour **Virement**, vous pouvez aussi faire envoyer au client un e-mail lui conseillant d'utiliser la communication structurée lors des prochains virements. La case **Envoyer un rappel pour la communication structurée** se trouve dans l'écran de paiement. Elle est grisée si le client n'a pas d'adresse e-mail.

## Paramètres pour les paiements manuels [#instellingen-voor-handmatige-betalingen]

Sous <UIPath>Support > Paramètres > Paiements</UIPath>, vous trouvez ces paramètres :

| Paramètre | Ce qu'il fait |
|---|---|
| **Afficher le mode de paiement "Autres"** | Ajoute la méthode **Autres** dans l'écran de paiement |
| **Montant maximal en espèces** | Le montant en espèces le plus élevé par paiement, 2999 euros par défaut |
| **Par défaut : rappel pour virement manuel** | Coche par défaut la case du rappel |
| **Montant maximal en espèces** | Montant le plus élevé que vous pouvez enregistrer comme paiement en espèces, en euros entiers (2999 par défaut) |

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor refuse mon montant en espèces">
Un paiement en espèces ne peut pas dépasser le **Montant maximal en espèces** sous <UIPath>Support > Paramètres > Paiements</UIPath> (2999 euros par défaut). Enregistrez le montant en plusieurs parties, ou choisissez une autre méthode.
</Accordion>
<Accordion title="Je ne vois pas la méthode Autres">
La méthode est désactivée. Activez **Afficher le mode de paiement "Autres"** sous <UIPath>Support > Paramètres > Paiements</UIPath>.
</Accordion>
<Accordion title="Je ne vois aucune méthode manuelle">
Les paiements manuels ne sont pas disponibles pour chaque facture. L'écran l'indique alors.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Enregistrer un paiement" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" />
</Cards>


# Groupes de paiements (/fr-FR/betalingsverwerking/groepen)

Un groupe de paiements regroupe plusieurs paiements entrants sous un nom, afin que vous puissiez les lier en une fois à une facture comptabilisée. Pratique si vous ne voulez pointer qu'à la fin de la journée ou d'une activité.

Exemples :

- **Clôturer un service de caisse** : tous les paiements par carte de la journée sont dans un groupe. Vous les liez à la facture du chiffre d'affaires journalier.
- **Facturer une activité** : les participants paient à l'avance en ligne. Lors de la comptabilisation, vous liez tout le groupe à la facture.
- **Une réservation avec acompte et solde** : l'acompte et le paiement final sont dans un même groupe et sont assignés en une fois.

## Les règles [#de-regels]

- Un groupe a le statut <Status tone="info">Ouvert</Status> (pas encore lié) ou <Status tone="success">Affecté</Status> (déjà lié à une facture).
- Un groupe n'a pas de client propre. Le client découle de la facture à laquelle vous liez le groupe.
- Les paiements d'un groupe ne se déplacent qu'ensemble. Vous ne pouvez pas rattacher un paiement isolé d'un groupe à une autre facture.
- Vous ne pouvez lier un groupe qu'à une facture comptabilisée. Les factures brouillon peuvent encore changer ou disparaître.

## Lier un groupe à une facture [#een-groep-aan-een-factuur-koppelen]

<Steps>
<Step>
### Ouvrez les groupes de paiements [#open-de-betalingsgroepen]
Allez dans <UIPath>Administration > Paiements</UIPath> et regardez sous **Groupes de paiements**. La liste n'affiche par défaut que les groupes ouverts. Modifiez le filtre **Statut** pour voir aussi les groupes affectés.

<DocScreenshot src="/screenshots/betalingen/payment-groups.png" alt="Aperçu des paiements - Groupes de paiements" />
</Step>
<Step>
### Choisissez Assigner [#kies-koppelen]
Ouvrez le menu d'actions (trois points) d'un groupe ouvert et choisissez **Assigner**.
</Step>
<Step>
### Choisissez la facture [#kies-de-factuur]
Sélectionnez la facture comptabilisée à laquelle tout le groupe doit être lié.
</Step>
<Step>
### Confirmez [#bevestig]
Cliquez sur **Assigner** dans la fenêtre. Tous les paiements du groupe vont en une fois vers cette facture, et le groupe obtient le statut <Status tone="success">Affecté</Status>.
</Step>
</Steps>

Vous pouvez aussi le faire depuis la facture. Choisissez-y **Assigner un paiement** dans le menu d'actions, allez dans l'onglet **Groupes de paiements** et cliquez sur **Assigner le groupe**.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Un groupe affecté figure sur le PDF de la facture sous la forme d'une ligne avec le total du groupe. Vous dépliez les paiements individuels dans l'aperçu des paiements de la facture. Le groupe lui-même apparaît dans les détails de chaque paiement qu'il contient.

Si le groupe contient un paiement Mollie qui existe déjà chez Mollie, **Synchroniser** apparaît à côté de **Assigner**. Cette action récupère en même temps les données actuelles de tous les paiements concernés du groupe. Cela aide si vous doutez du statut ou si une notification a été manquée. Un groupe vide peut être supprimé avec **Supprimer**.

## Comment les paiements arrivent-ils dans un groupe ? [#hoe-komen-betalingen-in-een-groep]

Votre système de caisse ou d'activités peut transmettre un nom de groupe lors de la création d'un paiement Mollie. Tillor crée alors lui-même un groupe, ou utilise un groupe ouvert existant, et y place le paiement. Les champs correspondants se trouvent dans [Métadonnées Mollie](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas lier le groupe à ma facture">
La facture est encore un brouillon. Comptabilisez-la d'abord, car seules les factures comptabilisées peuvent recevoir un groupe.
</Accordion>
<Accordion title="Je veux mettre un paiement du groupe sur une autre facture">
C'est impossible pour un paiement qui se trouve encore dans un groupe. Travaillez au niveau du groupe.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Retrouver des paiements" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Métadonnées Mollie" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Encaisser une facture avec un mandat (/fr-FR/betalingsverwerking/incasso)

Si un client a un mandat actif, Tillor peut prélever une facture sur son compte bancaire. Vous choisissez comment : vous liez le mandat à la facture pour que le prélèvement démarre tout seul après la comptabilisation, ou vous lancez le prélèvement manuellement avec **Effectuer un paiement**.

Vous demandez un mandat via [Faire signer un mandat SEPA](/betalingsverwerking/mandaat). Une note de crédit ne peut pas être encaissée.

## Faire encaisser une facture automatiquement [#een-factuur-automatisch-laten-innen]

<Steps>
<Step>
### Ouvrez la facture [#open-de-factuur]
Allez dans <UIPath>Administration > Factures</UIPath> et ouvrez une facture brouillon ou comptabilisée du client.
</Step>
<Step>
### Choisissez le mandat [#kies-het-mandaat]
Choisissez dans **Mandat de prélèvement** le mandat du client. Seuls les mandats actifs figurent dans la liste. Choisissez **Aucun mandat** pour retirer à nouveau la liaison.

Le champ indique ce qui se passe : Tillor crée immédiatement un paiement impayé, et la banque est sollicitée deux jours après la comptabilisation. D'ici là, vous pouvez annuler le paiement.
</Step>
<Step>
### Comptabilisez la facture [#boek-de-factuur]
Après la comptabilisation, la facture affiche **Le prélèvement est prévu le** avec la date. Ce jour-là, Tillor envoie le prélèvement à la banque.
</Step>
</Steps>

Si la facture était déjà comptabilisée quand vous avez lié le mandat, le même délai de deux jours s'applique à partir de ce moment. Si Tillor a déjà envoyé le prélèvement à la banque, vous ne pouvez plus modifier le mandat sur la facture.

### Le montant maximal d'un mandat [#het-maximumbedrag-van-een-mandaat]

Chaque mandat a un montant maximal. Vous le voyez dans la liste des mandats sous la forme **max.** suivi d'un montant. Si une facture est plus élevée :

- le mandat est grisé dans la liste, avec l'indication que le maximum est inférieur au montant de la facture ;
- la facture affiche l'avertissement que son montant dépasse le maximum du mandat ;
- Tillor ne peut pas comptabiliser une facture à laquelle un tel mandat est lié.

Choisissez alors un mandat avec un maximum plus élevé, ou faites payer le client autrement.

## Lancer un prélèvement manuellement [#een-incasso-handmatig-starten]

<Steps>
<Step>
### Ouvrez l'écran de paiement [#open-het-betaalscherm]
Ouvrez la facture comptabilisée et cliquez sur **Effectuer un paiement**.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Facture comptabilisée - Effectuer un paiement" />
</Step>
<Step>
### Choisissez Mandat SEPA [#kies-sepa-mandaat]
Choisissez dans **Méthode de paiement** l'option **Mandat SEPA**. Si elle est grisée, le client n'a pas de mandat actif capable de couvrir le montant.
</Step>
<Step>
### Choisissez le mandat et le délai [#kies-het-mandaat-en-de-vertraging]
Sélectionnez le **Mandat**. Tillor choisit lui-même le premier mandat actif capable de couvrir le montant. Dans **Délai (jours)**, saisissez de 0 à 7 jours. Avec 0, le prélèvement part immédiatement à la banque ; avec un nombre plus élevé, Tillor attend autant de jours.
</Step>
<Step>
### Exécutez le paiement [#voer-de-betaling-uit]
Cliquez sur **Effectuer le paiement**.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Le paiement figure sur la facture et dans <UIPath>Administration > Paiements</UIPath>.

- Tant que le prélèvement attend, les détails affichent **Envoyer après** avec la date. Choisissez **Ignorer le délai** dans le menu d'actions pour l'envoyer maintenant à la banque, ou **Annuler** pour l'arrêter.
- Après l'envoi, le paiement a le statut <Status tone="warning">En attente</Status> avec la **Date d'échéance**. Un prélèvement SEPA prend quelques jours. Ensuite il passe à <Status tone="success">Payé</Status>, ou à <Status tone="error">Échoué</Status> si la banque refuse le prélèvement.
- Un prélèvement en cours compte déjà dans la comptabilité comme paiement en attente. Si vous le faites échouer ou l'annulez, il disparaît à nouveau du brouillon. Voir [Rapports de paiement](/boekhouden/betalingsrapporten).
- Sur la page de paiement, le client voit **Payé par domiciliation** avec le montant et la date, et aucun bouton de paiement. Ainsi, personne ne paie en double. Le PDF de la facture et l'e-mail de facture mentionnent le montant et la date du prélèvement.

Le petit premier paiement par lequel un client a confirmé son mandat est déduit par Tillor de la facture suivante.

## Faire encaisser automatiquement les factures d'énergie et d'eau [#nutsfacturen-automatisch-innen]

Vous pouvez faire encaisser automatiquement les factures de consommation d'eau, d'électricité et de gaz avec le mandat du client.

- Si, lors de la signature, le client coche **Utiliser aussi ce mandat pour payer automatiquement mes factures d'énergie et d'eau**, Tillor définit ce mandat dès qu'il est actif. La case est cochée par défaut.
- Vous pouvez aussi choisir le mandat vous-même sous <UIPath>Clients > client > Facturation</UIPath>, dans la carte **Paramètres de facturation**, dans **Mandat**.
- Dans la liste des mandats, le mandat pour les services publics est indiqué par **Énergie et eau**.

Une nouvelle facture de consommation reçoit alors automatiquement ce mandat comme **Mandat de prélèvement**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Mandat SEPA est grisé dans Effectuer un paiement">
Le client n'a pas de mandat au statut <Status tone="success">Actif</Status> dont le maximum est assez élevé. Vérifiez la carte **Mandats** sous <UIPath>Clients > client > Facturation</UIPath>.
</Accordion>
<Accordion title="Je ne peux pas comptabiliser la facture">
Le mandat lié a un maximum inférieur au montant de la facture. Choisissez un autre mandat ou retirez le mandat de la facture.
</Accordion>
<Accordion title="Je ne peux plus modifier le mandat sur la facture">
Tillor a déjà envoyé le prélèvement à la banque. Suivez le paiement dans <UIPath>Administration > Paiements</UIPath>.
</Accordion>
<Accordion title="Le prélèvement a échoué">
Ouvrez le paiement pour connaître la raison. La facture est à nouveau ouverte. Choisissez **Effectuer un paiement** pour un nouveau prélèvement ou une autre méthode, ou envoyez au client un lien de paiement avec **Envoyer la notification**.
</Accordion>
<Accordion title="Je veux encore arrêter le prélèvement">
Tant que le paiement dans <UIPath>Administration > Paiements</UIPath> affiche encore **Envoyer après**, vous pouvez l'annuler. S'il est déjà envoyé, ce n'est plus possible. Vous pouvez en revanche révoquer le mandat pour les factures suivantes, voir [Révoquer un mandat](/betalingsverwerking/mandaat-beheren).
</Accordion>
</Accordions>

Les automatisations peuvent aussi encaisser : l'étape [Innen via domiciliëring](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Faire signer un mandat SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Révoquer ou renvoyer un mandat" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Retrouver des paiements" href="/betalingsverwerking/betalingen-bekijken" />
</Cards>


# Aperçu (/fr-FR/betalingsverwerking)

Un paiement dans Tillor est généralement lié à une facture comptabilisée. Le client peut payer lui-même en ligne, vous pouvez enregistrer un paiement à l'accueil, ou Tillor prélève automatiquement le montant via un mandat SEPA. Cette page montre à quoi sert chaque méthode.

<Callout type="info" title="Bon à savoir">
- Un paiement est lié à une facture comptabilisée. Sur un brouillon, vous ne pouvez pas payer.
- Un paiement en espèces est limité par défaut à 2999 euros. Vous l'ajustez avec **Montant maximal en espèces** sous <UIPath>Support > Paramètres > Paiements</UIPath>.
- Au-dessus de 2500 euros, la page de paiement avertit le client que la banque ou la carte peut refuser le paiement en ligne. Le client reçoit alors l'IBAN et la communication structurée pour virer le montant.
- Un prélèvement avec un mandat part à la banque deux jours après la comptabilisation. Avec **Effectuer un paiement**, vous choisissez vous-même un délai de 0 à 7 jours. Tant que le prélèvement n'est pas parti, vous pouvez l'annuler.
- Si une facture dépasse le maximum du mandat, vous ne pouvez pas encaisser. Si ce mandat est sur la facture, vous ne pouvez pas non plus comptabiliser la facture.
- Le lien de signature d'un mandat est valable 14 jours. Tillor rappelle le client après 7 jours, 2 jours avant l'expiration et le dernier jour.
- Un virement interne n'est possible qu'entre deux factures comptabilisées du même client.
- Tillor ne peut pas rembourser d'argent à un client. Un remboursement se fait en dehors de Tillor, par exemple par virement bancaire.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Chaque méthode aboutit au même endroit : un paiement sur la facture. Ensuite, il passe au rapport de paiement et à votre comptabilité.

```mermaid
flowchart LR
  F[Facture comptabilisée] --> M{Méthode de paiement}
  M -- En ligne --> P[Paiement]
  M -- Terminal --> P
  M -- Espèces ou virement --> P
  M -- Prélèvement SEPA --> P
  M -- Virement interne --> P
  P -- Statut et solde --> F
  P -- Par jour --> R[Rapport de paiement]
  R --> B[Comptabilité]
```

Un prélèvement reste d'abord <Status tone="warning">En attente</Status>. La facture figure alors déjà comme payée (en attente). Si l'encaissement échoue, la facture est à nouveau ouverte. Les rapports de paiement et la liaison avec le logiciel de comptabilité se trouvent dans [Comptabilité](/boekhouden).

## Quelle méthode choisir ? [#welke-methode-kies-je]

| Méthode | Quand | Comment le client paie | Ce que Tillor comptabilise |
|---|---|---|---|
| [Payer en ligne](/betalingsverwerking/online) | Le client paie lui-même, chez lui ou en déplacement | Via le lien dans l'e-mail ou le SMS de facture, avec iDEAL, Bancontact, carte de crédit ou une autre méthode | Le paiement dès que le partenaire de paiement le confirme, même si le client ne fait plus rien |
| [Terminal](/betalingsverwerking/terminal) | Le client est à l'accueil | Avec une carte ou un téléphone sur un terminal de paiement Mollie | Le paiement dès que le terminal le termine |
| [Espèces et virement](/betalingsverwerking/contant) | Argent reçu en dehors de Tillor | Liquide à l'accueil ou virement bancaire | Le paiement que vous enregistrez, avec la date de réception |
| [Mandat SEPA](/betalingsverwerking/incasso) | Factures récurrentes ou élevées, consommation | Il ne paie pas. Tillor prélève le montant sur le compte bancaire | Un paiement en attente jusqu'à ce que la banque confirme l'encaissement |
| [Virement interne](/betalingsverwerking/interne-overboeking) | Déplacer un solde entre deux factures du même client | Il ne paie pas. Aucun argent n'arrive | Deux paiements liés, un positif et un négatif |

Les paiements en ligne, par terminal et les prélèvements passent par Mollie. Les paiements en espèces et les virements, vous les enregistrez vous-même.

<Cards>
  <Card title="Enregistrer un paiement" href="/betalingsverwerking/betaling-registreren" icon={<ReceiptTextIcon />} description="L'écran de paiement sur une facture comptabilisée" />
  <Card title="Retrouver des paiements" href="/betalingsverwerking/betalingen-bekijken" icon={<SearchIcon />} description="Par facture, dans l'aperçu et dans les détails" />
  <Card title="Payer en ligne" href="/betalingsverwerking/online" icon={<GlobeIcon />} description="La page de paiement que voit le client" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" icon={<MonitorSmartphoneIcon />} description="Paiements par carte à l'accueil" />
  <Card title="Espèces et virement" href="/betalingsverwerking/contant" icon={<BanknoteIcon />} description="Enregistrer des paiements en dehors de Tillor" />
  <Card title="Virement interne" href="/betalingsverwerking/interne-overboeking" icon={<ArrowLeftRightIcon />} description="Déplacer un solde entre des factures" />
  <Card title="Faire signer un mandat SEPA" href="/betalingsverwerking/mandaat" icon={<FileSignatureIcon />} description="À distance ou à la réception" />
  <Card title="Encaisser une facture" href="/betalingsverwerking/incasso" icon={<LandmarkIcon />} description="Encaisser automatiquement avec un mandat" />
  <Card title="Groupes de paiements" href="/betalingsverwerking/groepen" icon={<LayersIcon />} description="Regrouper des paiements et les lier en une fois" />
  <Card title="Exemples pratiques" href="/praktijk" icon={<ReceiptTextIcon />} description="Exemples détaillés issus de la pratique" />
</Cards>

## Notions [#begrippen]

- **Paiement** : un montant reçu ou en cours, avec une méthode, un statut et généralement une facture.
- **Mandat** : l'autorisation d'un client de prélever des factures sur son compte bancaire. Voir [Mandat SEPA](/betalingsverwerking/mandaat).
- **Groupe de paiements** : un ensemble de paiements que vous liez plus tard en une fois à une facture. Voir [Groupes de paiements](/betalingsverwerking/groepen).
- **Rapport de paiement** : l'aperçu journalier des paiements reçus pour la comptabilité. Voir [Rapports de paiement](/boekhouden/betalingsrapporten).
- **Virement interne** : déplacer un solde entre deux factures du même client, sans qu'aucun argent n'arrive.
- **Prélèvement** : Tillor prélève le montant sur le compte bancaire du client, avec son mandat.
- **Client** : le client à qui appartient la facture. Voir [Client](/begrippen#klant).


# Effectuer un virement interne (/fr-FR/betalingsverwerking/interne-overboeking)

Avec **Virement interne**, vous déplacez un montant d'une facture comptabilisée vers une autre facture comptabilisée du même client. Aucun argent n'arrive. Tillor crée un paiement positif sur la facture que vous soldez et un paiement négatif lié sur la facture cible.

Ce n'est ni un paiement en espèces, ni par carte, ni un virement. Ces méthodes sont séparées dans l'écran de paiement.

## Enregistrer un virement interne [#een-interne-overboeking-registreren]

<Steps>
<Step>
### Ouvrez l'écran de paiement [#open-het-betaalscherm]
Ouvrez la facture comptabilisée avec un solde impayé et cliquez sur **Effectuer un paiement**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-internal-transfer.png" alt="Boîte de dialogue de paiement - Virement interne avec la liste Facture cible ouverte" />
</Step>
<Step>
### Choisissez Virement interne [#kies-interne-overboeking]
Dans **Méthode de paiement**, choisissez **Virement interne**.
</Step>
<Step>
### Choisissez la facture cible [#kies-de-doelfactuur]
Sélectionnez dans **Facture cible** la facture comptabilisée vers laquelle va le montant. La liste n'affiche que les factures comptabilisées du même client.
</Step>
<Step>
### Saisissez le montant [#vul-het-bedrag-in]
Tapez un montant ou utilisez les boutons 25 %, 50 %, 75 % et 100 %.
</Step>
<Step>
### Exécutez le paiement [#voer-de-betaling-uit]
Renseignez éventuellement **Date de réception** et cliquez sur **Effectuer le paiement**.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Tillor crée deux paiements liés, **Virement interne de** et **Virement interne vers**, chacun avec le numéro de facture de l'autre facture.
- Le solde impayé des deux factures est mis à jour.
- Si vous supprimez l'un des deux paiements, Tillor supprime aussi l'autre.

## Virement interne et comptabilité [#interne-overboeking-en-boekhouding]

- Un virement interne figure sur le rapport de paiement du jour où vous l'enregistrez. Si vous l'enregistrez aujourd'hui, il figure immédiatement sur le [rapport provisoire](/boekhouden/betalingsrapporten#concept-en-definitief) d'aujourd'hui.
- Il part dans l'export comptable, avec les paiements Mollie.
- Les paiements en espèces, les virements et les comptes bancaires ne partent pas dans l'export comptable.

## Après l'inversion d'une facture avec Prolonger l'occupation [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen]

Avec **Inverser la facture**, vous transformez une facture en note de crédit. Un virement interne entre ces deux factures n'est qu'une compensation comptable. Il ne prolonge ni ne raccourcit l'occupation une nouvelle fois.

Ce que cela signifie pour **Payé jusqu'au** :

- Sur la facture d'origine, **Payé jusqu'au** ne change pas.
- Sur la note de crédit, **Payé jusqu'au** ne recule que si la facture d'origine avait déjà été payée par un vrai paiement, comme des espèces, un virement ou Mollie. Si elle n'avait été compensée que par un virement interne, **Payé jusqu'au** reste identique.
- **Facturé jusqu'au** a déjà été ajusté lors de la comptabilisation.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="La facture cible ne figure pas dans la liste">
Seules les factures comptabilisées du même client apparaissent. Comptabilisez d'abord une facture brouillon, et ne choisissez pas la même facture que celle sur laquelle vous faites le paiement.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Enregistrer un paiement" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Comptes bancaires" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Révoquer ou renvoyer un mandat (/fr-FR/betalingsverwerking/mandaat-beheren)

Toutes les actions d'un mandat se trouvent dans le menu (trois points) en bout de ligne sur la carte **Mandats**. Vous trouvez cette carte sous <UIPath>Clients > client > Facturation</UIPath>. Les actions affichées dépendent du statut.

| Statut | Actions dans le menu |
|---|---|
| <Status tone="info">En attente de signature</Status> | **Afficher sur l'iPad**, **Envoyer un rappel**, **Renvoyer le lien de signature**, **Annuler la demande** |
| <Status>Lien expiré</Status> | **Renvoyer le lien de signature**, **Annuler la demande** |
| <Status tone="error">Échec de l'activation</Status> | **Annuler la demande** |
| <Status tone="success">Actif</Status> | **Ouvrir le mandat signé**, **Révoquer le mandat** |
| <Status>Révoqué</Status> | **Ouvrir le mandat signé** |

**Afficher sur l'iPad** n'apparaît que si l'application Tillor est en ligne sur un appareil de votre organisation.

## Renvoyer une demande en attente [#een-openstaande-aanvraag-opnieuw-versturen]

<Steps>
<Step>
### Ouvrez le menu de la demande [#open-het-menu-bij-de-aanvraag]
Cherchez la demande au statut <Status tone="info">En attente de signature</Status> ou <Status>Lien expiré</Status>.
</Step>
<Step>
### Choisissez l'action [#kies-de-actie]
- **Envoyer un rappel** envoie de nouveau un e-mail au client, avec un nouveau lien. La date de fin ne change pas.
- **Renvoyer le lien de signature** envoie un nouveau lien, de nouveau valable 14 jours.

Un lien envoyé précédemment ne fonctionne plus après ces deux actions.
</Step>
</Steps>

Tillor affiche **Rappel envoyé** ou **Lien de signature renvoyé**. Le client reçoit un e-mail. Le fonctionnement des rappels automatiques se trouve dans [Faire signer un mandat SEPA](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen).

## Annuler une demande [#een-aanvraag-annuleren]

Choisissez **Annuler la demande** si le client n'a plus besoin de signer. La demande passe au statut <Status>Annulé</Status>. Si elle est sur la tablette, elle y disparaît. Vous pouvez ensuite lancer une nouvelle demande.

## Révoquer un mandat actif [#een-actief-mandaat-intrekken]

Révoquez un mandat si le client ne peut plus être prélevé, par exemple en cas de déménagement, de contrat résilié ou à la demande du client.

<Callout type="warn" title="La révocation est irréversible">
Pour le paiement automatique, il faudra ensuite un nouveau mandat, avec une nouvelle signature du client.
</Callout>

<Steps>
<Step>
### Choisissez Révoquer le mandat [#kies-mandaat-intrekken]
Ouvrez le menu du mandat actif et choisissez **Révoquer le mandat**.
</Step>
<Step>
### Confirmez [#bevestig]
Dans l'écran **Révoquer ce mandat ?**, cliquez sur **Révoquer**. Tillor affiche **Mandat révoqué**.
</Step>
</Steps>

Ce qui se passe ensuite :

- Plus aucune facture n'est prélevée via ce mandat. Les prélèvements que Tillor n'avait pas encore envoyés à la banque sont annulés.
- Le statut du mandat devient <Status>Révoqué</Status>.
- Le document signé reste conservé comme preuve, mais passe aux archives. Dans les documents du client, vous le trouvez sous **Archivé**, de sorte que la liste ne montre que les mandats encore valables.
- Le client reçoit un e-mail l'informant que le mandat est révoqué, avec une copie du document signé.

Les mandats configurés en dehors de Tillor n'affichent que **Révoquer le mandat** dans le menu.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Révoquer le mandat">
L'action n'apparaît que pour un mandat au statut <Status tone="success">Actif</Status>. Une demande pas encore signée s'annule avec **Annuler la demande**.
</Accordion>
<Accordion title="Un prélèvement était déjà en route vers la banque">
La révocation n'annule que les prélèvements que Tillor n'avait pas encore envoyés à la banque. Un prélèvement déjà en route, vous le suivez dans <UIPath>Administration > Paiements</UIPath>.
</Accordion>
<Accordion title="Je veux utiliser un autre mandat pour une facture">
Choisissez le mandat dans **Mandat de prélèvement** sur la facture. Voir [Encaisser une facture](/betalingsverwerking/incasso).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Faire signer un mandat SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Encaisser une facture" href="/betalingsverwerking/incasso" />
</Cards>


# Faire signer un mandat SEPA (/fr-FR/betalingsverwerking/mandaat)

Avec un mandat SEPA, un client autorise le prélèvement automatique de ses factures sur son compte bancaire. Le client signe le mandat dans Tillor même. Tillor conserve le document signé chez le client, et vous pouvez ensuite faire encaisser des factures. Cela se trouve dans [Encaisser une facture](/betalingsverwerking/incasso).

Avant de commencer :

- Les mandats doivent être activés pour votre organisation. Si ce n'est pas le cas, le bouton **Créer un mandat** vous indique de contacter l'administrateur.
- Le client a besoin d'une adresse e-mail.
- Un client ne peut avoir qu'une seule demande ouverte à la fois.

## Demander un mandat [#een-mandaat-aanvragen]

<Steps>
<Step>
### Ouvrez le client [#open-de-klant]
Allez dans <UIPath>Clients > client > Facturation</UIPath>. En bas se trouve la carte **Mandats** avec tous les mandats et demandes du client.
</Step>
<Step>
### Cliquez sur Créer un mandat [#klik-op-mandaat-aanmaken]
Un menu s'ouvre avec un ou deux choix. Choisissez comment le client signe.
</Step>
</Steps>

<Tabs items={["À distance", "À la réception"]}>
<Tab value="À distance">
Choisissez **Envoyer l'invitation au mandat**. Le client reçoit un e-mail avec un lien vers la page de signature, et Tillor affiche **Mandat envoyé pour signature à** suivi de l'adresse e-mail du client.

Le lien est valable 14 jours, jusqu'au dernier jour inclus. Le client n'a pas à indiquer d'IBAN. Il choisit lui-même comment confirmer le mandat.
</Tab>
<Tab value="À la réception">
Choisissez **Faire signer sur l'iPad de l'accueil**. Le mandat apparaît sur la tablette de la réception, et Tillor affiche **Le mandat est sur l'iPad, le client peut signer**.

Ce choix n'apparaît dans le menu que si l'application Tillor est en ligne sur un appareil de votre organisation. Voir [Tablettes et bornes](/mobiele-app/tablets-en-kiosken). Le client signe avec le doigt sur la tablette. Le document signé note qu'il a été signé à la réception, et quel collègue a utilisé la tablette.

La demande est déjà envoyée et vous voulez quand même l'afficher sur la tablette ? Ouvrez le menu de la demande et choisissez **Afficher sur l'iPad**.
</Tab>
</Tabs>

## Que fait le client ? [#wat-doet-de-klant]

Le client parcourt plusieurs écrans. Sur la tablette, ce sont les mêmes écrans, avec quelques différences indiquées ci-dessous.

<Steps>
<Step>
### Consulter le mandat [#het-mandaat-bekijken]
La page **Signez votre mandat SEPA pour** votre organisation indique qui est le créancier, pour qui il prélève et de quel type de paiement il s'agit. Le client touche **Signer le mandat**.
</Step>
<Step>
### Accepter le texte [#de-tekst-accepteren]
Le client lit le résumé ou, via **Lire le texte complet du mandat**, le texte intégral, et coche qu'il est d'accord.

En dessous se trouve une deuxième case pour utiliser aussi le mandat pour les factures d'énergie et d'eau (eau, électricité, gaz). Cette case est cochée par défaut. Voir [Encaisser une facture](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
</Step>
<Step>
### Signer [#tekenen]
Le client signe avec le doigt ou la souris.
</Step>
<Step>
### Choisir la confirmation [#de-bevestiging-kiezen]
Sous **Comment souhaitez-vous autoriser ?**, le client choisit entre deux façons de confirmer.

- **Un petit premier paiement** avec sa propre banque ou carte, par exemple via iDEAL, Bancontact, carte de crédit ou Apple Pay. Le montant se situe entre 0 et 1 euro, selon la méthode. La banque confirme ainsi que le compte appartient au client, et le client n'a pas à recopier d'IBAN. Tillor déduit le montant de la facture suivante.
- **Compte bancaire (SEPA)** : le client saisit son IBAN, confirme que le compte est le sien et saisit un code à six chiffres. Ce code arrive par SMS sur le numéro de téléphone du client, ou par e-mail si aucun numéro n'est connu.
</Step>
</Steps>

Sur la tablette, le parcours par IBAN fonctionne de la même façon : le code est envoyé par SMS au téléphone du client. Si le client choisit le premier paiement, la tablette affiche un code QR que le client scanne avec son téléphone pour payer.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le mandat apparaît dans la liste avec le statut <Status tone="warning">Signé, activation en cours</Status>, ou <Status tone="warning">En attente du premier paiement</Status> si le client a choisi le petit paiement.
- Dès que le mandat est valide chez le partenaire de paiement, le statut devient <Status tone="success">Actif</Status>. Le client reçoit par e-mail une copie du mandat signé.
- Tillor conserve le document signé dans les documents du client. Vous l'ouvrez via le menu du mandat avec **Ouvrir le mandat signé**. Le document est scellé et horodaté, de sorte qu'une modification ultérieure dans un lecteur PDF est visible. Voir [Sceau et horodatage](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).
- Si la fenêtre du client a été fermée avant la fin du premier paiement, la demande reste ouverte. Le client peut réessayer via le même lien ou passer à son IBAN.

## Statuts [#statussen]

| Statut | Signification |
|---|---|
| <Status tone="info">En attente de signature</Status> | Le client n'a pas encore signé |
| <Status tone="warning">Signé, activation en cours</Status> | Signé avec IBAN, Tillor crée le mandat |
| <Status tone="warning">En attente du premier paiement</Status> | Signé, le petit paiement doit encore aboutir |
| <Status tone="success">Actif</Status> | Vous pouvez utiliser le mandat pour un prélèvement |
| <Status tone="error">Échec de l'activation</Status> | Le partenaire de paiement a refusé le mandat. Tillor réessaie plus tard |
| <Status>Lien expiré</Status> | Le client n'a pas signé dans les 14 jours |
| <Status>Annulé</Status> | Vous avez annulé la demande |
| <Status>Révoqué</Status> | Le mandat actif a été révoqué |

Les mandats configurés en dehors de Tillor affichent les statuts <Status tone="warning">En cours</Status>, <Status tone="success">Actif</Status>, <Status tone="error">Inactif</Status> et <Status>Annulé</Status>. Seul un mandat actif peut être utilisé pour un prélèvement.

## Rappels avant la signature [#herinneringen-voor-het-tekenen]

Tillor envoie lui-même des rappels par e-mail au client tant que la demande est ouverte : quand il reste 7 jours, deux jours avant l'expiration et le dernier jour. Chaque rappel contient un nouveau lien de signature.

Vous voulez relancer le client vous-même ? Choisissez dans le menu de la demande **Envoyer un rappel**. La date de fin reste alors identique. Si le lien a expiré, ou si vous voulez lui redonner 14 jours, choisissez **Renvoyer le lien de signature**. Vous en saurez plus sur ces actions dans [Révoquer ou renvoyer un mandat](/betalingsverwerking/mandaat-beheren).

Vous voulez qu'une automatisation réagisse lorsqu'une demande expire ? Il existe pour cela le déclencheur **Expiration d'une demande de mandat**, voir [Automatisations](/automatiseringen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le bouton Créer un mandat est grisé">
Survolez le bouton pour connaître la raison. Le plus souvent, le client n'a pas d'adresse e-mail, ou les mandats ne sont pas activés pour votre organisation. Ajoutez une adresse e-mail au client ou demandez à votre administrateur d'activer les mandats.
</Accordion>
<Accordion title="Tillor indique qu'un mandat attend déjà une signature">
Par client, une seule demande peut être ouverte à la fois. Renvoyez la demande existante ou annulez-la, puis créez-en une nouvelle.
</Accordion>
<Accordion title="Le choix de signer à la réception est absent">
Le choix n'apparaît que si l'application Tillor sur un appareil de votre organisation a récemment été en contact avec Tillor. Ouvrez l'application sur la tablette, patientez un instant et réessayez.
</Accordion>
<Accordion title="Le client ne reçoit pas le code SMS">
Le code est envoyé au numéro de téléphone figurant sur la fiche client. Vérifiez qu'il est correct. Si le client n'a pas de numéro, le code arrive par e-mail. Le client peut demander un nouveau code.
</Accordion>
<Accordion title="Le client voit que le lien a expiré">
Le client voit **Ce lien de signature a expiré**. Choisissez, dans la demande, **Renvoyer le lien de signature**.
</Accordion>
<Accordion title="Le statut reste Échec de l'activation">
Le partenaire de paiement a refusé le mandat. Tillor réessaie automatiquement plus tard. Si cela échoue durablement, annulez la demande avec **Annuler la demande** et demandez au client de signer à nouveau, éventuellement avec une autre confirmation.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Encaisser une facture" href="/betalingsverwerking/incasso" />
  <Card title="Révoquer ou renvoyer un mandat" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Méthodes de paiement" href="/betalingsverwerking" />
</Cards>


# Faire payer un client en ligne (/fr-FR/betalingsverwerking/online)

Le paiement en ligne passe par la page de paiement personnelle d'une facture. Le client ouvre la page, choisit une méthode de paiement et termine le paiement auprès de sa banque ou de l'émetteur de sa carte. Tillor collabore pour cela avec [Mollie](https://www.mollie.com), donc Mollie doit être connecté.

Il n'y a pas de bouton distinct « Envoyer le lien de paiement ». Vous partagez la page avec une notification ou avec l'URL personnelle de la facture.

Avant de commencer :

- La facture est comptabilisée et un montant reste impayé. Sinon, le client n'a rien à payer.
- Mollie est connecté. Sans méthodes de Mollie, le client ne voit qu'un bouton de paiement, voir [Un problème ?](#problemen).
- Le client a une adresse e-mail ou un numéro de téléphone, ou vous partagez le lien vous-même.

## Envoyer le lien de paiement au client [#de-betaallink-naar-de-klant-sturen]

<Steps>
<Step>
### Comptabilisez la facture [#boek-de-factuur]
Le paiement en ligne n'est possible que sur une facture comptabilisée avec un solde impayé.
</Step>
<Step>
### Envoyez une notification [#verstuur-een-notificatie]
Cliquez sur **Envoyer la notification** et choisissez un canal, comme l'e-mail ou le SMS. Le client reçoit un message avec le bouton **Consulter et payer en ligne**.
</Step>
</Steps>

Vous préférez partager vous-même ? Ouvrez le menu d'actions (trois points) de la facture et choisissez **URL personnelle**. Tillor copie le lien dans votre presse-papiers. Une relance avec le même lien s'envoie avec **Envoyer un rappel**, voir [Retrouver des paiements](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). Le client ne veut payer qu'une partie ? Créez alors un [lien pour un paiement partiel](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).

## Que voit le client ? [#wat-ziet-de-klant]

Le client ouvre la page **Votre facture de** votre organisation. On y trouve le montant à payer, un aperçu des lignes de facture et un bouton pour consulter la facture. À partir de cet écran, le client poursuit en trois étapes.

<Steps>
<Step>
### Payer [#betaal]
Le client touche **Payer** avec le montant. S'il y a un bouton Apple Pay, le client peut payer directement avec.
</Step>
<Step>
### Choisir une méthode [#kies-een-methode]
Sous **Comment souhaitez-vous payer ?** figurent les méthodes disponibles, comme iDEAL, Bancontact et carte de crédit. L'ordre vient de Mollie et s'adapte à la langue du client. Les règles suivantes s'appliquent :

- La méthode que le client a utilisée la dernière fois sur cet appareil est signalée par **Dernière utilisation**.
- Pour les clients francophones, Pay By Bank figure en tête avec **Souvent le plus adapté**.
- Si une méthode a une panne chez Mollie, un avertissement l'accompagne, par exemple que la méthode est partiellement inaccessible ou en maintenance. Le client peut quand même essayer la méthode, mais l'avertissement indique que cela risque de ne pas fonctionner. Le texte de la panne vient de Mollie.
</Step>
<Step>
### Terminer le paiement [#rond-de-betaling-af]
Ce qui se passe ensuite dépend de la méthode et de l'appareil. Voir ci-dessous.
</Step>
</Steps>

### Terminer sur ordinateur ou téléphone [#afronden-op-computer-of-telefoon]

<Tabs items={["Sur un ordinateur", "Sur un téléphone"]}>
<Tab value="Sur un ordinateur">
Pour iDEAL et Bancontact, Tillor affiche un code QR sous **Scannez pour payer**. Le client ouvre l'application de sa banque sur son téléphone et scanne le code. La page continue d'elle-même dès que le paiement est arrivé. Si le client préfère payer sur l'ordinateur, il le peut avec **Payer dans le navigateur**.
</Tab>
<Tab value="Sur un téléphone">
Pour Bancontact, Tillor affiche le bouton **Ouvrir l'application Bancontact**. Le client termine le paiement dans l'application, puis revient à la page. Via **Payer dans le navigateur**, le client peut aussi payer dans le navigateur du téléphone.
</Tab>
</Tabs>

Pour les autres méthodes, comme la carte de crédit, Tillor redirige le client vers la page de paiement du partenaire de paiement puis le ramène. Si la redirection ne se fait pas toute seule, un lien permet de continuer.

### Si cela échoue [#als-het-niet-lukt]

- **Choisir une autre méthode** ramène le client à la liste.
- **Recommencer** lance un nouveau paiement avec la même méthode. Pratique si le client a annulé dans l'application de sa banque ou si rien ne s'est passé.
- En cas de paiement échoué, annulé ou expiré, la page indique le résultat et le client peut choisir une autre méthode.

## Ce que la page peut afficher d'autre [#wat-de-pagina-nog-meer-kan-tonen]

| Situation | Ce que voit le client |
|---|---|
| La facture est payée | **Entièrement payée** avec le montant reçu, et une confirmation par e-mail |
| La banque a lancé un virement | **Confirmation de votre paiement**. Avec Pay By Bank, cela prend généralement quelques secondes et au plus quelques jours ouvrables |
| Un prélèvement SEPA est planifié | **Payé par domiciliation** avec le montant et la date. Le client n'a rien à faire. Les options de paiement n'y figurent pas, afin que personne ne paie en double |
| Le montant dépasse 2 500 euros | Un avertissement indiquant que la banque ou la carte peut refuser le paiement en ligne à cause de plafonds, avec l'IBAN et la communication structurée pour virer le montant |
| Le paiement en ligne n'est pas possible pour cette facture | **Payer par virement** avec les coordonnées bancaires |

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Le lien personnel n'a pas de date d'expiration. Le client peut donc encore l'ouvrir plus tard. Dès que Mollie confirme le paiement, il apparaît sur la facture et dans <UIPath>Administration > Paiements</UIPath>. La facture passe à <Status tone="success">Payé</Status> lorsque le montant total est arrivé. Vous n'avez rien à enregistrer vous-même. Voir [Retrouver des paiements](/betalingsverwerking/betalingen-bekijken) pour les statuts.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le client ne voit aucune méthode de paiement">
Mollie ne transmet alors aucune méthode. Le client ne voit que le bouton de paiement et va avec lui directement à la page de paiement de Mollie. Si cela persiste, vérifiez la connexion avec Mollie.
</Accordion>
<Accordion title="Le client a payé, mais la facture est encore ouverte">
Ouvrez le paiement via <UIPath>Administration > Paiements</UIPath> et utilisez **Synchroniser**. Avec Pay By Bank, la confirmation peut prendre quelques jours ouvrables.
</Accordion>
<Accordion title="Le client reçoit un avertissement sur une panne d'une méthode">
Mollie signale que la méthode connaît des perturbations. Le client peut choisir une autre méthode ou réessayer plus tard.
</Accordion>
</Accordions>

Vous intégrez votre propre système avec des paiements Mollie ? Voir [Métadonnées Mollie](/ontwikkelaars/mollie-metadata).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Retrouver des paiements" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mandat SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Payer avec un terminal de paiement (/fr-FR/betalingsverwerking/terminal)

Avec le mode de paiement **Terminal**, vous envoyez le montant restant dû d'une facture à un terminal de paiement à l'accueil. Le client paie par carte ou par téléphone, et Tillor enregistre le paiement dès que le terminal le finalise.

Tillor est le Tech Partner exclusif de [Mollie](https://www.mollie.com) pour le paiement par carte. Tillor fournit les terminaux Mollie et met en place avec vous Mollie Connect, l'appareil et la liaison avec les factures. Les questions sur le paiement par carte à l'accueil arrivent donc chez Tillor.

<Callout type="info" title="Uniquement des terminaux Mollie">
Tillor ne connecte pas de terminaux Worldline, CCV ou d'autres marques. Si vous avez déjà un tel terminal, nous vous fournissons un appareil Mollie. Ainsi, le paiement en ligne, le paiement par carte et le [rapport de paiement](/boekhouden/betalingsrapporten) restent une seule et même chaîne.
</Callout>

## Lancer un paiement par carte [#een-pinbetaling-starten]

<Steps>
<Step>
### Ouvrez l'écran de paiement [#open-het-betaalscherm]
Ouvrez une facture comptabilisée avec un solde dû et cliquez sur **Effectuer un paiement**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-terminal.png" alt="Boîte de dialogue de paiement avec le mode de paiement Terminal sélectionné" />
</Step>
<Step>
### Choisissez Terminal [#kies-terminal]
Sous **Mode de paiement**, choisissez **Terminal**.
</Step>
<Step>
### Choisissez le terminal [#kies-de-terminal]
Sélectionnez le terminal de votre accueil. Tillor n'affiche que les terminaux disponibles à ce moment. Si vous n'en avez qu'un, il est déjà sélectionné.
</Step>
<Step>
### Saisissez le montant [#vul-het-bedrag-in]
Saisissez un montant ou utilisez les boutons 25 %, 50 %, 75 % et 100 %. Un montant partiel est pratique pour un acompte ou si le client paie une partie en espèces et une partie par carte.
</Step>
<Step>
### Envoyez le paiement [#stuur-de-betaling]
Cliquez sur **Effectuer le paiement**. L'écran **Traitement du paiement** s'affiche pendant que Tillor envoie la demande au terminal.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

L'écran suit le paiement en direct. Le client paie sur le terminal, et l'écran passe de **Paiement en cours** à **Paiement réussi**. Il se ferme tout seul après quelques secondes, et le solde dû de la facture est mis à jour.

Tant que le terminal attend, vous pouvez cocher deux cases :

- **Imprimer A4 une fois payé** place le PDF de la facture dans la file d'attente de l'imprimante A4 dès que le paiement aboutit. L'option est grisée si aucun connecteur n'est en ligne.
- **Envoyer par e-mail après paiement** envoie la facture par e-mail au client dès que le paiement aboutit. L'option est grisée si le client n'a pas d'adresse e-mail.

Si le paiement échoue ou expire, vous recevez le message **Paiement échoué** ou **Paiement expiré**. Cliquez sur **Renvoyer au terminal** pour réessayer.

## Définir le terminal par défaut [#de-standaardterminal-instellen]

Tillor active l'appareil de paiement avec votre compte Mollie. Après la connexion de Mollie, Tillor choisit lui-même le terminal s'il n'y a qu'un seul terminal actif. Pour en choisir un autre, ouvrez <UIPath>Paramètres > Intégrations</UIPath> sous Mollie, dans le champ **Terminal par défaut** (à côté du **Profil principal**). Tillor propose alors ce terminal lors d'un paiement par carte.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Terminal sous Mode de paiement">
Ce mode n'apparaît que si Mollie est connecté et qu'un terminal est associé à votre compte. Vérifiez la connexion sous <UIPath>Paramètres > Intégrations</UIPath>.
</Accordion>
<Accordion title="Le terminal manque dans la liste">
Tillor n'affiche que les terminaux en ligne et actifs. Vérifiez que le terminal est allumé et connecté, puis réessayez.
</Accordion>
<Accordion title="Un ancien paiement est encore en attente">
Après une nouvelle tentative, un ancien paiement peut rester avec le statut <Status tone="warning">En attente</Status>. Annulez-le via <UIPath>Administration > Paiements</UIPath> avec **Annuler** dans le menu d'actions, pour que la facture soit correcte.
</Accordion>
<Accordion title="Panne ou accueil supplémentaire">
Envoyez un e-mail à **support@tillor.eu**.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Enregistrer un paiement" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Groupes de paiement" href="/betalingsverwerking/groepen" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Occupations (/fr-FR/bezettingen)

Une occupation indique qu'un client utilise un terrain donné (un emplacement de camping, une borne électrique, etc.). Tant que l'occupation est en cours, Tillor attribue automatiquement au client la consommation des compteurs de ce terrain. Vous gérez les occupations sur la fiche client. Commencez par [Créer une occupation](#een-bezetting-aanmaken).

<Callout type="info" title="Bon à savoir">
- Un terrain ne peut être occupé que par un seul client à la fois. Les terrains avec une occupation active ne figurent pas dans la liste de choix.
- **Payé jusqu'au** n'accepte qu'aujourd'hui ou une date ultérieure.
- Vous ne pouvez pas modifier le terrain d'une occupation après coup. Si un client déménage, mettez fin à l'occupation et créez-en une nouvelle.
- La suppression d'une occupation est irréversible, mais la consommation jusqu'à la date de fin est conservée et peut encore être facturée.
- Avec **Prolonger l'occupation (facture)**, le brouillon de facture reçoit une échéance de 14 jours après sa création.
- Seuls les champs **Type**, **Fréquence de loyer** et **Prix** sont informatifs. Ils ne pilotent pas automatiquement l'enregistrement des relevés ni la facturation.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une occupation relie trois éléments : le client, le terrain et les compteurs de ce terrain. Tillor sait ainsi à quel nom imputer la consommation.

```mermaid
flowchart LR
  K[Client] --> B[Occupation]
  B --> T[Terrain]
  T --> M[Compteurs du terrain]
  M --> V[Période de consommation du client]
  V --> F[Facture]
  B -->|Prolonger l'occupation| F
```

À la création, Tillor note les relevés de début, à la fin de l'occupation les relevés de fin. La consommation entre les deux revient au client. Une nouvelle occupation sur le même terrain ouvre une nouvelle période.

## Consulter les occupations [#bezettingen-bekijken]

Ouvrez une fiche client via <UIPath>Clients > Aperçu</UIPath> et allez à la carte **Occupations** de l'onglet **Aperçu**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Occupations sur la fiche client" />

- Le tableau affiche pour chaque occupation le **Terrain**, le **Type**, la **Fréquence de loyer**, le **Prix**, le **Statut** et **Payé jusqu'au**, avec une indication relative comme « dans 12 jours ».
- À côté de **Payé jusqu'au**, une icône d'information affiche **Facturé jusqu'au** dans une infobulle, si cette date est renseignée ou égale à **Payé jusqu'au**.
- Avec **Filtrer les occupations...**, vous cherchez par nom de terrain.
- Les actions par occupation (modifier, prolonger, supprimer) se trouvent dans le menu à trois points à la fin de la ligne.

## Créer une occupation [#een-bezetting-aanmaken]

Avant de commencer :

- Le terrain doit être libre. S'il n'est pas dans la liste, il est déjà occupé. Voir Un problème ? en bas de page.
- Si le terrain a des compteurs, gardez les relevés de début à portée de main. Si vous ne saisissez rien, Tillor reprend le dernier relevé connu.

<Steps>
<Step>
### Ouvrez la fiche client [#open-het-klantprofiel]
Allez à <UIPath>Clients > Aperçu</UIPath>, ouvrez le client et allez à la carte **Occupations**.
</Step>
<Step>
### Cliquez sur Créer une occupation [#klik-op-bezetting-aanmaken]
Le bouton se trouve dans la barre d'outils du tableau. Une boîte de dialogue s'ouvre.
</Step>
<Step>
### Renseignez les informations [#vul-de-gegevens-in]
Seul **Terrain** est obligatoire. Le reste est facultatif.

- **Terrain** : choisissez via **Sélectionner un terrain**. Seuls les terrains disponibles figurent dans la liste. Si aucun terrain n'est disponible, vous voyez **Aucun terrain disponible trouvé.**
- **Payé jusqu'au (optionnel)** : jusqu'à quand le client a payé d'avance. Vous choisissez aujourd'hui ou plus tard.
- **Facturé jusqu'au (optionnel)** : laissez vide pour suivre la même date que **Payé jusqu'au**, ou choisissez votre propre date.
- **Type** : **Logement personnel** (par défaut) ou **Caravane en location**.
- **Fréquence de loyer (optionnel)** : une des options configurées par votre organisation, chacune avec un mois de début et un nombre de mois (par exemple début en janvier, 6 mois). Choisissez **Aucune fréquence** si vous ne voulez pas en enregistrer.
- **Description (optionnel)** : une explication, par exemple des accords tarifaires.
- **Prix** : l'occupation reprend le prix du terrain. Avec **Remplacer le prix du terrain hérité**, vous indiquez votre propre prix.
- **Lectures de compteur de début (optionnel)** : apparaît dès que le terrain a des compteurs. S'il n'en a pas, vous voyez **Aucun compteur lié**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu d'actions d'une occupation avec Modifier, Prolonger et Supprimer" />
</Step>
<Step>
### Confirmez [#bevestig]
Cliquez sur **Créer une occupation** pour enregistrer.
</Step>
</Steps>

### Renseigner les relevés de compteur [#meterstanden-invullen]

<Tabs items={["Compteur manuel", "Compteur automatique"]}>
<Tab value="Handmatige meter">
Saisissez vous-même le relevé via l'onglet **Manuel**. Le champ affiche le dernier relevé connu comme exemple. S'il existe des relevés antérieurs, vous pouvez aussi en choisir un via **Sélectionner**.
</Tab>
<Tab value="Automatische meter">
Un compteur qui transmet lui-même ses relevés n'autorise pas la saisie manuelle. Choisissez un relevé existant via **Sélectionner une lecture de compteur**.
</Tab>
</Tabs>

Si vous saisissez un relevé inférieur au dernier relevé enregistré, Tillor affiche un avertissement. Vous pouvez alors confirmer la valeur plus basse ou corriger la saisie.

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- L'occupation est immédiatement active et figure dans le tableau de la fiche client.
- Tillor démarre pour chaque compteur du terrain une période de consommation pour ce client. Les nouveaux relevés comptent désormais comme consommation du client.
- Le terrain n'est plus disponible pour une autre occupation.

## Modifier une occupation [#een-bezetting-bewerken]

<Steps>
<Step>
### Ouvrez le menu de l'occupation [#open-het-menu-van-de-bezetting]
Cliquez sur le menu à trois points à côté de l'occupation et choisissez **Modifier**.
</Step>
<Step>
### Ajustez les champs [#pas-de-velden-aan]
Vous pouvez modifier **Type**, **Fréquence de loyer**, **Description**, **Payé jusqu'au**, **Facturé jusqu'au** et **Prix**. **Terrain** est en lecture seule. Si votre organisation a des [champs personnalisés](/eigen-velden) pour les occupations, ils figurent en bas de la boîte de dialogue.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-edit-dialog.png" alt="Boîte de dialogue Modifier l'occupation" />
</Step>
<Step>
### Enregistrez [#sla-op]
Cliquez sur **Enregistrer les modifications**. La modification apparaît avec un aperçu avant/après dans l'onglet **Événements** du client.
</Step>
</Steps>

## Mettre fin à une occupation [#een-bezetting-beëindigen]

Mettre fin supprime le lien entre le client et le terrain. Le terrain redevient ensuite disponible.

<Steps>
<Step>
### Choisissez Supprimer [#kies-verwijderen]
Cliquez sur le menu à trois points à côté de l'occupation et choisissez **Supprimer**. La fenêtre **Supprimer l'occupation** s'ouvre.
</Step>
<Step>
### Choisissez la date et les relevés de fin [#kies-de-datum-en-de-eindmeterstanden]
Si le terrain a des compteurs, vous pouvez renseigner **Lectures de compteur de fin (optionnel)**. Choisissez d'abord sous **Date** le jour où l'occupation se termine (aujourd'hui ou avant). Un champ pour le relevé de fin apparaît ensuite pour chaque compteur. Pour un compteur manuel, vous saisissez le relevé via **Manuel** ou le choisissez via **Sélectionner**. Un compteur automatique demande toujours un relevé existant via **Sélectionner une lecture de compteur**.
</Step>
<Step>
### Confirmez [#bevestig-1]
Cliquez sur **Supprimer**. Cette action est irréversible.
</Step>
</Steps>

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna-1]

- Tillor clôture les périodes de consommation ouvertes du client. La consommation jusqu'à la date de fin est conservée et peut encore être facturée.
- Le terrain est de nouveau disponible pour une nouvelle occupation.
- L'occupation disparaît du tableau.

## Facturation : prolonger l'occupation [#facturatie-bezetting-verlengen]

Avec **Prolonger l'occupation (facture)**, vous créez un brouillon de facture pour la période suivante d'une occupation, par exemple le droit de stationnement annuel. Vous pouvez le faire pour une seule occupation ou pour toutes les occupations du client en une fois.

Avant de commencer : il doit exister au moins un produit avec l'action **Prolonger l'occupation** (souvent le droit de stationnement). Voir [Produits](/producten).

<Steps>
<Step>
### Lancez l'action [#start-de-actie]
<Tabs items={["Une occupation", "Toutes les occupations"]}>
<Tab value="Eén bezetting">
Ouvrez le menu à trois points à côté de l'occupation et choisissez **Prolonger l'occupation (facture)**.
</Tab>
<Tab value="Alle bezettingen">
Cliquez dans la barre d'outils sur **Tout prolonger**. Toutes les occupations se retrouvent sur un seul brouillon de facture, avec une ligne principale par occupation.
</Tab>
</Tabs>
</Step>
<Step>
### Choisissez si vous facturez aussi la consommation [#kies-of-je-verbruik-meefactureert]
Cochez **Facturer la consommation ouverte pour ce terrain** (avec **Tout prolonger** : **Facturer la consommation ouverte (tous les terrains)**) si vous voulez facturer aussi la consommation ouverte sur le même brouillon de facture. S'il n'y a rien d'ouvert sur les compteurs concernés, on s'en tient aux lignes de prolongation de l'occupation.
</Step>
<Step>
### Créez le brouillon de facture [#maak-de-conceptfactuur]
Cliquez sur **Créer le brouillon**. Tillor utilise le premier produit avec l'action **Prolonger l'occupation** (par ordre alphabétique du nom) et construit les lignes pour vous. Complétez ensuite la période sur la facture et comptabilisez-la quand vous êtes prêt.
</Step>
</Steps>

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna-2]

- Un brouillon de facture est prêt chez le client, avec le message **Prêt** et une description de ce qui a été créé.
- Si vous comptabilisez la facture, Tillor place **Facturé jusqu'au** à la date de fin de la ligne.
- Après paiement, Tillor met à jour **Payé jusqu'au**. **Facturé jusqu'au** n'avance que s'il se situait encore avant cette date de fin.

<Callout type="warn" title="Attention en cas de brouillon existant">
S'il existe déjà un brouillon de facture qui prolonge ce terrain, Tillor affiche **Vérifier avant de continuer**. Un deuxième brouillon peut produire des lignes en double ou sauter une période. Ouvrez le brouillon existant avec **Ouvrir le brouillon ...**, ou choisissez **Créer quand même le brouillon**.
</Callout>

## Payé jusqu'au, type, fréquence de loyer et prix [#betaald-tot-type-huurfrequentie-en-prijs]

| Champ | Signification |
|---|---|
| **Payé jusqu'au** | Jusqu'à quand le client a payé d'avance. À la création ou à la modification, vous choisissez aujourd'hui ou plus tard. |
| **Facturé jusqu'au** | Jusqu'à quand il a été facturé. Si vous le laissez vide, l'affichage suit **Payé jusqu'au**. |
| **Type** | Distingue le séjour personnel de la location. |
| **Fréquence de loyer** | Enregistre le rythme de la location pour le suivi administratif. |
| **Prix** | Suit par défaut le terrain, mais peut être ajusté par occupation. |

## Scénarios courants [#veelvoorkomende-scenarios]

### Un nouveau client arrive [#een-nieuwe-gast-checkt-in]

1. Cherchez le client ou ajoutez-le.
2. Créez sur la fiche client une occupation sur le terrain.
3. Renseignez le relevé de début, ou laissez Tillor reprendre le dernier relevé.
4. Tillor associe désormais la consommation des compteurs de ce terrain à ce client.

### Un client part [#een-gast-vertrekt]

1. Choisissez **Supprimer** sur l'occupation.
2. Choisissez la date de départ et renseignez les relevés de fin.
3. Confirmez. Tillor clôture les périodes de consommation et le terrain est de nouveau disponible.

### Un client déménage sur un autre terrain [#een-klant-verhuist-naar-een-ander-terrein]

1. Mettez fin à l'occupation actuelle avec les relevés de fin de l'ancien terrain.
2. Créez une nouvelle occupation sur le nouveau terrain avec les relevés de début.
3. Tillor tient les périodes de consommation séparées par terrain.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le terrain ne figure pas dans la liste de choix">
Seuls les terrains sans occupation active figurent dans la liste. Si un autre client occupe encore le terrain, mettez d'abord fin à cette occupation. Si rien n'est disponible, vous voyez **Aucun terrain disponible trouvé.** Si tous les terrains manquent et que vous voyez **Une erreur s'est produite lors du chargement des terrains.**, rechargez la page.
</Accordion>
<Accordion title="L'occupation ne peut pas être créée parce que le terrain est déjà occupé">
Un autre utilisateur vous a devancé et a pris le terrain. Rechargez la page du client, choisissez un autre terrain ou mettez d'abord fin à l'occupation de l'autre client.
</Accordion>
<Accordion title="Je ne peux pas choisir une date passée sous Payé jusqu'au">
C'est voulu. À la création ou à la modification, **Payé jusqu'au** n'accepte qu'aujourd'hui ou une date ultérieure.
</Accordion>
<Accordion title="Les relevés de fin n'apparaissent pas sous Supprimer">
Choisissez d'abord sous **Date** le jour où l'occupation se termine. Un champ apparaît ensuite pour chaque compteur. Si le terrain n'a pas de compteurs, il n'y a pas de champ.
</Accordion>
<Accordion title="Je ne peux pas saisir de relevé pour un compteur">
C'est un compteur qui transmet lui-même ses relevés. Choisissez un relevé existant via **Sélectionner une lecture de compteur**. Si vous voyez **Aucune lecture de compteur disponible**, le compteur n'a pas encore transmis de relevé.
</Accordion>
<Accordion title="Tillor affiche : Échec de la création. Impossible de créer la facture">
Le plus souvent, il n'existe aucun produit avec l'action **Prolonger l'occupation**. Créez-en un, voir [Produits](/producten), et réessayez. Si vous prolongez toutes les occupations en une fois, vérifiez aussi qu'elles appartiennent au même client.
</Accordion>
<Accordion title="Tillor affiche Vérifier avant de continuer lors de la prolongation">
Il existe déjà un brouillon pour ce terrain, ou le terrain est facturé jusqu'à une date qui n'est pas encore payée. Lisez le message. Avec **Créer quand même le brouillon**, vous continuez en connaissance de cause ; avec **Ouvrir le brouillon ...**, vous vérifiez d'abord le brouillon existant.
</Accordion>
<Accordion title="J'ai supprimé une occupation par erreur">
C'est irréversible. Créez une nouvelle occupation sur le même terrain. La consommation jusqu'à la date de fin de l'ancienne occupation a été conservée.
</Accordion>
</Accordions>

## Termes [#begrippen]

- **Occupation** : un client sur un terrain pour une période. Voir [occupation](/begrippen#bezetting).
- **Terrain** : l'emplacement lui-même, avec d'éventuels compteurs. Voir [terrain](/begrippen#terrein).
- **Payé jusqu'au** : la date jusqu'à laquelle le client a payé d'avance.
- **Facturé jusqu'au** : la date jusqu'à laquelle on a déjà facturé.
- **Période de consommation** : la période pendant laquelle la consommation d'un compteur est imputée à un seul client. Voir [lot de consommation](/begrippen#verbruiksbatch).
- **Fréquence de loyer** : le rythme de la location, par exemple annuel ou semestriel.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" description="Ajouter et gérer des clients" />
  <Card title="Gestion des compteurs" href="/meterbeheer" description="Comment les compteurs sont relevés et liés aux occupations" />
  <Card title="Lots de consommation" href="/meterbeheer/consumptie-batches" description="Comment les périodes de consommation sont suivies et facturées" />
  <Card title="Exemples pratiques" href="/praktijk" />
  <Card title="Accueillir un client saisonnier" href="/praktijk/seizoensklant-binnenhalen" />
  <Card title="Une caravane résidentielle se libère" href="/praktijk/stacaravan-komt-vrij" />
</Cards>


# TVA et fiscalité (/fr-FR/boekhouden/belasting)

Vous lisez ici comment la TVA arrive sur vos factures et comment Tillor contrôle le numéro de TVA d'un client. Le contrôle passe par VIES, le service européen qui permet de vérifier un numéro de TVA.

## Taux de TVA [#btw-tarieven]

Les taux de TVA se définissent par produit. Allez à **Administration > Produits** et ouvrez un produit pour choisir la **TVA %** parmi les taux disponibles (par défaut 0 %, 6 %, 9 %, 12 % et 21 %).

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Liste des produits - colonne TVA par produit" />

## Autoliquidation et autres régimes sans TVA [#btw-verlegd-en-andere-regimes-zonder-btw]

Parfois vous ne facturez pas de TVA, mais ce n'est pas un simple taux de 0 % : le client doit déclarer lui-même la TVA, ou la livraison est exonérée. Dans la liste de choix **TVA %** d'un produit figurent donc, sous les taux, cinq régimes. Si vous en choisissez un, le produit passe à 0 % et Tillor sait pourquoi.

| Régime | Quand | Case de la déclaration de TVA |
|--------|---------|----------------------------|
| **Autoliquidation (services UE)** | Un service pour un client assujetti à la TVA dans un autre pays de l'UE | 44 |
| **Autoliquidation (cocontractant)** | Travaux immobiliers pour un client belge assujetti à la TVA qui dépose des déclarations périodiques | 45 |
| **Livraison intracommunautaire** | Des biens que vous envoyez à un client assujetti à la TVA dans un autre pays de l'UE | 46 |
| **Exportation hors UE** | Des biens qui quittent l'UE | 47 |
| **Exonéré de TVA** | Une livraison exonérée par nature (article 44 du Code de la TVA) | 00 |

Un régime fait quatre choses qu'un simple taux de 0 % ne fait pas :

- **Sur la facture**, la ligne porte `0%*`, avec sous les totaux la mention légale du régime, par exemple *Autoliquidation : la TVA est due par le preneur*. Si deux régimes figurent sur une même facture, le deuxième reçoit `**`.
- **La comptabilisation n'aboutit qu'avec un numéro de TVA** pour les deux régimes d'autoliquidation et pour une livraison intracommunautaire. Saisissez le numéro sur la fiche client ; il figure alors aussi sur la facture.
- **Vers la comptabilité**, la ligne part avec le code du régime, afin d'arriver dans la bonne case de votre déclaration de TVA. Voir [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes).
- **Via Peppol**, la ligne reçoit la catégorie de TVA du régime.

<Callout type="warn" title="C'est à vous de décider quel régime s'applique">
Tillor ne vérifie pas si un client ou une livraison a droit à un régime. En cas de doute, demandez à votre comptable.
</Callout>

## Validation du numéro de TVA [#btw-nummer-validatie]

Lorsque vous saisissez un numéro de TVA sur la fiche client, Tillor le contrôle automatiquement via le service européen VIES dès que le pays est renseigné.

### Comment ça marche [#hoe-het-werkt]

1. Ouvrez **Clients > client** (section **Détails du client**)
2. Définissez le **pays** et saisissez le numéro de TVA (par ex. `NL123456789B01` ou `BE0123456789`)
3. Tillor valide automatiquement le numéro (après une courte pause)
4. Pour un numéro de TVA valide, une coche verte apparaît ; cliquez dessus pour voir les données de l'entreprise issues de VIES
5. Vous voulez reprendre le nom et l'adresse ? Cliquez sur **Appliquer l'adresse de l'entreprise** dans cette fenêtre (le nom de l'entreprise va dans le champ prénom)
6. Pour un numéro de TVA invalide, une icône rouge apparaît avec une explication

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Fiche client - Détails du client avec les champs de TVA" />

<Callout type="info">
La validation de la TVA fonctionne pour tous les pays de l'UE. Pour les entreprises hors UE, vous pouvez saisir le numéro de TVA manuellement sans validation.
</Callout>

### Pays pris en charge [#ondersteunde-landen]

La validation prend en charge tous les États membres de l'UE, dont les Pays-Bas (NL), la Belgique (BE), l'Allemagne (DE), la France (FR) et tous les autres pays de l'UE.

### Code pays sur le PDF de la facture [#landcode-op-de-factuur-pdf]

Sur le PDF de la facture, Tillor complète automatiquement un code pays manquant pour les pays où c'est l'écriture habituelle : si vous saisissez `0123456789` pour un client belge, `BE0123456789` figure sur la facture. Pour l'Espagne, l'Italie et le Portugal, ce n'est pas le cas, car le numéro fiscal national s'y écrit sans code pays (un NIF espagnol comme `B04876793` reste donc inchangé). Si vous saisissez vous-même le code pays dans le champ, il est toujours repris.

## Clients belges et Peppol [#belgische-klanten-en-peppol]

Pour les clients belges avec un numéro de TVA, un **ID Peppol** doit figurer dans l'onglet **Facturation** avant que vous puissiez comptabiliser des factures. C'est une obligation légale pour la facturation B2B en Belgique.

Voir la [documentation Peppol](/boekhouden/peppol) pour plus d'informations.

## TVA sur les factures [#btw-op-facturen]

Toutes les lignes de facture affichent automatiquement le bon taux de TVA sur la base du produit lié. Sur la facture, vous voyez **Sous-total**, **TVA** et **Total** ; sur le PDF de la facture figure en plus un récapitulatif par taux de TVA.

<Callout type="info" title="Ajuster la TVA par ligne">
Avez-vous le droit de modifier les paramètres de l'organisation ? Allez à **Paramètres > Facturation** et activez **Menu déroulant du taux de TVA sur les lignes de facture brouillon**. Sur les **brouillons de facture** apparaît alors une colonne pour choisir le taux par ligne (les options suivent les taux configurés pour votre organisation). Lorsque vous sélectionnez un produit, le taux standard du produit reste la valeur de départ. Dans la même colonne, vous choisissez aussi un [régime sans TVA](#btw-verlegd-en-andere-regimes-zonder-btw) pour une ligne.
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le numéro de TVA du client reçoit une icône rouge">
Tillor n'a pas pu confirmer le numéro via VIES. Vérifiez le pays et le numéro. Pour une entreprise hors UE, vous pouvez aussi saisir le numéro sans validation.
</Accordion>
<Accordion title="Je ne peux pas comptabiliser une facture avec autoliquidation">
Le client n'a pas de numéro de TVA. L'autoliquidation et la livraison intracommunautaire n'existent que pour un client assujetti à la TVA. Saisissez le numéro sous <UIPath>Clients > client</UIPath>, section **Détails du client**, et comptabilisez à nouveau.
</Accordion>
<Accordion title="Je ne peux pas envoyer une facture avec deux régimes via Peppol">
Une facture Peppol ne peut porter qu'un seul motif d'absence de TVA. Placez les lignes de chaque régime sur une facture distincte.
</Accordion>
<Accordion title="Il me manque un taux de TVA sur un produit">
Vous ne pouvez choisir que parmi les taux autorisés, par défaut 0 %, 6 %, 9 %, 12 % et 21 %.
</Accordion>
<Accordion title="Je ne peux pas choisir le taux de TVA sur une ligne de facture">
La colonne des taux n'existe que sur les brouillons de facture et seulement si **Menu déroulant du taux de TVA sur les lignes de facture brouillon** est activé.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Produits" href="/producten" description="Associer des taux de TVA aux produits" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Facturation électronique en Belgique" />
  <Card title="Factures" href="/facturen" description="Créer et comptabiliser des factures" />
</Cards>


# Moyens de paiement (/fr-FR/boekhouden/betalingsrapporten/betaalmethodes)

Les rapports de paiement contiennent des paiements de différentes sources. Seuls **Mollie** et les **virements internes** sont envoyés à la comptabilité.

| Méthode | Sur le rapport Tillor | Vers la comptabilité |
|---------|-------------------|------------------|
| [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Oui (via le décompte Mollie) | Oui |
| [Comptes bancaires](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Oui (le jour du paiement) | Non |
| [Virement interne](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Oui | Oui |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Rapport de paiement - paiements de différentes sources" />

```mermaid
flowchart LR
  Mollie[Mollie] --> R[Rapport Tillor]
  Bank[Comptes bancaires] --> R
  Internal[Virement interne] --> R
  R --> BH[Comptabilité]
  Mollie --> BH
  Internal --> BH
```

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Comptes bancaires" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Virement interne" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Virements internes (/fr-FR/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers)

Avec **Virement interne**, vous déplacez un montant restant dû d'une facture vers une autre facture **comptabilisée** du **même client**. Tillor crée un paiement positif sur la facture que vous payez et un paiement négatif lié sur la facture cible.

Voir [Virement interne - Enregistrer](/betalingsverwerking/interne-overboeking) pour le processus d'enregistrement pas à pas avec captures d'écran.

## Dans les rapports de paiement [#in-betalingsrapporten]

- Les virements internes figurent sur le rapport de paiement Tillor du jour où vous les enregistrez (Bruxelles).
- Ils sont **bien** transmis à l'export comptable : avec les paiements Mollie, et **pas** avec les comptes bancaires ni les autres méthodes manuelles (espèces, virement, ...).
- Dans l'export comptable, chaque ligne apparaît sous la forme `Tillor - Interne overboeking - {factuurnummer}`, liée à la facture et au client concernés.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Enregistrer" href="/betalingsverwerking/interne-overboeking" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Comptes bancaires" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Mollie (/fr-FR/boekhouden/betalingsrapporten/betaalmethodes/mollie)

Les paiements Mollie (iDEAL, carte de crédit, Bancontact, terminal, etc.) sont synchronisés dans Tillor et associés aux rapports de paiement via le **versement Mollie**.

## Connecter dans Tillor [#koppelen-in-tillor]

1. Allez à **Paramètres > Intégrations** et choisissez **Mollie** dans la liste.
2. Suivez les étapes OAuth de Mollie si la connexion n'est pas encore active.
3. Sur la page de détail, choisissez sous **Profil de site web** un **Profil principal** (le profil de site web Mollie pour les paiements et la synchronisation). Vous pouvez en option choisir un **Terminal par défaut** (l'appareil de paiement que Tillor propose par défaut sur les factures).
4. Cliquez sur **Enregistrer**. Sans profil principal, les paiements Mollie ne fonctionnent pas dans Tillor ; un terminal n'est nécessaire que pour les paiements par carte.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-marketplace-install.png" alt="Paramètres > Intégrations - Mollie dans la liste" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-connection-settings.png" alt="Paramètres Mollie - Profil principal et Terminal par défaut" />

### Icônes de statut dans les listes de choix [#statusiconen-in-de-keuzelijsten]

À gauche du nom du profil et du terminal figure une icône colorée. C'est le statut chez Mollie, pas le nom lui-même.

| Icône | Profil de site web | Terminal |
|-------|----------------|----------|
| Verte (coche) | Vérifié - adapté aux paiements réels | Actif - prêt pour les paiements par carte |
| Orange (horloge) | Pas encore vérifié chez Mollie | En attente - pas encore actif |
| Rouge (interdit) | Bloqué | - |
| Grise | - | Inactif |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-profile-select-open.png" alt="Profil principal ouvert - icône de statut à côté du nom du profil" />

Choisissez de préférence un profil **vérifié**. Un terminal **actif** est facultatif et n'est nécessaire que si vous voulez proposer des paiements par carte depuis Tillor. Sans profil principal, les paiements et la synchronisation ne fonctionnent pas.

## Versements Mollie [#mollie-settlements]

Tant que Mollie n'a pas encore versé un paiement, il figure comme **avance** sur le rapport brouillon ouvert. C'est seulement à la finalisation que le versement décide sur quel rapport il se trouve ; voir [Paiements Mollie sur le brouillon](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept).

Pour le **jour de rapport D**, Tillor cherche un versement dans cet ordre :

1. Versement **créé le jour D**
2. Sinon, versement **créé le jour D+1** (typiquement : le chiffre d'affaires de D est versé le lendemain matin)

```mermaid
flowchart TD
  D[Jour de rapport D] --> E{Versement créé le jour D ?}
  E -- oui --> F[Associer au rapport D]
  E -- non --> G{Versement créé le jour D+1 ?}
  G -- oui --> F
  G -- non --> H[Pas encore de Mollie sur ce rapport]
  F --> I[Un identifiant de versement par rapport]
```

**Règles établies :**

- Chaque identifiant de versement figure sur **au maximum un** rapport de paiement.
- Un rapport a déjà un versement ? Cette association **reste** ; Tillor ne la remplace pas.
- Si D et D+1 manquent tous les deux (par ex. week-end) : le rapport peut déjà exister avec uniquement des paiements manuels ou de comptes bancaires ; dès que Mollie publie, la synchronisation quotidienne complète avec Mollie.

## Exemples [#voorbeelden]

| Jour de rapport D | Versement créé chez Mollie | Résultat |
|--------------|----------------------------------|-----------|
| Mar. 20 mai | Mar. 20 mai (`stl_aaa`) | `PAYR/2026/0140` (20 mai) reçoit `stl_aaa` |
| Mar. 20 mai | Mer. 21 mai tôt (`stl_bbb`) | `PAYR/2026/0140` (20 mai) reçoit `stl_bbb` (règle D+1) |
| Dim. 18 mai | Lun. 19 mai (`stl_ccc`) | `PAYR/2026/0138` (dimanche) reçoit `stl_ccc`, **pas** le rapport du lundi |
| Lun. 19 mai | Lun. 19 mai (`stl_ccc`) | Le rapport du lundi cherche son propre versement (`stl_ddd` le mardi ou plus tard), pas `stl_ccc` |
| Sam. 17 mai | Pas de versement sam./dim./lun. matin | Rapport du 17 mai : d'abord manuel/comptes bancaires ; Mollie suit s'il y a un versement |
| Mar. 20 mai | Le rapport existait déjà sans versement | Prochaine exécution à 09:00 : versement ajouté au 20 mai, paiements associés |

**Concrètement (D+1) :** le chiffre d'affaires du **mardi 20 mai** figure dans le versement `stl_6necch`, créé le **mercredi 21 mai** à 06:08. Tillor associe `stl_6necch` à **`PAYR/2026/0140` (jour de rapport 20 mai)**, pas au rapport du 21 mai.

**Rapport existant :** `PAYR/2026/0140` figurait déjà dans Tillor sans décompte Mollie associé et avec deux lignes manuelles ? Après la synchronisation, `stl_6necch` est tout de même associé ; les lignes existantes restent ; les paiements Mollie de ce versement s'y ajoutent.

**Déjà associé :** le rapport du **15 mai** a déjà `stl_old`. Tillor ne modifie **pas** cet identifiant. Des paiements Mollie isolés avec le même identifiant de versement arrivent tout de même sur le rapport qui a déjà ce versement.

## Synchronisation sur les rapports existants [#synchronisatie-op-bestaande-rapporten]

Après la création des rapports manquants, Tillor cherche **uniquement les rapports sans décompte Mollie associé** dans une fenêtre glissante d'**un mois calendaire avant hier** jusqu'à hier. Les rapports qui ont déjà un décompte Mollie ne sont **pas** récupérés à nouveau via la liste des versements Mollie.

```mermaid
flowchart TD
  start[Synchronisation<br/>lun.-sam. 09:00] --> scope[Jour de rapport du<br/>mois avant hier jusqu'à hier]
  scope --> nullOnly[Uniquement les rapports<br/>sans décompte Mollie]
  nullOnly --> U{Chercher un versement pour D ou D+1}
  U -- trouvé --> V[Enregistrer le versement]
  U -- pas trouvé --> W[Pas d'étape Mollie]
  V --> X[Associer les paiements Mollie<br/>non associés du versement]
  X --> Z[Paiements avec le même<br/>identifiant de versement sur ce rapport]
```

Les paiements qui ont déjà un identifiant de versement de Mollie, mais ne figurent pas encore sur un rapport, arrivent sur le rapport ayant le même identifiant de versement.

## Paiements Mollie dans Tillor [#mollie-betalingen-in-tillor]

Tillor récupère les paiements Mollie **toutes les 15 minutes** (par organisation avec une connexion Mollie active). Les webhooks de Mollie fonctionnent en plus, immédiatement : un paiement passe aussitôt à **Payé**, **Remboursé** ou **Remboursé par opposition**, même s'il est né en dehors de Tillor (par exemple un terminal de paiement). En cas de doute ou de webhook manqué : **Synchroniser** dans le menu d'actions du paiement.

Un paiement arrive sur un rapport si :

- il figure dans le **versement** associé (liste de Mollie), ou
- le paiement a déjà un identifiant de versement qui correspond au rapport.

| Type dans le rapport | Signification |
|-----------------|-----------|
| Connu | Paiement associé à une facture dans Tillor |
| Inconnu | Aucune facture associée dans Tillor → compte d'attente 499000, sauf si vous transmettez des données comptables via Mollie |

Les paiements d'un versement qui n'existent **pas** dans Tillor apparaissent comme paiement Mollie inconnu sur le rapport.

Sur un rapport de paiement, vous voyez les paiements Mollie associés dans le tableau **Paiements** :

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Détail du rapport de paiement - paiements et Vers la comptabilité" />

## Métadonnées Mollie [#mollie-metadata]

Vous avez une caisse ou un autre système qui crée lui-même des paiements Mollie ? Vous pouvez piloter Tillor via des métadonnées sur ce paiement : association à une facture ou à un [groupe de paiement](/betalingsverwerking/groepen), ou directement vers la comptabilité. Les champs figurent sous [Métadonnées Mollie](/ontwikkelaars/mollie-metadata).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Rapports de paiement" href="/boekhouden/betalingsrapporten" />
  <Card title="Groupes de paiement" href="/betalingsverwerking/groepen" />
  <Card title="Comptes bancaires" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Virements internes" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Métadonnées Mollie (API)" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Comptes bancaires (/fr-FR/boekhouden/betalingsrapporten/betaalmethodes/ponto)

La connexion bancaire se connecte à votre compte bancaire via l'open banking et récupère automatiquement les transactions.

## Comment ça marche [#hoe-het-werkt]

1. **Transactions** : toutes les 5 minutes, Tillor récupère les transactions bancaires auprès de votre banque
2. **Communication structurée** : +++123/4567/89002+++ ou numéro de facture (INV/2024/0001) est lu
3. **Association** : Tillor cherche une facture correspondante → le paiement est créé et associé
4. **Double virement manuel** : s'il existe déjà un virement manuel sur la même facture avec le même montant, il est supprimé pour que le paiement ne compte pas deux fois
5. Dans Tillor, vous voyez ce paiement comme **virement bancaire**

## Connecter [#koppelen]

L'intégration s'appelle **Comptes bancaires** et se trouve sous <UIPath>Paramètres > Intégrations > Comptes bancaires</UIPath>. Vous renseignez un **ID client** et un **Secret client** ; un administrateur Tillor vous aide à la configuration et accompagne l'onboarding.

## Consulter les transactions bancaires [#banktransacties-bekijken]

Les transactions bancaires importées figurent sous **Administration > Transactions bancaires**. Cette page n'est visible que pour les utilisateurs ayant le droit **Voir les transactions bancaires**. Sans ce droit, vous ne voyez pas la page dans le menu.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-list.png" alt="Liste des transactions bancaires avec la colonne Facture" />

Dans le tableau **Transactions**, la colonne **Facture** se trouve entre **Date de valeur** et **Communication** :

- La transaction est déjà sur une facture ? Vous voyez alors le numéro de facture sous forme de lien (par ex. `INV/2026/0001`).
- Pas encore d'association ? Ouvrez le menu d'actions (trois points) à la fin de la ligne et choisissez **Associer à une facture**. Au besoin, Tillor crée d'abord un paiement et l'associe à la transaction. Pour cela, vous avez besoin du droit **Assigner un paiement** ; sans ce droit, vous ne voyez pas cette action dans le menu.
- La transaction est déjà sur une facture ? Ouvrez le même menu d'actions et choisissez **Dissocier de la facture** pour supprimer l'association (manuelle et automatique).

Cliquez sur l'icône (i) à côté de l'IBAN pour ouvrir le panneau de détail de cette transaction : montant, date de valeur, contrepartie et IBAN, communication, les données de l'extrait de compte (référence bancaire, référence du donneur d'ordre, numéro de carte, ...), la facture, le paiement et le rapport de paiement associés, ainsi que les références. Le menu d'actions figure aussi en haut de ce panneau.

Dans le menu d'actions, vous choisissez en outre :

- **Créer une tâche** pour rattacher une tâche à la transaction, par exemple pour traiter un paiement manuellement. La tâche affiche la transaction comme élément lié ; cliquez dessus pour ouvrir le panneau de détail. Voir [Éléments liés](/taken/taakdetails#gekoppelde-items).
- **Copier le lien** pour un lien qui ouvre la page **Transactions bancaires** avec le panneau de détail de cette transaction, par exemple à coller dans une remarque ou un message.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-assign-dialog.png" alt="Boîte de dialogue Associer à une facture pour une transaction bancaire" />

Vous voyez la même colonne **Facture** sur un **rapport de paiement** dans le tableau **Transactions du compte bancaire**, tant que vous avez le droit de lecture.

## Dissocier [#ontkoppelen]

Sous **Administration > Transactions bancaires** (et sur un rapport de paiement dans **Transactions du compte bancaire**), ouvrez le menu d'actions d'une ligne associée et choisissez **Dissocier de la facture**. Cela fonctionne aussi bien pour les transactions associées manuellement que pour celles appariées automatiquement.

Sous **Administration > Paiements**, **Dissocier de la facture** n'apparaît que pour les paiements que vous avez vous-même associés ou déplacés vers une facture. Vous évitez ainsi de supprimer par erreur une association automatique correcte via l'aperçu des paiements.

<DocScreenshot src="/screenshots/betalingen/payment-unassign-menu.png" alt="Menu d'actions du paiement avec Dissocier de la facture" />

## Synchroniser manuellement [#handmatig-synchroniseren]

Sous **Administration > Transactions bancaires** et sur un **rapport de paiement** (tableau **Transactions du compte bancaire**), le bouton **Synchroniser le compte bancaire** apparaît si la connexion bancaire est installée et que vous avez le droit **Synchroniser les transactions bancaires**. Vous demandez ainsi une nouvelle synchronisation bancaire ; Tillor importe ensuite les nouvelles transactions et tente de les associer aux factures.

Sans connexion bancaire ou sans ce droit, le bouton n'apparaît pas. Tillor importe aussi automatiquement les nouvelles transactions, toutes les 5 minutes.

Vous configurez ces deux droits via **Paramètres > Autorisations des utilisateurs** (groupe **Transactions bancaires**).

## Dans les rapports de paiement [#in-betalingsrapporten]

Les virements bancaires figurent **bien** sur le rapport de paiement Tillor de la date de paiement (Bruxelles), avec les paiements manuels de ce jour. Ils ne sont **pas** transmis à l'export comptable : uniquement Mollie et les virements internes. La connexion bancaire sert surtout à l'association automatique aux factures dans Tillor.

<Callout type="idea" title="Association automatique">
Le client vire avec une communication structurée → Tillor récupère auprès de votre banque → la facture est appariée → paiement + facture payée.
</Callout>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Virements internes" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Admisol (/fr-FR/boekhouden/betalingsrapporten/boekhoudsystemen/admisol)

Admisol est un logiciel de comptabilité que Tillor prend en charge pour l'envoi des rapports de paiement. Les rapports de paiement sont convertis en XML Admisol et envoyés à Admisol automatiquement ou manuellement.

## Installation [#installatie]

1. Allez à **Paramètres** (repère **1** sur la capture d'écran) et choisissez **Intégrations**.
2. Cherchez **Admisol** dans la liste des intégrations (repère **2**) et ouvrez la page de détail.
3. Sur la page de détail, renseignez votre **Company ID** et votre **Web Service Key** (données d'Admisol) et cliquez sur **Installer**.

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-marketplace-install.png" alt="Paramètres > Intégrations - Admisol dans la liste" />

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-credentials-dialog.png" alt="Détail Admisol - Company ID et Web Service Key" />

## Envoi automatique [#automatisch-versturen]

Lorsqu'un rapport de paiement **change sur le fond** (par exemple après l'association de paiements ou après **Recalculer le rapport**) :

1. Tillor vérifie si Admisol est installé pour l'organisation
2. Le rapport est converti en XML Admisol
3. Le XML est envoyé à Admisol

Lors de la **création quotidienne** (09:00), Tillor parcourt les jours manquants **du plus ancien au plus récent**. Chaque nouveau rapport n'est envoyé à Admisol qu'une fois que le rapport précédent a reçu une réponse (acceptation ou refus). Si l'envoi échoue, Tillor s'arrête pour cette organisation jusqu'à la prochaine exécution.

Le [rapport brouillon](/boekhouden/betalingsrapporten#concept-en-definitief) du jour en cours part déjà vers Admisol dès qu'il contient un paiement Mollie ou un virement interne, puis uniquement à nouveau lorsque l'écriture change. Les paiements en espèces sur le brouillon ne déclenchent pas d'envoi. Les paiements Mollie sur un brouillon sont contrepassés sur le fournisseur Mollie **sans référence de document** ; Admisol les comptabilise comme **avance** (« à recevoir »). Les remboursements que Mollie n'a pas encore retenus figurent comme deuxième ligne d'avance distincte sur Mollie (« à retenir »). Lors de l'envoi définitif, le vrai versement avec les frais bancaires les remplace, et les paiements qui ne figuraient pas dans le versement passent comme avance au brouillon suivant. Tant que le rapport est un brouillon, la référence de document dans Admisol est `PAYR/2026/0275 - Concept` ; cet ajout disparaît à l'envoi définitif. Si le rapport devient définitif le jour ouvrable suivant, Tillor le renvoie, cette fois avec le versement Mollie, sous **le même numéro de document et la même date d'écriture**.

En cas d'échec de l'envoi automatique, vous recevez une notification et une ligne apparaît sur la chronologie des événements du rapport.

## Envoi manuel [#handmatig-versturen]

1. Allez à **Administration > Rapports de paiement**
2. Ouvrez le rapport que vous voulez envoyer
3. Cliquez sur **« Vers la comptabilité »**

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Rapport de paiement - Vers la comptabilité" />

## Quels paiements sont transmis ? [#welke-betalingen-gaan-mee]

Uniquement les paiements avec :

- **Mollie** comme prestataire, ou
- **Virement interne** comme moyen de paiement

Les paiements de comptes bancaires ne sont pas transmis à la comptabilité.

## Remboursement partiel (Mollie) [#gedeeltelijke-terugbetaling-mollie]

Si un paiement Mollie associé est remboursé en partie ou en totalité, Tillor transmet le **montant d'origine du paiement** sur le rapport de paiement du **versement Mollie dans lequel le paiement est arrivé**. Le **remboursement** apparaît comme ligne négative sur le rapport du **versement dans lequel Mollie déduit le remboursement** (libellé *Terugbetaling*). Il peut s'agir de versements ultérieurs ; plusieurs remboursements reçoivent chacun leur propre ligne sur le rapport de leur versement. Le rapport correspond ainsi à ce que Mollie verse réellement. Comme les remboursements ne sont comptabilisés que le jour de ce versement, aucune ligne supplémentaire n'est liée au compte d'attente **499000** (*restant saldo*).

## Frais bancaires par facture Mollie [#bankkosten-per-mollie-factuur]

Mollie retient ses frais sur chaque versement et les facture une fois par mois. Tillor comptabilise donc les frais retenus **par période de facturation** : chaque ligne porte le mois pour lequel Mollie facture les frais, par exemple *Bankkosten 01/2026*. Un versement des premiers jours du mois contient souvent encore des frais du mois précédent ; ils figurent alors comme ligne distincte sur le même rapport.

Toutes les lignes d'une même période s'additionnent au montant de la facture Mollie de ce mois. Les lignes du mois en cours restent ouvertes jusqu'à ce que Mollie émette la facture.

### Sur le fournisseur Mollie [#op-de-leverancier-mollie]

Les frais retenus ne sont pas une seconde charge : Mollie règle ainsi sa propre facture. Tillor les comptabilise donc sur le **fournisseur Mollie**, sans référence de document. La charge et la TVA n'entrent que par la facture d'achat Mollie. Chaque mois, vous pointez sur le fournisseur Mollie la facture avec les lignes *Bankkosten* de cette période ; elles ont le même montant au total. Une correction par opération diverse n'est pas nécessaire.

Mollie retient généralement les frais d'un paiement dès l'arrivée du paiement, même si le versement suit plus tard. Un rapport brouillon comptabilise donc déjà ces frais par période de facturation, et l'avance sur Mollie est le montant après frais. Un paiement par carte que Mollie retient encore n'a pas encore de frais retenus : ces frais n'arrivent que sur le rapport avec le versement. D'ici là, le mois n'est pas encore complet sur le fournisseur Mollie.

Dans Admisol, ne **pointez pas de lignes d'un rapport brouillon** (la référence de document se termine par *- Concept*). Lors de l'envoi définitif, Admisol remplace les lignes du rapport, et les pointages sur ces lignes peuvent disparaître. Cela peut aussi arriver quand vous renvoyez un rapport définitif, même si rien n'a changé : vérifiez ensuite les pointages sur le fournisseur Mollie.

## Réserve de solde [#balansreserve]

Mollie retient parfois une partie du versement comme **réserve de solde** : de l'argent qui vous est dû, mais que Mollie retient temporairement. Comme ce n'est ni une charge ni un remboursement, Tillor comptabilise ce montant sur le **fournisseur Mollie** avec le libellé *Balansreserve*, tout comme le versement lui-même. Il reste ainsi comme avoir ouvert sur Mollie plutôt que sur le compte d'attente. Si Mollie libère ensuite la réserve, une ligne *Balansreserve* de sens contraire apparaît sur le rapport de ce versement et solde l'avoir. Vous n'avez rien à faire ; sur le fournisseur Mollie, les deux lignes s'annulent.

## Factures déjà pointées dans Admisol [#facturen-die-in-admisol-al-afgepunt-zijn]

Admisol refuse une ligne sur une facture ou une note de crédit que vous avez pointée manuellement dans Admisol contre une autre écriture que le rapport de paiement. Tillor comptabilise alors les lignes de cette seule facture sur le client **sans référence de document**, pour que le rapport passe quand même. Les montants et le client restent identiques ; seul le lien avec la facture est à repointer vous-même dans Admisol. Sur la chronologie des événements du rapport, le XML envoyé indique de quelle facture il s'agit.

## Paramètres comptables [#boekhoudparameters]

Après l'installation, vous définissez les paramètres comptables via **Paramètres** sur l'application Admisol (même écran que Company ID et Web Service Key). Y figurent notamment les types de documents pour les factures et les versements, le code fournisseur Mollie, le compte général par défaut pour les lignes de facture et le service par défaut. Les champs manquants reçoivent les valeurs par défaut de Tillor.

Les paiements Mollie inconnus sont comptabilisés sur le compte d'attente **499000**. Par paiement, vous pouvez aussi transmettre le service et l'exercice via les [métadonnées Mollie](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping).

### Régimes de TVA [#btw-regimes]

Une ligne de facture avec un [régime sans TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) part vers Admisol avec son propre **profil d'adresse fiscal** et son propre **code de taxe**. Ensemble, ils déterminent dans quelle case de la déclaration de TVA la ligne arrive. Les valeurs par défaut sont celles d'un nouveau dossier Admisol :

| Régime | Profil d'adresse fiscal | Code de taxe | Case |
|--------|------------------|----------|---------|
| Autoliquidation (services UE) | `EU` | `vd21` | 44 |
| Autoliquidation (cocontractant) | `MED` | `v21` | 45 |
| Livraison intracommunautaire | `EU` | `v21` | 46 |
| Exportation hors UE | `EXP` | `v21` | 47 |
| Exonéré de TVA | `NA` | `v0` | 00 |

Si votre dossier utilise d'autres codes, adaptez-les dans les paramètres comptables : pour chaque régime, il y a un champ pour le profil d'adresse fiscal et un pour le code de taxe. Vous trouvez les codes de votre dossier dans Admisol sous **Instellingen > BTW-instellingen > Tax-relaties**. La fiche client dans Admisol garde son propre profil d'adresse fiscal ; seule la ligne de facture reçoit celui du régime.

## Voir aussi [#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 (/fr-FR/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online)

Exact Online est le logiciel de comptabilité que de nombreux parcs néerlandais et leurs bureaux utilisent. Tillor associe les **clients**, les **factures comptabilisées** et les **rapports de paiement** à Exact Online. La connexion est **disponible sur demande** - pas encore en libre-service dans l'App Marketplace.

<Callout type="info" title="Sur demande">
Vous voulez connecter Tillor à Exact Online ? Demandez l'activation via la [démo](https://tillor.eu/demo) ou envoyez un e-mail à **support@tillor.eu**. Nous mettons la connexion en place avec votre comptable.
</Callout>

## Ce que couvre la connexion [#wat-de-koppeling-dekt]

L'export prévu suit la même chaîne que [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) et [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). Nous définissons avec vous lors de l'activation le mappage exact des journaux et des comptes de produits.

- **Clients** de Tillor vers Exact Online
- **Factures comptabilisées** (lignes et TVA)
- **Rapports de paiement** - uniquement **Mollie** et les **virements internes**, comme pour les autres exports comptables

Les paiements de comptes bancaires figurent bien sur le rapport Tillor, mais ne sont pas transmis à l'export comptable. Voir [systèmes comptables](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Pas encore de libre-service [#nog-geen-zelfbediening]

Vous ne trouvez pas encore Exact Online sous **Paramètres > Intégrations**. Le choix de l'administration, le mappage du grand livre et le premier export se font avec le support Tillor. Il n'y a pas de formulaire d'installation à remplir soi-même.

<Callout type="warn" title="Un seul système comptable actif">
Tillor exporte vers un seul logiciel de comptabilité par organisation. Si vous utilisez déjà Admisol ou Odoo, nous convenons ensemble du système qui reste actif.
</Callout>

## Faire la demande [#aanvragen]

1. Notez votre administration Exact Online (division) et si votre comptable en suit le contenu.
2. Demandez la connexion via [tillor.eu/demo](https://tillor.eu/demo) ou **support@tillor.eu**.
3. Tillor planifie l'activation et le mappage des journaux et des comptes de produits.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Systèmes comptables" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Aperçu (/fr-FR/boekhouden/betalingsrapporten/boekhoudsystemen)

Tillor prend en charge l'intégration avec des logiciels de comptabilité pour l'envoi des rapports de paiement. Les rapports de paiement sont convertis au format de votre logiciel de comptabilité (actuellement Admisol) et envoyés automatiquement ou manuellement. [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) est disponible sur demande.

## Systèmes pris en charge [#ondersteunde-systemen]

| Système | Statut |
|---------|--------|
| [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Pris en charge |
| [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Clients et factures comptabilisées |
| [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | Sur demande |

## Général [#algemeen]

- **Automatique** : à la création ou lors d'une mise à jour significative d'un rapport de paiement, il est envoyé à Admisol (uniquement si Admisol est installé)
- **Manuel** : via **Administration > Rapports de paiement** → ouvrez le rapport → **Vers la comptabilité**
- **Quels paiements** : uniquement **Mollie** et les **virements internes**. Les comptes bancaires figurent bien sur le rapport Tillor, mais ne sont pas transmis à l'export comptable.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Rapport de paiement - Vers la comptabilité en manuel" />

## Voir aussi [#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 (/fr-FR/boekhouden/betalingsrapporten/boekhoudsystemen/odoo)

La connexion Odoo de Tillor exporte les **clients** et les **factures comptabilisées** vers Odoo. Les rapports de paiement vers Odoo suivront dans une prochaine version ; d'ici là, utilisez [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) si vous voulez transmettre automatiquement les rapports de paiement.

## Installation [#installatie]

1. Allez dans **Paramètres** et ouvrez l'App Marketplace.
2. Cherchez la carte **Odoo** et cliquez sur **Installer**.
3. Renseignez d'abord sous **Connexion** :
   - **URL Odoo** - par exemple `https://mijnbedrijf.odoo.com` ou simplement `mijnbedrijf` (Tillor complète alors l'URL `.odoo.com`)
   - **Nom d'utilisateur** - utilisateur ayant accès à l'API
   - **Clé API** - clé API (Odoo : profil utilisateur > clés API)
4. Cliquez sur **Continuer vers la base de données**. Tillor récupère les bases de données disponibles (ou vous laisse saisir le nom manuellement).
5. Choisissez la base sous **Base de données** et terminez l'installation.

À l'enregistrement, Tillor teste la connexion.

<Callout type="info" title="Un seul système comptable actif">
Si Admisol et Odoo sont tous deux installés, Tillor utilise **Admisol** pour l'export (priorité fixe). N'installez Odoo que si vous n'utilisez plus Admisol.
</Callout>

## Paramètres comptables (application Odoo) [#boekhoudparameters-odoo-app]

Après l'installation, vous réglez les paramètres d'export via **Paramètres** sur l'application Odoo (en plus de l'URL, de la base de données, de l'utilisateur et de la clé API). Tillor récupère en direct depuis Odoo les journaux de ventes et les comptes de produits ; vous les choisissez via un champ de recherche (code et nom).

| Champ dans l'application | Par défaut | Signification |
|---|---|---|
| **Code journal des ventes** | INV | Journal des ventes dans Odoo portant ce code |
| **Compte de produit par défaut** | 700000 | Compte de produit utilisé quand la ligne de facture n'a pas de numéro de compte général propre |
| **Comptabiliser les factures automatiquement** | désactivé | Comptabiliser directement dans Odoo après l'export |
| **Joindre le PDF de facture** | activé | PDF de la facture Tillor en pièce jointe de la facture Odoo |
| **Joindre l'UBL Peppol** | activé | UBL Peppol en pièce jointe supplémentaire (uniquement si Tillor a déjà cet UBL) |

Pour chaque ligne de facture, Tillor cherche d'abord un compte Odoo ayant le même code que le **numéro de compte général** de la ligne ; sinon, il prend le compte de produit par défaut. Pour la TVA, Tillor cherche dans Odoo une TVA de vente avec le même pourcentage que sur la ligne.

### Régimes de TVA [#btw-regimes]

Une ligne de facture avec un [régime sans TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), comme l'autoliquidation, a besoin dans Odoo de sa propre TVA de vente : un 0 % ordinaire atterrit dans la mauvaise case de votre déclaration. Indiquez donc dans les paramètres d'export, pour chaque régime que vous utilisez, le **nom de la TVA de vente dans Odoo**, exactement comme il apparaît dans Odoo sous **Comptabilité > Configuration > Taxes** (dans un Odoo belge par exemple `0% EU S` pour les services dans l'UE). Il y a cinq champs : autoliquidation (services UE), autoliquidation (cocontractant), livraison intracommunautaire, exportation hors UE et exonéré de TVA.

Si le champ d'un régime est vide ou si la TVA n'existe pas dans Odoo, l'export de cette facture s'arrête avec un message d'erreur. Renseignez le nom et renvoyez la facture.

## PDF de facture dans Odoo [#factuur-pdf-in-odoo]

Avec **Joindre le PDF de facture** (activé par défaut), Tillor envoie le même PDF que dans Tillor. Lors d'un nouvel export, cela se fait **avant** la comptabilisation dans Odoo, afin que l'aperçu à droite de la facture puisse être lié. Le nom de fichier suit le numéro de facture Tillor (par ex. `INV_2026_0001.pdf`). Tillor place aussi ce PDF comme pièce jointe principale de la facture Odoo.

Dans les **Événements** de la facture Tillor, vous voyez si l'export a réussi, avec le client, la facture, le PDF et l'UBL.

- Si la facture Odoo existe déjà (même référence : le numéro de facture Tillor), Tillor met à jour le client, les lignes, les dates et la référence de paiement. Si la facture était déjà comptabilisée dans Odoo, Tillor la remet d'abord en brouillon, adapte les données et la comptabilise à nouveau lorsque **Comptabiliser les factures automatiquement** est activé ou que la facture était déjà comptabilisée.
- Ensuite, les pièces jointes PDF et UBL sont remplacées ou ajoutées lorsque ces options sont activées.
- Si l'envoi échoue après la création d'une facture brouillon, cette facture Odoo est supprimée afin qu'un export suivant puisse réessayer.

## UBL Peppol dans Odoo [#peppol-ubl-in-odoo]

Avec **Joindre l'UBL Peppol** (activé par défaut), Tillor envoie l'UBL Peppol comme pièce jointe supplémentaire de la facture Odoo. Le nom de fichier suit le numéro de facture Tillor (par ex. `INV_2026_0001.xml`).

- Tillor ne génère pas d'UBL lui-même : le fichier n'est disponible qu'après une livraison Peppol réussie.
- Si l'UBL n'est pas encore prêt au moment de l'export, Tillor ignore la pièce jointe UBL ; dès que l'UBL arrive, elle est ajoutée à la facture Odoo existante.
- Si l'envoi de l'UBL échoue, l'ensemble de l'export Odoo n'échoue **pas** (contrairement au PDF). Seule une erreur de PDF sur une nouvelle facture annule le brouillon Odoo.

## Factures [#facturen]

- Lors de la **comptabilisation** ou de la **recomptabilisation** d'une facture, Tillor exporte automatiquement la facture vers Odoo.
- Manuellement : actions de la facture > export vers la comptabilité (même bouton que pour Admisol).
- Seules les factures au statut **Comptabilisé** sont exportées.
- S'il existe déjà une facture Odoo avec le même numéro de facture Tillor, aucune seconde facture n'est créée. Tillor met à jour le client, les lignes et les dates sur cette facture (par exemple après un transfert vers un autre client ou une recomptabilisation) et remplace les pièces jointes PDF/UBL lorsque ces options sont activées.
- Si le PDF de la facture change après un **paiement** (ou un autre montant sur le document), Tillor remplace la pièce jointe PDF existante dans Odoo dès que le nouveau PDF est prêt. Il n'y a pas de seconde facture Odoo et aucun paiement n'est comptabilisé dans Odoo.

## Clients [#klanten]

Les clients sont mis à jour ou créés dans Odoo avec le numéro de client Tillor comme référence. Les partenaires existants portant le même numéro sont mis à jour.

## Rapports de paiement [#betalingsrapporten]

L'envoi automatique et manuel des rapports de paiement vers Odoo n'est **pas encore disponible**. Le processus quotidien de rapport de paiement ignore Odoo sans message d'erreur.

## Prérequis dans Odoo [#vereisten-in-odoo]

- Journal des ventes avec le code configuré (par défaut `INV`)
- Comptes généraux dont les codes correspondent aux lignes Tillor ou au compte de produit par défaut
- Facultatif : taux de TVA de vente dans Odoo avec les mêmes pourcentages que dans Tillor

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Systèmes comptables" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Aperçu (/fr-FR/boekhouden/betalingsrapporten)

Un **rapport de paiement** est un récapitulatif quotidien des paiements d'un seul jour calendaire. Numérotation : `PAYR/YYYY/DDDD` (jour de l'année, quatre chiffres ; par ex. `PAYR/2026/0054`).

**Contenu :** paiements connus et inconnus, le versement Mollie (le cas échéant) et les transactions bancaires non liées de vos comptes bancaires. Un versement de Mollie s'appelle en comptabilité un settlement : le montant que Mollie verse sur votre compte bancaire pour une série de paiements.

Votre comptable travaille avec ces rapports. Vous n'avez pas à les créer ni à les clôturer. Voir aussi [Comment tout cela s'articule-t-il ?](/boekhouden#hoe-hangt-dit-samen).

## Brouillon et définitif [#concept-en-definitief]

Un rapport a un **statut** :

| Statut | Signification |
|--------|---------------|
| **Brouillon** | Le rapport du **jour en cours**. Les paiements d'aujourd'hui (virements internes, espèces, comptes bancaires et Mollie) y sont déjà liés et le rapport part déjà vers la comptabilité. Les paiements Mollie y figurent comme **avance** : de l'argent que Mollie doit encore verser. Il n'y a pas encore de settlement Mollie et le rapport n'est pas encore imprimé automatiquement. |
| **Définitif** | La journée est clôturée. Tillor a lié le settlement Mollie (le cas échéant), imprimé le rapport et envoyé la version définitive à la comptabilité. |

Le rapport brouillon d'aujourd'hui est créé automatiquement : lors de l'exécution de 09:00, ou plus tôt dès que vous enregistrez le premier paiement manuel ou paiement de compte bancaire de ce jour. Vous n'avez jamais à rendre un brouillon définitif vous-même ; Tillor le fait lors de la prochaine exécution quotidienne après la fin de la journée.

Vous reconnaissez un brouillon à son **numéro de rapport gris, souligné en pointillés** et au badge **Brouillon**, dans la liste (colonne et filtre **Statut**), sur la page de détail et partout où le rapport est référencé. Le PDF d'un brouillon porte **(brouillon)** dans son titre. Le numéro du rapport et la date comptable restent identiques lorsque le brouillon devient définitif.

### Paiements Mollie sur le brouillon [#mollie-betalingen-op-het-concept]

Chaque paiement Mollie encaissé qui n'a pas encore été versé par Mollie arrive immédiatement sur le rapport brouillon ouvert. En comptabilité, le total apparaît comme **avance sur le fournisseur Mollie** : vous voyez ainsi à tout moment combien Mollie vous doit encore.

Une **domiciliation SEPA en cours** compte de la même manière, même si l'encaissement ne part vers Mollie que dans quelques jours. La facture est alors déjà indiquée comme payée (en cours de traitement) dans Tillor, et il en va de même en comptabilité. Si l'encaissement échoue ou est annulé, le paiement disparaît du brouillon.

Lorsque le brouillon devient définitif, Tillor compare le rapport au settlement Mollie :

- Les paiements qui sont **dans le settlement** restent sur le rapport. L'avance est remplacée par le versement réel, avec les frais bancaires.
- Les paiements qui n'y sont **pas** (par exemple carte de crédit avec versement ultérieur, ou chiffre d'affaires après la clôture de Mollie) passent au **prochain rapport brouillon** et y restent comme avance.
- Si un paiement du settlement figurait déjà sur un brouillon plus récent, Tillor le ramène sur le rapport du settlement.

Seuls les paiements récents entrent en ligne de compte : payés au cours du dernier mois et encore sans settlement chez Mollie.

Les **remboursements** comptent immédiatement. Un remboursement que Mollie n'a pas encore déduit d'un versement figure comme ligne négative sur le brouillon ouvert. En comptabilité, cela reste deux avances distinctes sur Mollie : une pour les paiements encore à recevoir et une pour les remboursements encore à déduire ; elles ne sont pas compensées entre elles. C'est aussi le cas lorsque le paiement d'origine figure déjà sur un rapport définitif plus ancien : Mollie déduit alors le montant d'un versement ultérieur. Dès qu'un settlement impute le remboursement, il figure sur le rapport de ce settlement et disparaît du brouillon.

<Callout type="info" title="Brouillon en comptabilité">
Un brouillon part vers la comptabilité dès qu'il contient quelque chose que la comptabilité enregistre (un paiement Mollie ou un virement interne). Ensuite, Tillor ne le renvoie que si l'écriture change, toujours sous le même numéro de document. Les modifications sont regroupées : l'envoi part environ dix secondes après la dernière modification et au plus tard après une minute, de sorte que, par exemple, l'affectation d'un paiement à une facture ne donne qu'un seul envoi. Un brouillon ne contenant que des paiements en espèces ou des paiements de compte bancaire n'est donc pas envoyé, et un paiement en espèces supplémentaire ne provoque pas de nouvel envoi.
</Callout>

## Génération quotidienne [#dagelijkse-generatie]

Chaque **jour ouvrable à 09:00** (du lundi au samedi, fuseau Europe/Bruxelles), Tillor traite tous les rapports du **1er janvier à hier** qui manquent encore ou sont encore en **brouillon**, **du plus ancien au plus récent** : les brouillons deviennent définitifs, les jours manquants sont immédiatement créés comme rapport définitif. Pour chaque rapport, Tillor attend la réponse d'Admisol (succès ou erreur) avant de traiter et d'envoyer le rapport suivant. Ensuite, Tillor ouvre le **rapport brouillon d'aujourd'hui**. Pour chaque organisation avec une connexion Mollie active, une synchronisation **limitée** suit : les rapports **sans** settlement Mollie, depuis **un mois calendaire avant hier** jusqu'à hier (voir [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
```

### Que contient un rapport ? [#wat-zit-in-een-rapport]

| Source | Quand liée |
|------|-------------------|
| Paiements manuels | Jour calendaire de la date de création (Bruxelles) |
| Paiements de compte bancaire | Jour calendaire de la date de paiement (Bruxelles) |
| Mollie | Settlement pour le jour de rapport D (voir [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) |

Les paiements de compte bancaire figurent **bien** sur le rapport Tillor de ce jour, mais ne partent **pas** vers l'export comptable (uniquement Mollie et les virements internes).

### Hier sans settlement Mollie [#gisteren-zonder-mollie-settlement]

Le rapport d'**hier** doit-il encore devenir définitif (ou être créé) et Mollie n'a-t-il pas encore de settlement pour hier ou aujourd'hui ? Alors Tillor **attend** le jour ouvrable suivant ; le rapport reste en **brouillon** entre-temps. Les jours plus anciens sans settlement reçoivent bien un rapport (manuel/comptes bancaires) ; Mollie est lié plus tard lors de la synchronisation.

<Callout type="warn" title="Week-end">
Le chiffre d'affaires du samedi et du dimanche n'obtient souvent un settlement Mollie que le lundi matin. Il appartient au rapport du **dimanche** (règle D+1), pas à celui du lundi. Voir les [exemples sur la page Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).
</Callout>

## Exemples [#voorbeelden]

| Situation | Ce que vous voyez |
|----------|-------------|
| Jour ouvrable, settlement le lendemain matin | Le rapport d'**hier** reçoit encore Mollie (règle D+1) |
| Virement interne enregistré aujourd'hui | Figure immédiatement sur le **rapport brouillon d'aujourd'hui** et part vers la comptabilité |
| Paiement Mollie reçu aujourd'hui | Figure immédiatement sur le brouillon, en comptabilité comme avance sur Mollie |
| Paiement Mollie absent du settlement du rapport | Passe au brouillon suivant lors du passage en définitif |
| Rapport d'hier encore en brouillon, pas de settlement | Tillor **attend** que Mollie publie (jour ouvrable suivant 09:00) ; le rapport reste en brouillon |
| Le rapport existait sans Mollie | L'exécution de 09:00 suivante complète le settlement et les paiements |
| Le rapport avait déjà un identifiant de settlement | L'identifiant **reste** ; seuls des paiements supplémentaires peuvent encore être liés |

Plus d'exemples de dates (week-end, double settlement) : [Mollie > Exemples](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

## Ouvrir et parcourir un rapport de paiement [#betalingsrapport-openen-en-navigeren]

1. Allez dans **Administration > Rapports de paiement** (repère vert **1** sur la capture d'écran).
2. Ouvrez un rapport dans la liste.
3. Sur la page de détail, utilisez les flèches de la barre d'actions à droite pour passer au rapport précédent ou suivant.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Liste des rapports de paiement" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Détail d'un rapport de paiement - Vers la comptabilité et flèches de navigation" />

Au survol d'une flèche, vous voyez du contexte supplémentaire (numéro de rapport, date et nombre de paiements) du rapport vers lequel vous naviguez.

À droite de la page de détail se trouve le **Journal des événements**. Vous y voyez quand le rapport a été créé, quand il est devenu définitif et s'il a été envoyé à la comptabilité.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le rapport d'hier reste en brouillon">
Mollie n'a pas encore publié de versement pour hier. Tillor attend alors le jour ouvrable suivant à 09:00. Le rapport devient définitif tout seul, vous n'avez rien à faire.
</Accordion>
<Accordion title="Un paiement ne figure pas sur le rapport du jour attendu">
Un paiement arrive sur le rapport du jour où il a été reçu. Pour les espèces et les virements, c'est la **Date de réception** que vous avez saisie. Modifiez cette date lors de l'enregistrement, voir [Espèces et virement](/betalingsverwerking/contant).
</Accordion>
<Accordion title="Un paiement Mollie figure sur le rapport suivant">
Le paiement n'était pas dans le versement du rapport. Il passe au brouillon suivant et y reste comme avance jusqu'à ce que Mollie le verse.
</Accordion>
<Accordion title="Le rapport ne figure pas dans ma comptabilité">
Seuls les paiements Mollie et les virements internes sont envoyés. Un rapport ne contenant que des paiements en espèces ou des paiements de compte bancaire n'est pas envoyé. Une erreur d'envoi se trouve dans le **Journal des événements** du rapport.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Systèmes comptables" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Modes de paiement" href="/boekhouden/betalingsrapporten/betaalmethodes" />
</Cards>

## Notions [#begrippen]

- **Rapport de paiement** : le récapitulatif quotidien des paiements d'un seul jour calendaire, avec le numéro `PAYR/année/jour`.
- **Brouillon** : le rapport du jour en cours. Il peut encore changer.
- **Définitif** : la journée est clôturée et le rapport a été envoyé à la comptabilité.
- **Avance** : un paiement Mollie que Mollie n'a pas encore versé.
- **Settlement** : le versement de Mollie en votre faveur.


# Aperçu (/fr-FR/boekhouden)

Ici, vous transférez les paiements et les factures de Tillor vers votre logiciel comptable. Tillor regroupe les paiements par jour dans un rapport de paiement et transmet ce rapport, de sorte que votre comptable n'a rien à retaper.

<Callout type="info" title="Bon à savoir">
- Il y a un rapport de paiement par jour calendaire. Le rapport d'aujourd'hui existe déjà comme **Brouillon** et devient définitif dès que la journée est terminée.
- Tillor traite les rapports chaque jour ouvrable (du lundi au samedi) à 09:00, heure belge.
- Seuls les paiements Mollie et les virements internes partent vers la comptabilité. Les espèces, les virements bancaires et les comptes bancaires figurent bien sur le rapport, mais ne sont pas transmis.
- Les paiements Mollie sont mis à jour toutes les 15 minutes, les comptes bancaires toutes les 5 minutes.
- Mollie verse généralement le lendemain. Le week-end n'obtient souvent un versement que le lundi matin.
- Tillor regroupe les modifications d'un brouillon et l'envoie environ dix secondes après la dernière modification, et au plus tard après une minute.
- Un client belge avec un numéro de TVA a besoin d'un ID Peppol avant que vous puissiez comptabiliser une facture.
</Callout>

## Comment tout cela s'articule-t-il ? [#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 paiement est rattaché à une facture. Voir [Factures](/facturen).
- Chaque paiement arrive sur le rapport du jour où il a été reçu.
- Un paiement Mollie figure d'abord comme avance sur le rapport brouillon. Dès que Mollie verse, cette avance devient le versement réel.
- Le rapport part vers votre logiciel comptable. Les systèmes possibles figurent sous [Systèmes comptables](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Que fait-il ? [#wat-doet-het]

- **Rapports de paiement** : récapitulatifs quotidiens portant le numéro `PAYR/YYYY/DDDD`, où DDDD est le jour de l'année
- **Systèmes comptables** : connexion avec Admisol, Odoo pour les clients et les factures (les rapports de paiement vers Odoo suivront plus tard) et [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) sur demande
- **Modes de paiement** : Mollie, comptes bancaires et virements internes

**Exemple :** le chiffre d'affaires du **20 mai** est versé le **21 mai** et figure sur le rapport **`PAYR/2026/0140` (20 mai)**. Plus d'exemples : [exemples Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

Dans l'application web, vous voyez les paiements et les factures comme ci-dessous.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Liste des paiements - Tous les paiements" />

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Liste des factures - Toutes les factures" />

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Rapports de paiement" href="/boekhouden/betalingsrapporten" />
  <Card title="Systèmes comptables" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Modes de paiement" href="/boekhouden/betalingsrapporten/betaalmethodes" />
  <Card title="TVA et fiscalité" href="/boekhouden/belasting" />
  <Card title="Peppol" href="/boekhouden/peppol" />
  <Card title="Exemples pratiques" href="/praktijk" />
</Cards>

## Notions [#begrippen]

- **Rapport de paiement** : le récapitulatif quotidien des paiements d'un seul jour calendaire.
- **Brouillon** : le rapport du jour en cours, qui peut encore changer.
- **Définitif** : un rapport clôturé qui a été envoyé à la comptabilité.
- **Versement (settlement)** : le montant que Mollie verse sur votre compte bancaire pour une série de paiements.
- **Avance sur Mollie** : de l'argent que Mollie doit encore vous verser, tel qu'il figure en comptabilité.
- **Grand livre** : le numéro de compte dans votre comptabilité. Voir [Produits](/producten).
- **Peppol** : le réseau européen pour envoyer des factures directement au système du destinataire. Voir [Peppol](/boekhouden/peppol).


# Peppol (/fr-FR/boekhouden/peppol)

Avec Peppol, vous envoyez une facture directement au système comptable du destinataire, sans PDF. Peppol est le réseau européen de facturation électronique. Chez Tillor, cela se fait automatiquement : si un client a un ID Peppol, la facture part d'elle-même après la comptabilisation.

## Quand utiliser Peppol ? [#wanneer-gebruik-je-peppol]

Peppol est obligatoire pour :

- **Les factures B2B belges** - l'envoi de factures à des entreprises belges disposant d'un numéro de TVA
- **Les marchés publics** - la facturation aux administrations publiques dans la plupart des pays de l'UE

Pour les clients néerlandais, Peppol est facultatif mais pris en charge.

<Callout type="warn">
À partir de 2026, Peppol est obligatoire pour toutes les factures B2B en Belgique. Veillez à ce que les ID Peppol de vos clients belges soient correctement renseignés.
</Callout>

## Configurer Peppol [#peppol-instellen]

### Peppol pour votre organisation [#peppol-voor-je-organisatie]

Peppol utilise le **numéro de TVA** et l'**adresse** de votre organisation. Vérifiez que ces données sont correctes dans **Paramètres**.

Lors du premier envoi Peppol, Tillor enregistre automatiquement votre organisation comme expéditeur dans le réseau Peppol.

<Callout type="info">
Contactez le support Tillor si Peppol n'est pas encore disponible pour votre organisation.
</Callout>

### Définir l'ID Peppol d'un client [#peppol-id-instellen-voor-een-klant]

Pour chaque client à qui vous voulez facturer via Peppol :

1. Allez dans *Clients > [client] > Facturation*
2. Ouvrez **Paramètres de facturation**
3. Saisissez l'**ID Peppol**, ou choisissez un destinataire via l'icône de recherche
4. Cliquez sur **Enregistrer**

<Callout type="warn">
Vous avez un client belge avec un numéro de TVA ? Vous ne pouvez alors pas comptabiliser de facture tant qu'aucun ID Peppol n'est défini.
</Callout>

## Rechercher un destinataire Peppol [#een-peppol-ontvanger-opzoeken]

Vous ne connaissez pas l'ID Peppol d'un client ? Utilisez l'icône de recherche à gauche du champ :

1. Allez dans *Clients > [client] > Facturation*
2. Cliquez sur l'icône de recherche à gauche de **ID Peppol**
3. Tillor cherche automatiquement à partir du numéro de TVA du client
4. Sélectionnez le bon destinataire parmi les résultats

<Callout type="info">
Toutes les entreprises ne sont pas enregistrées dans le réseau Peppol. Si une entreprise n'est pas trouvée, vous pouvez toujours envoyer la facture par e-mail.
</Callout>

## Envoyer des factures via Peppol [#facturen-via-peppol-versturen]

Lorsqu'un client a un ID Peppol, Tillor envoie automatiquement la facture via Peppol après la comptabilisation :

1. Créez la facture comme d'habitude
2. Vérifiez que l'**ID Peppol** du client est correctement défini
3. Vérifiez les lignes et les montants sur la facture brouillon, puis cliquez sur **Comptabiliser la facture**

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Facture brouillon avec Comptabiliser la facture" />

4. Tillor envoie automatiquement la facture via le réseau Peppol (généralement dans les minutes qui suivent la comptabilisation)

### Vérifier le statut d'envoi [#verzendstatus-controleren]

Ouvrez la facture comptabilisée et consultez **Événements** dans le panneau de droite. Vous y voyez si la facture a été envoyée via Peppol, ou si l'envoi ou la livraison a échoué.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La facture est envoyée automatiquement dès que vous la comptabilisez. Vous n'avez rien à envoyer.
- Une facture envoyée via Peppol reçoit l'étiquette **Envoyée via Peppol** dans la liste du profil client.
- Une telle facture ne peut plus être remise en brouillon ni déplacée vers un autre client. Vous la corrigez avec une note de crédit. Voir [Corriger une facture](/facturen/corrigeren).
- Si l'envoi échoue, vous le voyez dans **Événements** sur la facture et une alerte apparaît sous <UIPath>Communication > Notifications</UIPath>. Envoyez alors la facture par e-mail, voir [Envoyer une facture](/facturen/versturen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="La facture ne peut pas être comptabilisée car le client n'a pas d'ID Peppol">
Le client est belge et a un numéro de TVA. Renseignez l'ID Peppol sous <UIPath>Clients > client > Facturation</UIPath>, **Paramètres de facturation**. Si vous ne connaissez pas l'ID, utilisez l'icône de recherche à gauche du champ.
</Accordion>
<Accordion title="Je ne trouve pas le destinataire dans les résultats de recherche">
Toutes les entreprises ne sont pas raccordées à Peppol. Envoyez alors la facture par e-mail.
</Accordion>
<Accordion title="La facture n'a pas été envoyée via Peppol">
Vérifiez que l'ID Peppol du client est renseigné avant de comptabiliser.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Factures" href="/facturen" description="Créer et comptabiliser des factures" />
  <Card title="TVA et fiscalité" href="/boekhouden/belasting" description="Valider les numéros de TVA" />
  <Card title="Comptabilité" href="/boekhouden" description="Aperçu financier" />
</Cards>


# Envoyer une facture ou un rappel (/fr-FR/communicatie/e-mails)

Avec **Envoyer la notification**, vous envoyez une facture comptabilisée au client. Avec **Envoyer un rappel**, vous rappelez au client une facture impayée. Vous choisissez vous-même par e-mail, SMS, courrier ou WhatsApp, puis vous suivez la remise dans [Notifications](/notificaties).

Tillor n'envoie pas ces messages tout seul lors de la comptabilisation. C'est vous qui décidez quand le client reçoit quelque chose. Si vous voulez que cela se fasse automatiquement, c'est possible avec une [automatisation](/begrippen#automatisering).

Avant de commencer :

- La facture doit être **comptabilisée**. Sur une facture brouillon, le bouton n'apparaît pas.
- Le client a au moins une adresse e-mail, un numéro de téléphone ou une adresse postale complète (rue, code postal et commune). Sinon, vous ne voyez pas **Envoyer la notification**.
- Pour un rappel, un montant doit encore être dû. Une facture payée ne propose pas **Envoyer un rappel**.
- Pour chaque canal, la donnée correspondante doit être connue. Sinon, le canal est grisé, avec le message **Aucune adresse e-mail connue**, **Aucun numéro de téléphone connu** ou **Aucune adresse postale connue**.

## Envoyer une facture [#een-factuur-versturen]

<Steps>
<Step>
### Ouvrir la facture [#open-de-factuur]
Allez dans <UIPath>Administration > Factures</UIPath> et ouvrez une facture comptabilisée.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification-button.png" alt="Facture comptabilisée avec le bouton Envoyer la notification dans la barre d'actions" />
</Step>
<Step>
### Cliquer sur Envoyer la notification [#klik-op-verstuur-notificatie]
La fenêtre **Envoyer la notification** s'ouvre. Choisissez les canaux par lesquels le client reçoit la facture.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification.png" alt="La fenêtre Envoyer la notification avec E-mail, SMS et Courrier" />
</Step>
<Step>
### Choisir les canaux et cliquer sur Envoyer [#kies-de-kanalen-en-klik-op-versturen]
Tillor indique **Notification envoyée**. Si cela échoue, vous voyez **Notification non envoyée**.
</Step>
</Steps>

Les canaux fonctionnent ainsi :

| Canal | Ce que le client reçoit |
|---|---|
| **E-mail** | Activé par défaut. La facture est jointe au message en PDF, à l'adresse e-mail du profil client |
| **SMS** | Un court texte avec le lien personnel vers la facture |
| **Courrier** | La facture sous forme de lettre à l'adresse postale du profil client. Désactivé par défaut. Tillor affiche un montant indicatif d'affranchissement par lettre |
| **WhatsApp** | Apparaît si vous avez connecté WhatsApp Business. Si la fenêtre de 24 heures du client est fermée et que vous n'avez pas de moyen de paiement chez Meta, Tillor bloque l'envoi |

## Envoyer un rappel [#een-aanmaning-versturen]

<Steps>
<Step>
### Ouvrir le menu à côté de Envoyer la notification [#open-het-menu-naast-verstuur-notificatie]
Cliquez sur la flèche à côté du bouton et choisissez **Envoyer un rappel**.
</Step>
<Step>
### Choisir les canaux [#kies-de-kanalen]
Pour un rappel, **SMS** est activé par défaut si le client a un numéro de téléphone. Si vous choisissez **Courrier**, le client reçoit une lettre de rappel avec la facture en pièce jointe et un code QR sur la lettre. Voir [Envoyer une facture](/facturen/versturen).

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Envoi d'un rappel avec le choix du courrier et du recommandé" />
</Step>
<Step>
### Confirmer [#bevestig]
Cliquez sur **Envoyer**. Si vous avez aussi choisi **Courrier recommandé avec accusé de réception**, le bouton indique **Envoyer avec frais supplémentaires**. Cette option n'existe que si le courrier recommandé est pris en charge dans le pays de l'adresse postale. Tillor facture les frais supplémentaires à votre organisation.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le message apparaît dans <UIPath>Communication > Notifications</UIPath> avec le canal, le statut et un lien vers la facture. Vous le voyez aussi chez le client.
- Les e-mails et les SMS démarrent à <Status tone="info">En attente</Status> et passent à <Status tone="success">Envoyé</Status> dès qu'ils sont remis. Le client peut lire le message et cliquer sur le lien. Vous retrouvez les deux dans la fenêtre de détail.
- Pour le courrier, le statut passe à <Status tone="success">Envoyé</Status> dès que le service postal confirme que la lettre est en route ou distribuée. Pour le courrier, vous voyez le montant d'affranchissement au moment de l'envoi et, pour le recommandé, aussi le montant supplémentaire.
- Si un message reste bloqué plus de 5 minutes, Tillor réessaie. Après 2 jours sans envoi, il passe à <Status tone="error">Échec</Status>.
- Si le message échoue, la facture reste comme elle était. Vous pouvez toujours renvoyer.

Vous voulez que Tillor réagisse lui-même, par exemple en prévenant un collègue lorsqu'un rappel échoue ? Vous pouvez pour cela créer une [automatisation](/begrippen#automatisering).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas le bouton Envoyer la notification">
La facture est encore un brouillon, ou le client n'a ni adresse e-mail, ni numéro de téléphone, ni adresse postale complète. Comptabilisez la facture ou complétez l'une de ces données sur le profil client.
</Accordion>
<Accordion title="Je ne vois pas Envoyer un rappel dans le menu">
La facture est déjà payée, ou pas encore comptabilisée. Un rappel n'est possible que pour une facture comptabilisée dont un montant reste dû.
</Accordion>
<Accordion title="Un canal est grisé avec Aucune adresse e-mail connue">
La donnée manque sur le profil client. Ajoutez l'adresse e-mail, le numéro de téléphone ou l'adresse postale et rouvrez la fenêtre.
</Accordion>
<Accordion title="Tillor indique Notification non envoyée">
Ouvrez <UIPath>Communication > Notifications</UIPath> et cliquez sur le canal du message. Le message d'erreur figure dans la fenêtre de détail. Le plus souvent, l'adresse ou le numéro est incorrect. Corrigez-le sur le profil client et renvoyez.
</Accordion>
<Accordion title="Je ne vois pas Recommandé sous Courrier">
L'envoi en recommandé n'est possible que vers des adresses postales dans les pays où Tillor le prend en charge. Pour les autres adresses, le courrier ordinaire reste possible.
</Accordion>
<Accordion title="Le client dit qu'il n'a rien reçu">
Consultez le statut dans <UIPath>Communication > Notifications</UIPath>. Si le message est en **Rejeté**, l'adresse n'existe pas. S'il est en **Envoyé**, demandez au client de vérifier ses courriers indésirables. Voir [Notifications](/notificaties#problemen).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Notifications" href="/notificaties" description="Statut de remise des messages envoyés" />
  <Card title="Types de notification" href="/communicatie/notificatietypes" description="Tous les types de messages que Tillor envoie" />
  <Card title="Envoyer une facture" href="/facturen/versturen" description="Courrier, code QR et lettres de rappel" />
</Cards>


# Aperçu (/fr-FR/communicatie)

Sous Communication, vous suivez tout ce qui se dit ou s'envoie entre votre parc et vos clients : appels téléphoniques, messages envoyés par Tillor et commentaires internes. C'est aussi ici que vous décidez quels messages partent vers un client et que vous voyez s'ils sont arrivés. Les conversations que les clients démarrent par chat ou via les réseaux sociaux se trouvent dans l'[inbox](/inbox).

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Liste des appels téléphoniques dans Communication" />

<Callout type="info" title="Bon à savoir">
- Un message de facture ou un rappel ne part jamais tout seul lors de la comptabilisation. C'est vous qui le lancez, ou une [automatisation](/begrippen#automatisering)
- Si un message reste bloqué plus de 5 minutes, Tillor réessaie. Après 2 jours sans envoi, il passe à **Échec**
- Un SMS avec les coordonnées de l'organisation ne peut être envoyé que pendant un appel en cours, depuis le panneau en bas à droite
- Un nouveau message dans l'inbox apparaît comme une carte en bas à droite et disparaît après une dizaine de secondes
- Les appels téléphoniques n'arrivent qu'une fois Voys installé et le plan d'appel dirigé vers Tillor
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Toute la communication avec un client se rassemble sur le profil client. Ce qui sort et ce qui entre passe par différents canaux.

```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
```

- Les **appels** arrivent via votre fournisseur de téléphonie et sont rattachés au client par le numéro de téléphone.
- Les **messages de clients** par chat ou réseaux sociaux arrivent dans l'inbox.
- Les **messages vers les clients** s'envoient depuis une facture. Vous suivez la remise sous Notifications.
- Les **commentaires** sont internes. Les clients ne les voient pas.

## Composants [#onderdelen]

<Cards>
  <Card title="Inbox" href="/inbox" description="WhatsApp, Messenger, Instagram et chat du site web au même endroit" />
  <Card title="Appels téléphoniques" href="/communicatie/telefoongesprekken" description="Suivre les appels, écouter les enregistrements et envoyer des informations par SMS" />
  <Card title="Envoyer une facture ou un rappel" href="/communicatie/e-mails" description="Envoyer soi-même un message à un client" />
  <Card title="Notifications" href="/notificaties" description="Consulter le statut de remise des messages envoyés" />
  <Card title="Types de notification" href="/communicatie/notificatietypes" description="Tous les types de messages et quand ils partent" />
  <Card title="Commentaires" href="/notities" description="Commentaires internes sur les clients, les factures et d'autres enregistrements" />
  <Card title="Fournisseurs" href="/communicatie/providers" description="Voys et Twilio : qui appelle et qui envoie les SMS" />
</Cards>

## Notions [#begrippen]

- **Fournisseur de téléphonie** : l'entreprise qui fournit votre ligne téléphonique, par exemple Voys.
- **Notification** : un message que Tillor envoie à un client ou à un [utilisateur](/begrippen#gebruiker).
- **Canal** : la voie par laquelle passe un message, comme l'e-mail, le SMS, le courrier ou WhatsApp.
- **Inbox** : l'endroit où arrivent les messages des clients par chat et réseaux sociaux.
- **Commentaire** : une note interne sur un [client](/begrippen#klant), une facture ou un autre enregistrement.

D'autres termes figurent dans le [glossaire](/begrippen).


# Types de notification (/fr-FR/communicatie/notificatietypes)

Cette liste présente chaque type de message que vous pouvez rencontrer dans la [liste des notifications](/notificaties), et quand Tillor l'envoie. Vous voyez le type dans la colonne **Type** et pouvez filtrer dessus avec le filtre **Type**. Les noms correspondent à l'écran.

Les messages aux clients partent par e-mail, SMS, courrier ou WhatsApp. Les messages aux collègues partent par push, e-mail ou téléphone, selon les préférences de ce collègue. Voir [Alertes dans l'application](/notificaties#meldingen-in-de-app).

<Callout type="info" title="Les messages de facture ne partent pas tout seuls">
Des messages comme **Nouvelle Facture** ou **Rappel de Facture** ne sont pas envoyés automatiquement par Tillor lors de la comptabilisation d'une facture. C'est vous qui les lancez avec **Envoyer la notification** ou **Envoyer un rappel** sur la facture. Voir [Envoyer une facture ou un rappel](/communicatie/e-mails).
</Callout>

## Factures et paiements [#facturen-en-betalingen]

| Type | Quand il est envoyé |
|---|---|
| Nouvelle Facture | Au client, lorsque vous envoyez une facture. La facture est jointe au message |
| Facture Payée | Au client, lorsqu'une facture est payée |
| Rappel de Facture | Au client, comme rappel pour une facture impayée |
| Rappel de Virement Bancaire Manuel | Au client qui paie par virement, avec le conseil d'utiliser la communication structurée |
| Archive de Factures | À l'adresse de support de votre organisation, avec votre comptable en copie, lorsqu'une archive de factures est prête |
| Échec de l'envoi de facture Peppol | Lorsqu'une facture n'a pas pu être envoyée via Peppol |
| Échec de l'envoi de la facture vers le logiciel comptable | Lorsque la transmission d'une facture vers votre logiciel comptable échoue |
| Envoi de la facture vers le logiciel comptable rétabli | Lorsque cette transmission a finalement réussi après des alertes précédentes |
| Échec de l'envoi du rapport de paiement vers le logiciel comptable | Lorsque la transmission d'un rapport de paiement échoue |
| Factures rétablies recomptabilisées | Lorsque des factures rétablies ont été recomptabilisées automatiquement dans la nuit |
| Paiement bancaire ne soldant pas la facture | Lorsqu'un paiement bancaire est lié à une facture, mais que la facture reste ensuite impayée |
| Consommation bien au-dessus de l'habitude, retenue hors facturation automatique | Lorsqu'un client n'a pas été facturé automatiquement parce que l'électricité ou l'eau est très au-dessus de l'habitude |
| Prix de produit planifié appliqué | À votre organisation, le jour où un [prix planifié](/producten/prijzen-plannen) entre en vigueur. L'ancien et le nouveau prix figurent côte à côte |
| Remboursement auto démarrage machine | Lorsqu'un paiement en ligne pour le démarrage d'une machine a été remboursé parce que la machine n'a pas démarré |
| Vérification des paiements NFC hors ligne | Lorsque des paiements NFC hors ligne n'ont pas pu être vérifiés après la synchronisation |
| Solde Bas Tag NFC | Au client lorsque le solde d'un tag NFC est bas |

## Mandats SEPA et signature [#sepa-mandaten-en-ondertekenen]

| Type | Quand il est envoyé |
|---|---|
| Demande de signature de mandat SEPA | Au client avec le lien pour signer le mandat, y compris pour les rappels avant l'expiration du lien |
| Code de vérification du mandat SEPA | Au client avec le code qu'il saisit sur la page de signature, par SMS ou e-mail |
| Copie du mandat SEPA signé | Au client, dès que le mandat est actif |
| Mandat SEPA révoqué | Au client, avec une nouvelle fois le document signé |
| Demande de signature | À un signataire lorsque c'est son tour, par e-mail ou par SMS s'il n'y a pas d'adresse e-mail |
| Code de signature | Au signataire avec le code pour signer, par SMS ou e-mail |
| Document signé | À tous les signataires avec le PDF signé, dès que le dernier a signé |
| Signature refusée | Au collègue qui a envoyé la demande, lorsqu'un signataire refuse |
| Acceptation du DPA | Confirmation de l'acceptation du DPA, avec le DPA signé en pièce jointe |
| Code de vérification DPA | Par SMS au responsable avec le code pour accepter l'accord de traitement des données |

## Compteurs, contrôleurs et accès [#meters-controllers-en-toegang]

| Type | Quand il est envoyé |
|---|---|
| Alarme de compteur | Lorsqu'un compteur a une nouvelle alarme |
| Alarme de compteur résolue | Lorsqu'une alarme de compteur a été résolue |
| Suppression de Compteur | Lorsque des compteurs ont été supprimés |
| Compteurs nécessitant une attention | Récapitulatif des compteurs dont les relevés n'arrivent plus ou qui ont une alarme depuis longtemps |
| Contrôleur hors ligne | Lorsqu'un contrôleur ne donne plus signe de vie depuis plus de 5 minutes |
| Contrôleur en surchauffe | Alerte urgente lorsqu'un contrôleur devient trop chaud |
| Connecteur hors ligne | Lorsque le connecteur de votre parc ne donne plus signe de vie |
| Connecteur de nouveau en ligne | Lorsque le connecteur est de nouveau joignable |
| Passerelle HTTP du connecteur hors service | Lorsque le connecteur fonctionne encore, mais que les caméras ne l'atteignent plus |
| Caméra LPR hors ligne | Lorsqu'une caméra de plaques d'immatriculation ne répond plus depuis plus de 5 minutes |
| Point d'accès ouvert trop longtemps | Lorsqu'un point d'accès reste ouvert plus longtemps que permis |
| Récapitulatif des sorties de plaques expirées | Résumé des véhicules dont la période d'accès avait expiré et qui sont sortis alors que la réception était fermée |
| QR code d'accès | Au client avec le code QR pour l'accès |
| Tablette ou borne hors ligne | Lorsqu'une tablette ou une borne ne donne plus signe de vie en dehors de sa période de veille |
| Batterie de tablette ou de borne faible | Lorsqu'une tablette ou une borne est presque vide et ne charge pas |

## Tâches, commentaires et inbox [#taken-opmerkingen-en-inbox]

| Type | Quand il est envoyé |
|---|---|
| Tâche assignée | Au collègue à qui une tâche est assignée |
| Tâche désassignée | Au collègue à qui une tâche est retirée |
| Tâche terminée | Lorsqu'une tâche est terminée |
| Rappel de Tâche | Lorsque le moment de rappel d'une tâche est atteint |
| Échéance de tâche | Lorsqu'une tâche atteint son échéance sans être terminée |
| Résumé quotidien d'une vue | Par e-mail, le résumé quotidien d'une vue de tâches que vous suivez |
| Réponse au Commentaire | Quelqu'un a répondu à un commentaire |
| Mention dans Commentaire | Vous avez été mentionné dans un commentaire |
| Commentaire Résolu | Un commentaire a été marqué comme résolu |
| Réponse au commentaire refusée | Lorsqu'une réponse par e-mail à un commentaire n'a pas été publiée parce que l'adresse de l'expéditeur ne correspond pas |
| Message inbox | Lorsqu'un nouveau message arrive dans l'inbox |
| Transfert IA urgent | Lorsque l'assistant IA vous transfère une conversation urgente |
| Relance chat du site web | À un visiteur du site avec une réponse non lue, avec un lien pour reprendre la conversation |

## Automatisations et intégrations [#automatiseringen-en-integraties]

| Type | Quand il est envoyé |
|---|---|
| Message d'automatisation | Texte qu'une automatisation envoie à un client |
| Notification d'automatisation | Alerte qu'une automatisation envoie à un collègue, par push, e-mail ou les deux |
| Exécution d'automatisation échouée | Au créateur d'une automatisation lorsqu'une exécution s'est terminée par une erreur |
| Échec de livraison webhook | Lorsque les livraisons à votre webhook échouent et que Tillor continue d'essayer |
| Livraison webhook définitivement échouée | Lorsque Tillor n'a pas pu livrer un événement webhook après toutes les tentatives |
| Notification externe | Message qu'un système connecté a lui-même envoyé, voir [Notifications externes](/notificaties#externe-notificaties) |

Un webhook est une connexion par laquelle Tillor transmet automatiquement un événement à un autre système.

## Compte et organisation [#account-en-organisatie]

| Type | Quand il est envoyé |
|---|---|
| Bienvenue Utilisateur | Message de bienvenue pour un nouvel utilisateur |
| Vérification de l'e-mail | Le lien pour confirmer une adresse e-mail |
| Invitation à l'organisation | Invitation pour une personne sans compte Tillor à rejoindre votre organisation |
| Détails de l'Organisation | SMS à un appelant avec un lien vers les coordonnées de votre organisation |
| Soumission du Formulaire de Contact | Lorsque quelqu'un remplit le formulaire de contact |
| Rappel des horaires pour un jour férié | Rappel pour renseigner les horaires d'ouverture d'un prochain jour férié |
| Document Supprimé | À l'utilisateur qui a supprimé un document |

## Alertes de l'équipe Tillor [#meldingen-van-het-tillor-team]

Ces messages sont destinés à l'équipe Tillor et vous ne les voyez normalement pas : **Incident Système**, **Alerte de sécurité**, **Alerte Grafana** et **Panne de passerelle LoRa**.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Notifications" href="/notificaties" description="Statut de remise et alertes dans l'application" />
  <Card title="Envoyer une facture ou un rappel" href="/communicatie/e-mails" description="Envoyer soi-même un message" />
  <Card title="Automatisations" href="/automatiseringen" description="Messages envoyés par une automatisation" />
</Cards>


# Aperçu (/fr-FR/communicatie/providers)

Via un fournisseur de téléphonie comme Voys, Tillor voit qui appelle et conserve les appels, les enregistrements et les transcriptions. Vous connectez le fournisseur via <UIPath>Paramètres > Intégrations</UIPath>. Twilio n'est pas un fournisseur de téléphonie : il envoie les SMS de Tillor et a été configuré par Tillor lui-même.

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Paramètres > Intégrations" />

## Fournisseurs disponibles [#beschikbare-providers]

<Cards>
  <Card
    title="Voys"
    href="/communicatie/providers/voys"
    description="Associez les appels téléphoniques entrants aux profils clients"
  />
  <Card
    title="Twilio"
    href="/communicatie/providers/twilio"
    description="Envoi de SMS et de WhatsApp via un réglage de la plateforme"
  />
  <Card title="Inbox" href="/inbox" description="Messenger et WhatsApp Business pour l'inbox omnicanal" />
</Cards>


# Twilio (/fr-FR/communicatie/providers/twilio)

Twilio envoie pour le compte de Tillor les SMS et, si c'est configuré, les notifications WhatsApp. Ce n'est pas un fournisseur de téléphonie comme Voys et vous ne l'installez pas vous-même : Tillor l'a configuré pour toute la plateforme.

## Différence avec Voys [#verschil-met-voys]

| | Voys | Twilio |
|---|---|---|
| Téléphonie (appeler, appels) | Oui | Non |
| Configuration dans Tillor | **Paramètres > Intégrations** | Non - réglage de la plateforme |
| Visible pour les utilisateurs | Appels, enregistrements, transcriptions | SMS et notifications WhatsApp envoyés |

## Que fait Twilio dans Tillor ? [#wat-doet-twilio-in-tillor]

Dès que Twilio est configuré, Tillor l'utilise notamment pour :

- **Envoyer des notifications SMS** (par exemple rappels de paiement, confirmations de réservation et notifications de facture)
- **Envoyer les coordonnées de l'organisation par SMS** depuis **Communication > Appels téléphoniques** (bouton SMS avec l'infobulle **Envoyer les détails de l'organisation à l'appelant par SMS**)
- **Remettre les notifications WhatsApp** lorsque WhatsApp est configuré via Twilio sur la plateforme
- **Utiliser des codes de vérification par SMS** lors de la signature de l'accord de traitement des données (DPA)

Vous suivez les SMS et les notifications WhatsApp envoyés dans **Communication > Notifications** :

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Liste des notifications - statut de remise des messages" />

<Callout type="info">
Vous ne configurez pas Twilio vous-même dans Tillor. Demandez à l'administrateur de votre plateforme ou au support Tillor la bonne connexion pour votre environnement.
</Callout>

## Pas d'installation dans Intégrations [#geen-installatie-in-integraties]

Contrairement à Voys, vous ne trouvez **pas** Twilio sous **Paramètres > Intégrations**. La connexion est gérée par l'administrateur de l'environnement Tillor.

## Voir aussi [#zie-ook]

<Cards>
  <Card
    title="Téléphonie Voys"
    href="/communicatie/providers/voys"
    description="Intégration de téléphonie pour les appels"
  />
  <Card
    title="Appels téléphoniques"
    href="/communicatie/telefoongesprekken"
    description="Envoyer les coordonnées de l'organisation par SMS"
  />
</Cards>


# Téléphonie Voys (/fr-FR/communicatie/providers/voys)

Avec l'intégration Voys, Tillor voit qui appelle et affiche aussitôt les données du client. Les appels, enregistrements et transcriptions arrivent ensuite sous [Appels téléphoniques](/communicatie/telefoongesprekken). Voys est un fournisseur de téléphonie pour les entreprises.

Avant de commencer :

- Vous avez besoin d'un compte VoIP Voys actif et d'un accès aux réglages du plan d'appel dans Voys.
- Vous avez besoin du droit **Gérer les intégrations**.
- Le numéro de téléphone de l'appelant doit figurer sur la fiche client ou chez une personne de contact, sinon Tillor ne relie pas l'appel à un client.

<DocScreenshot src="/screenshots/communicatie/providers/voys/incoming-call.png" alt="Appel entrant sur le tableau de bord" />

## Configurer Voys [#voys-instellen]

1. Allez dans **Paramètres** (barre latérale, sous **Support**)

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-nav.png" alt="Navigation vers Paramètres" />

2. Choisissez **Intégrations** et ouvrez **Voys** dans la liste
3. Sur la page de détail, saisissez vos données Voys (`username`, `password`, `client_uuid`, `token`) et cliquez sur **Installer**

Vous avez besoin d'un compte VoIP Voys actif.

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-voys.png" alt="Paramètres > Intégrations - Voys dans la liste" />

<Callout type="info">
Après l'installation et la configuration, Tillor relie automatiquement les appels aux clients lorsque le numéro de téléphone correspond à un client ou à un contact.
</Callout>

## Retrouver les URL pour Voys [#urls-voor-voys-terugvinden]

Tillor et Voys communiquent par des adresses (URL). À certaines étapes, Voys attend une réponse de Tillor, par exemple pour savoir si vous êtes ouvert. Cette réponse est **ACK** (oui, continuer) ou **NAK** (non, suivre l'autre chemin). Un webhook est une adresse que Voys appelle pendant un appel.


Pour les webhooks, la recherche du nom de l'appelant et les codes d'accès, vous utilisez les URL que Tillor génère pour vous.

1. Allez dans **Paramètres > Intégrations** et ouvrez **Voys**
2. Après l'installation, le bloc **URLs à configurer** se trouve sur la page de détail, sous **Paramètres** - copiez-y l'URL qui correspond à chaque usage

Vous y trouvez notamment :

- **Notifications de conversation** - URL de webhook pour les événements d'appel
- **Webhook pour recherche d'appelant** - URL pour la recherche du nom de l'appelant dans votre plan d'appel Voys
- **XML Phonebook** - URL permettant aux téléphones VoIP de récupérer l'annuaire
- **Codes d'accès** - URL pour commander le point d'accès (barrière, portail ou porte) via le plan d'appel
- **Webhook des heures d'ouverture** - ACK si Tillor est ouvert, NAK si Tillor est fermé
- **Webhook appelant autorisé** - ACK si l'appel peut être transféré, NAK si l'appelant doit aller à la messagerie vocale
- **Webhook de routage** - ACK avec une destination, NAK si aucune destination n'est définie

Dans le plan d'appel Voys, utilisez les mêmes variables que celles indiquées dans Tillor (comme `{callerid}`, `{did}`, `{callername}`, `{callid}` et `{code}`).

<DocScreenshot src="/screenshots/communicatie/providers/voys/config-urls-dialog.png" alt="Détail Voys - URLs à configurer sur la page" />

## Configurer les notifications d'appel dans Voys [#gespreksnotificaties-in-voys-configureren]

1. Dans Voys, ouvrez le module [Notifications d'appel](https://freedom.voys.nl/redirect/CallNotification)
2. Cliquez sur **Ajouter**
3. Pour le package/service, choisissez **Personnalisé**
4. Collez l'URL Tillor depuis **Notifications de conversation**
5. Enregistrez

Documentation Voys :

- [Notifications d'appel](https://help.voys.nl/gespreksnotificaties)

## Configurer les noms d'appelants (caller lookup) dans le plan d'appel [#bellernamen-caller-lookup-in-call-plan-configureren]

Pour la recherche du nom de l'appelant, vous utilisez dans Voys une étape webhook du plan d'appel.

1. Dans Tillor, ouvrez l'URL **Webhook pour recherche d'appelant** (sur **Paramètres > Intégrations > Voys**, sous **URLs à configurer**) et copiez-la
2. Dans Voys, ouvrez le module [Webhooks](https://help.voys.nl/webhooks) et créez un webhook avec ce modèle d'URL
3. Activez ce webhook dans votre plan d'appel via l'étape webhook
4. Dans le modèle d'URL, utilisez les variables prises en charge par Voys (`{callerid}`, `{did}`, `{callername}` et si nécessaire `{code}`)
5. Dans le routage du webhook, définissez **Variable nom de l'appelant** pour que le nom renvoyé s'affiche sur les appareils

Les webhooks des heures d'ouverture et de routage ne recherchent pas le nom de l'appelant. Utilisez pour cela cette étape distincte.

Pour en savoir plus :

- [Webhooks](https://help.voys.nl/webhooks)
- [Que sont les notifications d'appel (différence avec les webhooks)](https://help.voys.nl/gespreksnotificaties)

## Heures d'ouverture et destinations dans le plan d'appel [#openingsuren-en-bestemmingen-in-het-belplan]

Tillor est la source pour les heures d'ouverture, les vacances et les exceptions des jours fériés. Voys n'a plus besoin de connaître ce calendrier.

1. Sur **Paramètres > Intégrations > Voys**, choisissez l'appareil Voys pour **ouvert** et, en option, pour **fermé**
2. Copiez **Webhook des heures d'ouverture** ou **Webhook de routage** depuis **URLs à configurer**
3. Dans Voys, créez un [webhook](https://help.voys.nl/webhooks) avec ce modèle d'URL
4. Placez ce webhook comme étape du plan d'appel, **au-dessus** d'éventuels menus à choix
5. Laissez **Utiliser le menu** désactivé

Deux modèles :

- **Webhook des heures d'ouverture** - `status=ACK` suit le chemin **HTTP et menu réussis** (ouvert), `status=NAK` suit **HTTP ou menu échoué** (fermé). Si une destination d'ouverture est définie, elle est transmise avec ACK sous `destination`.
- **Webhook de routage** - Tillor choisit la destination. Dans l'étape réussie, définissez **Variable destination finale**. ACK + `destination` s'il y a une destination, sinon NAK.

En cas d'erreur ou de dépassement de délai, Voys prend le chemin d'échec. Considérez-le comme fermé.

Documentation Voys : [Webhooks](https://help.voys.nl/webhooks).

## Envoyer automatiquement des appelants vers la messagerie vocale [#bellers-automatisch-naar-voicemail-sturen]

Avec le **Webhook appelant autorisé**, vous laissez Voys décider, appelant par appelant, si un appel est transféré. Tillor vérifie si le numéro de l'appelant appartient à un client pour lequel la messagerie automatique est activée.

Commencez par configurer le plan d'appel :

1. Copiez **Webhook appelant autorisé** depuis **URLs à configurer** sur **Paramètres > Intégrations > Voys**
2. Dans Voys, créez un [webhook](https://help.voys.nl/webhooks) avec ce modèle d'URL
3. Placez ce webhook comme étape du plan d'appel, **au-dessus** des étapes qui transfèrent l'appel
4. Laissez **Utiliser le menu** désactivé
5. Dirigez le chemin **HTTP et menu réussis** vers votre routage habituel et le chemin **HTTP ou menu échoué** vers la messagerie vocale
6. Sur **Paramètres > Intégrations > Voys**, sous **Routage des appels**, cochez **Messagerie automatique dans Voys**

Tant que cette option est désactivée, vous ne voyez pas **Envoyer les appels vers la messagerie vocale** sur la fiche client.

Activez ensuite la messagerie automatique client par client :

1. Ouvrez la fiche client et allez dans l'onglet **Communication**
2. Dans **Paramètres de communication**, cochez l'option **Envoyer les appels vers la messagerie vocale**
3. Cliquez sur **Enregistrer**

Voici comment fonctionne la réponse :

- **ACK** - l'appelant peut passer. C'est aussi le cas pour les numéros inconnus et pour les appelants au numéro masqué.
- **NAK** - le numéro appartient à un client avec messagerie automatique. Voys suit le chemin d'échec.

Tillor compare le numéro de l'appelant au numéro de téléphone de la fiche client, quels que soient les espaces ou la notation de l'indicatif du pays. Les numéros de téléphone des personnes de contact ne comptent pas.

<Callout type="warn">
En cas d'erreur ou de dépassement de délai, Voys prend aussi le chemin d'échec. Tous les appelants vont alors temporairement à la messagerie vocale, pas seulement ceux qui sont bloqués. Utilisez donc une destination de messagerie vocale dont vous consultez régulièrement les messages.
</Callout>

Ce webhook ne tient pas compte des heures d'ouverture. Combinez-le avec le webhook des heures d'ouverture ou de routage en les plaçant comme étapes distinctes dans le plan d'appel.

Documentation Voys : [Webhooks](https://help.voys.nl/webhooks).

## Routage fixe par appelant [#vaste-routering-per-beller]

Le même **Webhook de routage** peut transférer directement un appelant vers un appareil Voys, un numéro interne ou un numéro de téléphone précis. Cela ne vaut que pour les clients pour lesquels vous avez choisi une destination, et seulement si **Routage d'appel fixe dans Voys** est activé.

1. Placez le **Webhook de routage** dans le plan d'appel, comme pour les heures d'ouverture
2. Dans l'étape réussie, définissez **Variable destination finale**
3. Sur **Paramètres > Intégrations > Voys**, sous **Routage des appels**, cochez **Routage d'appel fixe dans Voys**

Tant que cette option est désactivée, vous ne voyez pas **Routage d'appel fixe** sur la fiche client. Le webhook utilise alors uniquement l'appareil pour ouvert ou fermé.

Définissez ensuite la destination client par client :

1. Ouvrez la fiche client et allez dans l'onglet **Communication**
2. Sous **Routage d'appel fixe**, choisissez un appareil Voys, ou **Autre** pour un numéro de téléphone ou un numéro interne (par exemple 411)
3. Choisissez **Aucun** pour désactiver le routage fixe
4. Cliquez sur **Enregistrer**

Voici comment le webhook de routage choisit la destination :

- Si une destination fixe existe pour cet appelant, c'est `destination`.
- Sinon, `destination` est l'appareil Voys pour ouvert ou fermé.
- **NAK** - il n'y a pas de destination fixe ni d'appareil pour l'état actuel. C'est aussi le cas pour les numéros inconnus et les appelants au numéro masqué, tant qu'il n'y a pas d'appareil pour ouvert ou fermé.

Tillor compare le numéro de l'appelant au numéro de téléphone de la fiche client, quels que soient les espaces ou la notation de l'indicatif du pays. Les numéros de téléphone des personnes de contact ne comptent pas.

En cas d'erreur ou de dépassement de délai, Voys prend le chemin d'échec.

Documentation Voys : [Webhooks](https://help.voys.nl/webhooks).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Chaque appel qui arrive ou part figure dans <UIPath>Communication > Appels téléphoniques</UIPath>, avec le client si le numéro correspond. Voir [Appels téléphoniques](/communicatie/telefoongesprekken).
- Lors d'un appel entrant, l'appelant apparaît sous forme de carte en bas à droite dans Tillor, avec les données du client.
- Les enregistrements et transcriptions arrivent dès que l'appel est terminé, si les enregistrements d'appels sont activés dans votre compte Voys.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas le bloc URLs à configurer">
Le bloc n'apparaît qu'après l'installation. Cliquez d'abord sur **Installer** sur la page de détail de Voys.
</Accordion>
<Accordion title="Aucun appel n'arrive dans Tillor">
Voys ne transmet les appels que si le module Notifications d'appel utilise l'URL **Notifications de conversation** de Tillor. Vérifiez dans Voys que cette URL est présente et qu'elle provient du bloc **URLs à configurer**.
</Accordion>
<Accordion title="Le nom de l'appelant n'apparaît pas sur l'appareil">
Vérifiez que le webhook de recherche du nom de l'appelant figure dans le plan d'appel et que **Variable nom de l'appelant** est définie dans l'étape réussie. Les webhooks des heures d'ouverture et de routage ne recherchent pas de noms.
</Accordion>
<Accordion title="Je ne vois pas Envoyer les appels vers la messagerie vocale sur la fiche client">
Cochez d'abord **Messagerie automatique dans Voys** sous <UIPath>Paramètres > Intégrations > Voys</UIPath>, dans **Routage des appels**. L'option apparaît ensuite dans l'onglet **Communication** du client. Il en va de même pour **Routage d'appel fixe**.
</Accordion>
<Accordion title="Tous les appelants vont soudain à la messagerie vocale">
En cas d'erreur ou de dépassement de délai d'un webhook, Voys prend le chemin d'échec. Vérifiez que Tillor est joignable et que l'URL du webhook est toujours correcte. Voir l'avertissement sous [Envoyer automatiquement des appelants vers la messagerie vocale](#bellers-automatisch-naar-voicemail-sturen).
</Accordion>
<Accordion title="Un appel n'est pas rattaché à un client">
Tillor compare le numéro au numéro de téléphone de la fiche client. Les numéros des personnes de contact comptent pour relier les appels, mais pas pour la messagerie vocale ni le routage fixe.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card
    title="Appels téléphoniques"
    href="/communicatie/telefoongesprekken"
    description="Actions sur les appels, comme les coordonnées de l'organisation par SMS"
  />
  <Card title="Gestion des clients" href="/klantenbeheer" description="Fiches clients et coordonnées" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Comment les SMS sont envoyés" />
</Cards>


# Appels téléphoniques (/fr-FR/communicatie/telefoongesprekken)

Sous <UIPath>Communication > Appels téléphoniques</UIPath> figure chaque appel qui arrive ou part via votre fournisseur de téléphonie, avec le client si Tillor reconnaît le numéro. Vous utilisez cette page pour suivre les appels et, pendant un appel en cours, envoyer par SMS les coordonnées de votre organisation à l'appelant.

Avant de commencer :

- Les appels n'apparaissent qu'après l'installation et la configuration de [Voys](/communicatie/providers/voys). Sans liaison, la liste reste vide.
- Les enregistrements et transcriptions n'existent que si les enregistrements d'appels sont activés dans votre compte Voys.
- Le bouton SMS d'un appel en cours ne fonctionne que si l'envoi de SMS est configuré pour votre environnement. Voir [Twilio](/communicatie/providers/twilio).

## Consulter les appels [#gesprekken-bekijken]

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Aperçu des appels téléphoniques" />

Dans le tableau **Tous les appels**, vous voyez pour chaque appel :

| Colonne | Ce que vous voyez |
|---|---|
| **Direction** | **Entrant** ou **Sortant** |
| **Démarré le** | Date et heure |
| **De** et **Vers** | Les numéros de téléphone |
| **Durée** | La durée de l'appel, une fois terminé |
| **Client** | Le client relié, ou un nom transmis par Voys (non vérifié) si aucun client ne correspond |
| **Statut** | Où en est l'appel |

Tillor relie un appel à un client d'après le numéro de téléphone. Si le numéro n'appartient pas encore à un client, ajoutez-le à la fiche client ou à une personne de contact. Les nouveaux appels seront ensuite reliés automatiquement.

Un appel passe par ces statuts :

| Statut | Signification |
|---|---|
| <Status tone="info">Création</Status> | L'appel vient de démarrer |
| <Status tone="info">Sonnerie</Status> | Le téléphone sonne |
| <Status tone="warning">Répondu</Status> | Quelqu'un a décroché |
| <Status tone="warning">En cours</Status> | L'appel est en cours |
| <Status tone="warning">Transfert assisté</Status> et <Status tone="warning">Transfert direct</Status> | L'appel a été transféré, avec ou sans annonce |
| <Status>Raccroché</Status> et <Status>Terminé</Status> | L'appel est terminé |
| <Status tone="error">Échec</Status> | L'appel n'a pas abouti |

## Envoyer les coordonnées de l'organisation par SMS [#organisatiegegevens-via-sms-versturen]

Un appelant demande votre adresse ou vos horaires d'ouverture ? Envoyez-les par SMS en quelques secondes, pendant l'appel.

<Steps>
<Step>
### Attendez que l'appel soit en cours [#wacht-tot-het-gesprek-loopt]
L'action se trouve sur le panneau des appels actifs en bas à droite, pas dans la liste. L'appel doit avoir le statut **En cours**. Sur un téléphone, touchez d'abord l'icône de téléphone en haut à droite.
</Step>
<Step>
### Développez l'appel [#klap-het-gesprek-uit]
Si l'appel est réduit, développez-le.
</Step>
<Step>
### Cliquez sur l'icône de message [#klik-op-het-berichtenpictogram]
L'infobulle indique **Envoyer les détails de l'organisation à l'appelant par SMS**.
</Step>
<Step>
### Choisissez la langue [#kies-de-taal]
Tillor marque la langue qu'il reconnaît chez l'appelant avec *(détectée)*. Choisissez la langue du SMS.
</Step>
</Steps>

L'appelant reçoit un lien court vers une page publique avec les coordonnées de votre organisation. Si l'adresse de votre organisation est renseignée, la page contient aussi des boutons d'itinéraire pour **Waze**, **Google Maps** et **Apple Maps**. Le bouton e-mail de cette page a déjà un objet et un texte, avec le numéro et l'heure de l'appel s'ils sont connus. Le lien du site web reçoit des balises de suivi, pour mesurer combien d'appelants cliquent.

## Enregistrements et transcriptions [#opnames-en-transcripties]

<Steps>
<Step>
### Ouvrez l'appel [#open-het-gesprek]
Dans la liste, cliquez sur **Transcription** à côté de l'appel. La fenêtre **Détails de l'appel** s'ouvre.
</Step>
<Step>
### Choisissez un onglet [#kies-een-tabblad]
Sur **Enregistrement**, l'appel se lit dans votre navigateur. Sur **Transcription**, vous trouvez le texte retranscrit par interlocuteur, et sur **Résumé** un court résumé.
</Step>
</Steps>

Tillor crée lui-même la transcription et le résumé dès que l'appel est terminé et qu'un enregistrement existe. Cela prend un moment. Pour un appel sans enregistrement, il n'y a pas d'onglets.

<Callout type="warn">
Les enregistrements d'appels peuvent contenir des informations sensibles pour la vie privée. Veillez à respecter la législation sur la vie privée (RGPD) lors de l'enregistrement des appels et informez les appelants que les appels sont enregistrés.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une fois terminé, un appel figure dans la liste avec sa durée, le client et, s'il y a un enregistrement, une transcription et un résumé.
- Un SMS envoyé avec les coordonnées de l'organisation figure dans <UIPath>Communication > Notifications</UIPath> avec le type **Détails de l'Organisation**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="La liste des appels est vide">
Vérifiez que Voys est installé sous <UIPath>Paramètres > Intégrations</UIPath> et que les notifications d'appel dans Voys pointent vers l'URL de Tillor. Voir [Téléphonie Voys](/communicatie/providers/voys).
</Accordion>
<Accordion title="Un appel n'est pas rattaché à un client">
Tillor compare le numéro de l'appelant au numéro de téléphone de la fiche client ou d'une personne de contact. Ajoutez le numéro et les nouveaux appels seront reliés. Les appels déjà arrivés restent tels quels.
</Accordion>
<Accordion title="Je ne trouve pas le bouton SMS">
Le bouton se trouve uniquement sur le panneau des appels actifs en bas à droite, et seulement tant que l'appel a le statut **En cours**. Il n'est pas dans la liste de cette page.
</Accordion>
<Accordion title="Je ne vois pas d'onglet Enregistrement">
Voys n'a pas enregistré l'appel. Activez les enregistrements d'appels dans votre compte Voys. Les appels précédents ne peuvent pas être enregistrés après coup.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Téléphonie Voys" href="/communicatie/providers/voys" description="Installer Voys et configurer le plan d'appel" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Comment les SMS sont envoyés" />
  <Card title="Notifications" href="/notificaties" description="Statut de remise des SMS envoyés" />
</Cards>


# Connecteur (/fr-FR/connector)

Le Connecteur Tillor est un petit boîtier dans le réseau de votre parc. Il relie Tillor aux appareils sur place : imprimantes de tickets, barrières, contrôleurs d'accès et lecteurs d'identité. Sans connecteur, Tillor ne peut pas commander ces appareils. S'il est éteint, l'impression et la commande des barrières depuis Tillor ne fonctionnent pas. Pour savoir comment continuer dans ce cas, voir [Problèmes](#problemen).

Tillor livre le connecteur préconfiguré et le surveille à distance. Vous n'avez rien à installer ni à mettre à jour.

<Callout type="info" title="Bon à savoir">
- Chaque organisation a un seul connecteur. Si vous gérez plusieurs parcs, chaque parc (organisation) reçoit son propre boîtier.
- Le connecteur se signale à Tillor toutes les 15 secondes.
- Si Tillor n'entend plus rien pendant 3 minutes, l'équipe Tillor reçoit automatiquement une alerte.
- Tillor installe lui-même les mises à jour, sans rien vous demander.
- Le connecteur établit lui-même une connexion sécurisée sortante. Vous n'avez pas à ouvrir de ports sur votre routeur.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Le connecteur se place entre Tillor sur internet et les appareils de votre propre réseau. Tillor envoie une commande au connecteur, et le connecteur l'exécute sur le bon appareil. Dans l'autre sens, le connecteur signale ce qui s'est passé, par exemple une plaque d'immatriculation lue.

```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]
```

Par exemple :

- Vous imprimez un ticket ou une étiquette. Tillor l'envoie au connecteur, qui le transmet à votre imprimante.
- Vous donnez une méthode d'accès à un client. Tillor envoie la modification via le connecteur aux contrôleurs d'accès, voir [Contrôle d'accès](/toegangscontrole#hoe-hangt-dit-samen).
- Un client scanne une pièce d'identité à l'enregistrement. Le connecteur transmet le scan à Tillor, voir [Scans d'identité](/identiteitsscans).

## Ce que Tillor fait pour vous [#wat-tillor-voor-je-doet]

- **Livraison** : le boîtier arrive préconfiguré pour votre organisation.
- **Installation et liaison** : nous relions vos imprimantes, barrières et scanners lors du démarrage.
- **Mises à jour** : les nouvelles versions s'installent automatiquement, sans interruption.
- **Surveillance** : Tillor voit si le connecteur est connecté et réagit de lui-même en cas de panne.

## Ce dont vous avez besoin [#wat-je-zelf-nodig-hebt]

- Une prise de courant près de votre équipement réseau
- Un câble réseau vers votre routeur ou switch, dans le même réseau que vos imprimantes et barrières
- Une connexion internet stable

## Appareils reliés [#gekoppelde-apparaten]

- **Imprimantes** : voir [Imprimante](/printer) pour la configuration et l'utilisation.
- **Barrières, portails et contrôleurs d'accès** : voir [Contrôle d'accès](/toegangscontrole).
- **Lecteurs d'identité** : voir [Scans d'identité](/identiteitsscans) pour créer des clients à partir d'un scan et pour les durées de conservation.

<Callout type="info" title="Pour le lecteur technique">
Dans le réseau de votre parc, vous pouvez consulter l'état du connecteur sur `http://[adres-van-de-connector]:3000/`. Vous y voyez la connexion avec Tillor, la file d'impression et les dernières plaques lues. Le support Tillor vous donne l'adresse lors de l'installation. Plus de détails sur le protocole sous [MQTT](/ontwikkelaars/mqtt).
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le connecteur n'est pas connecté">
Vérifiez que le boîtier est alimenté et que le câble réseau est bien branché. Regardez si internet fonctionne dans votre parc. Débranchez ensuite brièvement le boîtier puis rebranchez-le. Si le problème persiste, contactez le support Tillor. Nous voyons généralement la panne nous-mêmes.
</Accordion>
<Accordion title="L'impression ou la commande d'une barrière ne fonctionne pas">
Consultez d'abord l'état du connecteur, voir l'astuce technique ci-dessus. Vérifiez que l'appareil est allumé et dans le même réseau. Si le connecteur est connecté et l'appareil joignable mais que rien ne se passe, contactez le support.
</Accordion>
<Accordion title="Les nouvelles méthodes d'accès n'arrivent pas à la barrière">
Regardez sous **Opérations du Contrôleur** sur la page Contrôle d'accès. Si une commande reste sur **En attente**, le connecteur est hors ligne.
</Accordion>
</Accordions>

## Notions [#begrippen]

- **Connecteur** : le boîtier de votre parc qui relie Tillor à vos appareils.
- **Contrôleur d'accès** : un boîtier à côté d'une barrière qui lit les badges et les codes QR.
- **Solution gérée** : Tillor livre, configure et entretient le boîtier pour vous.

Plus d'explications dans le [glossaire](/begrippen).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Contrôleurs" href="/controllers" description="Lecteurs de badges aux douches, portes et bornes de recharge" />
  <Card title="Imprimante" href="/printer" description="Configurer et utiliser les imprimantes" />
  <Card title="Contrôle d'accès" href="/toegangscontrole" description="Barrières et méthodes d'accès" />
  <Card title="Scans d'identité" href="/identiteitsscans" description="Scanner les pièces d'identité à l'enregistrement" />
</Cards>


# Documents (/fr-FR/documenten)

Avec la gestion des documents, vous conservez des fichiers chez un client, comme des polices d'assurance, des cartes d'identité, des contrats, des permis et d'autres pièces jointes. Les fichiers qui n'appartiennent encore à personne restent dans la liste centrale des documents jusqu'à ce que vous les reliez à un client. Commencez par [Documents d'un client](#documenten-bij-een-klant) ou par [La liste centrale des documents](#de-centrale-documentenlijst).

<Callout type="info" title="Bon à savoir">
- Un fichier peut peser 250 Mo au maximum.
- Vous pouvez téléverser des PDF, des documents Word, des messages Outlook (.msg), des fichiers Excel, PowerPoint, des images (JPEG, PNG, GIF) et des fichiers texte.
- Tillor convertit les images en PDF après le téléversement. Les autres types de fichiers restent tels quels, avec un aperçu PDF à côté.
- Lorsqu'un document est supprimé, vous recevez une copie en pièce jointe sur votre adresse e-mail, si le fichier a pu être sauvegardé.
- Un PDF lié à une demande de signature, ainsi que le PDF signé, peuvent être archivés mais pas supprimés.
- Un document archivé est conservé, mais ne figure plus parmi les documents actifs.
</Callout>

## Comment tout cela s'articule-t-il ? [#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 document se trouve à un seul endroit : soit dans la liste centrale, soit chez un client. Si vous le reliez à un client, il disparaît de la liste centrale. Les PDF signés et les mandats signés rejoignent automatiquement les documents du client.

## Documents d'un client [#documenten-bij-een-klant]

### Consulter les documents [#documenten-bekijken]

1. Allez dans <UIPath>Clients > Aperçu</UIPath> et ouvrez la fiche du client.
2. Cliquez sur l'onglet **Documents**.
3. Vous voyez les documents de ce client, répartis entre **Actif** et **Archivé**.
4. Cliquez sur un document (ou sur l'œil) pour le voir à droite dans l'**Aperçu**. L'icône de téléchargement l'enregistre.

### Modifier, déplacer ou archiver un document [#een-document-bewerken-verplaatsen-of-archiveren]

Le menu **…** à côté d'un document contient **Modifier**, **Déplacer vers un client**, **Télécharger**, **Archiver** (ou **Désarchiver**) et **Supprimer**.

### Supprimer un document [#een-document-verwijderen]

Avant de commencer : un document lié à une demande de signature ne peut pas être supprimé. Archivez-le alors.

<Steps>
<Step>
### Choisissez Supprimer [#kies-verwijderen]
Choisissez **Supprimer** dans le menu **…** à côté du document.
</Step>
<Step>
### Confirmez [#bevestig]
Confirmez dans la boîte de dialogue avec **Supprimer**, ou annulez avec **Annuler**. La suppression ne peut pas être annulée.

<DocScreenshot src="/screenshots/documenten/document-delete-dialog.png" alt="Boîte de dialogue de confirmation de suppression d'un document" />
</Step>
</Steps>

Après la suppression, vous recevez sur l'adresse e-mail de votre compte un message avec le document supprimé en pièce jointe, de sorte que vous avez généralement une copie sous la main.

### Faire signer un document [#een-document-laten-ondertekenen]

Sous les documents d'un client se trouvent les **Demandes de signature**. Avec **Demander des signatures**, vous faites signer un PDF en ligne par le client, une personne de contact, un collègue ou un tiers. Le PDF signé arrive dans les documents sous **[titre] (signé)**, avec le type **Accord signé** si le PDF d'origine n'avait pas de type. Voir [Signatures](/handtekeningen).

## La liste centrale des documents [#de-centrale-documentenlijst]

Outre les documents des clients, Tillor a une liste centrale. Y apparaissent les fichiers qui ne sont pas encore reliés à un client, par exemple des documents reçus par e-mail. Allez dans <UIPath>Administration > Documents</UIPath>.

<DocScreenshot src="/screenshots/documenten/documents-upload.png" alt="Liste centrale des documents avec zone de téléversement" />

### Téléverser un document [#een-document-uploaden]

<Tabs items={["Glisser ou choisir", "Par e-mail"]}>
<Tab value="Glisser ou choisir">
Glissez un fichier vers la zone de téléversement, ou cliquez sur **Sélectionner un fichier**. Le fichier est enregistré automatiquement et apparaît comme nouvel élément dans la liste.
</Tab>
<Tab value="Par e-mail">
La zone de téléversement affiche une adresse e-mail dédiée. Envoyez le fichier en pièce jointe à cette adresse, et il apparaît automatiquement dans la liste centrale.
</Tab>
</Tabs>

### Relier un document à un client [#een-document-koppelen-aan-een-klant]

Chaque document de la liste centrale a un formulaire de modification et un panneau d'aperçu.

<Steps>
<Step>
### Trouvez le document [#zoek-het-document]
Allez dans <UIPath>Administration > Documents</UIPath> et faites défiler jusqu'au document.
</Step>
<Step>
### Remplissez les champs [#vul-de-velden-in]
- **Nom du Document** : le nom du document.
- **Assigner au Client** : le client auquel appartient ce document (facultatif).
- **Type de document** : par exemple **Police d'assurance**, **Preuve de paiement d'assurance**, **Carte d'identité**, **Mandat SEPA**, **Accord signé** ou **Autre** (facultatif).
- **Date d'expiration de l'assurance** : la date à laquelle une assurance ou un permis expire. Ce champ n'apparaît que pour les types de documents qui peuvent avoir une date d'expiration.
- **Remarques** : notes libres sur le document (facultatif).
</Step>
<Step>
### Enregistrez [#sla-op]
Cliquez sur **Enregistrer les Modifications**.
</Step>
</Steps>

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le document disparaît de la liste centrale et figure dans l'onglet **Documents** de ce client.
- Si vous avez renseigné une **Date d'expiration de l'assurance**, elle apparaît comme étiquette sur le document.

## Suggestions de l'IA pour les documents [#ai-suggesties-bij-documenten]

Lorsque vous téléversez un PDF, Tillor analyse son contenu en arrière-plan. Si Tillor reconnaît un nom correspondant à un client de votre administration, un bouton de suggestion apparaît à côté de **Assigner au Client**, avec le nom du client et un pourcentage indiquant le degré de certitude de Tillor. Une suggestion peut aussi apparaître pour une date d'expiration d'assurance.

Cliquez sur le bouton pour reprendre la suggestion, ou choisissez vous-même un autre client. Une suggestion n'est toujours qu'une proposition. Cliquez sur **Enregistrer les Modifications** pour valider votre choix.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas supprimer un document">
Si le document est lié à une demande de signature, comme PDF d'origine ou comme PDF signé, Tillor refuse la suppression, car c'est une preuve. Archivez-le avec **Archiver** dans le menu **…**.
</Accordion>
<Accordion title="Tillor affiche : Échec de l'archivage">
Le message est **Le document n'a pas pu être archivé.** Réessayez. Il en va de même pour **Échec de la restauration** avec **Désarchiver**.
</Accordion>
<Accordion title="Tillor affiche : Échec de la mise à jour">
Vos modifications du **Nom du Document**, du client, du type ou des remarques n'ont pas été enregistrées. Vérifiez le formulaire et cliquez de nouveau sur **Enregistrer les Modifications**.
</Accordion>
<Accordion title="Tillor affiche : Échec du téléchargement">
Le document n'a pas pu être téléchargé. Réessayez.
</Accordion>
<Accordion title="Le champ Date d'expiration de l'assurance est absent">
Ce champ n'apparaît que pour les types de documents qui peuvent avoir une date d'expiration, comme **Police d'assurance**. Choisissez d'abord le bon type sous **Type de document**.
</Accordion>
<Accordion title="Mon fichier n'est pas accepté">
Vérifiez le type de fichier (PDF, Word, message Outlook, Excel, PowerPoint, JPEG, PNG, GIF ou texte) et la taille (250 Mo au maximum).
</Accordion>
<Accordion title="Le document ne figure plus dans la liste centrale">
Dès qu'un document est relié à un client, il ne se trouve plus que chez ce client, sous **Documents**. S'il est archivé, vous le trouvez sous **Archivé**.
</Accordion>
</Accordions>

## Notions [#begrippen]

- **Type de document** : le genre de document, par exemple **Police d'assurance** ou **Carte d'identité**.
- **Archivé** : un document conservé mais qui ne figure plus parmi les documents actifs.
- **Liste centrale des documents** : les fichiers qui ne sont pas encore reliés à un client.
- **Demande de signature** : une commande pour faire signer un PDF. Voir [demande de signature](/begrippen#ondertekenverzoek).
- **Client** : la fiche dans Tillor à laquelle un document est rattaché. Voir [client](/begrippen#klant).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" />
  <Card title="Signatures" href="/handtekeningen" />
</Cards>


# Aperçu (/fr-FR/eigen-velden)

Avec les champs personnalisés, vous ajoutez vous-même des champs à une fiche. Pensez à un numéro de caution de bouteille de gaz sur un client, à un supplément sur un emplacement ou à une heure d'arrivée prévue sur une réservation. Le champ apparaît dans le formulaire de cette fiche, comme les champs que Tillor fournit lui-même.

Vous les gérez sous <UIPath>Paramètres > Champs personnalisés</UIPath>.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-list.png" alt="Paramètres > Champs personnalisés avec l'onglet Clients et la liste des champs" />

<Callout type="info" title="Bon à savoir">
- Le type d'un champ et la clé ne peuvent plus être modifiés après la création
- Texte : 1 000 caractères au maximum par défaut, Texte long 10 000. Une liste de choix a 200 options au maximum
- Un groupe de champs a 30 sous-champs au maximum. Lignes répétées : 100 lignes au maximum par défaut, jamais plus de 500
- Fichiers : 20 au maximum par champ par défaut (jamais plus de 50), 50 Mo chacun au maximum
- Un champ qui disparaît à cause d'une condition est vidé à l'enregistrement de la fiche
- Un champ supprimé disparaît des formulaires. Les valeurs saisies restent toutefois sur les fiches
- Toutes les limites par type figurent sous [Types de champs et paramètres](/eigen-velden/veldtypes)
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Vous créez un champ une seule fois, et il apparaît ensuite partout où ce type de fiche est rempli.

```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]
```

- **Les listes de choix** se créent séparément des champs. Si vous modifiez une option, c'est correct dans chaque champ qui utilise la liste.
- **Un champ** appartient à un seul type de fiche. Le type et la clé sont fixes.
- **L'accès** se règle par champ. Celui qui n'a pas le droit de voir un champ ne voit jamais la valeur, pas même dans les exports ou les automatisations.

## Où pouvez-vous ajouter des champs personnalisés [#waar-kun-je-eigen-velden-toevoegen]

Chaque type de fiche a son propre onglet. Le nombre de champs figure après le nom.

| Onglet | Fiche |
|---|---|
| **Clients** | Fiche client |
| **Emplacements** | Emplacement |
| **Occupations** | Occupation |
| **Compteurs** | Compteur |
| **Tâches** | Tâche |
| **Produits** | Produit |
| **Documents** | Document |
| **Réservations** | Réservation |
| **Méthodes d'accès** | Méthode d'accès |

L'onglet **Listes de choix** n'a pas de fiches. Vous y créez des listes d'options que vous réutilisez dans des champs à choix.

## Ce que vous pouvez en faire [#wat-je-ermee-kunt]

- Ajouter un champ d'un certain type, comme texte, nombre, montant, date, choix ou fichier. Voir [Types de champs et paramètres](/eigen-velden/veldtypes)
- Placer le champ dans le formulaire parmi les champs existants, ou ne l'afficher que si une autre valeur correspond
- Rendre le champ obligatoire, éventuellement seulement sous condition
- Déterminer qui peut voir le champ et qui peut le modifier. Voir [Visibilité et accès](/eigen-velden/zichtbaarheid-en-toegang)

Les valeurs sont disponibles dans l'export des clients et des emplacements et dans les automatisations. Une automatisation peut aussi remplir un champ personnalisé avec l'étape **Définir un champ personnalisé**.

## Qui peut l'utiliser [#wie-kan-het-gebruiken]

<Callout type="info" title="La gestion demande un droit">
Créer, modifier, réorganiser et supprimer des champs est possible avec le droit **Gérer les champs personnalisés**. Celui qui ne l'a pas peut ouvrir la page s'il a le droit de consulter les paramètres, mais les boutons sont alors désactivés.
Remplir un champ sur une fiche est possible pour toute personne qui peut voir et modifier le champ.
</Callout>

## Composants [#onderdelen]

<Cards>
  <Card
    title="Créer un champ personnalisé"
    href="/eigen-velden/veld-aanmaken"
    description="Ajouter, placer et adapter un champ pas à pas"
  />
  <Card
    title="Listes de choix"
    href="/eigen-velden/keuzelijsten"
    description="Définir les options pour les types Choix et Choix multiple"
  />
  <Card
    title="Types de champs et paramètres"
    href="/eigen-velden/veldtypes"
    description="Pour chaque type, les paramètres et les limites"
  />
  <Card
    title="Visibilité et accès"
    href="/eigen-velden/zichtbaarheid-en-toegang"
    description="Où se trouvent les valeurs et qui peut les voir ou les modifier"
  />
</Cards>

## Notions [#begrippen]

- **[Champ personnalisé](/begrippen#eigen-veld)** : un champ supplémentaire que vous ajoutez vous-même à une fiche
- **Libellé** : le nom que vos collègues voient au-dessus du champ de saisie
- **Clé** : le nom fixe du champ, par exemple `gasMeterNumber`. Vous la voyez dans la liste et elle sert dans les exports et les filtres
- **Type** : le genre de valeur que le champ conserve
- **[Liste de choix](/begrippen#keuzelijst)** : une liste d'options que vous utilisez dans plusieurs champs à choix

D'autres termes figurent dans le [glossaire](/begrippen). Un exemple détaillé se trouve sous [Exemples pratiques](/praktijk).


# Créer des listes de choix (/fr-FR/eigen-velden/keuzelijsten)

Un champ de type **Choix** ou **Choix multiple** a besoin d'une liste de choix. Vous créez la liste une fois et l'utilisez dans autant de champs que vous voulez. Si vous modifiez une option, c'est correct partout aussitôt.

<Requires permission="Gérer les champs personnalisés" />

<Steps>
<Step>
### Ouvrez l'onglet Listes de choix [#open-het-tabblad-keuzelijsten]
Allez dans <UIPath>Paramètres > Champs personnalisés</UIPath> et cliquez sur **Listes de choix**. Chaque liste affiche ses options avec leur couleur et le nombre de champs qui l'utilisent.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enums.png" alt="L'onglet Listes de choix avec la liste Type de contrat" />
</Step>
<Step>
### Créez une liste [#maak-een-lijst-aan]
Cliquez sur **Nouvelle liste de choix**. Saisissez un **Nom** et éventuellement une **Description**. Tillor crée lui-même une **Clé**.
</Step>
<Step>
### Ajoutez des options [#voeg-opties-toe]
Cliquez sur **Ajouter une option** et saisissez le **Libellé**, par exemple *Saison*. Choisissez une couleur avec le point de couleur. Une liste a besoin d'au moins une option.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enum-dialog.png" alt="Boîte de dialogue Nouvelle liste de choix" />
</Step>
<Step>
### Enregistrez [#sla-op]
Cliquez sur **Enregistrer**. Choisissez ensuite la liste lors de la création d'un champ de type **Choix** ou **Choix multiple**.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La liste est proposée lors de la création d'un champ de type **Choix** ou **Choix multiple**.
- Si vous modifiez plus tard le libellé ou la couleur d'une option, c'est correct aussitôt dans chaque champ qui utilise la liste.
- La **Valeur** d'une option est fixe dès qu'elle a été utilisée sur une fiche.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas supprimer une liste">
Une liste encore utilisée dans un champ ne peut pas être supprimée. Tillor indique que la liste est encore utilisée par un champ. Retirez d'abord la liste de ces champs ou supprimez ces champs.
</Accordion>
<Accordion title="Mon champ à choix affiche Créez d'abord une liste de choix">
Aucune liste n'existe encore. Créez-en une dans l'onglet **Listes de choix** puis choisissez-la dans le champ.
</Accordion>
<Accordion title="Je ne peux pas enregistrer la liste">
Une liste a besoin d'au moins une option et de 200 au maximum. Ajoutez une option avec **Ajouter une option**.
</Accordion>
</Accordions>


# Créer un champ personnalisé (/fr-FR/eigen-velden/veld-aanmaken)

Avec un champ personnalisé, vous conservez une donnée que Tillor ne connaît pas, comme un numéro de caution de bouteille de gaz sur un client. Vous le créez en quelques minutes et, à droite de la page, vous voyez aussitôt comment vos collègues recevront le champ. Vous le remplissez ensuite sur la fiche elle-même, voir [Visibilité et accès](/eigen-velden/zichtbaarheid-en-toegang).

Avant de commencer :

- Vous avez besoin du droit **Gérer les champs personnalisés**. Sans ce droit, le bouton **Nouveau champ** est grisé.
- Si le champ a besoin d'un choix, créez d'abord une [liste de choix](/eigen-velden/keuzelijsten). Sinon, il est écrit **Créez d'abord une liste de choix**.
- Choisissez le type avec soin : vous ne pourrez plus le modifier ensuite.

<Requires permission="Gérer les champs personnalisés" />

<Steps>
<Step>
### Ouvrez Champs personnalisés et choisissez l'onglet [#open-eigen-velden-en-kies-het-tabblad]
Allez dans <UIPath>Paramètres > Champs personnalisés</UIPath> et ouvrez l'onglet de la fiche à laquelle le champ appartient, par exemple **Clients**. Cliquez sur **Nouveau champ**.

Si l'onglet est encore vide, vous voyez sous **Démarrage rapide** quelques propositions, comme **Nombre de chiens** pour les clients. Cliquez sur une proposition pour ouvrir le formulaire déjà rempli. Les propositions avec une liste de choix demandent d'abord une liste. Voir [Listes de choix](/eigen-velden/keuzelijsten).
</Step>
<Step>
### Remplissez le champ [#vul-het-veld-in]
Sous **1. Champ**, vous choisissez le type de fiche dans **S'applique à**, donnez un **Libellé** au champ et choisissez le **Type**. Chaque carte de type a une courte explication.

Tillor crée lui-même une **Clé** à partir de votre libellé. Sous **3. Clé**, vous pouvez la modifier avec **Modifier** avant d'enregistrer.

<DocScreenshot src="/screenshots/eigen-velden/field-new-form.png" alt="Nouveau champ personnalisé avec les cartes de type, les paramètres et l'aperçu à droite" />
</Step>
<Step>
### Réglez le champ [#stel-het-veld-af]
Sous **2. Paramètres** figurent les options propres au type choisi. Voir [Types de champs et paramètres](/eigen-velden/veldtypes). Vous pouvez aussi choisir :

- **Largeur** : **Moitié** ou **Pleine largeur** dans le formulaire
- **Position dans le formulaire** : laissez le champ en bas (**Section par défaut (en bas)**), ou choisissez un champ existant du formulaire et placez le champ **Avant** ou **Après** celui-ci
- **Obligatoire** : la fiche ne peut pas être enregistrée tant que le champ est vide
- **Visibilité** : n'affichez le champ que si une condition est remplie
- **Obligatoire si** : ne rendez le champ obligatoire que si une condition est remplie
- **Règles de validation** : comparez la valeur à un autre champ, ou vérifiez-la avec une expression
- **Texte d'aide** : une courte explication sous le champ de saisie
</Step>
<Step>
### Déterminez qui y a accès [#bepaal-wie-erbij-mag]
Sous **4. Accès**, il est indiqué par défaut que tout le monde peut voir et modifier le champ. Cliquez sur **Restreindre** pour l'adapter. Voir [Visibilité et accès](/eigen-velden/zichtbaarheid-en-toegang).
</Step>
<Step>
### Enregistrez le champ [#sla-het-veld-op]
Cliquez sur **Enregistrer**. Tillor indique **Champ enregistré** et vous ramène à la liste. Le champ figure aussitôt dans le formulaire de la fiche.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le champ figure aussitôt dans le formulaire de la fiche, à l'endroit que vous avez choisi.
- Les fiches existantes ont encore une valeur vide. Si le champ est obligatoire, un collègue doit le remplir avant d'enregistrer de nouveau une telle fiche.
- Les valeurs sont reprises dans l'export des clients et des emplacements et sont disponibles dans les automatisations.
- Qui peut voir ou modifier le champ se règle sous **4. Accès**.

## Position et conditions [#plaats-en-voorwaarden]

Avec **Position dans le formulaire**, vous placez un champ près des champs auxquels il se rattache, au lieu de le mettre en bas. Avec **Visibilité**, vous n'affichez un champ que si une autre valeur le demande. Dans cet exemple, **Hivernage** n'apparaît que pour un emplacement avec le **Type de contrat** Saison, juste après **Description**.

<DocScreenshot src="/screenshots/eigen-velden/field-edit-conditions.png" alt="Modification d'un champ avec Position dans le formulaire et une condition sous Visibilité et Obligatoire si" />

Une condition se compose d'une ou plusieurs règles. Sous **Type de condition**, vous choisissez **Règles** ou **Expression**. L'expression est destinée aux cas compliqués et demande un petit bout de code. Pour la plupart des champs, les règles suffisent.

<Callout type="info" title="Un champ masqué est vidé">
Si un champ disparaît parce que la condition n'est plus remplie, Tillor efface la valeur à l'enregistrement de la fiche. Si le champ revient, il est vide. Un champ obligatoire sous condition n'est obligatoire que tant qu'il est visible.
</Callout>

## Modifier, déplacer ou supprimer un champ [#een-veld-bewerken-verplaatsen-of-verwijderen]

Dans la liste, chaque champ a quatre boutons.

| Bouton | Ce qu'il fait |
|---|---|
| **Monter** et **Descendre** | Change l'ordre des champs dans le formulaire |
| **Modifier le champ** | Ouvre le champ. Le type, la clé et la fiche à laquelle le champ appartient sont alors fixes |
| **Supprimer** | Supprime le champ après confirmation |

Un champ supprimé disparaît des formulaires. Les valeurs saisies restent toutefois sur les fiches, mais ne sont plus affichées ni modifiées.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas cliquer sur Nouveau champ">
Le bouton est désactivé sans le droit **Gérer les champs personnalisés**. Demandez à un administrateur de vous accorder ce droit.
</Accordion>
<Accordion title="Je veux modifier le type ou la clé d'un champ existant">
C'est impossible. Créez un nouveau champ avec le bon type puis supprimez l'ancien. Tillor ne reprend pas les valeurs de l'ancien champ.
</Accordion>
<Accordion title="Mon champ n'est pas là où je l'attends">
Vérifiez sous **Position dans le formulaire** si vous avez choisi un champ. Avec **Section par défaut (en bas)**, le champ se trouve après les champs standard du formulaire. S'il a une condition sous **Visibilité**, il n'apparaît que si elle est remplie.
</Accordion>
</Accordions>


# Types de champs et paramètres (/fr-FR/eigen-velden/veldtypes)

Lors de la création d'un champ, vous choisissez un type. Vous ne pouvez plus le modifier ensuite. Sous **2. Paramètres** figurent les options de ce type. Toutes les options sont facultatives, sauf indication contraire ci-dessous.

Pour presque chaque type, vous pouvez aussi saisir un **Message d'erreur**. Il remplace le message par défaut lorsqu'une valeur n'est pas correcte. Avec **Texte indicatif**, vous définissez ce qui s'affiche dans le champ de saisie vide.

## Texte et Texte long [#tekst-en-lange-tekst]

**Texte** est une seule ligne, **Texte long** plusieurs lignes.

| Paramètre | Ce qu'il fait |
|---|---|
| **Longueur minimale** et **Longueur maximale** | Le nombre de caractères. Sans maximum, la limite est de 1 000 caractères pour Texte et de 10 000 pour Texte long |
| **Format** | **Texte libre**, **Adresse e-mail**, **Numéro de téléphone**, **Adresse web**, **IBAN**, **Code postal**, **Chiffres uniquement** ou **Modèle personnalisé** |
| **Modèle (expression régulière)** | Avec **Modèle personnalisé**. La valeur entière doit correspondre. Tillor refuse les modèles avec des répétitions imbriquées ou des références arrière et les modèles de plus de 200 caractères |

## Nombre et Montant [#getal-en-bedrag]

**Montant** utilise la devise de votre organisation.

| Paramètre | S'applique à | Ce qu'il fait |
|---|---|---|
| **Minimum** et **Maximum** | Nombre, Montant | Limite inférieure et limite supérieure |
| **Nombres entiers uniquement** | Nombre | Aucune décimale autorisée |
| **Affichage** | Nombre, uniquement avec des nombres entiers | **Champ de saisie** ou **Compteur (− / +)** avec boutons |
| **Pas** | Nombre | La valeur doit être le minimum (ou 0) plus un nombre entier de pas |
| **Décimales maximales** | Nombre | Limite les décimales |

## Oui / non [#ja--nee]

Un interrupteur activé/désactivé. Avec **Doit être cochée**, la fiche ne peut être enregistrée que si la case est cochée. Pratique pour un consentement.

## Date [#datum]

| Paramètre | Ce qu'il fait |
|---|---|
| **Date la plus proche** et **Date la plus lointaine** | Limites fixes |
| **Pas dans le passé** et **Pas dans le futur** | Comparé à aujourd'hui dans le fuseau horaire de votre organisation |
| **À moins de jours d'aujourd'hui** | Au maximum ce nombre de jours avant ou après aujourd'hui |

## Choix et Choix multiple [#keuze-en-meerkeuze]

Vous choisissez une [liste de choix](/eigen-velden/keuzelijsten). **Choix** conserve une option, **Choix multiple** plusieurs. Pour Choix multiple, vous réglez **Sélection minimale** et **Sélection maximale**. Une liste a 200 options au maximum.

## Lien vers une fiche [#koppeling-naar-record]

Le champ pointe vers une autre fiche dans Tillor.

| Paramètre | Ce qu'il fait |
|---|---|
| **Lie vers** | Client, Emplacement, Occupation, Compteur, Tâche, Facture, Réservation, Rapport de paiement, Appel téléphonique, Personne de contact, Produit, Armoire de compteurs, Paiement, Document, Tag NFC ou Méthode d'accès |
| **Plusieurs fiches** | Autorise plus d'une fiche liée. Vous pouvez alors aussi régler un minimum et un maximum |
| **Affichage** | **Sélecteur** ou **Menu déroulant** (une seule liste avec recherche) |
| **Uniquement les enregistrements de ce client** | Limite les options aux fiches du client que vous modifiez. Uniquement pour Personne de contact, Facture, Réservation, Occupation, Paiement, Document, Tag NFC et Méthode d'accès |
| **Uniquement les éléments de l'emplacement** | Limite les options aux compteurs de l'emplacement : pour une occupation, l'emplacement de cette occupation, pour un emplacement, l'emplacement lui-même. Uniquement pour Compteur. Un compteur d'un autre emplacement ne peut pas être enregistré |
| **Filtrer les options** | TypeScript facultatif qui détermine pour chaque option si elle figure dans la liste, voir [Filtrer les options](#opties-filteren). Pour Personne de contact, Produit, Armoire de compteurs, Paiement, Document, Tag NFC, Méthode d'accès, Facture, Réservation, Occupation, Compteur et Emplacement |

Si une fiche liée est supprimée plus tard, le champ affiche **Supprimé**.

S'il y a au moins 50 fiches à choisir, vous saisissez d'abord 2 caractères pour rechercher. S'il y en a moins, comme les compteurs d'un seul emplacement, vous les voyez toutes aussitôt.

### Filtrer les options [#opties-filteren]

Avec **Filtrer les options**, vous décidez vous-même quelles fiches le champ propose. Vous écrivez du TypeScript, comme pour la [formule tarifaire](/terreinen#tariefformule), que Tillor exécute pour chaque option. S'il renvoie `true`, l'option figure dans la liste ; sinon, non.

Dans le filtre, vous lisez des champs avec des accolades. Le menu **Variable** montre ce qui est disponible, y compris les champs personnalisés :

| Variable | Ce que c'est |
|-----------|------------|
| `{option.…}` | La fiche que vous pourriez choisir, par exemple `{option.type}` ou `{option.terrainId}` pour un compteur |
| `{occupation.…}`, `{terrain.…}`, … | La fiche que vous modifiez, sous le nom de son type, avec `customFields` pour ses propres champs |

Exemple : uniquement les compteurs d'électricité de l'emplacement de l'occupation.

```ts
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};
```

### Libellés personnalisés [#eigen-labels]

Le même filtre peut aussi déterminer le nom d'une option dans la liste. Ce que vous renvoyez détermine le résultat :

| Vous renvoyez | Résultat |
|----------------|-----------|
| `true` | L'option figure dans la liste sous son propre nom |
| `false`, `null` ou un texte vide | L'option ne figure pas dans la liste |
| Un texte | L'option figure dans la liste sous ce texte |
| `{ label, group }` | L'option reçoit ce libellé et se place sous le titre `group`. Les deux sont facultatifs |

Exemple : uniquement les compteurs d'ICY et d'Hydrodigit, avec le type ajouté et groupés par fournisseur.

```ts
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };
```

Le libellé s'applique dans la liste de sélection et sur les pastilles choisies dans le formulaire. Aux endroits qui n'affichent que la valeur, comme la page de détail ou un export, c'est le nom propre de la fiche qui apparaît.

**Insérer un exemple** sous le champ donne un point de départ. Un filtre qui ne compile pas ne peut pas être enregistré ; le message sous le champ indique ce qui ne va pas.

Le filtre ne limite pas seulement la liste. Si vous choisissez malgré tout, via l'API ou un ancien formulaire, une fiche que le filtre écarte, Tillor refuse l'enregistrement en nommant le champ. Les automatisations et les imports ne sont pas contrôlés, tout comme elles peuvent remplir des champs masqués.

## Groupe de champs [#groep-velden]

Un ensemble fixe de sous-champs qui figurent ensemble dans le formulaire, comme **Chiens** et **Autres animaux** sous **Animaux**.

| Paramètre | Ce qu'il fait |
|---|---|
| **Ajouter un sous-champ** | Chaque sous-champ a un libellé, un type et ses propres paramètres. Cliquez sur **Plus** pour la clé, la largeur et les conditions. Un groupe peut avoir 30 sous-champs au maximum |
| **Affichage** | **Cadre** (avec bordure) ou **Intégré** (les champs se poursuivent dans le formulaire) |
| **Colonnes** | De 1 à 4 |
| **Largeur dans le groupe** | Pour chaque sous-champ, le nombre de colonnes qu'il occupe |

## Lignes répétées [#herhalende-rijen]

Un tableau où vous ajoutez des lignes avec **Ajouter une ligne**, par exemple plusieurs véhicules. Vous réglez les sous-champs comme pour un groupe. Avec **Lignes minimales** et **Lignes maximum**, vous bornez la liste. Sans maximum, la limite est de 100 lignes, et plus de 500 est impossible.

Un groupe ou des lignes répétées peuvent contenir, sur un niveau de profondeur, un autre groupe ou d'autres lignes répétées, pas plus.

## Fichiers [#bestanden]

Pour les documents et les photos. Un fichier que vous téléversez n'est accessible qu'à celui qui peut voir le champ.

| Paramètre | Ce qu'il fait |
|---|---|
| **Plusieurs fichiers** | Autorise plus d'un fichier |
| **Fichiers minimum** et **Fichiers maximum** | Sans maximum, la limite est de 20 fichiers, et plus de 50 est impossible |
| **Taille maximale par fichier (Mo)** | 50 Mo au maximum par fichier, même si vous voulez une valeur plus élevée |
| **Types de fichiers autorisés** | **Tout fichier**, **Images**, **PDF**, **Documents Office**, ou une extension personnalisée comme `.dwg` ou un type MIME comme `application/zip` |

Tillor vérifie le type d'après le contenu du fichier, pas seulement d'après son nom.

## JSON [#json]

Destiné aux données structurées qu'une intégration transmet. Vos collègues le remplissent rarement dans le formulaire. Avec **Taille maximale (Ko)**, vous fixez une limite, 64 Ko par défaut et 256 Ko au maximum.

## Paramètres pour chaque type [#instellingen-voor-elk-type]

| Paramètre | Ce qu'il fait |
|---|---|
| **Chiffrer cette valeur** | Conserve la valeur chiffrée. Un champ chiffré ne peut pas être recherché, filtré ni trié et n'est pas disponible comme variable dans les automatisations. Uniquement pour les champs de plus haut niveau, donc pas pour les sous-champs. Toutes les valeurs des champs personnalisés sont de toute façon stockées chiffrées, que vous l'activiez ou non |
| **API uniquement** | Masque le champ dans les formulaires et les vues détaillées. Une intégration le remplit via l'API. Un tel champ ne peut pas être obligatoire |
| **API uniquement, lecture seule** | Affiche le champ, mais désactivé, pour que vos collègues voient la valeur sans pouvoir la modifier |
| **Règles de validation** | Comparez une date, un nombre ou un montant à un autre champ (**Avant**, **Au plus tard**, **Après**, **Au plus tôt**, avec un décalage en jours, semaines ou mois), ou vérifiez la valeur avec une expression. 10 règles au maximum par champ |

Une limite modifiée ne s'applique pas rétroactivement. Une valeur que vous ne modifiez pas ne bloque pas l'enregistrement de la fiche, même si elle ne respecte plus la nouvelle règle.


# Visibilité et accès (/fr-FR/eigen-velden/zichtbaarheid-en-toegang)

Un champ personnalisé apparaît dans le formulaire de l'enregistrement auquel il appartient. Par défaut, toute personne ayant accès à cet enregistrement peut voir et remplir le champ. Vous pouvez restreindre cela champ par champ.

## Où voir les valeurs [#waar-je-de-waarden-ziet]

Vous remplissez les champs personnalisés au même endroit que les autres données de l'enregistrement.

| Enregistrement | Où |
|---|---|
| Client | Le bloc **Détails du client** du profil client |
| Terrain, compteur, occupation, réservation, produit, document, méthode d'accès | Le formulaire de création ou de modification de l'enregistrement |
| Tâche | La fenêtre de la tâche. Vous enregistrez les modifications avec **Enregistrer les champs** |

Un champ se place à l'endroit choisi dans **Position dans le formulaire**. Sans choix, il se place après les champs standard.

<DocScreenshot src="/screenshots/eigen-velden/customer-custom-fields.png" alt="Le profil client avec des champs personnalisés comme Chiens, Date d'arrivée et Numéro de caution bouteille de gaz entre les champs standard" />

Si un champ est obligatoire, vous ne pouvez pas enregistrer l'enregistrement tant qu'il est vide. Un champ avec **Visibilité** n'apparaît que lorsque la condition est remplie.

Les champs personnalisés se retrouvent aussi dans l'export des clients et des terrains, et vous pouvez les utiliser dans les automatisations.

## Qui peut voir ou modifier un champ [#wie-mag-een-veld-zien-of-bewerken]

Ouvrez le champ sous <UIPath>Paramètres > Champs personnalisés</UIPath> et allez à **4. Accès**. Cliquez sur **Restreindre**.

<Requires permission="Gérer les champs personnalisés" />

<DocScreenshot src="/screenshots/eigen-velden/field-edit-access.png" alt="Modification d'un champ avec Qui peut voir ce champ et Qui peut modifier ce champ" />

Vous avez deux blocs.

| Bloc | Ce qu'il fait |
|---|---|
| **Qui peut voir ce champ** | Si vous le laissez vide, tous les membres peuvent le voir. Une personne qui n'a pas le droit de le voir ne voit jamais la valeur, pas non plus dans les exports ou les automatisations qu'elle modifie |
| **Qui peut modifier ce champ** | Si vous le laissez vide, toute personne qui voit le champ peut aussi le modifier. Les autres le voient en lecture seule |

Dans chaque bloc, vous choisissez un **collègue ou groupe** et/ou une **autorisation**. Si une personne correspond à l'un des collègues, groupes ou autorisations choisis, elle a accès. Vous ne pouvez modifier le champ que si vous avez aussi le droit de le voir.

Dans la liste, un tel champ reçoit l'étiquette **Restreint**. Survolez-la pour l'explication : seuls certains collègues, groupes ou autorisations peuvent voir ou modifier ce champ.

<Callout type="warn" title="Attention">
L'option **Visibilité** (une condition) masque seulement un champ dans le formulaire. Une personne qui a le droit de voir le champ peut toujours retrouver la valeur. Utilisez **Qui peut voir ce champ** si personne d'autre ne doit pouvoir la lire.
</Callout>

## Qui peut gérer les champs [#wie-mag-velden-beheren]

Créer, modifier, réorganiser et supprimer des champs, et gérer les listes de choix, demande l'autorisation **Gérer les champs personnalisés**. La façon d'attribuer des autorisations est décrite dans [Inviter des utilisateurs et attribuer des droits](/gebruikers/gebruikers-en-rechten). La page **Champs personnalisés** est visible pour les personnes qui peuvent consulter ou modifier les paramètres, ou qui ont cette autorisation. Sans cette autorisation, vous ne voyez que les champs que vous avez le droit de lire, et **Nouveau champ**, la modification et la suppression sont désactivés.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Un collègue ne voit pas un champ">
Vérifiez dans **Qui peut voir ce champ** si ce collègue, son groupe ou l'une de ses autorisations est sélectionné. Si le champ est un champ **API uniquement**, il n'apparaît pas dans les formulaires.
</Accordion>
<Accordion title="Un collègue ne peut pas modifier un champ">
Regardez dans **Qui peut modifier ce champ**. Si des collègues, groupes ou autorisations y sont sélectionnés, les autres sont limités à la lecture. Si quelqu'un essaie quand même de modifier la valeur, Tillor refuse.
</Accordion>
</Accordions>


# Créer et modifier une facture (/fr-FR/facturen/aanmaken-en-bewerken)

Une nouvelle facture est toujours un brouillon : vous la créez sur le profil du client et vous remplissez les lignes. Tant qu'elle est un brouillon, vous pouvez ajouter, modifier, déplacer et supprimer des lignes. Ensuite, vous [la comptabilisez](/facturen/boeken).

Avant de commencer :

- Le client existe déjà dans Tillor. Voir [Gestion des clients](/klantenbeheer).
- Pour les produits avec un terrain ou une occupation, le client a une occupation sur ce terrain. Sans occupation, vous créez une offre que vous ne pouvez pas comptabiliser.

## Créer une facture [#een-factuur-aanmaken]

Vous créez les factures sur le profil du client, pas depuis <UIPath>Administration > Factures</UIPath>.

<Steps>
<Step>
### Ouvrez le client [#open-de-klant]
Allez à <UIPath>Clients > Récapitulatif</UIPath> et ouvrez le profil du client.
</Step>
<Step>
### Créez la facture [#maak-de-factuur-aan]
Dans le bloc **Factures**, cliquez sur **Nouvelle facture**. Tillor crée une facture brouillon et ouvre aussitôt la page de la facture.

<DocScreenshot src="/screenshots/klanten/customer-new-invoice.png" alt="Nouvelle facture depuis le profil client" />
</Step>
</Steps>

La facture reçoit un numéro de brouillon provisoire. Le numéro de facture définitif, la date de facture et la date d'échéance n'arrivent qu'à la [comptabilisation](/facturen/boeken).

## Ajouter et modifier des lignes [#regels-toevoegen-en-aanpassen]

Sur la page de la facture, un tableau contient les lignes de facture. En bas se trouve une ligne vide dans laquelle vous commencez une nouvelle ligne.

<Steps>
<Step>
### Choisissez un produit ou saisissez une description [#kies-een-product-of-typ-een-omschrijving]
Choisissez un **Produit** dans la liste, et Tillor remplit la **Description** et le prix. Vous pouvez aussi saisir vous-même une description.
</Step>
<Step>
### Remplissez la quantité et le prix [#vul-aantal-en-prijs-in]
Adaptez la **Quantité** et le **Prix (TTC)** par unité si nécessaire. Le **Total** de la ligne est calculé automatiquement. Si le réglage de la TVA par ligne est activé pour votre organisation, vous choisissez aussi le taux de TVA.
</Step>
<Step>
### Ajoutez une note (facultatif) [#voeg-een-notitie-toe-optioneel]
Sous le tableau, vous pouvez remplir une **Note (Optionnel)**. Ce texte figure sur la facture et est visible pour le client.
</Step>
</Steps>

Les modifications sont enregistrées automatiquement presque aussitôt. Vous pouvez aussi cliquer sur **Enregistrer les modifications**, ou sur **Annuler** pour annuler les modifications non enregistrées.

### Réorganiser ou supprimer des lignes [#regels-herschikken-of-verwijderen]

- Faites glisser une ligne par la poignée à sa gauche pour changer l'ordre.
- Cliquez sur la croix à droite d'une ligne pour la supprimer.

Sur la chronologie **Événements** à côté de la facture, vous voyez ce qui a été modifié et quand, avec l'avant et l'après des champs et des lignes.

## Lignes avec une action [#regels-met-een-actie]

Si le produit choisi a une action sur la ligne de facture, des champs supplémentaires apparaissent sous la ligne. Les actions d'un produit se définissent sur le produit lui-même. Voir [Actions de produit](/producten/productacties).

| Action | Ce que vous remplissez sur la facture |
|-------|-----------------------------|
| **Recharger Tag NFC** | Le tag à recharger. Après le paiement, Tillor ajoute le montant au solde du tag. |
| **Période** | Dates de début et de fin, et pour un produit avec terrain aussi le **Terrain** (dans une liste ou **Choisir sur la carte**). |
| **Prolonger l'occupation** | Le terrain pour lequel vous prolongez l'occupation, plus les dates de début et de fin. |
| **Demander les coordonnées** | Adresse e-mail et numéro de téléphone du client. S'ils sont obligatoires, vous ne pouvez pas comptabiliser sans eux. |
| **Créer une méthode d'accès** | Le type de méthode d'accès et éventuellement une plaque d'immatriculation ou un code PIN. |
| **Afficher une alerte** | Rien. Vous voyez seulement une alerte avec le texte défini sur le produit. |
| **Empêcher la comptabilisation** | Rien. La facture ne peut pas être comptabilisée tant que la ligne y figure. |

### Choisir la période et le terrain [#periode-en-terrein-kiezen]

Pour une ligne avec **Période**, vous choisissez une date de début et une date de fin. Dessous, vous voyez le nombre de jours et la **Quantité** que Tillor facture. Si la période ne correspond pas exactement à une semaine ou à un mois du produit, Tillor arrondit à l'unité supérieure et **Arrondi** s'affiche. Avec la case **Pro rata**, vous facturez au contraire une semaine ou un mois partiel au prorata. Cette case n'apparaît que pour les produits avec une période d'une semaine ou d'un mois.

Si le produit demande un terrain, vous choisissez d'abord la période, puis le **Terrain**.

À la comptabilisation, Tillor crée la réservation. Une carte apparaît ensuite sur la ligne, avec numéro de réservation, statut, terrain et dates. Le fait que le client soit enregistré aussitôt dépend du produit : avec **Enregistrer l'arrivée à la validation**, cela se fait à la comptabilisation, avec **Enregistrer l'arrivée au paiement** seulement une fois la facture payée. Un acompte ne fait que réserver le terrain.

### Prolonger une occupation [#een-bezetting-verlengen]

Avec **Prolonger l'occupation**, vous facturez une période pour une occupation du client, par exemple des frais de stationnement.

<Steps>
<Step>
### Choisissez le terrain [#kies-het-terrein]
Dans **Sélectionner l'occupation active**, choisissez le terrain. La liste affiche les occupations actives du client.
</Step>
<Step>
### Choisissez la période [#kies-de-periode]
Choisissez la **Date de début**. Tillor ouvre ensuite aussitôt le calendrier pour la **Date de fin**. Sous les dates, vous voyez jusqu'à quand l'occupation est actuellement facturée, ainsi que le nombre de jours et la quantité couverts par la ligne.
</Step>
<Step>
### Réglez l'arrondi [#stel-het-afronden-in]
La case **Arrondir à la prochaine limite de période** est activée par défaut. La ligne se termine alors à la prochaine limite de période de la fréquence de location, de sorte que le client suit à terme le même cycle. Avec la case décochée, la ligne dure exactement une période à partir de la date de début.
</Step>
</Steps>

La ligne reçoit une description sous la forme **Nom du produit | Nom du terrain | Période**. La date de fin compte comme dernier jour, et une demi-période est aussi facturée pour moitié.

Si l'occupation a déjà une date **Payé jusqu'au** et que l'arrondi est activé, la nouvelle ligne commence le lendemain. Si **Payé jusqu'au** est encore vide, vous choisissez vous-même la date de début et Tillor calcule la date de fin jusqu'à la prochaine limite de période. Ce qui se passe avec **Payé jusqu'au** et **Facturé jusqu'au** après la comptabilisation et le paiement est décrit dans [Occupations](/bezettingen).

Deux cases supplémentaires aident dans des situations exceptionnelles :

- **Afficher tous les terrains (offre)** vous permet de choisir un terrain quelconque pour créer une offre. Si le client n'a pas ce terrain en occupation, vous ne pouvez pas comptabiliser la facture. Les utilisateurs avec l'autorisation **Corrections de factures** peuvent tout de même comptabiliser une telle facture, voir [Comptabiliser une facture](/facturen/boeken#problemen).
- **Marquer en crédit (remboursement)** transforme la ligne en remboursement. La quantité devient négative et la période va d'aujourd'hui à **Payé jusqu'au**. Avec **Arrondir à la limite de période**, vous arrondissez cela à une limite de période.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les modifications sont enregistrées automatiquement presque aussitôt. La chronologie **Événements** montre qui a modifié quoi.
- Rien n'est envoyé au client et rien ne change pour les occupations ou les tags. Cela n'arrive qu'à la [comptabilisation](/facturen/boeken) et au paiement.
- Un brouillon avec une ligne **Empêcher la comptabilisation** ne peut pas être comptabilisé.
- Vous supprimez un brouillon avec **Supprimer la facture** dans le menu d'actions.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux plus modifier les lignes">
Seules les factures brouillon sont modifiables. Une facture comptabilisée peut, sous conditions, être remise en brouillon, voir [Corriger une facture](/facturen/corrigeren#terugzetten-naar-concept).
</Accordion>
<Accordion title="Une ligne avec Recharger Tag NFC n'affiche aucun tag">
Le client n'a pas de tag disponible. Associez d'abord un tag NFC au client. Voir [NFC](/nfc).
</Accordion>
<Accordion title="Je ne vois pas le bouton Nouvelle facture">
Le bouton se trouve sur le profil client, dans le bloc **Factures**, et non sur la liste des factures sous **Administration**.
</Accordion>
<Accordion title="Le client n'apparaît pas dans la liste Sélectionner l'occupation active">
Avec **Prolonger l'occupation**, la liste n'affiche que les occupations actives du client. Créez d'abord une occupation, voir [Occupations](/bezettingen), ou utilisez **Afficher tous les terrains (offre)** pour une offre.
</Accordion>
</Accordions>

## Pour aller plus loin [#verder]

<Cards>
  <Card title="Comptabiliser une facture" href="/facturen/boeken" />
  <Card title="Produits" href="/producten" description="Définir les actions sur les lignes de facture" />
</Cards>


# Imprimer, télécharger ou partager une facture (/fr-FR/facturen/afdrukken-en-downloaden)

Avec **Imprimer**, vous imprimez une facture, l'enregistrez en PDF ou l'envoyez à une imprimante. Le bouton se trouve sur chaque page de facture, même pour un brouillon. La flèche à côté ouvre un menu avec les autres options. Vous créez un lien pour le client sous [Partager un lien personnel](#een-persoonlijke-link-delen).

Avant de commencer : pour les options d'imprimante, un Tillor Connector tourne pour votre organisation. Sans connecteur, ces options sont grisées.

## Imprimer ou enregistrer [#afdrukken-of-opslaan]

| Option | Ce qu'elle fait |
|-------|--------------|
| **Imprimer** | Ouvre la fenêtre d'impression de votre navigateur. Vous pouvez aussi utiliser le raccourci Ctrl+P (Cmd+P sur Mac). |
| **Ouvrir dans une nouvelle fenêtre** | Affiche le PDF dans une nouvelle fenêtre. |
| **Télécharger le PDF** | Enregistre la facture comme fichier PDF. |
| **Envoyer vers imprimante A4** | Envoie la facture à votre imprimante A4 connectée. |
| **Envoyer vers imprimante à bons** | Envoie la facture à votre imprimante à bons connectée. |

Les deux options d'imprimante sont grisées tant qu'aucun Tillor Connector n'est actif pour votre organisation. La configuration des imprimantes est décrite dans [Imprimante](/printer).

## Afficher la facture sur une tablette [#de-factuur-tonen-op-een-tablet]

Si une tablette à l'accueil affiche les documents des clients, vous pouvez y faire apparaître la facture. Ouvrez les trois points en haut à droite de la page de la facture et choisissez **Aperçu sur iPad**. Pour un paiement en espèces, le même bouton figure aussi dans la fenêtre de paiement.

## Partager un lien personnel [#een-persoonlijke-link-delen]

Pour une facture comptabilisée, vous pouvez créer un lien que le client ouvre lui-même pour consulter la facture et, s'il reste un montant à payer, payer en ligne.

<Steps>
<Step>
### Ouvrez le menu d'actions [#open-het-actiemenu]
Cliquez sur les trois points en haut à droite de la page de la facture et choisissez **URL personnelle**.
</Step>
<Step>
### Partagez le lien [#deel-de-link]
Tillor copie le lien dans votre presse-papiers et affiche le message **URL générée**. Collez-le dans un message ou un e-mail au client.
</Step>
</Steps>

<DocScreenshot src="/screenshots/facturen/invoice-actions-menu.png" alt="Menu d'actions de la facture - URL personnelle, Copier la facture, Inverser la facture" />

Le menu d'actions contient d'autres options. Voir [Corriger une facture](/facturen/corrigeren) pour copier, inverser et recalculer une facture.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Imprimer, télécharger et envoyer à l'imprimante ne changent rien à la facture.
- Avec **Aperçu sur iPad**, le client voit la facture sur la tablette. La chronologie de la facture indique que le PDF a été envoyé à la tablette.
- Le lien personnel n'a pas de date d'expiration. Le client y voit le montant restant dû et peut payer en ligne. Voir [Laisser un client payer en ligne](/betalingsverwerking/online).
- Les produits peuvent aussi imprimer automatiquement lors du paiement. Voir [Actions de produit](/producten/productacties#thermisch-printen-en-a4-printen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Envoyer vers imprimante A4 est grisé">
Aucun Tillor Connector actif pour votre organisation. Vérifiez la connexion et les réglages de l'imprimante, voir [Imprimante](/printer).
</Accordion>
<Accordion title="URL personnelle est absente">
Cette option n'existe que dans le menu d'actions d'une facture comptabilisée.
</Accordion>
<Accordion title="L'impression échoue">
Tillor affiche alors un message avec la raison, par exemple qu'il n'y a plus de papier ou de toner. Réglez le problème et réessayez.
</Accordion>
</Accordions>

## Pour aller plus loin [#verder]

<Cards>
  <Card title="Imprimante" href="/printer" description="Configurer les imprimantes et l'impression automatique" />
  <Card title="Envoyer une facture" href="/facturen/versturen" />
</Cards>


# Enregistrer un paiement (/fr-FR/facturen/betalingen-registreren)

Sur une facture comptabilisée avec un montant restant dû, vous effectuez un paiement ou vous en enregistrez un, par exemple un paiement par carte, en espèces ou un prélèvement. Le montant, le statut de paiement et la liste **Paiements** à côté de la facture sont ensuite mis à jour. Tous les modes figurent aussi dans [Traitement des paiements](/betalingsverwerking).

Avant de commencer :

- La facture est comptabilisée et un montant reste dû. Sinon, **Effectuer un paiement** est absent.
- Pour **Terminal de paiement**, Mollie est connecté. Pour **Mandat SEPA**, le client a un mandat actif. Sinon, le mode ne figure pas dans la liste ou est grisé.

## Effectuer un paiement [#een-betaling-uitvoeren]

<Steps>
<Step>
### Ouvrez la facture comptabilisée [#open-de-geboekte-factuur]
Allez à <UIPath>Administration > Factures</UIPath> et ouvrez une facture comptabilisée. Le bouton **Effectuer un paiement** s'y trouve tant qu'un montant reste dû.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Facture comptabilisée - Effectuer un paiement" />
</Step>
<Step>
### Choisissez le mode de paiement [#kies-de-betaalmethode]
Cliquez sur **Effectuer un paiement** et choisissez une **Méthode de paiement**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Boîte de dialogue de paiement - méthode de paiement et montant" />

| Méthode | À utiliser pour |
|---------|-----------------|
| **Terminal de paiement** | Un paiement par carte. Vous choisissez un terminal de paiement et Tillor lui envoie le paiement. Voir [Terminal](/betalingsverwerking/terminal). |
| **Virement interne** | Déplacer le montant vers une autre facture comptabilisée du même client (**Facture cible**). Voir [Virement interne](/betalingsverwerking/interne-overboeking). |
| **Espèces** | Enregistrer un paiement en espèces. Voir [Espèces](/betalingsverwerking/contant). |
| **Virement bancaire** | Enregistrer un virement bancaire reçu. |
| **Mandat SEPA** | Un prélèvement automatique via un **Mandat** actif du client. Voir [Mandat](/betalingsverwerking/mandaat). |
| **Autres** | Une autre forme de paiement, comme un chèque. Se trouve derrière **Autres moyens de paiement** et n'est visible que si vous l'avez activé. Une description est alors obligatoire. |

**Terminal de paiement** et **Mandat SEPA** n'apparaissent que s'ils sont disponibles pour votre organisation. **Mandat SEPA** est grisé tant que le client n'a pas de mandat actif, et n'existe pas pour les factures de crédit.
</Step>
<Step>
### Saisissez le montant [#vul-het-bedrag-in]
Le **Montant** est par défaut le montant restant dû en entier. Saisissez un autre montant ou utilisez les boutons **25%**, **50%**, **75%** et **100%**. Le montant ne peut pas dépasser ce qui reste dû.
</Step>
<Step>
### Remplissez les champs supplémentaires [#vul-de-extra-velden-in]
Pour **Espèces**, **Virement bancaire** et **Autres**, vous remplissez facultativement la **Date de réception** (pas dans le futur) et une **Remarque**. Pour un prélèvement, vous choisissez le **Mandat** et éventuellement un **Délai (jours)**, 0 envoyant aussitôt.

Si vous choisissez **Virement bancaire** et que le client a une adresse e-mail, vous pouvez cocher **Envoyer un rappel pour la communication structurée**. Le client reçoit alors un e-mail lui conseillant d'utiliser la communication structurée pour les prochains paiements.
</Step>
<Step>
### Effectuez le paiement [#voer-de-betaling-uit]
Cliquez sur **Effectuer le paiement**.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Paiements sur la facture" />
</Step>
</Steps>

Pour **Espèces**, il y a aussi un bouton **Aperçu sur iPad** pour montrer la facture au client sur une tablette connectée.

## Montants maximaux [#maximumbedragen]

Un paiement en espèces ne peut pas dépasser le **Montant maximal en espèces** sous <UIPath>Support > Paramètres > Paiements</UIPath> (par défaut 2999 euros). Pour un prélèvement, le montant ne peut pas dépasser le maximum du mandat.

## Associer un paiement existant [#een-bestaande-betaling-koppelen]

Si un paiement ou une transaction bancaire correspondant à cette facture est déjà arrivé, vous l'associez au lieu d'en créer un nouveau.

<Requires permission="Assigner un paiement" />

<Steps>
<Step>
### Ouvrez le menu d'actions [#open-het-actiemenu]
Cliquez sur les trois points en haut à droite de la page de la facture et choisissez **Assigner un paiement**.
</Step>
<Step>
### Choisissez le paiement [#kies-de-betaling]
Dans la fenêtre, choisissez un paiement ou un groupe. Les onglets **Groupes de paiements**, **Paiements par carte et en ligne** et **Transactions bancaires** indiquent ce qui est disponible. En haut figurent des suggestions qui correspondent au montant restant dû.
</Step>
<Step>
### Associez [#koppel]
Cliquez sur **Assigner le paiement**, **Assigner le groupe** ou **Assigner la transaction bancaire**, selon ce que vous avez choisi.
</Step>
</Steps>

Pour les transactions bancaires, vous avez aussi besoin de l'autorisation **Voir les transactions bancaires**.

## Créer un lien pour un paiement partiel [#een-link-voor-een-deelbetaling-maken]

Si le client ne veut payer qu'une partie du montant restant dû, vous créez un lien de paiement pour un montant de votre choix. C'est possible sur toute facture comptabilisée avec un montant restant dû.

<Steps>
<Step>
### Ouvrez le menu d'actions [#open-het-actiemenu-1]
Cliquez sur les trois points à côté de **Envoyer la notification** et choisissez **Lien de paiement partiel**.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-menu.png" alt="Menu d'actions d'une facture avec Lien de paiement partiel" />
</Step>
<Step>
### Saisissez le montant [#vul-het-bedrag-in-1]
Saisissez dans **Montant** ce que le client peut payer. Le montant doit être supérieur à 0 et ne peut pas dépasser ce qui reste dû.
</Step>
<Step>
### Créez le lien [#maak-de-link]
Cliquez sur **Créer et copier le lien**. Tillor copie le lien dans votre presse-papiers et l'affiche sous **Lien de paiement**. Avec le bouton de copie à côté, vous le copiez à nouveau.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-dialog.png" alt="Boîte de dialogue Lien de paiement partiel avec montant et lien de paiement" />
</Step>
</Steps>

Envoyez vous-même le lien au client, par exemple par e-mail ou par chat. Le client ouvre la page de paiement habituelle de la facture, mais celle-ci ne demande plus que votre montant, avec la mention qu'il s'agit d'un paiement partiel du montant encore dû. Le client paie alors de la manière qu'il choisit sur [la page de paiement](/betalingsverwerking/online).

Le lien reste valable, mais ne demande jamais plus que ce qui reste dû à ce moment-là. Si une partie a déjà été payée entre-temps, la page de paiement s'adapte à la baisse. Après un paiement, la facture est à <Status tone="warning">Partiellement</Status> jusqu'à ce que le montant total soit reçu.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le montant restant dû diminue et le statut de paiement change : <Status tone="warning">Partiellement</Status> tant qu'il reste quelque chose à payer, <Status tone="success">Payé</Status> quand tout est reçu.
- Pour un prélèvement ou un paiement par carte, la facture est d'abord à <Status tone="info">En cours</Status> jusqu'à ce que l'argent soit définitivement reçu.
- Si une ligne a une action de paiement, Tillor l'exécute dès que la facture est payée. Par exemple recharger un tag NFC, prolonger **Payé jusqu'au** d'une occupation ou imprimer un bon. Voir [Comment tout cela s'articule-t-il ?](/producten#hoe-hangt-dit-samen).
- Le paiement figure dans le rapport de paiements du jour. Voir [Rapports de paiements](/boekhouden/betalingsrapporten).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Effectuer un paiement">
La facture doit être comptabilisée et un montant doit rester dû. Sur une facture brouillon, vous ne pouvez pas payer.
</Accordion>
<Accordion title="Je ne vois pas Lien de paiement partiel">
La facture doit être comptabilisée et un montant doit encore rester dû.
</Accordion>
<Accordion title="Mandat SEPA est grisé">
Le client n'a pas de mandat actif. Configurez-le dans les données du client, voir [Mandat](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Je ne peux pas choisir Autres">
Ce mode de paiement est désactivé par défaut. Activez **Afficher le mode de paiement "Autres"** sous <UIPath>Support > Paramètres > Paiements</UIPath>.
</Accordion>
<Accordion title="La facture est à En cours">
Le paiement a démarré, par exemple un prélèvement, mais l'argent n'est pas encore définitivement reçu. Dès que le paiement est traité, le statut passe à **Payé**. Voir [Statuts](/facturen/statussen).
</Accordion>
</Accordions>

## Pour aller plus loin [#verder]

<Cards>
  <Card title="Traitement des paiements" href="/betalingsverwerking" description="Tous les modes de paiement en détail" />
  <Card title="Statuts" href="/facturen/statussen" />
</Cards>


# Comptabiliser une facture (/fr-FR/facturen/boeken)

La comptabilisation transforme un brouillon en facture définitive avec son propre numéro de facture. Ce n'est qu'ensuite que vous pouvez [l'envoyer](/facturen/versturen) et [la faire payer](/facturen/betalingen-registreren). Vérifiez donc les lignes avant de comptabiliser, car une facture comptabilisée ne se modifie plus librement.

Avant de commencer :

- La facture a au moins une ligne, ou un total différent de zéro.
- Les lignes avec **Période** ou **Prolonger l'occupation** ont une date de début et une date de fin.
- Si une ligne a une action qui demande des données, elles sont remplies. Par exemple **Demander les coordonnées** ou **Créer une méthode d'accès**.
- Pour un client belge avec un numéro de TVA, un ID Peppol est rempli. Voir [Peppol](/boekhouden/peppol).

En cas de problème, **Comptabiliser la facture** est grisé. Passez la souris sur le bouton pour lire pourquoi. Voir aussi [Un problème ?](#problemen).

## Comptabiliser une facture [#een-factuur-boeken]

<Steps>
<Step>
### Ouvrez la facture brouillon [#open-de-conceptfactuur]
Allez à <UIPath>Administration > Factures</UIPath> et ouvrez une facture avec le statut <Status>Brouillon</Status>, par exemple via la liste **Brouillons**.
</Step>
<Step>
### Vérifiez la facture [#controleer-de-factuur]
Relisez les lignes et la note.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Facture brouillon - lignes et Comptabiliser la facture" />
</Step>
<Step>
### Cliquez sur Comptabiliser la facture [#klik-op-boek-factuur]
La facture reçoit un numéro de facture séquentiel. Tillor indique que la facture est comptabilisée.
</Step>
</Steps>

## Qu'est-ce qui change ? [#wat-verandert-er]

Voici l'aspect d'une facture avant et après la comptabilisation. Ce sont deux factures d'exemple différentes, mais vous voyez la différence de numéro, de statut et de boutons.

**Avant la comptabilisation** : un numéro de brouillon provisoire et le bouton **Comptabiliser la facture**.

<DocScreenshot src="/screenshots/facturen/invoice-before-title.png" alt="Titre d'une facture brouillon avec le numéro de brouillon CON/2026/0001" />

<DocScreenshot src="/screenshots/facturen/invoice-before-toolbar.png" alt="Boutons d'une facture brouillon : Comptabiliser la facture et Imprimer" />

**Après la comptabilisation** : un numéro de facture définitif, un statut de paiement et les boutons **Effectuer un paiement** et **Envoyer la notification**.

<DocScreenshot src="/screenshots/facturen/invoice-after-title.png" alt="Titre d'une facture comptabilisée avec le numéro INV/2026/0001 et le statut de paiement Partiellement" />

<DocScreenshot src="/screenshots/facturen/invoice-after-toolbar.png" alt="Boutons d'une facture comptabilisée : Effectuer un paiement, Imprimer et Envoyer la notification" />

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La **date de facture** est le jour de la comptabilisation. La **date d'échéance** est ce jour plus l'**Échéance par défaut (jours)** de votre organisation, par défaut 7 jours. Vous l'adaptez sous <UIPath>Support > Paramètres > Facturation</UIPath>.
- Si le total n'est pas un multiple de 5 centimes, Tillor ajoute lui-même une ligne **Arrondi**.
- Si la facture a un total négatif, elle devient une **Facture de crédit**.
- Si le client a un ID Peppol, Tillor envoie automatiquement la facture via Peppol. Voir [Peppol](/boekhouden/peppol).
- Les lignes avec **Prolonger l'occupation** placent **Facturé jusqu'au** de l'occupation à la fin de la ligne. **Payé jusqu'au** ne suit qu'au paiement. Voir [Comment tout cela s'articule-t-il ?](/producten#hoe-hangt-dit-samen).
- Les lignes avec **Période** et **Demander un emplacement** créent une réservation. Le fait que le client soit enregistré aussitôt dépend du produit.
- Si un mandat de prélèvement est associé, Tillor crée aussitôt un paiement en attente. La banque est sollicitée deux jours après la comptabilisation.
- Le client ne reçoit rien automatiquement. La notification, vous l'envoyez vous-même, voir [Envoyer une facture](/facturen/versturen).
- Vous voulez malgré tout modifier quelque chose ? Dans les 7 jours et tant que rien n'a été envoyé, vous [remettez la facture en brouillon](/facturen/corrigeren#terugzetten-naar-concept).

## Choisir un autre délai de paiement [#een-andere-betaaltermijn-kiezen]

Si la date d'échéance diffère de votre valeur par défaut, vous n'avez pas besoin de le régler à l'avance.

<Steps>
<Step>
### Ouvrez le menu de choix [#open-het-keuzemenu]
Cliquez sur la flèche à côté de **Comptabiliser la facture** et choisissez **Conditions de paiement personnalisées…**.
</Step>
<Step>
### Choisissez le délai [#kies-de-termijn]
Dans **Conditions de paiement**, choisissez une option, de **À la date de facture** à **Net 60 jours**. Vous voyez aussitôt la **Date d'échéance estimée**.
</Step>
<Step>
### Comptabilisez [#boek]
Cliquez sur **Enregistrer la facture**.
</Step>
</Steps>

## Transmettre à votre comptabilité [#doorsturen-naar-je-boekhouding]

La transmission à votre logiciel de comptabilité se fait normalement d'elle-même. Si vous voulez la relancer, par exemple après une erreur, c'est possible facture par facture.

<Requires permission="Vers la comptabilité" />

Ouvrez la facture comptabilisée, cliquez sur les trois points en haut à droite et choisissez **Envoyer au logiciel de comptabilité**. Les systèmes disponibles sont décrits dans [Comptabilité](/boekhouden). [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) est disponible sur demande.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Comptabiliser la facture est grisé">
Passez la souris sur le bouton. Tillor indique la raison. Les plus fréquentes figurent ci-dessous.
</Accordion>
<Accordion title="Cette facture brouillon contient une ligne Empêcher la comptabilisation">
Le produit de cette ligne n'autorise pas la comptabilisation. Supprimez la ligne ou choisissez un autre produit.
</Accordion>
<Accordion title="Remplissez les dates de début et de fin sur chaque ligne avec Période ou occupation prolongée">
Une ligne avec **Période** ou **Prolonger l'occupation** n'a pas de date. Remplissez les dates de début et de fin.
</Accordion>
<Accordion title="Ajoutez au moins une ligne ou un montant total différent de zéro">
Ajoutez une ligne, ou faites en sorte que le total ne soit pas nul.
</Accordion>
<Accordion title="Remplissez les coordonnées obligatoires, ou choisissez un type de méthode d'accès">
Sur les lignes avec **Demander les coordonnées**, remplissez les champs obligatoires. Sur les lignes avec **Créer une méthode d'accès**, choisissez un type, et pour la reconnaissance de plaques aussi la plaque d'immatriculation.
</Accordion>
<Accordion title="Cette facture prolonge un terrain que le client n'a pas en occupation (offre)">
Une telle facture est une offre et vous ne pouvez pas la comptabiliser. Faites d'abord prendre le terrain en occupation par le client. Si vous avez l'autorisation **Corrections de factures**, vous pouvez choisir **Forcer l'enregistrement** via la flèche à côté de **Comptabiliser la facture**. L'occupation n'est alors prolongée que lorsque le client occupe le terrain.
</Accordion>
<Accordion title="Le montant de la facture dépasse le maximum du mandat associé">
Le montant de la facture ne peut pas dépasser le montant maximal du mandat associé. Adaptez le mandat dans **Mandat de prélèvement** sous **Informations sur la facture** à côté de la facture, ou réduisez le montant. Voir [Mandat SEPA](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Cette facture fait passer le solde du client sous zéro">
Un produit avec compte surveillé (par exemple une caution) ne peut pas faire passer le solde du client sous zéro. Si vous avez l'autorisation **Outrepasser le solde du compte**, vous pouvez comptabiliser quand même avec une justification. Voir [Surveiller le solde du client](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
</Accordion>
<Accordion title="La facture ne peut pas être comptabilisée car le client n'a pas d'ID Peppol">
Pour un client belge avec un numéro de TVA, un ID Peppol doit être connu. Ouvrez <UIPath>Clients > client > Facturation</UIPath>, allez à **Paramètres de facturation** et remplissez l'ID. Voir [Peppol](/boekhouden/peppol).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Envoyer une facture" href="/facturen/versturen" />
  <Card title="Enregistrer des paiements" href="/facturen/betalingen-registreren" />
  <Card title="Corriger une facture" href="/facturen/corrigeren" description="Si vous voulez tout de même modifier quelque chose après la comptabilisation" />
</Cards>


# Corriger une facture (/fr-FR/facturen/corrigeren)

Une facture comptabilisée ne se modifie pas à la légère. La voie à choisir dépend de l'avancement de la facture.

Toutes les corrections, sauf la remise en brouillon, se trouvent dans le menu d'actions (trois points) à côté de **Envoyer la notification**.

<DocScreenshot src="/screenshots/facturen/invoice-correct-menu.png" alt="Menu d'actions d'une facture comptabilisée avec Copier la facture et Inverser la facture" />

| Situation | Ce que vous faites |
|----------|-------------|
| La facture vient d'être comptabilisée et n'a pas encore été envoyée | [Remettre en brouillon](#terugzetten-naar-concept) |
| La facture a déjà été envoyée ou est trop ancienne | [Inverser](#een-factuur-omkeren) avec une facture de crédit |
| Vous voulez réutiliser les mêmes lignes | [Copier](#een-factuur-kopiëren) |
| La facture est sur le mauvais client | [Déplacer](#een-factuur-verplaatsen-naar-een-andere-klant) |
| Les montants sont incorrects | [Recalculer](#een-factuur-herberekenen) |

## Remettre en brouillon [#terugzetten-naar-concept]

Tant que la facture n'est pas encore sortie, vous la remettez en brouillon et vous la comptabilisez à nouveau après votre modification.

C'est possible si toutes ces conditions sont remplies :

- La facture est comptabilisée.
- Tillor n'a pas encore envoyé de notification pour elle, quel que soit le canal.
- La facture n'a pas été envoyée via Peppol.
- La date de facture date de moins de 7 jours.

<Steps>
<Step>
### Ouvrez la facture comptabilisée [#open-de-geboekte-factuur]
Allez à <UIPath>Administration > Factures</UIPath> et ouvrez la facture.
</Step>
<Step>
### Remettez-la en brouillon [#zet-hem-terug]
Cliquez sur **Revenir au brouillon** et confirmez avec **Oui, revenir au brouillon**. Si le bouton est absent, la facture ne remplit pas les conditions.
</Step>
<Step>
### Modifiez la facture et comptabilisez à nouveau [#pas-de-factuur-aan-en-boek-opnieuw]
Modifiez les lignes et cliquez sur **Comptabiliser la facture**.
</Step>
</Steps>

Entre-temps, la facture a un numéro de brouillon avec le numéro d'origine entre parenthèses. La ligne **Arrondi** est retirée et revient lors d'une nouvelle comptabilisation. Lors d'une nouvelle comptabilisation, la facture retrouve son numéro d'origine, avec la date de facture et la date d'échéance d'origine. Un brouillon issu d'une facture comptabilisée ne peut pas être supprimé.

Après une remise en brouillon, un bouton **Restaurer la version** figure sur cet événement de la chronologie **Événements**. Il remplace les lignes actuelles par les lignes telles qu'elles étaient au moment de la remise en brouillon. Si la facture est à nouveau comptabilisée, Tillor la remet d'abord en brouillon.

<Callout type="warn" title="Attention">
Si la facture a déjà été imprimée, montrée au client ou partagée d'une autre manière, soyez prudent. Le client a alors une version qui ne sera bientôt plus exacte.
</Callout>

### Quand la remise en brouillon n'est plus possible [#als-terugzetten-niet-meer-kan]

<Requires permission="Corrections de factures" />

Si la facture ne remplit plus les conditions, par exemple parce qu'une notification a déjà été envoyée ou que la facture a plus de 7 jours, vous pouvez tout de même la remettre en brouillon avec l'autorisation **Corrections de factures**. Ouvrez les trois points en haut à droite de la page de la facture et choisissez **Forcer le retour au brouillon**. Ne l'utilisez que si c'est possible sur le plan juridique et comptable. Une facture de crédit via [l'inversion](#een-factuur-omkeren) est généralement la solution la plus propre.

## Inverser une facture [#een-factuur-omkeren]

Avec l'inversion, vous créez une facture de crédit qui annule une facture comptabilisée. Cela fonctionne toujours, même si la facture a déjà été envoyée ou payée.

<Steps>
<Step>
### Inversez la facture [#keer-de-factuur-om]
Ouvrez les trois points en haut à droite de la facture comptabilisée et choisissez **Inverser la facture**. Tillor crée un nouveau brouillon avec les mêmes lignes en montants négatifs et l'ouvre.
</Step>
<Step>
### Vérifiez et comptabilisez [#controleer-en-boek]
Adaptez le brouillon si nécessaire et cliquez sur **Comptabiliser la facture**. Il devient alors une **Facture de crédit**.
</Step>
</Steps>

Les deux factures renvoient l'une à l'autre. Dans les **Informations sur la facture**, la facture de crédit indique **Contre-passation de** et la facture d'origine **Contre-passée en**. Dans la liste des factures du profil client, le brouillon porte l'étiquette **Brouillon de contre-passation** et la facture d'origine **Cette facture a été contre-passée**.

Si vous avez déjà inversé une facture auparavant, Tillor demande une confirmation avec **Oui, contre-passer à nouveau**, pour que vous ne créiez pas deux factures de crédit par erreur.

Si vous voulez compenser la facture de crédit avec la facture d'origine, choisissez **Virement interne** lors du paiement. Voir [Virement interne](/betalingsverwerking/interne-overboeking).

## Copier une facture [#een-factuur-kopiëren]

Choisissez **Copier la facture** dans le menu d'actions d'une facture comptabilisée. Tillor crée un nouveau brouillon avec les mêmes lignes, la même note et le même mandat de prélèvement, et l'ouvre. La ligne **Arrondi** n'est pas copiée.

## Déplacer une facture vers un autre client [#een-factuur-verplaatsen-naar-een-andere-klant]

<Requires permission="Corrections de factures" />

Si une facture est sur le mauvais client, vous la déplacez.

<Steps>
<Step>
### Ouvrez le menu d'actions [#open-het-actiemenu]
Cliquez sur les trois points en haut à droite de la page de la facture et choisissez **Déplacer vers un client**.
</Step>
<Step>
### Choisissez le client [#kies-de-klant]
Choisissez le **Client cible** et cliquez sur **Déplacer la facture**.
</Step>
</Steps>

La facture déménage avec les paiements associés, les lots de compteurs et les remarques. Une facture comptabilisée est ensuite renvoyée à votre comptabilité. Si la facture a déjà été envoyée via Peppol, vous ne pouvez pas la déplacer.

## Recalculer une facture [#een-factuur-herberekenen]

Si les montants d'une facture comptabilisée ne correspondent pas aux lignes, choisissez **Recalculer la facture** dans le menu d'actions. Tillor recalcule les totaux.

## Supprimer un brouillon [#een-concept-verwijderen]

Vous pouvez supprimer une facture brouillon avec **Supprimer la facture** dans le menu d'actions. Vous revenez alors sur le profil du client. Les factures comptabilisées ne peuvent pas être supprimées, vous les inversez.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

| Voie | Conséquence |
|-------|-----------|
| Remettre en brouillon | Le numéro de facture est conservé. Lors d'une nouvelle comptabilisation, la facture retrouve son numéro et ses dates d'origine. |
| Inverser | Une facture de crédit est créée, qui renvoie à la facture d'origine. La compensation est possible avec un [virement interne](/betalingsverwerking/interne-overboeking). |
| Copier | Un nouveau brouillon est créé. La facture d'origine ne change pas. |
| Déplacer | Les paiements, les lots de compteurs et les remarques suivent. Une facture comptabilisée repart vers votre comptabilité. |
| Recalculer | Les totaux sont recalculés à partir des lignes. |

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Revenir au brouillon">
Une des conditions n'est pas remplie. Une notification a-t-elle déjà été envoyée ou la facture a-t-elle 7 jours ou plus ? Vous pouvez alors l'inverser, ou la remettre en brouillon de force avec l'autorisation **Corrections de factures**.
</Accordion>
<Accordion title="Déplacer vers un client est absent">
Vous avez pour cela besoin de l'autorisation **Corrections de factures**. Si la facture a été envoyée via Peppol, le déplacement n'est pas possible.
</Accordion>
<Accordion title="Quelles autorisations a mon utilisateur ?">
Un administrateur les définit. Voir [Utilisateurs](/gebruikers).
</Accordion>
</Accordions>

## Pour aller plus loin [#verder]

<Cards>
  <Card title="Comptabiliser une facture" href="/facturen/boeken" />
  <Card title="Statuts" href="/facturen/statussen" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Envoyer des factures via Peppol" />
</Cards>


# Récapitulatif (/fr-FR/facturen)

Sous <UIPath>Administration > Factures</UIPath>, vous trouvez toutes les factures de votre parc, avec les montants restant dus en haut. Une facture commence comme brouillon et ne devient définitive que lorsque vous la comptabilisez. Ensuite, vous pouvez l'envoyer, la faire payer et éventuellement la corriger.

<Callout type="info" title="Bon à savoir">
- Vous créez une nouvelle facture sur le profil du client, pas depuis cette liste.
- Une facture comptabilisée reçoit une date d'échéance : le jour de la comptabilisation plus l'échéance par défaut de votre organisation, par défaut 7 jours. Vous pouvez choisir un autre délai pour chaque facture.
- Si le total n'est pas un multiple de 5 centimes, Tillor ajoute une ligne **Arrondi** lors de la comptabilisation.
- Tillor n'envoie pas de lui-même une facture comptabilisée au client. Vous le faites vous-même avec **Envoyer la notification**.
- La remise en brouillon est possible jusqu'à 7 jours après la date de facture, tant qu'aucune notification n'a été envoyée et que la facture n'a pas été envoyée via Peppol. Après cela, vous inversez la facture avec une facture de crédit.
- Un paiement en espèces est limité par défaut à 2999 euros. Vous l'adaptez avec **Montant maximal en espèces** sous <UIPath>Support > Paramètres > Paiements</UIPath>.
- Un prélèvement avec un mandat SEPA part vers la banque deux jours après la comptabilisation. Jusque-là, vous pouvez annuler le paiement.
- Le lien personnel d'une facture n'a pas de date d'expiration. Le client y voit ce qui reste dû.
- Si le client a un ID Peppol, Tillor envoie automatiquement la facture via Peppol après la comptabilisation.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une facture est le début d'une chaîne. Un paiement se rattache à une facture comptabilisée, les paiements d'un jour vont dans un rapport de paiements et ce rapport va à votre comptabilité.

```mermaid
flowchart LR
  A[Facture brouillon] -- Comptabiliser --> B[Facture comptabilisée]
  B -- Envoyer la notification --> K[Le client reçoit la facture]
  K -- Le client paie en ligne --> C[Paiement]
  B -- Vous enregistrez un paiement --> C
  C -- Solde et statut de paiement --> B
  C -- Regroupés par jour --> D[Rapport de paiements]
  D -- Mollie et virements internes --> E[Comptabilité]
```

- Le solde restant dû et le statut de paiement de la facture découlent d'eux-mêmes des paiements.
- Un paiement sans facture peut être associé plus tard à une facture comptabilisée.
- Les paiements qui vont à la comptabilité sont décrits dans [Comptabilité](/boekhouden).

## La liste des factures [#de-facturenlijst]

En haut figurent quatre compteurs : **Total des factures**, **Factures ouvertes** (non payées ou partiellement payées), **Factures en retard** (date d'échéance dépassée) et **Total impayé** (le montant total des factures ouvertes).

Dessous figurent quatre listes :

- **Paiements en attente** : factures comptabilisées dont le paiement a démarré mais n'est pas encore définitivement reçu
- **Factures avec solde impayé** : factures comptabilisées avec un montant encore à payer, triées par date d'échéance
- **Brouillons** : les dix dernières factures brouillon créées
- **Toutes les factures** : la liste complète, filtrée par défaut sur les factures comptabilisées

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Récapitulatif des factures - Toutes les factures" />

Vous ne créez pas de nouvelles factures depuis cette liste. Vous le faites sur le profil du client, voir [Créer une facture](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken).

### Rechercher et filtrer [#zoeken-en-filteren]

La barre de recherche cherche par numéro de facture, prénom ou nom du client, adresse e-mail et montant. Dans la liste **Toutes les factures**, vous pouvez en outre filtrer sur :

| Filtre | Ce que vous en faites |
|--------|-------------------|
| **Période** | Uniquement les factures d'une certaine période |
| **Statut** | **Brouillon** ou **Comptabilisé** |
| **Statut de paiement** | **Non payé**, **Partiellement**, **En cours** ou **Payé** |
| **Type de client** | **Standard**, **Ouvrier Location Caravane** ou **Ouvrier Caravane Remorque** |
| **Client** | Toutes les factures d'un client |
| **Produits** | Factures avec un certain produit sur une ligne |
| **Montant** | Factures avec un montant minimal ou maximal |

Dans la liste **Factures avec solde impayé** figure aussi le filtre **À relancer**. Vous choisissez un nombre de jours (7 à 90) et vous voyez alors les factures en retard créées il y a au moins aussi longtemps et pour lesquelles aucun rappel par e-mail ou SMS n'a été envoyé ces derniers jours. Pratique pour déterminer qui relancer à nouveau.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Factures avec solde impayé" />

### Factures par client [#facturen-per-klant]

Sur un profil client, vous trouvez toutes les factures de ce client dans le bloc **Factures** de l'onglet **Récapitulatif**, ou dans l'onglet **Facturation**. Vous y créez aussi une nouvelle facture.

## Guides [#handleidingen]

<Cards>
  <Card title="Créer et modifier" href="/facturen/aanmaken-en-bewerken" description="Créer une facture brouillon et ajouter des lignes" />
  <Card title="Comptabiliser une facture" href="/facturen/boeken" description="Rendre la facture définitive" />
  <Card title="Envoyer une facture" href="/facturen/versturen" description="Notification ou rappel au client" />
  <Card title="Enregistrer des paiements" href="/facturen/betalingen-registreren" description="Enregistrer ou associer un paiement" />
  <Card title="Imprimer et télécharger" href="/facturen/afdrukken-en-downloaden" description="PDF, imprimante et lien personnel" />
  <Card title="Corriger" href="/facturen/corrigeren" description="Remettre en brouillon, inverser, copier et déplacer" />
  <Card title="Statuts" href="/facturen/statussen" description="Ce que signifient Brouillon, Comptabilisé et Payé" />
</Cards>

## Voir aussi [#gerelateerd]

<Cards>
  <Card title="Traitement des paiements" href="/betalingsverwerking" description="Les modes de paiement en détail" />
  <Card title="Produits" href="/producten" description="Actions sur les lignes de facture" />
  <Card title="Comptabilité" href="/boekhouden" description="Rapports de paiements et liens avec la comptabilité" />
  <Card title="Exemples pratiques" href="/praktijk" description="Exemples détaillés issus de la pratique" />
</Cards>

## Notions [#begrippen]

- **Brouillon** : une facture que vous pouvez encore modifier, avec un numéro de brouillon provisoire.
- **Comptabilisé** : une facture définitive avec son propre numéro de facture. Voir [Comptabilisation](/begrippen#boeken).
- **Facture de crédit** : une facture comptabilisée avec un total négatif, par exemple après l'inversion d'une facture.
- **Statut de paiement** : si et combien de la facture a été payé. Voir [Statuts](/facturen/statussen).
- **Client** : le client pour qui est la facture. Voir [Client](/begrippen#klant).
- **Occupation** : un client sur un terrain pour une période. Voir [Occupation](/begrippen#bezetting).


# Statuts des factures (/fr-FR/facturen/statussen)

Chaque facture a un **statut** (si elle est déjà définitive) et, une fois comptabilisée, un **statut de paiement** (combien a été payé). Vous pouvez filtrer les deux dans la [liste des factures](/facturen).

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Liste des factures avec statut et statut de paiement par facture" />

## Statut de la facture [#factuurstatus]

| Statut | Signification |
|--------|-----------|
| <Status>Brouillon</Status> | La facture est encore modifiable et a un numéro de brouillon provisoire. Vous ne pouvez pas encore l'envoyer ni la faire payer. |
| <Status tone="success">Comptabilisé</Status> | La facture est définitive et a son propre numéro de facture. Vous pouvez l'envoyer, la faire payer et la corriger. |

Un brouillon issu d'une facture comptabilisée remise en brouillon a un numéro de brouillon avec le numéro de facture d'origine entre parenthèses. Voir [Corriger une facture](/facturen/corrigeren).

## Statut de paiement [#betalingsstatus]

Le statut de paiement figure à côté du numéro de facture d'une facture comptabilisée.

| Statut | Signification |
|--------|-----------|
| <Status tone="error">Non payé</Status> | Rien n'a encore été payé. |
| <Status tone="warning">Partiellement</Status> | Une partie a été payée et un montant reste dû. |
| <Status tone="info">En cours</Status> | Le montant total a été lancé, par exemple un prélèvement, mais l'argent n'est pas encore définitivement traité. |
| <Status tone="success">Payé</Status> | La facture est entièrement réglée. |

Une facture est **en retard** si la date d'échéance est dépassée et qu'un montant reste dû. Ce n'est pas un statut distinct. Vous le voyez dans le compteur **Factures en retard** de la liste des factures.

## Type de facture [#factuurtype]

| Type | Signification |
|------|-----------|
| **Facture** | Une facture ordinaire avec un total positif. |
| **Facture de crédit** | Une facture comptabilisée avec un total négatif, par exemple après [l'inversion d'une facture](/facturen/corrigeren#een-factuur-omkeren). |

## Étiquettes dans la liste du profil client [#labels-in-de-lijst-op-het-klantprofiel]

| Étiquette | Signification |
|-------|-----------|
| **Envoyée via Peppol** | La facture a été envoyée via Peppol. |
| **Brouillon de contre-passation** | Ce brouillon a été créé pour inverser une autre facture. |
| **Cette facture a été contre-passée** | Une facture de crédit ou un brouillon annule cette facture. |

## Pour aller plus loin [#verder]

<Cards>
  <Card title="Récapitulatif" href="/facturen" description="La liste des factures et les filtres" />
  <Card title="Enregistrer des paiements" href="/facturen/betalingen-registreren" />
</Cards>


# Envoyer une facture (/fr-FR/facturen/versturen)

Avec **Envoyer la notification**, vous envoyez au client une facture comptabilisée par e-mail, SMS, WhatsApp ou courrier. Tillor ne le fait jamais de lui-même. Si la facture a déjà été envoyée mais pas encore payée, vous envoyez un rappel. Le client peut ensuite payer via le lien du message, voir [Laisser un client payer en ligne](/betalingsverwerking/online).

Avant de commencer :

- La facture est comptabilisée. Sur un brouillon, les boutons sont absents.
- Le client a au moins une adresse e-mail, un numéro de téléphone ou une adresse postale complète (rue, code postal et commune). Sinon, les boutons sont absents.
- Pour un rappel, un montant reste dû.

## Envoyer une facture [#een-factuur-versturen]

<Steps>
<Step>
### Ouvrez la facture comptabilisée [#open-de-geboekte-factuur]
Allez à <UIPath>Administration > Factures</UIPath> et ouvrez une facture avec le statut <Status tone="success">Comptabilisé</Status>.
</Step>
<Step>
### Cliquez sur Envoyer la notification [#klik-op-verstuur-notificatie]
Une fenêtre **Envoyer la notification** s'ouvre.
</Step>
<Step>
### Choisissez les canaux [#kies-de-kanalen]
Vous pouvez choisir parmi :

- **E-mail** : le client reçoit un e-mail avec la facture en pièce jointe. Activé par défaut s'il y a une adresse e-mail.
- **SMS** : le client reçoit un SMS. Disponible uniquement avec un numéro de téléphone.
- **WhatsApp** : visible uniquement si WhatsApp Business est installé. Demande un numéro de téléphone, et un moyen de paiement chez Meta ou une conversation en cours avec le client.
- **Courrier** : la facture part en PDF par la poste. Disponible uniquement avec une adresse postale complète. Désactivé par défaut et affiche un montant indicatif d'affranchissement par lettre.

Un canal impossible pour ce client est désactivé, avec la raison, par exemple **Aucune adresse e-mail connue**. Choisissez au moins un canal.
</Step>
<Step>
### Envoyez [#verstuur]
Cliquez sur **Envoyer**.
</Step>
</Steps>

## Envoyer un rappel [#een-aanmaning-versturen]

Un rappel est possible dès que la facture est comptabilisée et qu'un montant reste dû.

<Steps>
<Step>
### Ouvrez le menu de choix [#open-het-keuzemenu]
Cliquez sur la flèche à côté de **Envoyer la notification** et choisissez **Envoyer un rappel**.
</Step>
<Step>
### Choisissez les canaux [#kies-de-kanalen-1]
Ici, **E-mail** et **SMS** sont activés par défaut si le client a une adresse e-mail et un numéro de téléphone. Avec **Courrier**, le client reçoit une lettre de rappel avec la facture en pièce jointe, avec un code QR pour la consulter ou la payer en ligne.

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Boîte de dialogue de confirmation d'envoi d'un rappel" />
</Step>
<Step>
### Choisissez éventuellement le recommandé [#kies-eventueel-aangetekend]
Si vous avez coché **Courrier**, vous pouvez choisir **Recommandé avec accusé de réception**. C'est possible uniquement pour un rappel, pas pour la première notification de facture, et seulement si le recommandé est disponible pour cette adresse. Tillor affiche alors le supplément indicatif en plus des frais d'affranchissement habituels. Le bouton s'appelle alors **Envoyer avec frais supplémentaires**.
</Step>
<Step>
### Envoyez [#verstuur-1]
Cliquez sur **Envoyer**.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Sur la page de la facture, le bloc **Notifications** indique quels messages ont été envoyés. Tous les messages de votre organisation figurent sous <UIPath>Communication > Notifications</UIPath>.

Les envois postaux démarrent à **En attente**. Suit ensuite le statut de la lettre : **PDF reçu**, **Validé**, **En traitement**, **Au centre d'impression** et **Remis au service postal**. Dès que le transporteur le confirme, le statut devient **Envoyé**. Le courrier non distribuable passe à **Échoué**. Une lettre annulée chez le transporteur reçoit le statut **Ignoré**. Ouvrez le message pour voir le montant de l'affranchissement, la référence du transporteur et le dernier statut de suivi. Vous en saurez plus dans [Notifications](/notificaties).

- Tillor envoie le message aussitôt. Le client reçoit un lien pour consulter la facture et la payer en ligne.
- Un rappel reste une action distincte par facture. Le filtre **À relancer** dans la [liste des factures](/facturen) vous aide à choisir qui relancer.
- Les automatisations peuvent aussi envoyer des rappels automatiquement. Voir [Automatisations](/automatiseringen).

<Callout type="info">
Une facture pour laquelle une notification a déjà été envoyée ne peut plus être remise simplement en brouillon. Voir [Corriger une facture](/facturen/corrigeren#terugzetten-naar-concept).
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Envoyer la notification">
La facture doit être comptabilisée, et le client doit avoir une adresse e-mail, un numéro de téléphone ou une adresse postale complète. Complétez les données sur le profil du client.
</Accordion>
<Accordion title="Je ne vois pas Envoyer un rappel">
Un rappel n'est possible que pour une facture comptabilisée avec un montant restant dû.
</Accordion>
<Accordion title="Le message a échoué">
Ouvrez le message sous <UIPath>Communication > Notifications</UIPath> pour voir le message d'erreur. Vérifiez ensuite l'adresse e-mail, le numéro de téléphone ou l'adresse postale du client et renvoyez. Voir [Notifications](/notificaties).
</Accordion>
</Accordions>

## Pour aller plus loin [#verder]

<Cards>
  <Card title="Notifications" href="/notificaties" description="Statut et historique des messages envoyés" />
  <Card title="Enregistrer des paiements" href="/facturen/betalingen-registreren" />
</Cards>


# Inviter des utilisateurs et attribuer des autorisations (/fr-FR/gebruikers/gebruikers-en-rechten)

Un collègue qui a un compte Tillor s'appelle un utilisateur dans Tillor. Vous décidez qui a accès à votre organisation et ce que cette personne peut voir et faire, grâce aux autorisations. Pour les collègues que vous sollicitez souvent ensemble, vous créez ensuite un [groupe](/gebruikers/groepen).

Avant de commencer :

- Vous avez besoin de l'autorisation **Gérer les autorisations utilisateurs**. Sans elle, les boutons **Inviter un utilisateur** et **Modifier les autorisations** sont grisés.
- Vous ne pouvez accorder que les autorisations que vous avez vous-même. Une autorisation qui vous manque, vous ne pouvez pas l'activer pour quelqu'un d'autre.
- L'autorisation **Gérer les autorisations utilisateurs** elle-même ne peut être accordée à un autre utilisateur que par un utilisateur disposant de **Toutes les autorisations**.

## Inviter un collègue [#een-collega-uitnodigen]

<Steps>
<Step>
### Ouvrir les utilisateurs [#open-de-gebruikers]
Allez à <UIPath>Support > Paramètres > Utilisateurs</UIPath>. Vous voyez les **Membres** de votre organisation et les **Invitations en attente**.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Paramètres > Utilisateurs avec la liste des membres" />
</Step>
<Step>
### Cliquer sur Inviter un utilisateur [#klik-op-gebruiker-uitnodigen]
La fenêtre **Inviter un utilisateur** s'ouvre.

<DocScreenshot src="/screenshots/gebruikers/settings-members-invite-dialog.png" alt="La fenêtre Inviter un utilisateur" />
</Step>
<Step>
### Saisir l'adresse e-mail [#vul-het-e-mailadres-in]
Saisissez l'**Adresse e-mail** de votre collègue et cliquez sur **Inviter**.
</Step>
</Steps>

La suite dépend de l'adresse e-mail :

<Tabs items={["Il existe déjà un compte Tillor", "Pas encore de compte Tillor"]}>
<Tab value="Er is al een Tillor-account">
L'utilisateur devient directement membre de votre organisation. Tillor indique **Utilisateur ajouté à l'organisation**. La personne voit immédiatement votre organisation parmi les siennes.
</Tab>
<Tab value="Nog geen Tillor-account">
Tillor indique **Invitation envoyée** et envoie une invitation par e-mail. Tant que la personne ne s'est pas connectée pour la première fois, elle figure sous **Invitations en attente** avec le badge **En attente**. À sa première connexion, elle devient membre de votre organisation. Avec **Révoquer l'invitation**, vous retirez l'invitation, et Tillor indique **Invitation révoquée**.
</Tab>
</Tabs>

Un nouvel utilisateur reçoit au départ ces autorisations : **Voir les paramètres**, **Modifier les paramètres**, **Voir les intégrations**, **Gérer les intégrations**, **Notifications d'alarme compteur**, **Notifications de messages inbox**, **Alertes tablette et borne**, **Gérer les demandes de signature** et **Gérer les champs personnalisés**. Vérifiez que cela convient et adaptez-les si besoin.

## Modifier les autorisations [#rechten-bewerken]

<Steps>
<Step>
### Cliquer sur Modifier les autorisations pour l'utilisateur [#klik-bij-de-gebruiker-op-rechten-bewerken]
La fenêtre **Modifier les autorisations utilisateur** s'ouvre. En haut figurent les groupes dont l'utilisateur est membre. Avec **Rechercher des autorisations**, vous trouvez rapidement une autorisation.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions-dialog.png" alt="La fenêtre Modifier les autorisations utilisateur avec les autorisations par domaine" />
</Step>
<Step>
### Activer ou désactiver des autorisations [#zet-rechten-aan-of-uit]
Les autorisations sont regroupées par domaine, comme **Facturation**, **Paiements** ou **Boîte de réception**. En bas figure le nombre d'autorisations effectives de l'utilisateur.
</Step>
<Step>
### Enregistrer les autorisations [#sla-de-rechten-op]
Cliquez sur **Enregistrer les autorisations**. Tillor indique **Autorisations utilisateurs enregistrées**. 
</Step>
</Steps>

### D'où vient une autorisation ? [#waar-komt-een-recht-vandaan]

Chaque autorisation indique sa source. Vous voyez ainsi pourquoi quelqu'un peut ou ne peut pas faire quelque chose.

| Source | Signification |
|---|---|
| **Directe** | Vous avez accordé l'autorisation directement à cet utilisateur. Vous pouvez la désactiver ici |
| Un nom de groupe | Ce [groupe](/gebruikers/groepen#groepsrechten) accorde l'autorisation. Vous ne pouvez pas la désactiver ici, mais bien dans le groupe |
| **Bloquée** avec un nom de groupe | Ce groupe refuse l'autorisation. Même si l'utilisateur l'avait lui-même, elle reste bloquée |
| **Non accordé** | Personne n'accorde l'autorisation |

Le bouton **Modifier les autorisations** est grisé pour votre propre ligne et pour les utilisateurs qui ont le badge **Toutes les autorisations**. Ces utilisateurs ont tous les droits et vous ne pouvez pas les limiter.

## Régler les notifications d'un collègue [#meldingen-van-een-collega-instellen]

Avec l'icône de cloche (**Paramètres de notification**) d'un utilisateur, vous ouvrez ses notifications dans cette organisation. Pour chaque notification, vous choisissez e-mail, push ou appel téléphonique. Avec **Toutes les notifications**, vous désactivez un canal en une fois. Les modifications s'appliquent immédiatement et uniquement dans cette organisation.

<DocScreenshot src="/screenshots/gebruikers/settings-members-notifications-dialog.png" alt="La fenêtre avec les notifications d'un collègue" />

Les notifications qui sont toujours envoyées ne peuvent pas être désactivées. Ce qu'est une notification et où la retrouver est expliqué sous [Notifications](/notificaties#meldingen-in-de-app).

## Retirer un utilisateur [#een-gebruiker-verwijderen]

Cliquez sur l'icône de corbeille (**Retirer de l'organisation**) et confirmez avec **Retirer l'utilisateur**. Tillor indique **Utilisateur retiré de l'organisation**. La personne perd immédiatement l'accès à cette organisation. Son compte Tillor reste en place, ainsi que ses éventuelles autres organisations.

Vous ne pouvez pas vous retirer vous-même. Un utilisateur avec **Toutes les autorisations** ne peut être retiré que si vous avez vous-même **Toutes les autorisations**.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- L'utilisateur voit votre organisation parmi les siennes et peut utiliser tout ce pour quoi il a des autorisations.
- Une modification des autorisations s'applique immédiatement après l'enregistrement.
- Un utilisateur retiré perd immédiatement l'accès. Son compte Tillor reste en place.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le bouton Inviter un utilisateur est grisé">
Vous n'avez pas l'autorisation **Gérer les autorisations utilisateurs**. Demandez à un collègue qui a **Toutes les autorisations** de vous l'accorder.
</Accordion>
<Accordion title="Tillor indique Échec de l'invitation">
Cette adresse e-mail est déjà membre de votre organisation, ou une invitation est déjà en attente pour cette adresse. Consultez les listes **Membres** et **Invitations en attente**. Si l'invitation y figure déjà, révoquez-la et invitez à nouveau si la personne n'a pas reçu l'e-mail.
</Accordion>
<Accordion title="La personne invitée ne trouve pas son e-mail">
Demandez-lui de vérifier ses courriers indésirables. Elle ne devient membre que si elle se connecte avec exactement l'adresse e-mail avec laquelle vous l'avez invitée. Si elle se connecte avec une autre adresse, révoquez l'invitation et invitez cette adresse.
</Accordion>
<Accordion title="Une autorisation est grisée et je ne peux pas l'activer">
Vous ne pouvez accorder que les autorisations que vous avez vous-même. Si un nom de groupe figure à côté de l'autorisation, ce groupe l'accorde ou la bloque et vous la modifiez dans le groupe.
</Accordion>
<Accordion title="Modifier les autorisations est grisé pour un collègue">
Le collègue a **Toutes les autorisations**, ou c'est votre propre ligne. Vous ne pouvez pas les modifier.
</Accordion>
<Accordion title="Un collègue n'a pas un bouton alors que je lui ai accordé l'autorisation">
Dans la fenêtre **Modifier les autorisations utilisateur**, vérifiez si un groupe affiche l'autorisation comme **Bloquée**. Un refus d'un groupe l'emporte toujours sur une autorisation que vous avez accordée directement.
</Accordion>
<Accordion title="Je ne peux pas retirer un utilisateur">
Vous ne pouvez pas vous retirer vous-même. Un utilisateur avec **Toutes les autorisations** ne peut être retiré que si vous avez vous-même **Toutes les autorisations**.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Groupes" href="/gebruikers/groepen" description="Regrouper des collègues et définir les autorisations par groupe" />
  <Card title="Notifications" href="/notificaties" description="Comment les notifications arrivent" />
  <Card title="Visibilité et accès des champs personnalisés" href="/eigen-velden/zichtbaarheid-en-toegang" description="Autorisations par champ personnalisé" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Toutes les sections de Paramètres" />
</Cards>


# Groupes (/fr-FR/gebruikers/groepen)

Un groupe est un ensemble fixe de collègues, par exemple **Réception** ou **Service technique**. Vous utilisez un groupe à ces endroits :

- **Attribuer des tâches** : lors de l'attribution d'une tâche, cherchez le nom du groupe
- **Mentionner et prévenir** : une mention ou une notification adressée à un groupe va à tous les membres
- **Partager des vues** : pour une vue de tâches, choisissez **Certains groupes**, voir [Vues](/taken/weergaven#wie-ziet-een-weergave)
- **Automatisations** : les étapes qui créent ou mettent à jour une tâche peuvent l'attribuer à des groupes

## Créer un groupe [#een-groep-maken]

<Steps>
<Step>
### Ouvrir Groupes [#open-groepen]
Allez à <UIPath>Support > Paramètres > Groupes</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-groups.png" alt="Paramètres > Groupes avec deux groupes" />
</Step>
<Step>
### Cliquer sur Nouveau groupe [#klik-op-nieuwe-groep]
Saisissez un **Nom**, par exemple Réception.
</Step>
<Step>
### Choisir les membres [#kies-de-leden]
Sous **Membres**, choisissez les personnes. Vous ne pouvez ajouter que des utilisateurs déjà membres de l'organisation.
</Step>
<Step>
### Cliquer sur Enregistrer [#klik-op-opslaan]
Tillor indique **Groupe enregistré**.
</Step>
</Steps>

Cliquez sur un groupe pour modifier son nom ou ses membres. Si vous supprimez un groupe, les tâches restent attribuées à ceux qui y figurent directement. Seul le groupe lui-même disparaît.

## Autorisations du groupe [#groepsrechten]

Un groupe peut aussi accorder ou retirer des autorisations. Cliquez sur la petite clé (**Autorisations du groupe**) du groupe. Pour chaque autorisation, vous choisissez :

| Choix | Ce que cela fait |
|---|---|
| **Autoriser** | Toute personne du groupe reçoit l'autorisation (« Accordé à tous ») |
| **Hériter** | Le groupe ne fait rien avec cette autorisation. Chaque membre garde son propre accès (« Hérite de l'accès propre »). C'est l'état de départ |
| **Refuser** | L'autorisation est bloquée pour tous les membres du groupe (« Bloqué pour tous ») |

<DocScreenshot src="/screenshots/gebruikers/settings-group-permissions-dialog.png" alt="La fenêtre Autorisations du groupe avec Refuser, Hériter et Autoriser" />

Avec **Rechercher des autorisations**, vous trouvez rapidement une autorisation. En bas figure le nombre d'autorisations que vous avez définies. Cliquez sur **Enregistrer**, puis Tillor indique **Autorisations du groupe enregistrées**.

<Requires permission="Gérer les autorisations utilisateurs" />

Sans cette autorisation, le bouton **Autorisations du groupe** est grisé. Vous ne pouvez alors pas non plus supprimer un groupe qui a encore des autorisations de groupe.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les autorisations du groupe s'ajoutent aux autorisations propres de chaque membre. Un refus l'emporte toujours : si une autorisation est sur **Refuser** dans un groupe et sur **Autoriser** dans un autre, elle reste bloquée.
- Dans la fenêtre **Modifier les autorisations utilisateur** d'un membre, vous voyez pour chaque autorisation quel groupe l'accorde ou la bloque. Voir [Modifier les autorisations](/gebruikers/gebruikers-en-rechten#rechten-bewerken).
- Si vous ajoutez un membre, les autorisations du groupe s'appliquent aussi à lui. Si vous le retirez, elles ne s'appliquent plus.
- Attribuer une tâche, mentionner quelqu'un ou envoyer une notification au groupe atteint toutes les personnes qui en sont membres à ce moment-là.

## Groupes issus de Microsoft Entra [#groepen-uit-microsoft-entra]

Si vous gérez déjà votre personnel dans Microsoft Entra ID, Entra peut tenir automatiquement à jour les membres d'un groupe. Sous la liste des groupes figure alors le tableau **Groupes Entra**, où vous associez chaque groupe Entra à un groupe Tillor.

<Callout type="info">
Pour un groupe associé, Entra est la source. Un membre que vous ajoutez ou retirez à la main dans Tillor est de nouveau aligné sur Entra à la prochaine synchronisation.
</Callout>

Voir [Groupes Microsoft Entra](/gebruikers/microsoft-entra) pour mettre en place l'association.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor indique Le groupe n'a pas pu être enregistré">
Réessayez. Si l'échec persiste, contactez le support Tillor.
</Accordion>
<Accordion title="Le bouton Autorisations du groupe est grisé">
Vous n'avez pas l'autorisation **Gérer les autorisations utilisateurs**.
</Accordion>
<Accordion title="Un membre ne peut pas faire quelque chose alors que le groupe l'autorise">
Un autre groupe de ce membre refuse cette autorisation. Un refus l'emporte toujours. Ouvrez la fenêtre **Modifier les autorisations utilisateur** du membre pour voir quel groupe la bloque.
</Accordion>
<Accordion title="Je ne vois pas un membre dans la liste de choix">
Seuls les utilisateurs de votre organisation figurent dans la liste. Invitez d'abord la personne. Voir [Inviter des utilisateurs](/gebruikers/gebruikers-en-rechten).
</Accordion>
<Accordion title="Un membre disparaît sans cesse du groupe">
Si le groupe est associé à Microsoft Entra, Entra est la source et la prochaine synchronisation réaligne les membres. Modifiez le membre dans Entra.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Groupes Microsoft Entra" href="/gebruikers/microsoft-entra" description="Tenir les groupes à jour automatiquement depuis Entra" />
  <Card title="Vues" href="/taken/weergaven" description="Partager une vue de tâches avec un groupe" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Paramètres et autorisations des utilisateurs" />
</Cards>


# Vue d'ensemble (/fr-FR/gebruikers)

C'est ici que vous réglez qui travaille avec Tillor et ce que ces personnes peuvent faire : inviter des utilisateurs, accorder des autorisations, regrouper des collègues et adapter les paramètres de votre organisation. Un utilisateur est toute personne ayant un compte qui a accès à votre organisation. Vous gérez cela sous <UIPath>Support > Paramètres</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Paramètres > Utilisateurs avec la liste des membres" />

<Callout type="info" title="Bon à savoir">
- Un nouvel utilisateur reçoit un ensemble fixe d'autorisations de départ (paramètres, intégrations, quelques notifications, demandes de signature et champs personnalisés). Tout le reste, c'est vous qui l'accordez
- Vous ne pouvez accorder que les autorisations que vous avez vous-même. L'autorisation **Gérer les autorisations utilisateurs** ne peut être transmise que par un utilisateur disposant de **Toutes les autorisations**
- Un refus via un groupe l'emporte toujours sur une autorisation que vous avez accordée directement
- Vous ne pouvez pas vous retirer vous-même ni modifier vos propres autorisations
- Vous n'avez pas de mot de passe Tillor distinct : vous vous connectez via Google, Microsoft ou Apple
- Vous ne modifiez pas vous-même les données de l'entreprise comme le numéro de TVA ou l'IBAN. C'est le support Tillor qui s'en charge
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Un utilisateur a des autorisations de deux manières : directement, ou via un groupe. Un groupe peut aussi refuser une autorisation.

```mermaid
flowchart TD
  U[Gebruiker] -->|direct gegeven| R[Rechten van de gebruiker]
  U -->|is lid van| G[Groep]
  G -->|Toestaan| R
  G -->|Overnemen| N[Doet niets, de gebruiker houdt zijn eigen rechten]
  G -->|Weigeren| B[Recht geblokkeerd, ook als de gebruiker het zelf had]
  R --> A[Wat de gebruiker in Tillor ziet en mag doen]
  B --> A
```

- **Directe** : vous activez une autorisation dans la fenêtre **Modifier les autorisations utilisateur**. Voir [Inviter des utilisateurs et attribuer des autorisations](/gebruikers/gebruikers-en-rechten).
- **Via un groupe** : sous **Autorisations du groupe**, vous choisissez pour chaque autorisation **Autoriser**, **Hériter** ou **Refuser**. Cela vaut pour toutes les personnes du groupe. Voir [Groupes](/gebruikers/groepen).
- **Refusée** : si une autorisation est sur **Refuser** dans un seul groupe, elle est bloquée, quel que soit le nombre d'autres groupes ou d'autorisations directes qui l'accordent.
- Vous utilisez les mêmes groupes pour attribuer des tâches, mentionner et partager des vues.

## Votre propre compte [#je-eigen-account]

Dans la barre latérale, cliquez sur votre nom (en bas) et choisissez **Compte**. Vous y gérez votre profil, votre numéro de téléphone, vos sessions actives, vos applications OAuth et les plateformes de connexion associées. Sous **Notifications**, vous choisissez pour chaque notification si Tillor vous joint par e-mail ou par push. Voir [Connexion et accès](/inloggen).

## Clés API [#api-sleutels]

Une clé API permet à un autre programme de communiquer avec Tillor en votre nom. Elle appartient à votre compte. Vous les gérez sur la page de votre compte.

<Steps>
<Step>
### Ouvrir votre compte [#open-je-account]
Dans la barre latérale, cliquez sur votre nom (en bas) et choisissez **Compte**.
</Step>
<Step>
### Créer la clé [#maak-de-sleutel]
Ouvrez la section **Clés API** et cliquez sur **Créer une clé API**.
</Step>
<Step>
### La copier tout de suite [#kopieer-hem-meteen]
Ensuite, Tillor n'affiche plus la clé en entier.
</Step>
</Steps>

Via **Développeurs** (dans le même menu utilisateur), vous trouvez aussi le raccourci **Aller aux clés API**.

<Callout type="warn">
Conservez les clés API en lieu sûr et ne les partagez jamais par des canaux non sécurisés. Si une clé a fuité, supprimez-la ou cliquez sur **Régénérer** et créez-en une nouvelle si nécessaire.
</Callout>

## Sections [#onderdelen]

<Cards>
  <Card title="Inviter des utilisateurs et attribuer des autorisations" href="/gebruikers/gebruikers-en-rechten" description="Ajouter des collègues et définir ce qu'ils peuvent faire" />
  <Card title="Groupes" href="/gebruikers/groepen" description="Attribuer, mentionner et accorder des autorisations à des collègues ensemble" />
  <Card title="Groupes Microsoft Entra" href="/gebruikers/microsoft-entra" description="Tenir à jour automatiquement les membres des groupes depuis Entra" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Toutes les sections de Paramètres" />
  <Card title="Paramètres de facturation" href="/gebruikers/instellingen-facturatie" description="PDF, délai d'échéance et taux de TVA" />
  <Card title="Paramètres de paiement" href="/gebruikers/instellingen-betalingen" description="Autres, rappels et adresse d'expédition" />
  <Card title="Définir les périodes de location" href="/gebruikers/instellingen-huurperiodes" description="Fréquences de location pour les occupations" />
  <Card title="Paramètres de contrôle d'accès" href="/gebruikers/instellingen-toegangscontrole" description="Sortir avec une plaque d'immatriculation expirée" />
  <Card title="Développeurs" href="/ontwikkelaars" description="Documentation d'intégration et webhooks" />
</Cards>

## Termes [#begrippen]

- **Utilisateur** : une personne avec un compte qui a accès à votre [organisation](/begrippen#organisatie).
- **[Autorisation](/begrippen#recht)** : une permission de voir ou de faire quelque chose, comme **Modifier les produits**.
- **Toutes les autorisations** : un badge pour les utilisateurs qui ont tous les droits. Vous ne modifiez pas leurs autorisations.
- **[Groupe](/begrippen#groep)** : un ensemble fixe de collègues, avec éventuellement ses propres autorisations.
- **Invitation** : une demande en attente adressée à quelqu'un sans compte pour devenir membre.
- **Clé API** : un code avec lequel un autre programme travaille avec Tillor.

D'autres termes figurent dans le [glossaire](/begrippen).


# Paramètres de paiement (/fr-FR/gebruikers/instellingen-betalingen)

Sous <UIPath>Support > Paramètres > Paiements</UIPath> se trouvent quelques paramètres qui influencent l'enregistrement des paiements et l'envoi des notifications. Les paramètres s'appliquent à toute votre organisation.

<Requires permission="Modifier les paramètres" />

<DocScreenshot src="/screenshots/instellingen/settings-payments.png" alt="Paramètres > Paiements" />

## Paramètres [#instellingen]

| Paramètre | Ce qu'il fait |
|---|---|
| **Afficher le mode de paiement "Autres"** | Ajoute le mode **Autres** à l'écran de paiement. Vous y enregistrez des paiements avec une description libre, par exemple un chèque ou un échange. Désactivé par défaut. |
| **Par défaut : rappel pour virement manuel** | Active par défaut la case du rappel sur la communication structurée quand vous enregistrez un virement bancaire manuel. Vous pouvez encore cocher ou décocher la case pour chaque paiement. Désactivé par défaut. |
| **Montant maximal en espèces** | Un montant en euros entiers. 2999 par défaut. |
| **Adresse e-mail de l'expéditeur** | L'adresse avec laquelle Tillor envoie les notifications par e-mail. |

## Montant maximal en espèces [#maximumbedrag-contant]

Avec **Montant maximal en espèces**, vous définissez le montant maximal d'un seul paiement en espèces. Par défaut, c'est 2999 euros. Tillor le vérifie pour chaque paiement en espèces, même s'il arrive via une liaison. Si le montant est plus élevé, enregistrez-le en plusieurs parties ou choisissez un autre mode. Voir [Espèces et virement](/betalingsverwerking/contant).

## Adresse d'expédition des notifications [#afzenderadres-van-meldingen]

Si vous laissez **Adresse e-mail de l'expéditeur** vide, le nom de votre organisation figure comme expéditeur des notifications, avec une adresse de Tillor. Si vous saisissez une adresse e-mail valide, par exemple `meldingen@recreatiepark-het-meer.be`, Tillor utilise cette adresse, avec le nom de votre organisation comme nom d'expéditeur. Saisissez uniquement l'adresse, sans nom. Une adresse invalide n'est pas enregistrée.

## Enregistrer les modifications [#wijzigingen-opslaan]

Cliquez en bas sur **Enregistrer les paramètres**. Avec **Annuler**, vous rétablissez le formulaire aux valeurs enregistrées.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Espèces et virement" href="/betalingsverwerking/contant" description="Enregistrer des paiements reçus en dehors de Tillor" />
  <Card title="Enregistrer des paiements sur une facture" href="/facturen/betalingen-registreren" description="Modes de paiement et champs de l'écran de paiement" />
  <Card title="Paramètres de facturation" href="/gebruikers/instellingen-facturatie" description="Délai d'échéance, TVA et PDF" />
</Cards>


# Paramètres de facturation (/fr-FR/gebruikers/instellingen-facturatie)

Sous <UIPath>Support > Paramètres > Facturation</UIPath>, vous définissez les valeurs par défaut des factures et du PDF que vous envoyez aux clients. Les paramètres s'appliquent à toute votre organisation.

<Requires permission="Modifier les paramètres" />

<DocScreenshot src="/screenshots/instellingen/settings-invoicing.png" alt="Paramètres > Facturation" />

## Ce qui figure sur le PDF de facture [#wat-staat-er-op-de-factuur-pdf]

| Paramètre | Ce qu'il fait |
|---|---|
| **Conditions générales sur le PDF de facture** | Le PDF reçoit, pour chaque page, un verso avec les conditions générales. Le pied de page y renvoie. Le texte des conditions est fixe et mentionne la dénomination légale de votre organisation. Désactivé par défaut. |
| **Tableau récapitulatif de TVA sur le PDF de facture** | À côté des totaux figure un tableau avec, par taux de TVA, la base et le montant de TVA. Désactivé par défaut. |
| **Lignes par page du PDF de facture** | Le nombre maximal de lignes sur une page. S'il y a plus de lignes, une nouvelle page suit. 20 par défaut, 1 au minimum. |

## Délai de paiement [#betaaltermijn]

Sous **Échéance par défaut (jours)**, vous saisissez le nombre de jours entre la date de facture et la date d'échéance. Cela vaut pour les factures pour lesquelles vous n'avez pas choisi vous-même de date d'échéance. Par défaut, c'est 7 jours. Vous pouvez saisir 0 : la facture est alors échue le jour de la comptabilisation. Voir [Comptabiliser une facture](/facturen/boeken).

## Choisir les taux de TVA [#btw-tarieven-kiezen]

Sous **Taux de TVA autorisés** figurent les taux que vous pouvez choisir dans la liste de TVA des factures brouillon. Par défaut, ce sont 0 %, 6 %, 9 %, 12 % et 21 %.

1. Saisissez un pourcentage entre 0 et 100 dans le champ sous la liste. Une virgule ou un point est accepté.
2. Cliquez sur **Ajouter un taux**.
3. Retirez un taux avec la croix à côté du pourcentage.
4. Cliquez sur **Enregistrer les paramètres**.

La liste est toujours triée du plus bas au plus haut. Un taux déjà présent dans la liste ne s'ajoute pas en double. Si une ligne de facture existante porte un taux que vous retirez ensuite de la liste, ce taux reste sur cette ligne.

Cette liste ne s'affiche que si **Menu déroulant du taux de TVA sur les lignes de facture brouillon** est activé. Une facture brouillon reçoit alors une colonne de TVA où vous choisissez un taux par ligne. Si vous choisissez un produit, le taux de ce produit reste la valeur de départ. Voir [TVA](/boekhouden/belasting) et [Créer et modifier des factures](/facturen/aanmaken-en-bewerken).

## Factures automatiques pour la consommation [#automatische-facturen-voor-verbruik]

Sous **Montant minimum des factures de fournitures automatiques**, vous saisissez un montant en euros. Pour les clients avec facturation automatique des fournitures, Tillor ne crée une facture que lorsque le montant ouvert atteint ce montant. Si vous laissez le champ vide (**Pas de minimum**), tout montant ouvert est facturé.

Si un client a son propre minimum sur sa fiche client, ce minimum s'applique à ce client à la place de ce paramètre. Voir [Gestion des compteurs](/meterbeheer).

## Enregistrer les modifications [#wijzigingen-opslaan]

Cliquez en bas sur **Enregistrer les paramètres**. Avec **Annuler**, vous rétablissez le formulaire aux valeurs enregistrées. Si vous n'avez que l'autorisation **Voir les paramètres**, les champs sont grisés.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Comptabiliser une facture" href="/facturen/boeken" description="Date de facture et date d'échéance" />
  <Card title="TVA" href="/boekhouden/belasting" description="Taux de TVA et TVA sur les factures" />
  <Card title="Paramètres de paiement" href="/gebruikers/instellingen-betalingen" description="Espèces, Autres et adresse d'expédition" />
</Cards>


# Définir les périodes de location (/fr-FR/gebruikers/instellingen-huurperiodes)

Pour une occupation, vous choisissez une **Fréquence de loyer**. Les choix proposés se définissent sous <UIPath>Support > Paramètres > Périodes de loyer</UIPath>. Chaque période que vous ajoutez ici devient un choix dans la liste.

<Requires permission="Modifier les paramètres" />

<DocScreenshot src="/screenshots/instellingen/settings-occupation.png" alt="Paramètres > Périodes de loyer avec une nouvelle période" />

## Ajouter une période [#een-periode-toevoegen]

<Steps>
<Step>
### Ajouter une période [#voeg-een-periode-toe]
Ouvrez **Périodes de loyer** et cliquez sur **Ajouter une période**. Un bloc apparaît avec les valeurs de départ : janvier, 12 mois.
</Step>
<Step>
### Remplir la période [#vul-de-periode-in]
Choisissez le **Mois de début** et saisissez sous **Durée (mois)** un nombre de 1 à 12. Une période de 12 mois qui commence en janvier est une année civile. Une période de 1 mois est une location mensuelle. Sous **Libellé**, vous pouvez mettre un nom personnalisé, par exemple Annuelle.
</Step>
<Step>
### Choisir comment arrondir [#kies-hoe-je-afrondt]
La case **Arrondir les dates de début à la période suivante** est cochée par défaut. Ce qu'elle fait se lit sous [Arrondir à la période suivante](#afronden-naar-de-volgende-periode).
</Step>
<Step>
### Enregistrer [#sla-op]
Cliquez sur **Enregistrer les paramètres**. Avec **Retirer la période**, vous supprimez une période. Avec **Annuler**, vous rétablissez le formulaire à la liste enregistrée.
</Step>
</Steps>

Si vous n'avez pas encore ajouté de périodes, **Aucune période de loyer définie** s'affiche. Dans le formulaire d'une occupation, vous ne pouvez alors choisir aucune fréquence de loyer.

## Où retrouver les périodes [#waar-zie-je-de-periodes-terug]

Dans le formulaire d'une occupation, la liste se trouve sous **Fréquence de loyer**, avec **Aucune fréquence** en haut. Une période de 1 mois s'y appelle **Mensuel**. Une période de 12 mois s'affiche comme **Année (janv. - déc.)**, avec le premier et le dernier mois de votre période. Les autres durées s'affichent comme **6 mois (avr. - sept.)**. Si vous avez renseigné un **Libellé** pour une période, ce libellé remplace ce texte, dans la liste et dans la colonne **Fréquence de loyer** des occupations.

Si vous retirez une période des paramètres, les occupations déjà créées avec elle conservent leur fréquence de loyer.

## Arrondir à la période suivante [#afronden-naar-de-volgende-periode]

La case détermine l'état de départ de **Arrondir à la prochaine limite de période** sur la ligne de facture avec laquelle vous prolongez une occupation. Sur la ligne de facture, vous pouvez toujours cocher ou décocher la case vous-même.

- Si la case est cochée, la ligne se termine à la prochaine limite de période. Si vous commencez au milieu d'une période, vous facturez la première partie au prorata. Ensuite, le client suit le même cycle que les autres locataires.
- Si la case est décochée, la ligne dure exactement une période à partir de la date de début.

Voir [Créer et modifier des factures](/facturen/aanmaken-en-bewerken) et [Occupations](/bezettingen).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Occupations" href="/bezettingen" description="Lier un client à un emplacement sur la durée" />
  <Card title="Créer et modifier des factures" href="/facturen/aanmaken-en-bewerken" description="Arrondir à la prochaine limite de période sur une ligne de facture" />
</Cards>


# Paramètres de contrôle d'accès (/fr-FR/gebruikers/instellingen-toegangscontrole)

Sous <UIPath>Support > Paramètres > Contrôle d'accès</UIPath>, vous réglez le comportement des barrières pour les plaques dont la période d'accès a expiré.

<Requires permission="Modifier les paramètres" />

<DocScreenshot src="/screenshots/instellingen/settings-access-control.png" alt="Paramètres > Contrôle d'accès" />

## Laisser sortir les plaques expirées [#verlopen-kentekens-laten-uitrijden]

Un visiteur dont la plaque a une période d'accès expirée ne passe sinon plus la barrière de sortie. Avec **Autoriser la sortie des plaques expirées**, la barrière de sortie s'ouvre tout de même, pendant un délai de grâce après l'expiration. Cela ne fonctionne qu'en dehors des heures d'ouverture. Si la réception est ouverte, le personnel traite le véhicule au comptoir.

La case est cochée par défaut. Si vous la décochez, la barrière de sortie reste fermée pour une plaque expirée.

| Paramètre | Ce qu'il fait |
|---|---|
| **Autoriser la sortie des plaques expirées** | Active ou désactive le délai de grâce. |
| **Délai de grâce de sortie (jours)** | Le nombre de jours après l'expiration pendant lesquels un véhicule peut encore sortir en dehors des heures d'ouverture. 2 par défaut, 30 au maximum. Avec 0, il n'y a pas de délai de grâce. |

Le délai de grâce ne vaut que pour les plaques à une sortie. Une plaque bloquée ou inactive n'obtient jamais de délai de grâce. Pour les autres méthodes d'accès, comme les tags NFC ou les codes QR, le délai de grâce n'existe pas.

Les heures d'ouverture proviennent de <UIPath>Support > Paramètres > Heures d'ouverture</UIPath>. Voir [Heures d'ouverture](/gebruikers/organisaties#openingsuren).

## Enregistrer les modifications [#wijzigingen-opslaan]

Cliquez en bas sur **Enregistrer les paramètres**. Avec **Annuler**, vous rétablissez le formulaire aux valeurs enregistrées.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Contrôle d'accès" href="/toegangscontrole" description="Points d'accès, véhicules et journal" />
  <Card title="Organisation" href="/gebruikers/organisaties" description="Heures d'ouverture et autres paramètres" />
</Cards>


# Groupes Microsoft Entra (/fr-FR/gebruikers/microsoft-entra)

Avec le provisioning, Microsoft Entra ID envoie vos utilisateurs et groupes à Tillor. Si vous associez un groupe Entra à un [groupe](/gebruikers/groepen) Tillor, les membres de ce groupe suivent Entra : la personne que vous ajoutez dans Entra reçoit les tâches et les vues du groupe, et celle que vous retirez ou désactivez les perd. Personne n'a besoin de se reconnecter pour cela.

Entra utilise pour cela le protocole SCIM. Tillor ne lit rien lui-même dans votre tenant Microsoft : c'est Entra qui décide quels utilisateurs et groupes il envoie. Seulement pendant la [configuration rapide](#snel-instellen), votre navigateur parle à Microsoft pour créer l'application à votre place.

## Ce qui se passe et ne se passe pas [#wat-er-wel-en-niet-gebeurt]

- **Uniquement les membres existants.** Entra ne crée pas de comptes Tillor. Une personne qui n'est pas encore membre de votre organisation ne compte pas tant que vous ne l'avez pas [invitée](/gebruikers/organisaties). Dès qu'elle devient membre, elle entre aussitôt dans ses groupes associés
- **Aucune donnée des non-membres.** Pour les personnes sans compte Tillor, Tillor ne conserve ni nom ni adresse e-mail, seulement un code illisible grâce auquel Tillor les reconnaît si elles deviennent membres plus tard
- **Rien sans association.** Un groupe Entra ne change quelque chose dans Tillor que lorsque vous l'associez à un groupe Tillor sous **Groupes Entra non liés**
- **Un pour un.** Un groupe Tillor appartient à un seul groupe Entra au maximum
- **Le nom reste celui de Tillor.** Si vous renommez le groupe dans Entra, vous voyez le nouveau nom après **Entra ·**, mais le groupe Tillor garde son propre nom
- **Les groupes imbriqués** ne sont pas dépliés. Un groupe qui est membre d'un autre groupe ne compte pas comme membre. Si vous voulez aussi ces personnes, attribuez le groupe imbriqué séparément dans Entra et associez-le au même groupe Tillor ou à un autre
- **La connexion ne change pas.** Les personnes se connectent simplement avec Microsoft, voir [Connexion](/inloggen)

## Avant de commencer [#voordat-je-begint]

Il vous faut :

- Dans Tillor, l'autorisation **Modifier les paramètres**
- Dans Microsoft Entra, le rôle **Cloud Application Administrator** ou **Application Administrator** (ou supérieur)
- Une licence Entra qui autorise le provisioning automatique vers des applications propres (Microsoft Entra ID P1 ou supérieur)

Veillez à ce que vos collègues aient dans Tillor le même compte Microsoft ou la même adresse e-mail que dans Entra. Ainsi Tillor reconnaît qui est qui, voir [Comment Tillor reconnaît les personnes](#hoe-tillor-mensen-herkent).

## Configuration rapide [#snel-instellen]

Si vous êtes vous-même administrateur Entra, Tillor prépare l'association en une seule fois pour vous.

1. Allez à **Support > Paramètres** et choisissez **Groupes**
2. Sous **Microsoft Entra**, cliquez sur **Configurer avec Microsoft** puis sur **Se connecter et configurer**
3. Dans la fenêtre de Microsoft, connectez-vous avec votre compte administrateur et donnez votre accord. Microsoft demande l'autorisation de gérer les applications et le provisioning et de lire vos groupes

Tillor crée alors l'application dans Entra, renseigne l'URL du locataire et le jeton, fait reconnaître les utilisateurs par leur compte Microsoft et fait envoyer par Entra le type de chaque groupe. Ensuite la synchronisation démarre et Tillor vous envoie, vous et tous vos groupes, immédiatement, pour que vous n'ayez pas à attendre la première synchronisation. Enfin, Tillor lit pour chaque groupe le type et s'il y a une équipe associée. Vous voyez chaque étape se cocher. Tillor le fait en arrière-plan : vous pouvez fermer la fenêtre ou même la page. Si vous cliquez plus tard à nouveau sur **Configurer avec Microsoft**, vous voyez où en est l'opération, ou, jusqu'à une heure après la fin, si elle a réussi ou échoué. Vous pouvez ensuite recommencer avec **Configurer à nouveau**.

Entra envoie alors tous vos utilisateurs et groupes. Vous n'avez rien à choisir au préalable : les groupes apparaissent sous **Groupes Entra non liés** et ne changent rien tant que vous ne les associez pas. Pour cela, poursuivez avec [Associer des groupes dans Tillor](#groepen-koppelen-in-tillor). Les membres des groupes suivent avec la première synchronisation. Elle dure quelques minutes, quelques heures pour les grandes organisations.

<Callout type="info">
Tillor n'utilise l'accès que pour cette configuration. Il part chiffré vers la tâche d'arrière-plan et n'est ensuite conservé nulle part ; Microsoft le laisse expirer de lui-même au bout d'environ une heure. Si vous relancez **Configurer avec Microsoft**, Tillor retrouve la même application et n'en crée pas une seconde.
</Callout>

<Callout type="warn">
La configuration rapide crée un nouveau jeton. Un jeton que vous aviez collé à la main dans Entra ne fonctionne plus ensuite. Si la configuration s'arrête en cours de route, cliquez sur **Réessayer**.
</Callout>

Si la connexion échoue, par exemple parce que votre organisation bloque l'autorisation des applications, ou si vous voulez qu'Entra n'envoie que certains groupes, configurez l'association à la main comme ci-dessous.

## Configuration manuelle [#handmatig-instellen]

<Steps>
<Step>

### Créer un jeton dans Tillor [#token-maken-in-tillor]

1. Allez à **Support > Paramètres** et choisissez **Groupes**
2. En haut figure **Microsoft Entra**. Si l'association est déjà configurée, cliquez sur **Connexion**
3. Copiez l'**URL du locataire**. Elle ressemble à `https://…/api/orgs/<organisatie>/scim/v2`
4. Cliquez sur **Générer un jeton** et copiez le jeton qui apparaît

<Callout type="warn">
Le jeton n'est affiché qu'une seule fois. Collez-le tout de suite dans Entra. Si vous l'avez perdu, cliquez sur **Remplacer le jeton** et utilisez le nouveau jeton.
</Callout>

</Step>
<Step>

### Créer une application dans Entra [#een-app-maken-in-entra]

1. Ouvrez le [centre d'administration Microsoft Entra](https://entra.microsoft.com)
2. Allez à **Identity > Applications > Enterprise applications** et cliquez sur **New application**
3. Cliquez sur **Create your own application**
4. Donnez un nom à l'application, par exemple **Tillor**, choisissez **Integrate any other application you don't find in the gallery (Non-gallery)** et cliquez sur **Create**

Si vous avez déjà une enterprise application pour Tillor, vous pouvez aussi l'utiliser.

</Step>
<Step>

### Associer le provisioning [#provisioning-koppelen]

1. Dans l'application, ouvrez **Provisioning** et cliquez sur **Get started** (ou **New configuration**)
2. Mettez **Provisioning Mode** sur **Automatic**
3. Sous **Admin Credentials**, renseignez :
   - **Tenant URL** : l'URL du locataire de Tillor
   - **Secret Token** : le jeton de Tillor
4. Cliquez sur **Test Connection**. Entra doit indiquer que la connexion a réussi
5. Cliquez sur **Save**

</Step>
<Step>

### Vérifier les attributs [#attributen-controleren]

Sous **Mappings**, ouvrez la règle **Provision Microsoft Entra ID Users** :

- Mettez **externalId** sur **objectId** (par défaut, c'est **mailNickname**). Tillor reconnaît alors une personne par son compte Microsoft, même si l'adresse e-mail diffère
- Laissez **userName** (← **userPrincipalName**), **active** et **emails[type eq "work"].value** (← **mail**) en place

Laissez **Provision Microsoft Entra ID Groups** activé. Les réglages par défaut (**displayName**, **externalId** ← **objectId**, **members**) conviennent.

Si vous voulez voir dans Tillor de quel type de groupe il s'agit, ajoutez ces attributs aux groupes. Sous **Show advanced options**, choisissez d'abord **Edit attribute list for customappsso** et ajoutez les attributs cibles, puis pour chaque règle **Add New Mapping** :

| Source dans Entra | Attribut cible | Type |
|---|---|---|
| Expression `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 |

Si une source manque dans la liste d'Entra, sautez cette règle. Entra ne peut pas transmettre ainsi si une équipe est associée à un groupe ; Tillor ne le voit que via **Configurer avec Microsoft**.

Vous pouvez laisser les autres attributs. Tillor ne les enregistre pas.

</Step>
<Step>

### Attribuer des groupes [#groepen-toewijzen]

1. Dans l'application, ouvrez **Users and groups** et cliquez sur **Add user/group**
2. Choisissez les groupes que Tillor doit recevoir, par exemple **Réception**, et cliquez sur **Assign**
3. Sous **Provisioning > Settings**, vérifiez que **Scope** est sur **Sync only assigned users and groups**

Entra envoie un groupe avec ses membres. Vous n'avez pas à attribuer les membres séparément.

</Step>
<Step>

### Démarrer le provisioning [#provisioning-starten]

Sous **Provisioning**, mettez **Provisioning Status** sur **On** et cliquez sur **Save**.

Le premier cycle peut prendre un moment, selon le nombre d'utilisateurs. Ensuite, Entra envoie les modifications environ toutes les 40 minutes. Si vous voulez mettre à jour une seule personne tout de suite, utilisez **Provision on demand** dans Entra.

</Step>
<Step>

### Associer des groupes dans Tillor [#groepen-koppelen-in-tillor]

Actualisez **Paramètres > Groupes**. En haut figure la ligne **Microsoft Entra** avec la dernière synchronisation et le nombre de groupes liés. Sous vos groupes Tillor figure **Groupes Entra non liés** avec les groupes envoyés qui ne font encore rien. Cliquez sur **Afficher** si la liste est fermée et utilisez le champ de recherche pour trouver un groupe. Pour chaque groupe, choisissez sous **Lier à…** ce qui doit se passer, puis cliquez sur **Enregistrer**. Avec **Annuler les modifications**, vous écartez vos choix. Un groupe Tillor ne peut être rattaché qu'à un seul groupe Entra ; les groupes déjà liés ne peuvent pas être choisis une nouvelle fois.

| Choix | Ce qui se passe |
|---|---|
| **Créer** | Tillor crée un groupe avec le nom issu d'Entra et le remplit avec les membres reconnus |
| Un groupe existant | Les membres de ce groupe sont remplacés par les membres reconnus issus d'Entra. Si Entra n'a pas encore envoyé les membres de ce groupe, les membres actuels restent en place jusqu'à ce que la synchronisation les livre |

Désormais, Entra met à jour les membres à chaque synchronisation. Le groupe lié disparaît de la liste et, dans vos groupes Tillor, **Entra · [nom]** figure sous le groupe avec le type de groupe.

L'association ne se fait que depuis **Groupes Entra non liés**. Un groupe Tillor que vous gérez à la main, comme IT, ne s'associe pas depuis le groupe lui-même.

Après chaque nom de groupe figure le type de groupe dans Entra. Avec les boutons au-dessus de la liste, vous n'affichez qu'un seul type.

| Libellé | Ce que c'est |
|---|---|
| **Sécurité** | Un groupe de sécurité ordinaire, souvent le groupe que vous voulez associer |
| **Sécurité à extension messagerie** | Un groupe de sécurité avec sa propre adresse e-mail |
| **Liste de distribution** | Uniquement une liste de diffusion e-mail |
| **Microsoft 365** | Un groupe avec une boîte aux lettres partagée et un site SharePoint, parfois avec une équipe |
| **Windows Server AD** | Provient de votre Active Directory local (hybride) et y est géré |
| **Dynamique** | Entra détermine lui-même les membres avec une règle |
| **Teams** | Une équipe est associée |
| **Type inconnu** | Tillor ne connaît pas encore le type. Relancez **Configurer avec Microsoft** |

Les groupes de site SharePoint, comme **Propriétaires**, **Membres** et **Visiteurs** d'un site, ne sont pas des groupes Entra. Ils n'arrivent jamais dans Tillor. Ce que vous voyez, c'est le groupe Microsoft 365 derrière le site.

</Step>
</Steps>

## Comment Tillor reconnaît les personnes [#hoe-tillor-mensen-herkent]

Pour chaque utilisateur qu'Entra envoie, Tillor cherche un membre existant de votre organisation :

1. D'abord par le **compte Microsoft** avec lequel cette personne se connecte à Tillor (l'ID d'objet Entra, si vous mettez **externalId** sur **objectId**)
2. Sinon par **adresse e-mail** : l'adresse professionnelle d'Entra, ou le **userPrincipalName** si c'est une adresse e-mail

Si Tillor ne trouve personne, ou si l'utilisateur est désactivé dans Entra, il ne compte pas dans le groupe. Dès que la personne devient membre de l'organisation, elle compte aussitôt. Si vous la réactivez dans Entra, elle compte à la prochaine synchronisation.

## Ce qui se passe lors de modifications dans Entra [#wat-er-gebeurt-bij-wijzigingen-in-entra]

| Dans Entra | Dans Tillor |
|---|---|
| Membre ajouté à un groupe lié | Entre dans le groupe Tillor (s'il est membre de l'organisation) |
| Membre retiré du groupe | Sort du groupe Tillor |
| Utilisateur désactivé (**Account enabled** désactivé) | Sort de tous les groupes Tillor liés. Son compte Tillor reste en place |
| Utilisateur ou groupe n'est plus attribué à l'application | Entra envoie une désactivation ou une suppression, avec le même effet |
| Groupe supprimé | Sous le groupe Tillor figure **Supprimé dans Entra. Les membres ont été conservés.** Le groupe Tillor reste en place avec ses derniers membres et n'est plus mis à jour |

Retirer quelqu'un complètement de votre organisation se fait dans Tillor, sous [Organisation](/gebruikers/organisaties). Entra ne gère que les membres des groupes.

## Ce que vous retrouvez dans le journal d'activité [#wat-je-terugziet-in-het-activiteitenlog]

Dans le [journal d'activité](/activiteitenlog), vous voyez :

- Chaque modification des membres d'un groupe Tillor qu'Entra applique, avec qui est entré ou sorti. Elle est au nom du système, pas d'un utilisateur
- Chaque cycle de synchronisation d'Entra, une ligne par cycle. Un cycle dans lequel Entra n'envoie rien ne s'affiche pas
- Qui a associé ou dissocié un groupe Entra d'un groupe Tillor, et qui a remplacé le jeton

## Modifier ou arrêter l'association [#koppeling-wijzigen-of-stoppen]

- **Dissocier** : cliquez sur **Délier** sur le groupe Tillor. Le groupe Tillor reste tel quel et vous le gérez à nouveau à la main. Le groupe Entra revient sous **Groupes Entra non liés**
- **Autre groupe Tillor** : déliez, puis associez le groupe Entra à un autre groupe sous **Groupes Entra non liés**. Le groupe précédent garde ses membres, mais n'est plus mis à jour
- **Arrêter complètement** : dans Entra, mettez **Provisioning Status** sur **Off**, ou supprimez l'enterprise application

## Remplacer le jeton [#token-vervangen]

Dans la ligne **Microsoft Entra**, cliquez sur **Connexion** puis sur **Remplacer le jeton** si le jeton a fuité ou si vous en avez de nouveau besoin. L'ancien jeton ne fonctionne plus immédiatement. Collez le nouveau jeton dans Entra sous **Provisioning > Admin Credentials > Secret Token** et cliquez sur **Save**. Tant que vous ne le faites pas, la synchronisation échoue dans Entra.

## Résoudre les problèmes [#problemen-oplossen]

**Configurer avec Microsoft s'arrête à une étape**

À l'étape figure le message de Microsoft. Le plus souvent, il manque à votre compte le rôle d'administrateur ou l'autorisation. Vérifiez les rôles sous [Avant de commencer](#voordat-je-begint) et cliquez sur **Réessayer**. Tillor réutilise l'application et le provisioning déjà créés.

**Test Connection échoue**

Vérifiez que l'URL du locataire est reprise en entier, `/scim/v2` compris, et que le jeton est le dernier généré. Après **Remplacer le jeton**, un ancien jeton ne fonctionne plus.

**Un groupe ne figure pas dans la liste**

Attendez la fin de la première synchronisation et actualisez la page. Si vous avez configuré l'association à la main, Entra n'envoie que les groupes attribués à l'application : vérifiez **Users and groups** dans l'application et attendez le cycle suivant, ou utilisez **Provision on demand**.

**Quelqu'un manque dans le groupe Tillor**

- Cette personne est-elle membre de votre organisation Tillor ? Entra ne crée pas de comptes
- L'adresse e-mail dans Entra correspond-elle à celle de Tillor ? Sinon, mettez **externalId** sur **objectId**, pour que Tillor la reconnaisse par son compte Microsoft. Cela ne fonctionne que si elle s'est déjà connectée une fois à Tillor avec Microsoft
- L'utilisateur est-il activé dans Entra ?
- Est-il directement membre du groupe, et non via un groupe imbriqué ?

**Ma modification manuelle disparaît**

Pour un groupe lié, Entra est la source. Modifiez les membres dans Entra, ou déliez le groupe.

**Plus de détails sur un cycle échoué**

Dans Entra, ouvrez **Provisioning > Provisioning logs**. Vous y voyez pour chaque utilisateur et groupe ce qu'Entra a essayé et quelle réponse Tillor a donnée.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Groupes" href="/gebruikers/groepen" description="Créer et utiliser des groupes" />
  <Card title="Vues" href="/taken/weergaven" description="Partager une vue de tâches avec un groupe" />
  <Card title="Connexion" href="/inloggen" description="Se connecter avec Microsoft" />
</Cards>


# Organisation (/fr-FR/gebruikers/organisaties)

Sur la page **Paramètres** (en bas du menu principal, <UIPath>Support > Paramètres</UIPath>), vous gérez les paramètres de votre organisation. À gauche, vous passez d'une section à l'autre. Les sections que vous voyez dépendent de vos autorisations.

| Section | À quoi elle sert |
|---|---|
| **Général** | Profil de l'organisation, fuseau horaire, pays par défaut et couleurs de l'identité visuelle. Voir [Général](#algemeen) |
| **Heures d'ouverture** | Horaire hebdomadaire, saisons, exceptions et jours fériés. Voir [Heures d'ouverture](#openingsuren) |
| **Facturation** | PDF, délai d'échéance et taux de TVA. Voir [Paramètres de facturation](/gebruikers/instellingen-facturatie) |
| **Impression** | Imprimantes et moments d'impression. Voir [Impression](#afdrukken) |
| **Paiements** | Mode de paiement Autres et adresse d'expédition. Voir [Paramètres de paiement](/gebruikers/instellingen-betalingen) |
| **Périodes de loyer** | Fréquences de location pour les occupations. Voir [Définir les périodes de location](/gebruikers/instellingen-huurperiodes) |
| **Tarif d'emplacement** | La formule du tarif calculé. Voir [Formule de tarif](/terreinen#tariefformule) |
| **Contrôle d'accès** | Sortir avec une plaque expirée. Voir [Paramètres de contrôle d'accès](/gebruikers/instellingen-toegangscontrole) |
| **Carte** | Centre et orientation de la carte. Voir [Définir la carte par défaut](/kaart#kaartstandaard-instellen) |
| **Types de terrain** | Types d'emplacements. Voir [Types de terrain](/terreinen#terreintypes) |
| **Labels de tâches** | Labels pour les tâches. Voir [Labels](/taken/labels) |
| **Groupes** | Regrouper des collègues. Voir [Groupes](/gebruikers/groepen) |
| **Champs personnalisés** | Champs supplémentaires sur les clients, emplacements et plus. Voir [Champs personnalisés](/eigen-velden) |
| **Apple Wallet** | Arrière-plan de la carte et point d'accès. Voir [Apple Wallet](#apple-wallet) |
| **Tablettes et bornes** | Tablettes et bornes. Voir [Tablettes et bornes](/mobiele-app/tablets-en-kiosken) |
| **Intégrations** | Liaisons avec d'autres services. Voir [Intégrations](#integraties) |
| **Utilisateurs** | Membres, invitations et autorisations. Voir [Gérer les autorisations utilisateurs](#gebruikersrechten-beheren) |

<Callout type="info" title="Bon à savoir">
- Les sections que vous voyez dépendent de vos autorisations. Vous enregistrez les modifications en bas avec **Enregistrer les paramètres**
- Environ une semaine avant un jour férié légal, Tillor envoie un e-mail à l'adresse du support si les heures d'ouverture de ce jour sont encore vides
- Après l'enregistrement des paramètres du wallet, Tillor met à jour toutes les cartes wallet actives. Les visiteurs le voient généralement après avoir ouvert la carte
- Dès que votre organisation a des factures ou des paiements, la devise ne peut plus changer
</Callout>

<Callout type="info">
Les données de l'entreprise sur les factures (nom, adresse, numéro de TVA, IBAN, logo) sont définies lors de l'onboarding. Contactez le support Tillor si vous voulez les modifier.
</Callout>

## Intégrations [#integraties]

Choisissez **Intégrations** pour voir les liaisons disponibles, comme la téléphonie Voys, les comptes bancaires, Mollie ou un logiciel de comptabilité (par ex. Admisol). Sous **Intégrations** dans le menu de gauche figurent des catégories (communication, paiements, comptabilité, compteurs). Cliquez sur une intégration dans la liste pour ouvrir la page de détail. Vous y installez la liaison ou adaptez les paramètres (pas de fenêtre de dialogue distincte). Voir aussi l'[aperçu des intégrations](/integraties).

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Paramètres - aperçu des intégrations" />

## Général [#algemeen]

Sous **Général**, vous définissez le profil de l'organisation, le fuseau horaire, le pays par défaut et les couleurs de l'identité visuelle. Vous avez besoin de l'autorisation **Modifier les paramètres** pour enregistrer des modifications.

## Heures d'ouverture [#openingsuren]

Sous **Heures d'ouverture**, vous modifiez un horaire hebdomadaire. Avec les options colorées, vous passez aux **périodes saisonnières** (par exemple du 1er juillet au 31 août) ou à une **exception** (une seule date ou une période comme du 24 au 26 décembre). Les **jours fériés légaux** des 12 prochains mois y figurent déjà : choisissez un jour férié et renseignez les heures (ou laissez-les vides si vous êtes fermé ce jour-là). Laissez un jour de la semaine vide si vous êtes fermé ce jour-là. L'IA de la boîte de réception utilise ces heures comme heures d'ouverture du bureau. Environ une semaine avant un jour férié légal, Tillor envoie un e-mail de rappel à l'**adresse du support** de l'organisation (ou à l'adresse e-mail générale s'il n'y a pas d'adresse de support) lorsque les heures de ce jour férié ne sont pas encore renseignées. Si vous utilisez Partoo, les heures d'ouverture sont synchronisées automatiquement. Voir [Partoo](/integraties/partoo). Un site web peut récupérer les heures résolues (y compris les libellés de saison comme Été ou Hiver) et les prochains jours fériés via l'[API des heures d'ouverture](/ontwikkelaars/voorbeelden/opening-hours).

## Impression [#afdrukken]

Sous **Impression**, vous définissez les impressions PDF, les adresses IP des imprimantes et le **planning des moments d'impression**. Ajoutez pour chaque jour de la semaine un ou plusieurs horaires (ou laissez le jour vide). Les paiements en ligne, par mandat et par virement attendent le moment suivant ce jour-là avant que la facture parte dans la file d'attente de l'imprimante.

## Apple Wallet [#apple-wallet]

Sous **Apple Wallet**, vous définissez deux choses côte à côte : à gauche l'**arrière-plan de la carte**, à droite la **localisation du point d'accès**.

**Arrière-plan de la carte** (à gauche) : photo facultative pleine page pour la mise en page Poster Generic sur iPhone avec **iOS 27**. Téléversez du JPEG, PNG ou WebP ; les gros fichiers sont automatiquement réduits. Faites glisser l'aperçu pour choisir quelle partie de la photo reste visible derrière le code QR. L'aperçu montre aussitôt votre choix ; ce n'est qu'après **Enregistrer** en bas de **Paramètres** que la photo (ou la suppression) passe en direct et que Tillor transmet le point focal aux cartes d'accès.

Sur iPhone avec **iOS 26 ou plus ancien**, la carte utilise la mise en page generic classique avec les mêmes données (statut, nom du visiteur, validité, code QR). Sans image personnelle, toutes les cartes reçoivent le dégradé Tillor standard. Avec une photo personnelle, le **logo de l'organisation** issu des données de votre entreprise figure en haut, en couleur sur la photo. Avec le dégradé standard, le logo est blanc sur le dégradé sombre.

Sur les cartes Poster Generic (iOS 27), le code QR est **carré** ; sur les appareils plus anciens, il est rectangulaire, comme sur une carte generic classique.

**Localisation du point d'accès** (à droite) : cliquez sur la carte ou faites glisser l'épingle pour définir le point GPS du point d'accès principal. **Apple Wallet** et **Google Wallet** utilisent cette localisation sur la carte d'accès. Sur iPhone, iOS peut proposer la carte sur l'écran verrouillé lorsqu'un visiteur est à proximité. Choisissez **Utiliser le centre de la carte du parc** pour supprimer l'épingle et utiliser le centre de la carte du parc.

Après l'enregistrement de **Paramètres**, Tillor met à jour toutes les cartes wallet actives de l'organisation (Apple via notification push silencieuse, Google via synchronisation d'objets). Les invités voient généralement la mise à jour après avoir ouvert la carte dans Wallet ; parfois, une actualisation manuelle dans l'application Wallet reste nécessaire. L'aperçu dans Tillor montre le même recadrage que sur la carte : faites glisser l'image pour que le centre soit à l'endroit voulu.

<DocScreenshot src="/screenshots/gebruikers/settings-wallet-barrier-map.png" alt="Paramètres > Apple Wallet avec arrière-plan de la carte et point d'accès sur la carte" />

Au dos de la carte wallet figurent le numéro de téléphone et l'adresse e-mail de l'organisation (e-mail du support s'il est défini, sinon l'adresse générale). Pour les cartes bloquées, expirées ou révoquées, ces données apparaissent aussi derrière le texte de réception sur l'écran verrouillé (Apple) ou dans Google Wallet.

<DocScreenshot src="/screenshots/gebruikers/settings-dialog.png" alt="Paramètres > Général" />

## Gérer les autorisations utilisateurs [#gebruikersrechten-beheren]

Sous **Utilisateurs**, vous voyez les **Membres** de votre organisation et les **Invitations en attente**. Comment inviter des collègues, les retirer et régler leurs notifications se trouve sous [Inviter des utilisateurs et attribuer des autorisations](/gebruikers/gebruikers-en-rechten).

### Modifier les autorisations [#rechten-bewerken]

Cliquez sur **Modifier les autorisations** pour un utilisateur. Toutes les explications, y compris sur les groupes et les autorisations bloquées, se trouvent sous [Modifier les autorisations](/gebruikers/gebruikers-en-rechten#rechten-bewerken). Ci-dessous figurent les autorisations qui suscitent souvent des questions.

### Comptes bancaires [#bankrekeningen]

| Autorisation | Que peut faire l'utilisateur ? |
|---|---|
| **Voir les transactions bancaires** | Page **Administration > Transactions bancaires** et le bloc **Transactions du compte bancaire** sur **Administration > Rapports de paiement** |
| **Synchroniser les transactions bancaires** | Bouton **Synchroniser le compte bancaire** (import manuel) |

Les autorisations figurent dans la fenêtre des autorisations sous le groupe **Transactions bancaires**.

Voir aussi [Comptes bancaires](/boekhouden/betalingsrapporten/betaalmethodes/ponto) pour la liaison avec l'open banking.

### Associer un paiement [#betaling-koppelen]

| Autorisation | Que peut faire l'utilisateur ? |
|---|---|
| **Assigner un paiement** | **Assigner le paiement** sur une facture comptabilisée, **Assigner** pour les groupes de paiements et **Associer à une facture** pour les transactions bancaires (invisible sans autorisation) |

L'autorisation figure dans la fenêtre des autorisations sous le groupe **Paiements**.

### Applications OAuth [#oauth-apps]

| Autorisation | Que peut faire l'utilisateur ? |
|---|---|
| **Autoriser les applications OAuth** | Donner l'accord à des tiers (par ex. Cursor, Claude, ChatGPT) via OAuth, et continuer à utiliser les jetons OAuth existants |

Les utilisateurs existants conservent l'autorisation après la migration. Les nouveaux utilisateurs ne la reçoivent pas automatiquement. Cochez-la dans la fenêtre des autorisations de l'utilisateur. Désactivez-la pour empêcher cet utilisateur d'associer de nouvelles applications OAuth ; les jetons existants de cet utilisateur s'arrêtent alors aussi. Les utilisateurs qui ont cette autorisation dans au moins une organisation peuvent autoriser.

Voir aussi [MCP](/ontwikkelaars/mcp).

## Accord de traitement des données [#verwerkersovereenkomst]

Si un écran **Accord de Traitement des Données Requis** apparaît à la place de Tillor, votre organisation doit signer l'accord de traitement des données (DPA) actuel avant de pouvoir continuer. Vous pouvez d'abord télécharger le document avec **Télécharger le Document DPA**. Ensuite, vous demandez un code de vérification. Il est envoyé par SMS au numéro de téléphone de la personne responsable. Saisissez le code et cliquez sur **Accepter le DPA**.

## Données sur les factures [#gegevens-op-facturen]

Les données de l'entreprise comme le nom, l'adresse, le numéro de TVA et l'IBAN apparaissent automatiquement sur les factures. Elles sont définies lors de l'onboarding. Contactez le support Tillor pour les modifier.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Utilisateurs" href="/gebruikers" description="Gérer l'accès aux comptes" />
  <Card title="Groupes" href="/gebruikers/groepen" description="Regrouper des collègues, aussi avec des autorisations de groupe" />
  <Card title="Factures" href="/facturen" description="Créer et envoyer des factures" />
</Cards>


# Preuve et validité (/fr-FR/handtekeningen/bewijs-en-geldigheid)

Lors de chaque signature, Tillor enregistre qui a signé, quand et comment, puis scelle le PDF afin qu'une modification ultérieure soit visible. Le résultat est une signature électronique simple, adaptée aux contrats de location, aux règlements intérieurs, aux décharges et aux conditions. Pour les documents pour lesquels la loi exige une signature plus forte, Tillor n'est pas le bon outil.

## Que contiennent les pages de preuve ? [#wat-staat-er-op-de-bewijspaginas]

Le PDF signé reçoit à la fin une ou plusieurs pages **Preuve de signature**. Elles contiennent :

- le titre du document, la demande, ton organisation, le nombre de pages et la date de création, d'envoi et de finalisation de la demande
- deux empreintes du fichier : celle du PDF tel que tu l'as téléversé, et celle des pages signées avant l'ajout des pages de preuve. Si un seul caractère du fichier change, l'empreinte ne correspond plus
- pour chaque signataire : nom, rôle, type, adresse e-mail, numéro de téléphone et langue, le moment où le lien a été envoyé et celui où cette personne a ouvert la page pour la première fois, l'heure de signature, l'adresse IP et l'appareil
- comment le signataire a été confirmé : par un code à usage unique, vers quel canal le code a été envoyé et quand, ou connecté dans Tillor pour les collaborateurs
- la phrase par laquelle le signataire a donné son accord, exactement comme elle s'affichait à l'écran
- ce que le signataire a rempli : chaque champ de texte, de date et case à cocher avec sa valeur, y compris ce qui est resté vide
- la signature et le paraphe tels qu'ils ont été tracés, et les pages où ils figurent. Une signature saisie apparaît sous la forme d'une image du nom saisi, comme une signature dessinée
- comment la signature a été apposée : sur la page de signature via le lien, dans Tillor par un collaborateur connecté, ou sur la tablette à la réception (avec un code, ou avec l'identité confirmée par un collaborateur)
- la **piste d'audit** : chaque étape avec l'heure, la personne concernée, l'adresse IP et l'appareil. Par exemple *Lien de signature envoyé*, *Page de signature ouverte*, *Code de vérification envoyé*, *Code erroné saisi*, *Signé* et *Finalisé et scellé*

Les heures sont indiquées dans le fuseau horaire de ton organisation, avec l'heure UTC (l'heure standard mondiale) à côté. Tillor conserve les adresses IP et les appareils sous forme chiffrée. Tu les vois dans Tillor et sur les pages de preuve. Les signatures et les valeurs saisies figurent dans le document aux endroits que tu as choisis. Ton fichier d'origine est conservé séparément et ne change jamais.

Ces mêmes étapes apparaissent aussi sur la page de la demande sous **Historique** et chez le client sous **Événements**.

<Callout type="info" title="Pour le lecteur technique">
Les deux empreintes sont des sommes de contrôle SHA-256. Une empreinte SHA-256 change entièrement dès qu'un seul octet du fichier change, c'est pourquoi elle prouve que le fichier n'a pas été modifié. Les pages de preuve indiquent aussi l'empreinte du certificat de scellement (voir ci-dessous).
</Callout>

## Sceau et horodatage [#zegel-en-tijdstempel]

Le PDF signé est **scellé** en dernière étape avec une signature numérique de ton organisation, créée par Tillor. Si tu l'ouvres dans Adobe Reader ou un autre lecteur de PDF, tu vois un panneau de signature. Si le fichier est modifié après le scellement, le lecteur l'indique.

Le lecteur peut qualifier le signataire d'**inconnu** ou de **non approuvé**. C'est normal : le certificat provient de Tillor et non d'une autorité de certification payante. Le certificat concerné figure avec son empreinte sur la page de preuve.

Le sceau reçoit aussi un **horodatage** d'un service d'horodatage indépendant et gratuit (FreeTSA, ou DigiCert s'il ne répond pas). Cela prouve, indépendamment de Tillor, quand le fichier existait exactement sous cette forme. L'heure figure sur la page de la demande sous **Horodatage**.

## Quel type de signature [#welk-soort-handtekening]

Il s'agit d'une **signature électronique simple** au sens des règles européennes eIDAS. Tillor vérifie l'adresse e-mail ou le numéro de téléphone avec un code, enregistre le tracé et conserve la preuve. Cela convient aux contrats de location, aux règlements intérieurs, aux décharges et aux conditions.

Une signature **qualifiée**, par exemple avec itsme ou une carte eID, n'est pas possible. Si tu as un document pour lequel la loi l'exige, fais-le signer en dehors de Tillor.

## Que devient la preuve ? [#wat-gebeurt-er-met-het-bewijs]

- Le PDF d'origine et le PDF signé restent parmi les documents du client. Tu peux les archiver mais pas les supprimer.
- La preuve fait partie du PDF signé. Quiconque a reçu une copie dispose donc aussi des pages de preuve.
- La piste d'audit reste sur la page de la demande, même si la demande a été refusée, annulée ou a expiré.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Mon lecteur de PDF indique que la signature n'est pas approuvée">
C'est exact et normal. Le sceau provient de Tillor, pas d'une autorité de certification payante. L'important est que le lecteur ne signale aucune modification après le scellement. Le certificat figure avec son empreinte sur la page de preuve.
</Accordion>
<Accordion title="Mon lecteur de PDF indique que le document a été modifié après la signature">
Le fichier a été modifié après le scellement, par exemple en l'enregistrant à nouveau ou en le modifiant. Télécharge à nouveau le PDF signé via la page de détail de la demande ou parmi les documents du client. Ce fichier est inchangé.
</Accordion>
<Accordion title="Un client veut une signature qualifiée avec itsme ou eID">
Ce n'est pas possible dans Tillor. Fais signer ce document en dehors de Tillor.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Comment une personne signe" href="/handtekeningen/ondertekenen" />
  <Card title="Suivre une demande" href="/handtekeningen/opvolgen" />
  <Card title="Tous les termes" href="/begrippen" />
</Cards>


# Demander des signatures (/fr-FR/handtekeningen/handtekening-vragen)

Avec une demande de signature, tu fais signer un PDF en ligne par une ou plusieurs personnes. Tu la crées en deux temps : tu choisis d'abord le client et le PDF, puis tu règles les signataires et les champs dans l'éditeur. La manière de suivre qui a signé est décrite dans [Suivre une demande](/handtekeningen/opvolgen).

<Requires permission="Gérer les demandes de signature" />

Avant de commencer :

- Tu as besoin du droit **Gérer les demandes de signature**. Si tu ne l'as pas, le bouton **Demander des signatures** est grisé.
- Le fichier doit être un PDF de 250 Mo maximum. Tillor refuse un autre type de fichier avec le message **Ce n'est pas un PDF. Choisissez un fichier PDF.**
- Chaque signataire a besoin d'une adresse e-mail ou d'un numéro de téléphone pour recevoir le lien ou le code. Pour un client ou un contact, renseigne-les d'abord dans ses données.
- Chaque signataire a besoin d'au moins un champ de signature ou de paraphe.

## Créer une demande de signature [#een-ondertekenverzoek-maken]

<Steps>
<Step>
### Démarre la demande [#start-het-verzoek]
Choisis par où tu commences.

<Tabs items={["Depuis Signatures", "Depuis le client"]}>
<Tab value="Depuis Signatures">
Va dans <UIPath>Administration > Signatures</UIPath> et clique sur **Demander des signatures**. Choisis le **Client**.
</Tab>
<Tab value="Depuis le client">
Ouvre l'onglet **Documents** du client et clique sur **Demander des signatures**. Le client est alors déjà renseigné.
</Tab>
</Tabs>

Dans **Document**, choisis un PDF déjà présent chez ce client, ou laisse **Téléverser un nouveau PDF** et glisse le PDF dans la zone (ou clique sur **Choisir un PDF**). Saisis un **Titre**, par exemple *Contrat de location 2027*. Si tu le laisses vide, Tillor reprend le nom du document. Clique ensuite sur **Continuer**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-create-dialog.png" alt="Boîte de dialogue Demander des signatures avec client, titre et document" />

Un PDF téléversé est placé parmi les documents du client. Tillor ne le modifie jamais : les signatures sont placées dans une copie distincte.
</Step>
<Step>
### Ajoute des signataires [#voeg-ondertekenaars-toe]
Sous **Signataires**, clique sur **Ajouter un signataire** et choisis :

- **Client : [nom]**
- **Contact du client**
- **Collaborateur**
- **Partie externe** : renseigne **Nom**, **Adresse e-mail** et/ou **Numéro de mobile** et **Langue**. Au moins une des deux coordonnées est nécessaire. Sans adresse e-mail, la personne reçoit le lien par SMS.

<DocScreenshot src="/screenshots/handtekeningen/signatures-add-signer-menu.png" alt="Menu Ajouter un signataire" />

<DocScreenshot src="/screenshots/handtekeningen/signatures-external-dialog.png" alt="Boîte de dialogue Ajouter une partie externe" />

Tu peux ajouter 10 signataires au maximum. Ils signent de haut en bas, et le suivant ne reçoit le lien que lorsque le précédent a signé. Avec **Signer plus tôt** et **Signer plus tard** (les flèches), tu changes l'ordre, et avec la corbeille tu retires quelqu'un. Dans le champ sous le nom, tu peux indiquer un **Rôle**, par exemple *Locataire* ou *Garant*.

Chaque signataire reçoit sa propre couleur. Tu la retrouves sur ses champs dans le document.
</Step>
<Step>
### Place les champs [#plaats-de-velden]
Dans **Champs pour**, choisis le signataire pour lequel tu places des champs. Choisis ensuite le type de champ et touche ou glisse sur une page du document. Glisse un champ pour le déplacer et glisse le coin pour l'agrandir ou le réduire.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor.png" alt="Éditeur avec les signataires, Champs pour et les types de champs" />

| Champ | Ce que fait le signataire |
| --- | --- |
| **Signature** | Place la signature tracée en touchant la zone |
| **Paraphe** | Place le paraphe tracé en touchant la zone |
| **Nom** | Rien : Tillor renseigne le nom du signataire |
| **Date de signature** | Rien : Tillor renseigne le jour de la signature |
| **Texte** | Saisit une ligne, jusqu'à 200 caractères, par exemple une plaque d'immatriculation |
| **Texte long** | Saisit quelques lignes, jusqu'à 2 000 caractères, par exemple une remarque |
| **Case à cocher** | Coche une condition |
| **Date** | Choisit une date, par exemple un jour d'arrivée |

Clique sur un champ placé pour le sélectionner. Sous les boutons, tu vois alors :

- **Signataire** : attribue le champ à un autre signataire, sans le redessiner.
- Pour **Texte**, **Texte long**, **Case à cocher** et **Date**, aussi une **Question ou libellé** (que le signataire voit près de la zone de saisie) et **Obligatoire**. Un champ qui n'est pas obligatoire peut rester vide.
- La croix sur le champ le supprime.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor-fields.png" alt="Dernière page avec les champs du locataire, du colocataire et du bailleur, chacun dans sa couleur" />

Si quelqu'un a besoin d'un paraphe sur chaque page, utilise **Paraphe sur chaque page**. Tillor place alors un champ de paraphe sur toutes les pages pour ce signataire. Tant qu'un signataire n'a pas de champ de signature ou de paraphe, tu vois **Pas encore de champ de signature** à côté de cette personne.
</Step>
<Step>
### Règle le message et le délai [#stel-bericht-en-termijn-in]
Sous **Demande**, renseigne :

- **Titre** : tel que les signataires le voient.
- **Message aux signataires** : facultatif, il figure dans l'e-mail et sur la page de signature.
- **Signer avant le** : la date limite. Par défaut, 14 jours après la création. On peut signer jusqu'à la fin de ce jour.
- **Rappel après** : après combien de jours (de 1 à 14) un signataire dont c'est le tour reçoit un rappel. Par défaut 3 jours.
</Step>
<Step>
### Envoie la demande [#verstuur-het-verzoek]
Clique sur **Envoyer** et confirme. Le premier signataire reçoit le lien.

<DocScreenshot src="/screenshots/handtekeningen/signatures-send-dialog.png" alt="Confirmation Envoyer la demande ?" />

Si tu veux continuer plus tard, clique sur **Enregistrer le brouillon**. Avec la corbeille à côté (**Supprimer le brouillon**), tu jettes la demande, après confirmation. Le PDF reste parmi les documents du client.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La demande reçoit le statut <Status tone="info">En cours</Status>. Tu la trouves chez le client sous **Documents** et sous <UIPath>Administration > Signatures</UIPath>. Tillor affiche **Envoyée au premier signataire**.
- Le premier signataire reçoit un e-mail avec un lien personnel, ou un SMS s'il n'y a qu'un numéro de téléphone. Chaque signataire suivant reçoit le lien dès que le précédent a signé.
- Un signataire dont c'est le tour et qui ne réagit pas reçoit automatiquement un rappel après le nombre de jours indiqué dans **Rappel après**, 2 fois au maximum. Tu peux toujours envoyer un rappel toi-même, voir [Suivre une demande](/handtekeningen/opvolgen#een-herinnering-sturen).
- Dès que tout le monde a signé, la demande passe à <Status tone="success">Terminé</Status> et le PDF signé se trouve chez le client.
- Si le délai est dépassé sans que tout le monde ait signé, la demande passe à <Status tone="warning">Expiré</Status>.

Si tu veux encore modifier quelque chose alors que personne n'a signé, ou seulement toi, clique sur **Revenir à la modification**. La demande redevient un brouillon : les liens envoyés ne fonctionnent plus et chacun signe à nouveau dès que tu la renvoies. Si quelqu'un d'autre a déjà signé, annule la demande et crée-en une nouvelle.

Tu veux qu'une automatisation réagisse à une demande terminée, par exemple avec une tâche ? Utilise alors le déclencheur **Demande de signature terminée**, voir [Déclencheurs](/automatiseringen/triggers).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le bouton Demander des signatures est grisé">
Tu n'as pas le droit **Gérer les demandes de signature**. Demande à un administrateur de l'ajouter sous <UIPath>Paramètres > Utilisateurs</UIPath>.
</Accordion>
<Accordion title="Tillor dit : Ce n'est pas un PDF. Choisissez un fichier PDF.">
Tu as choisi un autre type de fichier, par exemple Word. Enregistre d'abord le document en PDF et choisis ce fichier.
</Accordion>
<Accordion title="Tillor dit : Choisissez un client, ou : Téléversez un PDF ou choisissez un document du client">
Dans le premier écran, **Client** ou **Document** est vide. Renseigne les deux et clique à nouveau sur **Continuer**.
</Accordion>
<Accordion title="Je ne peux pas envoyer">
Tillor vérifie la demande avant l'envoi et indique ce qui manque :

- **Ajoutez au moins un signataire avant l'envoi.**
- Un signataire n'a pas encore de champ de signature ou de paraphe. Tillor sélectionne cette personne. Glisse alors sur le document pour placer un champ.
- Un signataire n'a ni adresse e-mail ni numéro de téléphone et ne peut donc pas recevoir de lien ni de code. C'est aussi le cas pour un client ou un contact : renseigne d'abord une adresse e-mail ou un numéro de téléphone dans ses données. Dans la liste, cette personne est marquée **Pas d'adresse e-mail ni de numéro de téléphone**.
- **Donnez un titre à la demande.**
</Accordion>
<Accordion title="Tillor dit : La demande n’a pas pu être envoyée">
La demande n'est peut-être pas partie. Recharge la page. Si la demande est encore au statut <Status>Brouillon</Status>, clique à nouveau sur **Envoyer**.
</Accordion>
<Accordion title="Tillor dit : Le brouillon n’a pas pu être enregistré">
Tes modifications n'ont pas été enregistrées. Recharge la page et vérifie ce qui reste avant de continuer.
</Accordion>
<Accordion title="Le document ne se charge pas dans l'éditeur">
Recharge la page. Si cela ne fonctionne toujours pas, vérifie que le fichier est un PDF valide.
</Accordion>
<Accordion title="J'ai placé un champ chez la mauvaise personne">
Clique sur le champ et choisis la bonne personne sous **Signataire**. Le champ reste à sa place.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Suivre une demande" href="/handtekeningen/opvolgen" />
  <Card title="Comment une personne signe" href="/handtekeningen/ondertekenen" />
  <Card title="Preuve et validité" href="/handtekeningen/bewijs-en-geldigheid" />
</Cards>


# Aperçu (/fr-FR/handtekeningen)

Avec **Signatures**, tu fais signer en ligne un PDF tel qu'un contrat de location, un règlement intérieur, une décharge ou un cautionnement. Les signataires signent l'un après l'autre, et tu décides où placer chaque signature, paraphe ou champ de saisie sur les pages. La marche à suivre est décrite dans [Demander des signatures](/handtekeningen/handtekening-vragen).

Lorsque tout le monde a signé, Tillor crée un PDF signé suivi de pages de preuve. Il se trouve ensuite dans les **Documents** du client et chaque signataire en reçoit une copie. Ton PDF d'origine est conservé sans modification.

<Requires permission="Gérer les demandes de signature" />

Préparer, envoyer, relancer, reprendre et annuler des demandes de signature nécessite le droit **Gérer les demandes de signature**, dans le groupe **Signatures** sous <UIPath>Paramètres > Utilisateurs</UIPath>. Si tu n'as pas ce droit, ces boutons sont grisés. Tous les utilisateurs de ton organisation peuvent consulter les demandes et signer eux-mêmes lorsque c'est leur tour.

<Callout type="info" title="Bon à savoir">
- Une demande compte 10 signataires au maximum et uniquement des fichiers PDF, jusqu'à 250 Mo.
- Par défaut, on peut signer pendant 14 jours, jusqu'à la fin du dernier jour. Tu peux choisir une autre date.
- Un signataire dont c'est le tour reçoit par défaut un rappel après 3 jours (tu peux choisir de 1 à 14 jours), avec un maximum de 2 rappels automatiques. Ils partent lors du contrôle quotidien de Tillor.
- Lors de la signature, le signataire confirme avec un code à 6 chiffres. Le code est valable 10 minutes et un nouveau code peut être demandé après 2 minutes.
- Ton PDF d'origine ne change jamais. L'original et le PDF signé peuvent être archivés mais pas supprimés, car ils constituent la preuve.
- La demande passe au statut Expiré lors du contrôle quotidien, pas au moment exact où le délai est dépassé.
</Callout>

## Où le trouver [#waar-vind-je-het]

- <UIPath>Administration > Signatures</UIPath> affiche toutes les demandes de signature avec leur statut et le nombre de signatures déjà apposées.
- Sur le profil d'un client, l'onglet **Documents** contient le bouton **Demander des signatures**, avec en dessous les **Demandes de signature** de ce client.

<DocScreenshot src="/screenshots/handtekeningen/signatures-list.png" alt="Liste des demandes de signature sous Administration > Signatures" />

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une demande de signature est toujours liée à un seul client et à un seul PDF. Les signataires ne sont pas forcément le client lui-même : un contact, un collègue ou une partie externe peut aussi signer.

```mermaid
flowchart LR
  A[PDF chez le client] --> B[Demande de signature avec signataires et champs]
  B --> C[Le signataire 1 signe]
  C --> D[Le signataire 2 signe]
  D --> E[PDF signé avec pages de preuve]
  E --> F[Documents du client]
  E --> G[Copie pour chaque signataire]
```

## Déroulement d'une demande [#hoe-een-verzoek-verloopt]

```mermaid
flowchart LR
  A[Brouillon] -->|Envoyer| B[En cours]
  B -->|tout le monde a signé| C[Terminé]
  B -->|un signataire refuse| D[Refusé]
  B -->|Annuler la demande| E[Annulé]
  B -->|délai dépassé| F[Expiré]
  B -->|Revenir à la modification| A
```

## Statuts [#statussen]

| Statut | Signification |
|---|---|
| <Status>Brouillon</Status> | Tu prépares encore la demande. Rien n'a encore été envoyé. |
| <Status tone="info">En cours</Status> | La demande est envoyée et la signature est en cours. |
| <Status tone="success">Terminé</Status> | Tout le monde a signé et le PDF signé se trouve chez le client. |
| <Status tone="error">Refusé</Status> | Un signataire a refusé. La demande est arrêtée. |
| <Status>Annulé</Status> | Toi ou un collègue avez retiré la demande. |
| <Status tone="warning">Expiré</Status> | La signature n'a pas eu lieu à temps. |

Pour chaque signataire, tu vois **En attente** (ce n'est pas encore son tour), **Lien envoyé** (c'est son tour), **Signé** ou **Refusé**.

## Qui peut signer [#wie-kan-ondertekenen]

| Type | Comment cette personne signe |
|---|---|
| **Client** | Via un lien personnel par e-mail, ou par SMS s'il n'y a qu'un numéro de téléphone |
| **Contact** | Comme le client, pour un contact de ce client |
| **Collaborateur** | Dans Tillor même, sans code |
| **Partie externe** | Comme le client, avec un nom et une adresse e-mail ou un numéro de téléphone que tu renseignes toi-même |

Un client, un contact ou une partie externe peut aussi signer au comptoir, sur une tablette avec l'app Tillor. Voir [Sur la tablette à la réception](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Automatiser [#automatiseren]

Une demande de signature peut déclencher une [automatisation](/automatiseringen/triggers). Avec **Demande de signature terminée**, tu crées par exemple une tâche dès qu'un contrat de location est signé, et avec **Demande de signature modifiée** tu réagis à chaque changement de statut. Tu peux aussi envoyer ces mêmes événements comme [webhook](/ontwikkelaars/webhooks) vers ton propre système.

<Cards>
  <Card title="Demander des signatures" href="/handtekeningen/handtekening-vragen" />
  <Card title="Suivre une demande" href="/handtekeningen/opvolgen" />
  <Card title="Comment une personne signe" href="/handtekeningen/ondertekenen" />
  <Card title="Preuve et validité" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Accueillir un client saisonnier" href="/praktijk/seizoensklant-binnenhalen" description="Avec signature du contrat de location" />
</Cards>

## Termes [#begrippen]

- **Demande de signature** : l'ordre de faire signer un PDF, avec des signataires, des champs et un délai. Voir [demande de signature](/begrippen#ondertekenverzoek).
- **Signataire** : une personne qui doit signer. Un client, un contact, un collaborateur ou une partie externe.
- **Champ** : un emplacement sur le PDF où un signataire signe, appose un paraphe ou saisit quelque chose.
- **Brouillon** : une demande que tu prépares encore. Rien n'a encore été envoyé.
- **Pages de preuve** : les pages à la fin du PDF signé indiquant qui a signé, quand et comment. Voir [page de preuve](/begrippen#bewijspagina).
- **Sceau** : la signature numérique de ton organisation avec laquelle le PDF signé est clôturé. Voir [sceau](/begrippen#zegel).


# Comment une personne signe (/fr-FR/handtekeningen/ondertekenen)

Cette page montre ce que vivent tes signataires, pour que tu puisses répondre à leurs questions, et comment faire signer quelqu'un au comptoir sur la tablette. Tu envoies toi-même une demande via [Demander des signatures](/handtekeningen/handtekening-vragen).

Avant de commencer :

- La demande doit avoir le statut <Status tone="info">En cours</Status> et le signataire doit être à son tour. Si ce n'est le tour de personne, il est indiqué **Ce n’est pas encore votre tour**.
- Pour la tablette, tu as besoin du droit **Gérer les demandes de signature** et l'app Tillor doit être en ligne sur un appareil de ton organisation.
- Le signataire a besoin d'un numéro de téléphone ou d'une adresse e-mail, car le code y est envoyé. Seul un collaborateur signe sans code.

## Sur la tablette à la réception [#op-de-tablet-aan-de-receptie]

Si quelqu'un se tient devant toi, il n'a pas besoin d'ouvrir le lien lui-même. C'est possible pour un client, un contact ou une partie externe dont c'est le tour.

<Steps>
<Step>
### Ouvre la demande [#open-het-verzoek]
Va dans <UIPath>Administration > Signatures</UIPath> et ouvre la demande, ou ouvre-la via l'onglet **Documents** du client.
</Step>
<Step>
### Clique sur Signer sur tablette [#klik-op-op-tablet-tekenen]
Chez le signataire dont c'est le tour, clique sur **Signer sur tablette** et choisis comment l'identité est confirmée :

- **Avec un code** : le signataire confirme sur la tablette avec le code reçu par SMS ou e-mail, comme via le lien.
- **Sans code** : tu as vérifié l'identité au comptoir, par exemple avec une carte d'identité. Aucun code n'est demandé. La feuille de preuve indique que l'identité a été confirmée par un collaborateur, et l'historique indique qui.

Tillor affiche **Ouvert sur la tablette**.
</Step>
<Step>
### Fais signer la personne [#laat-de-persoon-tekenen]
Le document s'ouvre dans l'app sur la tablette, avec en haut, en grandes lettres, le nom du signataire. Vérifie ce nom avec la personne devant toi. Les étapes sont les mêmes que via le lien, voir ci-dessous. Juste après l'envoi, la tablette peut encore afficher brièvement **Préparation du document…**.
</Step>
</Steps>

Après la signature ou le refus, la tablette revient à l'écran d'accueil au bout de quelques secondes. S'il y a plusieurs signataires, tu envoies chacun séparément vers la tablette dès que c'est son tour. La feuille de preuve indique que la signature a été apposée sur la tablette.

## Que fait le signataire ? [#wat-doet-de-ondertekenaar]

<Tabs items={["Via le lien", "Sur la tablette"]}>
<Tab value="Via le lien">
Le signataire reçoit un e-mail, ou un SMS s'il n'y a qu'un numéro de téléphone. Il contient un lien personnel vers la page de signature, avec ton message et le nom de ton organisation. La page fonctionne sur téléphone, tablette et ordinateur, dans la langue du signataire.
</Tab>
<Tab value="Sur la tablette">
Le signataire voit directement le document dans l'app, après que tu as choisi **Signer sur tablette**. Aucun lien ni e-mail n'est nécessaire. Quiconque signe sur la tablette avec un code reçoit le code sur son propre téléphone ou dans son e-mail.
</Tab>
</Tabs>

Ensuite, les étapes sont identiques.

<Steps>
<Step>
### Commencer [#beginnen]
La première carte indique qui d'autre signe, la place dans la file (par exemple *Signataire 2 sur 3*) et les étapes. À droite se trouve le document, avec les signatures des signataires précédents déjà en place. Avec **Commencer à signer**, le signataire démarre. Chaque étape a un bouton de retour. Le bouton de retour du téléphone fonctionne aussi.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-start.png" alt="Page de signature pour le garant avec la carte de départ et le document" />
</Step>
<Step>
### Dessinez votre signature [#teken-je-handtekening]
Le signataire trace une **Signature** avec le doigt ou la souris, ou choisit **Taper** et saisit son nom complet. Tillor met alors ce nom saisi dans une écriture manuscrite. S'il y a des champs de paraphe, un **Paraphe** (initiales tracées ou saisies) suit de la même manière. Avec **Effacer**, le signataire recommence. Passer de **Dessiner** à **Taper** vide la zone.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-type.png" alt="Étape Dessinez votre signature avec Taper sélectionné" />
</Step>
<Step>
### Placez votre signature [#plaats-je-handtekening]
Le signataire touche chaque zone marquée dans le document (**Cliquez pour signer** ou **Cliquez pour parapher**). **Champ suivant** saute à la prochaine zone vide. Avec **Case précédente** et **Case suivante**, le signataire parcourt toutes les zones. Un second clic sur une zone remplie ne fait rien.
</Step>
<Step>
### Complétez vos informations [#vul-je-gegevens-in]
Uniquement si tu as placé des champs de saisie : texte, date ou case cochée. Chaque champ indique **obligatoire** ou **facultatif**. Un champ obligatoire vide bloque l'étape. Ce qui est saisi apparaît immédiatement dans le document. Tillor renseigne lui-même le nom et la date de signature.
</Step>
<Step>
### Confirmez et signez [#bevestig-en-onderteken]
Le signataire coche qu'il a lu le document. S'il manque encore quelque chose, une liste de boutons mène à l'étape concernée.

Ce n'est que lorsque tout est prêt que le signataire fait envoyer un code à 6 chiffres avec **Envoyer le code de vérification** : par SMS s'il y a un numéro de téléphone, sinon par e-mail. Le code est valable 10 minutes. S'il n'arrive pas, le signataire peut **Renvoyer le code** après 2 minutes. Ensuite, le signataire clique lui-même sur **Signer**. Rien n'est jamais signé automatiquement.
</Step>
</Steps>

## Que voit-on ensuite ? [#wat-zie-je-daarna]

- Si ce n'est le tour de personne, il est indiqué **Ce n’est pas encore votre tour** et un message suit dès que c'est le cas.
- Celui qui a déjà signé voit **Vous avez signé** jusqu'à ce que les autres aient terminé.
- Dès que tout le monde a signé, chaque signataire peut télécharger le PDF signé via le même lien (**Signé par tous**).
- Pour une demande retirée, le signataire voit **Demande retirée**, pour une demande expirée **Délai de signature écoulé** et pour une demande refusée **Signature arrêtée**.
- Un collaborateur signe dans Tillor, via le bouton **Signer maintenant** sur la page de détail ou via le lien dans le message. Un code n'est pas nécessaire, car cette personne est déjà connectée. Ici aussi, la signature peut être tracée ou saisie.

## Refuser [#weigeren]

Avec **Refuser de signer**, un signataire peut rejeter la demande et indiquer éventuellement un motif (jusqu'à 500 caractères). La demande s'arrête alors, personne d'autre n'est sollicité et la personne qui a créé la demande reçoit un message. Voir [Suivre une demande](/handtekeningen/opvolgen#wat-gebeurt-er-daarna).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le bouton Signer sur tablette n'apparaît pas">
Le bouton n'apparaît que si l'app Tillor sur un appareil de ton organisation a eu contact avec Tillor ces dernières minutes, et uniquement pour un client, un contact ou une partie externe dont c'est le tour. Ouvre l'app sur la tablette, patiente un instant et recharge la page. Vérifie aussi que **Afficher les tickets et documents** est activé dans les [paramètres de l'appareil](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid). Voir aussi [Tablettes et bornes](/mobiele-app/tablets-en-kiosken).
</Accordion>
<Accordion title="Tillor dit : Impossible de l'ouvrir sur la tablette">
Tillor n'a pu joindre aucune tablette qui affiche des documents. Vérifie que l'app est ouverte et que l'appareil est connecté, puis réessaie.
</Accordion>
<Accordion title="Le signataire ne reçoit pas de code">
Le code est envoyé au numéro de téléphone, ou à l'adresse e-mail s'il n'y a pas de numéro. Demande au signataire de consulter son dossier de courrier indésirable et d'utiliser **Renvoyer le code** après 2 minutes. Si le numéro ou l'adresse est incorrect, corrige-le chez le client ou le contact et envoie un rappel. Pour une partie externe, annule la demande et crée-en une nouvelle avec les bonnes coordonnées.
</Accordion>
<Accordion title="Tillor dit : Le code n'a pas pu être vérifié">
Le code saisi est incorrect ou a expiré. Un code est valable 10 minutes. Le signataire en demande un nouveau avec **Renvoyer le code** et le saisit. Chaque tentative erronée figure dans l'historique sous **Code erroné saisi**.
</Accordion>
<Accordion title="Le signataire ne peut pas cliquer sur Signer">
Il manque encore quelque chose. Sous **À faire avant de pouvoir signer** figure ce qui reste : tracer la signature ou le paraphe, toucher encore une zone, ou remplir un champ obligatoire. La case indiquant que le document a été lu doit aussi être cochée.
</Accordion>
<Accordion title="Le lien ne fonctionne plus">
Si la demande a été remise en brouillon, annulée ou a expiré, l'ancien lien ne fonctionne plus. Après un nouvel envoi, le signataire reçoit un nouveau lien. Pour une demande annulée ou expirée, tu dois créer une nouvelle demande.
</Accordion>
<Accordion title="Le signataire voit : Cette demande a changé entre-temps">
La page était déjà ouverte pendant que la demande changeait, par exemple parce qu'elle est déjà signée. La page affiche maintenant son état actuel. Il n'y a pas eu d'erreur.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Suivre une demande" href="/handtekeningen/opvolgen" />
  <Card title="Preuve et validité" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Tablettes et bornes" href="/mobiele-app/tablets-en-kiosken" />
</Cards>


# Suivre une demande (/fr-FR/handtekeningen/opvolgen)

Après l'envoi, tu suis une demande de signature sur la page de détail : qui a déjà signé, qui est à son tour et ce que tu peux encore faire. C'est aussi ici que tu envoies un rappel, annules une demande et télécharges le PDF signé.

Avant de commencer :

- Tout le monde peut consulter. Relancer, annuler, remettre en brouillon et envoyer vers la tablette nécessitent le droit **Gérer les demandes de signature**. Sans ce droit, ces boutons sont grisés.
- La demande doit avoir été envoyée. Un <Status>Brouillon</Status> se modifie dans l'éditeur, voir [Demander des signatures](/handtekeningen/handtekening-vragen).

## Ouvrir la demande [#het-verzoek-openen]

Ouvre <UIPath>Administration > Signatures</UIPath>. La liste affiche pour chaque demande le **Titre**, le **Client**, le **Statut**, le nombre de personnes ayant déjà **Signé**, la date de création (**Créé le**) et la date limite de signature (**Signer avant le**). Cherche par titre ou nom de client, ou filtre avec **Statut** pour ne voir par exemple que les demandes encore en cours. Clique sur une demande pour l'ouvrir.

Ces mêmes demandes figurent aussi chez le client, dans l'onglet **Documents** sous **Demandes de signature**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-customer-documents.png" alt="Onglet Documents d'un client avec le PDF signé et les demandes de signature" />

## La page de détail [#de-detailpagina]

À gauche, tu vois les données de la demande, les signataires dans l'ordre et l'**Historique**. À droite se trouve le document, avec les signatures déjà apposées. En haut, il est indiqué qui est attendu, par exemple *En attente de la signature de Marc Janssens.*

Pour chaque signataire, tu vois s'il doit encore attendre (**En attente**), s'il a reçu le lien (**Lien envoyé**), s'il a **Signé** ou **Refusé**, avec l'heure. La page se rafraîchit d'elle-même quand quelqu'un signe.

### Avant et après : de En cours à Terminé [#voor-en-na-van-bezig-naar-afgerond]

Voici à quoi ressemble le même type de demande pendant la signature, puis après. D'abord elle est <Status tone="info">En cours</Status> : le locataire a signé et c'est au tour du garant.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-in-progress.png" alt="Avant : demande En cours, le locataire a signé et c'est au tour du garant" />

Dès que le dernier signataire a signé, elle passe à <Status tone="success">Terminé</Status>. Toutes les signatures figurent dans le document, l'historique est complété et le bouton pour télécharger le PDF signé apparaît en haut.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-completed.png" alt="Après : demande terminée avec les signatures dans le document et l'historique" />

## Envoyer un rappel [#een-herinnering-sturen]

Chez un signataire dont c'est le tour, clique sur **Envoyer un rappel**. Cette personne reçoit à nouveau le même lien, et Tillor affiche **Le lien a été renvoyé**. Le lien du premier message continue aussi de fonctionner. Le bouton n'existe pas pour les collaborateurs, qui signent dans Tillor, ni pour les signataires qui doivent encore attendre.

Par ailleurs, Tillor envoie lui-même des rappels. Un signataire dont c'est le tour reçoit un rappel après le nombre de jours réglé dans **Rappel après** (3 par défaut), compté à partir du premier message ou du rappel précédent. Cela se produit 2 fois au maximum par signataire, lors du contrôle quotidien de Tillor. Un rappel peut donc arriver jusqu'à un jour plus tard que le nombre de jours que tu as réglé.

## Faire signer sur la tablette [#laten-tekenen-op-de-tablet]

Si le signataire est au comptoir, clique chez cette personne sur **Signer sur tablette**. Comment cela fonctionne et pourquoi le bouton manque parfois, tu le lis dans [Sur la tablette à la réception](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Signer soi-même en tant que collaborateur [#zelf-ondertekenen-als-medewerker]

Si c'est le tour d'un collègue ou le tien, cette personne reçoit un message avec un lien vers Tillor. Sur la page de détail apparaît alors le bouton **Signer maintenant**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-staff-turn.png" alt="Demande dont c'est le tour du collaborateur, avec le bouton Signer maintenant" />

## Annuler une demande [#een-verzoek-annuleren]

Clique sur **Annuler la demande** et confirme. Les liens de signature ne fonctionnent alors plus et les signatures déjà apposées ne sont pas utilisées. Si tu veux finalement continuer, clique sur **Conserver**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-cancel-dialog.png" alt="Confirmation Annuler cette demande ?" />

On ne peut annuler que tant que la demande est <Status tone="info">En cours</Status>. Une demande terminée, refusée ou expirée est définitive.

## Revenir à la modification [#terug-naar-bewerken]

Si personne n'a encore signé, ou seulement toi, le bouton **Revenir à la modification** apparaît sur la page de détail. La demande redevient un brouillon, les liens envoyés ne fonctionnent plus et chacun signe à nouveau après l'envoi. Si quelqu'un d'autre a déjà signé, le bouton est absent. Annule alors la demande et crée-en une nouvelle.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- **Quelqu'un signe** : le signataire passe au statut **Signé** et le suivant reçoit le lien. La page se rafraîchit d'elle-même.
- **Tout le monde a signé** : tu vois brièvement *Tout le monde a signé. Le PDF signé est en préparation.* La demande passe à <Status tone="success">Terminé</Status>. Le PDF signé figure sous le nom **[titre] (signé)** dans les **Documents** du client, avec le même type de document que le PDF d'origine. Si celui-ci n'avait pas de type, il reçoit le type **Accord signé**. Chaque signataire reçoit une copie.
- **Quelqu'un refuse** : la demande s'arrête avec le statut <Status tone="error">Refusé</Status>. La personne qui a créé la demande reçoit une notification et les autres signataires ne sont plus sollicités. Le motif figure chez le signataire, s'il a été renseigné.
- **Tu annules** : la demande reçoit le statut <Status>Annulé</Status> et les liens ne fonctionnent plus.
- **Le délai est dépassé** : après le jour indiqué dans **Signer avant le**, plus personne ne peut signer. Tillor passe la demande à <Status tone="warning">Expiré</Status> lors du contrôle quotidien. Jusqu'à ce contrôle, tu vois sur la page de détail que le délai est dépassé. Si tu veux que quelqu'un signe encore, crée une nouvelle demande.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-declined.png" alt="Demande refusée avec le motif du client" />

## Le PDF signé [#de-ondertekende-pdf]

Sur la page de détail, tu télécharges le PDF avec **Télécharger le PDF signé**, sous l'historique. L'**Horodatage** y figure aussi, voir [Preuve et validité](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

Par e-mail, le PDF est en pièce jointe du message au signataire. Si ce n'est pas possible, un bouton permet de le télécharger. Quiconque n'a qu'un numéro de téléphone reçoit un SMS avec un lien.

Le PDF signé et le PDF d'origine constituent la preuve de la signature. Tu ne peux donc pas les supprimer, seulement les archiver.

## Historique et événements [#verloop-en-gebeurtenissen]

Sous **Historique** figure chaque étape avec l'heure et la personne concernée : créée, envoyée, lien envoyé, page ouverte, code envoyé, code erroné, signée, refusée, remise en brouillon, annulée, expirée et terminée. Cette même ligne figure chez le client dans l'onglet **Événements** et dans le [journal d'activité](/activiteitenlog).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas le bouton Envoyer un rappel">
Le bouton n'existe que chez un signataire au statut **Lien envoyé**, donc dont c'est le tour. Chez un collaborateur, il n'apparaît jamais, car il signe dans Tillor. S'il est présent mais grisé, tu n'as pas le droit **Gérer les demandes de signature**.
</Accordion>
<Accordion title="Tillor dit : Le rappel n’a pas pu être envoyé">
Réessaie. Si cela échoue toujours, vérifie l'adresse e-mail et le numéro de téléphone du signataire. Pour un client ou un contact, corrige-les dans ses données. Pour une partie externe, annule la demande et crée-en une nouvelle avec les bonnes coordonnées.
</Accordion>
<Accordion title="Le bouton Revenir à la modification est absent">
Quelqu'un d'autre que toi a déjà signé. La demande ne peut alors plus revenir à un brouillon. Annule la demande avec **Annuler la demande** et crée-en une nouvelle.
</Accordion>
<Accordion title="Tillor dit : La demande n’a pas pu être annulée">
On ne peut annuler qu'une demande <Status tone="info">En cours</Status>. Recharge la page et regarde quel est le statut actuel. Une demande terminée, refusée ou expirée ne peut plus être annulée.
</Accordion>
<Accordion title="La demande est encore En cours, mais le délai est dépassé">
Tu vois *Le délai de signature est écoulé ; la demande expire lors du prochain contrôle quotidien.* Plus personne ne peut signer. Une fois le contrôle effectué, la demande passe à <Status tone="warning">Expiré</Status>.
</Accordion>
<Accordion title="Je vois Tout le monde a signé, mais pas encore de PDF signé">
Tillor prépare encore le PDF. Recharge la page après quelques minutes. Dès qu'il est prêt, il figure parmi les documents du client et **Télécharger le PDF signé** apparaît. S'il n'est toujours pas prêt après un quart d'heure, Tillor réessaie lors du prochain contrôle quotidien.
</Accordion>
<Accordion title="Je ne peux pas supprimer le document ni le PDF signé">
C'est voulu. Le PDF d'origine et le PDF signé constituent la preuve. Tu peux en revanche les archiver.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Comment une personne signe" href="/handtekeningen/ondertekenen" />
  <Card title="Preuve et validité" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Documents" href="/documenten" />
</Cards>


# Scans d'identité (/fr-FR/identiteitsscans)

Avec un lecteur d'identité, tu scannes des passeports, cartes d'identité, permis de conduire, visas et titres de séjour. Tillor reconnaît le type de document, lit les données et s'en sert pour créer rapidement un client, sans que tu aies à tout retaper. Le lecteur envoie le scan à ton organisation via le [connecteur Tillor](/connector) sur ton réseau local. La suite, la création d'un client, est décrite dans [Créer un client à partir d'un scan](#klant-aanmaken-vanuit-een-scan).

<Callout type="info" title="Bon à savoir">
- Un scan sans client associé est supprimé automatiquement par Tillor après 7 jours, avec les fichiers qui s'y rattachent.
- Un scan associé est conservé jusqu'à ce que tu le dissocies ou le supprimes. C'est toi qui fixes la durée de conservation.
- Créer un client à partir d'un scan nécessite au moins un prénom dans le scan.
- S'il existe déjà un client avec le même numéro de registre national, associe le scan à ce client plutôt que de créer un doublon.
- Les fichiers de scan sont stockés sous forme chiffrée. Les images de page portent un filigrane **Not valid as ID**. Le portrait reste sans filigrane.
- Le connecteur écoute par défaut sur le port 8765.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  subgraph lokaal[Réseau local]
    R[Lecteur d identité]
    C[Connecteur Tillor]
  end
  T[Scan en attente dans Tillor]
  K[Client ou contact]
  R --> C
  C --> T
  T -->|Créer ou associer le client| K
  T -->|Non associé après 7 jours| X[Supprimé automatiquement]
```

Un scan commence comme scan en attente. Si tu l'associes à un client ou à un contact, il reste conservé chez ce client.

## Créer un client à partir d'un scan [#klant-aanmaken-vanuit-een-scan]

Avant de commencer :

- Le scan doit figurer dans Tillor comme scan en attente. S'il n'y est pas, voir Un problème ? en bas de page.
- Le scan doit avoir un prénom.

<Steps>
<Step>
### Ouvre la liste des clients [#open-de-klantenlijst]
Va dans <UIPath>Clients > Aperçu</UIPath> et clique sur **Créer un nouveau client**. Tant qu'il y a des scans en attente, le bouton affiche un menu : choisis **Manuel** ou un scan dans la liste.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Créer un nouveau client - menu avec scan d'identité en attente" />
</Step>
<Step>
### Vérifie le scan [#controleer-de-scan]
Après avoir choisi un scan, une confirmation s'ouvre avec un aperçu du document et les données de la zone de lecture. Clique sur **Créer le client**.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Confirmation après le choix d'un scan en attente avec aperçu du document" />
</Step>
</Steps>

Le même chemin fonctionne via **Commencer une réservation** (**Nouveau client…**) et via le panneau en bas à droite avec **Créer un client à partir de la numérisation**.

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Panneau en bas à droite - scan d'identité en attente avec aperçu du document" />

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Tillor crée le client, associe le scan et renseigne si possible prénom, nom, date de naissance, adresse et autres champs.
- Tu arrives sur le nouveau profil client.
- Le scan ne figure plus dans la file d'attente et reste conservé chez le client.
- L'association figure dans l'onglet **Événements** du client.

## Associer à un client ou un contact existant [#koppelen-aan-een-bestaande-klant-of-contactpersoon]

Outre un nouveau client, tu peux aussi associer un scan à un client ou un contact existant.

<Tabs items={["À un client", "À un contact"]}>
<Tab value="À un client">
Sur le profil client apparaît une carte en pointillés **Associer une numérisation en attente** tant qu'il y a des scans en attente appropriés. Choisis un scan avec **Choisir une numérisation…** et clique sur **Associer à ce client**.
</Tab>
<Tab value="À un contact">
Sur la carte d'un contact, tu peux associer un scan qui n'a pas encore de contact et qui contient au moins un prénom, avec **Lier au contact**. Tu peux aussi faire créer un nouveau contact avec **Créer un contact à partir du scan**.
</Tab>
</Tabs>

Après l'association, Tillor complète si possible les données du client ou du contact. Comme prénom, Tillor ne reprend que la première partie du prénom, par exemple `Andy` pour `Andy Adhemar R`. Sur le scan, tous les prénoms restent visibles.

## Dissocier, exporter ou supprimer un scan [#een-scan-ontkoppelen-exporteren-of-verwijderen]

Pour un scan associé, des actions sont disponibles : **Télécharger**, **Exporter en PDF**, **Découpler le scan** et **Supprimer le scan**. La suppression retire définitivement le scan et tous les fichiers chiffrés et ne peut pas être annulée.

## Durée de conservation et ta responsabilité [#bewaartermijn-en-jouw-verantwoordelijkheid]

<Callout type="warn" title="7 jours pour les scans en attente">
Les scans qui ne sont pas encore associés à un client sont supprimés automatiquement par Tillor après 7 jours (le scan et les fichiers qui s'y rattachent). Associe ou traite les scans en attente à temps via **Créer un nouveau client**, le panneau en bas à droite ou la carte en pointillés sur un profil client.
</Callout>

Pour les scans associés, une autre règle s'applique : ils sont conservés jusqu'à ce que ton organisation les dissocie ou les supprime. C'est toi qui décides si, quand et sur quelle base juridique des pièces d'identité sont scannées et combien de temps les scans associés sont nécessaires. Tillor traite les scans en tant que sous-traitant, sur ton instruction. Le respect de la législation sur la vie privée, des durées de conservation des scans associés et de la suppression en temps utile lorsque le stockage n'est plus nécessaire relève de ta responsabilité en tant que responsable du traitement.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Aucun scan n'arrive dans Tillor">
Vérifie sur le lecteur l'adresse IP du connecteur et le port 8765, ainsi que le fonctionnement du connecteur. Voir [Connecteur](/connector).
</Accordion>
<Accordion title="Le scan ne figure pas dans le menu ou le panneau">
Seuls les scans sans client associé comptent comme en attente. Si le scan est déjà associé, ou plus ancien que 7 jours et donc supprimé, il n'y figure plus.
</Accordion>
<Accordion title="Créer un client à partir de la numérisation est grisé">
La raison figure près du scan. Si le scan n'a pas de prénom, il est indiqué *saisissez-le sur le lecteur ou liez la numérisation manuellement*. Si le document est encore valide et qu'il existe déjà un client avec ce numéro de registre national, ouvre le client proposé en haut de la carte ou associe le scan à ce client.
</Accordion>
<Accordion title="Tillor dit : Impossible de créer un client à partir de cette numérisation">
Le client n'a pas été créé et le scan reste en attente. Réessaie. Si cela échoue, crée le client manuellement et associe le scan avec **Attribuer au client**.
</Accordion>
<Accordion title="Tillor dit : Impossible de lier la numérisation au client">
Réessaie, ou utilise le panneau en bas à droite.
</Accordion>
</Accordions>

## Termes [#begrippen]

- **Scan d'identité** : les données lues et les images d'une seule pièce d'identité.
- **Scan en attente** : un scan qui n'est pas encore associé à un client et qui disparaît après 7 jours.
- **Zone de lecture (MRZ)** : les lignes de lettres et de chiffres en bas du document que le lecteur interprète.
- **Connecteur** : le petit boîtier sur ton réseau local qui transmet les scans à Tillor. Voir [connecteur](/begrippen#connector).
- **Client** : l'enregistrement dans Tillor. Voir [client](/begrippen#klant).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" description="Créer un client, y compris par un scan" />
  <Card title="Connecteur" href="/connector" description="Le boîtier connecteur dans ton parc" />
  <Card title="Exemples pratiques" href="/praktijk" />
</Cards>


# Lire et répondre aux conversations (/fr-FR/inbox/gesprekken)

La boîte de réception rassemble toutes les conversations de vos canaux connectés. Vous y lisez les messages, vous y répondez et vous les rangez. La façon de connecter un canal est décrite dans [Inbox](/inbox).

Avant de commencer :

- Il vous faut l'autorisation **Consulter la boîte de réception** pour lire les conversations et **Gérer la boîte de réception** pour répondre ou archiver. Sans **Consulter la boîte de réception**, la boîte de réception n'apparaît pas dans la barre latérale.
- Au moins un canal doit être connecté. Sinon, vous voyez un lien vers <UIPath>Paramètres > Intégrations</UIPath>.

<Requires permission="Inbox bekijken" />

## Ouvrir la boîte de réception [#de-inbox-openen]

<Steps>
<Step>
### Allez dans la boîte de réception [#ga-naar-de-inbox]
Dans la barre latérale, sous **Support**, choisissez **Boîte de réception** (repère **1** sur la capture d'écran). Si aucun canal n'est encore connecté, Tillor affiche un lien vers <UIPath>Paramètres > Intégrations</UIPath>.
</Step>
<Step>
### Choisissez une conversation [#kies-een-gesprek]
À gauche se trouve la liste **Conversations** avec les fils de tous les canaux. Avec **Ouvertes** et **Archivées**, vous passez des conversations actives aux conversations traitées. Cliquez sur une conversation pour l'ouvrir à droite.
</Step>
</Steps>

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-overview.png" alt="Boîte de réception : liste des conversations avec des conversations de démonstration et colonne de détail vide" />

Une conversation ouverte affiche les messages dans l'ordre, avec le nom et l'heure. Le champ de réponse se trouve en bas (repère **2** dans l'exemple).

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-whatsapp.png" alt="Boîte de réception : conversation WhatsApp avec le champ de réponse" />

L'arrière-plan d'une conversation suit le canal : beige pour WhatsApp, bulles bleues pour Messenger, rose pour Instagram et gris clair pour le chat du site web.

## Envoyer une réponse [#een-antwoord-sturen]

<Requires permission="Inbox beheren" />

<Steps>
<Step>
### Ouvrez la conversation [#open-het-gesprek]
Cliquez sur la conversation dans la liste.
</Step>
<Step>
### Saisissez votre réponse [#typ-je-antwoord]
Saisissez votre texte dans le champ de réponse en bas.
</Step>
<Step>
### Envoyez [#verstuur]
Cliquez sur **Envoyer** ou appuyez sur **Ctrl+Entrée**.
</Step>
</Steps>

Sur vos propres messages, une coche à côté de l'heure signifie envoyé, une double coche signifie distribué et une double coche bleue signifie lu. Les réponses que vous envoyez via l'application WhatsApp Business ou l'application Messenger apparaissent aussi dans la conversation tant que l'intégration est active.

Vous ne pouvez pas modifier un message que vous avez envoyé : les canaux ne le permettent pas. Sur Messenger et Instagram, un bouton de suppression se trouve à côté de votre propre message texte. Il ne masque le message que dans Tillor ; le client le conserve dans sa propre application.

Les photos reçues via Messenger sont enregistrées et affichées dans la conversation ; dans la liste, une icône de photo remplace alors le texte. Les réactions par émoji aux messages Messenger apparaissent sous forme de compteurs sous le message.

### WhatsApp et la fenêtre de réponse de 24 heures [#whatsapp-en-het-antwoordvenster-van-24-uur]

Un client qui vous écrit sur WhatsApp ouvre une fenêtre de réponse gratuite de 24 heures. Tillor affiche **Fenêtre de réponse gratuite ouverte** avec un compte à rebours. Quand la fenêtre est fermée, **Fenêtre de 24 h fermée** apparaît et votre réponse part sous forme de modèle WhatsApp payant, jusqu'à ce que le client écrive de nouveau.

- Si aucun moyen de paiement n'a été ajouté pour votre compte WhatsApp Business dans Meta WhatsApp Manager, Tillor bloque les réponses payantes. Les réponses gratuites dans la fenêtre restent possibles.
- Si Meta n'a pas encore approuvé le modèle dans la langue de votre organisation, votre réponse attend. Cela prend en général quelques minutes et peut aller jusqu'à 48 heures.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Votre réponse apparaît dans la conversation avec une coche : envoyé, distribué ou lu. Si la distribution échoue, **Non distribué** s'affiche.
- Une conversation archivée disparaît de **Ouvertes**. Si le client écrit de nouveau, la conversation réapparaît.
- La conversation figure aussi chez le client, sous <UIPath>Clients > client > Communication</UIPath>.

## Retrouver et ranger les conversations [#gesprekken-terugvinden-en-opruimen]

- **Rechercher** : filtrez les fils par nom ou numéro de téléphone, dans **Ouvertes** ou **Archivées**.
- **Non lues** : dans **Ouvertes**, les conversations non lues sont en gras, avec un point rouge. Cliquez sur **Tout marquer comme lu** en haut de la liste pour tout marquer comme lu en une fois.
- **Archiver** : cliquez sur **Archiver** pour une conversation traitée dans **Ouvertes**.
- **Restaurer** : ouvrez une conversation dans **Archivées** et cliquez sur **Restaurer** pour la remettre en place et pouvoir y répondre de nouveau.
- **Menu contextuel** : faites un clic droit ou un appui long sur une conversation pour **Marquer comme lu**, **Marquer comme non lu**, **Épingler la conversation** ou **Retirer l'épingle**, **Archiver** et **Restaurer**.

Le nombre à côté de **Boîte de réception** dans la barre latérale compte les conversations ouvertes dont le dernier message vient du client et attend une réponse. Les nouveaux messages apparaissent en direct ; le nombre se met à jour tout seul.

## Tags [#tags]

Avec les tags, vous classez les conversations pour toute votre équipe.

1. Ouvrez une conversation et utilisez le bloc **Tags** dans le panneau latéral.
2. Créez un tag avec **Nouveau tag** ou choisissez-en un existant. Via le menu des tags, vous modifiez ou supprimez des tags.
3. Filtrez la liste avec l'icône de tag à côté du filtre de plateforme.

Les tags avec **L'IA peut appliquer** peuvent être ajoutés par Tillie après une réponse automatique. Les tags que votre équipe avait déjà posés restent en place.

## Notifications [#meldingen]

Les utilisateurs avec **Notifications de messages inbox** reçoivent une notification push pour chaque nouveau message d'un client. Vos propres réponses ne déclenchent pas de notification.

Avec **Consulter la boîte de réception**, vous voyez aussi, à chaque nouveau message, une notification en bas à droite, dans le même dock que les scans d'identité en attente et les appels téléphoniques actifs. Elle indique l'expéditeur, le canal et un extrait du texte. Cliquez dessus pour ouvrir la conversation. La notification disparaît après une dizaine de secondes, sauf si vous gardez la souris dessus. Si la conversation est déjà ouverte, aucune notification n'apparaît.

## Conversations et clients [#gesprekken-en-klanten]

Tillor associe une conversation à un client quand c'est possible :

- WhatsApp par numéro de téléphone.
- Messenger par un nom correspondant, ou par un numéro de téléphone ou une adresse e-mail que le client partage lui-même dans la conversation.
- Instagram par un nom correspondant ou un nom d'utilisateur `@`.

Meta ne transmet ni adresse e-mail ni numéro de téléphone via Messenger et Instagram. Les conversations ouvertes d'un client figurent aussi sous <UIPath>Clients > client > Communication</UIPath>.

Le panneau latéral de droite affiche, pour chaque canal, les informations du participant, comme le numéro WhatsApp, le nom d'utilisateur Instagram avec le lien du profil ou la page pour le chat du site web. Avec l'icône de panneau au-dessus de la conversation, vous masquez ou affichez le panneau.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas la boîte de réception dans la barre latérale">
Il vous faut l'autorisation **Consulter la boîte de réception**. Demandez à un administrateur de vous l'accorder via <UIPath>Paramètres > Utilisateurs</UIPath>, avec **Modifier les autorisations utilisateur** à côté de votre nom.
</Accordion>
<Accordion title="Je ne peux pas envoyer de réponse">
Pour répondre, il vous faut **Gérer la boîte de réception**. Dans une conversation archivée, vous ne pouvez pas répondre non plus : cliquez d'abord sur **Restaurer**.
</Accordion>
<Accordion title="Tillor indique Échec de l'envoi du message">
Vérifiez que la conversation est ouverte et que vous avez **Gérer la boîte de réception**. Pour WhatsApp, la fenêtre de réponse fermée peut aussi en être la cause, voir ci-dessus. Réessayez ensuite.
</Accordion>
<Accordion title="Mon message affiche Non distribué">
Le canal n'a pas pu remettre le message. Pour WhatsApp, cela vient le plus souvent de la fenêtre de 24 heures fermée ou d'un moyen de paiement manquant chez Meta.
</Accordion>
<Accordion title="La boîte de réception est vide">
Aucun canal n'est encore connecté, ou aucun message n'est encore arrivé. Connectez un canal sous <UIPath>Paramètres > Intégrations</UIPath>.
</Accordion>
<Accordion title="Un client a modifié ou supprimé un message">
Tillor adapte automatiquement la conversation quand un client modifie ou retire un message sur Messenger ou Instagram, ou le modifie sur WhatsApp (dans les 15 minutes).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Aperçu" href="/inbox" description="Canaux et autorisations" />
  <Card title="Conversations via le chat du site" href="/inbox/website-chat-gesprekken" description="Particularités du chat sur votre site" />
  <Card title="Assistant IA de la boîte de réception" href="/inbox/inbox-ai-assistant" description="Tillie sur tous les canaux" />
</Cards>


# Assistant IA de la boîte de réception (Tillie) (/fr-FR/inbox/inbox-ai-assistant)

**Tillie** est le nom par défaut de l'assistant IA de la [boîte de réception Tillor](/inbox). Elle répond aux questions fréquentes, recueille les informations pour les demandes de réservation ou de vente et transfère la conversation à votre équipe quand un collègue est nécessaire. Tillie fonctionne sur **tous les canaux de la boîte de réception** : [chat du site](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) et [Instagram Direct](/inbox/instagram).

<Callout type="info" title="Indépendant du chat du site">
Installez **Assistant IA de la boîte de réception** séparément sous **Paramètres > Intégrations**. L'assistant fait partie de la boîte de réception, pas seulement du widget du site.
</Callout>

## Installer l'intégration [#integratie-installeren]

1. Allez dans **Paramètres > Intégrations** (barre latérale, sous **Support**)
2. Ouvrez **Assistant IA de la boîte de réception** dans la liste
3. Cliquez sur **Installer**
4. Sous **Paramètres**, définissez ce que Tillie a le droit de faire (voir les champs ci-dessous)

| Champ | Que fait-il ? |
|------|----------------|
| **IA de la boîte de réception activée** | Interrupteur principal de toutes les fonctions d'IA de la boîte de réception. Désactivez-le pour tout arrêter sans désinstaller |
| **Envoyer des réponses automatiques** | Désactivé : Tillie n'envoie aucun message aux visiteurs. Les traductions, la détection de langue et les brouillons de réponse pour l'équipe peuvent rester actifs séparément |
| **Activer automatiquement l'IA pour les nouvelles conversations** | S'applique uniquement si les réponses automatiques sont activées. Désactivé : chaque nouvelle conversation démarre sans IA ; vous l'activez par conversation dans la barre latérale. Activé : les nouvelles conversations de tous les canaux reçoivent tout de suite l'IA (avec 30 minutes de pause après un message de l'équipe) |
| **Générer des brouillons pour l'équipe** | Permet aux collègues de générer un brouillon IA dans la zone de rédaction. Ce brouillon n'est jamais envoyé automatiquement |
| **Traduire les messages** | Traduit les messages entrants dans la langue de l'organisation et les réponses de l'équipe dans la langue du contact. Les réponses de l'équipe reçoivent aussi une ponctuation soignée, des majuscules et les abréviations de chat écrites en toutes lettres (même s'il n'y a rien à traduire) |
| **Détecter la langue du contact** | Utilise l'IA pour reconnaître la langue du visiteur quand elle n'est pas encore connue, et l'enregistre sur la conversation |
| **Nom de l'assistant IA** | Nom utilisé dans les réponses et les prompts (par défaut **Tillie**) |
| **Serveurs MCP (JSON)** | Facultatif. Connexions MCP en lecture seule (URL et en-têtes) |
| **Outils MCP** | Après enregistrement : **Charger les outils**, liste des outils en lecture seule, à activer ou désactiver un par un |

<Callout type="info" title="Traduire uniquement, sans réponses automatiques">
Activez **IA de la boîte de réception activée**, **Traduire les messages** (et éventuellement **Détecter la langue du contact**), et désactivez **Envoyer des réponses automatiques**. Tillie traduit alors, mais n'envoie rien aux visiteurs.
</Callout>

### Outils MCP (facultatif) [#mcp-tools-optioneel]

Si votre parc dispose d'un serveur MCP avec des connexions en lecture seule, Tillor peut récupérer des **données du parc en direct** pendant une conversation. Pensez aux activités, aux caravanes à vendre ou à d'autres données que votre serveur propose.

Tillor n'a **pas de liste fixe de noms d'outils**. Les outils existants s'affichent après **Charger les outils** dans les paramètres de l'intégration. Vous ne pouvez activer que les outils que votre serveur MCP marque comme étant en lecture seule.

1. Renseignez **Serveurs MCP (JSON)** (URL et en-têtes).
2. Enregistrez et cliquez sur **Charger les outils**.
3. Activez les outils qui correspondent à votre parc.

Selon la configuration IA de votre environnement, Tillie choisit elle-même l'outil activé qui convient, d'après la description de l'outil sur votre serveur. Elle n'appelle jamais d'outils que vous n'avez pas activés.

Les résultats venant de MCP se retrouvent dans la réponse de Tillie. Ils ne remplacent pas la base de connaissances : les prix, la disponibilité et les règles, elle ne les invente toujours pas si elle ne les trouve nulle part.

<Callout type="info" title="Pas de réponse de Tillie ?">
Tillie utilise un modèle d'IA que Tillor configure pour votre environnement. Si l'assistant ne répond pas, contactez le support Tillor.
</Callout>

## Ce que fait Tillie après un message de visiteur [#wat-tillie-doet-na-een-bezoekersbericht]

Après chaque nouveau message entrant dans une conversation où l'IA est active :

1. Tillor affiche un **indicateur de saisie** sur le canal pendant que la réponse est générée
2. Tillor détermine l'intention : **réservation**, **vente** ou **autre** (pour les organisations avec le parcours caravane de location, aussi **caravane de location**)
3. Tillie répond dans la langue du visiteur ; ensuite l'indicateur de saisie disparaît

Tillie décide elle-même, d'après ses instructions, quand elle répond et quand elle reste silencieuse. À une formule d'accueil (« salut », « bonjour »), elle répond par un court mot de bienvenue et demande en quoi elle peut aider. Après un remerciement final, elle ne réagit plus à un bref « merci », « ok » ou « non » du visiteur, pour éviter une boucle de remerciements.

| Intention | Comportement |
|-----------|--------|
| **Réservation** | Demande les informations manquantes : arrivée, départ, type (tente, mobil-home, caravane de tourisme), chiens oui/non (et combien), nombre de personnes, enfants et âges, puis nom, e-mail et numéro de téléphone, et éventuellement la plaque d'immatriculation pour l'enregistrement (peut être ignorée). Les informations que Tillor connaît déjà (par exemple via le widget du site ou WhatsApp) sont préremplies ; seuls les champs manquants sont demandés. Pour un jour de la semaine (« lundi »), Tillie pose d'abord une question de confirmation (« Vous voulez dire … ? ») avant de continuer. Chaque réponse se termine par une seule question. Elle répond aux courtes questions de politique tirées de la base de connaissances (par exemple modifier une réservation plus tard) puis continue la collecte. Quand tout est complet, Tillie résume la **demande** et transfère la conversation à un collègue : il n'y a pas encore de réservation définitive |
| **Caravane de location** | Recueille le nom, l'e-mail, l'adresse, le pays et le motif du séjour (sur demande), puis transfère à votre équipe |
| **Vente** | Explique que le visiteur doit passer au bureau pour une visite ou un achat, et transmet l'information à votre équipe |
| **Autre** | Ne répond que si la réponse figure dans la base de connaissances. Sinon Tillie dit honnêtement qu'elle ne sait pas, propose de transmettre la question à un collègue et transfère la conversation |

Tillie **n'invente ni prix, ni disponibilité, ni règles**. Seul ce qui figure dans la base de connaissances peut être énoncé comme un fait.

### Formulaire de réservation sur votre site [#boekingsformulier-op-je-website]

Vous connectez votre propre formulaire au [chat du site](/inbox/website-chat) ? Vous pouvez alors demander à Tillie de se limiter à confirmer et à transférer aussitôt, sans questions d'accueil. Cela convient à un formulaire dont l'onglet se ferme ensuite. Voir [API du chat du site - métadonnées](/ontwikkelaars/website-chat#metadata-boekingsformulier).

## Par conversation : Automatique, Activé ou Désactivé [#per-gesprek-automatisch-aan-of-uit]

Dans les détails de la conversation, dans la barre latérale, vous choisissez pour chaque fil :

| Mode | Comportement |
|-------|--------|
| **Automatique** | Tillie répond, mais fait une pause de **30 minutes** après chaque message de votre équipe |
| **Activé** | Tillie répond toujours, même juste après un message de l'équipe |
| **Désactivé** | Tillie ne répond pas à cette conversation |

Pendant la pause, un compte à rebours s'affiche dans la barre latérale.

## Tags après une réponse de l'IA [#tags-na-een-ai-antwoord]

Dans le panneau latéral, vous pouvez créer et attribuer des **tags** valables pour toute l'organisation (autorisation **Gérer la boîte de réception**). Utilisez **Nouveau tag** pour en créer un. Ouvrez le menu des tags sur une conversation pour attribuer des tags ; pour chaque tag, la modification et la suppression se trouvent dans ce même menu. Cochez **L'IA peut appliquer** si Tillie peut ajouter ce tag après une réponse automatique. Tillie choisit alors elle-même zéro, un ou plusieurs de ces tags selon la conversation ; les tags que votre équipe avait déjà posés restent en place.

Des tags typiques sont par exemple **Vente**, **Réservation** et **Urgent**. Tillie reconnaît ces noms et les relie à ce qu'elle a déjà établi dans la conversation :

| Intention de Tillie | Correspond à des noms de tag comme |
|---|---|
| Vente | Vente, Sale |
| Réservation | Réservation, Boeking, Booking |
| Caravane de location | Caravane, Location |
| Transfert urgent | Urgent, Spoed, Dringend |

Le nom du tag n'a pas besoin de correspondre exactement : **Demande de réservation** compte aussi comme tag de réservation. Seuls les tags avec **L'IA peut appliquer** entrent en ligne de compte.

## Langue, ton et coordonnées [#taal-toon-en-contactgegevens]

Les réponses suivent la langue du visiteur, pas seulement les quatre langues du widget (`en`, `nl`, `de`, `fr`), mais toute langue dans laquelle Tillie peut répondre (par exemple espagnol, polonais, turc). Si quelqu'un demande explicitement une autre langue, Tillie bascule et enregistre la langue choisie sur la conversation.

Les **résumés de transfert** (visibles uniquement par votre équipe) suivent toujours la **langue de l'organisation** définie dans Tillor, pour chaque transfert (réservation, caravane de location, vente, question ouverte, demande explicite d'un collègue), quelle que soit la langue de la conversation. Tillie reçoit cette langue d'organisation dans chaque prompt.

Les messages aux visiteurs (IA et équipe) sont toujours en **texte brut**, sans markdown, car WhatsApp, Instagram, Messenger et le widget ne le prennent pas en charge. Sur WhatsApp, Tillie peut ajouter jusqu'à trois boutons de réponse sous une courte réponse, lorsqu'un appui correspond à un choix que le message mentionne déjà. Le message reste lisible si le client écrit au lieu d'appuyer. En dehors de la fenêtre de 24 heures, la réponse part sous forme de modèle sans boutons.

Tillie reste calme et professionnelle, ne parle pas des concurrents et ne néglige aucune règle de sécurité si un visiteur demande d'ignorer les instructions. Les coordonnées de renvoi proviennent de votre **profil d'organisation Tillor** (nom, adresse, téléphone, e-mail, site web). Les **heures d'ouverture du bureau** se définissent sous **Paramètres > Heures d'ouverture** (horaires hebdomadaires, périodes saisonnières, jours fériés et exceptions) ; Tillie utilise ces heures pour dire quand un collègue peut répondre. Gardez ces champs à jour. Environ une semaine avant un jour férié légal, Tillor rappelle par e-mail l'adresse du support si les heures de ce jour ne sont pas encore renseignées.

## Événements dans la conversation (visibles uniquement par votre équipe) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team]

Pendant la prise en charge d'une réservation, Tillie met à jour le nom, l'e-mail et le téléphone dès que le visiteur les communique. Dans la boîte de réception apparaît alors un événement **Données IA mises à jour** (de → vers), visible uniquement par votre équipe.

Lors d'un transfert apparaît un événement **Transfert IA** : une carte bien visible avec un résumé (tableau pour les données de réservation ou de caravane de location, plus des notes pour les questions ouvertes). Le résumé est toujours dans la **langue de votre organisation** (nl, en, de ou fr), même si le visiteur discute dans une autre langue. Le visiteur ne voit pas cette carte.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Boîte de réception : chat du site avec transfert IA et détails de la conversation" />

## Base de connaissances : les faits que Tillie peut utiliser [#kennisbank-feiten-die-tillie-mag-gebruiken]

Tillie répond aux questions à partir d'une **base de connaissances** : de courts articles contenant des faits vérifiés sur votre parc, par exemple les heures d'ouverture, les règles pour les animaux, la piscine, les bornes de recharge ou la façon de modifier une réservation plus tard.

Certains articles valent pour toutes les organisations Tillor, d'autres sont propres à votre parc. Dans une conversation, Tillie n'utilise que les articles généraux et ceux qui ont été ajoutés pour votre organisation.

Vous souhaitez faire ajouter, modifier ou supprimer des sujets ? Transmettez-le au support Tillor. Nous remplissons et maintenons la base de connaissances avec vous, en fonction de ce que votre réception veut pouvoir répondre.

## Parcours de conversation : un scénario par intention [#gespreksflows-draaiboek-per-bedoeling]

En plus de la base de connaissances, Tillie suit des **parcours de conversation** : des règles sur les informations qu'elle demande, dans quel ordre, et quand elle transfère la conversation à votre équipe. Chaque intention (réservation, caravane de location, vente, autre, voir le tableau ci-dessus) a un tel parcours.

Les parcours sont définis par défaut, mais Tillor les ajuste avec vous à votre parc. Vous voulez par exemple faire demander d'autres informations pour une demande de réservation, ou faire transférer Tillie plus vite ? Transmettez-le au support Tillor.

<Callout type="warn" title="Première version">
Vérifiez les réponses de l'IA dans la boîte de réception avant de les confier aux visiteurs. Une réservation par chat reste une **demande**, pas une réservation définitive.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une conversation que Tillie transfère apparaît dans la boîte de réception avec un bloc **Tillie a transféré cette conversation à votre équipe** et les informations recueillies.
- Votre équipe reçoit une notification. Pour un transfert urgent, elle passe par la notification **Transfert IA urgent**. Voir [Types de notifications](/communicatie/notificatietypes).
- Si un collègue répond, Tillie fait une pause de 30 minutes en mode **Automatique**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillie ne répond pas">
Vérifiez que **IA de la boîte de réception activée** et **Envoyer des réponses automatiques** sont activés sous <UIPath>Paramètres > Intégrations > Assistant IA de la boîte de réception</UIPath>. Regardez ensuite dans la barre latérale de la conversation si le mode n'est pas sur **Désactivé**, ou si un compte à rebours est en cours après un message de votre équipe.
</Accordion>
<Accordion title="Les nouvelles conversations démarrent sans Tillie">
**Activer automatiquement l'IA pour les nouvelles conversations** est désactivé. Activez l'interrupteur, ou choisissez **Activé** par conversation.
</Accordion>
<Accordion title="Tillie dit qu'elle ne sait pas">
Tillie n'utilise que ce qui figure dans la base de connaissances et n'invente ni prix, ni disponibilité, ni règles. Complétez la base de connaissances.
</Accordion>
</Accordions>

## Voir aussi [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Lire et répondre aux conversations" />
  <Card title="Chat du site" href="/inbox/website-chat" description="Chat en direct sur votre propre site" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="WhatsApp dans la boîte de réception" />
  <Card title="Messenger" href="/inbox/messenger" description="Connecter Facebook Messenger" />
  <Card title="Instagram" href="/inbox/instagram" description="Connecter Instagram Direct" />
</Cards>


# Aperçu (/fr-FR/inbox)

Dans la boîte de réception, vous lisez et répondez aux messages des clients et des visiteurs qui arrivent par WhatsApp, Messenger, Instagram ou le chat de votre site web, tous au même endroit. Vous la trouvez dans la barre latérale sous **Support > Boîte de réception**. Vous connectez d'abord les canaux que vous voulez utiliser, puis vous travaillez au quotidien dans [Lire et répondre aux conversations](/inbox/gesprekken).

<Callout type="info" title="Pas pour les notifications automatiques">
La boîte de réception sert aux échanges dans les deux sens avec les clients. Les notifications WhatsApp automatiques, par exemple en cas de solde NFC bas, passent par Twilio et non par ces intégrations.
</Callout>

<Callout type="info" title="Bon à savoir">
- Un nouveau message apparaît sous forme de carte en bas à droite et disparaît après une dizaine de secondes. Le nombre à côté de **Boîte de réception** compte les conversations ouvertes qui attendent une réponse
- L'assistant IA Tillie fait une pause de 30 minutes après qu'un collègue a répondu
- Un message de chat sur le site web peut contenir au maximum 4096 caractères, sans images ni fichiers
- Un client peut modifier un message WhatsApp jusqu'à 15 minutes après l'envoi, et vous le voyez dans la conversation
- Le rappel par e-mail à un visiteur du site part après environ 5 minutes d'inactivité. Le lien fonctionne 30 jours
- Un message que vous supprimez vous-même dans Tillor (Messenger et Instagram) ne disparaît que dans Tillor, pas chez le client

</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Vous installez chaque canal séparément. Toutes les conversations arrivent ensuite dans la même liste, et Tillor les associe à un client quand c'est possible.

```mermaid
flowchart LR
  W[WhatsApp] --> I[Boîte de réception]
  M[Messenger] --> I
  G[Instagram] --> I
  C[Chat sur votre site web] --> I
  I --> K[Client associé via numéro de téléphone ou nom]
  I --> A[Tillie répond ou transfère]
  A --> T[Votre équipe]
  I --> T
  T -->|réponse| W
  T -->|réponse| M
  T -->|réponse| G
  T -->|réponse| C
```

- Votre équipe répond dans Tillor. La réponse repart vers le client par le même canal.
- Tillie, l'assistant IA, peut répondre et transférer une conversation à votre équipe. Vous le décidez par conversation.
- Les réponses que vous envoyez en dehors de Tillor, par exemple dans l'application WhatsApp Business, apparaissent aussi dans la conversation.

## Connecter les canaux [#kanalen-koppelen]

Installez une intégration par canal sous <UIPath>Paramètres > Intégrations</UIPath>.

<Cards>
  <Card title="Chat du site" href="/inbox/website-chat" description="Bouton de chat sur votre propre site, sans compte externe" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="Connecter un numéro WhatsApp via Meta" />
  <Card title="Messenger" href="/inbox/messenger" description="Connecter une page Facebook via Meta" />
  <Card title="Instagram" href="/inbox/instagram" description="Connecter Instagram Direct via Meta" />
  <Card title="Assistant IA de la boîte de réception" href="/inbox/inbox-ai-assistant" description="Tillie répond et transfère sur tous les canaux" />
</Cards>

Pour Messenger, Tillor récupère les conversations existantes de la page lors de la connexion. Si Messenger est déjà connecté, vous pouvez aussi lancer cette synchronisation manuellement depuis la boîte de réception.

## Travailler au quotidien [#dagelijks-werken]

<Cards>
  <Card title="Lire et répondre aux conversations" href="/inbox/gesprekken" description="Répondre, archiver, tags et notifications" />
  <Card title="Conversations via le chat du site" href="/inbox/website-chat-gesprekken" description="Ce que vous voyez pour un visiteur du site" />
</Cards>

## Autorisations [#rechten]

| Autorisation | Que peut faire l'utilisateur ? |
|-----------|------------------------|
| **Consulter la boîte de réception** | Ouvrir la boîte de réception et lire les conversations |
| **Gérer la boîte de réception** | Envoyer des réponses, archiver, restaurer et épingler des conversations, les marquer comme non lues et supprimer ses propres messages dans Tillor (Messenger et Instagram) |
| **Notifications de messages inbox** | Recevoir des notifications push pour les nouveaux messages de clients |

Définissez les autorisations sous <UIPath>Paramètres > Utilisateurs</UIPath>.

## Notions [#begrippen]

- **Conversation ou fil** : tous les messages avec un client ou un visiteur sur un canal.
- **Ouvertes et Archivées** : les deux onglets de la liste des conversations. Archiver retire une conversation de **Ouvertes**, restaurer la remet en place.
- **Tillie** : le nom par défaut de l'assistant IA dans la boîte de réception. Vous pouvez modifier ce nom.


Vous trouverez d'autres termes dans le [glossaire](/begrippen).


# Instagram (/fr-FR/inbox/instagram)

Avec **Instagram**, vous recevez les messages Instagram Direct dans la [boîte de réception Tillor](/inbox). L'intégration utilise une **page Facebook** connectée avec un **compte professionnel Instagram** dans Meta Business Suite.

Avant de commencer :

- Il vous faut l'autorisation **Gérer les intégrations**.
- Votre compte Instagram est un compte professionnel (Business ou Creator), relié à une page Facebook.

## Installer l'intégration [#integratie-installeren]

1. Allez dans **Paramètres** (barre latérale, sous **Support**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-nav.png" alt="Navigation vers Paramètres" />

2. Choisissez **Intégrations** et ouvrez **Instagram** dans la liste (repère **2**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-instagram.png" alt="Paramètres > Intégrations : Instagram dans la liste" />

3. Cliquez sur **Installer** (repère **1**) et terminez le flux OAuth de Meta (droits de messagerie Instagram)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/instagram-install.png" alt="Détail d'Instagram : Installer" />

4. Choisissez la **page Facebook** reliée à votre compte professionnel Instagram
5. Vérifiez le champ **Nom d'utilisateur Instagram** sous le choix de la page (Tillor affiche le compte connecté, par exemple `@uwaccount`)
6. Enregistrez les paramètres

Sans compte professionnel Instagram relié à la page sélectionnée, Tillor ne peut pas terminer l'intégration.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Après l'installation, les messages Instagram Direct entrants arrivent d'eux-mêmes dans la [boîte de réception](/inbox).
- Les réponses envoyées via l'application Instagram apparaissent aussi dans la boîte de réception. Les messages que vous envoyez via Tillor ne sont pas affichés en double.
- Si aucun message n'arrive malgré tout, contactez le support Tillor. La connexion Instagram avec Meta doit être configurée pour toute la plateforme.
- Messenger et Instagram sont des intégrations distinctes. Si vous voulez les deux canaux dans la boîte de réception, installez-les tous les deux.

## Un problème ? [#problemen]

### La connexion échoue ou aucun Instagram sur la page [#koppelen-mislukt-of-geen-instagram-op-de-pagina]

Si l'installation s'arrête avec *L'application n'a pas pu être connectée* ou *Aucun compte professionnel Instagram*, vérifiez dans Meta :

1. **Instagram professionnel** : votre compte Instagram doit être Business ou Creator (pas un compte personnel).
2. **Relier la page** : dans [Meta Business Suite](https://business.facebook.com/) ou dans Business Settings, reliez le compte Instagram à la **page Facebook** avec laquelle vous vous connectez.
3. **Accès aux messages** : dans l'application Instagram, **Paramètres** > **Messages et réponses aux stories** > **Outils connectés** > autorisez l'accès aux messages (requis pour Direct dans les applications de boîte de réception).
4. **Bonne connexion Meta** : utilisez un compte **administrateur** de la page Facebook avec les droits de messagerie.


À l'installation, Tillor recherche toutes les pages Facebook de votre compte et choisit la première page avec un compte professionnel Instagram relié. Si vous avez plusieurs pages, vous pouvez en choisir une autre après l'installation dans les paramètres de l'intégration.

<Callout type="info" title="Pour le lecteur technique">
À l'installation, Tillor demande toujours les droits `instagram_basic`, `instagram_manage_messages` et `pages_read_engagement`. Mettez-les d'abord sur **Ready for testing** sous **Use cases** (Messenger/Instagram) dans la Meta Developer Console. **Invalid Scopes** signifie qu'ils ne figurent pas encore sur l'application Meta. Les droits `instagram_business_*` relèvent d'une autre méthode de connexion et ne sont pas destinés à Tillor.
</Callout>

## Voir aussi [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Lire et répondre aux conversations" />
  <Card
    title="Messenger"
    href="/inbox/messenger"
    description="Connecter Facebook Messenger à la boîte de réception"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Connecter un numéro WhatsApp à la boîte de réception"
  />
</Cards>


# Messenger (/fr-FR/inbox/messenger)

Avec **Messenger**, vous recevez dans la [boîte de réception Tillor](/inbox) les messages de clients arrivant via une page Facebook connectée.

Avant de commencer :

- Il vous faut l'autorisation **Gérer les intégrations**.
- Vous vous connectez à Meta avec un compte administrateur de la page Facebook.

## Installer l'intégration [#integratie-installeren]

1. Allez dans **Paramètres** (barre latérale, sous **Support**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-nav.png" alt="Navigation vers Paramètres" />

2. Choisissez **Intégrations** et ouvrez **Messenger** dans la liste (repère **2**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-messenger.png" alt="Paramètres > Intégrations : Messenger dans la liste" />

3. Cliquez sur **Installer** (repère **1**) et terminez le flux OAuth de Meta

<DocScreenshot src="/screenshots/communicatie/providers/messenger/messenger-install.png" alt="Détail de Messenger : Installer" />

4. Sur la page de détail, choisissez quelle **page Facebook** reçoit les messages Messenger
5. Enregistrez les paramètres

Tillor affiche la page connectée sous **Paramètres** sur la page de détail. Après l'installation, Tillor reçoit automatiquement les messages Messenger entrants. Les réponses que vous envoyez aussi via l'application Messenger apparaissent dans la boîte de réception. Les messages que vous envoyez via Tillor ne sont pas affichés en double.

Pour **Instagram Direct**, installez l'intégration distincte [Instagram](/inbox/instagram).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Tillor récupère les conversations existantes de la page. Vous pourrez aussi lancer cette synchronisation vous-même plus tard depuis la boîte de réception.
- Les nouveaux messages arrivent d'eux-mêmes dans la [boîte de réception](/inbox). Tillor les associe à un client portant le même nom, ou via un numéro de téléphone ou une adresse e-mail que le client partage dans la conversation.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Aucun message n'arrive">
Vérifiez sous <UIPath>Paramètres > Intégrations > Messenger</UIPath> que la bonne **page Facebook** est choisie et que les paramètres sont enregistrés.
</Accordion>
<Accordion title="Une conversation n'est pas associée à un client">
Meta ne transmet ni adresse e-mail ni numéro de téléphone via Messenger. Tillor n'associe que sur un nom correspondant ou sur des informations que le client partage lui-même.
</Accordion>
</Accordions>

## Voir aussi [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Lire et répondre aux conversations" />
  <Card
    title="Instagram"
    href="/inbox/instagram"
    description="Connecter Instagram Direct à la boîte de réception"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Connecter un numéro WhatsApp à la boîte de réception"
  />
</Cards>


# Conversations via le chat du site (/fr-FR/inbox/website-chat-gesprekken)

Une conversation apparaît dans la boîte de réception dès que le visiteur envoie son premier message, avec le canal **Chat site web**. La façon de réagir est décrite dans [Lire et répondre aux conversations](/inbox/gesprekken). Cette page explique ce qu'il y a de plus à voir avec le chat du site.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Boîte de réception : chat du site avec les détails de la conversation" />

Dans le panneau latéral de droite se trouve un bouton **Ouvrir sur le site** avec la page où le visiteur a été actif en dernier, ainsi que les informations sur le visiteur et sa session. Les champs supplémentaires du formulaire visiteur s'y trouvent aussi.

## Qui est le visiteur ? [#wie-is-de-bezoeker]

- Tillor reconnaît un visiteur à son navigateur. Le même navigateur sur le même appareil rouvre donc la même conversation.
- Le nom, l'e-mail et le téléphone du formulaire visiteur sont conservés dans ce navigateur après le premier message. Quand le visiteur revient plus tard, il n'a rien à ressaisir.
- Si ce stockage est vide, par exemple dans un autre navigateur ou après un nettoyage, le widget complète les informations à partir de la conversation existante.
- Les messages sont du texte jusqu'à 4096 caractères. Les images et les fichiers ne sont pas pris en charge.

## Saisie et présence [#typen-en-aanwezigheid]

| Quoi | Qui le voit | Où |
|-----|--------------|------|
| **Saisie en cours…** pendant que le visiteur écrit | Votre équipe | Sous la conversation dans la boîte de réception, même avant le premier message |
| **Saisie en cours…** pendant qu'un collègue écrit | Le visiteur | Dans le widget |
| **En ligne** (point vert) ou **Dernière vue** avec une heure | Votre équipe | Au-dessus de la conversation |

Le visiteur compte comme en ligne tant que l'onglet est visible. Le widget envoie un signal de vie environ toutes les 20 secondes. Récupérer des messages, saisir et lire comptent aussi comme activité.

## Coches [#vinkjes]

Les visiteurs voient des coches sur leurs propres messages :

| Coches | Signification |
|---------|-----------|
| Une | Envoyé |
| Deux grises | Votre équipe a ouvert la conversation et chargé les messages |
| Deux bleues | Votre équipe a marqué la conversation comme lue |

Dans la boîte de réception, vous voyez des coches sur vos propres réponses :

| Coches | Signification |
|---------|-----------|
| Une | Envoyé |
| Deux grises | Le visiteur est sur la page et a récupéré les messages, même avec le chat fermé |
| Deux bleues | Le visiteur a la fenêtre de chat ouverte |

Les réponses de la boîte de réception apparaissent automatiquement dans le widget, même si le visiteur ouvre la fenêtre plus tard.

## Activité du visiteur dans la conversation [#bezoekersactiviteit-in-het-gesprek]

Après le premier message, votre équipe voit un texte d'information grisé dans la conversation. Le visiteur ne le voit pas. Ces lignes n'augmentent aucun compteur de non-lus et ne déclenchent aucune notification push.

| Événement | Texte dans la boîte de réception |
|-------------|-------------------|
| Chat fermé | L'utilisateur a fermé le chat |
| Autre onglet ou fenêtre réduite | L'utilisateur a changé d'onglet ou a réduit le navigateur |
| Autre page ouverte | L'utilisateur a navigué vers l'URL de la page |

La navigation est aussi détectée sur les sites qui changent de page en interne sans recharger. Le widget transmet la page actuelle environ toutes les 20 secondes, de sorte que le panneau latéral affiche la dernière page active.

## Tillie sur le chat du site [#tillie-op-website-chat]

Tillie, l'assistant IA, fonctionne aussi dans le widget. Pour cela, installez **Assistant IA de la boîte de réception** séparément. L'installation, la base de connaissances et le comportement sont décrits dans [Assistant IA de la boîte de réception (Tillie)](/inbox/inbox-ai-assistant). Les messages de Tillie reçoivent dans le widget un petit robot à la place du logo de l'organisation.

<Callout type="info" title="Le premier message">
Dès que le visiteur saisit du texte, votre équipe peut voir **Saisie en cours…**. Le premier message ne part qu'avec **Envoyer**, avec les coordonnées renseignées.
</Callout>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Lire et répondre aux conversations" href="/inbox/gesprekken" description="Répondre, archiver, tags" />
  <Card title="Paramètres du chat du site" href="/inbox/website-chat-instellingen" description="Widget et formulaire visiteur" />
  <Card title="API du chat du site" href="/ontwikkelaars/website-chat" description="Créer votre propre interface de chat" />
</Cards>


# Paramètres du chat du site (/fr-FR/inbox/website-chat-instellingen)

Vous trouvez les paramètres sous <UIPath>Paramètres > Intégrations > Chat site web</UIPath>. L'installation et la mise en place de l'extrait de code sont décrites dans [Mettre le chat sur votre site](/inbox/website-chat).

## Widget [#widget]

| Champ | Que fait-il ? |
|------|---------------|
| **Widget activé** | Masque le chat partout sans supprimer l'intégration. Activé par défaut |
| **Afficher sur les pages publiques Tillor** | Affiche le bouton de chat sur les pages publiques Tillor comme le pass d'accès, la facture en attente et la carte publique. Votre propre site utilise l'extrait de code. Activé par défaut |
| **Message de bienvenue** | Texte dans l'en-tête du chat et avant le premier message du visiteur. Maximum 500 caractères. Laissé vide, il affiche un texte par défaut dans la langue du widget |
| **Infobulle du bouton** | Libellé du bouton flottant, destiné aux lecteurs d'écran. Maximum 80 caractères |
| **Message de réponse rapide** | Ligne sous le nom de l'organisation dans l'en-tête du chat, par exemple « Nous répondons généralement vite » |
| **Icône du bouton** | Icône sur le bouton de chat : **Bulle de discussion**, **Discussion arrondie**, **Point d'interrogation**, **Recherche** ou **Personne** |
| **Couleur d'accent** | Couleur du bouton de chat et des messages du visiteur. Choisissez une couleur ou saisissez une valeur hexadécimale, par exemple `#2563eb` |
| **Domaines autorisés** | Noms d'hôte séparés par des virgules qui peuvent charger le chat. Vide signifie : tout domaine |
| **Envoyer un e-mail aux visiteurs pour les réponses non lues** | Voir [ci-dessous](#herinnering-per-e-mail). Activé par défaut |

L'en-tête du chat affiche automatiquement le logo de votre organisation. Les messages de l'assistant IA reçoivent un petit robot à la place de ce logo. Ni l'un ni l'autre ne se règle sous Chat site web.

<Callout type="info" title="Quelle langue le visiteur reçoit-il ?">
Si vous ne renseignez ni **Message de bienvenue**, ni **Infobulle du bouton**, ni **Message de réponse rapide**, le widget utilise un texte par défaut dans sa propre langue. Vous définissez cette langue sur l'extrait de code avec `data-locale` (voir [Options sur l'extrait de code](#opties-op-het-snippet)).
</Callout>

## Formulaire visiteur [#bezoekersformulier]

Vous déterminez ici ce que le visiteur renseigne avant le premier message. S'il y a des champs obligatoires, ils figurent avec le champ de message sur un seul écran. Le visiteur remplit tout et clique sur **Envoyer**, sans étape intermédiaire.

### Champs standard [#standaardvelden]

| Champ | Que fait-il ? |
|------|---------------|
| **Nom obligatoire** | Les visiteurs saisissent leur nom. Le nom est conservé avec la conversation |
| **E-mail obligatoire** | Les visiteurs saisissent leur adresse e-mail. L'adresse est conservée avec la conversation |
| **Téléphone obligatoire** | Les visiteurs saisissent un numéro de téléphone. Tillor le convertit en un format fixe et l'utilise pour associer la conversation à des appels et à des clients |

Chaque champ est activé ou désactivé séparément. Si seul le téléphone est activé, le visiteur ne voit que le champ de téléphone.

### Champs supplémentaires [#extra-velden]

Cliquez sur **Ajouter un champ** pour vos propres questions. Vous pouvez ajouter au maximum 8 champs supplémentaires. Supprimez un champ avec **Supprimer le champ**.

| Option | Explication |
|-------|--------|
| **Libellé du champ** | Ce que le visiteur voit dans le widget. Maximum 80 caractères |
| **Clé du champ** | Nom interne du champ. Commencez par une lettre minuscule et n'utilisez que des minuscules, des chiffres et `_` (32 caractères maximum) |
| **Type de champ** | **Texte** ou **E-mail** |
| **Obligatoire** | Le visiteur doit remplir le champ avant de pouvoir discuter. Un nouveau champ est obligatoire par défaut |
| **Texte indicatif** | Indication dans le champ de saisie. Maximum 120 caractères |

Les réponses aux champs supplémentaires figurent dans la boîte de réception, sur la conversation, à côté du canal et de l'identifiant du visiteur.

## Rappel par e-mail [#herinnering-per-e-mail]

Les visiteurs ferment souvent la page avant que votre équipe ou Tillie réponde. Avec **Envoyer un e-mail aux visiteurs pour les réponses non lues**, le visiteur reçoit un e-mail avec le bouton **Poursuivre la conversation** dès qu'une réponse qu'il n'a pas lue est prête.

- Le visiteur doit avoir fourni une adresse e-mail, via le formulaire visiteur ou en préremplissage. Sans adresse, il ne se passe rien.
- L'e-mail ne part que lorsque le visiteur est inactif depuis environ 5 minutes. Il reçoit un seul e-mail par série de réponses non lues.
- Le bouton ouvre le chat et poursuit la conversation, même sur un autre appareil ou dans un autre navigateur. Le lien fonctionne 30 jours.
- Le visiteur peut aussi répondre directement à l'e-mail. Cette réponse apparaît dans la même conversation dans la boîte de réception, avec une petite icône d'enveloppe à côté du message.
- Les réponses de Tillie comptent, tout comme celles de votre équipe.

## Options sur l'extrait de code [#opties-op-het-snippet]

En plus de `data-org-id` et `data-widget-key`, vous pouvez ajouter des attributs facultatifs au script. Cela s'adresse à la personne qui place l'extrait de code sur le site.

| Attribut | Que fait-il ? |
|-----------|---------------|
| `data-locale` | Langue du widget : `en`, `nl`, `de`, `fr`, `pt` ou `ro`, éventuellement avec région comme `nl-BE`. Par défaut `en` ; une autre langue retombe sur l'anglais. La région détermine le format de la date et de l'heure |
| `data-accent-color` | Couleur d'accent pour cette page en hexadécimal à 6 chiffres. Prime sur la couleur définie sous **Paramètres** |
| `data-messages` | Objet JSON pour adapter certains textes, par exemple `{"send":"Envoyer","messagePlaceholder":"Saisissez votre message…"}` |
| `data-sounds` | `false` désactive les sons pour les nouvelles réponses de l'équipe et à l'envoi. Activé par défaut |
| `data-launcher` | `false` masque le bouton de chat flottant. Vous ouvrez alors le chat avec votre propre bouton via [le SDK du widget](/ontwikkelaars/website-chat#widget-sdk) |
| `data-visitor` | Objet JSON pour préremplir le nom, l'e-mail et le téléphone, par exemple `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` |
| `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Préremplit l'un de ces champs |
| `data-debug` | `true` affiche des lignes de journal dans la console du navigateur |

Les attributs ne complètent que les champs vides. Si le visiteur a déjà renseigné des informations dans ce navigateur, elles sont conservées.

Un exemple avec des textes en néerlandais :

```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>
```

Vous pouvez aussi activer le débogage sans modifier l'extrait de code : exécutez `localStorage.setItem('tillor-inbox-debug', '1')` dans la console du navigateur et actualisez la page.

## Protection contre le spam [#spambeveiliging]

Le widget n'utilise pas de captcha. Tillor protège l'envoi avec la clé du widget et avec **Domaines autorisés**. Si votre formulaire de contact a son propre captcha, il peut rester en place comme couche supplémentaire.

## Conditions pour les visiteurs [#voorwaarden-voor-bezoekers]

Sous le champ de message figure une courte mention indiquant qu'en envoyant, le visiteur accepte les [conditions du chat du site](https://tillor.eu/chat-terms). Le lien s'ouvre dans un nouvel onglet et suit la langue de `data-locale`.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Mettre le chat sur votre site" href="/inbox/website-chat" description="Installer et placer l'extrait de code" />
  <Card title="Conversations via le chat du site" href="/inbox/website-chat-gesprekken" description="Ce que vous et le visiteur voyez" />
  <Card title="API du chat du site" href="/ontwikkelaars/website-chat" description="SDK du widget et interface de chat personnalisée" />
</Cards>


# Mettre le chat sur votre site (/fr-FR/inbox/website-chat)

Avec l'intégration Chat site web, votre site obtient un bouton de chat. Les messages des visiteurs arrivent dans la [boîte de réception](/inbox), à côté de WhatsApp, Messenger et Instagram.

<Requires permission="Integraties beheren" />

<Steps>
<Step>
### Installez l'intégration [#installeer-de-integratie]
Allez dans <UIPath>Paramètres > Intégrations</UIPath> et ouvrez **Chat site web**. Cliquez sur **Installer**. Aucune connexion à un compte externe n'est nécessaire ; Tillor crée lui-même la clé du widget.
</Step>
<Step>
### Configurez le widget [#stel-de-widget-in]
Sous **Paramètres**, sur la même page, renseignez au moins le **Message de bienvenue** et la **Couleur d'accent**. Renseignez aussi **Domaines autorisés** pour que seul votre site puisse charger le chat. Toutes les options figurent dans [Paramètres du chat du site](/inbox/website-chat-instellingen).
</Step>
<Step>
### Copiez l'extrait de code [#kopieer-het-snippet]
Sous **Intégrer sur votre site**, cliquez sur **Copier l'extrait**. Si le bloc n'apparaît pas, enregistrez les paramètres et actualisez la page.
</Step>
<Step>
### Collez l'extrait de code sur votre site [#plak-het-snippet-op-je-site]
Collez l'extrait de code avant la balise `</body>` fermante sur chaque page où le bouton de chat doit apparaître. Pour un site avec un modèle ou un pied de page partagé, placez-le une seule fois dans ce modèle.
</Step>
</Steps>

## Que voyez-vous ensuite ? [#wat-zie-je-daarna]

Ouvrez votre site. Un bouton de chat se trouve en bas à droite. Envoyez-vous un message de test : la conversation apparaît dans la boîte de réception avec le canal **Chat site web**. Vous trouverez ce que vous et le visiteur voyez dans [Conversations via le chat du site](/inbox/website-chat-gesprekken).

<Callout type="info" title="La clé du widget est publique">
La clé est lisible dans l'extrait de code, comme pour d'autres produits de chat. Limitez les abus avec **Domaines autorisés** (noms d'hôte séparés par des virgules, par exemple `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Si vous laissez le champ vide, le chat fonctionne sur tout domaine où figure l'extrait de code.
</Callout>

## Chat sur les pages publiques Tillor [#chat-op-publieke-tillor-paginas]

Si **Chat site web** est installé, que **Widget activé** est activé et que **Afficher sur les pages publiques Tillor** est activé, le bouton de chat apparaît aussi sur les pages publiques de votre organisation. Vous n'avez pas besoin d'y placer d'extrait de code. Il s'agit entre autres des pages pour un pass d'accès, une facture en attente, un tag NFC, les informations de l'organisation et la carte publique.

- Sur ces pages, Tillor utilise la **Couleur d'accent** des paramètres.
- **Domaines autorisés** ne vaut que pour votre propre site web, pas pour les pages Tillor.
- Si vous désactivez **Widget activé**, le bouton disparaît partout. Si vous ne désactivez que **Afficher sur les pages publiques Tillor**, le chat continue de fonctionner sur votre propre site.

## Désactiver temporairement le chat [#de-chat-tijdelijk-uitzetten]

Désactivez **Widget activé** sous <UIPath>Paramètres > Intégrations > Chat site web</UIPath>. L'intégration reste installée et la clé de votre widget ne change pas. Réactivez l'interrupteur pour remettre le chat.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le bouton de chat n'apparaît pas sur mon site">
Vérifiez d'abord que **Widget activé** est activé. S'il y a une liste sous **Domaines autorisés**, regardez si le nom d'hôte de la page y figure, avec `www.` si votre site fonctionne ainsi. Vérifiez aussi que l'extrait de code se trouve réellement sur cette page et pas seulement dans un modèle que cette page n'utilise pas.
</Accordion>
<Accordion title="L'extrait d'intégration ne se charge pas dans les paramètres">
Tillor affiche alors le message indiquant que l'extrait n'a pas pu être chargé. Enregistrez les paramètres et actualisez la page.
</Accordion>
<Accordion title="Le chat est sur les pages Tillor, mais pas sur mon site">
Sur les pages Tillor, aucun extrait de code n'est nécessaire. Votre propre site n'affiche le chat qu'avec l'extrait de l'étape 3.
</Accordion>
<Accordion title="Je veux connecter mon propre formulaire de contact ou remplacer le bouton">
C'est le travail d'un développeur avec le SDK du widget. Voir [API du chat du site](/ontwikkelaars/website-chat).
</Accordion>
<Accordion title="Un visiteur voit Vous avez envoyé beaucoup de messages en peu de temps">
Tillor limite ce qu'un visiteur envoie via le chat, pour qu'un script ne puisse pas inonder ta boîte de réception et les réponses de Tillie : 10 messages par minute et 200 par jour par visiteur, et 30 par minute et 600 par jour pour tout le monde sur le même réseau (comme le wifi de ton camping). Pièces jointes : 10 par heure par visiteur et 50 par heure par réseau. Après une minute, le visiteur peut continuer ; aucun message déjà envoyé n'est perdu.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres du chat du site" href="/inbox/website-chat-instellingen" description="Tous les champs et options d'intégration" />
  <Card title="Conversations via le chat du site" href="/inbox/website-chat-gesprekken" description="Ce que vous et le visiteur voyez" />
  <Card title="API du chat du site" href="/ontwikkelaars/website-chat" description="Connecter votre propre formulaire ou interface de chat" />
  <Card title="Assistant IA de la boîte de réception" href="/inbox/inbox-ai-assistant" description="Laisser Tillie répondre" />
</Cards>


# WhatsApp Business (/fr-FR/inbox/whatsapp-business-inbox)

Avec **WhatsApp Business**, vous recevez et vous répondez aux messages de clients via WhatsApp dans la [boîte de réception Tillor](/inbox). Ce n'est **pas** la même chose que les notifications WhatsApp via Twilio.

<Callout type="info">
Pour les messages WhatsApp automatiques (notifications), voir [Twilio](/communicatie/providers/twilio). L'application de la marketplace **WhatsApp Business** ne sert qu'aux conversations de la boîte de réception.
</Callout>

Avant de commencer :

- Il vous faut l'autorisation **Gérer les intégrations**.
- Vous avez un compte WhatsApp Business chez Meta et vous vous connectez avec un compte qui le gère.

## Installer l'intégration [#integratie-installeren]

1. Allez dans **Paramètres > Intégrations**
2. Ouvrez **WhatsApp Business** dans la liste (repère **2**)

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/marketplace-whatsapp.png" alt="Paramètres > Intégrations : WhatsApp Business dans la liste" />

3. Cliquez sur **Installer** (repère **1**) et terminez le flux OAuth de Meta

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/whatsapp-install.png" alt="Détail de WhatsApp Business : Installer" />

4. Choisissez quel **Numéro WhatsApp** reçoit les messages de la boîte de réception
5. Enregistrez les paramètres

Après l'installation, Tillor reçoit automatiquement les messages entrants. Les réponses que vous envoyez aussi via l'application WhatsApp Business ou un appareil connecté apparaissent dans la boîte de réception. Les messages que vous envoyez via Tillor ne sont pas affichés en double.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les messages entrants apparaissent d'eux-mêmes dans la [boîte de réception](/inbox), associés au client ayant le même numéro de téléphone.
- Vous envoyez les réponses dans Tillor. En dehors de la fenêtre de 24 heures, elles partent sous forme de modèle payant, voir [Lire et répondre aux conversations](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Aucun message n'arrive">
Vérifiez sous <UIPath>Paramètres > Intégrations > WhatsApp Business</UIPath> que le bon **Numéro WhatsApp** est choisi et que les paramètres sont enregistrés.
</Accordion>
<Accordion title="Mes réponses ne partent pas en dehors de la fenêtre de réponse">
Ajoutez un moyen de paiement dans Meta WhatsApp Manager pour votre compte WhatsApp Business. Sans moyen de paiement, Tillor bloque les réponses payantes.
</Accordion>
</Accordions>

## Voir aussi [#gerelateerd]

<Cards>
  <Card title="Inbox" href="/inbox" description="Lire et répondre aux conversations" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook Messenger pour la boîte de réception" />
</Cards>


# Aperçu (/fr-FR/integraties)

Une intégration relie Tillor à un autre service, par exemple pour les paiements, la comptabilité, la téléphonie, les caméras ou votre fiche Google. Vous les gérez toutes dans <UIPath>Paramètres > Intégrations</UIPath>. La façon d'en installer une est décrite dans [Installer une intégration](/integraties/integratie-installeren).

<Requires permission="Integraties bekijken" />

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une intégration appartient à toute votre organisation, pas à un seul utilisateur. Une fois installée, la connexion fonctionne là où on en a besoin : la connexion caméra aux points d'accès, la connexion de messagerie sur la fiche client, la connexion de paiement sur les factures. Certaines connexions passent par le connecteur, un petit programme sur un ordinateur de votre propre réseau. Il doit alors être en ligne.

```mermaid
flowchart LR
  A[Paramètres > Intégrations] --> B[Installer l'intégration]
  B --> C[Paiements et factures]
  B --> D[Fiche client et boîte de réception]
  B --> E[Points d'accès et caméras]
  E -. via .-> F[Connecteur dans votre réseau]
```

<Callout type="info" title="Bon à savoir">
- Consulter est possible avec l'autorisation **Voir les intégrations**. Installer, modifier et désinstaller demandent **Gérer les intégrations**.
- Une désinstallation ne peut pas être annulée. Vous réinstallez ensuite l'intégration et renseignez de nouveau les informations.
- Partoo reçoit vos heures d'ouverture pour les 90 prochains jours et une mise à jour chaque nuit. Voir [Partoo](/integraties/partoo).
- Les paiements effectués il y a plus de 24 heures n'ont plus d'incrustation caméra. Voir [UniFi Protect](/integraties/unifi-protect).
- Les intégrations que vous voyez dépendent de votre organisation. Il en manque une ? Demandez à votre administrateur Tillor ou au support.
</Callout>

## Intégrations disponibles [#beschikbare-integraties]

| Intégration | À quoi elle sert | Explication |
|---|---|---|
| Mollie | Paiements en ligne et par terminal, prélèvement SEPA | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) |
| Comptes bancaires | Importer les transactions bancaires et les associer aux factures | [Ponto et comptes bancaires](/boekhouden/betalingsrapporten/betaalmethodes/ponto) |
| Admisol | Envoyer les rapports de paiement à votre comptabilité | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) |
| Odoo | Exporter les clients et les factures vers Odoo | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) |
| ICY | Relever les compteurs | [Gestion des compteurs](/meterbeheer) |
| Voys | Associer les appels téléphoniques aux clients | [Voys](/communicatie/providers/voys) |
| WhatsApp Business | Messages WhatsApp dans la boîte de réception | [WhatsApp Business](/inbox/whatsapp-business-inbox) |
| Messenger | Conversations Facebook Messenger dans la boîte de réception | [Messenger](/inbox/messenger) |
| Instagram | Conversations Instagram Direct dans la boîte de réception | [Instagram](/inbox/instagram) |
| Chat site web | Chat en direct sur votre site web | [Chat du site](/inbox/website-chat) |
| Inbox AI assistant | Répondre automatiquement aux questions fréquentes | [Inbox AI assistant](/inbox/inbox-ai-assistant) |
| UniFi Protect | Relier les caméras aux points d'accès et aux paiements | [UniFi Protect](/integraties/unifi-protect) |
| Partoo | Garder les heures d'ouverture identiques sur Google et les autres fiches | [Partoo](/integraties/partoo) |
| Outlook | Voir le courrier d'un client sur sa fiche client | [Outlook](/integraties/outlook) |

## Notions [#begrippen]

- **Intégration** : une connexion entre Tillor et un service externe.
- **Connecteur** : le programme dans votre réseau qui relie des appareils comme les caméras et les imprimantes à Tillor. Voir [Connecteur](/connector).
- **Installer et désinstaller** : activer ou supprimer une connexion. La suppression ne peut pas être annulée.
- **Clé API** : un code secret avec lequel Tillor peut travailler dans un autre service.
- **Incrustation** : texte qui défile sur les images de caméra, par exemple un paiement.

Vous trouverez plus d'explications dans le [glossaire](/begrippen).

<Cards>
  <Card title="Installer une intégration" href="/integraties/integratie-installeren" description="Rechercher, renseigner et connecter" />
  <Card title="UniFi Protect" href="/integraties/unifi-protect" description="Images de caméra lors des accès et des paiements" />
  <Card title="Partoo" href="/integraties/partoo" description="Transmettre automatiquement les heures d'ouverture" />
  <Card title="Outlook" href="/integraties/outlook" description="Courrier du client sur sa fiche client" />
</Cards>


# Installer une intégration (/fr-FR/integraties/integratie-installeren)

Vous installez une intégration dans <UIPath>Paramètres > Intégrations</UIPath>. Vous la recherchez, saisissez les informations du service externe et cliquez sur **Installer**. Ensuite, vous l'ajustez dans le bloc **Paramètres** ou vous la retirez avec **Désinstaller**. Ce qui est disponible figure dans l'[aperçu](/integraties).

<Requires permission="Gérer les intégrations" />

Avant de commencer :

- Avec le seul droit **Voir les intégrations**, vous voyez la liste et les paramètres, mais vous ne pouvez rien modifier.
- Ayez sous la main les identifiants ou les clés du service externe. Pour Outlook, vous êtes redirigé pour vous y connecter vous-même.
- Pour une connexion qui passe par le connecteur, comme UniFi Protect, le connecteur doit être en ligne.

## Installer une intégration [#een-integratie-installeren]

<Steps>
<Step>
### Trouvez l'intégration [#zoek-de-integratie]
Utilisez la barre de recherche, ou choisissez à gauche sous **Intégrations** une catégorie : **Communication**, **Surveillance**, **Paiements**, **Comptabilité** ou **Compteurs**. **Toutes les intégrations** affiche tout. Une intégration déjà connectée porte l'étiquette **Connecté**.

<DocScreenshot src="/screenshots/integraties/integrations-overview.png" alt="Paramètres > Intégrations avec la liste des intégrations" />
</Step>
<Step>
### Ouvrez l'intégration [#open-de-integratie]
Cliquez dessus. Certaines pages ont en haut le lien **Voir la documentation**.
</Step>
<Step>
### Saisissez les informations et cliquez sur Installer [#vul-de-gegevens-in-en-klik-op-installeren]
Ce que vous saisissez dépend du service. Pour Outlook, vous êtes redirigé vers le service lui-même pour vous connecter.
</Step>
</Steps>

## Modifier ou supprimer [#aanpassen-of-verwijderen]

Après l'installation, la même page affiche un bloc **Paramètres**. Ajustez-y la connexion et enregistrez. Avec **Désinstaller**, vous supprimez la connexion. Cette action est irréversible.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La connexion fonctionne immédiatement pour toute votre organisation.
- Ce que fait la connexion apparaît là où elle a sa place, par exemple sur le profil client ou sur un point d'accès.
- Après **Désinstaller**, la connexion s'arrête. Ce qui se trouve déjà dans l'autre service y reste.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je vois Aucune intégration trouvée">
Aucune intégration ne correspond à votre recherche ou à votre catégorie. Essayez un autre terme ou choisissez **Toutes les intégrations**. Si une intégration que vous attendez manque, elle n'est pas activée pour votre organisation. Demandez au support.
</Accordion>
<Accordion title="Le bouton Installer est grisé ou absent">
Vous n'avez pas le droit **Gérer les intégrations**. Demandez à votre administrateur.
</Accordion>
<Accordion title="Tillor affiche Échec de la connexion">
L'intégration n'a pas pu être connectée. Vérifiez les informations saisies et réessayez.
</Accordion>
<Accordion title="Tillor affiche Échec de la déconnexion">
Réessayez. Si cela ne fonctionne pas, écrivez à support@tillor.eu.
</Accordion>
<Accordion title="Tillor affiche Échec de la mise à jour des paramètres">
Votre modification n'a pas été enregistrée. Essayez de l'enregistrer à nouveau.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Aperçu des intégrations" href="/integraties" description="Toutes les connexions disponibles" />
  <Card title="Connecteur" href="/connector" description="Le programme dans votre réseau" />
</Cards>


# Connecter Outlook (/fr-FR/integraties/outlook)

Avec la connexion Outlook, vous voyez sur le profil client les e-mails échangés entre votre organisation et ce client. Tillor les récupère en direct dans Outlook et ne les conserve pas lui-même.

<Requires permission="Gérer les intégrations" />

Avant de commencer :

- Il vous faut un compte Microsoft dont Tillor peut lire les e-mails.
- Pour voir les e-mails sur le profil client, vous avez besoin du droit **Consulter la boîte de réception**. Sans ce droit, l'onglet **Outlook** est absent.

## Installer [#installeren]

<Steps>
<Step>
### Ouvrez l'intégration [#open-de-integratie]
Allez dans <UIPath>Paramètres > Intégrations > Outlook</UIPath>.
</Step>
<Step>
### Cliquez sur Installer [#klik-op-installeren]
Vous êtes redirigé vers Microsoft.
</Step>
<Step>
### Connectez-vous et donnez votre autorisation [#log-in-en-geef-toestemming]
Connectez-vous avec le compte dont Tillor peut lire les e-mails.

<DocScreenshot src="/screenshots/integraties/integrations-outlook.png" alt="Installer Outlook" />
</Step>
</Steps>

Après la connexion, vous voyez sous **Paramètres** le nom, l'adresse e-mail et le nom d'utilisateur du compte connecté, ainsi que la date jusqu'à laquelle la connexion est active.

## Choisir les boîtes aux lettres [#mailboxen-kiezen]

Par défaut, Tillor ne cherche que dans la boîte aux lettres du compte connecté. Sous **Boîtes aux lettres**, vous choisissez des boîtes supplémentaires, par exemple une boîte partagée de la réception.

- **Personnelle** est la boîte aux lettres du compte connecté.
- **Partagée** désigne les boîtes partagées que ce compte peut ouvrir. Tillor les recherche lui-même.
- **Ajoutée manuellement** désigne les adresses que vous saisissez vous-même. Saisissez l'adresse et choisissez **Ajouter [adresse]**.

## E-mails sur le profil client [#mail-op-het-klantprofiel]

Sur le profil client apparaît un onglet **Outlook**, entre **Communication** et **Événements**. L'onglet n'existe que si Outlook est connecté et que vous avez le droit **Consulter la boîte de réception**.

- En haut figurent le nombre de messages et les boîtes dans lesquelles la recherche a eu lieu. Avec **Actualiser**, vous récupérez les e-mails les plus récents.
- Tillor cherche selon l'adresse e-mail du client et de ses contacts. Si personne n'a d'adresse e-mail, un message indique qu'il n'y a rien à rechercher.
- Chaque message affiche l'objet, s'il est **Reçu** ou **Envoyé**, de qui à qui, et un trombone en cas de pièces jointes. Cliquez sur un message pour ouvrir le texte et les pièces jointes. Avec **Ouvrir dans Outlook**, vous accédez au message dans Outlook même.
- Un même e-mail présent dans plusieurs boîtes n'apparaît qu'une seule fois dans la liste.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Tillor lit seulement les e-mails et ne conserve rien. Si vous supprimez la connexion, l'onglet **Outlook** disparaît du profil client.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Informations de compte indisponibles">
Tillor n'a pas pu récupérer le compte Microsoft connecté. Actualisez la page ou reconnectez Outlook via **Installer**.
</Accordion>
<Accordion title="Reconnectez pour détecter les boîtes partagées">
Outlook a été connecté avant que Tillor puisse rechercher les boîtes partagées. Cliquez sur **Reconnecter Outlook**, ou saisissez vous-même l'adresse de la boîte partagée.
</Accordion>
<Accordion title="Impossible de charger les boîtes aux lettres partagées">
Vous pouvez toujours saisir une adresse de boîte manuellement sous **Ajoutée manuellement**.
</Accordion>
<Accordion title="E-mails Outlook indisponibles">
Tillor n'a pas pu charger les e-mails depuis Outlook. Réessayez avec **Actualiser** ou vérifiez la connexion.
</Accordion>
<Accordion title="Certaines boîtes aux lettres n'ont pas pu être consultées">
Le compte connecté n'a pas accès à cette boîte. Vérifiez les autorisations de la boîte dans Outlook.
</Accordion>
<Accordion title="Je ne vois pas d'onglet Outlook sur le profil client">
Outlook n'est pas connecté, ou il vous manque le droit **Consulter la boîte de réception**.
</Accordion>
<Accordion title="Ce message n'a pas pu être chargé.">
Essayez d'ouvrir à nouveau le message. Si cela n'aide pas, allez sur le message lui-même avec **Ouvrir dans Outlook**.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" description="Le profil client et ses onglets" />
  <Card title="Intégrations" href="/integraties" description="Toutes les connexions disponibles" />
</Cards>


# Connecter Partoo (/fr-FR/integraties/partoo)

Partoo gère vos fiches sur Google et d'autres sites. Avec cette connexion, Tillor envoie vos horaires d'ouverture à votre établissement Partoo, pour que vous n'ayez pas à les tenir à jour à deux endroits. Vous gérez les horaires eux-mêmes dans Tillor, voir [Paramètres de l'organisation](/gebruikers/organisaties#openingsuren).

<Requires permission="Gérer les intégrations" />

Avant de commencer :

- Créez dans Partoo un utilisateur distinct pour Tillor, sans connexion en deux étapes. Avec une connexion en deux étapes, Tillor ne peut pas se connecter.
- Renseignez vos horaires d'ouverture dans Tillor, voir la rubrique Horaires d'ouverture dans les paramètres de l'organisation.

## Installer [#installeren]

<Steps>
<Step>
### Ouvrez l'intégration [#open-de-integratie]
Allez dans <UIPath>Paramètres > Intégrations > Partoo</UIPath>.
</Step>
<Step>
### Saisissez les informations de l'utilisateur Partoo [#vul-de-gegevens-van-de-partoo-gebruiker-in]
Saisissez l'**E-mail** et le **Mot de passe** de cet utilisateur.
</Step>
<Step>
### Choisissez votre établissement [#kies-je-vestiging]
La liste des établissements n'apparaît qu'une fois l'e-mail et le mot de passe saisis. Choisissez votre établissement sous **Établissement**. Saisissez du texte pour chercher dans **Rechercher un établissement…**.
</Step>
<Step>
### Cliquez sur Installer [#klik-op-installeren]

<DocScreenshot src="/screenshots/integraties/integrations-partoo.png" alt="Installer Partoo" />
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Tillor envoie vos horaires de la semaine, vos saisons et vos jours exceptionnels à partir des [horaires d'ouverture de votre organisation](/gebruikers/organisaties#openingsuren) :

- Les horaires de la semaine sont ceux de la semaine en cours. Partoo ne connaît pas les saisons, donc Tillor envoie les horaires de la saison actuelle.
- Les jours des 90 prochains jours dont les horaires diffèrent, comme une autre saison, un jour férié ou une exception, sont envoyés comme des dates distinctes. Une période de fermeture devient une seule période.
- Tillor envoie ces informations chaque nuit et immédiatement après chaque modification des horaires d'ouverture, du fuseau horaire, du pays par défaut ou de la connexion elle-même. Seules les différences avec Partoo sont modifiées.

## Modifier ou supprimer [#aanpassen-of-verwijderen]

Modifiez l'e-mail, le mot de passe ou l'établissement dans le bloc **Paramètres**. Laissez le mot de passe vide pour conserver l'actuel. Avec **Désinstaller**, l'envoi s'arrête. Ce qui se trouve déjà dans Partoo y reste.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Partoo a refusé cet e-mail ou ce mot de passe">
Vérifiez les informations de l'utilisateur Partoo. Si la connexion en deux étapes est activée pour cet utilisateur, désactivez-la ou créez un utilisateur distinct.
</Accordion>
<Accordion title="Cet utilisateur Partoo ne voit aucun établissement">
Dans Partoo, donnez à l'utilisateur Partoo l'accès à votre établissement, puis regardez à nouveau.
</Accordion>
<Accordion title="Impossible de charger les établissements depuis Partoo">
Réessayez dans un instant. Si le problème persiste, écrivez à support@tillor.eu.
</Accordion>
<Accordion title="Les horaires sur Google ne sont pas corrects">
Vérifiez d'abord les horaires d'ouverture dans Tillor, le fuseau horaire et le pays par défaut. Après une modification, Tillor les envoie aussitôt, puis encore chaque nuit.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres de l'organisation" href="/gebruikers/organisaties" description="Horaires d'ouverture, saisons et exceptions" />
  <Card title="Intégrations" href="/integraties" description="Toutes les connexions disponibles" />
</Cards>


# Connecter UniFi Protect (/fr-FR/integraties/unifi-protect)

Avec la connexion UniFi Protect, depuis une tentative d'accès ou un événement de point d'accès, vous accédez en un clic à l'enregistrement de la caméra correspondante. Les paiements en espèces et par carte peuvent en outre s'afficher en texte sur les images d'une caméra, pour que vous puissiez revoir la scène en cas d'écart de caisse. L'installation est la même que pour toute intégration, voir [Installer une intégration](/integraties/integratie-installeren).

<Requires permission="Gérer les intégrations" />

Avant de commencer :

- Les caméras sont lues sur votre parc via le [connecteur](/connector). Celui-ci doit être en ligne. S'il ne l'est pas, Tillor indique **Le connecteur Tillor est hors ligne ou injoignable.**
- Il vous faut les informations de votre console UniFi OS. C'est le boîtier ou le serveur sur lequel tourne UniFi Protect.
- Pour la liaison avec les points d'accès, ceux-ci doivent exister, voir [Contrôle d'accès](/toegangscontrole).

## Installer [#installeren]

<Steps>
<Step>
### Ouvrez l'intégration [#open-de-integratie]
Allez dans <UIPath>Paramètres > Intégrations > UniFi Protect</UIPath>.
</Step>
<Step>
### Renseignez la console [#vul-de-console-in]
- **Hôte de la console** : l'adresse IP locale ou le nom d'hôte de votre console UniFi OS.
- **Clé API** : un code secret que vous créez dans la console et qui permet à Tillor de lire les caméras.
- **ID de console cloud** : le long identifiant après `/consoles/` dans l'URL unifi.ui.com de votre console.
</Step>
<Step>
### Choisissez les caméras de paiement [#kies-de-betaalcameras]
Choisissez une caméra sous **Caméra paiements espèces** et **Caméra paiements POS**, ou laissez **Ne pas enregistrer**. POS désigne le terminal de paiement par carte.
</Step>
<Step>
### Cliquez sur Installer [#klik-op-installeren]
Dès que l'hôte et la clé API sont renseignés, Tillor charge les caméras de la console.

<DocScreenshot src="/screenshots/integraties/integrations-unifi-protect.png" alt="Installer UniFi Protect" />
</Step>
</Steps>

## Lier des caméras aux points d'accès [#cameras-koppelen-aan-toegangspunten]

Après l'installation, le bloc **Paramètres** contient le tableau **Caméras par point d'accès**. Liez chaque **Point d'accès** à une **Caméra**. Si la liste est vide, ajoutez d'abord des points d'accès.

Ensuite, dans les détails d'une tentative d'accès et d'un événement de point d'accès, vous trouvez le lien **Ouvrir dans UniFi Protect**. Il ouvre l'enregistrement autour de ce moment dans UniFi Protect, dans un nouvel onglet.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Si vous avez choisi une caméra sous **Caméra paiements espèces** ou **Caméra paiements POS**, Tillor envoie à cette caméra chaque paiement qui passe à **Payé**. Les paiements en espèces vont à la caméra des espèces, les paiements par carte sur un terminal à la caméra POS.
- Les paiements réglés il y a plus de 24 heures ne reçoivent plus de texte sur les images.
- Les paiements via Mollie ne comptent que s'ils appartiennent au profil principal de Mollie.
- Si vous modifiez les informations, enregistrez. Si vous laissez la **Clé API** vide, la clé existante reste en vigueur. Avec **Désinstaller**, vous supprimez la connexion.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Aucune caméra trouvée sur cette console UniFi Protect">
La console n'a pas de caméras, ou la clé API n'y a pas accès. Vérifiez la clé et si les caméras sont visibles dans UniFi Protect.
</Accordion>
<Accordion title="Impossible de récupérer les caméras UniFi Protect">
Vérifiez l'hôte, la clé API et si le connecteur est en ligne. Tillor indique : **Vérifiez l'hôte, la clé API et le connecteur.**
</Accordion>
<Accordion title="Le connecteur Tillor est hors ligne ou injoignable">
Les caméras se chargent via le connecteur sur votre réseau local. Démarrez le connecteur ou rétablissez la connexion, voir [Connecteur](/connector).
</Accordion>
<Accordion title="Je ne vois pas Ouvrir dans UniFi Protect sur une tentative d'accès">
Aucune caméra n'est liée à ce point d'accès. Liez-en une dans le tableau **Caméras par point d'accès**.
</Accordion>
<Accordion title="Le paiement n'apparaît pas sur les images">
Vérifiez que la caméra sous **Caméra paiements espèces** ou **Caméra paiements POS** n'est pas sur **Ne pas enregistrer**. Un paiement réglé il y a plus de 24 heures ne reçoit plus d'incrustation. Un paiement Mollie ne compte que pour le profil principal.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Contrôle d'accès" href="/toegangscontrole" description="Journal d'accès et points d'accès" />
  <Card title="Connecteur" href="/connector" description="La liaison avec votre réseau local" />
  <Card title="Intégrations" href="/integraties" description="Toutes les connexions disponibles" />
</Cards>


# Carte (/fr-FR/kaart)

Sur la carte, vous voyez d'un coup d'œil quels terrains sont libres, réservés ou occupés, pour chaque jour que vous choisissez. Vous y tracez aussi les limites de vos terrains, pour que Tillor connaisse leur superficie, et vous mesurez des distances. Vous gérez vos terrains eux-mêmes sous [Terrains](/terreinen).

<Callout type="info" title="Bon à savoir">
- La carte s'ouvre toujours sur aujourd'hui. Votre style, vos étiquettes et vos calques sont en revanche conservés.
- Les réservations terminées (départ enregistré) et annulées ne comptent pas pour la couleur, l'étiquette de départ ou la double réservation.
- Les étiquettes avec les nuits et le départ disparaissent sous le niveau de zoom 17,5. Le nom du terrain reste affiché.
- Un terrain sans limite tracée n'apparaît pas sur la carte. Le tracé n'est possible que lorsque le **Mode édition** est activé.
- La carte s'ouvre sur le centre de la carte que vous définissez sous **Paramètres > Carte**. Ce même point détermine aussi la météo.
</Callout>

## Ouvrir la carte [#de-kaart-openen]

Allez dans <UIPath>Parc > Carte</UIPath>. Vous voyez aussitôt tous les terrains avec leur statut d'occupation.


<DocScreenshot src="/screenshots/park/map-overview.png" alt="Carte avec le terrain 12 tracé" />

- **Zone verte** - terrain réservable libre
- **Zone grise** - le terrain est **non réservable** et n'a pas de séjour actif à la date choisie (ni réservation ni occupation) ; les étiquettes de nuits et de départ sont absentes
- **Zone cyan** - réservation **réservée**, pas encore arrivée (aussi les jours suivants de la période de séjour tant que l'arrivée n'est pas enregistrée)
- **Zone bleue** - réservation **arrivée** (séjour actif à la date choisie)
- **Zone jaune** - le terrain a une occupation active (location longue durée ; valable à chaque date choisie tant que l'occupation est en cours)
- **Zone rouge** (voile léger, bordure rouge) - double réservation : périodes de réservation qui se chevauchent sur le même terrain

Cliquez sur un terrain sur la carte pour ouvrir une fenêtre avec le nom, les réservations, l'éventuelle occupation active (client) et des raccourcis.

## Choisir la date [#datum-kiezen]

À droite de **Paramètres de la carte**, vous choisissez une **date** (aujourd'hui par défaut). La carte montre alors l'état des terrains ce jour-là. Après un rafraîchissement de la page, la date revient sur **aujourd'hui** ; seuls les autres paramètres de la carte (style, étiquettes, calques) sont conservés. Les réservations **terminées** et **annulées** ne comptent pas pour la couleur, l'étiquette de départ ou la double réservation (elles n'apparaissent pas non plus dans la fenêtre sur la carte). Pour les emplacements libres, une étiquette avec une icône de lune et le nombre de nuits jusqu'à la prochaine arrivée figure sous le nom du terrain. Pour une réservation ou une occupation avec date de départ, une étiquette avec une icône de départ indique le nombre de nuits jusqu'au départ (0 = aujourd'hui). Passez la souris sur une étiquette pour voir le texte complet. En cas de **double réservation** (deux réservations ou plus avec des périodes de séjour qui se chevauchent sur le même terrain), le terrain reçoit une bordure rouge et un voile rouge léger ; une icône de triangle rouge précède le numéro du terrain. Dans la fenêtre, vous voyez un avertissement avec les réservations concernées. Sous le niveau de zoom **17,5**, la carte masque automatiquement les étiquettes de nuits et de départ ; le nom du terrain reste visible. Zoomez jusqu'à au moins **17,5** (ou désactivez **Nuits et départ** dans les paramètres de la carte) pour voir ces étiquettes. Lorsque vous dézoomez, les noms des terrains sont affichés plus petits pour se chevaucher moins.

## Calques et couleurs [#lagen-en-kleuren]

En bas à gauche se trouvent trois boutons : **Calques**, **Exporter en PDF** et **Paramètres de la carte**, avec le sélecteur de date à leur droite. Avec **Calques**, vous déterminez ce que vous voyez et comment les terrains sont colorés.

<DocScreenshot src="/screenshots/instellingen/map-layers.png" alt="Carte avec le panneau Calques" />

- Sous **Couleurs**, vous choisissez **Occupation** ou **Type de terrain**. Avec **Occupation**, les terrains se colorent comme décrit ci-dessus. Avec **Type de terrain**, chaque terrain reçoit la **Couleur de carte** de son type, voir [Types de terrain](/terreinen#terreintypes).
- Avec **Occupation**, sous **Calques de terrains** figure une case par catégorie : **Libre**, **Réservé**, **Arrivé**, **Occupé**, **Non réservable** et **Double réservation**. Décochez pour masquer ces terrains.
- Sous **Types de terrain**, vous choisissez quels types apparaissent sur la carte. **Aucun type** correspond aux terrains sans type.

Avec **Exporter en PDF**, vous téléchargez un PDF des terrains actuellement sur la carte : nom, superficie, gaz et tarif calculé, à la date choisie.

## Paramètres de la carte [#kaartinstellingen]

Avec **Paramètres de la carte**, vous ajustez l'affichage.

<DocScreenshot src="/screenshots/instellingen/map-settings.png" alt="Carte avec le panneau Paramètres de la carte" />

| Paramètre | Description |
|------------|--------------|
| **Style** | **Satellite**, **Hybride** ou **Rues** |
| **Mode édition** | Affiche les outils pour tracer et modifier les limites des terrains |
| **Noms des terrains** | Affiche les noms des terrains sur la carte. Ne fonctionne que si au moins un calque est activé |
| **Nuits et départ** | Affiche, à côté des noms de terrains, combien de nuits sont libres et quand un séjour se termine. Ne fonctionne que si **Noms des terrains** est activé |

Vos paramètres sont enregistrés automatiquement.

## Définir la carte par défaut [#kaartstandaard-instellen]

<Requires permission="Modifier les paramètres" />

Sous <UIPath>Support > Paramètres > Carte</UIPath>, vous déterminez où la carte s'ouvre et son orientation.

<DocScreenshot src="/screenshots/instellingen/settings-map.png" alt="Paramètres > Carte" />

| Paramètre | Description |
|---|---|
| **Centre de la carte** | Cliquez sur la carte ou faites glisser l'épingle vers le centre de votre parc. Les coordonnées figurent en dessous. |
| **Orientation de la carte** | La direction de la boussole en degrés (0-360) avec laquelle la carte s'ouvre. |

Le centre de la carte compte aussi en dehors de la carte. C'est le lieu pour lequel la météo est récupérée sous <UIPath>Parc > Météo</UIPath>, et les suggestions d'adresses lors de la saisie d'une adresse donnent la priorité aux lieux proches. Si vous n'avez pas défini d'**Emplacement du point d'accès** pour **Apple Wallet**, Apple Wallet et Google Wallet utilisent le centre de la carte pour le pass d'accès. Voir [Organisation](/gebruikers/organisaties#apple-wallet). Si le centre est au mauvais endroit, la météo n'est donc pas correcte non plus.

## Tracer les limites des terrains [#terreingrenzen-intekenen]

Avec le mode édition, vous enregistrez la limite exacte d'un terrain sur la carte. Tillor en calcule la superficie en m², que la formule tarifaire utilise.

1. Allez dans **Parc > Carte**
2. Cliquez sur **Paramètres de la carte** en bas à gauche
3. Activez le **Mode édition**
4. Cliquez sur les points voulus sur la carte pour tracer un polygone
5. Fermez le polygone en cliquant sur le point de départ
6. Dans la boîte de dialogue, sélectionnez le terrain à associer

<DocScreenshot src="/screenshots/park/map-terrain-select-dialog.png" alt="Boîte de dialogue d'association du terrain après le tracé du polygone" />

7. Cliquez sur **« Mettre à jour »**

Le terrain apparaît maintenant comme une zone colorée sur la carte.

<Callout type="info">
Les terrains sans emplacement tracé figurent en haut de la liste de choix, pour que vous puissiez les trouver et les associer facilement.
</Callout>

## Mesurer des distances [#afstanden-meten]

Avec la fonction de mesure, vous mesurez rapidement des distances et des surfaces sur la carte, ce qui est pratique pour aménager le terrain ou estimer des distances entre des lieux.

1. En haut à gauche de la carte, cliquez sur **Mesurer la distance** ou **Mesurer la surface**
2. Placez des points sur la carte (fermez une surface en cliquant sur le point de départ)
3. La mesure s'affiche sur la carte ; utilisez **Effacer les mesures** pour recommencer

## Ouvrir un terrain depuis la carte [#een-terrein-openen-vanaf-de-kaart]

Via la carte, vous pouvez naviguer rapidement vers un terrain :

1. Cliquez sur un terrain sur la carte
2. La fenêtre affiche le nom, le statut d'occupation, les réservations actives et, en cas d'occupation, le client
3. Cliquez sur **« Voir les détails »** pour aller à la page de détail
4. Tant qu'il n'y a pas d'occupation active, vous pouvez lancer **« Créer une réservation »**

## Que se passe-t-il après le tracé ? [#wat-gebeurt-er-na-het-intekenen]

- Le terrain reçoit une couleur sur la carte et Tillor renseigne la **Superficie** sur la page du terrain.
- Le **Tarif calculé** est recalculé, car la superficie entre en compte. Voir [Terrains](/terreinen#hoe-het-tarief-tot-stand-komt).
- La **Superficie totale** en haut de la liste des terrains inclut désormais le terrain.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Mon terrain n'apparaît pas sur la carte">
Le terrain n'a pas encore de limite tracée. Activez le **Mode édition**, tracez le terrain et choisissez-le dans la boîte de dialogue. Les terrains sans emplacement figurent en haut de la liste de choix. Si le terrain est bien là, vérifiez sous **Calques** que le calque de son statut est activé.
</Accordion>
<Accordion title="Les étiquettes de nuits et de départ sont absentes">
Zoomez jusqu'au niveau 17,5 au moins et vérifiez dans **Paramètres de la carte** que **Noms des terrains** et **Nuits et départ** sont tous deux activés. Les terrains gris, non réservables et sans séjour n'ont jamais une telle étiquette.
</Accordion>
<Accordion title="La carte s'ouvre au mauvais endroit ou affiche la mauvaise météo">
Le centre de la carte est mal placé. Déplacez l'épingle sous <UIPath>Support > Paramètres > Carte</UIPath>.
</Accordion>
<Accordion title="Je ne vois pas Créer une réservation dans la fenêtre">
Ce choix n'existe que si le terrain n'a pas d'occupation active.
</Accordion>
<Accordion title="La carte affiche la date d'aujourd'hui, même après mon choix">
La date choisie n'est pas conservée. Après un rafraîchissement, la carte revient sur aujourd'hui.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Terrains" href="/terreinen" description="Créer des terrains, tarif et compteurs" />
  <Card title="Réservations" href="/reserveringen" description="Planifier et gérer les séjours" />
  <Card title="Parc" href="/park" description="Aperçu de la gestion du parc" />
</Cards>


# Gestion des clients (/fr-FR/klantenbeheer)

Un client est l'endroit dans Tillor où tout ce qui concerne une personne ou une entreprise se rassemble : données, contacts, factures, occupations, réservations, documents et accès. Vous créez un client, vous le retrouvez dans la liste et vous mettez à jour ses données sur le profil client. Commencez par [Ajouter un nouveau client](#een-nieuwe-klant-toevoegen).

<Callout type="info" title="Bon à savoir">
- Lors de la création, seul le **Prénom** est obligatoire. Vous complétez toutes les autres données plus tard sur le profil client.
- Tillor vous avertit d'un **client en double possible** si le prénom et le nom ensemble, l'adresse e-mail ou le numéro de téléphone figurent déjà chez un autre client. Une adresse e-mail ou un numéro de téléphone compte à partir de 4 caractères.
- Des suggestions d'adresse apparaissent à partir de 3 caractères saisis dans le champ **Rue**.
- Les scans de pièces d'identité sans client lié sont supprimés par Tillor après 7 jours.
- Supprimer un client supprime aussi toutes les données associées et est irréversible.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Tout ce que vous enregistrez dans Tillor est rattaché à un client. Une occupation relie le client à un terrain, et donc aussi aux compteurs de ce terrain. La consommation de ces compteurs figure sur la facture du client.

```mermaid
flowchart LR
  K[Client] --> C[Contacts]
  K --> R[Réservations]
  K --> B[Occupations]
  B --> T[Terrain]
  T --> M[Compteurs]
  M --> V[Consommation]
  V --> F[Factures]
  K --> F
  F --> P[Paiements]
  K --> D[Documents et demandes de signature]
  K --> O[Remarques et tâches]
```

## Ajouter un nouveau client [#een-nieuwe-klant-toevoegen]

Avant de commencer :

- Un scan d'identité si vous voulez créer le client avec celui-ci. S'il n'y a pas de scan dans la file d'attente, choisissez simplement la saisie manuelle.
- Vous ne savez pas si le client existe déjà ? Cherchez-le d'abord dans la liste, voir [Rechercher et filtrer des clients](#klanten-zoeken-en-filteren).

<Steps>
<Step>
### Ouvrez la liste des clients [#open-de-klantenlijst]
Allez dans <UIPath>Clients > Aperçu</UIPath> et cliquez en haut à droite sur **Créer un nouveau client**. Tant qu'il y a des scans d'identité en attente, le bouton affiche un menu avec **Manuel** et les scans de la file d'attente.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Créer un nouveau client avec le menu pour un scan d'identité en attente" />
</Step>
<Step>
### Choisissez comment créer le client [#kies-hoe-je-de-klant-aanmaakt]
<Tabs items={["Met de hand", "Vanuit een identiteitsscan"]}>
<Tab value="Met de hand">
Choisissez **Manuel**. Un formulaire s'ouvre avec **Prénom**, **Nom**, **Adresse e-mail** et **Numéro de téléphone**. Renseignez ce que vous savez et cliquez sur **Créer le client**. Si un client aux données similaires existe peut-être déjà, un message jaune avec un lien vers ce client apparaît en bas.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Boîte de dialogue Créer un nouveau client (Manuel)" />
</Tab>
<Tab value="Vanuit een identiteitsscan">
Choisissez un scan dans le menu, par exemple **Lotte Peeters**. Dans la confirmation, vous voyez un aperçu du document (recto, verso, portrait) et les données de la zone de lecture. Cliquez sur **Créer le client**. Tillor crée le client, lie le scan et renseigne les données du document.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Confirmation après le choix d'un scan d'identité en attente" />

Les scans en attente figurent aussi dans le panneau en bas à droite, avec **Créer un client à partir de la numérisation**. Vous en saurez plus sur les scans sous [Scans d'identité](/identiteitsscans).

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Panneau en bas à droite avec un scan d'identité en attente" />
</Tab>
</Tabs>
</Step>
<Step>
### Vérifiez s'il s'agit d'un client en double [#controleer-op-een-dubbele-klant]
Si un client avec le même nom, la même adresse e-mail ou le même numéro de téléphone existe peut-être déjà, Tillor affiche **Client en double possible** avec le nom et le numéro de client. Cliquez sur **Utiliser ce client** pour ouvrir ce client, ou sur **Créer quand même** si c'est bien une autre personne.
</Step>
</Steps>

<Callout type="warn" title="Durée de conservation et responsabilité">
Tillor supprime **automatiquement après 7 jours** les scans sans client lié. Traitez-les à temps.

Pour les scans **liés**, c'est **votre organisation** qui détermine la durée de conservation et la base juridique. Tillor les conserve jusqu'à ce que vous les dissociiez ou les supprimiez. Le respect de la législation sur la vie privée et de durées de conservation appropriées relève de **votre responsabilité** en tant que responsable du traitement.
</Callout>

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Vous arrivez sur le nouveau profil client, où vous renseignez le reste : adresse, numéro de TVA, contacts et champs personnalisés.
- Si le client a été créé à partir d'un scan, ce scan appartient au client et ne figure plus dans la file d'attente.
- La création apparaît comme première ligne de l'onglet **Événements** du client.
- Si vous voulez qu'une action se déclenche immédiatement pour un nouveau client, par exemple un e-mail de bienvenue, utilisez une [automatisation](/automatiseringen).

## Vérifier un numéro de TVA [#een-btw-nummer-controleren]

Dans l'onglet **Aperçu**, dans le bloc **Détails du client**, vous saisissez le **Numéro de TVA**. Tillor vérifie le numéro auprès du registre européen VIES dès que le **Pays** est aussi renseigné et que le numéro est assez long.

- Si le numéro est valide, vous voyez une coche verte et une fenêtre avec le nom officiel de l'entreprise et l'adresse de VIES. Cliquez sur **Appliquer l'adresse de l'entreprise** pour reprendre cette adresse dans le formulaire.
- Si le numéro est invalide, vous voyez une icône rouge et un message d'erreur.

## Le profil client [#het-klantprofiel]

Lorsque vous cliquez sur un client, vous voyez le profil client. En haut figurent les données récapitulatives du client, avec en dessous les remarques épinglées. Les onglets vous mènent au reste.

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Profil client - bloc Détails du client" />

| Onglet | Ce que vous y trouvez |
|---|---|
| **Aperçu** | Détails du client (formulaire modifiable), communication récente, factures, index des compteurs, remarques, occupations et notifications |
| **Facturation** | Toutes les factures de ce client, et le [solde par compte](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) |
| **Contrôle d'accès** | Droits d'accès et plaques d'immatriculation |
| **Contacts** | Contacts supplémentaires |
| **Badges NFC** | Badges NFC liés |
| **Réservations** | Toutes les réservations |
| **Communication** | Messages et historique de communication |
| **Outlook** | E-mails du client et vers le client depuis vos boîtes aux lettres Outlook. Cet onglet n'apparaît que si [Outlook](/integraties/outlook) est connecté et que vous avez le droit de **Consulter la boîte de réception** |
| **Événements** | Chronologie des modifications, y compris la création d'un client ou d'un contact, l'attribution ou la dissociation d'une pièce d'identité, et l'avant/après pour les mises à jour du client, du contact, des paramètres de facturation et des méthodes d'accès |
| **Documents** | Fichiers et pièces jointes enregistrés, et les [demandes de signature](/handtekeningen) |
| **Tâches** | Tâches liées à ce client |

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Profil client - onglet Contrôle d'accès avec les méthodes d'accès" />

### En un coup d'œil [#in-één-oogopslag]

Dans l'onglet **Aperçu**, la carte **En un coup d'œil** se trouve en haut à gauche. Elle n'affiche que ce qui demande de l'attention à ce moment et se replie lorsqu'il n'y a rien à montrer :

- **Réservations actives** et **Réservations à venir**, avec un bouton **Voir la réservation**
- **Compteurs actifs avec alarmes**
- **Tâches ouvertes** de ce client
- **Scans d'identité** de ce client

<DocScreenshot src="/screenshots/klanten/customer-key-info.png" alt="Profil client - carte En un coup d'œil" />

Vous voyez les mêmes données dans la carte d'un appel entrant. Une remarque que vous épinglez figure directement sous les détails du client en haut du profil. Voir [Remarques](/notities#opmerking-vastzetten).

### Anniversaires [#verjaardagen]

Si le client ou son ou sa partenaire fête son anniversaire aujourd'hui, un bloc vert **Anniversaire aujourd'hui** apparaît en haut du profil client, avec le nom et l'âge, et des confettis tombent sur la page. Pour le client, la date provient du champ **Date de naissance**. Le ou la partenaire est le contact ayant la relation **Partenaire**. Une date de naissance du 29 février compte le 28 février les années non bissextiles.

## Modifier les détails du client [#klantgegevens-bewerken]

Dans l'onglet **Aperçu**, dans le bloc **Détails du client**, vous modifiez les champs. En bas du formulaire figurent **Annuler** et **Enregistrer**. Chaque modification apparaît dans l'onglet **Événements**, avec un aperçu **Avant / après** par champ, pour que vous puissiez voir précisément ce qui a été modifié.

Si votre organisation a créé des [champs personnalisés](/eigen-velden) pour les clients, ils apparaissent comme champs supplémentaires dans le même bloc.

### Renseigner l'adresse [#adres-invullen]

L'adresse se compose de **Rue**, **N°** et **Boîte**, suivis de **Code postal**, **Ville** et **Pays**.

<DocScreenshot src="/screenshots/klanten/customer-address-input.png" alt="Champ d'adresse avec rue, numéro et boîte" />

- Si vous saisissez au moins trois caractères de la rue, Tillor propose des adresses. Choisissez-en une : la rue, le numéro, le code postal, la ville et le pays sont alors renseignés. Les suggestions proviennent d'OpenStreetMap, une base de données cartographique gratuite.
- Si vous saisissez **Kerkstraat 5** dans le champ **Rue**, le chiffre passe dans **N°**. Une espace après le numéro vous amène à **Boîte**. Si vous collez une adresse complète, elle est également répartie. Dans les pays où le numéro précède la rue, le numéro n'est pas déplacé automatiquement.
- Si le code postal ou la ville sont déjà renseignés, Tillor vérifie l'adresse. Une coche verte avec **Adresse trouvée** signifie que l'adresse existe. Une icône jaune avec **Orthographe suggérée** montre l'orthographe usuelle. Cliquez sur **Mettre à jour l'adresse** pour la reprendre.
- L'adresse est conservée sur une seule ligne, par exemple sur les factures et dans les exports.

Les suggestions sont une aide, pas une obligation. Vous pouvez toujours saisir vous-même une adresse.

## Rechercher et filtrer des clients [#klanten-zoeken-en-filteren]

Allez dans <UIPath>Clients > Aperçu</UIPath>. En haut figure une barre de recherche.

<DocScreenshot src="/screenshots/klanten/customers-list.png" alt="Liste des clients avec barre de recherche" />

- Saisissez un nom, une adresse e-mail, un numéro de téléphone ou un numéro de client.
- Les résultats sont mis à jour pendant que vous tapez, avec un court délai.
- Vous pouvez aussi filtrer par **Création** (plage de dates), **Statut** et **Type**.

## Supprimer un client [#een-klant-verwijderen]

Utilisez **Supprimer le client** dans le menu en haut du profil client. Tillor demande **Êtes-vous sûr de vouloir supprimer ce client ?** Si vous confirmez, toutes les données associées disparaissent aussi. Cette action est irréversible.

## Scénarios courants [#veelvoorkomende-scenarios]

### Un nouveau client réserve pour la première fois [#een-nieuwe-klant-boekt-voor-het-eerst]

1. Le client téléphone ou réserve en ligne.
2. Vous ajoutez le client avec **Créer un nouveau client**.
3. Vous renseignez l'adresse et les autres données sur le profil client (onglet **Aperçu** > **Détails du client**).
4. Vous créez une occupation sur le terrain souhaité, voir [Occupations](/bezettingen#een-bezetting-aanmaken).
5. Tillor suit automatiquement la consommation des compteurs liés. Vous la voyez sous **Index des compteurs** dans **Aperçu**.

### Modifier les données d'un client [#klantgegevens-wijzigen]

Ouvrez le profil client, modifiez l'adresse dans le formulaire et cliquez sur **Enregistrer**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor affiche : Client non créé">
Le message est **Le client n'a pas pu être créé.** Vérifiez que le **Prénom** est renseigné et que l'adresse e-mail est valide, avec un arobase et un domaine. Réessayez ensuite.
</Accordion>
<Accordion title="Tillor affiche : Client en double possible">
Un client avec les mêmes prénom et nom, la même adresse e-mail ou le même numéro de téléphone existe déjà. Cliquez sur **Utiliser ce client** s'il s'agit de la même personne, ou sur **Créer quand même** s'il s'agit d'une autre personne.
</Accordion>
<Accordion title="Tillor affiche : Une erreur s'est produite. Le client n'a pas pu être mis à jour">
Vos modifications n'ont pas été enregistrées. Vérifiez dans le formulaire qu'il n'y a pas d'adresse e-mail invalide ou de champ obligatoire vide, et cliquez à nouveau sur **Enregistrer**.
</Accordion>
<Accordion title="Le scan ne figure pas dans le menu de Créer un nouveau client">
Seuls les scans sans client lié comptent comme en attente. Si le scan est déjà lié à un client, ou a plus de 7 jours, il n'y figure plus. Voir [Scans d'identité](/identiteitsscans).
</Accordion>
<Accordion title="Créer un client à partir de la numérisation est grisé">
La raison figure sur le scan. Le plus souvent, le scan n'a pas de prénom : *renseignez-le sur le scanner ou liez ce scan manuellement*. Ou bien un client avec le même numéro de registre national existe déjà. Ouvrez alors ce client et liez-lui le scan.
</Accordion>
<Accordion title="Tillor affiche : Numéro de TVA invalide">
Le numéro n'est pas valide ou n'est pas enregistré dans VIES. Vérifiez que le **Pays** est correct et que le numéro est complet. Tillor indique aussi **Le numéro de TVA doit comporter au moins ... caractères** si le numéro est trop court pour le pays choisi, et demande à la fois un numéro et un pays si l'un des deux manque.
</Accordion>
<Accordion title="Je ne vois pas l'onglet Outlook">
L'onglet n'apparaît que si [Outlook](/integraties/outlook) est connecté et que vous avez le droit **Consulter la boîte de réception**.
</Accordion>
<Accordion title="Aucune suggestion d'adresse n'apparaît">
Saisissez au moins trois caractères dans le champ **Rue**. Si les suggestions ne viennent toujours pas, renseignez simplement l'adresse vous-même.
</Accordion>
</Accordions>

## Notions [#begrippen]

- **Client** : l'enregistrement dans Tillor d'une personne ou d'une entreprise. Voir [client](/begrippen#klant).
- **Contact** : une personne supplémentaire chez un client, par exemple un ou une partenaire ou un contact d'urgence.
- **Occupation** : un client sur un terrain pour une période. Voir [occupation](/begrippen#bezetting).
- **Réservation** : une réservation pour un séjour. Voir [réservation](/begrippen#reservering).
- **Événements** : la chronologie de toutes les modifications chez un client. Voir [événement](/begrippen#gebeurtenis).
- **VIES** : le registre européen dans lequel Tillor vérifie un numéro de TVA.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Scans d'identité" href="/identiteitsscans" description="Créer un client à partir d'un scan, durée de conservation et connecteur" />
  <Card title="Occupations" href="/bezettingen" />
  <Card title="Réservations" href="/reserveringen" />
  <Card title="Factures" href="/facturen" />
  <Card title="Terrains" href="/terreinen" />
  <Card title="Accueillir un client saisonnier" href="/praktijk/seizoensklant-binnenhalen" />
</Cards>


# Alarmes et état des compteurs (/fr-FR/meterbeheer/alarmen-en-status)

Un compteur déclenche une alarme lorsqu'il signale une anomalie, comme un problème de connexion ou une panne technique. Vous lisez ici où la voir, ce que signifie l'indicateur d'état et comment effacer une alarme.

## Traiter une alarme [#een-alarm-opvolgen]

<Steps>
<Step>
### Trouvez le compteur en alarme [#zoek-de-meter-met-een-alarm]
Allez dans <UIPath>Parc > Compteurs</UIPath>. Un compteur avec une alarme active porte un petit triangle.
</Step>
<Step>
### Ouvrez le compteur et lisez l'alarme [#open-de-meter-en-lees-het-alarm]
Dans la liste des alarmes, vous voyez pour chacune le message, **Démarré le** et si elle est Active ou Résolue. Le message dépend du type de compteur et du fournisseur.
</Step>
<Step>
### Résolvez le problème [#los-het-probleem-op]
Vérifiez la batterie et le signal dans les détails du compteur, et rendez-vous sur place si nécessaire.
</Step>
<Step>
### Effacez l'alarme [#wis-het-alarm]
Dans le menu d'actions du compteur, choisissez **Effacer les alarmes**.
</Step>
</Steps>

## Ce que signifie l'état [#wat-de-status-betekent]

- **Indicateur d'état** : les compteurs intelligents (ICY et Tillor Hydrodigit) indiquent s'ils ont communiqué récemment et s'il y a des alarmes. L'indicateur change de couleur en cas d'alarme active ou si le compteur n'a rien envoyé depuis plus d'un jour.
- **Niveau de batterie** et **qualité du signal** : en pourcentage dans les détails du compteur, pour les compteurs qui les transmettent.

## Contrôleurs ICY [#icy-controllers]

Les modules ICY sur les emplacements communiquent via un contrôleur placé dans le local des compteurs. Si un contrôleur tombe, plus aucun compteur derrière ce contrôleur n'envoie quoi que ce soit.

Si votre parc a des compteurs ICY, la carte **Contrôleurs ICY** apparaît dans <UIPath>Parc > Compteurs</UIPath>, au-dessus de la liste. Elle indique combien de contrôleurs il y a, combien n'ont plus été vus par ICY depuis une heure et combien d'alarmes sont ouvertes sur des contrôleurs. Cliquez sur **Afficher** pour le tableau :

- **Contrôleur** : le nom du local des compteurs où se trouvent la plupart des compteurs du contrôleur, avec un point vert ou rouge. Si le nom chez ICY diffère, il figure en gris à côté. Si les compteurs ne se trouvent dans aucun local, vous ne voyez que le nom d'ICY.
- **Compteurs** : combien de vos compteurs communiquent via ce contrôleur. Sur un compteur, ce nom figure sous **Contrôleur** dans la carte **Informations**.
- **Alarmes** : les alarmes qu'ICY signale sur le contrôleur lui-même, avec la date de début. Une alarme disparaît de la liste dès qu'ICY ne la signale plus ; vous n'avez pas à l'effacer. Une alarme que Tillor ne connaît pas encore par son nom s'affiche comme **Alarme inconnue** avec le code d'ICY. Les personnes qui reçoivent les notifications push pour les alarmes de compteurs en reçoivent aussi une pour une nouvelle alarme et pour une alarme résolue sur un contrôleur.
- **Dernière vue** : le moment où ICY a vu le contrôleur pour la dernière fois. Si c'était il y a plus d'une heure, l'heure s'affiche en rouge.

Un contrôleur avec une alarme ou silencieux depuis plus d'une heure est placé en haut, et la carte s'ouvre alors d'elle-même.
Tillor met la liste à jour à chaque lecture des compteurs ICY.

## Si tous vos compteurs s'arrêtent en même temps [#als-al-je-meters-tegelijk-stilvallen]

Les compteurs Tillor Hydrodigit et Tillor EM300 envoient leur index à Tillor via un récepteur, la passerelle LoRa. Normalement, ils envoient une mesure environ deux fois par jour. Si chaque compteur LoRa récemment actif de votre organisation n'a rien envoyé depuis plus de 24 heures, la cause est probablement la passerelle ou la liaison avec Tillor, et non les compteurs. Un seul compteur silencieux ne déclenche pas ce message : il faut au moins deux compteurs actifs.

Les administrateurs de Tillor reçoivent alors une notification, avec la dernière mesure reçue et les compteurs concernés. Ces compteurs ne figurent alors plus séparément comme compteurs nécessitant une attention. Vous n'avez rien à configurer. Si vous voyez sur vos compteurs un **Dernier relevé** ancien et identique, contactez le support.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une alarme effacée n'apparaît plus comme active dans la liste. Le petit triangle à côté du compteur dans <UIPath>Parc > Compteurs</UIPath> ne correspond qu'aux alarmes actives.
- Si le compteur signale à nouveau le problème, vous recevez une nouvelle alarme.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="L'alarme revient sans cesse">
La cause est toujours là. Vérifiez la batterie, le signal et l'emplacement du compteur, et appelez le support si nécessaire.
</Accordion>
<Accordion title="Plusieurs compteurs n'ont pas de relevé récent">
Regardez s'ils ont tous un **Dernier relevé** ancien. La cause est alors la passerelle ou la liaison. Contactez le support.
</Accordion>
<Accordion title="Un groupe de compteurs ICY n'envoie plus rien en même temps">
Regardez dans la carte **Contrôleurs ICY** si un contrôleur a une alarme ou est en rouge. Le problème vient alors de ce contrôleur ou de sa connexion, et non des compteurs. Vérifiez l'alimentation et le réseau du local des compteurs et contactez ICY si nécessaire.
</Accordion>
<Accordion title="Un compteur n'envoie plus rien, mais aucune notification n'arrive">
La notification de la passerelle exige au moins deux compteurs actifs. Regardez vous-même l'état, la batterie et le signal de ce compteur.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Consulter les index et les tendances" href="/meterbeheer/meterstanden-en-trends" />
  <Card title="Facturer la consommation" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Lots de consommation (/fr-FR/meterbeheer/consumptie-batches)

Cette page explique comment Tillor découpe la consommation d'un client en périodes, afin que vous compreniez pourquoi un montant se présente ainsi. Un **lot de consommation** (ou période de consommation) est une période de relevés de compteur pour un client et un compteur. Tillor suit automatiquement le début d'une période, sa fin et son état de facturation. Vous voulez seulement facturer ? Rendez-vous à [Facturer la consommation](/meterbeheer/verbruik-factureren).

## Cycle de vie d'un lot [#levenscyclus-van-een-batch]

```mermaid
flowchart TD
  A[Créé<br/>index de départ seulement] -- relevés --> B[Ouvert<br/>index de départ et de fin]
  B -- clôturer --> C[Clôturé<br/>figé]
  C -- facturer --> D[Facturé<br/>terminé]
```

### Statuts [#statussen]

| Statut | Description |
|--------|-------------|
| **Ouvert** | Les nouveaux relevés sont ajoutés automatiquement à la période |
| **Clôturé** | La période est terminée et attend d'être facturée |
| **Facturé** | La consommation a été reprise dans une facture |

## Quand un lot est-il créé ? [#wanneer-wordt-een-batch-aangemaakt]

- **À l'occupation** : lorsque vous liez un client à un terrain équipé de compteurs et que vous indiquez un index de départ
- **À un relevé manuel** : lorsque vous saisissez un index pour un compteur d'un terrain avec une occupation active et qu'il n'existe pas encore de lot ouvert pour cette combinaison client-compteur

## Quand un lot est-il clôturé ? [#wanneer-wordt-een-batch-gesloten]

- **À la fin de l'occupation** : lorsque le client quitte le terrain (l'occupation est supprimée)
- **À la correction ou remise à zéro du compteur** : lorsque l'index baisse (par exemple compteur remplacé ou corrigé), le système clôture la période précédente, crée un lot « saut » clôturé avec une consommation négative (par exemple -90 pour 100→10), et le relevé suivant démarre un nouveau lot ouvert
- **À une nouvelle occupation** : lorsqu'un autre client (ou le même client à nouveau) est lié avec des index de départ explicites

<Callout type="info" title="L'index baisse">
Lorsqu'un index baisse (correction, remise à zéro ou remplacement), Tillor clôture automatiquement le lot en cours, crée un lot « saut » clôturé avec une consommation négative et ouvre aussitôt un nouveau lot au nouvel index. Le lot « saut » est facile à reconnaître et à marquer comme payé. Le relevé suivant est ajouté au nouveau lot.
</Callout>

## Exemples [#voorbeelden]

<Accordions type="multiple">
  <Accordion title="Occupation normale (cas idéal)">
    Un client s'installe sur le terrain, consomme, puis part. Le scénario le plus courant.

    ```
    1. Bezetting aangemaakt met startstand 100 m³ (15 jan)
       → Batch: start 100 m³, open

    2. Uitlezingen: 150 m³ (20 jan), 200 m³ (25 jan)
       → Batch: start 100 m³, eind 200 m³, verbruik 100 m³

    3. Bezetting beëindigd met eindstand 250 m³
       → Batch gesloten: verbruik 150 m³, wacht op facturering

    4. Factureer verbruik
       → Batch gefactureerd, klaar
    ```
  </Accordion>

  <Accordion title="Facturation en continu (cas idéal)">
    L'occupation se poursuit ; vous facturez par période sans clôturer le lot.

    ```
    1. Batch: 0 → 50 m³ (open)
    2. Markeer als gefactureerd
       → Batch 1 gesloten, Batch 2 automatisch aangemaakt: 50 → (open)
    3. Nieuwe uitlezingen: 75, 100 m³
       → Batch 2: 50 → 100 m³, verbruik 50 m³
    4. Markeer weer als gefactureerd
       → Batch 2 gesloten, Batch 3: 100 → (open)
    ```
  </Accordion>

  <Accordion title="L'index baisse, cas simple (100 → 10)">
    Seulement un index de départ, puis une correction. Lot « saut » avec une consommation de -90 m³, puis nouveau lot ouvert.

    ```
    1. Batch: start 100 m³ (15 jan), nog geen eindstand
    2. Uitlezing op 16 jan: 10 m³ (meter gecorrigeerd)
       → Batch 1 gesloten (verbruik 0)
       → Sprong-batch: start 100 m³, eind 10 m³ (verbruik -90 m³) - gesloten
       → Nieuwe open batch: start 10 m³
    3. Volgende uitlezing: 20 m³ → batch: 10 → 20 m³, verbruik 10 m³
    ```
  </Accordion>

  <Accordion title="L'index baisse, avec consommation (100 → 150 → 10)">
    D'abord une consommation normale, puis le compteur est remplacé. Lot « saut » avec une consommation de -140 m³, puis nouveau lot ouvert.

    ```
    1. Batch: start 100 m³ (15 jan), eind 150 m³ (20 jan) → verbruik 50 m³
    2. Uitlezing op 25 jan: 10 m³ (meter vervangen)
       → Batch 1 gesloten met eind 150 m³ (verbruik 50 m³)
       → Sprong-batch: start 150 m³, eind 10 m³ (verbruik -140 m³) - gesloten
       → Nieuwe open batch: start 10 m³
    3. Volgende uitlezing: 20 m³ → batch: 10 → 20 m³, verbruik 10 m³
    ```
  </Accordion>

  <Accordion title="Période sans consommation">
    Un relevé avec le même index que celui de départ. Tillor ajuste la date de début.

    ```
    1. Batch: start 982 m³ (1 dec), open
    2. Uitlezing 5 jan: 982 m³ (zelfde stand)
       → Start automatisch aangepast naar 5 jan
       → Periode toont "5 jan → ..." in plaats van "1 dec → ..."
    3. Uitlezing 5 jan (later): 990 m³
       → Verbruik 8 m³, periode "5 jan → 5 jan"
    ```
  </Accordion>

  <Accordion title="Un client revient">
    Un client quitte le terrain et revient plus tard. Nouveau lot, sans lien avec le précédent.

    ```
    1. Klant A: batch 0 → 50 m³, bezetting beëindigd
    2. Klant B: batch 55 → 100 m³, bezetting beëindigd
    3. Klant A keert terug met startstand 110 m³
       → Nieuwe batch: start 110 m³ (niet 50 m³)
       → Geen koppeling met vorige periode
    ```
  </Accordion>

  <Accordion title="Facture brouillon supprimée : la suite redevient un seul lot">
    Vous aviez facturé la consommation alors que l'occupation continuait ; ensuite vous supprimez la facture brouillon.

    ```
    1. Open batch: 100 m³ (1 feb) → 200 m³ (7 mrt), bezetting loopt door
    2. Factureer verbruik (conceptfactuur)
       → Batch A: 100 → 200 m³, gekoppeld aan factuur, afgesloten voor die factuur
       → Batch B automatisch: start 200 m³ (zelfde uitlezing als eind van A), open
    3. Nieuwe uitlezing: 250 m³ (15 mrt)
       → Batch B: 200 → 250 m³
    4. Conceptfactuur verwijderen
       → Batch A: niet meer gekoppeld aan factuur, niet gefactureerd
       → Batch B (start nog steeds op 200 m³) wordt samengevoegd in A
       → Resultaat: één open batch 100 m³ → 250 m³, klaar om opnieuw te factureren
    ```
  </Accordion>

  <Accordion title="Facture brouillon supprimée : pas de fusion (autre départ)">
    Deux périodes distinctes sur le même compteur : le deuxième lot ne démarre **pas** à l'index de fin du premier. Tillor ne les fusionne **pas**.

    ```
    1. Batch A: 12,49 m³ → 13,21 m³ (eindstand = uitlezing X)
    2. Later een andere periode / sprong op de meter
    3. Batch B: 0,10 m³ → 0,77 m³ (start = uitlezing Y, Y ≠ X)
    4. Zelfde of andere factuur - maakt niet uit voor dit voorbeeld
    5. Als je een factuur verwijdert die alleen bij A hoorde:
       → A wordt weer vrijgegeven voor facturering
       → Batch B blijft bestaan; wordt niet in A getrokken (start Y is niet hetzelfde als eind X)
    ```
  </Accordion>

  <Accordion title="Facture brouillon supprimée : la suite est déjà refacturée">
    La première facture couvre la période jusqu'à l'index X ; ensuite de nouveaux relevés et une **deuxième** facture sur la suite. Supprimer la première facture ne modifie pas la deuxième.

    ```
    1. Factuur 1: batch A 0 → 50 m³ → na facturering batch B: start 50 m³, open
    2. Uitlezingen: 60, 75 m³ op batch B
    3. Factuur 2: batch B gefactureerd → batch C: start 75 m³
    4. Factuur 1 verwijderen
       → A weer vrijgegeven
       → B hoort nog bij factuur 2 → wordt niet als "open voortzetting van A" gezien
       → Geen samenvoeging van A met B; C blijft de actieve voortzetting na factuur 2
    ```
  </Accordion>
</Accordions>

## Facturation [#facturering]

### Méthode 1 : via le bouton de facturation (nouvelle facture) [#manier-1-via-factuurknop-nieuwe-factuur]

1. Allez dans **Clients** > client > onglet **Aperçu** (carte **Lectures**)
2. Cliquez sur **Facturer la consommation**
3. Le système crée une facture avec la consommation en ligne, ou l'ajoute à une facture brouillon existante
4. Les lots sont marqués comme facturés et liés à la facture

### Méthode 2 : marquer manuellement comme facturé [#manier-2-handmatig-als-gefactureerd-markeren]

Si vous avez facturé la consommation en dehors de Tillor :

1. Ouvrez le lot dans la carte **Lectures** (fiche client) ou **Consommation** (**Parc** > **Compteurs** > compteur)
2. Cliquez sur l'icône d'avertissement à côté de la période
3. Confirmez avec **Oui, marquer comme facturée**
4. Le lot est clôturé sans lien avec une facture

<Callout type="warn" title="Attention">
Seuls les lots marqués manuellement peuvent être « annulés ». Les lots liés à une vraie facture ne peuvent pas être annulés : la facture doit d'abord être supprimée.
</Callout>

### Nouveau lot automatique [#automatische-nieuwe-batch]

Lorsque vous marquez un lot comme facturé (et que l'occupation est toujours en cours), Tillor crée automatiquement un **nouveau lot ouvert** qui démarre à l'index de fin du précédent. La consommation se poursuit ainsi sans interruption.

```
Batch 1: 0 → 50 m³ (gefactureerd)
         ↓
Batch 2: 50 → (open, klaar voor nieuwe uitlezingen)
```

## Supprimer une facture [#factuur-verwijderen]

Si vous supprimez une **facture brouillon** à laquelle de la consommation était liée, Tillor adapte automatiquement les lots de consommation.

### Que se passe-t-il toujours ? [#wat-gebeurt-er-altijd]

- Le lien avec cette facture disparaît.
- Le lot redevient **non facturé** et peut à nouveau se retrouver sur une facture.

### Quand deux lots redeviennent-ils un seul ? [#wanneer-worden-twee-batches-weer-één]

Parfois, après la facturation, Tillor avait automatiquement démarré un **nouveau lot ouvert** à l'**index de fin** de la période facturée. Si vous supprimez cette facture, le système cherche une telle suite :

| Condition | Conséquence |
|-----------|-------------|
| Un autre lot a le **même index de départ** que l'**index de fin** du lot facturé (même relevé comme point de jonction) | Cette suite est **fusionnée** dans le lot d'origine. Vous retrouvez **une seule** période continue. |
| La suite n'est **pas encore facturée** (aucune facture dessus) | La fusion est **autorisée**. |
| La suite **commence à un autre relevé** que l'index de fin du lot facturé | **Pas** de fusion : ce sont deux périodes distinctes. |
| La suite est **déjà refacturée** (autre facture) | **Pas** de fusion : cette période reste sur l'autre facture. |

### Index de fin après la fusion [#eindstand-na-samenvoegen]

Après la fusion, le lot doit de nouveau être **ouvert** (si la suite était ouverte) et l'**index de fin** est l'index de fin actuel de cette suite, donc y compris les relevés arrivés **après** la facture. Si, techniquement, la suite n'avait pas d'index de fin mais que le compteur a des relevés plus récents, Tillor complète l'index de fin avec le **relevé le plus récent après le point de jonction** (même logique que lors de la création d'un lot).

<Callout type="info" title="Marqué manuellement comme facturé">
Seuls les lots **sans** lien avec une facture peuvent être remis manuellement « non facturés » avec l'icône d'annulation (sur **Parc** > **Compteurs** > compteur, pour les périodes réglées). Les lots rattachés à une vraie facture suivent les règles ci-dessus seulement **après** que vous avez supprimé cette facture.
</Callout>

## Situations particulières [#specifieke-situaties]

### Période sans consommation [#periode-zonder-verbruik]

Si un relevé arrive avec le même index que celui de départ (consommation = 0), Tillor ajuste automatiquement la date de début. La période affichée ne montre que la période pendant laquelle il y a réellement eu de la consommation.

### Un client revient [#klant-keert-terug]

Lorsqu'un client occupe à nouveau un terrain après un départ antérieur :

- Un **tout nouveau lot** est créé
- Le lot ne démarre pas là où le précédent s'était arrêté
- Vous choisissez à nouveau un index de départ (ou l'index du compteur à ce moment-là)

### Compteur lié à plusieurs clients [#meter-gekoppeld-aan-meerdere-klanten]

Chaque combinaison client-compteur a ses propres lots. Un même terrain peut avoir plusieurs occupations (par exemple sur des périodes différentes), chacune avec ses propres périodes de consommation.

## Aperçu dans l'application [#overzicht-in-de-applicatie]

Où voir les lots :

- **Clients** > client > onglet **Aperçu** > carte **Lectures** : par compteur, uniquement les périodes **en cours** (accent orange) avec le bouton **Facturer la consommation** en haut.
- **Parc** > **Compteurs** > compteur > carte **Consommation** : par client, d'abord les périodes en cours (orange), puis les périodes réglées (vert si liées à une facture, gris si marquées manuellement).
- **Clients** > **Consommation impayée** : tableau des clients dont la consommation reste à facturer.


<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Clients > Consommation impayée" />

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des compteurs" href="/meterbeheer" description="Retour à l'aperçu" />
  <Card title="Facturer la consommation" href="/meterbeheer/verbruik-factureren" description="Facturer pas à pas" />
  <Card title="Factures" href="/facturen" description="Factures brouillon et facturation" />
  <Card title="Gestion des clients" href="/klantenbeheer" />
</Cards>


# Aperçu (/fr-FR/meterbeheer)

Avec la gestion des compteurs, vous relevez à distance les compteurs de votre parc et voyez qui consomme quoi, sans que personne ait à passer devant les armoires. Vous voyez les index, la consommation par période et les alarmes, et vous facturez la consommation au client présent sur le terrain à ce moment-là. Vous trouvez vos compteurs sous <UIPath>Parc > Compteurs</UIPath>.

<DocScreenshot src="/screenshots/park/meters-list.png" alt="Parc > Compteurs avec tous les compteurs du parc" />

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Un compteur n'appartient jamais directement à un client. Le compteur est rattaché à un **terrain**, et le client est rattaché à ce terrain par une **occupation**. Celui qui a actuellement une occupation sur le terrain reçoit la consommation des compteurs de ce terrain.

```mermaid
flowchart LR
  M[Compteur] -->|vous le liez à| T[Terrain]
  K[Client] -->|reçoit une occupation sur| T
  T --> V[Consommation du client]
  V --> F[Facture]
```

Cela a trois conséquences qui surprennent souvent :

- Il n'y a pas de bouton pour lier un compteur à un client. Vous le faites en deux étapes : compteur au terrain, client au terrain. Voir [Lier un compteur à un client](/meterbeheer/meter-koppelen).
- Si un client déménage, vous ne déplacez pas le compteur. L'occupation se termine et le client suivant reçoit la consommation à partir de son propre index de départ.
- S'il n'y a pas d'occupation sur le terrain, la consommation n'appartient à personne et vous ne pouvez pas la facturer.

<Callout type="info" title="Bon à savoir">
- Un terrain a au maximum une occupation active à la fois. Un terrain avec une occupation ne figure pas dans la liste de choix de **Créer une occupation**.
- Les compteurs sur un réseau LoRa partagé envoient une mesure environ deux fois par jour. Voir l'encadré ci-dessous.
- Tillor signale une panne possible au récepteur (la passerelle) si tous vos compteurs LoRa récemment actifs n'ont rien envoyé depuis plus de 24 heures, et seulement avec au moins deux compteurs actifs.
- Si vous voulez facturer la consommation d'un client et que le montant en cours est inférieur au montant minimum, Tillor attend le prochain jour de facturation.
- En facturation automatique, Tillor retient une facture si la consommation d'électricité ou d'eau est au moins le double de ce que le client consomme habituellement.
- Un compteur supprimé ne peut pas être récupéré, ni ses index ni ses périodes de consommation.
</Callout>

<Callout type="info" title="Pour le lecteur technique">
LoRa est une liaison sans fil à longue portée et à faible consommation. Le compteur envoie son index à un récepteur sur ou près de votre parc, la passerelle, qui le transmet à Tillor. Le Dev EUI est le numéro unique d'un compteur LoRa, long de 16 caractères (chiffres 0-9 et lettres a-f). Vous saisissez ce numéro lors de la création du compteur. Les compteurs ICY se reconnaissent à leur numéro de série.
</Callout>

## Que voulez-vous faire ? [#wat-wil-je-doen]

<Cards>
  <Card title="Lier un compteur à un client" href="/meterbeheer/meter-koppelen" description="Compteur au terrain, client au terrain" />
  <Card title="Consulter les index et les tendances" href="/meterbeheer/meterstanden-en-trends" description="Index, consommation par jour ou par heure, comparaison avec la semaine dernière" />
  <Card title="Facturer la consommation" href="/meterbeheer/verbruik-factureren" description="Manuellement ou automatiquement, avec un montant minimum" />
  <Card title="Alarmes et état des compteurs" href="/meterbeheer/alarmen-en-status" description="Aucun relevé, batterie, signal et pannes" />
  <Card title="Supprimer un compteur" href="/meterbeheer/meter-verwijderen" description="En trois étapes, irréversible" />
  <Card title="Lots de consommation" href="/meterbeheer/consumptie-batches" description="Comment les périodes de consommation s'ouvrent, se clôturent et fusionnent" />
</Cards>

## Comment les index arrivent-ils ? [#hoe-komen-de-meterstanden-binnen]

Les compteurs intelligents envoient eux-mêmes leur index, en général chaque jour ou chaque semaine. Vous n'avez rien à faire : les nouveaux index apparaissent d'eux-mêmes sur le compteur et chez le client présent sur le terrain. Si un compteur n'a pas de connexion intelligente, vous saisissez l'index vous-même.

## Termes [#begrippen]

- **Compteur** : un compteur d'eau, de gaz ou d'électricité. Voir [Termes](/begrippen#meter).
- **Terrain** : l'endroit où se trouve le compteur et où se trouve un client. Voir [Termes](/begrippen#terrein).
- **Occupation** : un client sur un terrain pour une période. Voir [Termes](/begrippen#bezetting).
- **Période de consommation** (lot de consommation) : la consommation d'un client sur un compteur, d'un index de départ à un index de fin.
- **Consommation impayée** : consommation qui n'a pas encore été facturée.
- **Index de départ** : l'index avec lequel un client commence son occupation.


# Lier un compteur à un client (/fr-FR/meterbeheer/meter-koppelen)

Vous ne liez pas un compteur au client lui-même. Vous rattachez le compteur à un terrain et vous donnez au client une occupation sur ce terrain. Ensuite, la consommation arrive d'elle-même chez le client. Voir [Comment tout cela s'articule-t-il ?](/meterbeheer#hoe-hangt-dit-samen) pour le schéma.

<Requires permission="Modifier les compteurs" />

Avant de commencer :

- Le compteur figure déjà dans <UIPath>Parc > Compteurs</UIPath>. Un compteur déjà rattaché à un terrain n'apparaît pas dans la liste de choix.
- Le terrain existe et n'a pas encore d'occupation active. Si le terrain est occupé, il ne figure pas dans la liste de choix de **Créer une occupation** ; si vous voyez **Aucun terrain disponible trouvé.**, ils sont tous occupés.
- Le client existe.

## Étape 1 : rattacher le compteur au terrain [#stap-1-de-meter-aan-het-terrein-hangen]

<Steps>
<Step>
### Ouvrez le terrain [#open-het-terrein]
Allez dans <UIPath>Parc > Terrains</UIPath> et cliquez sur le terrain.
</Step>
<Step>
### Cliquez sur Ajouter un compteur [#klik-op-meter-toevoegen]
En bas de la carte **Compteurs** se trouve **Ajouter un compteur**. Choisissez le compteur dans la liste.
</Step>
<Step>
### Confirmez avec Assigner le compteur [#bevestig-met-meter-toekennen]
Le compteur figure maintenant dans la carte **Compteurs** du terrain.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Détail du terrain avec la carte Compteurs" />

## Étape 2 : placer le client sur le terrain [#stap-2-de-klant-op-het-terrein-zetten]

<Steps>
<Step>
### Ouvrez le client [#open-de-klant]
Allez dans <UIPath>Clients > Aperçu</UIPath> et ouvrez le client. Sur l'onglet **Aperçu** se trouve la carte **Occupations**.
</Step>
<Step>
### Cliquez sur Créer une occupation [#klik-op-bezetting-aanmaken]
Choisissez le terrain. S'il y a des compteurs sur le terrain, vous pouvez renseigner un **index de départ** par compteur. Vous choisissez pour cela un relevé existant ou vous saisissez une valeur. S'il n'y a pas de compteurs, vous voyez **Aucun compteur lié**.
</Step>
<Step>
### Confirmez [#bevestig]
Cliquez à nouveau sur **Créer une occupation**.
</Step>
</Steps>

## Détacher un compteur [#een-meter-loskoppelen]

Ouvrez le terrain, allez dans la carte **Compteurs** et, dans le menu (...) du compteur, choisissez **Détacher du terrain**. Le compteur continue d'exister et vous pouvez le rattacher à un autre terrain. Ce choix n'existe que sur la page du terrain, pas dans le menu du compteur lui-même.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Tillor démarre, pour chaque compteur du terrain, une période de consommation pour ce client, à partir de l'index de départ. Voir [Lots de consommation](/meterbeheer/consumptie-batches).
- Les nouveaux index sont ajoutés à cette période. Vous les voyez chez le client dans la carte **Lectures** et sur le compteur dans la carte **Consommation**.
- Si l'occupation se termine, Tillor clôture la période. Vous pouvez ensuite facturer la consommation, voir [Facturer la consommation](/meterbeheer/verbruik-factureren).
- Si vous rattachez plus tard un compteur supplémentaire à un terrain avec une occupation en cours, une période de consommation démarre pour ce compteur dès que vous saisissez un index.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas le compteur dans la liste de Ajouter un compteur">
La liste n'affiche que les compteurs sans terrain. Si le compteur est déjà rattaché à un autre terrain, allez sur ce terrain et choisissez **Détacher du terrain**.
</Accordion>
<Accordion title="Aucun terrain disponible trouvé">
Tous les terrains ont déjà une occupation active. Mettez d'abord fin à l'occupation du terrain que vous voulez utiliser, ou créez un nouveau terrain.
</Accordion>
<Accordion title="Détacher du terrain ne figure pas dans le menu du compteur">
Ce choix se trouve uniquement dans le menu (...) de la page du terrain, dans la carte **Compteurs**. Tillor affiche **Échec du détachement** si cela n'a pas fonctionné ; réessayez alors.
</Accordion>
<Accordion title="Le client ne voit pas la consommation du compteur">
Vérifiez trois choses : le compteur est-il rattaché au terrain, le client a-t-il une occupation active sur ce terrain, et un index est-il arrivé après le début ? Sans occupation, la consommation n'appartient à personne.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Facturer la consommation" href="/meterbeheer/verbruik-factureren" />
  <Card title="Terrains" href="/terreinen" />
  <Card title="Occupations" href="/bezettingen" />
</Cards>


# Supprimer un compteur (/fr-FR/meterbeheer/meter-verwijderen)

Un compteur qui n'existe plus se supprime en trois étapes. C'est irréversible. Si vous voulez seulement retirer le compteur d'un terrain, détachez-le, voir [Lier un compteur à un client](/meterbeheer/meter-koppelen#een-meter-loskoppelen).

<Requires permission="Modifier les compteurs" />

<Steps>
<Step>
### Ouvrez le menu d'actions [#open-het-actiemenu]
Cliquez sur les trois points du compteur, dans la liste ou sur la page du compteur, et choisissez **Supprimer le compteur**.

<DocScreenshot src="/screenshots/meterbeheer/meter-actions-menu.png" alt="Menu d'actions d'un compteur avec Supprimer le compteur" />
</Step>
<Step>
### Étape 1 sur 3 : Continuer [#stap-1-van-3-doorgaan]
Vous lisez que le compteur disparaît pour tout le monde dans votre organisation. Cliquez sur **Continuer**, ou sur **Annuler** pour arrêter.

<DocScreenshot src="/screenshots/meterbeheer/meter-delete-dialog.png" alt="Étape 1 de la suppression d'un compteur" />
</Step>
<Step>
### Étape 2 sur 3 : voyez ce qui disparaît [#stap-2-van-3-bekijk-wat-verdwijnt]
Vous voyez tous les index avec leurs photos, les remarques, les alarmes et les anomalies, ainsi que le nombre de périodes de consommation. Les périodes de consommation pas encore facturées sont en rouge. Si le compteur est encore rattaché à un terrain, cela figure aussi. Cliquez sur **Continuer**.
</Step>
<Step>
### Étape 3 sur 3 : saisissez le nom [#stap-3-van-3-typ-de-naam]
Saisissez le nom du compteur. Ce n'est qu'alors que **Supprimer définitivement** devient actif.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le compteur, ses index, photos, remarques et alarmes disparaissent, y compris pour vos collègues.
- Les périodes de consommation qui n'étaient pas encore facturées ne peuvent plus être facturées. Facturez-les ou marquez-les donc d'abord, voir [Facturer la consommation](/meterbeheer/verbruik-factureren).
- Si vous supprimez le compteur depuis sa propre page, vous revenez ensuite à la liste des compteurs.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le bouton Supprimer définitivement est grisé">
Vous devez saisir exactement le nom du compteur. Vérifiez les majuscules et les espaces.
</Accordion>
<Accordion title="Tillor affiche Impossible de supprimer le compteur">
Le compteur n'a pas été supprimé. Réessayez ; si cela continue d'échouer, contactez le support.
</Accordion>
<Accordion title="Je ne vois pas Supprimer le compteur dans le menu">
Vous avez besoin de l'autorisation **Modifier les compteurs**. Demandez-la à votre administrateur.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Lier un compteur à un client" href="/meterbeheer/meter-koppelen" />
  <Card title="Facturer la consommation" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Consulter les index et les tendances (/fr-FR/meterbeheer/meterstanden-en-trends)

Sur la page d'un compteur, vous voyez le dernier index, qui utilise le compteur actuellement et comment la consommation évolue. Vous voyez ainsi vite si un compteur fait ce qu'il doit faire et si quelque chose d'inhabituel se passe. Vous voulez facturer la consommation ? Rendez-vous à [Facturer la consommation](/meterbeheer/verbruik-factureren).

## Ouvrir un compteur [#een-meter-openen]

<Steps>
<Step>
### Allez dans Parc > Compteurs [#ga-naar-park--meters]
Vous voyez tous les compteurs avec **Nom**, **Type** (eau, électricité ou gaz), **Fournisseur**, **Module** (Campère ou PRM, uniquement pour les compteurs ICY), **Terrain** et la **Dernière lecture** avec sa date. Les compteurs avec une alarme active ont un petit triangle.
</Step>
<Step>
### Cliquez sur le compteur [#klik-op-de-meter]
Vous voyez en haut les données du compteur et notamment les cartes **Informations**, **Consommation**, **Consommation & tendances**, les alarmes et l'activité.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Détail du compteur avec la carte Consommation" />

Ce qui se trouve où :

- **Informations** : numéro de série, type, terrain, dernière mesure et, si le compteur la transmet, le niveau de batterie. Pour un compteur ICY, vous voyez aussi quel **Module** est installé à cet emplacement (Campère ou PRM), via quel **Contrôleur** ce module communique (avec le nom de l'armoire de compteurs de ce contrôleur), le **Temps de coupure** réglé chez ICY et, si ICY le connaît, le **Numéro de série du module**.
- **Client** dans l'en-tête : le client avec une occupation active sur le terrain du compteur. Si vous voyez **Aucun client**, le terrain n'est pas occupé ou le compteur n'est rattaché à rien.
- **Consommation** : par client, la consommation en cours et la consommation réglée.
- **Activité** : sous la carte **Consommation**, la chronologie avec la création du compteur, les modifications et les index saisis, modifiés ou supprimés manuellement. Les modifications que Tillor constate chez ICY, comme un autre numéro de série ou un autre temps de coupure du module, y figurent aussi.

## Lire la consommation et les tendances [#verbruik-en-trends-lezen]

En haut de la carte **Consommation & tendances**, vous voyez la consommation de **Cette semaine** et de **Semaine dernière**, la différence **vs semaine dernière** et la moyenne par semaine (**Moy. / semaine**). Si le compteur a encore trop peu d'historique, vous voyez **Historique insuffisant**.

<DocScreenshot src="/screenshots/meterbeheer/meter-consumption-trends.png" alt="Consommation & tendances d'un compteur" />

Sous le graphique se trouvent les **Analyses** : la prévision pour les 30 prochains jours, le total sur la période choisie, un jour de pic, les jours sans consommation et l'évolution. Si la consommation des 7 derniers jours est nettement supérieure à la normale, vous voyez **Consommation élevée**, avec la météo de ces jours. Voir [Météo](/weer).

<Tabs items={["Par jour ou par heure", "Choisir une période"]}>
<Tab value="Par jour ou par heure">
Avec les boutons en haut à droite de la carte, vous changez le **Regroupement** entre **Par jour** et **Par heure**, et le **Type de graphique** entre aire et barres. **Par heure** affiche la consommation horaire sous forme de barres ; une heure encore en cours porte l'indication **en cours**.

- Si vous choisissez une période de deux jours ou moins, comme **Aujourd'hui** ou **Hier**, le graphique affiche automatiquement des barres par heure.
- Pour une période plus longue, **Par heure** affiche les 31 derniers jours.
</Tab>
<Tab value="Choisir une période">
Cliquez en haut à droite sur le bouton calendrier. À gauche, vous choisissez une période rapide : **Aujourd'hui**, **Hier**, **7 derniers jours**, **Dernier mois**, **3 derniers mois** ou **Tout**. À droite, vous choisissez une **Date de début** et une **Date de fin** sur le calendrier et vous confirmez avec **Appliquer**. Cliquer sur un seul jour affiche ce jour. Vous pouvez aussi ajuster l'heure de début et de fin.

<DocScreenshot src="/screenshots/meterbeheer/meter-period-picker.png" alt="Sélecteur de période avec périodes rapides et calendrier" />
</Tab>
</Tabs>

## Compteurs commutables [#schakelbare-meters]

Pour les compteurs que vous pouvez allumer ou éteindre à distance, comme ICY, le graphique d'historique affiche aussi l'état marche/arrêt. Une ligne verte signifie que le compteur était allumé. Une ligne rouge avec des repères en pointillés signifie éteint. Si un relevé n'a pas de donnée marche/arrêt, il compte comme allumé.

Pour un compteur ICY, vous choisissez dans le menu d'actions, sous **Intensité**, combien d'ampères reçoit l'emplacement. Vous ne voyez que les valeurs jusqu'au maximum réglé chez ICY pour le module à cet emplacement : si c'est 16 A, 20 A et 25 A ne figurent pas dans la liste.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Rien ne change dans vos données : ce ne sont que des vues. Les tendances et la météo sont mises à jour dès que de nouveaux index arrivent.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Il est indiqué Historique insuffisant">
Le compteur n'a pas encore assez de jours de mesures pour une comparaison avec la semaine dernière. Revenez plus tard.
</Accordion>
<Accordion title="Le graphique est vide et il est indiqué Aucune consommation disponible">
Il n'y a pas de consommation pour la période choisie. Choisissez une période plus longue, par exemple **Tout**.
</Accordion>
<Accordion title="Le dernier index est ancien">
Regardez à [Alarmes et état des compteurs](/meterbeheer/alarmen-en-status) s'il y a une alarme ou une panne du récepteur.
</Accordion>
<Accordion title="Dans Intensité, la valeur que je veux ne figure pas dans la liste">
Tillor ne propose aucune valeur au-dessus du maximum réglé chez ICY pour le module à cet emplacement. Si ce maximum n'est pas correct, contactez ICY.
</Accordion>
<Accordion title="Dans Client, il est indiqué Aucun client">
Il n'y a pas d'occupation active sur le terrain du compteur, ou le compteur n'est rattaché à aucun terrain (**Aucun terrain**). Voir [Lier un compteur à un client](/meterbeheer/meter-koppelen).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Alarmes et état des compteurs" href="/meterbeheer/alarmen-en-status" />
  <Card title="Météo" href="/weer" />
  <Card title="Facturer la consommation" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Facturer la consommation (/fr-FR/meterbeheer/verbruik-factureren)

La consommation d'un client est prête à être facturée dès qu'il existe une période de consommation avec de la consommation. Vous la mettez sur une facture d'un seul bouton, ou vous laissez Tillor facturer automatiquement un jour fixe. Comment une période naît et se clôture, vous le lisez à [Lots de consommation](/meterbeheer/consumptie-batches).

Avant de commencer :

- Le client a ou avait une occupation sur un terrain avec des compteurs. Sans occupation, il n'y a pas de consommation à facturer, voir [Lier un compteur à un client](/meterbeheer/meter-koppelen).
- Il y a de la consommation impayée. Si vous voyez **Aucun compteur avec consommation impayée trouvé.**, il n'y a rien à facturer.

## Facturer la consommation [#verbruik-factureren]

<Tabs items={["Depuis le client", "De tous les clients", "Facturé hors de Tillor"]}>
<Tab value="Depuis le client">
<Steps>
<Step>
### Ouvrez le client [#open-de-klant]
Allez dans <UIPath>Clients > Aperçu</UIPath>, ouvrez le client et regardez la carte **Lectures**. Vous y voyez, par compteur, les périodes en cours.
</Step>
<Step>
### Cliquez sur Facturer la consommation [#klik-op-factureer-verbruik]
Tillor met, par période, une ligne principale avec le montant sur une facture, avec dessous une ligne d'information avec les dates et les index. S'il existe déjà une facture brouillon adaptée, Tillor y ajoute les lignes.
</Step>
<Step>
### Choisissez vous-même les compteurs et la facture [#kies-zelf-welke-meters-en-welke-factuur]
Ouvrez la flèche à côté du bouton et choisissez **Ajouter avec sélection...**. Dans **Facturation avancée**, vous choisissez une facture brouillon existante sous **Facture (optionnel)**, ou vous laissez vide pour une nouvelle facture. Sous **Sélectionner les compteurs**, vous cochez les compteurs à inclure.
</Step>
</Steps>
</Tab>
<Tab value="De tous les clients">
Allez dans <UIPath>Clients > Consommation impayée</UIPath>. Vous voyez les clients dont la consommation doit encore être facturée, avec le montant total par client. Par défaut, seuls les clients sans facturation automatique figurent ici. Facturez directement depuis la ligne.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Clients > Consommation impayée" />
</Tab>
<Tab value="Facturé hors de Tillor">
Si vous avez facturé la consommation ailleurs, vous la marquez sans facture :

1. Ouvrez la période dans la carte **Lectures** (fiche client) ou **Consommation** (<UIPath>Parc > Compteurs</UIPath> > compteur).
2. Cliquez sur l'icône d'avertissement à côté de la période.
3. Confirmez avec **Oui, marquer comme facturée**.

<Callout type="warn" title="Attention">
Tillor ne crée pas de facture ici. Seules les périodes que vous avez marquées ainsi se remettent en place avec l'icône d'annulation dans les périodes réglées. Une période rattachée à une vraie facture n'est libérée que si vous supprimez cette facture.
</Callout>
</Tab>
</Tabs>

## Facturer automatiquement [#automatisch-factureren]

Si la facturation automatique des fournitures est activée pour un client, Tillor crée lui-même la facture le jour choisi et l'envoie. Vous le réglez sur la fiche client.

Deux règles déterminent si cette facture est réellement créée :

- **Montant minimum.** Si le montant en cours est inférieur, Tillor attend un prochain jour de facturation. Le minimum pour tous les clients se trouve sous **Paramètres > Facturation** comme **Montant minimum des factures de fournitures automatiques**. Sur la fiche client, vous pouvez définir dans les paramètres de facturation un **Montant minimum** propre, qui prime pour ce client. Si vous laissez les deux vides, tout montant est facturé.
- **Consommation nettement supérieure à l'habituel.** Si la consommation d'électricité ou d'eau en cours est au moins le double de ce que le client consomme habituellement, Tillor ne crée pas la facture. Vous recevez un e-mail à l'adresse de support de votre organisation et la facture n'est pas émise tant que quelqu'un ne l'a pas vérifiée.

Tillor compare chaque type avec lui-même : l'électricité avec l'électricité précédente, l'eau avec l'eau précédente. La consommation habituelle est la valeur médiane des dernières factures de ce type. Il n'y a pas de limite fixe en m³ ou en kWh. Si le client n'a pas encore de facture précédente pour ce type, la facture part bien automatiquement.

Si l'index est correct après vérification, vous facturez vous-même la consommation via la fiche client ou via **Clients > Consommation impayée**. Réglez-y le filtre **Facturation automatique** sur **Avec date** pour voir les clients retenus.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les périodes passent de en cours à réglées. Si l'occupation est toujours active, Tillor ouvre aussitôt une nouvelle période à partir de l'index de fin, afin qu'il n'y ait pas de trou.
- Les lignes figurent sur une facture brouillon. Validez-la et envoyez-la comme n'importe quelle autre facture, voir [Factures](/facturen).
- Si vous supprimez à nouveau la facture brouillon, la consommation redevient disponible. Voir [Supprimer une facture](/meterbeheer/consumptie-batches#factuur-verwijderen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor affiche Erreur de facturation">
La consommation n'a pas pu être mise sur la facture. Réessayez. Si cela ne fonctionne pas avec une facture brouillon choisie, choisissez **Créer une nouvelle facture**.
</Accordion>
<Accordion title="La facture automatique n'a pas été créée et j'ai reçu un e-mail">
La consommation était au moins deux fois supérieure à l'habituel. Vérifiez l'index et facturez vous-même si tout est correct.
</Accordion>
<Accordion title="Le client ne figure pas dans Consommation impayée">
La liste n'affiche par défaut que les clients sans facturation automatique. Réglez le filtre **Facturation automatique** sur **Avec date** pour les autres clients. Si le client n'y figure toujours pas, il n'y a pas de consommation impayée.
</Accordion>
<Accordion title="Il n'y a rien à facturer alors que le client a consommé de l'eau">
Vérifiez si le client a une occupation active sur le terrain où se trouve le compteur, et si un index est arrivé après l'index de départ. Une période sans consommation ne donne aucun montant.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Lots de consommation" href="/meterbeheer/consumptie-batches" />
  <Card title="Factures" href="/facturen" />
  <Card title="Gestion des clients" href="/klantenbeheer" />
</Cards>


# Aperçu (/fr-FR/nfc)

Un tag NFC est une carte, un bracelet, un porte-clés ou un autocollant que le client approche d'un lecteur, comme pour un paiement sans contact. Avec lui, il prend une douche, ouvre une porte ou recharge sa voiture. Sur cette page, vous voyez comment un tag, un client et un solde vont ensemble. Les étapes pour lier un tag ou le recharger se trouvent à [Gérer les tags](/nfc/nfc-tags).

Vous trouvez tous les tags de votre organisation sur la page **Contrôleurs**, dans la carte **Tags NFC**.

<DocScreenshot src="/screenshots/nfc/nfc-tags-list.png" alt="La carte Tags NFC sur la page Contrôleurs" />

<Callout type="info" title="Bon à savoir">
- Un tag apparaît de lui-même dans Tillor dès qu'il a été approché d'un lecteur pour la première fois. Vous ne le créez pas vous-même.
- Un tag appartient à un client au maximum et a le statut **Actif**, **Inactif** ou **Bloqué**.
- Le solde est exprimé en euros sur le tag. Une modification de solde est toujours conservée comme transaction et ne peut être ni modifiée ni supprimée.
- Un paiement qui doit encore être écrit sur le tag reste ouvert 2 minutes. Ensuite, il expire.
- Un tag bloqué ne fonctionne plus sur les lecteurs.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Le tag lui-même ne sait rien. Tillor retient qui l'a, quel est le solde et où il peut aller. Le lecteur le demande à Tillor au moment où le client approche le tag.

```mermaid
flowchart TD
  K[Client] --> T[Tag NFC]
  T --> G[Groupes d'accès<br/>où le tag peut-il aller ?]
  T --> S[Solde<br/>quel crédit y a-t-il dessus ?]
  L[Lecteur à la douche, porte ou borne de recharge] -->|le client approche le tag| T
  L --> TR[Transaction<br/>montant, raison et lecteur]
  S --> TR
```

- Sans client, le lecteur refuse le tag. L'écran affiche alors **Tag non lié**.
- Sans le bon groupe d'accès, le lecteur refuse le tag avec **Pas d'accès**.
- Sans assez de solde, l'écran affiche **Solde insuffisant**. Tous les messages d'écran se trouvent à [Messages d'écran](/controllers/troubleshooting/scherm).
- Chaque débit ou recharge devient une ligne dans les [transactions](/nfc/nfc-transacties).
- Un tag est aussi une méthode d'accès. Vous l'ajoutez à un client sous [Contrôle d'accès](/toegangscontrole#een-toegangsmethode-toevoegen).

## Composants [#onderdelen]

<Cards>
  <Card title="Gérer les tags" href="/nfc/nfc-tags" description="Lier des tags à des clients et modifier le solde" />
  <Card title="Transactions" href="/nfc/nfc-transacties" description="Toute l'utilisation et les modifications de solde" />
  <Card title="Contrôleurs" href="/controllers" description="Les lecteurs contre lesquels les clients approchent leur tag" />
</Cards>

## Termes [#begrippen]

- **Tag** : la carte, le bracelet, l'autocollant ou le porte-clés.
- **UID** : le numéro unique du tag.
- **Solde** : le crédit sur le tag.
- **Groupe d'accès** : détermine pour quels lecteurs un tag est valable.
- **Transaction** : un débit ou une recharge du solde.

Vous trouverez plus d'explications dans la [liste des termes](/begrippen).


# Gérer les tags (/fr-FR/nfc/nfc-tags)

Un tag NFC n'est utilisable que s'il est rattaché à un client. Ce client peut alors s'en servir pour prendre une douche, ouvrir une porte ou recharger, et vous pouvez suivre le solde. Toutes les étapes ci-dessous se font sur la fiche client. Ce qui se passe à chaque passage, vous le lisez à [Transactions](/nfc/nfc-transacties).

Avant de commencer :

- Le tag doit déjà figurer dans Tillor. Cela se fait de lui-même dès qu'il a été approché d'un lecteur pour la première fois.
- Le tag ne doit pas encore être rattaché à un autre client. Sinon, il ne figure pas dans la liste.
- S'il n'y a pas de tag libre, la liste indique **Aucun tag disponible trouvé**.

## Lier un tag à un client [#een-tag-koppelen-aan-een-klant]

<Steps>
<Step>
### Ouvrez l'onglet Tags NFC [#open-het-tabblad-nfc-tags]
Allez dans <UIPath>Clients > client > Tags NFC</UIPath>. Vous voyez tous les tags de ce client. Au-dessus du tableau, vous filtrez sur **UID** et **Type** (**Carte**, **Bracelet**, **Autocollant** ou **Bague clé**).
</Step>
<Step>
### Choisissez le tag [#kies-de-tag]
Cliquez sur **Sélectionner une carte** et choisissez le tag. Vous pouvez chercher dans la liste.
</Step>
<Step>
### Cliquez sur Assigner [#klik-op-toewijzen]
Tillor affiche **Carte assignée au client** et le tag figure dans le tableau.
</Step>
</Steps>

Dans le tableau, vous voyez pour chaque tag l'**UID** (l'icône indique le type), le **Statut**, le **Solde**, la **Dernière utilisation** et les **Groupes d'accès**.

## Que pouvez-vous faire avec un tag ? [#wat-kun-je-met-een-tag-doen]

Ouvrez le menu d'actions (trois points) à droite du tag.

<DocScreenshot src="/screenshots/nfc/nfc-tag-actions-menu.png" alt="Menu d'actions d'un tag NFC" />

| Action | Ce que cela fait |
|---|---|
| **Modifier le solde** | Ajoute un montant ou définit le solde, voir ci-dessous. |
| **Bloquer** / **Débloquer** | Met le statut sur **Bloqué** ou le remet comme avant. |
| **Groupes d'accès** | Détermine pour quels groupes d'accès le tag est valable. |
| **Envoyer une notification de solde bas** | Envoie au client une notification que le solde est bas. |
| **Copier l'URL personnelle** | Copie le lien vers la page propre du tag. |
| **Retirer du client** | Détache le tag du client. |
| **Voir les détails** | Ouvre la page de détail avec transactions et activité. |

### Ajuster le solde [#het-saldo-aanpassen]

<Steps>
<Step>
### Choisissez Modifier le solde [#kies-saldo-bewerken]
Ouvrez le menu d'actions et choisissez **Modifier le solde**.
</Step>
<Step>
### Choisissez comment modifier le solde [#kies-hoe-je-het-saldo-wijzigt]
<DocScreenshot src="/screenshots/nfc/nfc-tag-topup-dialog.png" alt="Boîte de dialogue Modifier le solde" />

Sous **Option**, choisissez **Ajouter au solde** (un montant en plus) ou **Définir le solde** (un montant exact). En bas, vous voyez le résultat, par exemple **Actuelle : ... → Nouveau : ...**.
</Step>
<Step>
### Confirmez [#bevestig]
Saisissez le montant et cliquez sur **Ajouter** ou **Définir**. Le montant doit être positif. Tillor affiche **Solde mis à jour** ou **Solde défini**.
</Step>
</Steps>

### Bloquer un tag [#een-tag-blokkeren]

Vous bloquez un tag perdu ou volé via **Bloquer**. Le statut devient **Bloqué** et le tag ne fonctionne plus sur les lecteurs. Avec **Débloquer** dans le même menu, vous levez le blocage. Le client peut aussi bloquer lui-même son tag sur la page personnelle.

### Choisir les groupes d'accès [#toegangsgroepen-kiezen]

Choisissez **Groupes d'accès** et cochez ou décochez les groupes. La modification s'applique immédiatement. Si vous voyez **Aucun groupe d'accès disponible**, aucun groupe n'a encore été configuré pour votre organisation.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Un tag lié apparaît dans le tableau et chez le client. Lorsque le client l'approche d'un lecteur, le lecteur demande à Tillor si c'est autorisé.
- Chaque modification de solde devient une [transaction](/nfc/nfc-transacties), même si vous ajustez le solde manuellement. La raison est alors **Ajustement manuel**.
- Sous **Activité** sur la page de détail, vous voyez l'avant et l'après de chaque modification (solde, blocage, lien avec le client).
- Avec **Retirer du client**, le tag continue d'exister. Il est de nouveau libre d'être donné à un autre client. Les transactions sont conservées.
- Avec **Copier l'URL personnelle**, le client obtient sa propre page. Il peut y bloquer sa carte et, si vous avez configuré les paiements en ligne, la recharger lui-même. Cela génère une facture pour le client.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="La liste des tags est vide">
Tillor indique **Aucun tag disponible trouvé**. Seuls les tags qui n'appartiennent encore à personne y figurent. Détachez le tag de l'autre client avec **Retirer du client**, ou approchez un nouveau tag d'un lecteur pour qu'il apparaisse dans Tillor.
</Accordion>
<Accordion title="Tillor affiche : Échec de la mise à jour">
Le solde ou les groupes d'accès n'ont pas pu être enregistrés. Réessayez. Si cela échoue, actualisez la page et vérifiez que le tag est toujours rattaché au client.
</Accordion>
<Accordion title="Le client est refusé au lecteur">
Lisez la raison sur l'écran du contrôleur, voir [Messages d'écran](/controllers/troubleshooting/scherm). Le plus souvent, le tag est **Bloqué**, n'est pas rattaché à un client, le bon groupe d'accès n'est pas activé ou le solde est trop bas.
</Accordion>
<Accordion title="Tillor affiche : Le montant doit être positif">
Le montant doit être renseigné et supérieur à zéro. Sinon, Tillor affiche **Le montant est obligatoire**, **Montant invalide** ou **Le montant doit être positif**.
</Accordion>
<Accordion title="Le client ne peut pas recharger lui-même">
La recharge via la page personnelle ne fonctionne que si votre organisation a configuré les paiements en ligne et si le tag est rattaché à un client. Voir [Traitement des paiements](/betalingsverwerking).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Transactions" href="/nfc/nfc-transacties" description="Consulter l'historique des transactions" />
  <Card title="Contrôle d'accès" href="/toegangscontrole" description="Barrières et méthodes d'accès" />
  <Card title="Gestion des clients" href="/klantenbeheer" description="Gérer les fiches clients" />
</Cards>


# Transactions (/fr-FR/nfc/nfc-transacties)

Chaque modification de solde sur un tag NFC est enregistrée comme transaction, même un ajustement manuel. Vous voyez ainsi précisément quand et pourquoi le solde a changé. Les transactions ne peuvent être ni modifiées ni supprimées.

## Consulter les transactions [#transacties-bekijken]

<Steps>
<Step>
### Ouvrez le tag [#open-de-tag]
Allez dans <UIPath>Clients > client > Tags NFC</UIPath>, ouvrez le menu d'actions (trois points) à droite du tag et choisissez **Voir les détails**.
</Step>
<Step>
### Regardez Transactions [#kijk-bij-transacties]
La carte **Transactions** se trouve sur la page de détail. La plus récente est en haut. Au-delà de cinq transactions, vous paginez en bas.

<DocScreenshot src="/screenshots/nfc/nfc-tag-detail.png" alt="Page de détail d'un tag NFC avec transactions" />
</Step>
</Steps>

Au-dessus du tableau se trouvent des filtres sur **Date**, **Statut**, **Origine** et **Motif d'annulation**. Par défaut, **En attente** et **Validée** sont activés. Si vous voulez aussi voir les transactions annulées et expirées, cliquez sur **Effacer les filtres**.

## Colonnes [#kolommen]

| Colonne | Signification |
|---|---|
| **Montant** | La modification de solde. Positive pour une recharge, négative pour une utilisation. |
| **Raison** | Le motif, par exemple **Utilisation de la douche à** un contrôleur, **Débit POS**, **Recharge POS**, **Ajustement manuel** ou **Ajouté parce que la facture ... a été payée**. |
| **Contrôleur** | Le contrôleur qui a provoqué la transaction. Si vous voyez **Système**, il n'y avait pas de contrôleur : une modification manuelle, l'app de réception ou une facture payée. |
| **Date** | Date et heure. |
| **Statut** | Voir ci-dessous. |
| **Origine** | **En ligne** ou **Hors ligne**. |
| **Description**, **Motif d'annulation** | Explication supplémentaire et, pour une transaction annulée, la raison. |

## Statuts [#statussen]

| Statut | Signification |
|---|---|
| <Status tone="info">En attente</Status> | Le débit est réservé et doit encore être écrit sur le tag. |
| <Status tone="success">Validée</Status> | La transaction est terminée et le solde a été ajusté. |
| <Status tone="error">Annulée</Status> | La transaction n'a pas abouti. La raison figure dans **Motif d'annulation**. |
| <Status>Expirée</Status> | Le tag n'a pas été approché du lecteur à temps. Une réservation reste ouverte 2 minutes. |

Les motifs d'annulation possibles sont **Solde insuffisant**, **Non autorisé**, **Échec de l'écriture sur la carte** et **Expirée**.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une transaction en attente devient <Status tone="success">Validée</Status> dès que le tag a reçu le nouveau solde. Si cela échoue dans les 2 minutes, elle devient <Status>Expirée</Status> et le solde ne change pas.
- Sous **Origine**, vous voyez **Hors ligne** si la transaction ne s'est pas déroulée en direct via Tillor.
- Un réceptionniste peut effectuer le même débit ou la même recharge dans l'app Tillor. Le solde n'est alors mis à jour que dans Tillor. Cela apparaît comme **Débit POS** ou **Recharge POS**, sans contrôleur.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le solde ne correspond pas à ce que le client attend">
Ouvrez les transactions et regardez la raison et la date des dernières lignes. Une ligne avec **Ajustement manuel** a été saisie par un collègue. Si vous voyez des transactions **Expirée** ou **Annulée**, rien n'a été débité pour elles.
</Accordion>
<Accordion title="Une transaction En attente ne disparaît pas">
Attendez que les 2 minutes soient écoulées. La transaction devient alors <Status>Expirée</Status>. Faites approcher à nouveau le tag du lecteur par le client.
</Accordion>
<Accordion title="La carte Transactions est vide">
Le tag n'a pas encore été utilisé et le solde n'a pas été ajusté. Il n'y a alors rien à afficher.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gérer les tags" href="/nfc/nfc-tags" description="Lier des cartes et modifier le solde" />
  <Card title="Gestion des clients" href="/klantenbeheer" description="Consulter les fiches clients" />
</Cards>


# Notifications (/fr-FR/notificaties)

L'aperçu des notifications affiche chaque message que Tillor a envoyé aux clients et aux collègues, par e-mail, SMS, courrier, WhatsApp ou push. Vous voyez d'un coup d'œil quels messages sont arrivés, lesquels sont encore en route et lesquels ont échoué. Envoyer vous-même un message de facture est expliqué dans [Envoyer une facture ou un rappel](/communicatie/e-mails).

Vous ouvrez l'aperçu via <UIPath>Communication > Notifications</UIPath>.

<Callout type="info" title="Bon à savoir">
- Si un message reste plus de 5 minutes bloqué sans avoir été transmis, Tillor réessaie automatiquement
- Si aucun envoi n'a eu lieu après 2 jours, Tillor passe le message sur **Échoué**. Cela vaut aussi pour un SMS qui reste trop longtemps sur **En attente**
- La liste **Communications récentes** affiche par défaut 50 messages par page
- Un clic sur un lien dans un e-mail ou un SMS ne compte que s'il a lieu au moins environ une seconde et demie après l'envoi. Ainsi, les programmes de messagerie qui chargent les liens à l'avance ne sont pas comptés comme un clic
- Les messages de facture ne partent pas automatiquement lors de la comptabilisation d'une facture. C'est vous qui lancez l'envoi
- Une carte avec une nouvelle notification dans Tillor disparaît après quelques secondes. La notification reste dans la cloche jusqu'à ce que vous la lisiez
- Les notifications qui sont toujours envoyées ne peuvent pas être désactivées
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Un message commence par un déclencheur. Ensuite, Tillor choisit le canal et conserve le résultat dans l'aperçu.

```mermaid
flowchart LR
  A[Vous cliquez sur Envoyer la notification] --> D[Message]
  B[Un événement se produit, comme une alarme de compteur] --> D
  C[Une automatisation envoie un message] --> D
  D --> E{Pour qui ?}
  E -- Client --> F[E-mail, SMS, courrier ou WhatsApp]
  E -- Collègue --> G[Push, e-mail ou téléphone, selon ses préférences]
  F --> H[Notifications : statut par canal]
  G --> H
  G --> I[Cloche dans Tillor]
  H --> J[Aussi visible chez le client et sur la facture]
```

- **Pour un client**, vous choisissez le plus souvent le canal vous-même, par exemple dans la fenêtre **Envoyer la notification** sur une facture. Une [automatisation](/begrippen#automatisering) peut aussi envoyer un message à un client.
- **Pour un collègue**, c'est lui qui décide comment Tillor le joint, par type de notification. Voir [Notifications dans l'app](#meldingen-in-de-app).
- **Le résultat** s'affiche ici, ainsi que chez le client et sur la facture auxquels le message se rapporte. La colonne **Origine** vous y mène directement.

## Consulter les notifications [#notificaties-bekijken]

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Aperçu des notifications avec statistiques et listes" />

En haut figurent quatre statistiques :

- **Total des notifications** : toutes les tentatives d'envoi
- **Notifications envoyées** : les messages qui ont été remis
- **Notifications échouées** : les messages qui n'ont pas pu être remis
- **Notifications rejetées** : les messages qui ont été renvoyés, surtout des e-mails

En dessous figurent quatre listes : **Notifications rejetées**, **Notifications en attente** (encore dans la file ou en route), **Communications récentes** (tous les statuts) et **Notifications échouées**. Avec les filtres **Type** et **Canal** au-dessus de chaque liste, vous limitez ce que vous voyez. Les types disponibles sont décrits dans [Types de notifications](/communicatie/notificatietypes).

Chaque ligne affiche :

| Colonne | Ce que vous voyez |
|---|---|
| **Type** | La nature du message, comme Nouvelle facture ou Alarme sur compteur ou contrôleur |
| **Origine** | La facture, le client ou le paiement auquel le message se rapporte |
| **Canal** | E-mail, SMS, Courrier, WhatsApp ou Push |
| **Statut** | Le statut de remise |
| **Destinataire** | L'adresse e-mail, le numéro de téléphone, l'adresse postale ou l'utilisateur |
| **Date** | Le moment où la tentative d'envoi a été créée |

### Consulter les détails de remise [#leveringsdetails-bekijken]

Cliquez sur le canal dans une ligne pour voir ce qui a été envoyé exactement et ce qui s'est passé.

<DocScreenshot src="/screenshots/notificaties/notifications-delivery-detail.png" alt="Détails de remise de l'e-mail Nouvelle facture" />

La fenêtre affiche le statut de remise, un éventuel message d'erreur, le destinataire (**À**), l'adresse de l'expéditeur (**De**) et l'**Objet** pour un e-mail. Vous voyez aussi quand le message était prêt (**Créé le**) et quand il est réellement parti (**Envoyé à**). **Envoyé par** indique l'utilisateur qui a lancé l'envoi, ou **Système** si cela s'est fait automatiquement. En bas figurent le **Contenu** et les éventuelles **Pièces jointes**.

Pour un e-mail et un message WhatsApp, vous voyez aussi **Lu à**, et dans la liste une icône en forme d'œil pour les messages lus. Pour un e-mail et un SMS, **Cliqué à** apparaît si le client a cliqué sur un lien.

Pour le courrier, des champs supplémentaires s'affichent : **Référence transporteur**, **Statut de suivi** et **Dernière mise à jour de suivi** (le dernier événement du service postal), **Frais postaux** au moment de l'envoi et, pour un envoi recommandé, l'étiquette **Recommandé** avec le surcoût et une explication sur la répercussion.

<DocScreenshot src="/screenshots/notificaties/notifications-post-registered-detail.png" alt="Détails de remise d'un rappel recommandé par courrier" />

### Statuts [#statussen]

| Statut | Signification |
|---|---|
| <Status tone="info">En attente</Status> | Le message est en cours de traitement ou dans la file d'attente |
| <Status tone="success">Envoyé</Status> | Le message a été remis |
| <Status tone="error">Échoué</Status> | La remise a échoué |
| <Status>Ignoré</Status> | Le message n'a pas (ou plus) été envoyé, par exemple parce que le push n'était pas disponible ou parce qu'un courrier a été annulé auprès du service postal |
| <Status tone="info">Différé</Status> | Le message est planifié et partira plus tard |
| <Status tone="warning">Rejeté</Status> | Le message n'a pas pu atteindre l'adresse e-mail ou le numéro |
| <Status tone="error">Signalé comme spam</Status> | Le destinataire a marqué le message comme spam |

Un courrier postal démarre sur **En attente**. Dès que le service postal confirme que le courrier est en route ou remis, il passe sur **Envoyé**. Un courrier non distribuable passe sur **Échoué**. Un courrier annulé passe sur **Ignoré**. Vous trouvez surtout cette ligne sous **Communications récentes**.

## Notifications dans l'app [#meldingen-in-de-app]

Tout ce que Tillor vous envoie en tant que collègue, comme une tâche attribuée, une mention dans un commentaire ou une alarme de compteur, se retrouve aussi dans Tillor même. Chaque notification n'y figure qu'une fois, même si elle a été envoyée par e-mail et par push. Vous n'avez rien à configurer pour cela.

- **Cloche** : en haut à droite de la barre et en bas à gauche du menu (**Notifications**) se trouve une cloche avec le nombre de notifications non lues. Cliquez dessus pour voir vos notifications les plus récentes. Avec **Tout marquer comme lu**, vous mettez la liste à jour en une fois
- **Consulter l'e-mail** : cliquez sur une notification pour ouvrir l'e-mail que vous avez reçu, avec en haut un bouton vers la page concernée (par exemple **Ouvrir la tâche**). Une notification sans e-mail vous mène directement à cette page. La notification est ensuite lue
- **Carte en bas à droite** : si une notification arrive pendant que Tillor est ouvert, elle s'affiche sous forme de carte en bas à droite, au même endroit qu'un appel entrant. Cliquez sur la carte ou fermez-la avec la croix. Une carte fermée reste non lue dans la cloche. Si vous êtes déjà sur la page concernée par la notification, vous ne recevez pas de carte
- **Reste affichée** : les notifications pour lesquelles vous êtes aussi appelé, comme un connecteur qui n'est plus joignable, restent affichées jusqu'à ce que vous les fermiez
- **Boîte de réception** : les nouveaux messages de la boîte de réception gardent leur propre carte et leur propre compteur sous **Boîte de réception**. Dans la cloche, ils sont d'emblée marqués comme lus. Cela vaut aussi pour le récapitulatif quotidien des compteurs qui demandent de l'attention
- **Par jour** : dans la liste, vos notifications sont regroupées par jour, avec la catégorie. Avec les boutons du haut, vous n'affichez qu'une seule catégorie

Les notifications sont personnelles : vous ne voyez que les vôtres, par organisation.

Dans une [automatisation](/begrippen#automatisering), vous choisissez à l'étape **Prévenir des collègues**, avec **Afficher dans Tillor**, si la notification reçoit une carte et un compteur de non-lus. Si cette option est désactivée, la notification figure comme lue dans la liste.

### Désactiver les notifications [#meldingen-uitzetten]

<Steps>
<Step>
### Ouvrez votre compte [#open-je-account]
Cliquez sur votre nom dans le menu et choisissez **Compte**.
</Step>
<Step>
### Allez à Notifications [#ga-naar-meldingen]
Activez ou désactivez les canaux par type de notification. Dans la ligne **Toutes les notifications**, vous désactivez un canal en une seule fois pour tout.
</Step>
</Steps>

Un canal que vous désactivez dans **Toutes les notifications** reste désactivé pour chaque notification en dessous, sauf les notifications qui sont toujours envoyées. Un type dont vous désactivez tous les canaux n'apparaît plus non plus dans l'app. Pour un collègue, vous réglez cela sous <UIPath>Paramètres > Utilisateurs</UIPath>, voir [Configurer les notifications d'un collègue](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen).

## Notifications externes [#externe-notificaties]

Un système externe connecté, par exemple votre logiciel de newsletter ou de réservation, peut faire enregistrer dans Tillor les e-mails qu'il a lui-même envoyés à un client. Vous les trouvez chez le client, sur la facture et sous **Communications récentes**, parmi les messages de Tillor. Vous les reconnaissez à l'étiquette **Externe** avec le nom du système.

- Tillor n'a pas envoyé le message et ne peut pas vérifier le statut. Le statut provient du système externe
- Les notifications externes ne sont pas comptées dans les statistiques du haut et ne figurent pas dans les listes **Notifications rejetées**, **Notifications en attente** et **Notifications échouées**
- Dans la fenêtre de détail, les images sont bloquées par défaut. Ainsi, l'expéditeur ne remarque pas que vous ouvrez le message. Cliquez sur **Charger les images** pour les afficher quand même
- Le système externe peut mettre à jour ou supprimer plus tard ses propres notifications. Vous le retrouvez dans le [journal d'activité](/activiteitenlog) du client ou de la facture

Qui peut enregistrer des notifications externes se règle avec les droits **Enregistrer des notifications externes** et **Gérer les notifications externes des autres**. L'explication technique pour les intégrateurs se trouve sous [Développeurs > Notifications externes](/ontwikkelaars/externe-notificaties).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Un message est sur Rejeté">
L'adresse e-mail ou le numéro du client n'existe pas ou ne peut pas recevoir de messages. Ouvrez le message via la liste **Notifications rejetées** et lisez le message d'erreur. Allez au profil du client via la colonne **Origine**, corrigez l'adresse e-mail et renvoyez le message avec **Envoyer la notification** sur la facture.
</Accordion>
<Accordion title="Un SMS ou un message WhatsApp a échoué">
Ouvrez le message via **Notifications échouées** et lisez le message d'erreur. Le plus souvent, le numéro de téléphone est incorrect ou l'indicatif du pays manque. Modifiez le numéro sur le profil du client et renvoyez.
</Accordion>
<Accordion title="Un SMS reste sur En attente">
L'opérateur transmet parfois la remise avec du retard. Après 2 jours, Tillor passe automatiquement le SMS sur **Échoué**. Ouvrez la fenêtre de détail pour voir le message d'erreur et vérifiez le numéro.
</Accordion>
<Accordion title="Un courrier postal a échoué ou n'est pas distribuable">
Ouvrez le message via **Notifications en attente** ou **Notifications échouées**. Vérifiez l'adresse postale sur le profil du client (rue, code postal et commune) et renvoyez le courrier avec **Envoyer la notification** ou **Envoyer un rappel** sur la facture.
</Accordion>
<Accordion title="Un courrier est sur Ignoré">
Le courrier a été annulé auprès du service postal. Cherchez l'envoi sous **Communications récentes** et regardez dans **Statut de suivi** ce qui s'est passé. Ne renvoyez que si le client doit encore recevoir le courrier.
</Accordion>
<Accordion title="Je ne vois pas le bouton Envoyer la notification sur une facture">
Le bouton n'apparaît que sur une facture comptabilisée, et seulement si le client a une adresse e-mail, un numéro de téléphone ou une adresse postale complète. Complétez l'une de ces informations sur le profil du client.
</Accordion>
<Accordion title="Je ne reçois plus de notification dans Tillor">
Vérifiez sous **Compte**, dans **Notifications**, si vous avez désactivé tous les canaux pour ce type. Un type sans canaux n'apparaît plus non plus dans la cloche.
</Accordion>
</Accordions>

## Notions [#begrippen]

- **[Notification](/begrippen#notificatie)** : un message que Tillor envoie à un client ou à un collègue, par e-mail, SMS, courrier, WhatsApp ou push.
- **Canal** : la voie par laquelle un message part. Une notification peut passer par plusieurs canaux.
- **Remise** : une tentative d'envoi par un canal, avec son propre statut.
- **Rejeté** : le message est revenu parce que l'adresse ou le numéro n'existe pas.
- **Notification dans l'app** : une notification destinée à un [utilisateur](/begrippen#gebruiker) de Tillor, visible dans la cloche.
- **Externe** : un message qu'un système connecté a envoyé lui-même et qui est seulement enregistré dans Tillor.

Vous trouverez d'autres termes dans la [liste des notions](/begrippen).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Envoyer une facture ou un rappel" href="/communicatie/e-mails" description="Envoyer vous-même un message depuis une facture" />
  <Card title="Types de notifications" href="/communicatie/notificatietypes" description="Tous les types de messages et quand ils partent" />
  <Card title="Envoyer une facture" href="/facturen/versturen" description="Factures et lettres de rappel par courrier" />
  <Card title="Automatisations" href="/automatiseringen" description="Faire envoyer des messages par une automatisation" />
</Cards>


# Commentaires (/fr-FR/notities)

Avec les commentaires, les collègues collaborent autour des clients, factures, réservations et autres enregistrements, sans que le client voie quoi que ce soit. Vous écrivez un commentaire sur la page de détail de l'enregistrement, vous mentionnez un collègue avec un @ et vous épinglez les commentaires importants. Commencez par [Ajouter un commentaire](#een-opmerking-toevoegen).

<Callout type="info" title="Bon à savoir">
- Les commentaires sont toujours internes. Ils ne deviennent jamais visibles pour les clients, ni sur les factures ni dans les e-mails.
- Un collègue que vous mentionnez avec @ reçoit une notification.
- Un commentaire résolu ne peut plus être modifié ni épinglé.
- Résoudre un commentaire désépingle automatiquement un commentaire épinglé.
- Supprimer un commentaire ne peut pas être annulé.
- Un commentaire épinglé reste visible en haut de l'enregistrement, sans que vous ayez à faire défiler jusqu'à la carte **Commentaires**.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  R[Enregistrement : client, facture, réservation...] --> O[Commentaire]
  O -->|Mention @| M[Notification pour le collègue]
  O -->|Épingler| P[En haut de l'enregistrement]
  O -->|Rappel| T[Tâche de suivi]
  O -->|Résoudre| X[Résolu et replié]
```

Tous les commentaires de votre organisation figurent aussi ensemble sous <UIPath>Communication > Commentaires</UIPath>, avec un renvoi vers l'enregistrement auquel ils se rapportent.

## Où trouver les commentaires ? [#waar-vind-je-opmerkingen]

Sur les pages de détail se trouve une carte **Commentaires**. Selon l'enregistrement :

- <UIPath>Clients > Aperçu</UIPath> ou <UIPath>Clients > Communication client</UIPath> : sur le profil du client
- <UIPath>Administration > Factures</UIPath> : sur la page de détail de la facture
- <UIPath>Clients > Réservations</UIPath> : sur la page de détail de la réservation
- <UIPath>Parc > Emplacements</UIPath> : sur la page de détail de l'emplacement
- <UIPath>Parc > Compteurs</UIPath> : sur la page de détail du compteur
- <UIPath>Administration > Rapports de paiement</UIPath> : sur le rapport de paiement

## Ajouter un commentaire [#een-opmerking-toevoegen]

<Steps>
<Step>
### Ouvrez l'enregistrement [#open-het-record]
Ouvrez par exemple un profil de client ou une facture et allez à la carte **Commentaires**.

<DocScreenshot src="/screenshots/notities/invoice-comments.png" alt="Carte de commentaires sur le détail d'une facture" />
</Step>
<Step>
### Cliquez sur Ajouter un commentaire [#klik-op-reactie-toevoegen]
Saisissez votre commentaire dans la zone de texte **Écrire un commentaire...**.

- Saisissez **@** et choisissez un collègue dans la liste pour le mentionner. Cette personne reçoit une notification.
- Saisissez **/** pour lier un client, une facture, un compteur, un emplacement ou un autre enregistrement.
- Ajoutez une pièce jointe via **Joindre un fichier**, en collant ou en glissant des fichiers.
</Step>
<Step>
### Cliquez sur Envoyer [#klik-op-verzenden]
Votre commentaire apparaît maintenant sur la carte. Avec **Répondre** sous un commentaire existant, vous démarrez un fil de discussion.
</Step>
</Steps>

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le commentaire figure sur l'enregistrement et dans l'aperçu central.
- Un collègue mentionné reçoit une notification.
- Si vous voulez être sûr que quelqu'un réagisse, cliquez sur l'horloge à côté du commentaire (**Définir un rappel de suivi**). Tillor crée alors une tâche, afin que vous puissiez vérifier plus tard si le sujet a été pris en charge.

## Gérer les commentaires [#opmerkingen-beheren]

Chaque commentaire comporte des boutons d'action en haut à droite, dans la mesure où vous avez les droits.

### Modifier ou supprimer un commentaire [#opmerking-bewerken-of-verwijderen]

- **Modifier** : adaptez le texte. C'est possible pour vos propres commentaires, mais pas pour les commentaires résolus.
- **Supprimer** : supprimez le commentaire, après confirmation. Cela ne peut pas être annulé.

### Épingler un commentaire [#opmerking-vastzetten]

Vous voulez garder un commentaire important visible en haut ?

1. Cliquez sur l'icône d'épingle (**Épingler**).
2. Le commentaire reçoit l'étiquette **Épinglé** et se place en haut de la liste.
3. Cliquez à nouveau sur l'icône d'épingle pour le détacher (**Désépingler**).

Les commentaires résolus ne peuvent pas être épinglés.

#### Où se trouve un commentaire épinglé [#waar-staat-een-vastgezette-opmerking]

- Sur un profil de client, il se trouve directement sous les données du client en haut, au-dessus des onglets.
- Sur une facture, une réservation, un emplacement ou un compteur, il se trouve en haut dans la carte **En un coup d'œil**, avec les tâches en cours. Cette carte se replie quand elle est vide.

### Marquer un commentaire comme résolu [#opmerking-als-opgelost-markeren]

Pour les discussions qui sont terminées :

1. Cliquez sur la coche (**Résoudre**).
2. Le commentaire est marqué comme **Résolu** et disparaît de la liste ouverte.
3. Sur une page de détail, les commentaires résolus se trouvent en bas dans une section repliable.
4. Cliquez à nouveau sur la coche pour annuler (**Annuler la résolution**).

### Télécharger les commentaires en PDF [#opmerkingen-als-pdf-downloaden]

Avec l'icône d'impression, vous téléchargez tous les commentaires d'un enregistrement en PDF (**Télécharger tous les commentaires en PDF**), ou une seule discussion (**Télécharger ce fil de discussion en PDF**).

## Aperçu de tous les commentaires [#overzicht-van-alle-opmerkingen]

Allez à <UIPath>Communication > Commentaires</UIPath> pour un aperçu central. En haut, vous voyez des statistiques (total, ouverts, résolus et épinglés). En dessous :

<DocScreenshot src="/screenshots/notities/comments-overview.png" alt="Aperçu central des commentaires - Commentaires ouverts" />

- **Commentaires ouverts** : les commentaires qui sont encore ouverts.
- **Commentaires résolus** : les commentaires clôturés, à titre de référence.

Chaque commentaire affiche son **Origine** (par exemple client ou facture), afin que vous puissiez aller directement à l'enregistrement.

### Filtrer [#filteren]

- **Dernière semaine**, **Dernier mois** ou **Tout** : filtrez sur la date de création.
- **Afficher uniquement les mentions** : seulement les commentaires dans lesquels vous êtes mentionné.
- Recherchez avec **Rechercher des commentaires...**, ou filtrez sur l'auteur, la mention, résolu, épinglé et commentaire racine ou réponse.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor indique : Commentaire non créé">
Votre commentaire n'a pas été enregistré. Vérifiez que la zone de texte n'est pas vide et réessayez **Envoyer**.
</Accordion>
<Accordion title="Je ne vois aucun collègue en saisissant @">
Si **Aucun utilisateur trouvé** s'affiche, essayez un autre nom ou une adresse e-mail. Seuls les utilisateurs de votre organisation apparaissent dans la liste.
</Accordion>
<Accordion title="Je ne peux pas modifier ou épingler un commentaire">
Un commentaire résolu est verrouillé. Cliquez d'abord sur la coche pour le rouvrir (**Annuler la résolution**). La modification n'est possible que pour vos propres commentaires.
</Accordion>
<Accordion title="Le commentaire épinglé a disparu">
Résoudre un commentaire le désépingle. Rouvrez-le avec la coche, puis épinglez-le de nouveau.
</Accordion>
<Accordion title="Tillor indique : Échec de l'épinglage/désépinglage du commentaire ou Échec de la résolution/annulation de la résolution du commentaire">
La modification n'a pas été appliquée. Rechargez la page et réessayez.
</Accordion>
<Accordion title="Tillor indique : Impossible de créer le PDF">
Réessayez. Si le PDF n'apparaît pas, votre navigateur bloque une fenêtre pop-up. Autorisez les pop-ups pour ce site.
</Accordion>
</Accordions>

## Notions [#begrippen]

- **Commentaire** : un texte interne sur un enregistrement, éventuellement avec des pièces jointes. Voir [commentaire](/begrippen#opmerking).
- **Mention** : un collègue que vous citez avec @. Cette personne reçoit une notification.
- **Épingler** : garder un commentaire en haut de l'enregistrement.
- **Résolu** : un commentaire terminé qui disparaît de la liste ouverte.
- **Origine** : l'enregistrement auquel un commentaire se rapporte.
- **Tâche** : une to-do qui peut découler d'un rappel sur un commentaire. Voir [tâche](/begrippen#taak).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" description="Gérer les profils des clients" />
  <Card title="Factures" href="/facturen" description="Gérer les factures" />
</Cards>


# Parc (/fr-FR/park)

Sous **Parc** se trouve tout ce qui concerne le lieu physique : la carte avec l'occupation du jour, la liste des emplacements, les compteurs et armoires de compteurs, et la météo. Commencez par les [Emplacements](/terreinen), car une occupation, un compteur et un tarif en dépendent tous.

## Que trouve-t-on où ? [#wat-vind-je-waar]

| Menu | À quoi ça sert | Explication |
|---|---|---|
| <UIPath>Parc > Carte</UIPath> | La carte de votre parc, colorée par jour selon l'occupation | [Carte](/kaart) |
| <UIPath>Parc > Emplacements</UIPath> | Tous les emplacements, leur tarif et les compteurs qui s'y trouvent | [Emplacements](/terreinen) |
| <UIPath>Parc > Compteurs</UIPath> | Tous les compteurs d'eau, de gaz et d'électricité | [Gestion des compteurs](/meterbeheer) |
| <UIPath>Parc > Armoires à compteurs</UIPath> | Les armoires où sont installés des compteurs et quels compteurs s'y trouvent | Gérez vos armoires à compteurs et les compteurs qui leur sont attribués |
| <UIPath>Parc > Météo</UIPath> | La météo par jour à l'emplacement de votre parc | [Météo](/weer) |

<DocScreenshot src="/screenshots/park/map-overview.png" alt="Carte du parc avec des emplacements colorés" />

## Armoires à compteurs [#meterkasten]

Sous <UIPath>Parc > Armoires à compteurs</UIPath>, vous gérez les armoires à compteurs et les compteurs qui y sont attribués. Avec **Nouvelle armoire**, vous ajoutez une armoire, avec un nom et une description.

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

L'**emplacement** est le point d'ancrage. Vous y rattachez les compteurs. Un client se retrouve sur un emplacement par une **occupation**, et un hôte pour un court séjour par une **réservation**. La consommation des compteurs de l'emplacement va au client dont l'occupation est active.

```mermaid
flowchart LR
  M[Compteurs] --> T[Emplacement]
  T --> K[Carte]
  B[Occupation<br/>client pour une longue durée] --> T
  R[Réservation<br/>séjour avec dates d'arrivée et de départ] --> T
  T --> V[Tarif et consommation sur la facture]
```

Un emplacement ne reçoit une couleur sur la carte que lorsque vous en avez tracé la limite. Voir [Tracer les limites des emplacements](/kaart#terreingrenzen-intekenen).

<Callout type="info" title="Bon à savoir">
- Un emplacement a au maximum une occupation active à la fois.
- Un nouvel emplacement n'est pas réservable par défaut. Cochez **Réservable** si les clients peuvent le réserver en ligne.
- La superficie ne peut pas être saisie. Tillor la calcule dès que vous tracez l'emplacement sur la carte, et l'utilise pour le tarif.
- La carte s'ouvre toujours sur aujourd'hui. Vos autres réglages de carte (style, étiquettes, calques) sont conservés.
- Les étiquettes avec les nuits et le départ n'apparaissent qu'à partir du niveau de zoom 17,5.
- La météo est récupérée chaque nuit pour le centre de la carte de votre organisation.
</Callout>

## Notions [#begrippen]

- **Emplacement** : une place dans votre parc avec un nom, un tarif et éventuellement des compteurs. Voir [Notions](/begrippen#terrein).
- **Carte** : la carte interactive sous Parc.
- **Armoire à compteurs** : une armoire contenant des compteurs. Voir [Notions](/begrippen#meterkast).
- **Occupation** : un client sur un emplacement pour une période. Voir [Notions](/begrippen#bezetting).
- **Réservable** : un emplacement que les clients peuvent réserver en ligne.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Emplacements" href="/terreinen" description="Créer des emplacements, tarif et compteurs" />
  <Card title="Carte" href="/kaart" description="Carte, calques et limites des emplacements" />
  <Card title="Gestion des compteurs" href="/meterbeheer" />
  <Card title="Météo" href="/weer" />
</Cards>


# Paramètres d'impression (/fr-FR/printer/afdrukinstellingen)

Voici la liste de tous les paramètres de <UIPath>Paramètres > Impression</UIPath>. Les paramètres s'appliquent à l'ensemble de votre organisation. La configuration pas à pas se trouve dans [Configurer les imprimantes](/printer/printers-instellen).

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Paramètres > Impression" />

| Paramètre | Signification |
| ---------- | --------- |
| **Impression PDF** | Active l'impression des factures et documents sur des imprimantes physiques. Sans cela, Tillor n'imprime rien. |
| **Impression auto de la facture au paiement** | Les factures payées partent automatiquement dans la file d'impression. Pour chaque type de paiement, vous choisissez si cela se fait immédiatement, à la prochaine coupure ou pas du tout. |
| **Impression auto de la pièce d'identité à la liaison** | Si vous liez un scan de pièce d'identité à un client ou à un contact (y compris lors de la création d'un client à partir d'un scan), le récapitulatif part en PDF vers l'imprimante A4. Nécessite : **Impression PDF** activée et une **IP imprimante PDF** renseignée. |
| **IP imprimante PDF** | Adresse réseau de l'imprimante A4 pour les factures et documents, par exemple `192.168.1.100`. |
| **IP imprimante thermique** | Adresse réseau de l'imprimante à tickets, par exemple `192.168.1.101`. |
| **Largeur du papier ticket** | Largeur du rouleau de tickets : **80 mm** (par défaut) ou **58 mm**. Tillor adapte à cela la longueur des lignes et le logo du ticket. |
| **IP imprimante étiquettes** | Adresse réseau de l'imprimante d'étiquettes, par exemple `192.168.1.102`. |
| **Horaires de coupure d'impression** | Pour chaque jour de la semaine, un ou plusieurs horaires à la minute près, par exemple 09:00 et 13:30. Vide signifie qu'il n'y a pas de moment de coupure ce jour-là. |
| **Moment d'impression par type de paiement** | Par canal (terminal/comptoir, manuel, en ligne, mandat, virement) : **Imprimer immédiatement**, **Prochaine coupure** ou **Pas d'impression automatique**. Par défaut, le terminal et le manuel impriment immédiatement. En ligne, mandat et virement attendent l'heure de coupure. |
| **Mettre l'impression en pause jusqu'au** | Retient la file d'impression jusqu'au moment choisi. **Effacer la pause** supprime la pause. Vous pouvez aussi mettre en pause depuis la [file d'impression](/printer/printwachtrij). |

Cliquez en bas sur **Enregistrer les paramètres** pour appliquer vos modifications. Elles s'appliquent immédiatement.

<Callout type="info">
Les imprimantes doivent se trouver sur le même réseau que le connecteur et avoir une adresse IP fixe. Donnez à l'imprimante une adresse fixe dans votre routeur, sinon l'adresse peut changer.
</Callout>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Configurer les imprimantes" href="/printer/printers-instellen" description="Les étapes pour commencer" />
  <Card title="Imprimer des documents" href="/printer/documenten-afdrukken" description="Imprimer une facture ou un ticket" />
  <Card title="Connecteur" href="/connector" description="Le programme qui pilote l'imprimante" />
</Cards>


# Imprimer une facture ou un ticket (/fr-FR/printer/documenten-afdrukken)

Vous imprimez une facture depuis la page de la facture, sur l'imprimante A4 ou sur l'imprimante à tickets. Pour les paiements, Tillor peut aussi imprimer lui-même les tickets. Vous pouvez aussi afficher une facture sur la tablette sans l'imprimer.

<Requires permission="Modifier les paramètres" />

Avant de commencer :

- Les imprimantes sont configurées, voir [Configurer les imprimantes](/printer/printers-instellen).
- Un connecteur est actif pour votre organisation. Sans lui, les options **Envoyer vers imprimante A4** et **Envoyer vers imprimante à bons** ne figurent pas dans le menu.

## Imprimer une facture [#een-factuur-afdrukken]

<Steps>
<Step>
### Ouvrez la facture [#open-de-factuur]
Allez à <UIPath>Administration > Factures</UIPath> et ouvrez la facture.
</Step>
<Step>
### Choisissez comment imprimer [#kies-hoe-je-afdrukt]
<Tabs items={["Sur papier via le navigateur", "Vers une imprimante du réseau"]}>
<Tab value="Sur papier via le navigateur">
Cliquez sur **Imprimer**. Votre navigateur ouvre sa propre fenêtre d'impression.
</Tab>
<Tab value="Vers une imprimante du réseau">
Cliquez sur la flèche à côté de **Imprimer** et choisissez **Envoyer vers imprimante A4** ou **Envoyer vers imprimante à bons**. Tillor place une tâche dans la file d'impression.
</Tab>
</Tabs>

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Détail de la facture - actions d'impression et de paiement" />
</Step>
</Steps>

## Tickets après un paiement [#bonnen-na-een-betaling]

Dans <UIPath>Paramètres > Impression</UIPath>, activez **Impression auto de la facture au paiement**. Les factures payées partent alors vers l'imprimante A4 et éventuellement l'imprimante à tickets, immédiatement ou à la prochaine coupure, selon le canal de paiement.

Pour chaque produit, vous pouvez en outre activer **Impression thermique** et **Impression A4** et définir le nombre de copies sur la page du produit. Ces copies sortent en plus dès que ce produit figure sur une facture payée.

## Afficher une facture sur la tablette [#een-factuur-op-de-tablet-tonen]

Vous voulez montrer une facture sans l'imprimer ? Dans le menu des trois points de la facture, choisissez **Aperçu sur iPad**, ou cliquez sur **Aperçu sur iPad** dans la fenêtre de paiement d'un paiement en espèces. Le PDF apparaît sur la tablette liée et Tillor indique **PDF envoyé à l'iPad**. Voir [Tablettes et bornes](/mobiele-app/tablets-en-kiosken).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une tâche envoyée à une imprimante figure dans la [file d'impression](/printer/printwachtrij) avec un statut. Au moment de l'impression, elle part vers l'imprimante.
- Si l'impression échoue, Tillor réessaie automatiquement dans la plupart des cas. Ensuite, la tâche reste sur **Échoué** jusqu'à ce que vous la relanciez ou l'annuliez.
- La facture elle-même ne change pas : imprimer ne comptabilise ni n'envoie rien.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Envoyer vers imprimante A4">
Il n'y a pas de connecteur actif pour votre organisation, ou **Impression PDF** est désactivée. Voir [Configurer les imprimantes](/printer/printers-instellen).
</Accordion>
<Accordion title="Tillor indique Échec de l'impression">
Le message est **L'envoi du document à l'imprimante a échoué.** Ouvrez la [file d'impression](/printer/printwachtrij) pour voir la raison sous **Dernière erreur**, par exemple une imprimante hors ligne ou sans papier.
</Accordion>
<Accordion title="Tillor indique Échec du téléchargement">
Le PDF n'a pas pu être téléchargé. Réessayez.
</Accordion>
<Accordion title="Tillor indique PDF non envoyé">
Le PDF n'a pas pu être envoyé à la tablette. Aucune tablette n'est alors joignable. Ouvrez l'app Tillor sur la tablette et vérifiez si elle est **Connecté** sous <UIPath>Paramètres > Tablettes et bornes</UIPath>.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gérer la file d'impression" href="/printer/printwachtrij" description="Suivre les tâches et les relancer" />
  <Card title="Factures" href="/facturen" description="Gérer et envoyer des factures" />
  <Card title="Produits" href="/producten" description="Définir les copies par produit" />
</Cards>


# Aperçu (/fr-FR/printer)

Avec la liaison d'imprimante, vous imprimez factures, tickets et étiquettes directement depuis Tillor sur une imprimante de votre parc, sans télécharger d'abord le document. Vous configurez les imprimantes une seule fois dans [Configurer les imprimantes](/printer/printers-instellen), puis vous imprimez en un clic ou vous laissez Tillor le faire lors d'un paiement.

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Tillor n'envoie pas une tâche d'impression directement à votre imprimante. La tâche passe d'abord dans la file d'impression. Au moment de l'impression, Tillor la transmet au connecteur, un petit programme sur un ordinateur de votre réseau, qui fait imprimer l'imprimante.

```mermaid
flowchart LR
  A[Vous imprimez une facture ou<br/>un paiement arrive] --> B[File d'impression dans Tillor]
  B -- immédiatement ou au moment d'impression --> C[Connecteur dans votre réseau]
  C --> D[Imprimante]
  B -- échec --> E[Tillor réessaie]
```

C'est pourquoi le connecteur doit être en ligne et l'imprimante joignable sur le même réseau. Sans connecteur actif, vous ne voyez pas les options pour envoyer vers une imprimante. Voir [Connecteur](/connector).

<Callout type="info" title="Bon à savoir">
- Il existe trois types d'imprimantes : une imprimante A4 pour les factures et documents, une imprimante thermique pour les tickets de caisse et une imprimante d'étiquettes.
- La largeur du rouleau de tickets est de 80 mm (par défaut) ou 58 mm.
- Pour une tâche en échec, Tillor réessaie automatiquement après 10 secondes, 5 minutes et 15 minutes. Ensuite, elle passe sur **Échoué**. Si le papier est épuisé ou si l'imprimante est hors ligne, elle passe immédiatement sur **Échoué**.
- Chaque lundi matin, Tillor réessaie une dernière fois toutes les tâches qui sont sur **Échoué**.
- La mise en pause de l'impression est possible pour 15 minutes, 1 heure, 4 heures, 6 heures, 1 jour ou jusqu'à ce que vous la repreniez vous-même.
- Par défaut, les paiements par terminal et les paiements manuels s'impriment immédiatement. Les paiements en ligne, les mandats et les virements attendent le prochain moment d'impression.
</Callout>

## Que voulez-vous faire ? [#wat-wil-je-doen]

<Cards>
  <Card title="Configurer les imprimantes" href="/printer/printers-instellen" description="Saisir les adresses réseau et choisir les moments d'impression" />
  <Card title="Imprimer des documents" href="/printer/documenten-afdrukken" description="Imprimer une facture ou des tickets après paiement" />
  <Card title="Gérer la file d'impression" href="/printer/printwachtrij" description="Mettre en pause, relancer ou annuler des tâches" />
  <Card title="Paramètres d'impression" href="/printer/afdrukinstellingen" description="Tous les paramètres en un coup d'œil" />
</Cards>

## Notions [#begrippen]

- **File d'impression** : la liste des tâches d'impression que Tillor doit encore envoyer.
- **Moment d'impression** : un horaire fixe un jour de la semaine auquel Tillor envoie les tâches regroupées, aussi appelé heure de coupure.
- **Imprimante thermique** : l'imprimante pour les tickets de caisse.
- **Connecteur** : le programme de votre réseau qui pilote l'imprimante. Voir [Connecteur](/connector).
- **Adresse IP** : l'adresse réseau d'une imprimante, par exemple `192.168.1.100`.

Vous trouverez plus d'explications dans la [liste des notions](/begrippen).


# Configurer les imprimantes (/fr-FR/printer/printers-instellen)

Pour que Tillor puisse imprimer, il doit savoir quelles imprimantes vous avez et où elles se trouvent dans votre réseau. Vous le configurez une seule fois pour toute votre organisation. Ensuite, vous pouvez [imprimer des documents](/printer/documenten-afdrukken). Chaque paramètre avec son explication figure dans [Paramètres d'impression](/printer/afdrukinstellingen).

<Requires permission="Modifier les paramètres" />

Avant de commencer :

- Le connecteur tourne sur un ordinateur du même réseau que les imprimantes. Voir [Connecteur](/connector). S'il n'est pas actif, vous ne verrez pas ensuite les options pour envoyer vers une imprimante.
- Vous connaissez l'adresse IP de chaque imprimante, c'est-à-dire l'adresse réseau, par exemple `192.168.1.100`. Donnez à l'imprimante une adresse fixe dans votre routeur, sinon l'adresse peut changer et l'impression s'arrête.

## Ajouter une imprimante [#een-printer-toevoegen]

<Steps>
<Step>
### Ouvrez Impression [#open-afdrukken]
Allez à <UIPath>Paramètres > Impression</UIPath>.

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Paramètres > Impression" />
</Step>
<Step>
### Activez Impression PDF [#zet-pdf-afdrukken-aan]
Sans cet interrupteur, Tillor n'imprime rien.
</Step>
<Step>
### Saisissez les adresses des imprimantes [#vul-de-printeradressen-in]
Sous **Adresses IP des imprimantes**, saisissez l'adresse de l'**IP imprimante PDF** (A4), de l'**IP imprimante thermique** (tickets) et de l'**IP imprimante étiquettes**. Laissez vide ce que vous n'avez pas. Choisissez dans **Largeur du papier ticket** 80 mm ou 58 mm, selon votre rouleau de tickets.
</Step>
<Step>
### Choisissez quand l'impression a lieu [#kies-wanneer-er-afgedrukt-wordt]
Dans **Horaires de coupure d'impression**, saisissez pour chaque jour de la semaine un ou plusieurs horaires (par exemple 09:00 et 13:30). Dans **Moment d'impression par type de paiement**, choisissez pour chaque canal de paiement : **Imprimer immédiatement**, **Prochaine coupure** ou **Pas d'impression automatique**.
</Step>
<Step>
### Cliquez sur Enregistrer les paramètres [#klik-op-instellingen-opslaan]
Les paramètres s'appliquent immédiatement à toute votre organisation.
</Step>
</Steps>

## Impression automatique lors d'un paiement [#automatisch-afdrukken-bij-betaling]

Si vous voulez qu'une facture payée sorte sur papier sans intervention, activez **Impression auto de la facture au paiement**. Pour chaque canal de paiement, vous décidez avec le moment d'impression ci-dessus si cela se fait immédiatement ou à la prochaine coupure.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- À chaque impression, Tillor place une tâche dans la [file d'impression](/printer/printwachtrij), que le connecteur transmet à l'imprimante.
- Les factures payées partent automatiquement vers l'imprimante A4, et éventuellement l'imprimante à tickets, si vous l'avez activé.
- Si vous choisissez pour un canal une heure de coupure, Tillor regroupe les tâches jusqu'à ce moment. S'il n'y a pas de moment d'impression ce jour-là, il n'y a pas de moment de coupure.
- Essayez avec une facture, voir [Imprimer des documents](/printer/documenten-afdrukken).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Envoyer vers imprimante A4 sur une facture">
Les options n'apparaissent que si **Impression PDF** est activée et si un connecteur est actif pour votre organisation. Vérifiez les deux.
</Accordion>
<Accordion title="Tillor indique L'imprimante est hors ligne ou ne répond pas">
L'imprimante est éteinte, n'a pas de connexion réseau ou l'adresse IP n'est plus correcte. Vérifiez l'adresse dans <UIPath>Paramètres > Impression</UIPath> et si le connecteur est en ligne.
</Accordion>
<Accordion title="Tillor indique Plus de papier, de toner ou d'encre">
Réapprovisionnez l'imprimante et relancez la tâche depuis la file d'impression.
</Accordion>
<Accordion title="Tillor indique L'imprimante n'a pas répondu à temps">
Le connecteur n'a reçu aucune réponse de l'imprimante. Vérifiez que le connecteur tourne et que l'imprimante est joignable. Regardez dans la file d'impression si la tâche a été relancée.
</Accordion>
<Accordion title="Les tickets ne sortent pas immédiatement">
Vérifiez dans **Moment d'impression par type de paiement** si ce canal est sur **Prochaine coupure**. Le ticket attend alors l'horaire que vous avez choisi dans **Horaires de coupure d'impression**. Si vous avez mis l'impression en pause, regardez dans la [file d'impression](/printer/printwachtrij).
</Accordion>
<Accordion title="Le ticket ne tient pas sur le papier">
Vérifiez la **Largeur du papier ticket** : 80 mm ou 58 mm.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres d'impression" href="/printer/afdrukinstellingen" description="Tous les paramètres en un coup d'œil" />
  <Card title="Connecteur" href="/connector" description="Le programme qui pilote l'imprimante" />
  <Card title="Gérer la file d'impression" href="/printer/printwachtrij" description="Mettre en pause ou relancer des tâches" />
</Cards>


# Gérer la file d'impression (/fr-FR/printer/printwachtrij)

Dans la file d'impression, vous voyez quelles tâches d'impression attendent, sont en cours ou ont échoué. Vous y mettez l'impression en pause, vous traitez les tâches en attente et vous réglez celles qui n'ont pas abouti. La liste se rafraîchit automatiquement dès qu'une tâche change de statut.

<Requires permission="Modifier les paramètres" />

Avant de commencer : les imprimantes sont configurées, voir [Configurer les imprimantes](/printer/printers-instellen).

## Consulter la file [#de-wachtrij-bekijken]

Allez à <UIPath>Administration > File d'impression</UIPath>. Les listes sont :

- **En attente, planifiées et en cours** : les tâches qui sont encore en traitement. Une tâche avec le statut **Planifié plus tard** attend son horaire **Planifié** et s'imprime ensuite automatiquement, sauf si l'impression est en pause.
- **Échouées** : les tâches qui ont définitivement échoué, avec la raison dans **Dernière erreur**.
- **Toutes les tâches d'impression**.

## Mettre l'impression en pause [#het-afdrukken-pauzeren]

<Steps>
<Step>
### Choisissez Mettre l'impression en pause [#kies-afdrukken-pauzeren]
Cliquez sur **Mettre l'impression en pause** et choisissez une durée : 15 minutes, 1 heure, 4 heures, 6 heures, 1 jour, ou **Jusqu'à réactivation**.

<DocScreenshot src="/screenshots/printer/print-pause-menu.png" alt="Menu avec la durée de la pause" />
</Step>
<Step>
### Reprenez quand vous êtes prêt [#hervat-wanneer-je-klaar-bent]
Cliquez sur **Reprendre l'impression**. Sinon, l'impression reprend automatiquement après la durée choisie.
</Step>
</Steps>

Pendant la pause, les tâches directes comme les tâches planifiées attendent. Les nouvelles tâches restent dans la file. À côté de l'icône de la pause figure la durée jusqu'à laquelle elle court. Vous pouvez aussi régler la pause dans **Mettre l'impression en pause jusqu'au** sous <UIPath>Paramètres > Impression</UIPath>.

## Traiter ou rétablir des tâches [#opdrachten-doorzetten-of-herstellen]

<Tabs items={["Des tâches restent bloquées", "Une tâche a échoué"]}>
<Tab value="Des tâches restent bloquées">
Cliquez dans la barre d'outils de la liste sur **Traiter la file**. Les tâches planifiées sont alors traitées immédiatement. Le bouton est grisé tant que l'impression est en pause, avec l'astuce **Reprenez l'impression pour traiter la file d'attente**.
</Tab>
<Tab value="Une tâche a échoué">
Ouvrez le menu des trois points sur la ligne et choisissez **Réessayer** pour l'envoyer à nouveau, ou **Annuler**. Une tâche annulée reçoit le statut **Annulé** et n'est plus imprimée.
</Tab>
</Tabs>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Pour une tâche en échec, Tillor réessaie lui-même après 10 secondes, puis après 5 minutes et ensuite après 15 minutes. Si cela ne fonctionne toujours pas, elle passe sur **Échoué**.
- Les erreurs qu'une nouvelle tentative ne résout pas ne sont pas relancées par Tillor : papier, toner ou encre épuisé, imprimante hors ligne ou en pause, ou file d'impression désactivée. Elles passent immédiatement sur **Échoué**.
- Chaque lundi matin, Tillor remet en file une dernière fois toutes les tâches qui sont sur **Échoué**.
- Une tâche qui reste sur **Échoué** ne fait rien tant que vous ne la relancez pas ou ne l'annulez pas.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="La tâche est sur Échoué avec L'imprimante est hors ligne ou ne répond pas">
Allumez l'imprimante, vérifiez la connexion réseau et si le connecteur est en ligne. Choisissez ensuite **Réessayer**.
</Accordion>
<Accordion title="La tâche indique Papier, toner ou encre vide">
Réapprovisionnez l'imprimante et choisissez **Réessayer**.
</Accordion>
<Accordion title="La tâche indique L'impression est en pause. Vérifiez le papier, le toner ou l'encre.">
L'imprimante elle-même est en pause, par exemple à cause d'un bourrage papier. Réglez cela sur l'imprimante et réessayez.
</Accordion>
<Accordion title="La tâche indique La tâche d'impression a été perdue ou n'a pas abouti sur l'imprimante">
La tâche a été envoyée à l'imprimante mais n'a pas abouti. Vérifiez si quelque chose est déjà sorti avant de réessayer, sinon vous aurez un doublon.
</Accordion>
<Accordion title="La tâche indique La file d'impression est désactivée">
La file de l'imprimante elle-même est désactivée. Activez-la sur l'imprimante et réessayez.
</Accordion>
<Accordion title="Traiter la file est grisé">
L'impression est en pause. Choisissez **Reprendre l'impression**.
</Accordion>
<Accordion title="Tillor indique Impossible de démarrer le traitement de la file d'impression">
La file n'a pas pu être traitée. Réessayez. Si cela ne fonctionne pas, vérifiez si le connecteur est en ligne.
</Accordion>
<Accordion title="Tillor indique Impossible de réessayer la tâche d'impression">
Réessayez, ou annulez la tâche et réimprimez le document depuis la facture.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Configurer les imprimantes" href="/printer/printers-instellen" description="Adresses réseau et moments d'impression" />
  <Card title="Imprimer une facture ou un ticket" href="/printer/documenten-afdrukken" description="Créer des tâches" />
</Cards>


# Lier des actions à un produit (/fr-FR/producten/acties-instellen)

Avec les actions, vous automatisez ce qui se passe après la comptabilisation ou le paiement d'une facture : recharger un tag NFC, prolonger une occupation, imprimer un ticket ou créer une méthode d'accès. Un produit peut avoir plusieurs actions à la fois.

<Requires permission="Modifier les produits" />

Avant de commencer : le produit existe déjà. Voir [Créer un produit](/producten/product-aanmaken). Un schéma de ce que Tillor fait et quand se trouve sous [Comment tout cela s'articule-t-il ?](/producten#hoe-hangt-dit-samen).

<Steps>
<Step>
### Ouvrez le produit [#open-het-product]

Allez à <UIPath>Administration > Produits</UIPath> et ouvrez le produit.
</Step>
<Step>
### Cochez les actions [#vink-de-acties-aan]

Cherchez à droite la carte **Actions sur la ligne de facture**. Cochez les actions que vous voulez. Pour certaines actions, des champs supplémentaires apparaissent ensuite. Ce que fait chaque action et quels champs s'y rapportent, vous le lisez dans [Actions de produit](/producten/productacties).

Laissez toutes les cases décochées pour un tarif ordinaire sans suivi.
</Step>
<Step>
### Enregistrez [#sla-op]

Cliquez sur **Enregistrer** en bas de la carte **Lignes de facture supplémentaires**. Les actions figurent maintenant sur le produit et sont reprises dans les nouvelles lignes de facture.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Lorsque vous choisissez le produit sur une ligne de facture, Tillor reprend les actions avec les valeurs définies dans cette ligne. Ce qu'une action fait et quand dépend de son type. Certaines actions s'exécutent lors de la comptabilisation de la facture, la plupart lors du paiement.

| Moment | Actions |
|--------|--------|
| À la comptabilisation | **Prolonger l'occupation** (adapte **Facturé jusqu'au**), **Demander les coordonnées** (la comptabilisation n'est possible que si les champs obligatoires sont remplis), création d'une réservation avec **Période** et **Demander un emplacement** |
| Au paiement | **Recharger Tag NFC**, **Période**, **Prolonger l'occupation** (adapte **Payé jusqu'au**), **Prolonger le mode d'accès**, **Créer une méthode d'accès**, **Impression thermique** et **Impression A4** |
| Aucun effet | **Consommation compteur** (détermine le tarif), **Afficher une alerte** (affiche un texte) |
| Bloque la comptabilisation | **Empêcher la comptabilisation** |

Dans la liste des produits, la colonne **Action** montre quelles actions figurent sur un produit.

<Callout type="info">
Une modification des actions d'un produit s'applique aux lignes de facture que vous ajoutez ensuite.
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas le champ que je cherche">
Les champs supplémentaires n'apparaissent qu'après avoir coché l'action correspondante. **Enregistrer l'arrivée à la validation** et **Enregistrer l'arrivée au paiement** n'apparaissent que si **Demander un emplacement** est activé.
</Accordion>
<Accordion title="L'action ne se déclenche pas au paiement">
Vérifiez si l'action est renseignée sur la ligne de facture elle-même. Pour **Créer une méthode d'accès**, par exemple, un type doit être choisi. Sans type, Tillor ne crée rien, et pour une ligne qui n'est pas facultative, vous ne pouvez pas comptabiliser la facture.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Actions de produit" href="/producten/productacties" description="Toutes les actions et leurs paramètres" />
  <Card title="Configurer des lignes de facture supplémentaires" href="/producten/bundel-instellen" />
</Cards>


# Configurer des lignes de facture supplémentaires (/fr-FR/producten/bundel-instellen)

Certains produits sont plus qu'une ligne sur une facture : Staangeld avec suppléments, une explication, la location de compteur ou des tags NFC. Pour cela, vous configurez sur le produit principal un bundle de lignes supplémentaires. Si quelqu'un choisit ce produit comme ligne principale sur une facture brouillon, Tillor ajoute les lignes enfants sous cette ligne principale, dans l'ordre que vous définissez.

```mermaid
flowchart TD
  hoofd[Ligne principale : produit avec bundle] --> stap1[Étape 1 du bundle]
  stap1 --> kind1[Ligne enfant sur la facture]
  hoofd --> stap2[Étape 2 du bundle]
  stap2 --> kind2[Ligne enfant sur la facture]
```

<Requires permission="Modifier les produits" />

## Créer ou modifier un bundle [#een-bundel-aanmaken-of-bewerken]

<Steps>
<Step>
### Ouvrez le produit principal [#open-het-hoofdproduct]

Allez à <UIPath>Administration > Produits</UIPath> et ouvrez le produit, par exemple Staangeld.
</Step>
<Step>
### Démarrez le bundle [#start-de-bundel]

Cherchez la carte **Lignes de facture supplémentaires** sous **Général**. Si le produit n'a pas encore de bundle, cliquez sur **Configurer le bundle**.
</Step>
<Step>
### Ajoutez des étapes [#voeg-stappen-toe]

Cliquez sur **Étape produit** pour une ligne avec un produit et un montant, ou sur **Étape info** pour une ligne avec uniquement du texte. Renseignez les champs de chaque étape. Ce que fait chaque champ figure dans [Étapes de bundle](/producten/bundel-velden).
</Step>
<Step>
### Mettez les étapes dans le bon ordre [#zet-de-stappen-in-de-juiste-volgorde]

Avec les flèches **Monter l'étape** et **Descendre l'étape**, vous déterminez l'ordre sur la facture. **Supprimer l'étape** retire une étape.
</Step>
<Step>
### Enregistrez [#sla-op]

Cliquez sur **Enregistrer** en bas de la carte.
</Step>
</Steps>

<Callout type="info">
**Enregistrer** sous **Lignes de facture supplémentaires** enregistre toute la page du produit, y compris les modifications dans **Général** et **Actions sur la ligne de facture**. Chaque étape produit doit avoir un produit et chaque étape info un texte. Sinon, Tillor ne conserve pas le bundle.
</Callout>

Avec **Supprimer tout le bundle**, vous désactivez le bundle. Un bundle peut avoir 40 étapes au maximum.

## Exemple : un bundle Staangeld [#voorbeeld-een-staangeld-bundel]

Un bundle typique pour Staangeld se compose de cinq étapes. Pour les étapes avec une formule, collez la formule de [Étapes de bundle](/producten/bundel-velden#voorbeelden) dans le champ **Formule**.

<Steps>
<Step>
### Explication [#toelichting]

Une **Étape info** avec le texte « Taxes touristiques, communales et provinciales incluses ».
</Step>
<Step>
### Premier NFC inclus [#eerste-nfc-inbegrepen]

Une **Étape produit** avec le produit de supplément NFC et une formule qui renvoie le premier tag NFC actif du client avec une quantité de 0 et un prix de 0. Activez **Multiplier par la quantité de la ligne principale** et **Une fois par facture**, choisissez **Style de ligne** **INFO** et renseignez dans **Jours supplémentaires après la fin de la ligne principale (méthodes d'accès)** par exemple `20`.
</Step>
<Step>
### Tags NFC supplémentaires [#extra-nfc-tags]

La même étape produit avec une formule qui renvoie le deuxième, le troisième, etc. tag NFC actif au tarif du produit, avec les mêmes options d'échelle et de prolongation. Activez ici aussi **Une fois par facture**.
</Step>
<Step>
### Location de compteur [#meterhuur]

Une **Étape produit** avec le produit de location de compteur et une formule qui choisit dans `{meters}` les compteurs qui comptent, par exemple uniquement les compteurs d'électricité ICY avec supply activé, et qui renvoie une ligne par compteur avec le nom du compteur dans la description.
</Step>
<Step>
### Chiens [#honden]

Une **Étape produit** avec le produit chiens et une formule qui lit le nombre de chiens dans un champ propre du client et renvoie une ligne avec ce nombre, ou aucune ligne s'il n'y a pas de chiens.
</Step>
</Steps>

## Prolonger le NFC via le bundle [#nfc-verlengen-via-de-bundel]

Pour Staangeld avec tags NFC, trois choses vont ensemble :

1. Sur le produit principal figure l'action **Prolonger l'occupation**, et un emplacement est choisi sur la ligne de facture.
2. Dans le bundle figure au moins une étape avec **Jours supplémentaires après la fin de la ligne principale (méthodes d'accès)** renseigné, par exemple les étapes NFC de l'exemple ci-dessus.
3. Sur le produit principal figure l'action **Prolonger le mode d'accès** avec les types, statuts souhaités et éventuellement un jour de fin de semaine et une heure.

Lors du paiement d'une ligne d'une telle étape, Tillor fixe la validité des méthodes d'accès du client à la date de fin de la ligne principale Staangeld plus les jours supplémentaires. Par défaut, elle court jusqu'à 23:59 dans le fuseau horaire de l'organisation, ou jusqu'au jour de la semaine et à l'heure que vous avez définis dans **Prolonger le mode d'accès**. Si la ligne principale n'a pas de date de fin, Tillor ne prolonge rien.

<Callout type="warn" title="Attention">
**Jours supplémentaires après la fin de la ligne principale (méthodes d'accès)** ne fonctionne que si le produit a **Prolonger l'occupation** comme action. Si le message sous le champ indique que c'est nécessaire, cochez à droite dans **Actions sur la ligne de facture** **Prolonger l'occupation**.
</Callout>

## Que se passe-t-il sur une facture brouillon ? [#wat-gebeurt-er-op-een-conceptfactuur]

- Les lignes enfants n'apparaissent sous la ligne principale qu'après avoir choisi un emplacement dans **Prolonger l'occupation**.
- Tillor reconstruit les lignes enfants si vous modifiez sur la ligne principale le produit, la quantité ou l'emplacement. Dans les autres cas, les lignes enfants modifiées manuellement restent en place. Si vous supprimez par exemple une ligne de compteur, elle ne revient pas toute seule.
- Dans l'éditeur de facture, vous voyez un aperçu des lignes enfants, y compris l'effet de **Une fois par facture**, afin que cela corresponde à ce qui figurera après l'enregistrement.
- Vous déplacez une ligne principale avec les flèches uniquement comme un bloc entier. Les lignes enfants ne se déplacent qu'au sein de leur bundle. Si vous supprimez la ligne principale, les lignes enfants disparaissent avec elle.
- Sur le PDF, les lignes enfants ordinaires reçoivent souvent un **↳** devant la description. Les lignes info apparaissent comme des lignes grises sans montants.
- Tillor ignore les étapes sans produit choisi. Un produit qui a entre-temps été supprimé ou qui manque ne produit donc aucune ligne.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Les lignes enfants n'apparaissent pas sous la ligne principale">
Pour un produit principal avec **Prolonger l'occupation**, vous devez d'abord choisir un emplacement sur la ligne principale. Pour la prolongation NFC au paiement, la ligne principale a en outre besoin d'une date de fin.
</Accordion>
<Accordion title="Le même supplément figure deux fois sur la facture">
Si une facture contient deux lignes principales ou plus avec un bundle, chaque ligne principale reçoit les lignes du bundle. Activez **Une fois par facture** pour les étapes qui ne doivent apparaître qu'une fois. L'étape n'appartient alors qu'à la première ligne principale dans l'ordre de la facture.
</Accordion>
<Accordion title="Le bundle n'est pas conservé">
Vérifiez si chaque étape produit a un **Produit** et chaque étape info un **Texte de la ligne info**.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Étapes de bundle" href="/producten/bundel-velden" description="Champs, clés dynamiques et placeholders" />
  <Card title="JSON du bundle" href="/producten/bundel-json" />
  <Card title="Actions de produit" href="/producten/productacties" />
</Cards>


# JSON de bundle (/fr-FR/producten/bundel-json)

La carte **Lignes de facture supplémentaires** enregistre un bundle sous forme de JSON sur le produit, sous la clé `invoiceBundle`. Pour les imports, vous utilisez la même structure. Pour un usage normal, vous n'avez pas besoin de cette page : les champs et leur explication se trouvent sous [Étapes du bundle](/producten/bundel-velden).

## Structure [#structuur]

| Champ | Signification |
|------|-----------|
| `invoiceBundle.version` | Toujours `1` |
| `invoiceBundle.steps` | Liste d'étapes, 40 au maximum. L'ordre est celui des lignes enfants sur la facture |

Chaque étape est une étape de produit ou une étape d'information.

### Étape de produit [#productstap]

| Champ | Signification |
|------|-----------|
| `productId` | Un produit existant de votre organisation. Obligatoire |
| `quantity` | Nombre supérieur à 0, `1` par défaut. La quantité de la ligne sans formule, ou lorsque la formule renvoie `true` |
| `quantityScale` | Facultatif. `"anchor_line_quantity"` multiplie chaque quantité calculée par la quantité de la ligne principale |
| `description` | Facultatif. Texte de la ligne de facture à la place du nom du produit ; une formule peut fournir un `description` propre à chaque ligne |
| `style` | Facultatif. `DEFAULT` ou `INFO` |
| `billOncePerInvoice` | Facultatif. `true` rattache l'étape à la première ligne principale lorsqu'une facture en compte plusieurs |
| `extendAccessMethod` | Facultatif. `{ "daysAfterPeriodEnd": <nombre entier, 0 à 3660> }`, voir [Prolongation NFC](#nfc-verlenging) |
| `formula` | Facultatif. TypeScript qui détermine les lignes que l'étape produit, voir [Formule](#formule) |

### Étape d'information [#inforestap]

```json
{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}
```

`description` est obligatoire et une étape d'information n'a pas de `productId`. Avec `style` (`DEFAULT` ou `INFO`), vous choisissez le style de ligne, `INFO` par défaut. Une `formula` qui renvoie `false` supprime la ligne d'information.

## Formule [#formule]

`formula` est du TypeScript qui, lors de l'enregistrement d'une facture, renvoie `true` (une ligne avec `quantity`), `false` (aucune ligne), un nombre (la quantité) ou une liste de lignes `{ "quantity", "description", "unitPrice", "accessMethodValue" }`. Les champs et listes que vous pouvez lire et ce que fait chaque forme sont décrits sous [Formule par étape](/producten/bundel-velden#formule-per-stap). Une formule qui ne compile pas est refusée lors de l'enregistrement du produit. En JSON, la formule est une seule chaîne avec `\n` pour les sauts de ligne.

```json
"formula": "return {customer.customFields.exemptFromSurcharges} !== true;"
```

## Prolongation NFC [#nfc-verlenging]

N'a de sens que si le produit principal a **Prolonger l'occupation** comme action.

```json
"extendAccessMethod": { "daysAfterPeriodEnd": 20 }
```

Lorsqu'une ligne d'une telle étape est payée, Tillor fixe la validité des méthodes d'accès du client à la date de fin de la ligne principale plus `daysAfterPeriodEnd` jours calendaires. Par défaut, cette validité court jusqu'à 23:59 dans le fuseau horaire de l'organisation, ou jusqu'au jour de la semaine et à l'heure de **Prolonger le mode d'accès** sur le produit principal. Vous y réglez aussi les types et les statuts pris en compte. Sans date de fin sur la ligne principale, il ne se passe rien. Avec **Ne pas raccourcir lors de la prolongation** activé, Tillor ignore les méthodes dont la validité est déjà égale ou postérieure à la nouvelle date. Un `accessMethodValue` sur la ligne désigne la méthode de cette ligne ; la prolongation elle-même suit les réglages du produit principal.

Après une prolongation réussie, la chronologie de la facture affiche une ligne qui renvoie au paiement.

## Exemple : explication, supplément NFC, location de compteur et chiens [#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="Attention">
Vérifiez que toutes les valeurs `productId` des étapes de produit existent dans votre catalogue. Tillor ignore les étapes dont le produit est inconnu.
</Callout>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Étapes du bundle" href="/producten/bundel-velden" />
  <Card title="Configurer des lignes de facture supplémentaires" href="/producten/bundel-instellen" />
</Cards>


# Étapes du bundle (/fr-FR/producten/bundel-velden)

Cette page décrit les champs de la carte **Lignes de facture supplémentaires** sur la page du produit. La manière de construire un bundle est expliquée dans [Configurer des lignes de facture supplémentaires](/producten/bundel-instellen).

## Étape de produit [#productstap]

Tillor transforme une étape de produit en zéro, une ou plusieurs lignes de facture avec ce produit. Sans formule, il s'agit d'une seule ligne avec la quantité définie ; avec une [formule](#formule-per-stap), vous déterminez vous-même si des lignes sont créées, combien et lesquelles.

| Champ | Ce qu'il fait |
|------|--------------|
| **Produit** | Le produit qui figure sur la ligne enfant, par exemple un supplément NFC ou une location de compteur. Obligatoire |
| **Quantité** | La quantité de la ligne si l'étape n'a pas de formule, ou si la formule renvoie `true`. Supérieure à 0 |
| **Multiplier par la quantité de la ligne principale** | Multiplie chaque quantité calculée par la quantité de la ligne principale, par exemple 0,5 pour un demi-an de Loyer d'emplacement. Le résultat est arrondi à deux décimales. Tillor supprime les lignes qui tombent ainsi à 0 ; une ligne que la formule renvoie elle-même avec la quantité 0 est conservée |
| **Description (optionnel)** | Remplace le nom du produit sur la ligne de facture. Une formule qui renvoie des lignes peut donner à chaque ligne sa propre description |
| **Style de ligne** | **Par défaut (produit)**, **DEFAULT** ou **INFO**. Avec **INFO**, la ligne enfant devient une note grise dans le PDF et dans l'éditeur |
| **Une fois par facture** | Pertinent uniquement si la même facture contient deux lignes principales ou plus avec un bundle. L'étape n'appartient alors qu'à la première ligne principale dans l'ordre de la facture |
| **Jours supplémentaires après la fin de la ligne principale (méthodes d'accès)** | N'a de sens que si le produit principal a **Prolonger l'occupation** comme action. Lorsqu'une ligne de cette étape est payée, Tillor prolonge les méthodes d'accès du client jusqu'à la date de fin de la ligne principale plus ce nombre de jours ; les types et les statuts viennent de **Prolonger le mode d'accès** sur le produit principal, voir [Prolonger le NFC via le bundle](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) |
| **Formule** | Facultatif. TypeScript qui détermine si l'étape figure sur la facture, avec quelle quantité, ou quelles lignes précisément, voir [Formule par étape](#formule-per-stap) |

## Étape d'information [#inforestap]

Une étape d'information n'est que du texte, sans produit ni montant. Tillor l'affiche comme ligne d'explication.

| Champ | Ce qu'il fait |
|------|--------------|
| **Texte de la ligne info** | Le texte visible, par exemple « Inclusief toeristen-, gemeente- en provincietaksen ». Obligatoire |
| **Style de ligne** | **INFO** par défaut. Vous pouvez choisir **DEFAULT** si vous voulez afficher la ligne comme une ligne ordinaire |
| **Formule** | Facultatif. Si la formule renvoie `false`, la ligne d'information est omise |

Lorsqu'une étape d'information se trouve sous une ligne principale, le PDF place automatiquement **↳** devant le texte.

## Formule par étape [#formule-per-stap]

Chaque étape peut avoir une **Formule** : du TypeScript, comme la [formule de tarif](/terreinen#tariefformule), que Tillor exécute lors de l'enregistrement d'une facture contenant ce bundle. Ainsi, une étape dépend du client, de l'occupation, du terrain, des compteurs ou des méthodes d'accès, par exemple via un [champ personnalisé](/eigen-velden) dans lequel vous notez une exception.

### Ce que la formule renvoie [#wat-de-formule-teruggeeft]

| Valeur renvoyée | Effet |
|---------------------|--------|
| `true` | Une ligne avec la **Quantité** définie |
| `false` ou `null` | Aucune ligne |
| Un nombre supérieur à 0 | Une ligne avec ce nombre comme quantité |
| Une liste de lignes | Exactement ces lignes, dans cet ordre. Une liste vide signifie aucune ligne |

Une ligne d'une telle liste est un objet avec ces champs :

| Champ | Signification |
|-------|-----------|
| `quantity` | Obligatoire. La quantité, 0 ou plus. Une ligne à 0 est conservée, même avec **Multiplier par la quantité de la ligne principale** |
| `description` | Facultatif. La description de cette ligne ; sinon la **Description** de l'étape, sinon le nom du produit |
| `unitPrice` | Facultatif. Prix unitaire TVA incluse, comme le tarif du produit ; sinon le tarif du produit. `0` crée une ligne gratuite |
| `accessMethodValue` | Facultatif. La valeur de la méthode d'accès concernée par cette ligne (l'UID du badge NFC), pour la prolongation lors du paiement |

### Ce que la formule peut lire [#wat-de-formule-kan-lezen]

Vous lisez les champs avec des accolades, comme dans les automatisations. Le menu **Variable** à côté du champ affiche tout ce qui est disponible, y compris vos propres champs.

| Variable | De quoi il s'agit |
|-----------|------------|
| `{customer.…}` | Le client de la facture, par exemple `{customer.createdAt}` ou `{customer.customFields.meterhuurVrijgesteld}` |
| `{occupation.…}` | L'occupation de la ligne principale. Si le produit principal n'est pas sur **Prolonger l'occupation**, l'unique occupation du client ; vide (`null`) si le client occupe plusieurs terrains |
| `{terrain.…}` | Le terrain de cette occupation |
| `{anchor.…}` | La ligne principale : `{anchor.quantity}` (par exemple 0,5 pour un demi-an), `{anchor.terrainId}`, `{anchor.occupationId}` et `{anchor.endDate}` |
| `{meters}` | La liste des compteurs concernés : sur le terrain de la ligne principale avec **Prolonger l'occupation**, sinon sur tous les terrains que le client occupe. Chaque compteur a `name`, `provider` (par exemple `ICY`), `type` (par exemple `ELECTRICITY`, `GAS`), les métadonnées de son fournisseur (par exemple `icyMetadata.switchState` pour l'alimentation activée), son `terrain` et `customFields` |
| `{accessMethods}` | La liste des méthodes d'accès du client, les plus anciennes d'abord, de chaque type et de chaque statut. Chaque méthode a `type` (par exemple `NFC`), `status` (par exemple `ACTIVE`), `value`, un `label` lisible (le nom connu du badge NFC, sinon la valeur) et `customFields` |

Tillor ne charge les listes `{meters}` et `{accessMethods}` que si la formule les utilise.

### Exemples [#voorbeelden]

Ignorer une étape pour les clients exemptés :

```ts
if ({customer.customFields.exemptFromSurcharges} === true) return false;
return true;
```

Une ligne par compteur d'électricité ICY avec alimentation activée, et pour les clients depuis 2026 aussi avec alimentation coupée :

```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}` }));
```

Le premier badge NFC gratuit comme explication, chacun des suivants au tarif du produit (deux étapes avec le même produit, ou une seule étape qui renvoie les deux sortes de lignes) :

```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}`,
}));
```

Une ligne avec le nombre de chiens tiré d'un champ personnalisé du client, aucune ligne sans chien :

```ts
const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));
return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];
```

Avec **Insérer un exemple** sous le champ, vous obtenez un point de départ contenant ces formes en commentaire.

### Erreurs [#fouten]

Vous ne pouvez pas enregistrer une formule qui ne compile pas ; le message sous le champ indique ce qui ne va pas. Si une formule se bloque lors de l'enregistrement d'une facture, ou renvoie autre chose que `true`, `false`, un nombre ou des lignes valides, l'enregistrement échoue avec le nom de l'étape dans le message d'erreur, afin qu'une formule défectueuse n'ajoute ou ne supprime jamais une ligne en silence.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Configurer des lignes de facture supplémentaires" href="/producten/bundel-instellen" />
  <Card title="JSON de bundle" href="/producten/bundel-json" />
  <Card title="Gestion des compteurs" href="/meterbeheer" />
</Cards>


# Aperçu (/fr-FR/producten)

Un produit est un tarif ou un service que vous placez sur une ligne de facture : une nuit sur un terrain, un abonnement mensuel, un badge NFC ou un kWh d'électricité. Chaque produit a un prix TVA incluse. Vous pouvez aussi y associer des actions que Tillor exécute automatiquement, comme prolonger une occupation ou imprimer un ticket. Les utilisateurs disposant du droit **Modifier les produits** peuvent créer et modifier des produits.

Vous trouvez tous les produits via <UIPath>Administration > Produits</UIPath>.

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Liste des produits avec un produit de démonstration pour une nuit" />

<Callout type="info" title="Bon à savoir">
- Le prix est toujours TVA incluse. Vous choisissez 0 %, 6 %, 9 %, 12 % ou 21 %.
- Une modification du prix, du grand livre ou des actions s'applique aux lignes que vous ajoutez ensuite. Les factures existantes ne changent pas.
- Vous pouvez planifier un nouveau prix à partir d'aujourd'hui ou d'un jour ultérieur, pas pour le passé.
- Un produit désactivé ne peut plus être choisi sur les factures, mais reste sur les factures existantes.
- Un produit supprimé ne peut pas être récupéré. Désactivez-le plutôt.
- Pour chaque combinaison de type de client et de type de compteur, il n'existe qu'un seul produit avec l'action **Consommation compteur**.
- Le texte de **Afficher une alerte** peut contenir 4000 caractères au maximum.
- Par imprimante, vous réglez 10 copies au maximum pour l'impression automatique.
- Pour **Prolonger le mode d'accès**, vous comptez 3660 jours au maximum après la date de fin.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Un produit ne fait rien tant qu'il ne figure pas sur une facture. Si le produit a des actions, Tillor les reprend sur la ligne de facture. La comptabilisation et le paiement déclenchent ces actions, et le résultat arrive ainsi à l'occupation, au badge ou à l'imprimante.

```mermaid
flowchart TD
  P[Produit avec actions] --> R[Ligne de facture sur une facture brouillon]
  R -- Comptabiliser --> G[Facture comptabilisée]
  G --> G1[Occupation : Facturé jusqu'au avance]
  G --> G2[Réservation créée avec Demander un emplacement]
  G --> G3[Comptabilisation bloquée ou coordonnées demandées]
  G -- Payer --> B[Facture payée]
  B --> B1[Occupation : Payé jusqu'au avance]
  B --> B2[Badge NFC rechargé]
  B --> B3[Méthode d'accès créée ou prolongée]
  B --> B4[Ticket ou A4 imprimé]
```

Un exemple avec **Prolonger l'occupation** : vous facturez le loyer mensuel d'un client. Lors de la comptabilisation, l'occupation est facturée jusqu'à la fin du mois. Dès que le client paie, **Payé jusqu'au** avance aussi. Vous voyez ainsi sur l'occupation ce qui est déjà facturé et ce qui est déjà payé. Vous en saurez plus sous [Occupations](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).

Une facture de crédit annule cela : la comptabilisation remet **Facturé jusqu'au** au début de la ligne, le paiement remet **Payé jusqu'au** en arrière. Voir [Virement interne](/betalingsverwerking/interne-overboeking) pour le cas où une facture de crédit est seulement compensée avec la facture d'origine.

## Ce que vous voyez dans la liste [#wat-je-in-de-lijst-ziet]

| Colonne | Contenu |
|-------|--------|
| **Nom** et **Description** | Nom et explication tels que vous les avez saisis dans le produit |
| **Info** | Type de client et type de compteur, uniquement pour les produits avec l'action **Consommation compteur** |
| **Action** | Les actions du produit. S'il y en a plusieurs, la colonne affiche un résumé |
| **Prix (TTC)** | Prix par unité |
| **TVA %** | Le taux de TVA |
| **Grand livre** | Le numéro de compte du grand livre, si vous l'avez renseigné |

Dans la ligne, vous trouvez une icône de crayon pour ouvrir le produit et une icône de corbeille pour le supprimer. Les deux sont désactivées si vous n'avez pas le droit **Modifier les produits**.

### Rechercher et filtrer [#zoeken-en-filteren]

Tapez dans la barre de recherche pour filtrer la liste instantanément. Vous pouvez aussi filtrer par **TVA**, **Type de client**, **Type de compteur**, **Type d'action**, **Statut** (<Status tone="success">Actif</Status> ou <Status>Désactivé</Status>) et **Comptes**. Avec **Réinitialiser**, vous effacez tous les filtres d'un coup.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Créer un produit" href="/producten/product-aanmaken" description="Définir le nom, le prix, la TVA et le grand livre" />
  <Card title="Modifier ou supprimer un produit" href="/producten/product-bewerken" description="Modifier les données, désactiver ou supprimer" />
  <Card title="Planifier un changement de prix" href="/producten/prijzen-plannen" description="Un nouveau prix à partir d'une date et le calculateur de TVA" />
  <Card title="Associer des actions à un produit" href="/producten/acties-instellen" description="Faites faire quelque chose à Tillor lors de la comptabilisation ou du paiement" />
  <Card title="Actions de produit" href="/producten/productacties" description="Toutes les actions et leurs réglages" />
  <Card title="Configurer des lignes de facture supplémentaires" href="/producten/bundel-instellen" description="Placer automatiquement des suppléments et des explications sous une ligne principale" />
  <Card title="Étapes du bundle" href="/producten/bundel-velden" description="Champs, clés dynamiques et placeholders" />
  <Card title="JSON de bundle" href="/producten/bundel-json" description="La structure du bundle pour les imports" />
  <Card title="Exemples pratiques" href="/praktijk" description="Exemples détaillés tirés de la pratique" />
</Cards>

## Glossaire [#begrippen]

- **Produit** : un prix et une description qui peuvent figurer sur une ligne de facture.
- **Action** : quelque chose que Tillor fait automatiquement lorsqu'une ligne de facture avec ce produit est comptabilisée ou payée.
- **Bundle** : une série de lignes de facture supplémentaires que Tillor place sous une ligne principale, par exemple des suppléments pour la Loyer d'emplacement.
- **Ligne principale et ligne enfant** : la ligne principale est la ligne avec le produit du bundle, les lignes enfants sont celles que Tillor ajoute en dessous.
- **Facturé jusqu'au** et **Payé jusqu'au** : jusqu'à quand une occupation est facturée, respectivement payée. Voir [Occupation](/begrippen#bezetting).
- **Grand livre** : le numéro de compte de votre comptabilité sur lequel un produit comptabilise.


# Planifier un changement de prix (/fr-FR/producten/prijzen-plannen)

Si le prix d'un produit change à partir d'un certain jour, vous le planifiez à l'avance. Ce jour-là, Tillor modifie lui-même le prix du produit. Les factures existantes conservent leurs prix.

<Requires permission="Modifier les produits" />

## Planifier un prix [#een-prijs-plannen]

<Steps>
<Step>
### Ouvrez le produit [#open-het-product]
Allez dans <UIPath>Administration > Produits</UIPath> et ouvrez le produit. En bas de la page se trouve la carte **Prix planifiés**.

<DocScreenshot src="/screenshots/producten/product-price-changes.png" alt="Carte Prix planifiés avec un prix planifié et un prix appliqué" />
</Step>
<Step>
### Choisissez la date [#kies-de-datum]
Choisissez sous **À partir du** le jour où le nouveau prix entre en vigueur. Aujourd'hui est possible, un jour dans le passé non.
</Step>
<Step>
### Saisissez le prix [#vul-de-prijs-in]
Tapez le **Nouveau prix (TVA incl.)**. Sous **Taux de TVA**, laissez **Taux de TVA actuel** ou choisissez un autre taux qui s'applique à partir de ce jour. Vous pouvez aussi y choisir un [régime sans TVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), comme **Autoliquidation (services UE)** ; le produit est alors à 0 % sous ce régime à partir de ce jour.
</Step>
<Step>
### Planifiez le prix [#plan-de-prijs]
Cliquez sur **Planifier le prix**. Le prix apparaît dans la liste avec le statut <Status tone="info">Planifié</Status>.
</Step>
</Steps>

Si vous choisissez aujourd'hui comme date, le nouveau prix s'applique immédiatement. Pour une date ultérieure, le prix s'applique dès le début de ce jour. Tillor tient compte pour cela du fuseau horaire de votre organisation.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

Le produit reçoit le nouveau prix, et éventuellement le nouveau taux de TVA. La ligne dans la liste reçoit le statut <Status tone="success">Appliqué</Status>. Tillor envoie un e-mail à l'adresse d'assistance de votre organisation, ou à l'adresse e-mail générale si elle est absente. La notification s'intitule **Prix de produit planifié appliqué** et affiche l'ancien et le nouveau prix. Voir aussi [Notifications](/notificaties).

Les factures qui existent déjà ne changent pas. Seules les lignes que vous ajoutez ensuite reçoivent le nouveau prix.

## Modifier ou supprimer un prix planifié [#een-geplande-prijs-wijzigen-of-verwijderen]

- Si vous planifiez à nouveau un prix pour le même jour alors qu'un prix planifié existe encore, le nouveau remplace l'ancien.
- Cliquez sur l'icône de corbeille à côté d'un prix planifié et confirmez avec **Supprimer le prix planifié**. Le produit conserve à cette date son prix actuel.
- Un prix avec le statut <Status tone="success">Appliqué</Status> reste affiché comme historique et vous ne pouvez pas le supprimer.

## Le calculateur de TVA [#de-btw-calculator]

À côté du champ de prix, aussi bien pour **Nouveau prix (TVA incl.)** que pour **Prix (TTC)** dans **Général**, se trouve une petite calculatrice. Elle ouvre le **Calculateur de TVA**.

<DocScreenshot src="/screenshots/producten/product-vat-calculator.png" alt="Calculateur de TVA avec taux de TVA, montant HT et TTC et modification du prix en pourcentage" />

Dans le calculateur, vous pouvez :

- saisir le montant **HT** ou **TTC**. L'autre montant et la TVA sont calculés immédiatement.
- choisir un autre **Taux de TVA**. Le prix TTC est alors recalculé à partir du montant HT.
- saisir sous **Modifier le prix de %** un pourcentage, par exemple 5 pour cinq pour cent en plus ou -5 pour cinq pour cent en moins, et cliquer sur **Appliquer**.

Cliquez sur **Utiliser ce prix** pour placer le prix et le taux de TVA dans le formulaire. Vous devez ensuite encore enregistrer ou planifier le prix.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas choisir de date dans le passé">
Un prix ne peut s'appliquer qu'à partir d'aujourd'hui ou plus tard. Si vous voulez modifier un prix rétroactivement, vous modifiez les factures elles-mêmes.
</Accordion>
<Accordion title="Planifier le prix est grisé">
Vous avez besoin pour cela du droit **Modifier les produits**.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Modifier ou supprimer un produit" href="/producten/product-bewerken" />
  <Card title="Notifications" href="/notificaties" />
</Cards>


# Créer un produit (/fr-FR/producten/product-aanmaken)

Un nouveau produit est immédiatement disponible sur les factures. Vous configurez ensuite les actions et les lignes de facture supplémentaires sur la page du produit.

<Requires permission="Modifier les produits" />

<Steps>
<Step>
### Ouvrez la boîte de dialogue [#open-het-dialoogvenster]

Allez dans <UIPath>Administration > Produits</UIPath> et cliquez en haut à droite sur **Nouveau Produit**.
</Step>
<Step>
### Remplissez les données de base [#vul-de-basisgegevens-in]

<DocScreenshot src="/screenshots/producten/product-create-dialog.png" alt="Boîte de dialogue Créer un produit avec les champs de base" />

| Champ | Ce que vous saisissez |
|------|---------------|
| **Nom** (obligatoire) | Le nom tel qu'il apparaît sur les factures |
| **Description** | Une courte explication (facultatif) |
| **Prix (TTC)** | Le montant par unité, TVA incluse |
| **TVA %** | Choisissez parmi 0 %, 6 %, 9 %, 12 % ou 21 %, ou un régime sans TVA comme **Autoliquidation (services UE)**. Voir [Autoliquidation et autres régimes](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) |
| **Grand livre** | Le numéro de grand livre pour votre comptabilité (facultatif) |
| **Surveiller le solde du client sur ce compte** | Pour les cautions : refuse les factures qui feraient passer le solde du client sous zéro. Voir [Surveiller le solde du client](#het-saldo-van-de-klant-bewaken) |
</Step>
<Step>
### Créez le produit [#maak-het-product-aan]

Cliquez sur **Créer**. Tillor ouvre la page du produit, où vous pouvez ajouter des actions et des lignes de facture supplémentaires.
</Step>
</Steps>

<Callout type="info">
Le prix est toujours TVA incluse. Tillor calcule le montant de la TVA avec le pourcentage choisi et l'affiche séparément sur la facture.
</Callout>

## Numéro de grand livre [#grootboeknummer]

Avec le numéro de grand livre, vous associez un produit à un compte de votre comptabilité. Le numéro est utilisé lors de l'export vers le logiciel de comptabilité. Laissez le champ vide si vous ne voulez pas associer le produit à un compte propre.

Une modification du numéro de grand livre s'applique aux nouvelles lignes de facture. Les factures comptabilisées ne changent pas.

## Surveiller le solde du client [#het-saldo-van-de-klant-bewaken]

Pour les cautions, cochez **Surveiller le solde du client sur ce compte**. Tillor additionne alors, par client, toutes les lignes de facture comptabilisées sur ce grand livre, et refuse toute facture qui ferait passer ce solde sous zéro. Vous ne pouvez ainsi pas rembourser une caution deux fois par erreur. Cette option nécessite un numéro de grand livre.

Sur la facture, vous voyez sous la ligne le solde du client sur ce grand livre, et ce qu'il devient après cette facture. Les brouillons ne comptent pas. Il n'est pas non plus possible de remettre une facture de caution comptabilisée en brouillon ou de la déplacer vers un autre client si le solde passait ainsi sous zéro.

Sur l'onglet **Facturation** d'un client, sous **Factures**, se trouve le tableau **Comptes** : chaque grand livre sur lequel quelque chose a été comptabilisé pour ce client ou sur lequel figure un [solde d'ouverture](#beginsaldi-van-voor-tillor), avec le solde. Un compte dont le solde net est nul reste aussi visible. Un grand livre surveillé sur lequel le client n'a encore rien comptabilisé n'y figure pas.

Si au moins un produit surveille un grand livre, le filtre **Protection** est par défaut sur **Activé** et vous ne voyez que les grands livres surveillés. Effacez le filtre pour voir aussi les autres comptes, comme vos comptes de chiffre d'affaires. Sans produits surveillés, le filtre est désactivé et vous voyez directement tous les comptes. Avec le filtre **Solde**, vous ne gardez que les comptes dont le solde n'est pas nul. Un petit bouclier à côté du numéro indique quels comptes sont surveillés.

Déployez un compte et vous voyez les factures comptabilisées avec une ligne sur ce grand livre, de la plus ancienne à la plus récente, avec le montant et le **Solde courant** : le solde après cette facture. S'il y a plus de 100 factures sur le compte, vous voyez les 100 dernières. Le solde courant tient bien compte des factures plus anciennes.

Avec le droit **Outrepasser le solde du compte**, vous pouvez quand même comptabiliser. Vous indiquez alors une justification, qui figure dans la chronologie de la facture. Sans ce droit, **Comptabiliser** reste grisé tant que le solde passerait sous zéro.

<Requires permission="Outrepasser le solde du compte" />

## Soldes d'ouverture d'avant Tillor [#beginsaldi-van-voor-tillor]

Une caution que le client a payée avant que vous ne commenciez avec Tillor ne figure pas sur une facture dans Tillor. Enregistrez un tel montant comme **solde d'ouverture** sur le compte du client. Il compte dans le solde et dans la surveillance, vous remboursez donc cette caution plus tard normalement, sans justification. Un solde d'ouverture n'est pas une facture : il n'a ni numéro ni TVA, et il ne va pas vers votre comptabilité, car votre ancienne comptabilité l'a déjà.

**Un client :** ouvrez le client, onglet **Facturation**, carte **Comptes**, et cliquez sur **Solde d'ouverture**. Renseignez le compte (par ex. 428002), le montant, la date de l'ancien solde et une référence, par exemple la pièce de votre ancien système. Un montant négatif est un montant que le client doit encore. Déployez le compte et vous voyez le solde d'ouverture en haut du solde courant, avec des boutons pour le modifier ou le supprimer. Sous le solde figure la part qui provient du solde d'ouverture.

**Tous les clients en une fois :** allez dans <UIPath>Administration > Factures</UIPath> et cliquez sur **Importer des soldes d'ouverture**. Collez les lignes d'une feuille de calcul ou choisissez un fichier CSV, avec une ligne d'en-tête et les colonnes client (le numéro de client Tillor), compte, montant, date, référence et éventuellement note. Cliquez sur **Vérifier** : vous voyez quelles lignes sont nouvelles, lesquelles Tillor met à jour et quels clients n'ont pas été trouvés, ainsi que le total par compte. Comparez ce total avec le bilan de votre ancienne comptabilité, puis cliquez sur **Importer**. Une ligne avec une référence que le client a déjà sur ce compte met à jour ce solde d'ouverture au lieu de l'ajouter en double, vous pouvez donc refaire un import sans souci.

Un solde d'ouverture déjà remboursé ne peut normalement plus être supprimé ni réduit : le solde passerait sous zéro. Si vous avez le droit **Outrepasser le solde du compte**, Tillor demande dans ce cas une justification et effectue quand même la modification, par exemple pour retirer un ancien solde d'ouverture fusionné d'un client qui a déjà reçu sa caution dans Tillor. Cela vaut aussi pour un import qui fait passer un solde sous zéro. Chaque modification figure dans la chronologie du client, avec votre justification si vous avez outrepassé la surveillance.

<Requires permission="Gérer les soldes d'ouverture" />

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le produit figure immédiatement dans la liste et vous pouvez le choisir sur les factures brouillon.
- Sur la page du produit, vous configurez ensuite les [actions](/producten/acties-instellen), les [lignes de facture supplémentaires](/producten/bundel-instellen) et les [prix planifiés](/producten/prijzen-plannen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas créer ni modifier de produit">
Créer et modifier demande le droit **Modifier les produits**. Demandez à un administrateur de votre organisation d'ajouter ce droit à votre rôle.
</Accordion>
<Accordion title="Il me manque un taux de TVA">
Vous ne pouvez choisir que parmi 0 %, 6 %, 9 %, 12 % et 21 %. Vous ne pouvez pas définir d'autres taux.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Modifier ou supprimer un produit" href="/producten/product-bewerken" />
  <Card title="Associer des actions à un produit" href="/producten/acties-instellen" />
  <Card title="TVA et impôts" href="/boekhouden/belasting" />
</Cards>


# Modifier ou supprimer un produit (/fr-FR/producten/product-bewerken)

Sur la page du produit, vous modifiez tout ce qui concerne un produit. Les modifications s'appliquent aux nouvelles lignes de facture.

<Requires permission="Modifier les produits" />

## Modifier un produit [#een-product-bewerken]

<Steps>
<Step>
### Ouvrez le produit [#open-het-product]

Allez dans <UIPath>Administration > Produits</UIPath> et cliquez sur le nom du produit ou sur l'icône de crayon dans la ligne.
</Step>
<Step>
### Modifiez les données [#pas-de-gegevens-aan]

<DocScreenshot src="/screenshots/producten/product-detail.png" alt="Page de détail du produit avec Général, Lignes de facture supplémentaires, Actions sur la ligne de facture et Événements" />

À gauche, vous trouvez les cartes **Général** et **Lignes de facture supplémentaires**. À droite se trouvent **Actions sur la ligne de facture** et **Événements**. Dans **Général** figurent les mêmes champs qu'à la création, plus l'option **Désactiver le produit**.
</Step>
<Step>
### Enregistrez [#sla-op]

Cliquez en bas de la carte **Lignes de facture supplémentaires** sur **Enregistrer**. Ce bouton enregistre toutes les modifications de la page, y compris celles de **Général** et de **Actions sur la ligne de facture**. Le bouton n'est actif qu'après une modification.
</Step>
</Steps>

Si vous voulez qu'un nouveau prix ne s'applique qu'à partir d'une date ultérieure, utilisez la carte **Prix planifiés**. Voir [Planifier un changement de prix](/producten/prijzen-plannen).

Sous **Événements**, vous voyez une chronologie des modifications du produit, comme le prix, le grand livre et les actions. Pour chaque modification figurent l'heure, l'utilisateur et, si possible, la différence entre avant et après.

## Désactiver un produit [#een-product-uitschakelen]

Cochez **Désactiver le produit** et enregistrez. Un produit désactivé ne peut plus être choisi sur les factures, mais il reste dans la liste et sur les factures existantes. Dans la liste et sur la page du produit, vous le voyez comme <Status>Désactivé</Status>. Vous conservez ainsi l'historique sans plus utiliser le produit.

## Supprimer un produit [#een-product-verwijderen]

<Steps>
<Step>
### Choisissez la suppression [#kies-verwijderen]

Dans la liste, cliquez sur l'icône de corbeille à côté du produit. Sur la page du produit, ouvrez le menu des trois points dans l'en-tête et choisissez **Supprimer le produit**.
</Step>
<Step>
### Confirmez [#bevestig]

<DocScreenshot src="/screenshots/producten/product-delete-dialog.png" alt="Boîte de dialogue de confirmation de suppression du produit" />

Cliquez dans la boîte de dialogue sur **Supprimer**.
</Step>
</Steps>

<Callout type="warn" title="Attention">
La suppression est irréversible. Les factures sur lesquelles figure déjà le produit restent inchangées. Si le produit est une étape dans le bundle d'un autre produit, Tillor ignore désormais cette étape. Si vous voulez simplement ne plus utiliser le produit, désactivez-le plutôt.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Un nouveau prix, un autre grand livre ou une autre action s'applique aux lignes que vous ajoutez ensuite. Les factures existantes restent telles qu'elles étaient.
- Un produit désactivé disparaît de la liste de choix sur les factures, mais reste visible dans la liste des produits.
- Chaque modification figure dans la chronologie **Événements** du produit, avec l'utilisateur et l'heure.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Enregistrer est grisé">
Le bouton ne fonctionne qu'après une modification, et seulement avec le droit **Modifier les produits**.
</Accordion>
<Accordion title="Le bundle n'est pas conservé">
Chaque étape de produit du bundle doit avoir un produit et chaque étape d'information doit avoir un texte. Complétez-les et enregistrez à nouveau. Voir [Configurer des lignes de facture supplémentaires](/producten/bundel-instellen).
</Accordion>
<Accordion title="L'enregistrement échoue pour un produit avec Consommation compteur">
Pour chaque combinaison de type de client et de type de compteur, il ne peut exister qu'un seul produit avec l'action **Consommation compteur**. Si cette combinaison figure déjà sur un autre produit, l'enregistrement est refusé. Modifiez cet autre produit ou choisissez une autre combinaison.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Associer des actions à un produit" href="/producten/acties-instellen" />
  <Card title="Planifier un changement de prix" href="/producten/prijzen-plannen" />
  <Card title="Configurer des lignes de facture supplémentaires" href="/producten/bundel-instellen" />
</Cards>


# Actions de produit (/fr-FR/producten/productacties)

Vous activez les actions sur la page du produit, dans la carte **Actions sur la ligne de facture**. La manière de procéder est décrite sous [Associer des actions à un produit](/producten/acties-instellen). Cette page décrit chaque action. Pour voir comment les actions s'articulent avec les occupations, les badges et les imprimantes lors de la comptabilisation et du paiement, consultez [Comment tout cela s'articule-t-il ?](/producten#hoe-hangt-dit-samen).

## Recharger Tag NFC [#nfc-tag-opladen]

Lorsqu'une facture avec ce produit est payée, Tillor recharge automatiquement un badge NFC. Utilisez ceci pour les produits avec lesquels les clients obtiennent du solde ou un accès sur un badge. Le produit n'a pas de champs supplémentaires.

## Période [#periode]

Le produit représente un service sur une période de temps, comme un prix journalier, un abonnement hebdomadaire ou un tarif mensuel.

| Champ | Signification |
|------|-----------|
| **Par unité** | Nombre d'unités par période, au minimum 1 |
| **Unité de période** | **Jour**, **Semaine** ou **Mois** |
| **Prolonger automatiquement les méthodes d'accès** | Lors du paiement, Tillor prolonge toutes les méthodes d'accès du client jusqu'à la date de fin de la période |
| **Demander un emplacement** | Sur la ligne de facture, vous choisissez un emplacement. Lors de la comptabilisation, Tillor crée une réservation pour ce séjour |
| **Enregistrer l'arrivée à la validation** | Uniquement avec **Demander un emplacement**. Dès que la facture est comptabilisée, Tillor met la réservation sur <Status tone="success">Arrivé</Status> |
| **Enregistrer l'arrivée au paiement** | Uniquement avec **Demander un emplacement**. Dès que la facture est payée, Tillor met la réservation sur <Status tone="success">Arrivé</Status> |
| **Adultes inclus** | Uniquement avec **Demander un emplacement**. Nombre d'adultes sur la réservation, 2 par défaut. Vous pouvez saisir de 0 à 99 |

### Réservations avec Demander un emplacement [#reserveringen-bij-terrein-vragen]

- La réservation reçoit la même arrivée et le même départ que la ligne de facture et l'emplacement choisi comme préférence. Vous adaptez ensuite le groupe sur la réservation elle-même.
- Si vous remettez la facture en brouillon et modifiez les dates ou l'emplacement, Tillor met à jour la même réservation lors d'une nouvelle comptabilisation.
- Si vous retirez l'emplacement ou désactivez **Demander un emplacement**, la réservation est annulée. Une réservation dont le départ est déjà enregistré reste en place.
- Une note de crédit annule la réservation de la facture d'origine.
- Sans enregistrement de l'arrivée, la réservation reste sur <Status tone="info">Réservé</Status>. C'est ainsi que fonctionne un acompte de réservation : un emplacement et des dates dans le futur, sans arrivée.
- Si les deux options d'enregistrement de l'arrivée sont activées, c'est la comptabilisation qui compte.
- Si la facture est déjà payée au moment où vous comptabilisez à nouveau, Tillor enregistre à nouveau l'arrivée.

Sur la chronologie de la facture et de la réservation, vous voyez la création, la modification, l'annulation et l'enregistrement de l'arrivée, avec un renvoi vers l'autre.

## Prolonger l'occupation [#bezetting-verlengen]

Avec cette action, une facture prolonge l'occupation d'un client sur un terrain, par exemple pour le Loyer d'emplacement.

- Lors de la **comptabilisation**, Tillor adapte **Facturé jusqu'au** de l'occupation.
- Lors du **paiement**, Tillor adapte **Payé jusqu'au**.

Sur la ligne de facture, vous choisissez un terrain. Lors de la comptabilisation et du paiement, Tillor associe l'occupation active du client sur ce terrain. Tillor conserve aussi une copie de cette occupation sur la ligne, afin que vous voyiez après coup quelle occupation était visée, même si elle a été supprimée depuis. Avec **Arrondir à la prochaine limite de période** sur la ligne de facture, vous alignez les clients à terme sur le même cycle, selon la **Fréquence de loyer** de l'occupation.

Si vous choisissez un terrain sur lequel le client n'a pas encore d'occupation, vous faites une offre. Vous ne pouvez comptabiliser une telle ligne que lorsque le client occupe le terrain.

| Champ | Signification |
|------|-----------|
| **Échéance au début de l'occupation** | Lors de la comptabilisation, Tillor fixe l'échéance à la date de début de la période d'occupation sur la ligne de Loyer d'emplacement, au lieu du délai de paiement standard ou du délai de la boîte de dialogue de comptabilisation. En cas de nouvelle comptabilisation, l'échéance d'origine est conservée |

Si le produit a des lignes de facture supplémentaires, Tillor ajoute des lignes enfants sous la ligne principale. Voir [Configurer des lignes de facture supplémentaires](/producten/bundel-instellen).

## Prolonger le mode d'accès [#toegangsmethode-verlengen]

Avec cette action, le paiement d'une facture prolonge la validité des méthodes d'accès du client. Cela fonctionne de deux manières :

- **Avec Période** sur la même ligne, par exemple un loyer mensuel. Tillor prolonge les méthodes choisies jusqu'à la date de fin de la période.
- **Via un bundle** avec une ligne principale de Loyer d'emplacement et des étapes NFC. La date de fin de la ligne principale de Loyer d'emplacement sert alors de base. Les réglages ci-dessous viennent du produit principal, pas du produit de supplément de l'étape NFC. Voir [Prolonger le NFC via le bundle](/producten/bundel-instellen#nfc-verlengen-via-de-bundel).

| Champ | Signification |
|------|-----------|
| **Jours après la date de fin** | Jours calendaires en plus de la date de fin. 0 signifie la date de fin elle-même, 3660 au maximum. Pour les bundles, vous le réglez par étape NFC |
| **Jour de la semaine** | Facultatif. La validité se termine à l'occurrence la plus proche de ce jour de la semaine autour de la date cible. **Chaque jour** par défaut |
| **Heure** | Facultatif. Heure dans le fuseau horaire de l'organisation. Vide signifie 23:59 |
| **Types de méthodes d'accès** | Choisissez au moins un type parmi NFC, code QR, Reconnaissance de plaque d'immatriculation et Code PIN. Vous ne voyez que les types activés pour votre organisation |
| **Statuts** | Seules les méthodes ayant l'un de ces statuts sont prolongées : <Status tone="success">Actif</Status> ou <Status tone="warning">Bloqué temporairement</Status>. Par défaut, uniquement **Actif** |
| **Ne pas raccourcir lors de la prolongation** | Les méthodes dont **Valide jusqu'au** est déjà égal ou postérieur à la nouvelle date sont ignorées. Lors d'une annulation via une note de crédit, Tillor applique toujours la date calculée |

Sous le champ figure une ligne **Résultat** qui explique à quel moment la validité arrive, par exemple « mardi le plus proche de la date de fin + 10 jours, à 13:00 ».

Ce n'est pas la même chose que **Prolonger automatiquement les méthodes d'accès** sous **Période**. Ce commutateur prolonge lors du paiement d'un produit avec uniquement **Période**, sans l'action distincte **Prolonger le mode d'accès**.

## Créer une méthode d'accès [#toegangsmethode-aanmaken]

Lors du paiement de la facture, Tillor crée une nouvelle méthode d'accès pour le client. Le caissier choisit le type sur la ligne de facture. Si la ligne a aussi l'action **Période**, la période devient la validité de la méthode d'accès.

| Champ | Signification |
|------|-----------|
| **Types de méthode d'accès** | Types parmi lesquels le caissier choisit : code QR, Reconnaissance de plaque d'immatriculation ou Code PIN. Avec un seul type, Tillor le choisit automatiquement |
| **Méthode d'accès facultative** | La comptabilisation n'est jamais bloquée par cette ligne. Sans type choisi, Tillor ne crée rien |
| **Méthode d'accès par défaut** | Uniquement avec plusieurs types. Ce type est sélectionné par défaut sur les nouvelles lignes de facture, modifiable par ligne. **Aucune (choisir par ligne)** laisse le choix ouvert |
| **Imprimer le code QR automatiquement** | Uniquement avec le code QR. Tillor imprime le ticket d'accès QR sur l'imprimante de tickets dès qu'il est créé |
| **Convertir automatiquement les codes en plaque** | Les nouveaux codes QR et PIN sont remplacés par la plaque détectée lorsqu'ils sont utilisés à une barrière avec caméra. Modifiable par ligne |

Une ligne ne peut être comptabilisée que si un type est choisi, sauf si l'action est facultative. Pour la Reconnaissance de plaque d'immatriculation, la plaque doit aussi être renseignée.

## Demander les coordonnées [#contactgegevens-vragen]

Sur la ligne de facture apparaissent des champs pour l'adresse e-mail et le numéro de téléphone. Tillor les demande lors de la comptabilisation.

| Champ | Signification |
|------|-----------|
| **Demander l'adresse e-mail** | Affiche un champ e-mail sur la ligne de facture |
| **Adresse e-mail obligatoire** | Uniquement si vous demandez une adresse e-mail. La comptabilisation est bloquée tant que le champ n'est pas rempli |
| **Demander le numéro de téléphone** | Affiche un champ téléphone sur la ligne de facture |
| **Numéro de téléphone obligatoire** | Uniquement si vous demandez un numéro de téléphone. La comptabilisation est bloquée tant que le champ n'est pas rempli |

## Empêcher la comptabilisation [#boeken-blokkeren]

Utilisez ceci pour les produits qui ne doivent figurer que sur des factures brouillon. Si une telle ligne se trouve sur une facture brouillon, vous ne pouvez pas rendre la facture définitive. Il n'y a pas de champ supplémentaire. Tillor bloque la comptabilisation tant que la ligne est présente.

## Afficher une alerte [#melding-tonen]

Affiche une alerte sous la ligne de facture, par exemple « Attention : à utiliser uniquement pour les visiteurs d'un jour ». Il ne se passe rien lors de la comptabilisation ni du paiement.

| Champ | Signification |
|------|-----------|
| **Style d’alerte** | **Information**, **Avertissement**, **Erreur**, **Réussi** ou **Neutre** |
| **Texte de l’alerte** | Le texte, 4000 caractères au maximum. Le Markdown est pris en charge (gras, listes, liens) |

Sous le texte, vous voyez immédiatement un aperçu de l'alerte. Le texte est copié sur la ligne de facture. Les modifications ultérieures du produit ne changent pas les factures existantes.

## Consommation compteur [#meterverbruik]

Avec cette action, le produit devient le tarif de la consommation des compteurs. Tillor l'utilise pour la consommation en cours et pour la facturation automatique des relevés de compteurs. Vous choisissez deux champs.

| Champ | Options |
|------|--------|
| **Type de client** | **Par défaut**, **Ouvrier Location Caravane**, **Ouvrier Caravane Remorque** |
| **Type de compteur** | **Électricité**, **Eau**, **Gaz** |

Pour chaque combinaison de type de client et de type de compteur, il ne peut exister qu'un seul produit. Dans la liste, les deux valeurs figurent dans la colonne **Info**. Si un client n'a pas de produit propre pour son type de client, Tillor utilise le produit pour **Par défaut** avec le même type de compteur.

## Impression thermique et impression A4 [#thermisch-printen-en-a4-printen]

Cochez **Impression thermique** et **Impression A4** séparément. Dès qu'au moins l'une des deux est activée, le bloc **Impression automatique** apparaît. Vous y réglez, par imprimante, ce qui est imprimé lors du paiement de la facture.

| Champ | Signification |
|------|-----------|
| **Copies d'impression thermique** | Nombre d'exemplaires sur l'imprimante thermique (imprimante de caisse). 0 désactive cette imprimante |
| **Copies impression A4** | Nombre d'exemplaires sur l'imprimante A4. 0 désactive l'A4 |
| **Moment d'impression** | **Suivre les paramètres (par type de paiement)** (par défaut), **Imprimer immédiatement** ou **Prochaine coupure** |

Vous pouvez régler 10 copies au maximum par imprimante. Avec **Suivre les paramètres (par type de paiement)**, c'est le réglage de votre organisation par type de paiement qui s'applique.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Associer des actions à un produit" href="/producten/acties-instellen" />
  <Card title="Configurer des lignes de facture supplémentaires" href="/producten/bundel-instellen" />
  <Card title="Gestion des compteurs" href="/meterbeheer" />
  <Card title="NFC" href="/nfc" />
</Cards>


# Réservations (/fr-FR/reserveringen)

Avec les réservations, vous suivez les séjours sur votre parc : qui vient quand, sur quel emplacement et avec combien d'hôtes. Depuis une réservation, vous gérez aussi l'arrivée et le départ. Vous voyez toutes les réservations sur une chronologie sous **Réservations** et par client sur l'onglet **Réservations**. Commencez par [Créer une réservation](#een-reservering-aanmaken).

<Callout type="info" title="Bon à savoir">
- Chaque réservation appartient à un client et reçoit automatiquement un **Numéro de réservation** unique. Vous ne pouvez pas modifier ce numéro.
- La date de départ doit être postérieure à la date d'arrivée. Tillor refuse le même jour ou une date antérieure.
- Une plaque d'immatriculation se compose de lettres et de chiffres, 10 caractères au maximum, sans espaces ni traits d'union.
- L'arrivée et l'annulation ne sont possibles qu'à partir du statut **Réservé**. L'annulation n'est plus possible après l'arrivée.
- Une réservation n'est pas la même chose qu'une occupation : une réservation est une réservation pour un séjour, une occupation associe un client à un emplacement pour une période, voir [Occupations](/bezettingen).
- Les notes d'une réservation sont internes et ne sont jamais partagées avec le client.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Client] --> R[Réservation]
  R -->|Arrivée| I[Hôte sur l'emplacement]
  I -->|Départ| U[Séjour terminé]
  R -->|Annuler la réservation| A[Annulée]
  R --> F[Factures du client]
```

Vous trouvez les factures du client sur le profil du client sous **Facturation**.

## La chronologie [#de-tijdlijn]

Allez dans **Réservations** dans le menu principal. La chronologie affiche les réservations par emplacement sur un calendrier. Avec l'affichage, vous choisissez jour, semaine, mois, trimestre ou année, et vous accédez à une date avec **Aller à la date**.

<DocScreenshot src="/screenshots/reserveringen/reservations-list.png" alt="Chronologie des réservations" />

- Cliquez ou faites glisser sur une zone libre pour ajouter une réservation. En haut à droite se trouve aussi **Nouvelle réservation**.
- Si vous faites glisser une réservation vers d'autres dates, Tillor demande **Mettre à jour les dates ?** La réservation ne change qu'après votre confirmation.
- Le menu contextuel d'une réservation contient **Voir la réservation**, **Copier le lien** et **Annuler la réservation**.

## Créer une réservation [#een-reservering-aanmaken]

Avant de commencer :

- Vous avez besoin d'un client. S'il n'existe pas encore, vous le créez pendant le démarrage, voir [Gestion des clients](/klantenbeheer).
- Vous savez quel emplacement l'hôte souhaite ? Choisissez-le alors. Sinon, laissez le champ vide.

<Steps>
<Step>
### Démarrez la réservation [#start-de-reservering]
<Tabs items={["Via Réservations", "Via le profil du client"]}>
<Tab value="Via Réservations">
Cliquez en haut à droite sur **Nouvelle réservation**. Choisissez un client existant ou créez un nouveau client.
</Tab>
<Tab value="Via le profil du client">
Ouvrez le client via **Clients**, allez dans l'onglet **Réservations** et cliquez sur **Nouvelle réservation**.
</Tab>
</Tabs>
</Step>
<Step>
### Remplissez le formulaire [#vul-het-formulier-in]
Voir [Le formulaire de réservation](#het-reserveringsformulier) ci-dessous pour tous les champs.
</Step>
<Step>
### Créez la réservation [#maak-de-reservering-aan]
Cliquez sur **Créer la réservation**.
</Step>
</Steps>

### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La réservation reçoit le statut <Status tone="info">Réservé</Status> et un numéro de réservation.
- Si **E-mail de confirmation automatique** est activé, le client reçoit une confirmation.
- Vous trouvez la réservation sur la chronologie et sur l'onglet **Réservations** du client.
- Si vous voulez qu'une automatisation réagisse à une réservation nouvelle ou modifiée, utilisez un déclencheur, voir [Déclencheurs](/automatiseringen/triggers).

## Le formulaire de réservation [#het-reserveringsformulier]

### Dates et durée du séjour [#datums-en-verblijfsduur]

- **Arrivée** : choisissez la date d'arrivée.
- **Départ** : choisissez la date de départ. Après la date d'arrivée, le sélecteur de départ s'ouvre de lui-même. La date de départ doit être postérieure à la date d'arrivée.
- **Nombre de nuits** : Tillor le calcule lui-même.

### Nombres et animaux [#aantallen-en-dieren]

Indiquez le nombre d'**Adultes** (minimum 1), d'**Enfants**, de **Tout-petits** et d'**Animaux** avec les boutons plus et moins.

### Emplacement [#terrein]

- **Emplacement** : choisissez un emplacement si l'hôte a une préférence. La liste n'affiche que les emplacements réservables sans occupation active qui sont libres pendant la période choisie. Tillor exclut les réservations actives qui se chevauchent sur le même emplacement. Si vous modifiez les dates, la liste se rafraîchit. Pas de préférence ? Laissez le champ vide.
- **Inclure les emplacements non réservables** : affiche aussi les emplacements qui ne peuvent pas être réservés en ligne, par exemple les emplacements annuels fixes. Si la réservation se trouve déjà sur un tel emplacement, cette case est cochée d'elle-même.
- **Inclure les terrains occupés** : affiche aussi les emplacements qui ont déjà une occupation.

### Plaques d'immatriculation [#nummerplaten]

Tapez une plaque d'immatriculation, appuyez sur **Entrée** et répétez pour chaque plaque. Une petite croix sur une plaque la supprime. Les plaques d'immatriculation ne peuvent contenir que des lettres et des chiffres, 10 caractères au maximum.

Les plaques d'immatriculation d'une réservation sont accessibles via la recherche. Vous réglez l'accès à la barrière séparément, chez le client sur l'onglet **Contrôle d'accès**, voir [Contrôle d'accès](/toegangscontrole).

### Notes [#notities]

Utilisez le champ de note pour des remarques internes, comme des souhaits particuliers ou des accords.

### Préférences de communication [#communicatievoorkeuren]

- **E-mail de confirmation automatique** : envoie une confirmation après la création.
- **Paiement en ligne** : permet au client de payer la réservation en ligne.

## Consulter et modifier une réservation [#een-reservering-bekijken-en-bewerken]

Cliquez sur une réservation sur la chronologie ou dans le profil du client pour ouvrir la page de détail.

<DocScreenshot src="/screenshots/reserveringen/reservation-detail.png" alt="Page de détail d'une réservation" />

- **Détails de la réservation** (à gauche) : le formulaire complet. Modifiez ce que vous voulez et cliquez sur **Enregistrer**. Avec **Annuler**, vous rétablissez les valeurs d'origine. À côté du titre se trouve **Copier le lien de réservation**, pratique pour coller un lien cliquable dans un document.
- **Actions sur la réservation** (à droite) : les boutons ci-dessous.
- **Commentaires** (à droite) : discussion interne sur cette réservation.
- **Activité** (à droite) : une chronologie avec la création, l'arrivée, le départ, l'annulation, les annulations d'actions et les données modifiées, avec l'heure et l'utilisateur. Pour une modification, vous voyez quels champs ont été modifiés (avant / après).

## Arrivée, départ et annulation [#inchecken-uitchecken-en-annuleren]

Sur la page de détail, les actions se trouvent sous **Actions sur la réservation**. Chaque action demande une confirmation.

| Action | Possible quand | Résultat |
|---|---|---|
| **Enregistrer l'arrivée** | Statut <Status tone="info">Réservé</Status> | Statut <Status tone="success">Arrivé</Status> |
| **Enregistrer le départ** | Statut <Status tone="success">Arrivé</Status> | Statut <Status>Parti</Status> |
| **Annuler la réservation** | Uniquement avant l'arrivée | Statut <Status>Annulé</Status> |
| **Annuler l’annulation** | Uniquement avant l'arrivée | Retour à <Status tone="info">Réservé</Status> |
| **Annuler l’arrivée** | En cas d'arrivée enregistrée par erreur. Si l'hôte était déjà parti, annulez d'abord le départ | Retour à <Status tone="info">Réservé</Status> |
| **Annuler le départ** | En cas de départ enregistré par erreur | Retour à <Status tone="success">Arrivé</Status> |

Vous y trouvez en outre **Envoyer le formulaire de confirmation au client (SMS)** et **Créer une tâche**. Avec cette dernière, vous créez une tâche à partir de cette réservation.

Vous ne pouvez ni enregistrer l'arrivée ni le départ d'une réservation annulée. Annulez d'abord l'annulation.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor dit : Réservation non créée">
Le message est **La réservation n’a pas pu être créée.** Vérifiez qu'un client est choisi et que la date de départ est postérieure à la date d'arrivée. Le même jour ou une date antérieure est refusé.
</Accordion>
<Accordion title="Tillor dit : Réservation non mise à jour">
Vos modifications n'ont pas été enregistrées. Vérifiez les dates (le départ doit être postérieur à l'arrivée), les plaques d'immatriculation et le nombre d'adultes, puis cliquez à nouveau sur **Enregistrer**.
</Accordion>
<Accordion title="Tillor dit : Échec de l’enregistrement">
La réservation doit avoir le statut Réservé. Si elle est déjà arrivée, partie ou annulée, l'enregistrement de l'arrivée est impossible. Rechargez la page et regardez quel est le statut actuel. Si elle est annulée, faites d'abord **Annuler l’annulation**.
</Accordion>
<Accordion title="Tillor dit : Échec du départ">
Le départ ne peut être enregistré que pour une réservation dont l'arrivée est enregistrée. Si l'hôte n'est pas encore arrivé ou est déjà parti, cela ne fonctionne pas.
</Accordion>
<Accordion title="Tillor dit : Annulation impossible">
L'annulation n'est possible qu'avant l'arrivée. Si l'hôte est déjà arrivé, annulez d'abord l'arrivée avec **Annuler l’arrivée**, puis annulez la réservation.
</Accordion>
<Accordion title="L'emplacement ne figure pas dans la liste">
La liste n'affiche que les emplacements réservables sans occupation qui sont libres pendant la période choisie. Vérifiez les dates. Cochez **Inclure les emplacements non réservables** ou **Inclure les terrains occupés** si c'est un tel emplacement que vous voulez.
</Accordion>
<Accordion title="Une plaque d'immatriculation n'est pas ajoutée">
Une plaque d'immatriculation ne peut contenir que des lettres et des chiffres et faire 10 caractères au maximum. Retirez les espaces et les traits d'union.
</Accordion>
</Accordions>

## Glossaire [#begrippen]

- **Réservation** : une réservation pour un séjour. Voir [réservation](/begrippen#reservering).
- **Réservé, Arrivé, Parti, Annulé** : les quatre statuts d'une réservation.
- **Numéro de réservation** : le numéro automatique avec lequel vous retrouvez une réservation.
- **Occupation** : un client sur un emplacement pour une période, indépendamment d'une réservation. Voir [occupation](/begrippen#bezetting).
- **Chronologie** : l'aperçu des réservations par emplacement sur un calendrier.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des clients" href="/klantenbeheer" />
  <Card title="Occupations" href="/bezettingen" />
  <Card title="Contrôle d'accès" href="/toegangscontrole" />
  <Card title="Traitement des paiements" href="/betalingsverwerking" />
  <Card title="Exemples pratiques" href="/praktijk" />
</Cards>


# Partager des tâches (/fr-FR/taken/delen)

Vous voulez montrer des tâches à quelqu'un qui ne travaille pas dans Tillor, ou les voir dans votre propre agenda ? Créez alors un lien de partage. Il en existe deux types.

| Type | Ce que c'est |
|---|---|
| **Page partageable** | Un tableau en lecture seule avec ce qu'il y a à faire. Il suit les tâches : les modifications faites dans Tillor s'y retrouvent |
| **Agenda (ICS)** | Un abonnement d'agenda, par exemple pour Google Agenda, Outlook ou Apple Agenda |

## Créer un lien [#een-link-maken]

1. Cliquez sur l'icône de partage en haut à droite de la page des tâches (info-bulle **Partager cette vue**). Vous trouvez la même icône sur la carte **Tâches pour vous** du tableau de bord
2. Choisissez sous **Type de lien** une **Page partageable** ou **Agenda (ICS)**
3. Choisissez sous **Contenu** ce que vous partagez : **Mes tâches assignées** ou une de vos vues. Si vous ouvrez la fenêtre depuis une vue, elle est déjà sélectionnée
4. Limitez éventuellement le contenu avec **Filtres** : **Statut**, **Priorité**, **Assigné à**, **Label**, **Vue**, **Lié à** et **Bloqué**. Les filtres sont conservés sur le lien et ne font que restreindre ce que la source affiche déjà
5. Cliquez sur **Créer un lien**

<DocScreenshot src="/screenshots/taken/task-share-dialog.png" alt="Boîte de dialogue de partage des tâches avec le type de lien, le contenu et les filtres" />

Sous **Liens précédents** figurent tous les liens que vous avez créés pour cette source. Pour chaque lien, vous pouvez :

- **Copier le lien**
- Pour un lien d'agenda, **Ajouter à l'agenda**, ce qui ouvre directement l'abonnement dans votre application d'agenda
- **Invalider** (après confirmation). Le lien ne fonctionne alors plus. Les autres liens restent valides. Un lien invalidé reste dans la liste avec la mention **Invalidé**

<Callout type="warn">
Un lien de partage est privé, mais toute personne qui le possède peut voir les tâches, même sans se connecter. Ne le partagez qu'avec des personnes autorisées, et invalidez-le dès qu'il n'est plus nécessaire.
</Callout>

## La page partageable [#de-deelbare-pagina]

La page affiche les tâches par groupe, avec pour chaque tâche le nom, le statut, la priorité, l'échéance, les labels et les noms des collègues assignés. Il n'y a aucun bouton pour modifier quoi que ce soit. Pour un grand groupe, vous voyez **[nombre] sur [total]** tâches.

Par défaut, seules les tâches ouvertes y figurent, sauf si vous définissez vous-même un filtre de statut ou si vous partagez une vue. S'il n'y a rien à faire, vous voyez **Rien à faire pour le moment.**

## L'agenda [#de-agenda]

L'agenda contient les tâches avec une **échéance** ou un **rappel**. Les tâches sans date n'y figurent pas.

- Les rappels récurrents apparaissent sous forme de série, et vous recevez une notification à chaque rappel
- Sans rappel, vous recevez une notification une heure avant l'échéance
- Les tâches terminées restent encore visibles deux semaines, comme terminées, puis disparaissent
- Pour une vue, l'agenda suit la vue, quelle que soit la personne à qui les tâches sont assignées. Si la personne qui a créé le lien ne peut plus voir la vue, le lien ne fonctionne plus

<Callout type="info">
Dans Google Agenda, vous devez aussi activer les notifications par défaut pour un agenda auquel vous êtes abonné, sinon les notifications n'arrivent pas.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le lien fonctionne tout de suite et continue de fonctionner jusqu'à ce que vous l'invalidiez. Toute personne qui possède le lien peut voir les tâches, même sans se connecter.
- Une page partageable suit les tâches : les modifications faites dans Tillor s'y retrouvent.
- Un abonnement d'agenda se met à jour tout seul dans votre application d'agenda, et envoie une notification une heure avant l'échéance ou à chaque rappel.
- Si vous invalidez un lien, seul ce lien s'arrête. Les autres liens restent valides, et le lien invalidé reste dans la liste avec la mention **Invalidé**.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor indique que la création du lien a échoué">
Le lien n'a pas été créé. Vérifiez que vous avez choisi une source sous **Contenu** et réessayez. Le message **Impossible de charger les liens.** signifie que la liste des liens précédents ne s'est pas ouverte. Rouvrez la fenêtre.
</Accordion>
<Accordion title="La page affiche Rien à faire pour le moment">
Aucune tâche ne correspond à la source et aux filtres. Par défaut, une page partageable n'affiche que les tâches ouvertes.
</Accordion>
<Accordion title="L'agenda n'affiche pas mes tâches">
Seules les tâches avec une échéance ou un rappel figurent dans l'agenda. Si la personne qui a créé le lien ne peut plus voir la vue, le lien ne fonctionne plus non plus.
</Accordion>
<Accordion title="Je ne reçois pas de notifications dans Google Agenda">
Activez aussi les notifications par défaut pour l'agenda auquel vous êtes abonné dans Google Agenda.
</Accordion>
<Accordion title="Je ne veux plus que le lien fonctionne">
Choisissez **Invalider** sur le lien et confirmez sous **Invalider ce lien ?**. Si cela échoue, vous voyez **Impossible d'invalider le lien** : réessayez.
</Accordion>
</Accordions>


# Filtrer (/fr-FR/taken/filteren)

Au-dessus des tâches se trouve une barre de recherche, avec les boutons de filtre à côté. Les filtres font partie de la vue : si vous les enregistrez, ils déterminent les tâches que la vue affiche. Pour une vue filtrée, ce sont les tâches qui correspondent aux filtres. Pour une liste, ce sont les tâches ajoutées manuellement qui correspondent aussi aux filtres.

<DocScreenshot src="/screenshots/taken/task-filter-status.png" alt="Le filtre de statut avec les choix Inclure et Exclure et les quatre statuts" />

## Filtres toujours visibles [#altijd-zichtbare-filters]

| Filtre | Ce que vous choisissez |
|---|---|
| **Statut** | Un ou plusieurs statuts |
| **Priorité** | Une ou plusieurs priorités |
| **Assigné à** | Un ou plusieurs collègues, ou **Moi** pour vous-même |
| **Label** | Un ou plusieurs labels |
| **Vue** | Les tâches qui se trouvent dans une autre vue (manuelle) |
| **Bloqué** | **Bloquée** ou **Non bloquée** |
| **Lié à** | Le type d'enregistrement auquel la tâche est rattachée, comme un client, un terrain, une facture ou une réservation |
| **Texte** | Des mots que le nom ou la description contient ou justement ne contient pas, voir ci-dessous |
| **Échéance** | Une période, voir ci-dessous |

Pour les filtres à liste, vous choisissez en haut **Inclure** (tâches avec les valeurs choisies) ou **Exclure** (tâches sans ces valeurs). Pour **Lié à**, vous choisissez le type d'élément : **Client**, **Facture**, **Réservation**, **Compteur**, **Terrain**, **Commentaire**, **Conversation**, **Appel téléphonique**, **Transaction bancaire** ou **Produit**.

## Filtrer par texte [#filteren-op-tekst]

Avec **Texte**, vous n'affichez que les tâches dont le nom ou la description contient, ou justement ne contient pas, un bout de texte. Les majuscules et les minuscules n'ont pas d'importance.

1. Cliquez sur **Texte**
2. Choisissez **Contient** ou **Ne contient pas**
3. Tapez le texte dans **Texte dans le nom ou la description**, par exemple `Verzekering vervallen:`
4. Cliquez sur **Ajouter** ou appuyez sur Entrée

Répétez cette opération pour chaque texte que vous voulez ajouter. Chaque texte est un filtre distinct, vous pouvez donc combiner **Contient** et **Ne contient pas** : par exemple `caravan`, mais pas `Verzekering vervallen:`. La croix à côté d'un texte le retire. Le bouton affiche le texte lui-même, ou le nombre de textes s'il y en a plusieurs.

<Callout>
Qu'une tâche doive correspondre à **tous** les textes ou à **un seul** d'entre eux dépend du choix fait sous [Combiner plusieurs filtres](#meerdere-filters-combineren). Pour exclure plusieurs textes, laissez ce choix sur **Tous les filtres**.
</Callout>

## Filtrer par date [#filteren-op-datum]

**Échéance** fonctionne avec des choix fixes qui évoluent avec le jour, ou avec une période personnalisée.

- **En retard**, **Aujourd'hui**, **Demain**, **Cette semaine**, **Semaine prochaine**, **Ce mois-ci**
- **Sans date** (tâches sans échéance) et **Avec une date**
- **Période personnalisée** : choisissez une date de début et une date de fin dans le calendrier et cliquez sur **Appliquer la période**. Le dernier jour est entièrement compris

<DocScreenshot src="/screenshots/taken/task-filter-deadline.png" alt="Le filtre d'échéance avec des choix fixes et un calendrier pour une période personnalisée" />

Si vous cliquez encore une fois sur une option choisie, le filtre disparaît.

## Combiner plusieurs filtres [#meerdere-filters-combineren]

Dès que vous avez deux filtres ou plus, un menu de choix apparaît :

- **Tous les filtres** : une tâche doit correspondre à chaque filtre
- **Au moins un filtre** : il suffit qu'une tâche corresponde à l'un des filtres

Avec **Effacer les filtres**, vous supprimez tous les filtres d'un coup.

## Exemples [#voorbeelden]

- *Tout ce qui doit être terminé aujourd'hui et qui est encore ouvert* : filtrez **Échéance** sur **Aujourd'hui** et **Statut** sur tout sauf **Terminé**
- *Les tâches pour lesquelles j'attends quelque chose* : filtrez **Statut** sur **En attente de réponse** et **Assigné à** sur **Moi**
- *Tout sauf les notifications d'assurance expirée* : filtrez **Texte** sur **Ne contient pas** `Verzekering vervallen:`
- *Tout ce qui concerne un client* : ouvrez le client. L'onglet **Tâches** de la page du client contient toutes les tâches liées à ce client

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les filtres sur votre écran restreignent ce que vous voyez. Ce n'est que si vous les enregistrez avec **Enregistrer la vue** qu'ils font partie de la vue et que vos collègues voient la même sélection.
- Vous pouvez aussi enregistrer des filtres sur la vue intégrée **Toutes**. Ils s'appliquent alors à tout le monde dans votre organisation. Pour cela, vous avez besoin du droit **Gérer les étiquettes et les vues partagées**.
- Dans une vue filtrée, les tâches apparaissent et disparaissent toutes seules, selon qu'elles correspondent ou non aux filtres.
- La barre de recherche n'est jamais enregistrée.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois plus aucune tâche">
Vérifiez si un filtre est actif, par exemple un filtre de statut qui exclut **Terminé**, ou **Tous les filtres** alors que vous vouliez dire un seul des filtres. Avec **Effacer les filtres**, vous repartez de zéro.
</Accordion>
<Accordion title="Le filtre a disparu après l'actualisation">
Vous ne l'aviez pas enregistré. Choisissez **Enregistrer la vue** dans la barre **Modifications non enregistrées**.
</Accordion>
<Accordion title="Je ne peux pas enregistrer les filtres sur Toutes">
**Enregistrer la vue** est grisé si vous n'avez pas le droit **Gérer les étiquettes et les vues partagées**, car **Toutes** s'applique à toute l'organisation. Demandez-le à un administrateur, ou créez votre propre vue avec les mêmes filtres.
</Accordion>
<Accordion title="Une tâche d'un collègue n'apparaît pas">
Vous ne voyez que les tâches que vous avez le droit de voir. Une tâche dans une vue personnelle d'un collègue est invisible pour vous. Voir [Tâches privées](/taken/prive-taken).
</Accordion>
<Accordion title="Le filtre Échéance n'affiche rien avec une période personnalisée">
Après avoir choisi une date de début et une date de fin, cliquez sur **Appliquer la période**.
</Accordion>
</Accordions>


# Table, tableau et calendrier (/fr-FR/taken/indelingen)

Vous pouvez consulter les mêmes tâches de trois façons. En haut à droite, ouvrez **Affichage** pour choisir :

- **Disposition** : **Table**, **Tableau kanban** ou **Calendrier**. Ce choix n'existe que pour les vues enregistrées, pas pour **Toutes**
- **Regrouper par** : comment les tâches sont réparties en groupes ou en colonnes
- **Trier par** et **Ordre** : **Croissant** ou **Décroissant**
- **Type** : indique si la vue est une **Liste** ou une **Vue filtrée**, voir [Vues](/taken/weergaven#twee-soorten-weergaven). Cela non plus n'existe que pour les vues enregistrées
- **Terminé** : combien de temps les tâches terminées restent visibles

<DocScreenshot src="/screenshots/taken/task-view-display-options.png" alt="Le menu Affichage avec la disposition, le type, le regroupement, le tri et les tâches terminées" />

Les modifications restent une proposition tant que vous ne les enregistrez pas, voir [Enregistrer ou annuler les modifications](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

## Masquer les tâches terminées [#voltooide-taken-verbergen]

Sous **Terminé** dans le menu **Affichage**, vous choisissez combien de temps une tâche terminée reste dans la vue :

| Choix | Ce que vous voyez |
|---|---|
| **Tout afficher** | Toutes les tâches terminées (par défaut) |
| **Masquer** | Aucune tâche terminée |
| **Dernier jour** | Les tâches terminées au cours du dernier jour |
| **Dernière semaine** | Les tâches terminées au cours de la dernière semaine |
| **Dernier mois** | Les tâches terminées au cours du dernier mois |

Le décompte part du moment où la tâche a été mise sur **Terminé**. Un commentaire ou un nouveau nom n'y change rien. Si vous rouvrez une tâche, elle réapparaît aussitôt dans la vue. Si la vue a déjà un filtre de statut qui exclut les tâches terminées, ce filtre reste appliqué.

## Regrouper [#groeperen]

| Regroupement | Résultat |
|---|---|
| **Aucun regroupement** | Toutes les tâches dans une liste |
| **Statut** | Un groupe par statut |
| **Priorité** | Un groupe par priorité |
| **Assigné à** | Un groupe par collègue |
| **Label** | Un groupe par label |
| **Client** | Un groupe par client |
| **Échéance** | Des groupes comme **En retard**, **Aujourd'hui**, **Cette semaine**, **Plus tard** et **Aucune échéance** |
| **Colonnes personnalisées** | Des colonnes que vous créez vous-même, uniquement pour les vues enregistrées |

Une tâche avec plusieurs collègues assignés ou plusieurs labels apparaît dans le groupe de chacun d'eux.

## Trier [#sorteren]

Vous pouvez trier par **Manuel**, **Échéance**, **Priorité**, **Statut**, **Nom**, **Création** ou **Mis à jour**. Avec **Manuel**, vous décidez vous-même de l'ordre en faisant glisser les cartes. Avec les autres choix, c'est le champ qui détermine l'ordre et le glisser-déposer au sein d'une colonne n'a aucun effet, sauf pour les colonnes personnalisées.

## Table [#tabel]

La table affiche une ligne par tâche. Avec un regroupement, vous obtenez un bloc par groupe. Sous **Colonnes** dans le menu d'affichage, vous activez ou désactivez des colonnes : **Tâche**, **Statut**, **Priorité**, **Échéance**, **Vues**, **Assigné à**, **Liés** et **Label**. La colonne **Liés** affiche tous les éléments auxquels la tâche est rattachée. La colonne **Tâche** reste toujours visible.

Quand il y a beaucoup de tâches, Tillor en charge d'abord une partie. Faites défiler vers le bas ou cliquez sur **Charger plus** pour le reste.

## Tableau kanban [#bord]

Le tableau affiche chaque groupe sous forme de colonne, dans le style kanban. En haut d'une colonne, cliquez sur **Nouvelle tâche** pour y créer une tâche. Elle reçoit automatiquement la valeur de la colonne, comme le statut ou le collègue assigné.

Faites glisser une carte de tâche vers une autre colonne et la tâche reprend la valeur de cette colonne :

- avec un tableau par **Statut**, le statut change
- avec **Priorité**, la priorité change
- avec **Assigné à**, le collègue assigné change
- avec **Label** et **Client**, le label ou le client change
- avec **Colonnes personnalisées**, la tâche passe dans cette colonne

Avec un tableau par **Échéance**, vous ne pouvez pas faire glisser les cartes vers une autre colonne, car il faudrait inventer une échéance. Modifiez l'échéance dans la tâche elle-même.

S'il y a plus de tâches dans une colonne que ce qui est affiché, vous voyez en bas **[nombre] de plus**. Une carte qui est bloquée par d'autres tâches ou qui en bloque l'indique aussi, par exemple **Bloquée par 1 tâche**.

### Colonnes personnalisées [#eigen-kolommen]

Avec **Colonnes personnalisées**, vous créez vous-même les colonnes, comme *À planifier*, *Commandé* et *Terminé* :

1. Dans **Affichage**, choisissez sous **Regrouper par** l'option **Colonnes personnalisées** (ou choisissez-la dès la création)
2. À droite du tableau, cliquez sur **Nouvelle colonne** et donnez un nom à la colonne
3. Dans le menu d'une colonne, choisissez **Modifier** pour changer le nom ou **Supprimer**
4. Faites glisser les colonnes par leur titre pour changer leur ordre

<DocScreenshot src="/screenshots/taken/task-view-own-columns.png" alt="Tableau avec les colonnes personnalisées À planifier, Commandé et Terminé, plus Nouvelle colonne" />

Les nouvelles colonnes personnalisées sont vides au départ. Chaque tâche de la vue se trouve alors d'abord dans **Aucune colonne** tant que vous ne l'avez pas classée. Pour une liste, vous pouvez masquer ces tâches avec la case **Afficher les tâches sans colonne**. Pour une vue filtrée, elles restent visibles, sinon vous ne pourriez jamais les classer.

<Callout type="warn">
Si vous passez de **Colonnes personnalisées** à un autre regroupement et que vous enregistrez, les colonnes personnalisées de cette vue sont supprimées, ainsi que la place de chaque tâche dans ces colonnes. Cela ne peut pas être annulé. Tillor affiche un avertissement avant.
</Callout>

### Affecter des tâches à une liste [#taken-toewijzen-aan-een-lijst]

Pour le tableau d'une liste, le bouton **Affecter des tâches** apparaît tant qu'il existe des tâches qui n'y sont pas encore. Il ouvre une colonne supplémentaire **Pas dans cette vue** avec les tâches qui correspondent aux filtres de la vue mais n'y sont pas encore. Cherchez avec **Filtrer les tâches...** et faites glisser une tâche vers une colonne pour l'ajouter à la vue. Cliquez de nouveau sur le bouton pour fermer la colonne.

## Calendrier [#kalender]

Le calendrier affiche une grille mensuelle avec les tâches à leur **échéance**. La semaine commence le lundi et les jours suivent le fuseau horaire de votre organisation. Les tâches sans échéance ne figurent pas dans le calendrier.

- Avec les flèches, vous allez au mois précédent ou suivant ; avec **Aujourd'hui**, vous revenez au mois en cours
- Par jour, vous voyez au maximum trois tâches. Cliquez sur **+[nombre] de plus** pour voir le reste de la journée
- Cliquez sur une tâche pour ouvrir ses détails
- Faites glisser une tâche vers un autre jour pour déplacer l'échéance. L'heure reste la même, seul le jour change
- Les tâches terminées sont barrées, se trouvent sous les tâches ouvertes du jour et ne peuvent pas être déplacées

Le regroupement n'a pas d'effet dans le calendrier : toutes les tâches se trouvent dans la même grille.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Vos modifications dans **Affichage** sont d'abord une proposition sur votre écran. Ce n'est qu'après **Enregistrer la vue** qu'elles s'appliquent à toutes les personnes qui voient la vue.
- Si vous faites glisser une carte vers une autre colonne, la tâche elle-même est modifiée. Avec un tableau par **Statut**, le statut change, et vos collègues le voient tout de suite.
- Faire glisser une carte dans un calendrier déplace l'échéance à ce jour. L'heure reste la même.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne peux pas faire glisser une carte vers une autre colonne">
Avec un tableau par **Échéance**, ce n'est pas possible, car Tillor devrait inventer une échéance. Modifiez l'échéance dans la tâche. Dans un calendrier, vous faites glisser les tâches vers un autre jour, sauf les tâches terminées.
</Accordion>
<Accordion title="Tillor indique que la tâche n'a pas pu être déplacée">
Vous voyez **Impossible de déplacer la tâche**. La carte revient à son ancienne place. Réessayez.
</Accordion>
<Accordion title="Le choix Disposition ou Type est absent">
Ils n'existent que pour les vues enregistrées, pas pour **Toutes**.
</Accordion>
<Accordion title="Une tâche n'apparaît pas dans le calendrier">
Le calendrier affiche les tâches à leur échéance. Une tâche sans échéance n'y figure pas.
</Accordion>
<Accordion title="Mes tâches sont dans Aucune colonne">
Avec de nouvelles colonnes personnalisées, toutes les tâches commencent dans **Aucune colonne** tant que vous ne les classez pas. Faites-les glisser vers la bonne colonne.
</Accordion>
<Accordion title="Mes colonnes personnalisées ont disparu">
Vous êtes passé à un autre regroupement et vous l'avez enregistré. Tillor supprime alors les colonnes personnalisées, et cela ne peut pas être annulé. Tillor vous en avertit avant.
</Accordion>
</Accordions>


# Aperçu (/fr-FR/taken)

Avec le système de tâches, vous suivez ce qui doit être fait dans votre parc et par qui. Une tâche peut avoir une échéance, un rappel, un ou plusieurs collègues ou groupes assignés, des labels, des pièces jointes, des sous-tâches, du temps passé et des clients, terrains, factures, réservations, compteurs, conversations ou transactions bancaires liés.

Vous consultez les tâches via des **vues**. Une vue est une manière enregistrée de regarder vos tâches, par exemple *Tâches ouvertes*, *Mes tâches* ou *Entretien*. Chaque vue apparaît sous forme d'onglet en haut de la page.

## Où trouver les tâches [#waar-vind-je-taken]

- **Tâches** dans le menu latéral : la page principale avec toutes vos vues
- **Tableau de bord** : la carte **Tâches pour vous** affiche les tâches qui vous sont assignées, ou votre vue favorite
- **Clients > [client] > Tâches** : toutes les tâches liées à un client
- **Tâches ouvertes** : un bloc sur la page d'un client, d'une réservation, d'une facture, d'un terrain et d'un compteur

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Page des tâches avec des onglets par vue et un tableau par statut" />

En haut, les vues se présentent sous forme d'onglets. En dessous se trouvent la barre de recherche et les filtres, et à droite les boutons **Affichage**, **Suivre** et de partage. Plus bas, vous voyez les tâches, ici sous forme de tableau par statut. Survolez les repères ℹ pour obtenir une explication.

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une tâche est une seule chose, et les vues sont des manières de consulter les tâches. Les tâches sont créées par des collègues ou par des automatisations. Une automatisation peut aussi attendre une tâche.

```mermaid
flowchart LR
  A["Un collègue crée une tâche<br/>sur la page des tâches ou depuis un client, une facture ou un compteur"] --> T["Tâche"]
  B["Une automatisation crée une tâche<br/>étape Créer une tâche, au nom de Flux de travail"] --> T
  T --> L["Liste<br/>affiche uniquement les tâches que vous y ajoutez vous-même"]
  T --> G["Vue filtrée<br/>affiche chaque tâche qui correspond aux filtres"]
  L --> Z["La visibilité de la vue<br/>détermine qui voit la tâche"]
  T -- "Un collègue choisit un bouton sur la tâche" --> W["L'automatisation n'attend plus<br/>et continue"]
  T -- "Le statut ou l'assignation change" --> S["Une automatisation peut démarrer à ce moment"]
```

- Si vous placez une tâche dans une vue, la tâche elle-même ne change pas. Seule la vue l'obtient en plus.
- Une vue filtrée ne retire pas de tâches : elles apparaissent ou disparaissent toutes seules selon qu'elles correspondent ou non aux filtres.
- Une tâche créée par une automatisation est une tâche ordinaire. Si elle a des boutons de choix (étape **Demander une décision**), l'automatisation attend que quelqu'un choisisse un bouton. Voir [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen) et [Tâches dans les automatisations](/automatiseringen/acties/taken).

## Pour bien démarrer [#snel-aan-de-slag]

1. Ouvrez **Tâches** dans le menu latéral
2. Cliquez sur **Nouvelle vue**. Renseignez un **Nom** et choisissez ce que vous voulez sous **Visibilité**, **Contenu**, **Colonnes** et **Commencer avec**. Cliquez ensuite sur **Nouvelle vue** en bas de la boîte de dialogue
3. En haut d'une colonne, cliquez sur **Nouvelle tâche**, donnez un nom à la tâche et cliquez sur **Créer**
4. Cliquez sur une tâche pour ouvrir ses détails : statut, priorité, échéance, collègues assignés et plus encore
5. Cochez la case à gauche d'une tâche dès qu'elle est terminée

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Boîte de dialogue Nouvelle vue avec le nom, la visibilité, le contenu, les colonnes et le filtre de départ" />

Sans vues personnelles, vous pouvez toujours vous rabattre sur la vue intégrée **Toutes**, qui affiche toutes les tâches que vous avez le droit de voir. Les filtres enregistrés sur **Toutes** s'appliquent à toute l'organisation.

## Statuts [#statussen]

| Statut | Signification |
|---|---|
| **En attente** | La tâche est planifiée mais n'a pas encore été commencée |
| **En cours** | On travaille activement sur la tâche |
| **En attente de réponse** | Vous ne pouvez continuer que lorsque quelqu'un d'autre, comme un client ou un fournisseur, a fait quelque chose ou répondu |
| **Terminé** | La tâche est achevée |

Voici à quoi ressemble le même type de tâche avant et après avoir été cochée. En haut, une tâche ouverte, en dessous une tâche terminée : le titre est barré et le statut est **Terminé**.

<DocScreenshot src="/screenshots/taken/task-card-open.png" alt="Avant : une tâche ouverte avec le statut En cours" />

<DocScreenshot src="/screenshots/taken/task-card-done.png" alt="Après : une tâche terminée avec un titre barré et le statut Terminé" />

Une tâche terminée descend vers le bas dans une liste ou une colonne triée manuellement. Si vous mettez une tâche parente sur **Terminé**, les sous-tâches ouvertes sont terminées aussi. Si vous rouvrez ensuite la tâche, les sous-tâches restent terminées.

Une vue peut masquer les tâches terminées au bout d'un certain temps, voir [Masquer les tâches terminées](/taken/indelingen#voltooide-taken-verbergen).

## Priorités [#prioriteiten]

Une tâche a la priorité **Faible**, **Moyen**, **Élevé** ou **Urgent**.

## Composants [#onderdelen]

<Cards>
  <Card
    title="Vues"
    href="/taken/weergaven"
    description="Créer, partager, dupliquer et suivre des listes et des vues filtrées"
  />
  <Card
    title="Table, tableau et calendrier"
    href="/taken/indelingen"
    description="Choisissez comment vos tâches sont affichées, regroupez-les et triez-les"
  />
  <Card
    title="Filtrer"
    href="/taken/filteren"
    description="Retrouver des tâches par statut, échéance, client, élément lié et plus encore"
  />
  <Card
    title="Détails d'une tâche"
    href="/taken/taakdetails"
    description="Tout ce que vous pouvez consigner dans une tâche, des sous-tâches et du temps passé à l'impression"
  />
  <Card
    title="Tâches privées"
    href="/taken/prive-taken"
    description="Qui voit une tâche dépend des vues dans lesquelles elle se trouve"
  />
  <Card
    title="Labels"
    href="/taken/labels"
    description="Gérer les labels et faire définir automatiquement une échéance"
  />
  <Card
    title="Notifications"
    href="/taken/meldingen"
    description="Rappels, échéances et résumé quotidien d'une vue"
  />
  <Card
    title="Partager des tâches"
    href="/taken/delen"
    description="Créer une page en lecture seule ou un abonnement d'agenda"
  />
  <Card
    title="Tâches sur d'autres pages"
    href="/taken/taken-op-andere-paginas"
    description="Créer des tâches depuis des clients, des factures, des conversations et plus encore"
  />
</Cards>

<Callout type="info" title="Bon à savoir">
- Il n'existe pas de droits distincts pour les tâches. Toute personne qui travaille dans Tillor peut créer et modifier des tâches. Les tâches que vous voyez dépendent des vues dans lesquelles elles se trouvent. Voir [Tâches privées](/taken/prive-taken)
- Une nouvelle tâche peut avoir jusqu'à 50 sous-tâches. Les sous-tâches n'ont qu'un seul niveau
- Si vous mettez une tâche sur **Terminé**, les sous-tâches ouvertes sont terminées aussi
- Toute personne qui suit une vue reçoit chaque matin à 07:00 un résumé, avec au plus 15 tâches par liste
- Un minuteur en cours se met en pause après dix minutes sans souris ni clavier
- Un label avec un **Objectif d'échéance (jours)** donne automatiquement une échéance aux tâches qui n'en ont pas
- Une tâche que vous supprimez ne peut pas être restaurée
</Callout>

## Termes [#begrippen]

- **Tâche** : un travail que vous suivez, avec statut, priorité, échéance et éventuellement des collègues assignés
- **Vue** : un onglet de la page des tâches avec sa propre manière d'afficher les tâches, voir [Vues](/taken/weergaven)
- **Liste** : une vue qui n'affiche que les tâches que vous y ajoutez vous-même
- **Vue filtrée** : une vue qui affiche chaque tâche qui correspond aux filtres
- **Sous-tâche** : une partie d'une tâche, sous forme de liste de contrôle
- **Blocage** : une tâche qui doit être terminée avant qu'une autre tâche puisse démarrer
- **Flux de travail** : l'utilisateur au nom duquel une [automatisation](/begrippen#automatisering) crée des tâches

D'autres termes figurent dans le [glossaire](/begrippen).


# Labels (/fr-FR/taken/labels)

Avec les labels, vous donnez une catégorie aux tâches, par exemple *Entretien*, *Plaintes* ou *Saison*. Vous pouvez filtrer et regrouper par labels. Un label a un nom, une couleur et éventuellement une description.

## Gérer les labels [#labels-beheren]

Allez dans <UIPath>Paramètres > Labels de tâches</UIPath>. Vous voyez cette page si vous avez le droit de consulter ou de modifier les paramètres généraux de votre organisation. L'aperçu comporte les colonnes **Label**, **Description** et **Tâches** (le nombre de tâches avec ce label).

<DocScreenshot src="/screenshots/taken/task-labels-settings.png" alt="Paramètres, page Labels de tâches avec les labels Administration, Entretien et Réception" />

- **Nouveau label** crée un label avec un **Nom**, une **Description**, une **Couleur** et éventuellement un **Objectif d'échéance (jours)**
- **Modifier le label** change ensuite ces données
- **Supprimer le label** retire le label et indique au préalable sur combien de tâches il se trouve. Le label disparaît de toutes ces tâches

Vous pouvez aussi créer un label pendant que vous modifiez une tâche : saisissez le nom dans le champ **Labels** et choisissez **Créer [nom]**.

## Définir une échéance automatiquement [#een-deadline-automatisch-instellen]

<DocScreenshot src="/screenshots/taken/task-label-dialog.png" alt="Boîte de dialogue de création de label avec le nom, la description, la couleur et l'objectif d'échéance" />

Pour un label, vous pouvez renseigner l'**Objectif d'échéance (jours)**, par exemple *7*. Une tâche sans échéance qui reçoit ce label obtient alors elle-même une échéance : autant de jours plus tard à partir du moment où la tâche a été créée ou où le label a été ajouté.

- Cela se produit à la création d'une tâche avec le label, ou si vous ajoutez le label plus tard
- Si la tâche a déjà une échéance, elle reste inchangée
- Si une tâche a plusieurs labels avec un objectif, c'est le plus petit nombre de jours qui s'applique
- Si vous laissez le champ vide, le label ne définit pas d'échéance

C'est pratique pour des labels comme *Plainte* (sous 2 jours) ou *Suivre un devis* (sous 7 jours).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Vous pouvez tout de suite attribuer un nouveau label à des tâches, dans la tâche elle-même et dans le menu rapide.
- Un label avec un **Objectif d'échéance (jours)** donne dès lors automatiquement une échéance aux tâches qui n'en ont pas.
- Si vous supprimez un label, il disparaît de toutes les tâches sur lesquelles il se trouvait. Les tâches restent.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas la page Labels de tâches">
Vous n'avez pas le droit de consulter les paramètres généraux de votre organisation. Demandez à un administrateur d'adapter vos droits.
</Accordion>
<Accordion title="Tillor indique Échec de la création du label">
Renseignez un **Nom** (50 caractères au maximum) et réessayez. Pour la modification et la suppression, les messages s'intitulent **Échec de la mise à jour du label** et **Échec de la suppression du label**.
</Accordion>
<Accordion title="Ma tâche n'a pas reçu d'échéance du label">
Une échéance issue du label n'est ajoutée qu'aux tâches sans échéance. Si la tâche en a déjà une, elle reste. Avec plusieurs labels ayant un objectif, c'est le plus petit nombre de jours qui s'applique.
</Accordion>
</Accordions>


# Notifications (/fr-FR/taken/meldingen)

Tillor vous tient informé des tâches par e-mail et par notifications push.

## Rappels et échéances [#herinneringen-en-deadlines]

Si une tâche a un **Rappel** ou une **Échéance**, vous choisissez dans la fenêtre de détails, sous **Notifications**, si vous voulez un **E-mail** et/ou une **Notification push**. Les deux sont activés par défaut. Si vous les désactivez tous les deux, personne ne reçoit de notification pour cette tâche.

- Un rappel se déclenche au moment défini, avec le titre *Rappel de tâche*
- Une notification d'échéance se déclenche dès que l'échéance est atteinte et que la tâche n'est pas encore terminée
- Les tâches terminées ne donnent plus de rappel ni de notification d'échéance
- Un rappel récurrent se déclenche à chaque répétition, jusqu'à ce que la tâche soit terminée ou que le calendrier prenne fin

La notification est envoyée aux collègues assignés, y compris aux membres d'un groupe assigné. Si personne n'est assigné, elle est envoyée à la personne qui a créé la tâche. L'e-mail montre un aperçu de la tâche, avec le statut et un bouton pour l'ouvrir.

## Assigner, désassigner et terminer [#toewijzen-ontkoppelen-en-voltooien]

- Si une tâche vous est assignée, y compris via un groupe dont vous faites partie, vous recevez une notification (**Nouvelle tâche assignée**). Si vous vous assignez une tâche à vous-même, vous ne recevez pas de notification
- Si quelqu'un vous retire d'une tâche, vous recevez une notification indiquant que la tâche est **désassignée** (**Tâche désassignée**)
- Quand une tâche est terminée, les collègues assignés et la personne qui l'a créée reçoivent une notification, sauf la personne qui a terminé la tâche. La notification est envoyée avec environ une minute de retard. Si quelqu'un rouvre la tâche dans ce délai, elle n'est plus envoyée

## Suivre une vue [#een-weergave-volgen]

Avec **Suivre** (en haut à droite d'une vue enregistrée), vous recevez chaque matin à 07:00 un e-mail avec un résumé de cette vue. L'e-mail a pour objet *Résumé quotidien* avec le nom de la vue, et contient trois listes :

- **En retard** : tâches ouvertes dont l'échéance est dépassée
- **Dû aujourd'hui** : tâches ouvertes qui doivent être terminées aujourd'hui
- **Modifié depuis le dernier résumé** : tâches ouvertes qui ont été modifiées depuis votre dernier résumé

Chaque liste affiche au maximum 15 tâches avec l'échéance. En bas se trouve le bouton **Ouvrir la vue**, qui mène directement à la vue.

- S'il n'y a rien dans les trois listes, vous ne recevez pas d'e-mail ce jour-là
- Le bouton devient **Suivie**. Cliquez dessus pour arrêter de suivre. Vous pouvez suivre toute vue que vous pouvez voir, y compris les vues de collègues
- Si vous perdez l'accès à la vue, par exemple parce que le propriétaire la rend uniquement accessible à lui-même ou la supprime, vous arrêtez automatiquement de la suivre
- Vous ne voyez que les tâches que vous avez vous-même le droit de voir

<Callout type="info">
La vue intégrée **Toutes** ne peut pas être suivie, car ce n'est pas une vue enregistrée.
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne reçois pas de rappel ni de notification d'échéance">
Vérifiez dans la tâche, sous **Notifications**, que **E-mail** ou **Notification push** est activé. Une notification est envoyée aux collègues assignés, ou à la personne qui a créé la tâche si personne n'est assigné. Les tâches terminées ne donnent plus de notification.
</Accordion>
<Accordion title="Je ne reçois pas de notification quand je m'assigne une tâche">
C'est normal. Vous ne recevez une notification **Nouvelle tâche assignée** que si quelqu'un d'autre vous assigne la tâche.
</Accordion>
<Accordion title="Je ne reçois pas le résumé quotidien">
Soit vous ne suivez pas la vue (le bouton **Suivre** doit afficher **Suivie**), soit il n'y a rien dans **En retard**, **Dû aujourd'hui** et **Modifié depuis le dernier résumé**. Nous n'envoyons alors pas d'e-mail ce jour-là. Vous arrêtez aussi automatiquement de suivre si vous n'avez plus le droit de voir la vue.
</Accordion>
<Accordion title="Tillor indique Impossible de mettre à jour le suivi">
La modification n'a pas été enregistrée. Cliquez de nouveau sur **Suivre**.
</Accordion>
</Accordions>


# Tâches privées (/fr-FR/taken/prive-taken)

Une tâche est privée si elle ne se trouve que dans des vues personnelles. Vous n'avez rien à configurer pour cela : les vues dans lesquelles se trouve une tâche déterminent qui la voit.

## Les règles [#de-regels]

| Où se trouve la tâche | Qui la voit |
|---|---|
| Dans aucune vue | Tous les utilisateurs de l'organisation |
| Dans au moins une vue **Publique** | Tous les utilisateurs de l'organisation |
| Uniquement dans des vues personnelles (**Vous seul** ou **Partagée**) | La personne qui a créé la tâche, les collègues et groupes assignés, ainsi que le propriétaire et les personnes et groupes choisis de ces vues |

Les sous-tâches suivent leur tâche parente. Une tâche que vous n'avez pas le droit de voir n'apparaît nulle part : ni dans les listes, les résultats de recherche, les filtres, le tableau de bord, chez un client, dans le calendrier ou dans les notifications, et vous ne pouvez pas non plus l'ouvrir via un lien.

## Exemple [#voorbeeld]

Jan crée la vue personnelle *Mes idées* avec la visibilité **Vous seul**. Il ajoute la tâche *Demander un devis pour la nouvelle barrière* à cette liste.

- Seul Jan voit la tâche. Ses collègues ne la voient nulle part
- Jan assigne la tâche à Piet. Piet voit alors aussi la tâche, même s'il n'a jamais vu la vue de Jan
- Jan partage *Mes idées* avec Els (**Partagée**). Els voit alors aussi la tâche
- Jan ajoute la tâche à la vue *Entretien*, qui est **Publique**. À partir de là, toute l'équipe voit la tâche
- Si Jan retire la tâche de *Entretien* et qu'elle ne se trouve dans aucune autre vue publique, elle redevient privée

Si Jan n'avait mis la tâche dans aucune vue, tout le monde l'aurait vue.

## Qui détermine la visibilité d'une vue [#wie-bepaalt-de-zichtbaarheid-van-een-weergave]

Seul le propriétaire d'une vue personnelle peut modifier les personnes avec lesquelles la vue est partagée, ou la rendre **Publique**. Un collègue avec qui vous partagez la vue peut modifier les tâches de la vue, mais pas la visibilité, et il ne peut pas non plus supprimer la vue. Voir [Vues](/taken/weergaven#wie-ziet-een-weergave).

<Callout type="warn">
Ajouter une tâche privée à une vue publique la rend visible pour tout le monde. Tillor demande d'abord de le confirmer avec **Rendre cette tâche publique ?**. Vous pouvez alors choisir **Garder privée** ou **Rendre publique**. La même question apparaît si vous retirez la tâche de sa dernière vue publique. Si vous rendez **Publique** une vue personnelle qui contient des tâches, ces tâches deviennent visibles pour tout le monde sans question distincte.
</Callout>

## Conseils [#tips]

- Si vous voulez transmettre une tâche privée, assignez-la à un collègue ou partagez la vue avec ce collègue
- Une tâche compte comme « dans une vue » dès que vous l'ajoutez à une liste ou la placez dans une colonne personnalisée de la vue. Le simple affichage via un filtre ne fait pas qu'elle se trouve dans la vue
- Les notifications concernant une tâche privée, comme une échéance, ne sont envoyées qu'aux personnes qui ont le droit de voir la tâche

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Un collègue ne voit pas ma tâche">
La tâche ne se trouve que dans des vues personnelles. Assignez-la au collègue, partagez la vue avec lui, ou placez la tâche dans une vue publique.
</Accordion>
<Accordion title="Tillor demande Rendre cette tâche publique ?">
Vous ajoutez une tâche privée à une vue publique, ou vous la retirez de sa dernière vue publique. Choisissez **Garder privée** ou **Rendre publique**.
</Accordion>
<Accordion title="Je ne vois plus une tâche que j'avais hier">
Peut-être la tâche est-elle liée à une autre vue, ou la vue dans laquelle elle se trouvait n'est-elle plus visible pour vous. Demandez à la personne qui l'a créée ou au propriétaire de la vue.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Vues" href="/taken/weergaven" />
  <Card title="Détails d'une tâche" href="/taken/taakdetails" />
</Cards>


# Détails d'une tâche (/fr-FR/taken/taakdetails)

Dans la fenêtre de détail d'une tâche, vous enregistrez tout : qui s'en occupe, pour quand elle doit être terminée, combien de temps elle représente et à quoi elle est liée. Cliquez sur une tâche pour ouvrir la fenêtre. À gauche se trouvent le nom, la description et des éléments comme les sous-tâches et les commentaires. À droite se trouvent les propriétés comme le statut, la priorité et l'échéance. Les modifications d'une tâche existante sont enregistrées immédiatement. Vous n'enregistrez vous-même que la description, avec **Enregistrer**.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Fenêtre d'une tâche avec la description, les sous-tâches, les commentaires et, à droite, les propriétés, les champs personnalisés, les éléments liés et les pièces jointes" />

Vous pouvez aussi ouvrir une tâche directement avec un lien. Copiez-le via le menu à trois points en haut à droite de la fenêtre, voir [Le menu de la tâche](#het-menu-van-de-taak).

## Créer une tâche [#een-taak-aanmaken]

Vous créez des tâches à différents endroits : en haut d'une colonne d'un tableau (**Nouvelle tâche**), dans la carte **Tâches pour vous** du tableau de bord, sur la page d'un client, ou depuis une conversation, une facture ou un autre élément, voir [Tâches sur d'autres pages](/taken/taken-op-andere-paginas).

1. Cliquez sur **Nouvelle tâche**
2. Saisissez un **Nom**. Le reste est facultatif
3. Ajoutez éventuellement des sous-tâches avec **Ajouter une sous-tâche** : saisissez un nom et appuyez sur Entrée. Vous pouvez en ajouter jusqu'à 50
4. Cliquez sur **Créer**, ou appuyez sur Cmd ou Ctrl avec Entrée

<DocScreenshot src="/screenshots/taken/task-create-dialog.png" alt="Boîte de dialogue Nouvelle tâche avec un nom et deux sous-tâches" />

En haut de la fenêtre se trouve la vue dans laquelle la tâche sera placée. Si vous créez la tâche depuis une colonne d'un tableau, elle reçoit automatiquement cette vue et cette colonne. Vous pouvez en choisir une autre ou retirer la vue.

Vous êtes indiqué vous-même comme personne assignée. Si vous vous retirez et ne choisissez personne, la tâche n'a aucune personne assignée. Vous ajoutez les blocages et le temps passé une fois la tâche créée.

## Propriétés [#eigenschappen]

- **Statut** et **Priorité** : voir l'[aperçu](/taken#statussen)
- **Assigné à** : un ou plusieurs collègues ou [groupes](/gebruikers/groepen). Cherchez avec **Rechercher des personnes ou des groupes...**. Si vous assignez un groupe, la tâche concerne tous ceux qui font partie du groupe à ce moment-là
- **Clients** : liez un ou plusieurs clients avec **Ajouter un client**
- **Labels** : voir [Labels](/taken/labels). Vous créez directement un label manquant en saisissant son nom et en choisissant **Créer [nom]**
- **Date d'échéance** : la date limite, avec l'heure. Si l'échéance est dépassée, le temps relatif devient rouge
- **Rappel** : une date et une heure auxquelles vous souhaitez une notification, éventuellement récurrente
- **Notifications** : dès qu'un rappel ou une échéance est défini, vous choisissez si vous voulez un **E-mail** et/ou une **Notification push**. Les deux sont activés par défaut
- **Créée par** : la personne qui a créé la tâche
- **Champs personnalisés** : des champs que votre organisation a elle-même ajoutés aux tâches. Les modifications sont enregistrées immédiatement. Voir [Champs personnalisés](/eigen-velden)
- **Vue** : cliquez en haut à gauche sur le nom de la vue pour choisir dans quelles listes la tâche se trouve et dans quelle colonne. Pour une vue filtrée, vous ne choisissez qu'une colonne
- **Privée** : si un petit cadenas avec **Privée** est affiché, la tâche ne se trouve que dans des vues personnelles, voir [Tâches privées](/taken/prive-taken)

Une tâche peut aussi avoir une **Description**. Elle prend en charge Markdown pour la mise en forme.

## Rappels récurrents [#herhalende-herinneringen]

Un rappel peut se répéter jusqu'à ce que la tâche soit terminée :

1. Définissez d'abord un **Rappel** (date et heure)
2. Cliquez sur le champ de répétition en dessous (par défaut **Ne se répète pas**)
3. Choisissez **Quotidien**, **Tous les jours ouvrés (lun – ven)**, **Hebdomadaire**, **Mensuel**, **Annuel** ou **Personnalisé…**

Avec **Personnalisé…**, vous composez votre propre planning :

- **Répéter tous les** : un nombre de jours, de semaines, de mois ou d'années
- **Répéter le** : pour un planning hebdomadaire, les jours de la semaine où le rappel peut arriver
- **Se termine** : **Jamais**, **À une date** ou **Après** un certain nombre de fois

Si un rappel tombe un jour que vous avez exclu, il passe sans notification au prochain jour autorisé. La répétition s'arrête dès que la tâche est **Terminé** ou que le planning se termine.

## Éléments liés [#gekoppelde-items]

Sous **Éléments liés**, vous voyez à quoi la tâche est rattachée. Vous pouvez y lier plusieurs éléments de chaque sorte : terrains, factures, réservations, compteurs, appels téléphoniques, transactions bancaires, produits et conversations de la boîte de réception. Une tâche peut aussi être liée à un commentaire. Vous créez une tâche à propos d'une transaction bancaire depuis le menu de la transaction sous **Transactions bancaires** avec **Créer une tâche**. Vous créez une tâche à propos d'un produit, par exemple la vérification du compte du grand livre, sur la page du produit via le menu **⋯** avec **Créer une tâche** ; les tâches ouvertes du produit se trouvent en haut de cette page.

Vous liez un élément supplémentaire avec le petit plus à côté de **Éléments liés** (info-bulle **Lier un élément**). Cherchez un client, un terrain, un compteur, une facture, une réservation ou un produit. Si l'élément choisi appartient à un client, Tillor demande **Lier aussi [client] ?** :

- **Lier les deux** : la tâche apparaît aussi chez le client
- **Seulement cet élément** : le client n'est pas lié à la tâche

Avec **Dissocier**, vous supprimez à nouveau un lien. Les tâches liées qui sont encore ouvertes apparaissent sur la page de l'élément sous **Tâches ouvertes**.

## Pièces jointes [#bijlagen]

Sous **Pièces jointes**, vous ajoutez des fichiers à la tâche. Cliquez sur le petit plus, ou collez un fichier avec Cmd ou Ctrl et V n'importe où dans la fenêtre.

## Sous-tâches [#subtaken]

Une tâche peut avoir des sous-tâches, une checklist dans la fenêtre de détail. Il n'y a qu'un seul niveau : une sous-tâche ne peut pas avoir elle-même de sous-tâches.

1. Ouvrez la tâche parente, ou remplissez-les déjà pendant que vous créez une tâche
2. Sous **Ajouter une sous-tâche**, saisissez un nom et appuyez sur Entrée
3. Cochez une sous-tâche pour la passer à **Terminé**. Cochez-la à nouveau pour la remettre en arrière
4. Cliquez sur le nom pour la renommer, ou sur la corbeille pour la supprimer
5. Faites glisser une sous-tâche par la poignée pour modifier l'ordre. Avec **Ajouter une description**, vous donnez aussi une description à une sous-tâche

Pour une nouvelle tâche, les sous-tâches sont créées en même temps que la tâche, dans l'ordre où vous les avez saisies. Les sous-tâches n'apparaissent pas comme carte distincte dans les tableaux, les tables ou le calendrier. Sur la tâche, vous voyez un compteur comme **2/5**. Si vous passez la tâche parente à **Terminé**, toutes les sous-tâches ouvertes sont aussi terminées. L'inverse n'est pas nécessaire : vous pouvez terminer la tâche parente alors que des sous-tâches sont encore ouvertes.

## Blocages et dépendances [#blokkades-en-afhankelijkheden]

Parfois, une tâche ne peut démarrer ou se terminer que si une autre est terminée. Vous l'enregistrez dans la fenêtre de détail :

- **Bloquée par** : les tâches qui doivent d'abord être terminées. Ajoutez-les avec **Ajouter une tâche bloquante**
- **Bloque d'autres tâches** : les tâches qui attendent cette tâche. Ajoutez-les avec **Ajouter une tâche bloquée**

Pour chaque groupe, vous voyez combien de tâches sont encore ouvertes (par exemple **2 encore ouvertes**). Cherchez des tâches avec **Rechercher des tâches...** et supprimez un lien avec **Supprimer le lien**. Sur la carte de la tâche, une ligne comme **Bloquée par 1 tâche** figure sous le nom. Vous pouvez filtrer sur les tâches bloquées, voir [Filtrer](/taken/filteren).

Un blocage ne vous arrête pas. Si vous essayez de cocher une tâche bloquée, Tillor demande **Terminer une tâche bloquée ?** et ne la termine que si vous choisissez **Terminer quand même**.

Vous ajoutez aussi un blocage via le menu à trois points en haut à droite de la fenêtre, avec **Ajouter une tâche bloquante** et **Ajouter une tâche bloquée**.

## Temps passé [#bestede-tijd]

À côté de **Temps passé** dans la fenêtre de détail se trouve le total. Cliquez dessus pour enregistrer du temps.

<DocScreenshot src="/screenshots/taken/task-time-popover.png" alt="Temps passé avec le bouton Démarrer, un champ de saisie pour un enregistrement manuel et les enregistrements des collègues" />

Vous avez deux manières :

- Un **chronomètre**. Cliquez sur **Démarrer**, travaillez sur la tâche et cliquez sur le bouton d'arrêt quand vous avez terminé. Le temps est inscrit sur la tâche, secondes comprises
- **Saisir après coup**. Saisissez la durée, par exemple **1:30**, **90** (minutes), **1u 30m** ou **1.5h**. Les quatre signifient une heure et demie. Ajoutez éventuellement une note sous **Qu'avez-vous fait ? (facultatif)** et cliquez sur **Enregistrer**

Le temps est enregistré au jour d'aujourd'hui. Dans la liste, vous voyez pour chaque enregistrement qui l'a fait, la date, la note et la durée. Les collègues voient les enregistrements des uns et des autres, mais vous ne pouvez supprimer que les vôtres, via la corbeille qui apparaît quand vous passez la souris sur la ligne.

### Le chronomètre [#de-timer]

- Un chronomètre en cours continue de tourner si vous allez sur une autre page. Il apparaît alors sous forme de petite carte en bas à droite, avec des boutons pour mettre en pause (**Mettre en pause**), reprendre (**Reprendre**), **Pointer** et arrêter (**Terminer**). Cliquez sur le nom de la tâche pour y retourner
- Avec **Pointer**, vous enregistrez la partie écoulée jusqu'à maintenant, avec une courte note sur ce que vous faisiez, puis le chronomètre continue de tourner
- Vous ne pouvez suivre le temps que sur une seule tâche à la fois. Tant que votre chronomètre tourne, **Démarrer** est désactivé sur les autres tâches
- Si vous n'utilisez ni la souris ni le clavier pendant dix minutes, le chronomètre se met en pause au dernier moment où vous étiez actif
- Dans la fenêtre de la tâche, les collègues voient que vous êtes en cours (**En cours**) ou en pause (**En pause**). Ce temps ne compte dans le total qu'une fois enregistré

## Commentaires et activité [#opmerkingen-en-activiteit]

En bas de la fenêtre se trouve la section **Commentaires**. Avec **Ajouter un commentaire**, vous écrivez un commentaire. Vous pouvez mentionner des collègues dans un commentaire, afin qu'ils reçoivent une notification. En dessous se trouve l'**activité** : une chronologie de la création et des modifications, avec, pour une modification, ce qu'il y avait avant et après.

## Le menu de la tâche [#het-menu-van-de-taak]

En haut à droite de la fenêtre se trouve un menu à trois points.

<DocScreenshot src="/screenshots/taken/task-dialog-menu.png" alt="Menu de la tâche avec ajout de blocages, Imprimer, Copier le lien et Supprimer" />

- **Ajouter une tâche bloquante** et **Ajouter une tâche bloquée** enregistrent une dépendance
- **Imprimer** propose trois choix. **Imprimer (A4)** ouvre la boîte de dialogue d'impression de votre navigateur avec un PDF de la tâche. **Envoyer à l'imprimante A4** et **Envoyer à l'imprimante thermique (POS)** envoient la tâche à votre imprimante, par exemple une imprimante de tickets de caisse. Vous ne pouvez choisir ces deux options que si votre organisation a un [connecteur](/connector) avec imprimante, voir [Imprimante](/printer)
- **Copier le lien** copie un lien qui ouvre directement la tâche. Celui qui ouvre le lien doit avoir le droit de voir la tâche
- **Supprimer** se trouve tout en bas, voir [Supprimer une tâche](#een-taak-verwijderen)

L'impression montre le nom, le statut, la priorité, l'échéance et la description, et sous **Éléments liés** les clients, factures, réservations, terrains et compteurs auxquels la tâche est rattachée. S'il y a des blocages sur la tâche, les tâches qui la bloquent et celles qu'elle bloque y figurent aussi. Un groupe sans éléments est omis.

## Tâches avec boutons de choix [#taken-met-keuzeknoppen]

Certaines tâches, par exemple issues d'une [automatisation avec l'étape Demander une décision](/automatiseringen/logica#vraag-om-een-beslissing), demandent une décision. À la place d'une case à cocher, la tâche affiche des boutons, avec au-dessus **Choisissez une action pour terminer cette tâche**. Vous cliquez sur un bouton et la tâche est terminée.

- Si le choix demande une raison, Tillor ouvre d'abord une fenêtre avec **Pourquoi ce choix ?** où vous saisissez une note
- Si le choix demande une confirmation, Tillor affiche d'abord une fenêtre. Un choix effectué ne peut plus être annulé depuis la tâche
- Ensuite, la tâche indique quel choix a été fait et par qui
- Peut choisir la personne assignée à la tâche et un administrateur. Si personne n'est assigné, tous ceux qui voient la tâche peuvent choisir

Voici comment la tâche et l'automatisation sont liées :

```mermaid
flowchart TD
  A["L'automatisation atteint l'étape<br/>Demander une décision"] --> B["Tillor crée une tâche avec vos boutons<br/>et l'automatisation attend"]
  B --> C{"Un collègue choisit un bouton"}
  C -- "Une option" --> D["La tâche passe à Terminé<br/>l'automatisation continue via cette option"]
  C -- "Personne ne choisit dans le délai" --> E["L'automatisation continue via Délai dépassé<br/>la tâche reste"]
  C -- "La tâche est supprimée" --> E
```

Une tâche créée par une automatisation et qui ne peut être terminée que par le flux affiche, à la place d'une case à cocher, le texte **Terminée par son automatisation**. Vous ne pouvez alors pas la terminer et elle n'a pas de **Supprimer** dans le menu.

## Changer rapidement le statut et cocher [#status-snel-wijzigen-en-afvinken]

Sans ouvrir la fenêtre, vous pouvez :

- Cocher la case à gauche du nom de la tâche pour la passer à **Terminé**. Si vous la décochez, elle repasse à **En cours**
- Cliquer sur les trois points de la carte de la tâche, ou faire un clic droit sur la carte, pour un menu rapide avec **Modifier**, **Statut**, **Priorité**, **Rappel**, **Date d'échéance**, **Labels**, **Vues** et **Supprimer**. **Labels** n'y figure que s'il existe des labels et **Vues** seulement s'il existe des listes auxquelles vous ajoutez vous-même des tâches

<DocScreenshot src="/screenshots/taken/task-actions-menu.png" alt="Menu rapide d'une carte de tâche" />

## Supprimer une tâche [#een-taak-verwijderen]

Choisissez **Supprimer** dans le menu rapide de la tâche, ou dans le menu à trois points de la fenêtre de la tâche, et confirmez. Cela ne peut pas être annulé et les éventuelles sous-tâches disparaissent avec elle. La suppression est enregistrée dans le [journal d'activité](/activiteitenlog).

Pour une tâche que seule une automatisation peut terminer, **Supprimer** ne figure pas dans le menu. Si une telle tâche est quand même supprimée d'une autre manière, l'automatisation qui attendait sa fin échoue.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les modifications d'une tâche existante sont enregistrées immédiatement. Vous n'enregistrez vous-même que la description, avec **Enregistrer**.
- Si vous assignez la tâche, ce collègue (ou les membres du groupe) reçoit une notification. Voir [Notifications](/taken/meldingen).
- Si vous passez la tâche à <Status tone="success">Terminé</Status>, les sous-tâches ouvertes sont aussi terminées et les collègues assignés ainsi que la personne qui l'a créée reçoivent une notification, sauf vous. La tâche descend vers le bas dans une liste triée manuellement.
- Un rappel ou une échéance génère une notification jusqu'à ce que la tâche soit terminée.
- Une tâche créée par une [automatisation](/automatiseringen/acties/taken) peut elle-même démarrer une automatisation, par exemple lors d'un changement de statut ou quand quelqu'un choisit un bouton de choix.
- La suppression ne peut pas être annulée. Elle est enregistrée dans le [journal d'activité](/activiteitenlog).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor demande Terminer une tâche bloquée ?">
La tâche attend encore une ou plusieurs tâches non terminées (voir **Bloquée par**). Terminez d'abord ces tâches, ou choisissez **Terminer quand même**.
</Accordion>
<Accordion title="Je vois un texte à la place d'une case à cocher">
Avec **Terminée par son automatisation**, vous ne pouvez pas terminer la tâche vous-même. L'automatisation la termine. Si la tâche a des boutons sous **Choisissez une action pour terminer cette tâche**, cliquez sur un bouton.
</Accordion>
<Accordion title="Je ne peux pas utiliser les boutons d'une tâche">
Peut choisir la personne assignée à la tâche et un administrateur. Si personne n'est assigné, tous ceux qui voient la tâche peuvent choisir. En cas de message d'erreur **Impossible d’enregistrer le choix**, réessayez.
</Accordion>
<Accordion title="Le bouton Démarrer du chronomètre est grisé">
Votre chronomètre tourne déjà sur une autre tâche. Vous ne pouvez suivre le temps que sur une seule tâche à la fois. Arrêtez d'abord ce chronomètre.
</Accordion>
<Accordion title="Mon chronomètre s'est arrêté pendant que je travaillais">
Après dix minutes sans souris ni clavier, le chronomètre se met en pause au dernier moment où vous étiez actif. Utilisez **Reprendre** pour continuer.
</Accordion>
<Accordion title="L'enregistrement du temps échoue">
Saisissez une durée que Tillor comprend, comme **1:30**, **90**, **1u 30m** ou **1.5h**. Si cela échoue quand même, le message **Impossible d'enregistrer le temps** s'affiche et vous réessayez. Vous ne pouvez supprimer que vos propres enregistrements.
</Accordion>
<Accordion title="L'impression vers l'imprimante est impossible">
Vous ne pouvez choisir **Envoyer à l'imprimante A4** et **Envoyer à l'imprimante thermique (POS)** que si votre organisation a un connecteur avec imprimante. **Imprimer (A4)** fonctionne toujours. En cas de problème, le message **Impossible de générer le PDF de la tâche** s'affiche.
</Accordion>
<Accordion title="Tillor indique Impossible de mettre à jour la tâche">
La modification n'a pas été enregistrée. Réessayez ou actualisez la page.
</Accordion>
<Accordion title="Je ne peux pas supprimer une tâche">
Pour une tâche que seule une automatisation peut terminer, **Supprimer** ne figure pas dans le menu. Pour le reste, tout collègue qui voit la tâche peut la supprimer.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Vues" href="/taken/weergaven" />
  <Card title="Labels" href="/taken/labels" />
  <Card title="Tâches dans les automatisations" href="/automatiseringen/acties/taken" />
</Cards>


# Tâches sur d'autres pages (/fr-FR/taken/taken-op-andere-paginas)

Les tâches ne vivent pas sur une île. Vous les créez depuis l'élément dont elles parlent, et vous les y retrouvez aussi.

## Créer une tâche depuis un autre élément [#een-taak-maken-vanuit-een-ander-item]

La tâche est automatiquement liée à l'élément. Si un client est concerné, vous pouvez aussi le lier. Par défaut, la tâche vous est assignée.

| Où | Bouton |
|---|---|
| Page client | **Créer une tâche** dans le menu d'actions du client |
| Facture | **Créer une tâche** dans le menu d'actions |
| Compteur | **Créer une tâche** dans le menu d'actions |
| Réservation | **Créer une tâche** |
| Terrain | **Créer une tâche** |
| Conversation dans la boîte de réception | **Créer une tâche** |
| Appel téléphonique | **Créer une tâche** |
| Commentaire | L'icône de tâche à côté du commentaire (info-bulle **Créer une tâche à partir de ce commentaire**) |
| Transaction bancaire | **Créer une tâche** dans le menu d'actions de la transaction sous <UIPath>Administration > Transactions bancaires</UIPath> |

## Un rappel de suivi sur un commentaire [#een-opvolgherinnering-bij-een-opmerking]

À côté d'un commentaire se trouve aussi une petite horloge pour vous rappeler (ou rappeler aux collègues mentionnés) de donner suite au commentaire. Vous créez ainsi une tâche comme *Donner suite à ce commentaire* ou *Vérifier que [nom] l'a bien pris en compte*. Si vous marquez ensuite le commentaire comme traité, cette tâche de suivi est automatiquement terminée.

## Tâches ouvertes sur un élément [#openstaande-taken-bij-een-item]

Sur la page d'un client, d'une réservation, d'une facture, d'un terrain et d'un compteur se trouve un bloc **Tâches ouvertes** avec les tâches qui ne sont pas encore terminées et qui sont rattachées à cet élément. S'il n'y a pas de tâches ouvertes, le bloc n'apparaît pas.

Sur la page <UIPath>Clients > [client] > Tâches</UIPath> se trouvent toutes les tâches du client. Vous l'ouvrez via l'onglet **Tâches** de la page client. Les tâches terminées sont repliées sous **Tâches terminées**, avec leur nombre.

<DocScreenshot src="/screenshots/taken/customer-tasks.png" alt="Onglet Tâches sur une page client avec Nouvelle tâche et les tâches du client" />

## Sur le tableau de bord [#op-het-dashboard]

La carte **Tâches pour vous** affiche les tâches qui vous sont assignées. Avec l'étoile, vous choisissez une vue favorite que vous voulez y voir à la place, voir [Vues](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). Vous pouvez aussi y créer directement une tâche ou partager les tâches.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La tâche est rattachée à l'élément depuis lequel vous l'avez créée. Vous la voyez sous **Éléments liés** dans la tâche.
- Tant que la tâche n'est pas terminée, elle figure dans le bloc **Tâches ouvertes** sur la page de cet élément et du client lié.
- Une tâche de suivi sur un commentaire est terminée automatiquement quand vous marquez le commentaire comme traité.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je ne vois pas Créer une tâche">
Sur certaines pages, le bouton se trouve dans le menu d'actions, comme pour un client, une facture ou un compteur. Cherchez-y les trois points.
</Accordion>
<Accordion title="Le bloc Tâches ouvertes est absent">
Le bloc n'apparaît que s'il reste des tâches non terminées rattachées à l'élément.
</Accordion>
<Accordion title="Tillor indique Impossible de créer la tâche">
La tâche n'a pas été enregistrée. Saisissez un nom et réessayez.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Détails d'une tâche" href="/taken/taakdetails" />
  <Card title="Vues" href="/taken/weergaven" />
</Cards>


# Vues (/fr-FR/taken/weergaven)

En haut de la page **Tâches** se trouve une rangée d'onglets. Chaque onglet est une vue. Le premier onglet, **Toutes**, est intégré : il affiche chaque tâche et vous ne pouvez ni le modifier, ni le déplacer, ni le supprimer. Vous pouvez toutefois y enregistrer des filtres et des paramètres d'affichage pour toute l'organisation. Vous créez vous-même toutes les autres vues.

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Onglets de vues en haut de la page des tâches" />

## Deux sortes de vues [#twee-soorten-weergaven]

Lors de la création, vous choisissez le type de vue sous **Contenu**.

| Type | Ce que cela fait |
|---|---|
| **Vue filtrée** | Affiche chaque tâche qui correspond aux filtres, comme une recherche enregistrée. Les nouvelles tâches correspondantes apparaissent automatiquement |
| **Liste** | N'affiche que les tâches que vous y ajoutez vous-même |

Une liste est pratique pour un ensemble fixe, par exemple *Préparation de la saison*. Une vue filtrée est pratique pour tout ce qui répond à une règle, par exemple *Toutes les tâches urgentes qui attendent le client*.

Vous pouvez modifier le type plus tard dans **Affichage** (en haut à droite) sous **Type**. Vous ne le faites pas pour **Toutes**. Si vous convertissez une liste en vue filtrée, les tâches que vous y aviez ajoutées à la main en sont détachées. Tillor demande d'abord de le confirmer, car cela ne peut pas être annulé.

## Créer une vue [#een-weergave-aanmaken]

1. Cliquez sur **Nouvelle vue**, à droite des onglets
2. Saisissez un **Nom** et éventuellement une **Description**
3. Choisissez sous **Visibilité** qui voit la vue : **Public**, **Vous seul** ou **Partagé**. Pour **Partagé**, vous choisissez sous **Partager avec** les collègues et les groupes
4. Choisissez sous **Contenu** une **Vue filtrée** ou une **Liste**
5. Choisissez sous **Colonnes** comment les tâches sont réparties : **Colonnes personnalisées**, **Statut**, **Assigné à** ou **Aucun regroupement**
6. Choisissez sous **Commencer avec** un filtre de départ : **Toutes les tâches**, **Tâches ouvertes** ou **Mes tâches**
7. Cliquez sur **Nouvelle vue** en bas de la boîte de dialogue

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Boîte de dialogue Nouvelle vue" />

Au départ, la vue est réglée sur **Public**, **Vue filtrée**, **Statut** et **Tâches ouvertes**. Si vous choisissez **Aucun regroupement**, vous obtenez une table. Avec les autres choix, vous commencez avec un tableau. Vous l'adaptez plus tard, voir [Table, tableau et calendrier](/taken/indelingen).

Une vue filtrée réglée comme table ressemble à ceci. Les filtres se trouvent au-dessus de la table et sont déjà enregistrés ici.

<DocScreenshot src="/screenshots/taken/task-view-filtered.png" alt="Vue filtrée Tâches urgentes sous forme de table, avec des filtres sur la priorité et le statut" />

## Qui voit une vue [#wie-ziet-een-weergave]

| Choix | Qui voit la vue |
|---|---|
| **Public** | Tous les utilisateurs de l'organisation (une vue d'organisation) |
| **Vous seul** | Vous seul (une vue personnelle). Un petit cadenas figure sur l'onglet |
| **Partagé** | Vous et les collègues et groupes que vous choisissez sous **Partager avec**. Une icône de plusieurs personnes figure sur l'onglet |

Sous **Partager avec**, vous choisissez des personnes et des groupes dans la même liste. Un [groupe](/gebruikers/groepen) compte tel qu'il est composé à ce moment-là : celui qui rejoint le groupe plus tard voit aussi la vue, et celui qui quitte le groupe ne la voit plus.

Seul le propriétaire d'une vue personnelle peut modifier les personnes avec lesquelles elle est partagée ou la rendre visible pour tout le monde. Les collègues avec qui vous partagez la vue peuvent y travailler, mais ne peuvent pas décider qui la voit en plus, ni la supprimer. Si vous rendez une vue **Publique**, la liste des personnes et groupes choisis disparaît.

<Callout type="warn">
La visibilité d'une vue détermine aussi qui voit les tâches de cette vue. Lisez [Tâches privées](/taken/prive-taken) avant de placer des tâches dans une vue personnelle.
</Callout>

## Modifier, dupliquer ou supprimer une vue [#een-weergave-bewerken-dupliceren-of-verwijderen]

Faites un clic droit sur l'onglet de la vue et choisissez :

- **Modifier** : adaptez le nom, la description, la visibilité et les colonnes. Les filtres, le tri et la disposition restent comme ils étaient enregistrés. Vous ne choisissez **Contenu** et **Commencer avec** que lors de la création ; vous modifiez le type plus tard dans **Affichage**
- **Dupliquer** : crée une copie nommée *[nom] (copie)* et l'ouvre aussitôt
- **Supprimer** : après confirmation, la vue disparaît. Les tâches elles-mêmes restent et perdent seulement cette vue

Faites glisser les onglets pour modifier l'ordre. Le nouvel ordre est enregistré immédiatement.

## Enregistrer ou abandonner les modifications [#wijzigingen-opslaan-of-verwerpen]

Si vous modifiez des filtres ou des paramètres d'affichage, ils ne figurent d'abord que sur votre écran. Une barre apparaît en haut à droite avec **Modifications non enregistrées** et deux boutons :

- **Enregistrer la vue** conserve les modifications dans la vue
- **Abandonner** remet tout à la version enregistrée

Sur la vue intégrée **Toutes**, vous enregistrez les modifications pour tout le monde dans votre organisation, comme pour une vue publique. Pour cela, vous avez besoin du droit **Gérer les étiquettes et les vues partagées**. Sans ce droit, vous ne pouvez qu'**Abandonner** les modifications sur **Toutes**.

La barre de recherche (**Rechercher des tâches...**) n'est jamais enregistrée avec la vue : elle restreint seulement ce que vous voyez maintenant.

## Une vue favorite pour le tableau de bord [#een-favoriete-weergave-voor-het-dashboard]

<DocScreenshot src="/screenshots/taken/dashboard-tasks-card.png" alt="Carte du tableau de bord Tâches pour vous avec les boutons de vue favorite et de partage" />

Sur le tableau de bord, la carte **Tâches pour vous** affiche par défaut les tâches qui vous sont assignées. Vous pouvez y associer une vue à la place :

1. Cliquez sur l'étoile en haut à droite de la carte
2. Choisissez une vue dans la liste. Choisissez **Tâches pour vous** pour revenir à vos propres tâches assignées

Vous ne pouvez avoir qu'une seule vue favorite à la fois, et elle ne s'applique qu'à vous. Si la vue est supprimée plus tard ou n'est plus visible pour vous, le tableau de bord affiche à nouveau vos propres tâches.

## Suivre une vue [#een-weergave-volgen]

Avec le bouton **Suivre** en haut à droite, vous recevez chaque matin un e-mail avec ce qui demande de l'attention dans cette vue. Le fonctionnement est décrit sous [Notifications](/taken/meldingen#een-weergave-volgen).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La nouvelle vue apparaît comme onglet en haut de la page des tâches. Une vue filtrée affiche aussitôt toutes les tâches correspondantes, et les nouvelles tâches correspondantes s'y ajoutent automatiquement.
- Avec **Public**, tous les utilisateurs de votre organisation voient la vue. Avec **Vous seul**, vous seul la voyez, et avec **Partagé**, vous et les collègues et groupes choisis.
- Si vous supprimez une vue, les tâches restent. Elles perdent seulement cette vue.
- Si vous convertissez une liste en vue filtrée, les tâches que vous y aviez ajoutées à la main sont détachées.
- Une vue que vous suivez vous envoie chaque matin un résumé. Voir [Notifications](/taken/meldingen#een-weergave-volgen).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor indique que la vue n'a pas pu être créée">
Vous voyez **Échec de la création de la vue**. Vérifiez que vous avez saisi un **Nom** et réessayez. Si cela ne fonctionne toujours pas, vérifiez votre connexion internet. Lors d'une duplication, le message s'intitule **Impossible de dupliquer la vue** et la même chose s'applique.
</Accordion>
<Accordion title="Je ne peux pas modifier ni supprimer l'onglet Toutes">
**Toutes** est intégré et affiche chaque tâche que vous avez le droit de voir. Son nom, sa position et sa visibilité sont fixes. Vous pouvez en revanche y enregistrer des filtres et des paramètres d'affichage, pour toute l'organisation. Créez votre propre vue si vous voulez une sélection rien que pour vous.
</Accordion>
<Accordion title="Un collègue ne peut pas rendre la vue publique ni la supprimer">
Seul le propriétaire d'une vue personnelle décide avec qui elle est partagée, et peut la rendre publique ou la supprimer. Les collègues avec qui vous la partagez peuvent quand même y modifier des tâches.
</Accordion>
<Accordion title="Je vois la barre Modifications non enregistrées">
Vous avez modifié des filtres ou des paramètres d'affichage, et ils ne figurent encore que sur votre écran. Choisissez **Enregistrer la vue** pour les conserver ou **Abandonner** pour revenir en arrière. Sur **Toutes**, il vous faut pour cela le droit **Gérer les étiquettes et les vues partagées** ; sans ce droit, vous ne pouvez qu'y abandonner.
</Accordion>
<Accordion title="Une tâche ne figure pas dans ma liste">
Une liste n'affiche que les tâches que vous y ajoutez vous-même. Si vous voulez que tout ce qui répond à une règle y arrive automatiquement, choisissez sous **Type** une vue filtrée.
</Accordion>
<Accordion title="L'ordre des onglets n'est pas enregistré">
Tillor affiche alors **Échec de la réorganisation des vues**. Faites à nouveau glisser les onglets.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Table, tableau et calendrier" href="/taken/indelingen" />
  <Card title="Filtrer" href="/taken/filteren" />
  <Card title="Tâches privées" href="/taken/prive-taken" />
</Cards>


# Terrains (/fr-FR/terreinen)

Un terrain est un lieu de votre parc : une parcelle, un chalet, une place pour camping-car ou une place fixe. Vous créez ici vos terrains, leur donnez un type et un tarif et y rattachez des compteurs. Ensuite, vous y placez des clients avec une [occupation](/bezettingen) ou une [réservation](/reserveringen). Vous les trouvez sous <UIPath>Parc > Terrains</UIPath>.

<DocScreenshot src="/screenshots/park/terrains-list.png" alt="Aperçu des terrains avec le terrain de démonstration 12" />

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  T[Terrain] --> M[Compteurs]
  T --> Tar[Tarif calculé]
  K[Client] -->|occupation| T
  Tar --> F[Factures]
  M --> V[Consommation du client]
  V --> F
```

Tout ce qui concerne ce lieu est rattaché à un terrain. Le tarif découle de la superficie et des champs personnalisés du terrain. Les compteurs du terrain fournissent la consommation, et cette consommation va au client qui a une occupation active. Voir aussi [Gestion des compteurs](/meterbeheer#hoe-hangt-dit-samen).

<Callout type="info" title="Bon à savoir">
- Le nom est obligatoire et peut comporter 255 caractères au maximum.
- **Réservable** est désactivé par défaut pour un nouveau terrain.
- Tillor calcule la superficie dès que vous dessinez le terrain sur la carte. Vous ne la saisissez pas vous-même.
- **Terrains récents** compte les terrains des 7 derniers jours.
- Un terrain a au maximum une occupation active à la fois.
- Le tarif calculé est recalculé dès que vous enregistrez un terrain, et pour tous les terrains dès que vous enregistrez la formule du tarif.
- Si vous supprimez un type de terrain, les terrains restent, mais ils n'ont alors plus de type.
</Callout>

## Créer un nouveau terrain [#een-nieuw-terrein-aanmaken]

Avant de commencer : si vous avez besoin de types de terrain (comme **Emplacement** ou **Chalet**) ou de champs personnalisés, créez-les d'abord. Voir [Types de terrain](#terreintypes) et [Champs personnalisés](/eigen-velden).

<Steps>
<Step>
### Cliquez sur Créer un nouveau terrain [#klik-op-nieuw-terrein-aanmaken]
Vous trouvez le bouton en haut à droite de <UIPath>Parc > Terrains</UIPath>.

<DocScreenshot src="/screenshots/park/terrain-create-dialog.png" alt="Boîte de dialogue de création d'un terrain" />
</Step>
<Step>
### Saisissez les informations [#vul-de-gegevens-in]
Seul le **Nom** est obligatoire. Vous pouvez aussi renseigner :

- **Description**, une explication.
- **Type de terrain**, ou laissez **Aucun type**.
- **Champs personnalisés** que votre organisation a ajoutés elle-même, comme un supplément ou un numéro de compteur de gaz.
- **Réservable**, si les clients peuvent réserver le terrain en ligne.
- **Localisation**, pour désigner aussitôt le terrain sur la carte.
</Step>
<Step>
### Cliquez sur Créer le terrain [#klik-op-terrein-aanmaken]
Le terrain figure dans la liste. Si vous n'avez pas dessiné la localisation, vous le faites plus tard sur le plan, voir [Carte](/kaart#terreingrenzen-intekenen).
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le terrain apparaît dans la liste et dans les statistiques en haut : **Total des terrains**, **Terrains récents**, **Terrains réservables**, **Terrains non réservables** et **Superficie totale** (uniquement pour les terrains dont la localisation est dessinée).
- Tillor calcule le **Tarif calculé** à partir de la formule du tarif de votre organisation.
- Sur la page de détail, vous pouvez lier des compteurs, ajouter des commentaires et voir l'historique.

## Consulter et modifier un terrain [#een-terrein-bekijken-en-bewerken]

Cliquez sur un terrain dans la liste. En haut se trouvent le nom, la description, la superficie, le nombre de compteurs, s'il est réservable, le **Client** avec une occupation active et les dates de création et de modification. Dans le formulaire **Mettre à jour le terrain**, vous modifiez :

- **Nom**, **Type de terrain**, **Description**, **Réservable** et les **Champs personnalisés**.
- **Superficie** et **Tarif calculé** sont en lecture seule.

Enregistrez avec **Mettre à jour le terrain**. À côté du formulaire se trouvent **Localisation**, **Compteurs** et **Historique des occupations**. En dessous se trouvent **Commentaires** (visibles uniquement par vos collègues), **Événements** avec un aperçu avant/après par champ modifié, et **Réservations**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Détail d'un terrain avec des compteurs liés" />

## Rattacher des compteurs à un terrain [#meters-aan-een-terrein-hangen]

Dans la carte **Compteurs**, vous choisissez **Ajouter un compteur** puis **Assigner le compteur**. Seuls les compteurs sans terrain figurent dans la liste. Pour chaque compteur, vous voyez le type, un indicateur d'état et le dernier relevé. Avec le menu (...), vous choisissez **Détacher du terrain** ; ce choix ne se trouve qu'ici. Le parcours complet jusqu'au client figure sous [Lier un compteur à un client](/meterbeheer/meter-koppelen).

## Types de terrain [#terreintypes]

Avec les types de terrain, vous classez les terrains, par exemple **Emplacement**, **Chalet** ou **Place camping-car**. Vous voyez le type dans la liste des terrains (colonne **Type**, avec un filtre), vous pouvez colorer la carte selon celui-ci et il figure dans l'export. Vous les gérez sous <UIPath>Support > Paramètres > Types de terrain</UIPath>.

<Requires permission="Modifier les paramètres" />

<DocScreenshot src="/screenshots/instellingen/settings-terrain-types.png" alt="Paramètres > Types de terrain" />

Le tableau **Tous les types de terrain** affiche pour chaque type le **Nom**, la **Couleur de carte**, la **Description** et le nombre de **Terrains**. Cherchez avec **Rechercher des types de terrain...**. Avec le crayon, vous modifiez un type, avec la corbeille vous le supprimez.

<Steps>
<Step>
### Cliquez sur Nouveau type de terrain [#klik-op-nieuw-terreintype]
</Step>
<Step>
### Saisissez les informations [#vul-de-gegevens-in-1]
Donnez un **Nom**, éventuellement une **Description**, et choisissez une **Couleur de carte**. Le bleu est présélectionné.
</Step>
<Step>
### Cliquez sur Créer [#klik-op-aanmaken]
</Step>
</Steps>

<DocScreenshot src="/screenshots/instellingen/terrain-type-create-dialog.png" alt="Boîte de dialogue de création d'un type de terrain" />

Vous liez un type à un terrain via le champ **Type de terrain**. Vous voyez la couleur de la carte sur le plan quand vous réglez les couleurs sur **Types de terrain** sous **Calques**, voir [Carte](/kaart#lagen-en-kleuren).

## Exporter les terrains [#terreinen-exporteren]

Cliquez sur **Exporter tous les terrains** (en haut à droite) pour télécharger un fichier Excel. Il contient pour chaque terrain les informations de base, le type de terrain, les champs personnalisés et le calcul du tarif (sous-total, suppléments et total). Utilisez-le par exemple pour le contrôle annuel des tarifs.

## Comment le tarif est établi [#hoe-het-tarief-tot-stand-komt]

Le **Tarif calculé** découle de la formule du tarif de votre organisation. La formule calcule avec la superficie et avec les champs personnalisés du terrain. Vous décidez vous-même de quels champs il s'agit. La formule par défaut utilise les champs ayant les clés `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` et `staticPrice`. Si vous les avez créés sous <UIPath>Support > Paramètres > Champs personnalisés</UIPath>, ils fonctionnent ainsi :

1. **Superficie** : la superficie dessinée, par tranches par m².
2. **Supplément compteur de gaz** : s'ajoute si le champ avec le numéro de compteur de gaz est renseigné.
3. **Supplément emplacement** : le montant que vous saisissez.
4. **Supplément électricité** : le montant que vous saisissez.
5. **Prix fixe** : si ce champ est renseigné, ce montant remplace le tarif calculé et Tillor ignore la formule.

Si vous voulez modifier le tarif d'une année, adaptez les champs personnalisés, vérifiez sous **Tarif calculé** que c'est correct et enregistrez avec **Mettre à jour le terrain**.

### Formule du tarif [#tariefformule]

<Requires permission="Modifier la formule du tarif d'emplacement" />

Sous <UIPath>Paramètres > Tarif d'emplacement</UIPath>, vous décidez vous-même comment le tarif est calculé. Ceux qui pouvaient déjà modifier les paramètres ont reçu le droit **Modifier la formule du tarif d'emplacement**. La formule est un morceau de TypeScript (un langage de programmation) qui renvoie le tarif annuel en euros, ou des parties nommées qui forment ensemble le tarif, comme `Subtotaal` et `Toeslag gasmeter`. Chaque partie reçoit sa propre colonne dans l'export.

- Vous lisez les champs du terrain avec `{terrain.veld}`, comme `{terrain.surfaceArea}` ou `{terrain.customFields.locationSurcharge}`. Avec le bouton **Variable** ou en tapant `{`, vous choisissez parmi tous les champs, y compris les vôtres.
- À droite de la formule, vous l'essayez aussitôt sur l'un de vos terrains. Une erreur y apparaît avec le numéro de ligne. Une formule qui ne fonctionne pas ne peut pas être enregistrée.
- Avec **Rétablir la formule par défaut**, vous revenez à la formule avec laquelle chaque organisation a commencé.
- Dans les automatisations, vous lisez le tarif comme `{terrain.calculatedTariff.total}`.

<Callout type="warn" title="Attention">
La formule s'exécute de manière isolée : elle ne peut calculer qu'avec les champs du terrain, sans autres données ni internet. Une formule qui calcule trop longtemps est interrompue et ne produit alors aucun tarif.
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor indique Terrain non créé">
Le terrain n'a pas été enregistré. Vérifiez que le **Nom** est renseigné et ne dépasse pas 255 caractères, puis réessayez.
</Accordion>
<Accordion title="La superficie est vide ou à 0">
La superficie provient uniquement de la localisation sur la carte. Dessinez le terrain via <UIPath>Parc > Carte</UIPath>, voir [Carte](/kaart#terreingrenzen-intekenen). Les terrains sans localisation ne comptent pas dans **Superficie totale**.
</Accordion>
<Accordion title="Le Tarif calculé n'est pas correct">
Vérifiez les champs personnalisés du terrain (suppléments et numéro de compteur de gaz). Si un **Prix fixe** est renseigné, il remplace le tarif calculé. Si la formule a été modifiée, vérifiez sous Tarif d'emplacement que le test sur ce terrain est correct.
</Accordion>
<Accordion title="Je ne vois pas Tarif d'emplacement dans les paramètres">
Vous avez besoin du droit **Modifier la formule du tarif d'emplacement**. Demandez-le à votre administrateur.
</Accordion>
<Accordion title="Le compteur ne figure pas dans la liste de Ajouter un compteur">
Ce compteur est déjà rattaché à un autre terrain. Détachez-le d'abord de là.
</Accordion>
<Accordion title="Je ne peux pas créer d'occupation sur ce terrain">
Un terrain avec une occupation active ne figure pas dans la liste de choix. Terminez d'abord l'occupation en cours.
</Accordion>
</Accordions>

## Notions [#begrippen]

- **Terrain** : un lieu de votre parc. Voir [Notions](/begrippen#terrein).
- **Type de terrain** : une classification comme **Emplacement** ou **Chalet**, avec une couleur de carte.
- **Réservable** : les clients peuvent réserver le terrain en ligne.
- **Tarif calculé** : le tarif que Tillor calcule à partir de la formule.
- **Champ personnalisé** : un champ que votre organisation ajoute elle-même. Voir [Notions](/begrippen#eigen-veld).
- **Occupation** : un client sur un terrain pour une période. Voir [Notions](/begrippen#bezetting).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des compteurs" href="/meterbeheer" description="Lier des compteurs aux terrains et facturer la consommation" />
  <Card title="Occupations" href="/bezettingen" description="Placer des clients sur un terrain" />
  <Card title="Carte" href="/kaart" description="Dessiner les limites des terrains" />
</Cards>


# Contrôle d'accès (/fr-FR/toegangscontrole)

Avec le Contrôle d'accès, vous déterminez qui peut entrer dans votre parc et vous suivez qui s'y trouve. Vous donnez à un client une méthode d'accès (plaque d'immatriculation, tag NFC, QR code ou code PIN), vous commandez les barrières depuis votre écran et vous relisez qui est passé quand par quel point d'accès. Vous créez une méthode d'accès sur la fiche du client, voir [ajouter une méthode d'accès](#een-toegangsmethode-toevoegen).

<DocScreenshot src="/screenshots/toegangscontrole/stats-overview.png" alt="Contrôle d'accès avec les statistiques en haut" />

Les chiffres du haut comptent tous les accès, les dernières 24 heures, les tentatives autorisées et bloquées et vos points d'accès actifs. En dessous figurent les actions rapides, les véhicules dans le parc, le journal d'accès et les opérations du contrôleur.

<Callout type="info" title="Bon à savoir">
- Un véhicule devient **Véhicule fantôme** s'il n'a pas été vu à un point d'accès pendant 7 jours alors qu'il était à l'état **À l'intérieur**.
- Vous créez des méthodes d'accès QR jusqu'à 100 à la fois, chacune avec son propre code.
- Un code PIN comporte de 4 à 8 chiffres et doit être unique au sein de votre organisation.
- Chaque plaque d'immatriculation, chaque tag NFC et chaque QR code ne peut exister qu'une seule fois dans votre organisation.
- Une méthode d'accès qui ne se situe pas dans la période **Date de début** et **Date de fin** ne donne pas accès.
- Une plaque d'immatriculation au statut **Bloqué doux** n'est bloquée que pendant les heures d'ouverture de la réception.
- Une plaque expirée peut, par défaut, encore sortir pendant 2 jours en dehors des heures d'ouverture (30 au maximum). Voir [Paramètres du contrôle d'accès](/gebruikers/instellingen-toegangscontrole).
- Un véhicule apparaît sur la fiche client via une plaque enregistrée, ou via le tag NFC ou le QR code avec lequel le client est entré.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Une méthode d'accès est la clé d'un client. Le point d'accès (la barrière ou le portail) est la porte. Entre les deux se trouve du matériel dans votre parc : une caméra qui lit les plaques ou un boîtier qui lit les tags et les QR codes (un contrôleur d'accès), et le [connecteur](/connector). Le connecteur est le boîtier qui relie Tillor aux appareils de votre parc.

```mermaid
flowchart TD
  K[Client] --> M[Méthode d'accès<br/>plaque, tag NFC, QR code ou code PIN]
  M -->|Tillor transmet la liste| C[Connecteur dans votre parc]
  C --> L[Caméra ou lecteur de cartes<br/>à l'entrée]
  L -->|autorisé| P[Le point d'accès s'ouvre]
  L -->|refusé| W[Le point d'accès reste fermé]
  L -->|chaque tentative est signalée| LOG[Journal d'accès dans Tillor]
```

Ce que cela signifie pour vous :

- Si vous modifiez ou supprimez une méthode d'accès dans Tillor, Tillor le transmet au matériel via le connecteur. Vous voyez le résultat sous **Opérations du Contrôleur**.
- Si le connecteur est hors ligne, les méthodes d'accès nouvelles ou modifiées restent **En attente** jusqu'à ce qu'il soit de nouveau connecté.
- Une barrière que vous ouvrez depuis Tillor reçoit elle aussi sa commande, en général, via le connecteur. S'il est hors ligne, la barrière ne s'ouvre pas.

La rubrique Contrôleurs du menu principal concerne autre chose : les petits écrans avec lecteur de tag près des douches, des portes et des points de charge. Voir [Contrôleurs](/controllers). Le matériel des barrières est installé par le support Tillor lors de la mise en service.

## Commander les points d'accès [#toegangspunten-bedienen]

Sous **Actions rapides**, chaque point d'accès actif a un bouton. Vous ne voyez ce bloc que si au moins un point d'accès ou un contrôleur d'accès est configuré.

<DocScreenshot src="/screenshots/toegangscontrole/quick-actions.png" alt="Actions rapides avec points d'accès et boutons de gestion" />

<Steps>
<Step>
### Cliquez sur le bouton du point d'accès [#klik-op-de-knop-van-het-toegangspunt]
L'intitulé est **Ouvrir [nom]**.
</Step>
<Step>
### Confirmez [#bevestig]
Une boîte de dialogue vous demande si vous êtes sûr de vouloir ouvrir le point d'accès. Cliquez sur **Oui, ouvrir [nom]**.

<DocScreenshot src="/screenshots/toegangscontrole/barrier-confirm-dialog.png" alt="Confirmation pour ouvrir un point d'accès" />
</Step>
</Steps>

Tillor indique **Point d'accès ouvert**. La fermeture n'est possible que si le point d'accès la prend en charge. Une flèche vers le bas figure alors à côté du bouton d'ouverture : choisissez-y **Fermer [nom]** et confirmez avec **Oui, fermer [nom]**.

### Boutons de gestion dans Actions rapides [#beheerknoppen-in-snelle-acties]

À côté des points d'accès figurent, selon votre matériel, des boutons de maintenance. Utilisez-les uniquement si quelque chose ne va pas.

| Bouton | Ce qu'il fait | Quand |
|---|---|---|
| **Réinitialiser l'APB** | Efface la mémoire de qui est entré ou sorti en dernier, par type : **Pour les badges NFC…** ou **Pour les QR codes…**. | Des personnes ne passent plus parce que le portail pense qu'elles sont déjà à l'intérieur (ou à l'extérieur). APB signifie anti-passback. |
| **Synchroniser journaux contrôleurs** | Demande au connecteur de récupérer toutes les nouvelles lignes des contrôleurs d'accès. | Des passages récents manquent dans le journal d'accès. |
| **Réinitialiser le cache du connecteur** | Le connecteur efface ses données locales et récupère tout à nouveau auprès de Tillor. | Le matériel se comporte différemment des méthodes d'accès dans Tillor. |
| **Nettoyer les lectures LPR parasites** | Supprime uniquement les lignes fantômes sans risque de la liste des plaques. Les plaques enregistrées et associées sont conservées. | La liste contient des plaques qui ne correspondent à rien. |

## Gérer les méthodes d'accès via la fiche client [#toegangsmethoden-beheren-via-het-klantprofiel]

Vous ajoutez, modifiez et supprimez les méthodes d'accès sur la fiche du client.

### Ajouter une méthode d'accès [#een-toegangsmethode-toevoegen]

Une méthode d'accès appartient à un client et lui donne accès au parc. Vous les gérez sur la fiche client.

Avant de commencer :

- Le client existe dans Tillor.
- Pour le NFC, il vous faut un tag qui n'appartient encore à personne. S'il n'y a pas de tag libre, la liste indique **Aucune carte NFC disponible trouvée, toutes les cartes sont déjà assignées.**
- Le type **Code PIN** n'apparaît dans la liste que s'il est activé pour votre organisation.

<Steps>
<Step>
### Ouvrez l'onglet Contrôle d'accès [#open-het-tabblad-toegangscontrole]
Allez dans <UIPath>Clients > client > Contrôle d'accès</UIPath>. En haut figure le tableau **Méthodes d'accès** (repère **1** sur la capture d'écran ci-dessous).

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Fiche client Contrôle d'accès avec le tableau Méthodes d'accès et la plaque 1-DOC-2026" />
</Step>
<Step>
### Cliquez sur Ajouter et choisissez le type [#klik-op-toevoegen-en-kies-het-type]
<DocScreenshot src="/screenshots/toegangscontrole/access-method-create-dialog.png" alt="Boîte de dialogue pour une nouvelle méthode d'accès" />

Vous ne pouvez plus modifier le type par la suite. Si vous avez besoin d'un autre type, ajoutez une nouvelle méthode d'accès.
</Step>
<Step>
### Renseignez les données [#vul-de-gegevens-in]
Ce que vous renseignez dépend du type :
</Step>
</Steps>

<Tabs items={["Plaque", "NFC", "QR code", "Code PIN"]}>
<Tab value="Plaque">
Saisissez la plaque d'immatriculation sous **Plaque d'immatriculation**. Tillor la convertit en majuscules. La marque, le modèle et la couleur sont facultatifs.
</Tab>
<Tab value="NFC">
Sous **Cartes NFC**, choisissez un tag libre dans la liste. Vous pouvez rechercher par numéro du tag.
</Tab>
<Tab value="QR code">
Tillor crée le code lui-même. Avec **Quantité**, vous créez jusqu'à 100 méthodes d'accès QR distinctes en une seule fois, chacune avec son propre code. Cochez **Imprimer le ticket thermique tout de suite** pour envoyer chaque nouveau QR immédiatement à l'imprimante thermique sous forme de ticket d'entrée. Vous définissez l'adresse de l'imprimante dans les paramètres de l'organisation. Sur le ticket figurent **Valide du** et **Valide jusqu'au** dans le fuseau horaire de votre organisation.
</Tab>
<Tab value="Code PIN">
Saisissez de 4 à 8 chiffres, ou cliquez sur **Générer**. Le code PIN doit être unique au sein de votre organisation. Pour un code PIN, l'action **Synchroniser avec le système d'accès** n'existe pas.
</Tab>
</Tabs>

Pour chaque type, vous pouvez en outre renseigner :

| Champ | Signification |
|---|---|
| **Date de début**, **Date de fin** | La période pendant laquelle la méthode d'accès fonctionne. Vide signifie aucune limite. |
| **Statut** | **Actif**, **Inactif**, **Bloqué** ou **Bloqué doux** (voir [statuts](#statussen-van-toegangsmethoden)). |
| **Conversion automatique en plaque d'immatriculation** | Uniquement pour le QR code et le code PIN. Si quelqu'un utilise le code à un portail équipé d'une caméra, Tillor remplace le code par la plaque lue. Désactivé par défaut. |
| **Ne pas prolonger automatiquement** | La date de fin reste inchangée lorsqu'une facture avec prolongation automatique est payée. |
| **Commentaires** | Notes internes. |

Cliquez ensuite sur **Ajouter** pour enregistrer.

#### Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La méthode d'accès figure dans le tableau et Tillor l'envoie au matériel via le connecteur. Vous suivez cela sous **Opérations du Contrôleur**, avec le statut <Status tone="info">En attente</Status>, <Status tone="warning">En cours</Status>, <Status tone="success">Terminé</Status> ou <Status tone="error">Échec</Status>.
- Une méthode d'accès modifiée ou supprimée est transmise de la même manière.
- Chaque tentative d'entrée apparaît dans le journal d'accès, y compris les refusées.
- Un véhicule est associé au client via une plaque enregistrée, ou parce que le client est entré avec un tag NFC ou un QR code pendant que la caméra lisait aussi la plaque. Ce dernier cas fonctionne même si la plaque n'est pas enregistrée.

#### Modifier, envoyer ou supprimer une méthode d'accès [#een-toegangsmethode-bewerken-versturen-of-verwijderen]

Cliquez sur les trois points à droite de la méthode d'accès.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-actions-menu.png" alt="Menu d'actions d'une méthode d'accès" />

| Action | Utilité |
|---|---|
| **Modifier** | Adapter la période, le statut ou les données du véhicule. |
| **Synchroniser avec le système d'accès** | Renvoyer au matériel. Tillor indique **Synchronisation demandée**. Pas pour un code PIN. |
| **Envoyer la notification** | Envoie au client le lien QR personnel par e-mail, SMS ou WhatsApp (boîte de dialogue **Envoyer le QR code**). |
| **Copier l'URL personnelle** | Copie le lien vers le pass du client, voir [Wallet numérique](#digitale-wallet-qr-code). |
| **Télécharger le code QR**, **Imprimer le ticket thermique** | Uniquement pour un QR code. |
| **Supprimer** | Retire la méthode d'accès. Cela ne peut pas être annulé. Avec les cases à cocher du tableau, vous en supprimez plusieurs à la fois. |

#### Statuts des méthodes d'accès [#statussen-van-toegangsmethoden]

| Statut | Signification |
|---|---|
| <Status tone="success">Actif</Status> | Donne accès, tant que la période est respectée. |
| <Status>Inactif</Status> | Ne donne pas accès. Fonctionne comme Bloqué, avec un nom plus explicite. |
| <Status tone="error">Bloqué</Status> | Ne donne pas accès. |
| <Status tone="warning">Bloqué doux</Status> | Pour une plaque, bloquée uniquement pendant les heures d'ouverture de la réception. En dehors, le véhicule peut encore entrer et sortir. |

## Wallet numérique (QR code) [#digitale-wallet-qr-code]

Pour une méthode d'accès QR, vous copiez un lien personnel pour le client. Il ouvre la page **Pass d'accès** avec le QR code. Si Apple Wallet ou Google Wallet sont configurés pour votre environnement, des boutons pour enregistrer le pass s'affichent aussi.

<Steps>
<Step>
### Copiez le lien [#kopieer-de-link]
Ouvrez les trois points de la méthode d'accès QR et cliquez sur **Copier l'URL personnelle**. Tillor indique **Lien copié**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-personal-url-menu.png" alt="Menu d'actions d'une méthode d'accès QR avec Copier l'URL personnelle" />
</Step>
<Step>
### Envoyez le lien au client [#stuur-de-link-naar-de-gast]
Le client voit le QR code, la validité et, si disponibles, **Ajouter à Apple Wallet** et **Ajouter à Google Wallet**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-public-view-wallet.png" alt="Page client Pass d'accès avec QR code et boutons wallet" />
</Step>
</Steps>

Le pass wallet utilise le même QR code, la même validité et le même statut que dans Tillor. Sur un iPhone avec iOS 27, le pass apparaît sous forme de Poster Generic, avec en option un arrière-plan personnalisé et un QR code carré. Les iPhone plus anciens affichent la présentation classique. Sur iOS 27, le pass comporte aussi des raccourcis : **Itinéraire** ouvre Apple Maps vers l'emplacement du point d'accès (ou le centre de la carte du parc), et si vous avez indiqué un site web dans les données de votre entreprise, un bouton vers ce site s'y ajoute. Vous définissez l'arrière-plan et l'emplacement dans **Paramètres**, voir [Organisation](/gebruikers/organisaties). Sur un iPhone, le pass peut apparaître sur l'écran verrouillé lorsque le client est à proximité. Sur Android, le client enregistre le pass dans Google Wallet.

### Voir où le pass est enregistré [#zien-waar-de-pas-is-opgeslagen]

Si un client a ajouté le pass, une petite icône wallet figure à côté de la valeur QR, avec un nombre s'il y a plus d'un appareil. Passez la souris dessus pour voir :

- si le pass se trouve dans **Apple Wallet sur iPhone** ou **Google Wallet sur Android**, et sur combien d'appareils
- quand le pass a été **Dernier ajout** et **Pass mis à jour**, et pour Apple aussi **Dernière synchronisation**
- si le pass a été **Émis via** un **Collaborateur** ou un **Lien personnel**

Google ne signale pas quand un client supprime le pass. Dans Google Wallet, le pass reste donc indiqué comme enregistré.

### Renvoyer un pass wallet [#een-wallet-pas-opnieuw-versturen]

Si un pass QR change, par exemple sa validité, Tillor envoie lui-même la mise à jour aux wallets. Si une ancienne version s'affiche malgré tout, choisissez **Synchroniser le pass Wallet** dans le menu. Tillor indique combien d'appareils ont reçu la mise à jour. Si le pass n'est encore enregistré nulle part, vous voyez **Aucun appareil enregistré pour les mises à jour.** L'élément de menu n'apparaît que lorsque le pass a été ajouté à un wallet.

## Véhicules dans le parc [#voertuigen-in-het-park]

Le tableau **Véhicules dans le parc** indique, par plaque, si un véhicule est à l'intérieur. Une lecture à une entrée met le véhicule sur **À l'intérieur**, une lecture à une sortie sur **Parti**.

Chaque ligne affiche la plaque, le statut, le client, le moment d'entrée, le dernier moment où le véhicule a été vu à un point d'accès et ce point d'accès. Par défaut, le tableau affiche les véhicules à l'état **À l'intérieur** ou **Véhicule fantôme**. Avec les filtres, vous affichez aussi les véhicules partis, filtrez par point d'accès ou recherchez par plaque ou nom de client.

| Statut | Signification |
|---|---|
| <Status tone="success">À l'intérieur</Status> | Entré par une entrée et pas encore parti. |
| <Status tone="warning">Véhicule fantôme</Status> | Était à l'intérieur, mais n'a plus été vu à un point d'accès depuis 7 jours. |
| <Status>Parti</Status> | Sorti par une sortie. |

Un véhicule fantôme apparaît généralement parce que la caméra n'a pas lu la plaque à la sortie, ou l'a mal lue à l'entrée. Si la plaque est de nouveau vue plus tard à une entrée, le véhicule repasse sur **À l'intérieur**.

### Occupation du parc [#parkbezetting]

La carte **Occupation du parc** montre combien de véhicules sont à l'intérieur : **Actuellement à l'intérieur**, le **Pic** de la période choisie, et le nombre d'**Entrées** et de **Sorties**. Le premier graphique montre l'évolution, par heure jusqu'à une semaine et par jour pour une période plus longue. **Heures populaires** montre, pour chaque heure de la journée, le nombre moyen de véhicules et d'arrivées. Vous voyez ainsi par exemple quand il y a assez de monde pour ouvrir la restauration. Avec le sélecteur de période en haut à droite, vous choisissez aujourd'hui, 7 jours, 30 jours, 90 jours, tout ou une plage personnalisée.

## Journal d'accès [#toegangslogboek]

Le journal d'accès affiche chaque tentative d'entrée, avec la date, la méthode d'accès, le client (s'il est connu), le point d'accès et le statut.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Journal d'accès avec plaques, client et statut" />

Filtrez et recherchez par plaque ou valeur (pour le NFC aussi par libellé de carte), plage de dates, statut, type de méthode d'accès, point d'accès ou client. Avec **Exporter** à droite dans la barre d'outils, vous téléchargez le journal sous forme de fichier Excel.

| Statut | Signification |
|---|---|
| Autorisé | L'accès a été accordé. |
| Bloqué | L'accès a été refusé. |
| Inactif | La méthode d'accès est inactive. |
| Expiré | La méthode d'accès a expiré. |
| Invalide | La méthode d'accès est invalide. |
| Refusé | L'accès a été activement refusé. |
| Bloqué doux | L'accès est bloqué doux. |
| Erreur Appareil | Il y a eu un problème avec l'appareil. |
| Pas de Voiture | Aucune voiture n'a été détectée. |
| APB - Direction Incompatible | Le portail bloque le passage parce que le sens ne correspond pas (anti-passback). |
| Inconnu | Le statut n'a pas pu être déterminé. |
| Message Système | Un message du système lui-même. |

## Historique d'état des point d'accèss [#hekstatusgeschiedenis]

Sous le journal d'accès figure aussi l'**Historique d'état des point d'accèss** : quand un point d'accès était **Ouvert**, **Fermé** ou **En mouvement**, avec la **Source** du signalement. Si la position n'est pas connue, **Inconnu** s'affiche. Filtrez par statut ou point d'accès. Si la liste est vide, aucun signalement de position n'a encore été reçu.

## Opérations du Contrôleur [#controller-operaties]

En dessous figure **Opérations du Contrôleur**. Ce sont les commandes que Tillor envoie aux contrôleurs d'accès, comme **Créer**, **Mettre à jour**, **Supprimer** et **Synchroniser**. Vous voyez ainsi quand un pass ou un QR code est arrivé au point d'accès.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Opérations du Contrôleur avec commandes et leur statut" />

Une commande est <Status tone="info">En attente</Status>, <Status tone="warning">En cours</Status>, <Status tone="success">Terminé</Status> ou <Status tone="error">Échec</Status>. Avec l'icône en forme d'œil à droite dans la ligne, vous ouvrez les détails.

## Des problèmes ? [#problemen]

<Accordions>
<Accordion title="Le bloc Actions rapides est absent">
Le bloc n'apparaît que si un point d'accès ou un contrôleur d'accès est configuré. S'il n'y a rien, le support Tillor n'a pas encore associé le matériel.
</Accordion>
<Accordion title="Tillor indique : Échec ouverture point d'accès">
Le point d'accès n'a pas répondu. Le plus souvent, le connecteur est hors ligne ou l'appareil est inaccessible. Vérifiez le connecteur, voir [Connecteur non connecté](/connector#problemen), et réessayez.
</Accordion>
<Accordion title="Tillor indique : Cette valeur est déjà utilisée">
Chaque plaque d'immatriculation, chaque tag NFC et chaque QR code ne peut exister qu'une seule fois dans votre organisation. Pour une plaque, Tillor indique à quel client elle appartient déjà. Supprimez ou modifiez d'abord cette méthode d'accès.
</Accordion>
<Accordion title="Un client n'entre pas avec une plaque valide">
Regardez dans le journal d'accès quel statut la tentative a reçu. **Expiré** ou **Inactif** : vérifiez **Date de début**, **Date de fin** et **Statut** de la méthode d'accès. **Bloqué doux** : la plaque est bloquée pendant les heures d'ouverture de la réception. **Erreur Appareil** ou **Pas de Voiture** : la caméra n'a rien lu, vérifiez le matériel. Si la méthode d'accès est correcte mais que le portail refuse toujours, regardez sous **Opérations du Contrôleur** si la dernière modification est **Terminé**.
</Accordion>
<Accordion title="Une nouvelle méthode d'accès ne fonctionne pas encore au portail">
Regardez sous **Opérations du Contrôleur** si la commande est <Status tone="success">Terminé</Status>. Si elle est **En attente**, le connecteur est probablement hors ligne. Si elle est en **Échec**, choisissez **Synchroniser avec le système d'accès** sur la méthode d'accès.
</Accordion>
<Accordion title="Des personnes sont refusées avec APB - Direction Incompatible">
Le portail pense qu'elles sont déjà à l'intérieur (ou à l'extérieur). Cliquez sur **Réinitialiser l'APB** dans Actions rapides et choisissez **Pour les badges NFC…** ou **Pour les QR codes…**. Confirmez avec **Réinitialiser**.
</Accordion>
<Accordion title="La liste des tags NFC est vide">
Seuls les tags qui n'appartiennent encore à personne figurent dans la liste. Retirez d'abord un tag de l'autre client, voir [Gérer les tags](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen).
</Accordion>
<Accordion title="Un véhicule est indiqué comme Véhicule fantôme">
Le véhicule n'a pas été vu depuis 7 jours. Le plus souvent, il est parti sans que la caméra le voie. Il repasse automatiquement sur **À l'intérieur** si la plaque est lue à nouveau à une entrée.
</Accordion>
</Accordions>

## Termes [#begrippen]

- **Méthode d'accès** : la clé d'un client, une plaque d'immatriculation, un tag NFC, un QR code ou un code PIN.
- **Point d'accès** : la barrière, le portail ou la porte qui s'ouvre.
- **Contrôleur d'accès** : le boîtier près du point d'accès qui lit les tags et les QR codes.
- **Connecteur** : le boîtier de votre parc qui relie Tillor au matériel. Voir [Connecteur](/connector).
- **APB (anti-passback)** : la règle selon laquelle on ne peut pas franchir deux fois un portail dans le même sens.
- **Véhicule fantôme** : un véhicule qui figure comme étant à l'intérieur mais n'a pas été vu depuis 7 jours.

Vous trouverez plus d'explications dans la [liste des termes](/begrippen).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Connecteur" href="/connector" description="Le boîtier qui relie Tillor à votre matériel" />
  <Card title="NFC" href="/nfc" description="Associer des tags et gérer le solde" />
  <Card title="Paramètres du contrôle d'accès" href="/gebruikers/instellingen-toegangscontrole" description="Délai de grâce pour les plaques expirées" />
  <Card title="Gestion des clients" href="/klantenbeheer" />
</Cards>


# Météo (/fr-FR/weer)

Sur la page **Météo**, vous voyez jour par jour la météo à l'emplacement de votre parc, afin de pouvoir mettre un pic de consommation ou d'affluence en regard de la météo. Tillor utilise aussi ces données pour les compteurs et les réservations.

<Callout type="info" title="Bon à savoir">
- La météo dépend du centre de la carte de votre organisation. S'il est mal placé, la météo ne correspondra pas.
- Tillor récupère la météo chaque nuit et complète les jours manquants du passé.
- Par défaut, vous voyez les 14 derniers jours.
- Un jour marqué **Archives** est définitif. Un jour marqué **Prévision** peut encore changer.
</Callout>

## Ouvrir la page [#de-pagina-openen]

Allez dans <UIPath>Parc > Météo</UIPath>.

<DocScreenshot src="/screenshots/weer/weather-overview.png" alt="Parc > Météo avec les prévisions quotidiennes" />

Sous **Prévisions quotidiennes** figure l'emplacement, par exemple **Centre de la carte : 50.8503, 4.3517**. Il s'agit du centre de la carte de votre parc. Vous le définissez sous <UIPath>Paramètres > Carte</UIPath>. Si vous le déplacez, la météo suit ce nouvel emplacement. Voir [Carte](/kaart).

Vous voyez :

- une grande carte pour le jour le plus récent, avec la température, les conditions, les températures maximale et minimale et la quantité de pluie. À côté du jour figure **Archives** pour un jour déjà définitif, ou **Prévision** pour un jour qui peut encore être mis à jour
- en dessous, une carte par jour, avec les conditions comme **Dégagé**, **Partiellement nuageux**, **Couvert**, **Brouillard**, **Bruine**, **Pluie**, **Averses**, **Neige** ou **Orage**, les températures maximale et minimale, et la pluie en mm. Aujourd'hui a une bordure colorée
- **Aucune donnée pour ce jour** pour un jour pour lequel Tillor n'a rien

## Choisir une autre période [#een-andere-periode-kiezen]

Par défaut, vous voyez les 14 derniers jours. Cliquez en haut à droite sur **Sélectionner une période** pour choisir une autre période : **Aujourd'hui**, **Hier**, **7 derniers jours**, **Dernier mois**, **3 derniers mois**, **Tout** ou une **Plage personnalisée** dans le calendrier. Confirmez une plage personnalisée avec **Appliquer**.

## Pas encore de données météo [#nog-geen-weergegevens]

Si vous voyez **Pas encore de données météo**, la météo n'a pas encore été récupérée. Tillor la récupère chaque nuit pour le centre de la carte de votre organisation et complète aussi les jours manquants du passé. Essayez une autre période ou revenez le lendemain. Vérifiez aussi que le centre de la carte est correct.

## Où voir encore la météo [#waar-zie-je-het-weer-nog-meer]

- Sur la page d'un compteur, sous **Consommation & tendances** : pour un jour de pic, la température est indiquée, et pour une consommation élevée, un résumé des 7 derniers jours. Voir [Gestion des compteurs](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).
- Sur la chronologie des réservations et dans les graphiques des véhicules présents dans le parc, avec la météo du jour concerné.

## Des problèmes ? [#problemen]

<Accordions>
<Accordion title="Il est indiqué Pas encore de données météo">
La météo n'a pas encore été récupérée. Essayez une autre période ou revenez le lendemain, et vérifiez que le centre de la carte est correct.
</Accordion>
<Accordion title="La météo ne correspond pas à mon parc">
Le centre de la carte se trouve à un autre endroit. Déplacez-le sous <UIPath>Paramètres > Carte</UIPath>, voir [Carte](/kaart#kaartstandaard-instellen). La météo suit le nouvel emplacement.
</Accordion>
<Accordion title="Un jour indique Aucune donnée pour ce jour">
Tillor n'a rien pour ce jour. Il sera complété automatiquement dès que les données seront disponibles.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Carte" href="/kaart" description="Définir le centre de la carte de votre parc" />
  <Card title="Gestion des compteurs" href="/meterbeheer" description="Consommation et tendances par compteur" />
</Cards>


# Aperçu (/fr-FR/api-referentie)

Cette référence est générée directement à partir de l'API Tillor. Chaque endpoint a sa propre page avec les paramètres, le corps de la requête, les réponses possibles et des exemples de code. Dans la barre latérale, les endpoints sont regroupés par thème.

## Envoyer une requête [#een-request-versturen]

Chaque requête a besoin de votre clé API dans l'en-tête `x-api-key`. Les endpoints sous `/orgs/{organizationId}` fonctionnent au sein d'une seule organisation.

```http
GET https://api.tillor.eu/orgs/org_abc123/customers
x-api-key: tkn_xxx
```

Vous créez une clé API dans l'application, sous votre compte. Pour savoir comment cela fonctionne, quelles limites de débit s'appliquent et comment conserver vos clés en sécurité, consultez [API HTTP](/ontwikkelaars/http).

## Qui peut appeler un point de terminaison [#wie-mag-een-endpoint-aanroepen]

Chaque page de point de terminaison indique en haut, sous **Accès**, qui peut l’appeler. Pour la plupart, il s’agit d’un membre de l’organisation avec une autorisation donnée, comme `customers:read`. Une clé API fonctionne avec les autorisations de la personne qui l’a créée ; si la clé a des scopes, l’autorisation doit aussi y figurer. Sinon, l’API répond `403`.

La spécification contient la même information par point de terminaison dans `x-tillor-access`, avec `access` (qui) et `permissions` (une seule suffit).

## Essayer dans le playground [#uitproberen-in-de-playground]

Sur chaque page d'endpoint, vous pouvez envoyer la requête immédiatement. Si vous êtes connecté à Tillor dans le même navigateur, le playground utilise votre session et vous n'avez pas besoin de clé API. Sinon, saisissez votre clé API sous **Authorization**. Adaptez les paramètres et cliquez sur **Send**.

Le playground communique avec la véritable API de votre organisation : un `POST`, `PUT` ou `DELETE` modifie donc de vraies données.

<Callout type="warn" title="Utilisez une organisation de test">
Essayez les endpoints d'écriture sur une organisation de test, pas sur votre parc en exploitation.
</Callout>

## Télécharger la spécification [#specificatie-downloaden]

La spécification complète est disponible au format OpenAPI 3.1 sur [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Importez-la dans Postman ou Insomnia, ou générez-en un client.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="API HTTP" description="Authentification, limites de débit et conventions" href="/ontwikkelaars/http" />
  <Card title="Webhooks" description="Recevoir des événements sur votre propre URL" href="/ontwikkelaars/webhooks" />
</Cards>


# Gérer un contrôleur (/fr-FR/controllers/controller-beheren)

Sur la page d'un contrôleur, vous modifiez ses données et effectuez la maintenance. Les paramètres comme l'ACL, le réseau et les mises à jour se trouvent à part, dans [Paramètres du contrôleur](/controllers/settings).

Avant de commencer :

- Le contrôleur est approuvé, voir [Associer un contrôleur](/controllers/controller-koppelen).

## Modifier le nom, le type et le groupe [#naam-type-en-groep-wijzigen]

<Steps>
<Step>
### Ouvrez le contrôleur [#open-de-controller]
Allez dans <UIPath>Contrôleurs > Aperçu</UIPath> et cliquez sur le contrôleur.
</Step>
<Step>
### Adaptez le formulaire [#pas-het-formulier-aan]
Sous **Paramètres du contrôleur**, choisissez le **Nom**, le **Type** (**Douche**, **Accès** ou **Point de charge**) et le **Groupe**.
</Step>
<Step>
### Cliquez sur Enregistrer [#klik-op-opslaan]
Tillor indique **Contrôleur mis à jour** et transmet les paramètres au contrôleur.
</Step>
</Steps>

## Redémarrer un contrôleur [#een-controller-herstarten]

Si un contrôleur ne répond pas correctement, redémarrez-le depuis Tillor.

<Tabs items={["Sur la page de détail", "Dans l'aperçu"]}>
<Tab value="Sur la page de détail">
Ouvrez le menu d'actions (les trois points) et choisissez **Redémarrer le contrôleur**.

<DocScreenshot src="/screenshots/controllers/controller-actions-menu.png" alt="Menu d'actions d'un contrôleur avec Redémarrer le contrôleur" />
</Tab>
<Tab value="Dans l'aperçu">
Cliquez sur l'icône de redémarrage dans la ligne du contrôleur.
</Tab>
</Tabs>

L'écran affiche **Redémarrage** et le contrôleur se reconnecte ensuite.

Le menu d'actions contient aussi **Voir les logs dans Grafana**. Cela ouvre les journaux du contrôleur dans un autre programme, destiné au support. Sur la page du contrôleur elle-même, les logs récents se trouvent dans la carte **Console**.

## Mettre à jour vers une nouvelle version [#bijwerken-naar-een-nieuwe-versie]

Si une flèche vers le haut figure à côté du numéro de version, un <Term term="firmware">firmware</Term> (logiciel) plus récent est disponible. Survolez-la pour voir la version (**Mise à jour disponible**) et cliquez dessus pour lancer la mise à jour. Tillor indique **Mise à jour OTA démarrée**. Pour savoir quand les contrôleurs se mettent à jour eux-mêmes, consultez [Mises à jour du firmware](/controllers/updates).

## Supprimer un contrôleur [#een-controller-verwijderen]

Dans le menu d'actions, choisissez **Supprimer le contrôleur** et confirmez dans **Supprimer le contrôleur**. Le contrôleur disparaît de votre liste. Il peut ensuite redemander une adoption.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Après un redémarrage, le contrôleur se reconnecte à Tillor. Cela prend un moment.
- Après la mise à jour, le contrôleur redémarre de lui-même. Laissez l'alimentation branchée pendant que l'écran affiche **Mise à jour** avec un pourcentage.
- Un contrôleur supprimé ne donne plus accès.

## Des problèmes ? [#problemen]

<Accordions>
<Accordion title="Tillor indique : Échec du redémarrage">
Le contrôleur n'a pas pu être redémarré, généralement parce qu'il est hors ligne. Vérifiez l'alimentation et le réseau, voir [Problèmes de connexion](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="Tillor indique : Échec de la mise à jour OTA">
La mise à jour n'a pas pu être lancée. Vérifiez que le contrôleur est en ligne et que **Ignorer les mises à jour OTA** est sur **Non**, voir [Mises à jour du firmware](/controllers/updates).
</Accordion>
<Accordion title="Tillor indique : Échec de la mise à jour">
Le formulaire n'a pas pu être enregistré. Réessayez et vérifiez que le nom est renseigné.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres du contrôleur" href="/controllers/settings" description="ACL, réseau, mises à jour et relais" />
  <Card title="Mises à jour du firmware" href="/controllers/updates" description="Fenêtre de mise à jour et fréquence" />
</Cards>


# Associer un contrôleur (/fr-FR/controllers/controller-koppelen)

Un nouveau contrôleur ne fonctionne pour votre organisation qu'après que vous l'avez approuvé. C'est ce qu'on appelle l'adoption : vous indiquez dans Tillor que ce boîtier appartient à votre parc. Vous pouvez ensuite lui attribuer un type et un groupe, voir [Gérer un contrôleur](/controllers/controller-beheren).

Avant de commencer :

- Vous disposez d'une alimentation et d'un réseau (câble ou Wi-Fi) à l'endroit où sera installé le contrôleur.
- Si vous utilisez le Wi-Fi, ayez le nom du réseau et le mot de passe à portée de main.
- Ouvrez de préférence Tillor sur le même réseau que le contrôleur. Sinon, il arrive que vous ne voyiez pas sa demande.

## Brancher et approuver le contrôleur [#de-controller-aansluiten-en-goedkeuren]

<Steps>
<Step>
### Branchez le contrôleur [#sluit-de-controller-aan]
Branchez l'alimentation. L'écran affiche **Connexion...** puis ce qui manque encore.
</Step>
<Step>
### Donnez-lui un réseau [#geef-hem-een-netwerk]
<Tabs items={["Câble réseau", "Wi-Fi"]}>
<Tab value="Câble réseau">
Branchez le câble réseau. Le contrôleur se connecte tout seul, vous n'avez rien à configurer.
</Tab>
<Tab value="Wi-Fi">
Sur l'écran, touchez **Configurer le Wi-Fi**, choisissez votre réseau, saisissez le mot de passe et confirmez. L'écran affiche **Connecté**. Voir [Configurer le Wi-Fi sur l'écran](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).
</Tab>
</Tabs>
</Step>
<Step>
### Ouvrez Contrôleurs dans Tillor [#open-controllers-in-tillor]
Allez dans <UIPath>Contrôleurs > Aperçu</UIPath>. Dès que le contrôleur est connecté, il apparaît dans la liste avec le statut **En attente d'approbation**. L'écran du contrôleur affiche **Activer le contrôleur** avec le numéro de l'appareil. Ce numéro est l'<Term term="eFuse ID">eFuse ID</Term>, le numéro de série du boîtier. Vérifiez qu'il est identique à celui de la liste.
</Step>
<Step>
### Cliquez sur Approuver [#klik-op-goedkeuren]
Cliquez sur la coche (**Approuver**) dans la ligne. Tillor indique **Approuvé** et le contrôleur est ajouté à votre organisation.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- L'écran du contrôleur affiche **Scanner le QR** et **Scannez votre tag**. Il est prêt à l'emploi.
- Tillor envoie automatiquement les données de connexion et les paramètres au contrôleur. Vous n'avez rien à saisir.
- Son premier scan crée le tag dans Tillor, s'il n'existait pas encore.
- Avec la croix (**Refuser**), vous refusez une demande. Le contrôleur n'a alors pas accès à votre organisation.
- Si vous mettez un contrôleur de côté ou le remplacez, supprimez-le, voir [Gérer un contrôleur](/controllers/controller-beheren#een-controller-verwijderen). Il pourra ensuite refaire une demande.

## Des problèmes ? [#problemen]

<Accordions>
<Accordion title="Le contrôleur ne figure pas dans la liste">
L'écran doit afficher **Activer le contrôleur** avant qu'il n'apparaisse. S'il affiche encore **Configurer le Wi-Fi** ou **Connexion...**, il n'est pas encore en ligne. Ouvrez aussi Tillor depuis le même réseau que le contrôleur et actualisez la page. Vous trouverez d'autres étapes sous [Le contrôleur n'apparaît pas dans Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor).
</Accordion>
<Accordion title="Tillor indique : Échec de l'approbation">
L'adoption n'a pas pu être approuvée. Réessayez. Si l'erreur persiste, vérifiez que l'horloge du contrôleur est correcte et contactez le support. Voir [Échec de l'adoption](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd).
</Accordion>
<Accordion title="L'écran reste sur Connexion...">
Attendez 1 à 2 minutes. Si cela ne change pas, vérifiez le câble ou le signal Wi-Fi. Voir [L'écran reste sur Connexion...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gérer un contrôleur" href="/controllers/controller-beheren" description="Nom, groupe, redémarrage et suppression" />
  <Card title="Messages à l'écran" href="/controllers/troubleshooting/scherm" description="Ce qu'affiche le contrôleur" />
</Cards>


# Aperçu (/fr-FR/controllers)

Un contrôleur est un petit boîtier avec un écran tactile rond, installé sur votre parc près d'une douche, d'une porte ou d'un point de charge. Un client approche un tag <Term term="NFC">NFC</Term> ou scanne le QR code affiché à l'écran, et Tillor décide si c'est autorisé. Vous lisez ici ce que fait un contrôleur et comment il s'articule avec les clients et le solde. Vous mettez un nouveau contrôleur en service via [Associer un contrôleur](/controllers/controller-koppelen).

Les contrôleurs se trouvent dans le menu principal sous **Contrôleurs**. Les barrières et les contrôleurs d'accès à votre entrée n'en font pas partie, voir [Contrôle d'accès](/toegangscontrole).

<Callout type="info" title="Bon à savoir">
- Un contrôleur se signale à Tillor toutes les 15 secondes. Après environ 35 secondes sans contact, Tillor l'affiche comme hors ligne.
- Après 5 minutes sans contact, l'équipe Tillor reçoit une alerte.
- Un contrôleur retient au maximum 8 réseaux Wi-Fi.
- Le contrôle d'accès via le contrôleur (ACL) est désactivé par défaut. Activez **ACL activé** dans les [paramètres](/controllers/settings) pour faire vérifier les tags.
- Par défaut, il vérifie chaque jour s'il existe une nouvelle version du logiciel. Une mise à jour ne démarre que dans la fenêtre de mise à jour, si vous en avez défini une.
- Par défaut, il attend 1000 millisecondes (1 seconde) la réponse de Tillor avant de basculer, avec le paramètre **Délai d'expiration API ACL**.
- En cas de courte interruption, le paiement avec un tag fonctionne encore. Le paiement via le QR code ne fonctionne alors plus un moment.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Le contrôleur ne décide pas lui-même qui peut passer. Il lit le tag et interroge Tillor. Tillor sait à quel client le tag appartient, pour quels groupes d'accès il est valable et quel solde il porte.

```mermaid
flowchart TD
  G[Le client approche le tag de l'écran] --> C[Contrôleur]
  C -->|demande si c'est autorisé| T[Tillor]
  T --> K[Client du tag]
  T --> A[Groupes d'accès et solde]
  T -->|autoriser ou refuser| C
  C -->|affiche le résultat| G
  T --> TR[Transaction dans l'historique du tag]
```

- Chaque contrôleur a un **Type** (**Douche**, **Accès** ou **Point de charge**) et éventuellement un **Groupe**. Les tags autorisés ici se règlent avec les groupes d'accès du tag, voir [Gérer les tags](/nfc/nfc-tags).
- Si le contrôleur ne parvient pas à joindre Tillor un instant, il utilise avec **First local** les données qu'il a mémorisées lui-même, voir [Paramètres](/controllers/settings).
- Un tag qui n'existe pas encore dans Tillor est créé dès qu'il est présenté pour la première fois à un contrôleur.

## Que voyez-vous dans Tillor ? [#wat-zie-je-in-tillor]

- **Aperçu des contrôleurs** : tous les contrôleurs avec leur version, leur type, leur groupe, leur utilisation et leur **Dernière connexion**. Les contrôleurs qui demandent à être associés sont à l'état **En attente d'approbation**.
- **Détail du contrôleur** : état, réseau, charge du contrôleur, réseaux Wi-Fi, événements et la carte **Console** avec les logs.
- **Gestion** : redémarrer, mettre à jour et supprimer, voir [Gérer un contrôleur](/controllers/controller-beheren).

## Rubriques [#onderdelen]

<Cards>
  <Card title="Associer un contrôleur" href="/controllers/controller-koppelen" description="Brancher et approuver" />
  <Card title="Gérer un contrôleur" href="/controllers/controller-beheren" description="Nom, groupe, redémarrage et suppression" />
  <Card title="Configurer les réseaux Wi-Fi" href="/controllers/wifi-netwerken" description="Jusqu'à 8 réseaux par ordre de priorité" />
  <Card title="Paramètres du contrôleur" href="/controllers/settings" description="ACL, réseau, mises à jour et relais" />
  <Card title="Mises à jour du firmware" href="/controllers/updates" description="Fenêtre de mise à jour et fréquence" />
  <Card title="Messages à l'écran" href="/controllers/troubleshooting/scherm" description="Que signifie le message à l'écran ?" />
  <Card title="Problèmes de connexion" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, connexion à Tillor et adoption" />
  <Card title="Glossaire" href="/controllers/lexicon" description="Termes comme OTA, adoption et ACL" />
</Cards>

## Termes [#begrippen]

- **Contrôleur** : le boîtier avec écran et lecteur de tag.
- **Tag** : la carte, le bracelet ou le porte-clés d'un client. Voir [NFC](/nfc).
- **Adoption** : vous associez un nouveau contrôleur à votre organisation.
- **ACL** : la liste qui détermine si un tag est autorisé. Voir [le glossaire](/controllers/lexicon).
- **Firmware** : le logiciel du boîtier.

Vous trouverez plus d'explications dans la [liste des termes](/begrippen).


# Glossaire (/fr-FR/controllers/lexicon)

Un aperçu des termes que vous rencontrez en travaillant avec les contrôleurs. Chaque terme est accompagné d'une explication et, dans une citation, de ce que nous entendons par là en langage courant.

## A [#a]

<LexiconList>
<LexiconEntry
  term="ACL"
  termAlt="(Access Control List)"
  definition="Contrôle d'accès via le contrôleur. Avec l'ACL activé, il vérifie si une carte NFC est autorisée ; avec l'ACL désactivé, les cartes sont scannées mais pas validées. La priorité ACL détermine s'il consulte d'abord sa mémoire locale ou Tillor en ligne."
  simple="Le contrôleur regarde dans une liste si votre carte est autorisée. Cette liste s'appelle l'ACL."
/>
<LexiconEntry
  term="Adoption"
  definition="L'association d'un contrôleur à votre organisation dans Tillor. Après l'adoption, le contrôleur reçoit les bons paramètres et peut se connecter à Tillor."
  simple="Vous dites dans Tillor « ce contrôleur est à nous ». Ensuite, le contrôleur connaît votre organisation et coopère."
/>
<LexiconEntry
  term="API"
  definition="La consultation de Tillor en ligne pour le contrôle d'accès. Avec API d'abord, le contrôleur interroge toujours Tillor ; avec First local, il ne le fait que si la carte n'est pas connue localement."
  simple="Le contrôleur demande à Tillor en ligne si une carte est autorisée. Cette demande en ligne s'appelle l'API."
/>
</LexiconList>

## C [#c]

<LexiconList>
<LexiconEntry
  term="Contrôleur"
  definition="Le boîtier physique installé sur votre parc. Le contrôleur lit les cartes NFC, vérifie l'accès et communique avec Tillor."
  simple="Le boîtier près de la douche ou de la porte contre lequel vous approchez votre tag."
/>
<LexiconEntry
  term="Identifiants"
  definition="Données de connexion. Après l'adoption, le contrôleur reçoit automatiquement les bons identifiants pour se connecter à Tillor."
  simple="Les données de connexion avec lesquelles le contrôleur se connecte en toute sécurité à Tillor après l'adoption. Il les reçoit automatiquement : vous n'avez rien à saisir."
/>
</LexiconList>

## E [#e]

<LexiconList>
<LexiconEntry
  term="eFuse ID"
  termAlt="(Electronic Fuse ID)"
  definition="Un numéro d'identification unique enregistré dans le matériel du contrôleur. Chaque contrôleur a un eFuse ID différent : Tillor reconnaît ainsi de quel boîtier il s'agit."
  simple="Le numéro d'empreinte digitale du boîtier. Comme un numéro de série, mais gravé dans la puce."
/>
</LexiconList>

## F [#f]

<LexiconList>
<LexiconEntry
  term="Firmware"
  definition="Le logiciel qui tourne sur le contrôleur. Grâce aux mises à jour du firmware, le contrôleur reçoit de nouvelles fonctions et des améliorations."
  simple="Le programme dans le boîtier. Comme votre téléphone qui reçoit une mise à jour."
/>
</LexiconList>

## N [#n]

<LexiconList>
<LexiconEntry
  term="NFC"
  definition="Near Field Communication : la technologie avec laquelle le contrôleur lit les cartes, bracelets et porte-clés. Vous approchez le tag de l'écran pour scanner."
  simple="La façon dont le contrôleur lit votre tag. Vous l'approchez simplement : pas de code-barres ni de code PIN."
/>
</LexiconList>

## O [#o]

<LexiconList>
<LexiconEntry
  term="OTA"
  termAlt="(Over-The-Air)"
  definition="Mises à jour via internet, sans rien avoir à brancher. Le contrôleur télécharge et installe automatiquement le nouveau firmware."
  simple="Le boîtier récupère lui-même le nouveau logiciel via internet. Vous n'avez rien à faire : cela se fait tout seul."
/>
</LexiconList>

## R [#r]

<LexiconList>
<LexiconEntry
  term="Relais"
  definition="Un interrupteur dans le contrôleur avec lequel vous pouvez commander un point d'accès ou un autre appareil."
  simple="Un bouton dans le boîtier qui peut ouvrir ou fermer votre point d'accès."
/>
</LexiconList>

## S [#s]

<LexiconList>
<LexiconEntry
  term="Écran"
  definition="L'écran tactile rond du contrôleur. Il affiche l'état en langage courant (prêt, payé, refusé, pas de connexion), le QR code pour payer en ligne, et vous y configurez le Wi-Fi. Le lecteur de tag se trouve derrière l'écran."
  simple="Le petit écran rond contre lequel vous approchez votre tag. Il indique ce qui se passe."
/>
</LexiconList>

## T [#t]

<LexiconList>
<LexiconEntry
  term="Tag"
  definition="Le support NFC remis à un client : une carte, un bracelet, un porte-clés ou un autocollant. Le tag est associé à un client dans Tillor et peut avoir un solde."
  simple="La carte, le bracelet ou le porte-clés avec lequel vous prenez votre douche ou entrez."
/>
<LexiconEntry
  term="Tillor"
  definition="La plateforme de gestion de parc. Le contrôleur se connecte à Tillor pour vérifier l'accès et échanger des données."
  simple="Le programme dans lequel vous travaillez, sur votre ordinateur ou votre tablette. Le contrôleur communique avec lui."
/>
</LexiconList>

## U [#u]

<LexiconList>
<LexiconEntry
  term="Fenêtre de mise à jour"
  definition="La plage horaire pendant laquelle le contrôleur peut se mettre à jour (par ex. entre 02:00 et 04:00). En dehors de cette fenêtre, aucune mise à jour n'est effectuée."
  simple="Vous choisissez vous-même quand le boîtier peut se mettre à jour. Par exemple uniquement la nuit, pour que personne ne soit gêné en journée."
/>
</LexiconList>


# Paramètres du contrôleur (/fr-FR/controllers/settings)

Voici une page de référence sur les paramètres d'un contrôleur. Vous les trouvez sous <UIPath>Contrôleurs > Aperçu > [nom du contrôleur]</UIPath>, dans le formulaire sous l'en-tête. Cliquez sur **Enregistrer** pour appliquer les modifications. Tillor transmet ensuite les paramètres au contrôleur. Vous modifiez le nom, le type et le groupe dans [Gérer un contrôleur](/controllers/controller-beheren).

## Configuration ACL [#acl-configuratie]

L'<Term term="ACL">ACL</Term> (Access Control List) détermine comment le contrôleur vérifie l'accès. *Autrement dit : comment le boîtier vérifie si une carte est autorisée.*

| Paramètre | Signification |
| ---------- | --------- |
| **ACL activé** | Mettez sur **Oui** pour utiliser le contrôle d'accès via le contrôleur. Sur **Non**, les cartes sont scannées mais pas validées. Par défaut, c'est sur **Non**. |
| **Priorité ACL** | **First local** : le contrôleur vérifie d'abord sa propre mémoire, puis Tillor. *Pratique si internet est coupé un instant.* **API d'abord** : toujours interroger Tillor directement. Par défaut **First local**. |
| **Délai d'expiration <Term term="API">API</Term> ACL** | Durée (en millisecondes) pendant laquelle le contrôleur attend Tillor avant de basculer. Par défaut 1000 ms (1 seconde). |

<Callout type="info" title="Quand choisir First local ?">
Choisissez **First local** si vous voulez que le contrôleur fonctionne aussi lors de coupures internet temporaires. Le contrôleur enregistre les droits d'accès localement.
</Callout>

## Configuration internet [#internetconfiguratie]

| Paramètre | Signification |
| ---------- | --------- |
| **Connexion réseau principale** | **Wifi** ou **Ethernet** (câble réseau). C'est la connexion que le contrôleur essaie en premier. Par défaut **Wifi**. |
| **Réseaux Wi-Fi** | La liste des réseaux Wi-Fi que le contrôleur connaît, avec un maximum de 8. Voir [Configurer les réseaux Wi-Fi](/controllers/wifi-netwerken). |

## Configuration des mises à jour [#updateconfiguratie]

Voir [Mises à jour du <Term term="firmware">firmware</Term>](/controllers/updates) pour une explication détaillée de la fréquence des mises à jour, de la fenêtre de mise à jour et de l'option d'ignorer les mises à jour OTA.

| Paramètre | Signification |
| ---------- | --------- |
| **Fréquence de mise à jour** | À quelle fréquence le boîtier vérifie s'il existe une nouvelle version : **Heure**, **Quotidien** ou **Hebdomadaire**. |
| **Période de mise à jour de/à** | *Quand le boîtier peut-il se mettre à jour ?* Par ex. 02:00-04:00 = uniquement la nuit. |
| **Ignorer les mises à jour <Term term="OTA">OTA</Term>** | Mettez sur **Oui** si le boîtier ne doit plus récupérer de mises à jour. *Pratique temporairement, mais normalement, laissez sur Non.* |

## Commande du relais [#relais-aansturing]

Le <Term term="relais">relais</Term> est un interrupteur dans le boîtier. *Vous pouvez par exemple l'utiliser pour ouvrir ou fermer un point d'accès.*

| Paramètre | Signification |
| ---------- | --------- |
| **Type de relais** | Actuellement, seul **Interne** est pris en charge. |
| **Port du relais** | Numéro de port du relais. Par défaut 1. |

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Configurer les réseaux Wi-Fi" href="/controllers/wifi-netwerken" description="Réseaux et priorité" />
  <Card title="Mises à jour du firmware" href="/controllers/updates" description="Fenêtre de mise à jour et paramètres OTA" />
  <Card title="Messages à l'écran" href="/controllers/troubleshooting/scherm" description="Ce qu'affiche l'écran du contrôleur" />
</Cards>


# Messages à l'écran (/fr-FR/controllers/troubleshooting/scherm)

Le contrôleur possède un <Term term="scherm">écran tactile</Term> rond. Il affiche en langage courant ce que fait le contrôleur : un titre, une ligne d'explication en dessous et une bordure colorée. *Vous n'avez donc plus à retenir des couleurs : c'est écrit.* Vous trouvez ci-dessous chaque message et ce qu'il faut en faire.

## Prêt à l'emploi [#klaar-voor-gebruik]

| À l'écran | Signification |
| ------------- | --------- |
| **Scanner le QR** et **Scannez votre tag**, avec **À payer** et un montant | Le contrôleur est prêt. Le client approche un tag de l'écran ou scanne le QR code avec un smartphone. |
| QR code grisé et barré | Le contrôleur n'a temporairement plus de connexion avec Tillor. Le paiement avec un tag continue de fonctionner, le paiement en ligne via le QR code ne fonctionne plus un moment. |

## Scanner un tag [#een-tag-scannen]

Vous scannez un tag <Term term="NFC">NFC</Term> en l'approchant brièvement de l'écran, comme pour un paiement sans contact.

| À l'écran | Signification |
| ------------- | --------- |
| **Patientez** - Paiement en cours de traitement | Le tag a été lu, le contrôleur demande à Tillor si c'est autorisé. Maintenez encore un peu le tag contre l'écran. |
| **Paiement réussi !** avec le montant débité et le solde | Payé. La douche ou l'appareil démarre. |
| **Bienvenue** avec le nom du client | Accès accordé, pour une porte ou un équipement sans paiement. |

Si un tag est refusé, la raison s'affiche à l'écran :

| À l'écran | Ce qui se passe | Que faire |
| ------------- | --------------------- | ---------- |
| **Tag non reconnu** - Ce tag n'appartient pas à cet endroit | Le tag n'est pas celui de votre parc. | Donnez au client un tag du parc. |
| **Tag non reconnu** - Ce n'est pas un tag valide | Le contrôleur ne peut pas lire ce type de tag. | Utilisez un tag que vous avez reçu via Tillor. |
| **Échec du scan** - Tag mal lu | Le tag a été retiré trop vite. | Approchez à nouveau le tag de l'écran, un peu plus longtemps. |
| **Paiement refusé** - Pas d'accès | Le tag n'est pas autorisé sur ce contrôleur. | Vérifiez dans Tillor le groupe d'accès du tag. |
| **Paiement refusé** - Tag non associé | Le tag n'est pas encore associé à un client. | Associez le tag au client dans Tillor. |
| **Paiement refusé** - Solde insuffisant | Il y a trop peu sur le tag. Le solde est indiqué. | Rechargez le tag à la réception. |
| **Serveur inaccessible** | Le paiement n'a pas pu être traité. | Réessayez plus tard ; voir [Problèmes de connexion](/controllers/troubleshooting/verbinding). |
| **Échec de la mise à jour du tag** | Le solde n'a pas pu être enregistré sur le tag. | Approchez à nouveau le tag de l'écran et laissez-le jusqu'à ce que le message disparaisse. |

<Callout type="info" title="Un scan par présentation">
Laisser le tag contre l'écran n'a aucun effet : chaque présentation compte pour un scan. Si vous voulez scanner à nouveau, retirez le tag puis approchez-le de nouveau de l'écran.
</Callout>

## Démarrage et connexion [#opstarten-en-verbinden]

| À l'écran | Bordure | Signification | Que faire |
| ------------- | ---- | --------- | ---------- |
| **Connexion...** | Bleue | Le contrôleur démarre et cherche une connexion à internet et à Tillor. | Attendez 1 à 2 minutes. |
| **Configurer le Wi-Fi** - Choisissez un réseau Wi-Fi sur l'écran | Violette | Le contrôleur n'a pas encore de réseau. | Touchez **Configurer le Wi-Fi** et choisissez votre réseau ; voir [Configurer le Wi-Fi sur l'écran](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). |
| **Configurer le Wi-Fi** - Identifiants Wi-Fi refusés | Violette | Le mot de passe n'est pas (ou plus) correct. | Saisissez à nouveau le mot de passe sur l'écran. |
| **Activer le contrôleur** - Activez l'appareil … dans Tillor | Violette | Le contrôleur attend l'<Term term="adoptie">adoption</Term>. | Dans Tillor, allez dans **Contrôleurs** et cliquez sur **Approuver** (✓). |
| **Connexion perdue** - nouvel essai | Rouge | La connexion internet est coupée. Le contrôleur réessaie de lui-même. | Voir [Problèmes de connexion](/controllers/troubleshooting/verbinding#verbinding-verbroken). |
| **Connexion perdue** - Hors ligne depuis trop longtemps | Rouge | Le contrôleur est sans connexion depuis trop longtemps. Les paiements sont désactivés tant que la connexion n'est pas rétablie. | Rétablissez la connexion réseau. |

## Mises à jour et redémarrages [#updates-en-herstarten]

| À l'écran | Bordure | Signification |
| ------------- | ---- | --------- |
| **Mise à jour** avec un pourcentage | Ambre | Une mise à jour du <Term term="firmware">firmware</Term> est en cours de téléchargement et d'installation. Laissez l'alimentation branchée. |
| **Redémarrage** | Jaune | Le contrôleur redémarre, après une mise à jour ou parce que vous avez cliqué sur **Redémarrer le contrôleur** dans Tillor. |

## Pannes [#storingen]

| À l'écran | Signification | Que faire |
| ------------- | --------- | ---------- |
| **Lecteur de tag indisponible** | Le lecteur de tag ne démarre pas. Le contrôleur essaie de le rétablir de lui-même. | Attendez une minute. Si le message reste affiché, [redémarrez le contrôleur](/controllers/controller-beheren#een-controller-herstarten). |
| **Pas de connexion** - Connexion au contrôleur | L'écran ne reçoit aucun signal du reste du contrôleur. | Redémarrez le contrôleur. Si cela persiste, contactez le support Tillor. |
| L'écran reste noir | Le contrôleur n'a pas d'alimentation. | Vérifiez l'alimentation et le câblage. |

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Problèmes de connexion" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, connexion à Tillor et adoption" />
  <Card title="Paramètres du contrôleur" href="/controllers/settings" description="ACL, réseau, mises à jour et relais" />
</Cards>


# Problèmes de connexion (/fr-FR/controllers/troubleshooting/verbinding)

Si le contrôleur ne se connecte pas correctement, son <Term term="scherm">écran</Term> indique où le problème se situe. Vous trouverez ci-dessous, pour chaque message, ce qui se passe et ce que vous devez faire. Tous les messages figurent sur [Messages à l'écran](/controllers/troubleshooting/scherm).

## Configurer le Wi-Fi sur l'écran [#wifi-instellen-op-het-scherm]

Si l'écran affiche **Configurer le Wi-Fi**, le contrôleur n'a pas encore de réseau. Avec un câble réseau (Ethernet), vous n'avez rien à faire ; pour le Wi-Fi, vous configurez le réseau sur le contrôleur lui-même :

1. Touchez **Configurer le Wi-Fi**
2. Choisissez votre réseau dans la liste. La force du signal est indiquée pour chaque réseau : vert signifie bon, orange moyen, rouge faible
3. Saisissez le mot de passe avec le clavier à l'écran et validez
4. L'écran affiche **Connecté** - le Wi-Fi est configuré

Si votre réseau n'apparaît pas, touchez « rechercher à nouveau ». Pour modifier le réseau plus tard, appuyez longuement sur l'écran pendant que le contrôleur est prêt, ou modifiez-le dans les [paramètres](/controllers/settings#internetconfiguratie) de Tillor.

| Message | Solution |
| ------- | -------- |
| **Échec de la connexion** - Vérifiez le mot de passe | Saisissez à nouveau le mot de passe ; faites attention aux majuscules. |
| **Échec de la connexion** - Réseau introuvable | Rapprochez le contrôleur du point d'accès ou choisissez un autre réseau. |
| **Échec de la connexion** - La recherche de réseaux a échoué | Touchez « rechercher à nouveau ». Si le problème persiste, redémarrez le contrôleur. |
| **Configurer le Wi-Fi** - Identifiants Wi-Fi refusés | Le mot de passe enregistré n'est plus correct. Saisissez-le à nouveau sur l'écran. |

## Activer le contrôleur [#controller-activeren]

**Signification :** Le contrôleur attend l'<Term term="adoptie">adoption</Term> - il n'est pas encore relié à Tillor. *Le boîtier est prêt, mais ne sait pas encore à quelle organisation il appartient.* L'écran affiche **Activer le contrôleur** avec le numéro de l'appareil.

**Solution :**
1. Dans Tillor, allez dans **Contrôleurs**
2. Cherchez la ligne **En attente d'approbation** portant le même numéro (l'<Term term="eFuse ID">eFuse ID</Term>)
3. Cliquez sur **Approuver** (✓) pour relier le contrôleur à votre organisation

## Connexion perdue [#verbinding-verbroken]

**Signification :** La connexion internet est coupée. Le contrôleur essaie de se reconnecter automatiquement. *Le boîtier a perdu le contact avec Tillor et essaie de le rétablir.*

Tant que la coupure est courte, les clients peuvent continuer à payer avec leur badge ; le code QR est alors grisé et barré. Si l'écran affiche **Hors ligne depuis trop longtemps**, les paiements sont désactivés jusqu'au retour de la connexion.

Dans Tillor, le contrôleur apparaît hors ligne après environ 35 secondes sans contact. Après 5 minutes, l'équipe Tillor reçoit une alerte.

**Causes possibles :**
- **Le Wi-Fi a été coupé** - vérifiez que le réseau Wi-Fi est accessible
- **Panne d'internet** - le contrôleur ne peut pas joindre Tillor
- **Tillor est temporairement inaccessible**

**Solution :**
- Patientez quelques minutes - le contrôleur essaie de se reconnecter lui-même
- Vérifiez que les autres appareils du même réseau ont accès à internet
- Vérifiez les [paramètres Wi-Fi](/controllers/settings) du contrôleur (nom du réseau, mot de passe)
- Assurez-vous que le contrôleur se trouve à portée du point d'accès Wi-Fi, ou utilisez un câble réseau

## L'écran reste sur Connexion... [#scherm-blijft-op-verbinden]

**Signification :** Le contrôleur est encore en train de démarrer ou de se connecter. Sous le titre figure l'étape en cours, par exemple *Établissement de la connexion internet* ou *Recherche de mises à jour*.

**Solution :**
- Patientez 1 à 2 minutes - le démarrage prend un peu de temps
- S'il reste sur *Établissement de la connexion internet* : vérifiez le câble réseau ou [reconfigurez le Wi-Fi](#wifi-instellen-op-het-scherm)
- Vérifiez que le signal Wi-Fi est assez fort

## Le contrôleur n'apparaît pas dans Tillor [#controller-verschijnt-niet-in-tillor]

**Signification :** Le contrôleur n'est pas encore visible pour l'adoption.

**Causes possibles :**
- Le contrôleur n'a pas de connexion internet (il ne peut pas joindre Tillor)
- Le contrôleur est encore en train de démarrer
- Vous ouvrez Tillor depuis un autre réseau que celui auquel le contrôleur est connecté - les demandes d'adoption ne sont alors parfois pas visibles

**Solution :**
1. Vérifiez que le contrôleur est alimenté et que l'écran est allumé
2. Regardez ce qu'affiche l'écran : avec **Configurer le Wi-Fi** ou **Connexion...**, il n'est pas encore en ligne
3. Attendez que l'écran affiche **Activer le contrôleur** et que la ligne **En attente d'approbation** apparaisse dans la liste - cela peut prendre un moment
4. Ouvrez Tillor depuis le même réseau que le contrôleur, ou contactez le support
5. Actualisez la page Contrôleurs dans Tillor (les nouvelles demandes apparaissent aussi automatiquement)

## L'adoption échoue ou les identifiants sont refusés [#adoptie-mislukt-of-credentials-worden-geweigerd]

L'<Term term="adoptie">adoption</Term> consiste à relier le contrôleur à votre organisation ; les <Term term="credentials">identifiants</Term> sont les données de connexion qui vont avec.

**Signification :** La liaison avec Tillor a échoué. *Le boîtier n'a pas pu être relié à votre organisation.*

**Solution :**
- Vérifiez que l'horloge du contrôleur est correcte (un grand décalage horaire peut bloquer la liaison)
- Après un flash du firmware ou une nouvelle clé, le contrôleur doit être approuvé à nouveau
- Réessayez l'adoption via **Approuver** (✓)
- Contactez le support si le problème persiste - il a accès aux journaux

## La mise à jour OTA reste bloquée ou échoue [#ota-update-blijft-hangen-of-faalt]

Une mise à jour <Term term="OTA">OTA</Term> est une mise à jour du <Term term="firmware">firmware</Term> via internet. Pendant une mise à jour, l'écran affiche **Mise à jour** avec un pourcentage.

**Signification :** La mise à jour du firmware n'est pas terminée. *Le boîtier a essayé d'installer un nouveau logiciel, mais cela ne s'est pas bien passé.*

**Solution :**
- Attendez que la [<Term term="updatevenster">fenêtre de mise à jour</Term>](/controllers/updates) soit active - les mises à jour n'ont lieu que dans cette fenêtre
- Vérifiez que le contrôleur dispose d'une connexion internet stable
- Activez temporairement [Ignorer les mises à jour OTA](/controllers/updates#ota-updates-overslaan) si vous voulez d'abord stabiliser le contrôleur

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Messages à l'écran" href="/controllers/troubleshooting/scherm" description="Que signifie le message à l'écran ?" />
  <Card title="Paramètres du contrôleur" href="/controllers/settings" description="Configurer le Wi-Fi et le réseau" />
</Cards>


# Mises à jour du firmware (/fr-FR/controllers/updates)

Un contrôleur récupère lui-même de nouveaux logiciels via internet, comme votre téléphone. Ce logiciel s'appelle <Term term="firmware">firmware</Term>. Vous décidez **quand** et **à quelle fréquence** il peut le faire. Par défaut, il vérifie chaque jour s'il y a du nouveau. Si vous voulez lancer une mise à jour tout de suite, faites-le depuis la page du contrôleur, voir [Gérer un contrôleur](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie).

## Fréquence des mises à jour [#updatefrequentie]

Le contrôleur vérifie régulièrement si une nouvelle version du firmware est disponible :

| Option | Signification |
| ------ | ------------- |
| **Heure** | Vérifie les mises à jour toutes les heures. |
| **Tous les jours** | Vérifie une fois par jour (par défaut). |
| **Hebdomadaire** | Vérifie une fois par semaine. |

Après la vérification, une mise à jour n'est exécutée que s'il existe une version plus récente. Si vous avez défini une fenêtre de mise à jour, l'heure actuelle doit aussi se trouver dans cette fenêtre. *Autrement dit : le boîtier vérifie bien s'il y a du nouveau, mais ne l'installe qu'aux heures que vous avez définies.*

## Fenêtre de mise à jour [#updatevenster]

La fenêtre de mise à jour est la plage horaire pendant laquelle le contrôleur peut se mettre à jour. Si vous avez rempli **Période de mise à jour de** et **Période de mise à jour à**, les mises à jour ne sont exécutées que pendant ces heures. *En clair : vous choisissez vous-même quand le boîtier peut se mettre à jour, par exemple uniquement la nuit.*

**Exemple :** si vous réglez **Période de mise à jour de** sur 02:00 et **Période de mise à jour à** sur 04:00, une mise à jour n'a lieu qu'entre 02:00 et 04:00. Vous évitez ainsi que le contrôleur redémarre en pleine journée, aux heures d'affluence.

### Configurer [#instellen]

1. Allez dans <UIPath>Contrôleurs > Aperçu > [nom du contrôleur]</UIPath>
2. Faites défiler jusqu'à **Configuration des mises à jour**
3. Choisissez **Fréquence de mise à jour** (Heure, Tous les jours ou Hebdomadaire)
4. Remplissez **Période de mise à jour de** (par ex. 02:00)
5. Remplissez **Période de mise à jour à** (par ex. 04:00)
6. Cliquez sur **Enregistrer**

## Ignorer les mises à jour OTA [#ota-updates-overslaan]

<Term term="OTA">OTA</Term> signifie Over-The-Air : des mises à jour via internet. Si vous réglez **Ignorer les mises à jour OTA** sur **Oui**, le contrôleur n'installe plus de nouveau firmware. Le contrôleur reste sur la version actuelle. *Autrement dit : le boîtier ne se met plus à jour de lui-même via OTA.*

**Quand l'utiliser ?**

- Temporairement, si vous ne voulez aucun changement pendant une période chargée
- Pour des contrôleurs de test ou de démonstration qui doivent rester sur une version fixe

<Callout type="info" title="Recommandation">
Laissez **Ignorer les mises à jour OTA** sur **Non** par défaut. Les mises à jour contiennent souvent des améliorations et des correctifs de sécurité.
</Callout>

## Que se passe-t-il pendant une mise à jour ? [#wat-gebeurt-er-tijdens-een-update]

1. Le contrôleur détecte une nouvelle version du <Term term="firmware">firmware</Term>
2. Le firmware est téléchargé
3. L'écran affiche **Mise à jour** avec un pourcentage - le contrôleur est en cours de mise à jour
4. Le contrôleur redémarre automatiquement ; l'écran affiche **Redémarrage**
5. Après le redémarrage, la nouvelle version est active

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Une mise à jour ne démarre que s'il existe une version plus récente et que l'heure se situe dans votre fenêtre de mise à jour.
- Pendant la mise à jour et le redémarrage, l'écran affiche **Mise à jour** et **Redémarrage**. Prévoyez donc la fenêtre pour la nuit.
- Si vous réglez **Ignorer les mises à jour OTA** sur **Oui**, le contrôleur reste sur sa version actuelle jusqu'à ce que vous le remettiez comme avant.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le contrôleur ne se met pas à jour">
Vérifiez que **Ignorer les mises à jour OTA** est sur **Non** et que l'heure se situe dans votre fenêtre de mise à jour. Vérifiez aussi la connexion internet du contrôleur. Vous en saurez plus sous [La mise à jour OTA reste bloquée ou échoue](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt).
</Accordion>
<Accordion title="L'écran reste sur Mise à jour">
Laissez l'alimentation branchée et patientez quelques minutes. Si rien ne change, redémarrez le contrôleur et contactez le support.
</Accordion>
<Accordion title="Tillor indique : Échec de la mise à jour OTA">
La mise à jour n'a pas pu être lancée. Vérifiez que le contrôleur est en ligne et réessayez.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres du contrôleur" href="/controllers/settings" description="Aperçu de tous les paramètres" />
  <Card title="Messages à l'écran" href="/controllers/troubleshooting/scherm" description="Mise à jour et Redémarrage" />
</Cards>


# Configurer les réseaux Wi-Fi (/fr-FR/controllers/wifi-netwerken)

Un contrôleur peut connaître plusieurs réseaux Wi-Fi et bascule lui-même vers le meilleur. C'est pratique si votre parc a un point d'accès à plusieurs endroits. Vous les configurez sur la page du contrôleur. Si le contrôleur n'a encore aucun réseau, configurez plutôt le Wi-Fi sur l'écran lui-même, voir [Configurer le Wi-Fi sur l'écran](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).

Avant de commencer :

- Le contrôleur est approuvé, voir [Relier un contrôleur](/controllers/controller-koppelen).
- Vous connaissez, pour chaque réseau, le nom (SSID) et le mot de passe. Un réseau ouvert n'a pas de mot de passe.

## Ajouter des réseaux [#netwerken-toevoegen]

<Steps>
<Step>
### Ouvrez le contrôleur [#open-de-controller]
Allez dans <UIPath>Contrôleurs > Aperçu</UIPath> et cliquez sur le contrôleur. Faites défiler jusqu'à **Réseaux Wi-Fi**.
</Step>
<Step>
### Ajoutez un réseau [#voeg-een-netwerk-toe]
Cliquez sur **Ajouter un réseau** et remplissez le **Nom du réseau (SSID)** et le **Mot de passe**. Laissez le mot de passe vide pour un réseau ouvert. Répétez l'opération pour chaque réseau.
</Step>
<Step>
### Mettez-les dans l'ordre [#zet-ze-in-volgorde]
Faites glisser une ligne par la poignée à gauche. L'ordre est la priorité : le contrôleur essaie les réseaux à portée de haut en bas.

<DocScreenshot src="/screenshots/controllers/controller-wifi-networks.png" alt="Réseaux Wi-Fi avec deux réseaux classés par ordre de priorité" />
</Step>
<Step>
### Cliquez sur Enregistrer [#klik-op-opslaan]
Le bouton **Enregistrer** se trouve en bas du formulaire. Tillor transmet ensuite la liste au contrôleur.
</Step>
</Steps>

Pour supprimer un réseau, utilisez le bouton moins (**Supprimer le réseau**).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le contrôleur vérifie chaque réseau séparément. Si le premier réseau disparaît ou si le mot de passe est incorrect, il utilise le suivant.
- Sur la page de détail, sous **Réseaux Wi-Fi connus, par priorité**, vous voyez où en est chaque réseau :

| Statut | Signification |
|---|---|
| <Status tone="success">Connecté</Status> | Le contrôleur utilise ce réseau actuellement. |
| <Status>Vérifié</Status> | Le réseau fonctionne, mais le contrôleur utilise actuellement un autre réseau. |
| <Status tone="info">Pas encore vérifié</Status> | Le contrôleur n'a pas encore pu tester ce réseau. |
| <Status tone="warning">Échec</Status> | Le réseau ne fonctionne pas. La raison est indiquée, par exemple un mot de passe incorrect, un réseau introuvable ou l'absence d'accès à internet. |

- Pour chaque réseau, il est indiqué s'il est **à portée** ou **hors de portée**, parfois avec la force du signal en dBm. Les réseaux saisis sur l'écran portent la mention **ajouté sur l'écran**.
- Si la liste est vide, aucun réseau n'est configuré dans Tillor. Les réseaux que quelqu'un a ajoutés sur l'écran restent enregistrés sur le contrôleur.
- Les contrôleurs plus anciens, qui ne connaissent qu'un seul réseau, affichent à la place un seul message sur la dernière modification, comme **Modification Wi-Fi pas encore confirmée** ou **Identifiants Wi-Fi refusés**. Le contrôleur reste alors connecté au réseau précédent.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Ajouter un réseau est grisé">
Un contrôleur mémorise au maximum 8 réseaux. Tillor l'indique avec **Un contrôleur mémorise jusqu’à 8 réseaux.** Supprimez d'abord un réseau dont vous n'avez plus besoin.
</Accordion>
<Accordion title="Tillor indique : Saisissez un nom de réseau">
Une ligne n'a pas de nom de réseau. Saisissez le nom ou supprimez la ligne.
</Accordion>
<Accordion title="Tillor indique : Ce réseau figure déjà dans la liste">
Chaque nom de réseau ne peut apparaître qu'une seule fois. Supprimez la ligne en double.
</Accordion>
<Accordion title="Un réseau est en Échec">
Lisez la raison indiquée pour le réseau. Vérifiez le nom et le mot de passe. Le contrôleur réessaie lui-même et les autres réseaux continuent de fonctionner.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Problèmes de connexion" href="/controllers/troubleshooting/verbinding" description="Wi-Fi et connexion à Tillor" />
  <Card title="Paramètres du contrôleur" href="/controllers/settings" description="Préférence de réseau et autres paramètres" />
</Cards>


# Manuel Tillor (/fr-FR)

<HomeHero title="Comment faire dans Tillor ?">
  Des explications par tâche pour la réception, l'administration et le service technique. Cherchez ce que vous voulez faire, ou commencez par votre rôle.
</HomeHero>

<HomeSection title="Sur quoi travaillez-vous ?" description="Par rôle, les tâches qui reviennent le plus souvent.">

<RoleCard title="Réception" description="Accueillir les clients, enregistrer les arrivées et répondre aux questions." href="/reserveringen" icon={<ConciergeBellIcon />}>

- [Rechercher ou créer un client](/klantenbeheer)
- [Créer une réservation](/reserveringen)
- [Enregistrer l'arrivée d'un client avec une occupation](/bezettingen#een-bezetting-aanmaken)
- [Répondre aux messages dans la boîte de réception](/inbox)

</RoleCard>

<RoleCard title="Administration" description="Factures, paiements et la liaison avec votre comptabilité." href="/facturen" icon={<LandmarkIcon />}>

- [Créer et comptabiliser une facture](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken)
- [Enregistrer un paiement](/facturen/betalingen-registreren)
- [Prolonger une occupation via une facture](/bezettingen#facturatie-bezetting-verlengen)
- [Rapports de paiement vers votre comptabilité](/boekhouden/betalingsrapporten)

</RoleCard>

<RoleCard title="Service technique" description="Barrières, compteurs, contrôleurs et tablettes sur le terrain." href="/controllers" icon={<CpuIcon />}>

- [Ouvrir ou fermer un point d'accès](/toegangscontrole#toegangspunten-bedienen)
- [Relier un compteur à un terrain](/meterbeheer/meter-koppelen)
- [Que signifie le message à l'écran ?](/controllers/troubleshooting/scherm)
- [Configurer une borne](/mobiele-app/kiosk-inrichten)

</RoleCard>

<RoleCard title="Développeurs" description="Relier Tillor à vos propres systèmes ou à votre site web." href="/ontwikkelaars" icon={<BracesIcon />}>

- [Créer une clé API](/ontwikkelaars/http)
- [Recevoir des webhooks](/ontwikkelaars/webhooks)
- [Événements en temps réel via SSE](/ontwikkelaars/sse)
- [Relier des outils d'IA avec MCP](/ontwikkelaars/mcp)

</RoleCard>

</HomeSection>

<HomeSection title="Pour aller plus loin">

<HomeLink title="Nouveau chez Tillor ?" description="Se connecter, s'orienter et configurer votre parc." href="/aan-de-slag" icon={<RocketIcon />} />

<HomeLink title="En pratique" description="Quatre exemples détaillés qui combinent plusieurs modules." href="/praktijk" icon={<RouteIcon />} />

<HomeLink title="Glossaire" description="Les mots que vous rencontrez dans Tillor, expliqués brièvement." href="/begrippen" icon={<RocketIcon />} />

<HomeLink title="Nouveautés" description="Les changements récents dans Tillor, mois par mois." href="/wat-is-nieuw" icon={<SparklesIcon />} />

<HomeLink title="Tablettes et bornes" description="L'application Tillor sur des tablettes à la réception ou à l'extérieur." href="/mobiele-app" icon={<TabletSmartphoneIcon />} />

<HomeLink title="État du système" description="Tout fonctionne ? Consultez les pannes et les maintenances." href="https://status.tillor.eu" icon={<ActivityIcon />} />

</HomeSection>


# Envoyer une commande à une tablette (/fr-FR/mobiele-app/acties-op-afstand)

À droite de la page de l'appareil se trouve le panneau **Actions à distance**, quel que soit l'onglet ouvert. C'est là que vous envoyez une commande à l'appareil et que vous demandez une capture d'écran. Ce que l'appareil signale lui-même, vous le lisez dans [Diagnostic et historique](/mobiele-app/diagnose-en-geschiedenis).

<Requires permission="Modifier les paramètres" />

Avant de commencer :

- L'appareil doit être connecté. Une commande passe par la connexion en direct avec l'application. Si l'appareil est hors ligne, le panneau indique **L’appareil est hors ligne : les commandes n’arrivent qu’une fois qu’il est de nouveau connecté.** Tillor signale alors bien que la commande est envoyée, mais la tablette ne la voit pas.
- **Redémarrer l'appareil** ne fonctionne que si Tillor est propriétaire de la tablette. Voir [Configurer une borne](/mobiele-app/kiosk-inrichten).

## Envoyer une commande [#een-opdracht-versturen]

<Steps>
<Step>
### Ouvrez l'appareil [#open-het-toestel]
Allez dans <UIPath>Paramètres > Tablettes et bornes</UIPath> et cliquez sur la ligne de l'appareil.
</Step>
<Step>
### Choisissez la commande [#kies-de-opdracht]
Dans le panneau **Actions à distance**, cliquez sur la commande. Vous recevez le message **Envoyé à l'appareil**, ou **Impossible de joindre l'appareil** s'il n'a pas pu être envoyé.

<DocScreenshot src="/screenshots/tablets/remote-actions.png" alt="Actions à distance et le bloc Capture d'écran" />
</Step>
</Steps>

Les commandes :

- **Afficher le nom à l'écran** affiche le nom de l'appareil en grand pendant un instant. Pratique quand deux tablettes sont côte à côte et que vous voulez savoir laquelle vous avez ouverte.
- **Lire un son de test** joue le son de notification, au volume de l'onglet **Tickets et son**.
- **Réveiller l’écran** sort l'appareil du repos nocturne ou de **Mettre l’écran en veille**.
- **Mettre l’écran en veille** rend l'écran noir, même en dehors du repos nocturne.
- **Dormir 30 secondes** fait la même chose et réveille ensuite l'écran tout seul. Vous vérifiez ainsi que l'écran se rallume, sans attendre le matin.
- **Redémarrer l'appareil** redémarre la tablette. Sur une tablette dont Tillor n'est pas propriétaire, le bouton reste grisé.
- **Installer la mise à jour** installe une mise à jour de l'application déjà disponible.
- **Redémarrer l'application** redémarre uniquement l'application Tillor, pas la tablette.

## Demander une capture d'écran [#een-schermafbeelding-opvragen]

<Steps>
<Step>
### Cliquez sur Demander une capture d’écran [#klik-op-schermafbeelding-opvragen]
Dans le bloc **Capture d’écran**, cela envoie la demande à la tablette.
</Step>
<Step>
### Attendez l'image [#wacht-op-het-beeld]
Tillor attend un court instant et actualise l'image dès que la tablette l'a envoyée. Sous la photo figure le moment où elle a été prise.
</Step>
</Steps>

L'image montre ce que l'application affiche à ce moment : écran d'accueil, diaporama, ticket de caisse ou écran de veille. Ce n'est pas une vidéo en direct.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La tablette exécute la commande immédiatement. Toute commande, sauf les commandes de veille, réveille aussi l'écran.
- Chaque commande apparaît dans l'[historique de l'appareil](/mobiele-app/diagnose-en-geschiedenis#geschiedenis).
- Une capture d'écran reste dans le panneau jusqu'à ce que vous en demandiez une nouvelle.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Tillor indique Impossible de joindre l'appareil">
La commande n'a pas pu être envoyée à l'appareil. Il est le plus souvent hors ligne. Attendez que le statut repasse à **Connecté** et renvoyez la commande.
</Accordion>
<Accordion title="Le bouton Redémarrer l'appareil est grisé">
Tillor n'est pas propriétaire de la tablette. Configurez-la d'abord comme décrit dans [Configurer une borne](/mobiele-app/kiosk-inrichten). D'ici là, vous ne pouvez utiliser que **Redémarrer l'application**.
</Accordion>
<Accordion title="Aucune capture d'écran n'arrive">
L'appareil est hors ligne ou l'application est trop ancienne. Dans ce dernier cas, Tillor vous le dit à l'avance : **L’application sur cet appareil est trop ancienne pour les captures d’écran.** Installez une version plus récente. Tant que vous n'avez jamais demandé d'image, le message affiché est **Aucune capture d’écran demandée pour l’instant.**
</Accordion>
<Accordion title="L'écran reste noir après Réveiller l’écran">
Le réveil à distance ne fonctionne que si l'application figure aussi dans l'exception de batterie. Voir [Batterie](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Diagnostic et historique" href="/mobiele-app/diagnose-en-geschiedenis" description="Ce que l'appareil signale lui-même" />
  <Card title="Gérer une tablette ou une borne" href="/mobiele-app/tablets-en-kiosken" description="Envoyer des paramètres" />
</Cards>


# Diagnostic et historique (/fr-FR/mobiele-app/diagnose-en-geschiedenis)

Sous le panneau **Actions à distance** se trouvent deux blocs qui vous aident à contrôler une tablette : **Diagnostic** (ce que l'appareil a signalé la dernière fois) et **Historique** (le journal). Vous pouvez envoyer une commande dans le même panneau, voir [Envoyer une commande à une tablette](/mobiele-app/acties-op-afstand).

<DocScreenshot src="/screenshots/tablets/diagnostics.png" alt="Diagnostic et historique sur la page de l'appareil" />

## Diagnostic [#diagnose]

Le **Diagnostic** est le dernier message de l'appareil, pas une mesure en direct. Un tiret signifie que l'application n'a pas envoyé cette donnée.

| Donnée | Signification |
|---|---|
| **Vu pour la dernière fois** | Quand l'appareil a eu un contact pour la dernière fois |
| **Connexion** | Wi-Fi ou mobile |
| **Écran** | **Allumé** ou **En veille** |
| **Stockage libre** | Espace libre sur la tablette, en Go |
| **Langue de l’appareil** et **Fuseau horaire** | La langue et le fuseau horaire d'Android ou d'iOS. Ce n'est pas la langue que vous avez choisie pour l'application dans l'onglet **Appareil** |
| **Build**, **Version du runtime** | Quelle version de l'application est installée sur la tablette |
| **Dernière mise à jour de l’application** et **Dernière vérification de mise à jour** | Quand l'application a été mise à jour ou vérifiée pour la dernière fois |
| **Erreur de mise à jour** | Apparaît si la dernière vérification ou installation a échoué |
| **Enregistré** | Quand cet appareil est apparu pour la première fois dans la liste |

## Historique [#geschiedenis]

L'**Historique** affiche, pour chaque appareil :

- quand l'appareil s'est connecté
- quand vous avez envoyé des paramètres ou une commande
- quand l'application a été mise à jour
- quand l'appareil est passé hors ligne et quand il est revenu en ligne

Le journal s'actualise tout seul. **Aucun événement pour l’instant.** signifie que rien n'a encore été enregistré.

## Alertes [#meldingen]

Une alerte hors ligne ou de batterie n'arrive que si **Alertes** est activé dans l'onglet **Appareil**, et pas pendant le repos nocturne.

- Alerte hors ligne : l'appareil n'a rien signalé depuis 10 minutes.
- Alerte de batterie : sous 15 % sans chargeur. Tillor ne la renvoie pas tant que l'appareil n'a pas été remis sur son chargeur ou n'a pas nettement rechargé.

L'alerte est envoyée aux personnes qui gèrent les paramètres. Voir [Notifications](/notificaties).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Envoyer une commande à une tablette" href="/mobiele-app/acties-op-afstand" description="Réveiller, redémarrer et obtenir une capture d'écran" />
  <Card title="Paramètres de l'appareil" href="/mobiele-app/toestelinstellingen" description="L'onglet Appareil avec Alertes" />
</Cards>


# Aperçu (/fr-FR/mobiele-app)

L'application Tillor fonctionne sur une tablette, une borne ou un téléphone de votre parc, sous **iOS** et **Android**. Les clients et les collègues y voient l'écran d'accueil, les tickets de caisse et les demandes de signature. Depuis Tillor dans votre navigateur, vous envoyez des paramètres et des commandes à ces appareils. Une tablette qui doit rester en mode borne se configure via [Configurer une borne](/mobiele-app/kiosk-inrichten).

<Callout type="warn" title="Pas une application web complète">
L'application ne remplace pas Tillor dans votre navigateur. Gérer des réservations, créer des factures ou enregistrer des paiements se fait dans le navigateur.
</Callout>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

Un appareil apparaît tout seul dans Tillor dès que quelqu'un ouvre l'application et se connecte. Ce que vous configurez ensuite dans Tillor arrive à l'appareil par la connexion en direct. Dans l'autre sens, l'appareil se manifeste régulièrement auprès de Tillor, afin que vous voyiez s'il est toujours connecté.

```mermaid
flowchart LR
  A[Quelqu'un ouvre l'application<br/>et se connecte] --> B[L'appareil figure dans<br/>Paramètres > Tablettes et bornes]
  B --> C[Vous choisissez des paramètres<br/>et cliquez sur Enregistrer et envoyer]
  C --> D[La tablette les applique]
  E[Vous envoyez un ticket de caisse,<br/>un PDF ou une demande de signature] --> D
  D --> F[L'appareil signale batterie,<br/>connexion et version]
  F --> B
```

Si un appareil est hors ligne, les paramètres et les commandes n'arrivent que lorsqu'il est de nouveau connecté. Voir [Tablettes et bornes](/mobiele-app/tablets-en-kiosken).

<Callout type="info" title="Bon à savoir">
- Un nouvel appareil figure dans la liste dans la minute qui suit la connexion de quelqu'un.
- Tillor signale un appareil comme hors ligne après 10 minutes sans message. Cela n'arrive que si **Alertes** est activé et pas pendant le repos nocturne.
- L'alerte de batterie arrive sous 15 % sans chargeur.
- Un diaporama compte au maximum 20 photos. Vous pouvez placer six boutons supplémentaires sur l'écran d'accueil.
- Il n'y a pas de mot de passe d'application distinct. Vous vous connectez comme dans le navigateur, avec Microsoft, Google ou Apple.
</Callout>

## Installer l'application et se connecter [#de-app-installeren-en-inloggen]

Votre organisation partage le fichier d'installation ou le lien (version interne, TestFlight ou boutique d'applications, selon votre déploiement). Si vous n'avez pas encore accès, demandez à votre administrateur ou au support Tillor.

1. Ouvrez l'application après l'installation.
2. Connectez-vous avec **Microsoft**, **Google** ou **Apple**. C'est le même compte que dans le navigateur, voir [Se connecter](/inloggen).
3. Choisissez votre organisation si vous en avez plusieurs.

## Ce que l'application sait faire [#wat-de-app-kan]

- **Afficher des PDF et des images** : directement sur l'écran d'accueil dès que Tillor envoie un document à l'appareil.
- **Scanner des cartes prépayées** : lire une carte NFC et consulter les données de la carte et du client.
- **Faire entendre les paiements** : un signal sonore lors d'une facture payée.
- **Borne** : laisser l'écran allumé, régler la luminosité et afficher le logo de votre organisation.

## Ce que Tillor voit de l'appareil [#wat-tillor-van-het-toestel-ziet]

L'application envoie régulièrement à Tillor le nom, le modèle, le système d'exploitation, la version de l'application, la batterie et la connexion réseau (Wi-Fi ou mobile). Vous le voyez dans la liste des appareils et sur la page de l'appareil. Sous **Compte** > **Sessions actives**, vous retrouvez les mêmes appareils comme sessions d'application, avec les **Métadonnées de l'app**. Vous y mettez aussi fin à une session.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="L'application ne se connecte pas">
Vérifiez le Wi-Fi ou le réseau mobile, et que vous êtes connecté à la bonne organisation. Mettez l'application à jour vers la dernière version. Si cela n'aide pas, déconnectez-vous puis reconnectez-vous. Si le problème persiste, contactez votre administrateur.
</Accordion>
<Accordion title="L'appareil ne figure pas dans la liste">
Ouvrez l'application, connectez-vous et choisissez la bonne organisation. L'appareil apparaît dans la minute sous **Paramètres** > **Tablettes et bornes**. Si vous y voyez **Aucun appareil pour l'instant**, aucun appareil ne s'est encore connecté.
</Accordion>
</Accordions>

## Glossaire [#begrippen]

- **Tablette** : une tablette avec l'application Tillor, par exemple à la réception.
- **Borne** : une tablette verrouillée sur l'application Tillor, pour que les clients ne puissent pas en sortir.
- **Appareil** : toute installation de l'application qui figure dans Tillor, quel que soit le type.
- **Repos nocturne** : les heures pendant lesquelles l'écran est éteint ou noir.
- **Verrouillage d'écran** : un schéma ou un code PIN sur la tablette elle-même, différent du verrouillage de la borne.

Vous trouverez plus d'explications dans le [glossaire](/begrippen).

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Tablettes et bornes" href="/mobiele-app/tablets-en-kiosken" description="Appareils dans la liste, enregistrer et envoyer des paramètres" />
  <Card title="Configurer une borne" href="/mobiele-app/kiosk-inrichten" description="Verrouiller une tablette Android" />
  <Card title="Paramètres de l'appareil" href="/mobiele-app/toestelinstellingen" description="Tous les paramètres par onglet" />
  <Card title="Actions à distance" href="/mobiele-app/acties-op-afstand" description="Réveiller, redémarrer et obtenir une capture d'écran" />
  <Card title="Se connecter" href="/inloggen" description="Accès au compte via Microsoft, Google ou Apple" />
  <Card title="Contrôleurs" href="/controllers" description="Matériel sur votre parc" />
</Cards>


# Configurer une borne (/fr-FR/mobiele-app/kiosk-inrichten)

Avec une borne, vous verrouillez une tablette Android sur l'application Tillor. Les clients voient l'écran d'accueil, un diaporama ou un ticket de caisse, et n'accèdent pas aux réglages d'Android. Après une coupure de courant, la tablette redémarre dans Tillor. Cette page décrit la configuration à faire une seule fois. Les interrupteurs que vous réglez ensuite figurent dans [Paramètres de l'appareil](/mobiele-app/toestelinstellingen#kiosk).

Sans les étapes ci-dessous, vous pouvez bien activer **Verrouiller l’application**, mais Android n'utilise alors que l'épinglage d'écran. Celui-ci demande une confirmation sur la tablette et un client peut le quitter. Le statut de l'onglet **Borne** indique alors **Épinglage d'écran. Cette tablette n'est pas un kiosque configuré.**

Le verrouillage complet ne s'applique que lorsque Tillor est propriétaire de l'appareil. Dans l'onglet **Borne**, vous le lisez ainsi : **Kiosque configuré : le verrouillage est complet.**

<Callout type="warn">
Cela fonctionne sur Android. Sur iOS, vous pouvez bien utiliser l'application comme borne pour les tickets de caisse et l'écran d'accueil, mais pas la définir comme propriétaire de l'appareil. Les boutons sous **Gestion Android** restent alors fermés, avec le message **Disponible une fois cette tablette configurée comme kiosque.**
</Callout>

## Avant de commencer [#voor-je-begint]

Il vous faut un ordinateur avec `adb`. C'est un programme gratuit de Google qui permet de piloter une tablette Android via un câble USB. C'est une opération unique par tablette, destinée aux personnes un peu techniques. Si vous n'y arrivez pas, demandez au support Tillor.

Avant de commencer :

- Remettez la tablette aux réglages d'usine, ou utilisez une tablette sur laquelle aucun compte Google supplémentaire n'est encore installé. Android refuse une application comme propriétaire dès qu'un compte est déjà présent sur l'appareil.
- L'application Tillor doit être installée et connectée à votre organisation.
- Dans les réglages d'Android, activez le **Débogage USB** (Options pour les développeurs).
- Reliez la tablette à l'ordinateur avec un câble. `adb devices` doit afficher la tablette comme `device`, et non comme `unauthorized`.

## Tillor comme propriétaire de la tablette [#tillor-als-eigenaar-van-de-tablet]

Le propriétaire d'un appareil Android peut faire des choses qu'une application ordinaire ne peut pas faire, comme verrouiller réellement la tablette. Donnez ce rôle à Tillor avec cette commande sur l'ordinateur :

```bash
adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver
```

Si la commande réussit, Android répond que le propriétaire est défini. Si elle échoue avec un message au sujet de comptes, supprimez les comptes ou recommencez à partir d'une réinitialisation d'usine. Vous ne pouvez exécuter cette commande qu'une seule fois. Un autre propriétaire exige une nouvelle réinitialisation.

Ouvrez ensuite dans Tillor **Paramètres** > **Tablettes et bornes**, réglez le type sur **Borne** et enregistrez. Dans l'onglet **Borne**, la tuile **Appareil borne** doit maintenant être verte. Les deux autres tuiles suivent dès que vous avez envoyé **Application comme écran d’accueil** et **Supprimer le verrouillage de l'écran**. L'explication de ces tuiles se trouve dans [Borne](/mobiele-app/toestelinstellingen#kiosk).

## Batterie : ne pas laisser l'application s'endormir [#batterij-de-app-niet-laten-inslapen]

Android, et surtout Xiaomi avec HyperOS, coupe la connexion d'une application que le système considère comme « endormie ». La borne passe alors hors ligne en pleine nuit, même si l'écran doit être éteint pendant le repos nocturne.

Quand Tillor est propriétaire, l'application demande elle-même de désactiver l'optimisation de la batterie. Sur la plupart des tablettes, c'est une fenêtre dans laquelle vous touchez **Autoriser**. Sur Xiaomi, HyperOS ouvre à la place la page de batterie de Tillor : choisissez-y **Sans restriction**. Si vous passez cette étape, l'application la redemande après le prochain redémarrage, et la connexion reste peu fiable la nuit.

Aucune application ne peut définir elle-même cette exception, pas même en tant que propriétaire de l'appareil. Cela reste donc un geste par tablette, ou la commande ci-dessous.

Si cette fenêtre n'apparaît pas, définissez l'exception pendant la configuration depuis l'ordinateur :

```bash
adb shell dumpsys deviceidle whitelist +eu.tillor.app
```

Ensuite, l'application doit continuer à communiquer avec Tillor en arrière-plan, même écran éteint.

## Supprimer le verrouillage d'écran [#schermvergrendeling-weghalen]

Un schéma ou un code PIN sur la tablette signifie qu'après chaque redémarrage, Android attend sur l'écran de verrouillage. La borne reste alors noire jusqu'à ce que quelqu'un passe. La tuile **Verrouillage de l'écran** vous en avertit : **Un schéma ou un code PIN est défini : la tablette attend sur l'écran de verrouillage après chaque redémarrage.**

1. Ouvrez l'onglet **Borne**.
2. Sous **Gestion Android**, réglez **Supprimer le verrouillage de l'écran** sur **Activé**.
3. Choisissez **Enregistrer et envoyer**.

La tablette ne le demande pas d'elle-même. Le verrouillage disparaît la prochaine fois que quelqu'un saisit le schéma ou le code PIN, par exemple après un redémarrage. Ensuite, un redémarrage aboutit dans Tillor.

Si vous ne voulez pas attendre, supprimez vous-même le schéma dans les réglages Android de la tablette. La tuile devient **Pas de schéma ni de code PIN : un redémarrage aboutit dans Tillor.**

<Callout type="info" title="Xiaomi : boutons de navigation">
Tant que Tillor est l'écran d'accueil, HyperOS fait passer la navigation des gestes aux boutons. Tillor masque cette barre jusqu'à ce que quelqu'un touche trois fois l'écran d'accueil. Si vous choisissez **Déverrouiller temporairement** dans l'application, vous revenez à l'écran d'accueil de Xiaomi. Si vous voulez y retrouver les gestes, activez-les dans les réglages Android.
</Callout>

## Ce que vous activez ensuite [#wat-je-daarna-aanzet]

Pour une tablette dans un boîtier à la réception ou à l'entrée, voici un ensemble utilisable. Tout se trouve dans l'onglet **Borne**, sauf indication contraire.

| Réglage | Position | Pourquoi |
| --- | --- | --- |
| **Application comme écran d’accueil** | Activé | Le bouton d'accueil ouvre Tillor. L'horloge et la batterie restent visibles. |
| **Verrouiller l’application** | Activé | Les clients ne peuvent pas quitter l'application. |
| **Masquer l'interface système** | Activé | Pas de notifications, pas d'applications récentes, pas de menu d'alimentation. |
| **Verrouiller l'appareil** | Activé | Pas de réinitialisation d'usine, pas de mode sans échec, pas de transfert USB, pas de désinstallation. |
| **Rester allumé en charge** | Activé | L'écran reste allumé pendant les heures d'ouverture tant que le chargeur est branché. Le repos nocturne prend le dessus. |
| **Heure automatique** | Activé | Le repos nocturne suit l'horloge de l'organisation, pas une horloge de tablette décalée. |
| **Orientation de l'écran** | Portrait ou paysage | Dans **Écran et veille**, selon le boîtier. **Par défaut** correspond à la rotation automatique. |

**Verrouiller le volume** conserve le volume défini dans l'onglet **Tickets et son**, afin qu'un client ne puisse pas utiliser les boutons latéraux.

Enregistrez et vérifiez les trois tuiles en haut de **Borne**. Vert signifie que la tablette le signale ainsi. Un avertissement signifie que cette étape n'a pas encore réussi.

## Une nouvelle version de l'application par USB [#een-nieuwe-app-versie-over-usb]

**Verrouiller l'appareil** désactive le débogage USB et le transfert de fichiers. **Verrouiller l’application** garde la tablette dans l'application, ce qui empêche de confirmer une fenêtre d'installation.

Avant d'installer une version par câble :

1. Réglez **Verrouiller l’application** sur **Désactivé**.
2. Réglez **Verrouiller l'appareil** sur **Désactivé**.
3. Choisissez **Enregistrer et envoyer** et attendez que la tablette relâche le verrouillage.
4. Installez la nouvelle version. Sur Xiaomi, HyperOS demande sur la tablette de confirmer l'installation via USB : touchez **Installer**.
5. Remettez les deux réglages sur **Activé** et enregistrez à nouveau.

Si vous laissez **Verrouiller l'appareil** activé, `adb` ne voit plus la tablette. L'exception de batterie et le statut de propriétaire sont conservés lors d'une mise à jour ordinaire. Pas après une réinitialisation d'usine : vous recommencez alors à la commande `dpm`.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Après un redémarrage ou une coupure de courant, la tablette redémarre dans Tillor, sur l'écran d'accueil.
- Les clients ne peuvent pas quitter l'application et ne voient ni notifications ni applications récentes.
- Les trois tuiles en haut de l'onglet **Borne** affichent ce que la tablette signale elle-même. Après une modification, les tuiles peuvent mettre un moment à devenir vertes, car la tablette se manifeste toutes les 30 à 60 secondes.
- Une mise à jour ordinaire de l'application conserve le statut de propriétaire et l'exception de batterie. Pas une réinitialisation d'usine.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="La commande indique qu'il y a déjà des comptes sur l'appareil">
Android refuse un propriétaire dès qu'un compte est présent sur la tablette. Supprimez les comptes ou recommencez à partir d'une réinitialisation d'usine.
</Accordion>
<Accordion title="adb devices affiche unauthorized, ou rien">
Confirmez sur la tablette la fenêtre qui demande l'autorisation pour l'ordinateur, et vérifiez que le **Débogage USB** est activé. Si **Verrouiller l'appareil** est activé, `adb` ne voit plus la tablette : désactivez-le comme pour la mise à jour USB ci-dessus.
</Accordion>
<Accordion title="L'onglet Borne indique Épinglage d'écran. Cette tablette n'est pas un kiosque configuré.">
Tillor n'est pas encore propriétaire de la tablette, Android n'utilise donc que l'épinglage d'écran. Exécutez la commande de propriétaire, puis choisissez **Enregistrer et envoyer**.
</Accordion>
<Accordion title="Les boutons sous Gestion Android sont fermés">
Le message **Disponible une fois cette tablette configurée comme kiosque.** y figure. Configurez la tablette comme ci-dessus, ou utilisez une tablette Android : sur iOS, ce n'est pas possible.
</Accordion>
<Accordion title="La borne reste noire après un redémarrage">
Un schéma ou un code PIN est défini sur la tablette. Activez **Supprimer le verrouillage de l'écran** et saisissez une fois le schéma ou le code PIN, ou supprimez le verrouillage dans les réglages Android.
</Accordion>
<Accordion title="La borne passe hors ligne la nuit">
Android a laissé l'application s'endormir. Désactivez l'optimisation de la batterie pour Tillor, comme dans la rubrique Batterie ci-dessus.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres de l'appareil" href="/mobiele-app/toestelinstellingen#kiosk" description="Les interrupteurs de l'onglet Borne" />
  <Card title="Configurer un repos nocturne pour l'écran" href="/mobiele-app/nachtrust-instellen" description="L'écran éteint la nuit" />
  <Card title="Gérer une tablette ou une borne" href="/mobiele-app/tablets-en-kiosken" description="Envoyer des paramètres" />
</Cards>


# Configurer un repos nocturne pour l'écran (/fr-FR/mobiele-app/nachtrust-instellen)

Une tablette allumée toute la nuit consomme du courant et peut marquer l'écran. Avec un repos nocturne, l'écran s'éteint ou devient noir pendant les heures où le parc est fermé. Les autres options d'écran, comme l'atténuation, figurent dans [Paramètres de l'appareil](/mobiele-app/toestelinstellingen#scherm-en-slaap).

<Requires permission="Modifier les paramètres" />

Avant de commencer :

- Si vous voulez que l'écran s'éteigne vraiment et puisse être réveillé à distance, configurez d'abord la tablette comme borne et placez l'application dans l'exception de batterie. Voir [Configurer une borne](/mobiele-app/kiosk-inrichten).
- Si vous choisissez les heures d'ouverture de votre organisation, renseignez-les d'abord. Voir [Organisation](/gebruikers/organisaties#openingsuren).

## Configurer le repos nocturne [#de-nachtrust-instellen]

<Steps>
<Step>
### Ouvrez l'onglet Écran et veille [#open-het-tabblad-scherm-en-slaap]
Ouvrez l'appareil via <UIPath>Paramètres > Tablettes et bornes</UIPath> et cliquez sur la tuile **Écran et veille**. Cherchez le groupe **Repos nocturne**.
</Step>
<Step>
### Choisissez le Mode nuit [#kies-de-nachtstand]
<Tabs items={["Heures fixes", "Quand l'organisation est fermée"]}>
<Tab value="Heures fixes">
Choisissez **Heures fixes** et remplissez **De** et **À**. Un horaire qui passe minuit, comme 22:00 à 07:00, est autorisé.
</Tab>
<Tab value="Quand l'organisation est fermée">
L'écran suit les heures d'ouverture de votre organisation. Vous les modifiez à un seul endroit, et tous les appareils suivent.
</Tab>
</Tabs>
Avec **Désactivé**, Tillor ne planifie aucune veille.
</Step>
<Step>
### Choisissez le Mode de sommeil [#kies-de-slaapstijl]
**Voile noir** pose un voile noir sur l'image, et un toucher la réveille aussitôt. **Écran éteint** éteint réellement la dalle.
</Step>
<Step>
### Cliquez sur Enregistrer et envoyer [#klik-op-opslaan-en-versturen]
En haut à droite du groupe figure le moment de la prochaine veille.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Onglet Écran et veille, repos nocturne de 22:00 à 07:00" />

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Pendant le repos nocturne, l'écran s'éteint ou devient noir, même si **Garder l'écran allumé** est activé. Le repos nocturne prend le dessus.
- Toucher l'écran le réveille un instant.
- À la fin de l'horaire, l'écran redevient normal.
- Pendant le repos nocturne, Tillor n'envoie pas d'alerte indiquant que l'appareil est hors ligne.
- Si vous voulez réveiller ou mettre l'écran en veille en dehors de l'horaire, utilisez les [Actions à distance](/mobiele-app/acties-op-afstand).

## Un problème ? [#problemen]

<Accordions>
<Accordion title="L'écran ne se réveille pas la nuit avec Réveiller l’écran">
**Écran éteint** fonctionne pleinement sur une tablette configurée comme borne. Le réveil à distance ne fonctionne que si l'application figure aussi dans l'exception de batterie. Voir [Batterie](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
<Accordion title="La tablette s'éteint trop tôt ou trop tard">
Une horloge décalée sur la tablette décale l'horaire. Dans l'onglet **Borne**, activez **Heure automatique**, afin que la tablette suive l'horloge de l'organisation.
</Accordion>
<Accordion title="La tablette est hors ligne la nuit">
Android laisse l'application s'endormir. Désactivez l'optimisation de la batterie pour Tillor, voir [Configurer une borne](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Configurer une borne" href="/mobiele-app/kiosk-inrichten" description="Propriétaire de l'appareil et batterie" />
  <Card title="Actions à distance" href="/mobiele-app/acties-op-afstand" description="Réveiller l'écran ou le mettre en veille" />
</Cards>


# Configurer l'écran d'accueil et un diaporama (/fr-FR/mobiele-app/startscherm-en-diavoorstelling)

L'écran d'accueil est ce que voient les clients quand aucun ticket de caisse n'est affiché : un texte de bienvenue, votre logo, des boutons et éventuellement un diaporama d'affiches ou de photos du parc. C'est ici que vous le configurez. Chaque réglage avec ses limites figure dans [Paramètres de l'appareil](/mobiele-app/toestelinstellingen#startscherm).

<Requires permission="Modifier les paramètres" />

Avant de commencer :

- L'appareil figure dans <UIPath>Paramètres > Tablettes et bornes</UIPath>, voir [Gérer une tablette ou une borne](/mobiele-app/tablets-en-kiosken).
- Les photos sont des fichiers JPEG, PNG ou WebP, ou un lien `https` vers une image.

## Modifier le texte de bienvenue [#de-welkomsttekst-aanpassen]

<Steps>
<Step>
### Ouvrez l'onglet Écran d'accueil [#open-het-tabblad-startscherm]
Ouvrez l'appareil et cliquez sur la tuile **Écran d'accueil**. Les champs **Titre d'accueil** (60 caractères maximum) et **Sous-titre d'accueil** (120 maximum) se trouvent en haut.
</Step>
<Step>
### Remplissez le texte et envoyez [#vul-de-tekst-in-en-verstuur]
Laissez un champ vide si l'application peut garder son propre texte. Cliquez sur **Enregistrer et envoyer**.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Onglet Écran d'accueil, avec Apparence et Boutons mis en évidence" />

## Ajouter un diaporama [#een-diavoorstelling-toevoegen]

<Steps>
<Step>
### Ouvrez l'onglet Diaporama et boutons [#open-het-tabblad-diavoorstelling-en-knoppen]
Cliquez sur cette tuile. Sous **Affichage**, vous choisissez comment les photos apparaissent.
</Step>
<Step>
### Choisissez l'affichage [#kies-de-weergave]
<Tabs items={["En arrière-plan", "Plein écran en cas d’inactivité"]}>
<Tab value="En arrière-plan">
Les photos défilent derrière le logo et les boutons, à la place de l'arrière-plan de votre organisation. Les clients peuvent alors toucher les boutons en même temps.
</Tab>
<Tab value="Plein écran en cas d’inactivité">
Les photos prennent tout l'écran dès que personne ne le touche. Un toucher ramène l'écran d'accueil. La durée d'attente se règle sous **Démarrer après**.
</Tab>
</Tabs>
</Step>
<Step>
### Ajoutez des photos [#voeg-fotos-toe]
Cliquez sur **Téléverser une photo**, ou collez une adresse `https` via **Ajouter un lien**. Vous pouvez ajouter jusqu'à 20 photos. Pour une photo, vous pouvez ajouter une légende de 80 caractères maximum.
</Step>
<Step>
### Réglez la durée [#stel-de-timing-in]
**Durée par photo** va de 3 à 600 secondes. **Démarrer après** va de 10 à 3600 secondes. Sous **Ajustement**, choisissez **Remplir l’écran** (les bords sont rognés) ou **Afficher la photo entière** (avec des bandes noires).
</Step>
<Step>
### Cliquez sur Enregistrer et envoyer [#klik-op-opslaan-en-versturen]
La tablette affiche le diaporama dès qu'elle a reçu les réglages.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Onglet Diaporama et boutons, avec l'affichage et deux boutons supplémentaires" />

## Ajouter des boutons supplémentaires [#extra-knoppen-toevoegen]

Les boutons supplémentaires sont des raccourcis sur l'écran d'accueil, par exemple vers un plan ou le réseau des clients. Vous pouvez en avoir six.

<Steps>
<Step>
### Cliquez sur Ajouter un bouton [#klik-op-knop-toevoegen]
Une ligne vide apparaît.
</Step>
<Step>
### Remplissez le bouton [#vul-de-knop-in]
Indiquez un texte, une courte description et une adresse web (uniquement `https`). Choisissez une icône dans la rangée et, sous **Affichage**, si le bouton est toujours visible ou seulement après un appui.
</Step>
<Step>
### Cliquez sur Enregistrer et envoyer [#klik-op-opslaan-en-versturen-1]
</Step>
</Steps>

L'icône de corbeille supprime un bouton. **Laisser l'appareil décider** supprime la liste de Tillor, afin que la tablette utilise ses propres boutons.

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- La tablette adapte l'écran d'accueil dès que les réglages arrivent. Une tablette hors ligne le fait dès qu'elle est de nouveau connectée.
- Si vous avez réglé **Bouton prépayé** ou **Bouton réglages** sur **Après un appui**, le bouton disparaît après le nombre de secondes indiqué sous **Masquer après**.
- Un ticket de caisse, un document ou une demande de signature que Tillor envoie à la tablette s'affiche par-dessus l'écran d'accueil, puis disparaît.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le téléversement d'une photo ne fonctionne pas et Tillor indique Échec du téléversement">
Le fichier n'est pas un JPEG, un PNG ou un WebP, ou le téléversement a été interrompu. Essayez une autre photo, ou utilisez **Ajouter un lien** avec l'adresse de l'image.
</Accordion>
<Accordion title="Je ne peux pas ajouter de photos">
Les boutons n'apparaissent que si **Affichage** n'est pas sur **Désactivé**. Si la liste atteint 20 photos, supprimez-en d'abord une avec **Supprimer la photo**.
</Accordion>
<Accordion title="Le diaporama ne démarre pas">
Avec **Plein écran en cas d’inactivité**, il ne démarre qu'après le nombre de secondes indiqué sous **Démarrer après** sans toucher. La valeur par défaut d'un nouveau diaporama est de 60 secondes. Vérifiez aussi que la tablette a déjà reçu les nouveaux réglages.
</Accordion>
<Accordion title="Mon bouton n'ouvre rien">
L'adresse doit commencer par `https`. Vérifiez que le lien fonctionne dans un navigateur.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Paramètres de l'appareil" href="/mobiele-app/toestelinstellingen" description="Tous les réglages et leurs limites" />
  <Card title="Gérer une tablette ou une borne" href="/mobiele-app/tablets-en-kiosken" description="Envoyer des paramètres" />
</Cards>


# Gérer une tablette ou une borne (/fr-FR/mobiele-app/tablets-en-kiosken)

Chaque tablette, borne ou téléphone sur lequel quelqu'un ouvre l'application Tillor et choisit une organisation apparaît dans Tillor. À partir de là, vous voyez si l'appareil est encore connecté et vous lui envoyez l'écran d'accueil, le son et le verrouillage en mode borne. Ce que vous pouvez régler figure par onglet sous [Réglages de l'appareil](/mobiele-app/toestelinstellingen).

<Requires permission="Instellingen bewerken" />

Avant de commencer :

- L'appareil doit avoir l'application Tillor et quelqu'un doit être connecté à votre organisation. Sinon, vous voyez **Aucun appareil pour l'instant**.
- L'envoi de réglages n'est possible qu'avec l'autorisation **Modifier les paramètres**.

## Envoyer des réglages à un appareil [#instellingen-naar-een-toestel-sturen]

<Steps>
<Step>
### Ouvrez la liste [#open-de-lijst]
Allez dans <UIPath>Paramètres > Tablettes et bornes</UIPath>. Chaque ligne correspond à une installation de l'application. Vous voyez le nom, le type (**Tablette**, **Borne** ou **Téléphone**), le modèle, la version de l'application, le pourcentage de batterie et l'état de connexion de l'appareil. **Dernière connexion** signifie que l'application n'a rien signalé depuis un moment.

<DocScreenshot src="/screenshots/tablets/devices-list.png" alt="Paramètres > Tablettes et bornes avec la borne Borne libre-service" />
</Step>
<Step>
### Ouvrez l'appareil [#open-het-toestel]
Cliquez sur la ligne de l'appareil. En haut figurent le nom et le statut. En dessous se trouvent un champ de recherche et une rangée de tuiles, une par onglet.

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Page de l'appareil Borne libre-service avec les tuiles d'onglets et la barre d'enregistrement" />

Une tuile indique combien de réglages viennent de Tillor. **Tout reste sur l'appareil** signifie que vous n'avez encore rien fixé sur cet onglet. À droite, le panneau **Actions à distance** reste affiché, voir [Actions à distance](/mobiele-app/acties-op-afstand).
</Step>
<Step>
### Modifiez les réglages [#pas-de-instellingen-aan]
Choisissez un onglet et modifiez ce que vous voulez. Presque chaque interrupteur a trois positions : **Appareil**, **Activé** et **Désactivé**. **Appareil** conserve le choix fait sur la tablette elle-même. **Activé** et **Désactivé** remplacent ce choix dès que vous enregistrez. Sous la description figure ce que l'application fait quand personne n'a rien choisi, par exemple **Par défaut : Activé**.
</Step>
<Step>
### Cliquez sur Enregistrer et envoyer [#klik-op-opslaan-en-versturen]
Rien n'est envoyé à l'appareil tant que vous ne cliquez pas ici. Tant qu'une modification est en attente, la barre affiche **Modifications non envoyées** et l'onglet porte un point vert. **Annuler les modifications** remet le formulaire dans l'état actuel de l'appareil.

Avant et après une modification que vous n'avez pas encore envoyée :

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Avant : page de l'appareil sans modification" />

<DocScreenshot src="/screenshots/tablets/device-page-unsaved.png" alt="Après : un réglage modifié avec Modifications non envoyées et un point vert sur l'onglet" />
</Step>
</Steps>

## La même chose pour tous les appareils [#hetzelfde-voor-alle-toestellen]

Si vous avez plusieurs appareils du même type, inutile de les régler un par un.

<Tabs items={["Un appareil", "Tous les appareils de ce type"]}>
<Tab value="Un appareil">
Cliquez sur **Enregistrer et envoyer**. Seul cet appareil reçoit les réglages.
</Tab>
<Tab value="Tous les appareils de ce type">
Cliquez sur **Appliquer à toutes les bornes** (ou **tablettes**, ou **téléphones**, selon le type). Tillor copie les réglages de cet appareil vers les autres appareils du même type et les envoie aussitôt, avec le message **Réglages copiés sur les autres appareils**. Le nom, le type et les alertes restent propres à chaque appareil. La langue, elle, est copiée.
</Tab>
</Tabs>

## Rechercher dans tous les onglets [#zoeken-over-alle-tabbladen]

Vous ne savez pas sur quel onglet se trouve un réglage ? Le champ **Rechercher des réglages** fouille tous les onglets à la fois. Les tuiles restent affichées, mais en dessous apparaît une liste de résultats, regroupés par onglet.

<DocScreenshot src="/screenshots/tablets/device-search.png" alt="Recherche de luminosité, avec les résultats de Écran et veille" />

Une recherche comme `luminosité` affiche les lignes de luminosité de **Écran et veille**, puis les autres onglets qui contiennent aussi ce mot. **Ouvrir l'onglet** ferme la recherche et ouvre cet onglet, pour que vous voyiez aussi le reste du groupe. Si vous ne trouvez rien, **Aucun réglage ne correspond à** votre recherche s'affiche.

## Oublier un appareil [#een-toestel-vergeten]

Le menu à trois points en haut à droite de la page de l'appareil contient **Oublier l'appareil**. Utilisez-le pour une tablette qui n'est plus utilisée.

<DocScreenshot src="/screenshots/tablets/device-menu.png" alt="Menu avec Oublier l'appareil" />

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Tillor indique **Réglages envoyés**. La tablette les applique aussitôt si elle est connectée. Si elle est hors ligne, elle les reçoit dès qu'elle contacte à nouveau Tillor. L'application se signale toutes les 30 à 60 secondes.
- Sur la page de l'appareil et dans la liste, vous voyez si l'appareil est connecté. L'appareil renvoie aussi la batterie, la version de l'application et la connexion, voir [Diagnostic et historique](/mobiele-app/diagnose-en-geschiedenis).
- Chaque modification est ajoutée à l'historique de l'appareil et au [journal d'activité](/activiteitenlog) de votre organisation.
- Un appareil oublié disparaît de la liste et les réglages envoyés disparaissent avec lui. Si l'application tourne encore dessus et que quelqu'un est connecté, il revient en moins d'une minute, sans ces réglages. Vous devez alors les refaire.
- Si vous activez **Alertes** sur l'onglet **Appareil**, les personnes qui gèrent les réglages reçoivent un message lorsque l'appareil est hors ligne depuis 10 minutes ou que la batterie passe sous 15 % sans chargeur.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Je vois Aucun appareil pour l'instant">
Aucune tablette ne s'est encore signalée. Ouvrez l'application Tillor sur la tablette, connectez-vous et choisissez la bonne organisation. L'appareil apparaît en moins d'une minute.
</Accordion>
<Accordion title="Tillor affiche Impossible d'enregistrer les réglages">
L'enregistrement a échoué, souvent à cause d'une connexion instable ou parce qu'il vous manque l'autorisation **Modifier les paramètres**. Réessayez. Si cela ne fonctionne toujours pas, demandez l'autorisation à votre administrateur.
</Accordion>
<Accordion title="Tillor affiche Impossible de copier les réglages">
**Appliquer à toutes les bornes** a échoué. Cliquez à nouveau. Si cela ne marche pas, enregistrez l'appareil avec **Enregistrer et envoyer** et ouvrez les autres appareils un par un.
</Accordion>
<Accordion title="La tablette ne tient pas compte de ma modification">
Vérifiez que l'appareil est **Connecté**. S'il est hors ligne, il applique les réglages dès qu'il contacte à nouveau Tillor. Si l'interrupteur est sur **Appareil**, c'est la tablette qui décide. Choisissez **Activé** ou **Désactivé** pour lui imposer votre choix.
</Accordion>
<Accordion title="L'appareil est revenu après Oublier l'appareil">
L'application tourne encore et quelqu'un est connecté, donc il se signale à nouveau. Déconnectez-vous sur la tablette si vous voulez vraiment vous en défaire. Sous **Compte** > **Sessions actives**, vous pouvez mettre fin à la session de l'application.
</Accordion>
<Accordion title="Tillor affiche Utilisez 4 à 6 chiffres">
Le **Code des réglages** sur l'onglet **Écran d'accueil** doit comporter 4 à 6 chiffres, ou être vide. Ce n'est qu'ensuite que vous pouvez enregistrer.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Réglages de l'appareil" href="/mobiele-app/toestelinstellingen" description="Ce que contient chaque onglet" />
  <Card title="Configurer une borne" href="/mobiele-app/kiosk-inrichten" description="Verrouiller une tablette Android pour que les clients ne puissent pas en sortir" />
  <Card title="Actions à distance" href="/mobiele-app/acties-op-afstand" description="Réveiller l'écran, redémarrer et faire une capture d'écran" />
</Cards>


# Réglages de l'appareil (/fr-FR/mobiele-app/toestelinstellingen)

Vous trouvez ici tous les réglages d'un appareil, onglet par onglet, avec leur valeur par défaut et leurs limites. Il y en a six, chacun représenté par une tuile au-dessus des formulaires. Pour savoir comment y accéder, comment fonctionne la recherche et quand un réglage part vers l'appareil, voir [Gérer une tablette ou une borne](/mobiele-app/tablets-en-kiosken). L'écran d'accueil est détaillé pas à pas dans [Configurer l'écran d'accueil et un diaporama](/mobiele-app/startscherm-en-diavoorstelling) et le repos nocturne dans [Configurer un repos nocturne pour l'écran](/mobiele-app/nachtrust-instellen).

Chaque ligne a une icône, une courte explication et, là où c'est utile, la valeur par défaut de l'application. Choisissez **Appareil** (ou laissez un nombre vide sur **Par défaut**) pour que la tablette garde son propre choix. **Activé** et **Désactivé** remplacent ce choix.

Les lignes qui ne fonctionnent que sur une borne configurée affichent un avertissement tant que la tablette ne l'est pas : **Disponible une fois cette tablette configurée comme kiosque.** Ces étapes figurent dans [Configurer une borne](/mobiele-app/kiosk-inrichten).

## Écran d'accueil [#startscherm]

Texte de bienvenue, arrière-plan et boutons que voient les clients quand aucun ticket n'est affiché à l'écran.

### Texte de bienvenue [#welkomsttekst]

**Titre d'accueil** (60 caractères maximum) et **Sous-titre d'accueil** (120 maximum) figurent en haut de l'écran d'accueil. Laissez un champ vide si l'application peut garder son propre texte.

### Apparence [#uiterlijk]

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Onglet Écran d'accueil, avec Apparence et Boutons repérés" />

**Apparence** (repère **1**) :

- **Photo d'arrière-plan** affiche l'arrière-plan de l'organisation derrière le logo. Activée par défaut.
- **Assombrissement de l'arrière-plan** est un pourcentage de 0 à 90. 45 par défaut, pour que le logo et les boutons restent lisibles sur une photo claire.
- **Style du logo** est **Silhouette blanche** (par défaut) ou **En couleur sur une carte**.

### Boutons [#knoppen]

**Boutons** (repère **2**) :

- **Bouton prépayé** ouvre le solde, la recharge et le paiement avec une carte NFC. Activé par défaut.
- **Bouton réglages** affiche un bouton vers les réglages sur l'appareil lui-même. S'il est désactivé, vous y accédez en touchant trois fois l'écran d'accueil.
- **Affichage** est **Toujours** ou **Après un appui**. Avec **Après un appui**, vous renseignez **Masquer après**, en secondes. Ensuite le bouton disparaît jusqu'à ce que quelqu'un touche l'écran.
- **Code des réglages** compte 4 à 6 chiffres. L'appareil demande ce code avant d'ouvrir ses propres réglages. Vide signifie pas de code. Une valeur autre que 4 à 6 chiffres ne peut pas être enregistrée.

## Diaporama et boutons [#diavoorstelling-en-knoppen]

Les photos que l'écran d'accueil fait défiler, et des boutons supplémentaires vers une page web.

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Onglet Diaporama et boutons, avec l'affichage et deux boutons supplémentaires" />

### Diaporama [#diavoorstelling]

**Affichage** (repère **1**) a trois positions :

- **Désactivé** n'affiche aucune photo.
- **En arrière-plan** fait défiler les photos derrière le logo et les boutons, à la place de l'arrière-plan de l'organisation.
- **Plein écran en cas d'inactivité** prend tout l'écran dès que plus personne ne le touche.

Dès que l'affichage n'est plus sur **Désactivé**, vous pouvez ajouter jusqu'à 20 photos. **Téléverser une photo** accepte JPEG, PNG ou WebP. **Ajouter un lien** colle une adresse `https` d'une image. Vous pouvez saisir une légende de 80 caractères maximum par photo.

- **Durée par photo** est le temps pendant lequel chaque photo reste affichée, de 3 à 600 secondes. Un nouveau diaporama commence à 10.
- **Démarrer après** ne vaut que pour le plein écran : secondes sans contact avant le début du diaporama, de 10 à 3600. Un nouveau diaporama commence à 60.
- **Ajustement** : **Remplir l'écran** rogne les bords, **Afficher la photo entière** conserve toute la photo avec des bandes noires. Un nouveau diaporama commence sur **Afficher la photo entière**.

Un contact sur un diaporama en plein écran ramène l'écran d'accueil.

### Boutons supplémentaires [#extra-knoppen]

**Boutons supplémentaires** (repère **2**) sont des raccourcis sur l'écran d'accueil, par exemple un plan ou le réseau des clients. Vous pouvez en avoir six.

Pour chaque bouton, vous saisissez le texte du bouton, une courte description, l'adresse web et une icône. Vous choisissez l'icône dans la rangée : plan, site web, information, calendrier, restauration, wifi, téléphone ou tickets. **Affichage** fonctionne comme pour le bouton prépayé : toujours, ou seulement après un appui puis masqué à nouveau.

**Ajouter un bouton** crée une ligne vide. L'icône de corbeille supprime ce bouton. **Laisser l'appareil décider** supprime la liste venant de Tillor, de sorte que la tablette utilise ses propres boutons. Tant que vous n'avez enregistré aucun bouton, cette phrase s'affiche aussi : aucun bouton n'est défini depuis Tillor.

## Écran et veille [#scherm-en-slaap]

Luminosité, orientation, couleurs et moment où l'écran s'éteint la nuit.

### Luminosité [#helderheid]

Si vous cherchez un réglage, essayez `luminosité` dans le champ de recherche, voir [Rechercher dans tous les onglets](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen).

- **Mode borne** garde l'écran allumé, avec tickets, signatures et réglage de la luminosité. Activé par défaut sur une tablette ou une borne, désactivé sur un téléphone.
- **Garder l'écran allumé** empêche l'écran de se mettre en veille. Activé par défaut, désactivé sur un téléphone.
- **Atténuer en cas d'inactivité** passe à pleine luminosité au moindre contact puis atténue ensuite. Activé par défaut, désactivé sur un téléphone.
- **Atténuer après** est le nombre de secondes sans contact, de 5 à 3600. 15 par défaut.
- **Luminosité atténuée** est le pourcentage dans cet état atténué, de 0 à 100. 0,5 % par défaut.

Le repos nocturne ci-dessous l'emporte sur **Garder l'écran allumé** : pendant les heures de veille, l'écran s'éteint ou devient noir malgré tout.

### Affichage [#weergave]

- **Orientation de l'écran** est **Rotation automatique** (par défaut), **Portrait** ou **Paysage**. Fixez une borne dans son boîtier, sinon l'image tourne dès que quelqu'un incline la tablette.
- **Affichage** est **Suivre l'appareil**, **Clair** ou **Sombre**.

### Repos nocturne [#nachtrust]

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Onglet Écran et veille, repos nocturne de 22:00 à 07:00" />

**Mode nuit** (repère **1**) a trois positions :

- **Désactivé** ne planifie aucune veille.
- **Heures fixes** utilise **De** et **À**. Un horaire qui passe minuit, comme 22:00 à 07:00, est autorisé. L'écran s'éteint pendant cette plage, même s'il doit rester allumé le reste de la journée. Un contact le réveille brièvement.
- **Quand l'organisation est fermée** suit les heures d'ouverture de l'organisation.

En haut à droite du groupe figure le moment de la prochaine veille.

**Mode de sommeil** :

- **Voile noir** pose un voile noir sur l'image. L'écran reste tactile, donc un appui le réveille aussitôt.
- **Écran éteint** éteint réellement la dalle. Elle se réveille à la fin de l'horaire, ou via **Réveiller l'écran** dans [Actions à distance](/mobiele-app/acties-op-afstand). Cela fonctionne pleinement sur une tablette configurée comme borne. Le réveil à distance ne marche que si l'application figure aussi dans l'exception de batterie, voir [Batterie](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).

## Tickets et son [#kassabonnen-en-geluid]

Ce que fait la tablette quand Tillor envoie un document, et quels sons elle joue.

<DocScreenshot src="/screenshots/tablets/tab-sound.png" alt="Onglet Tickets et son" />

### Tickets et documents [#kassabonnen-en-documenten]

Repère **1** :

- **Afficher les tickets et documents** affiche les PDF, images et demandes de signature sur cet appareil. Activé par défaut, désactivé sur un téléphone. Désactivez-le sur une tablette qui ne doit être qu'un écran d'accueil et ne doit pas afficher de tickets.
- **Effacer après** est le nombre de secondes pendant lesquelles un ticket reste affiché avant que l'appareil le retire lui-même, de 5 à 900. Laissez vide pour attendre que Tillor efface l'écran.

### Son [#geluid]

Repère **2**. Tout ce qui suit est activé par défaut, volume à 100 %.

- **Son au démarrage** est joué quand l'application démarre ou redémarre.
- **Son pour les tickets et documents** est joué quand un ticket, une image ou une demande de signature arrive.
- **Son pour les paiements en ligne** est joué quand une facture est payée en ligne, ou par virement automatique.
- **Son de batterie faible** joue un avertissement quand la batterie est presque vide et que le chargeur n'est pas branché.
- **Volume sonore** va de 0 à 100. Sur une borne, vous pouvez le figer avec **Verrouiller le volume** sur l'onglet **Borne**.

**Lire un son de test** se trouve dans [Actions à distance](/mobiele-app/acties-op-afstand), pas sur cet onglet.

## Borne [#kiosk]

Utile seulement sur Android. La configuration (propriétaire de l'appareil, batterie, USB) figure dans [Configurer une borne](/mobiele-app/kiosk-inrichten). Cet onglet est l'endroit où vous réglez ensuite les interrupteurs.

<DocScreenshot src="/screenshots/tablets/tab-kiosk.png" alt="Onglet Borne avec les tuiles de statut et le verrouillage" />

### Statut [#status]

Trois tuiles (repère **1**) montrent ce que la tablette a indiqué lors de son dernier signalement. Ce ne sont pas des réglages.

- **Appareil borne** est vert avec **Kiosque configuré : le verrouillage est complet.** Un avertissement signifie épinglage de l'écran (l'application n'est pas propriétaire) ou que l'application n'est pas du tout verrouillée. Un tiret signifie que cette version de l'application ne transmet pas encore le statut.
- **Écran d'accueil** est vert quand Tillor est l'écran d'accueil. Sinon, il est indiqué que Tillor ne l'est pas encore, ou que l'application ne l'a pas encore signalé.
- **Verrouillage de l'écran** avertit si un schéma ou un code PIN est défini sur la tablette. Après un redémarrage, l'appareil reste alors bloqué sur l'écran de verrouillage. Vert signifie qu'un redémarrage aboutit dans Tillor.

### Verrouillage [#vergrendeling]

Repère **2**. Ces trois réglages sont désactivés par défaut, jusqu'à ce que vous les activiez.

- **Application comme écran d'accueil** fait de Tillor l'écran d'accueil. L'horloge et la batterie restent visibles. Android uniquement, et uniquement avec une version de l'application qui le permet.
- **Verrouiller l'application** garde la tablette dans l'application Tillor. Sur une borne configurée, un client ne peut pas en sortir. Sans cette configuration, Android se rabat sur l'épinglage de l'écran : quelqu'un doit le confirmer sur la tablette, et on peut le quitter.
- **Masquer l'interface système** retire les notifications, les applications récentes et le menu d'alimentation. L'horloge et la batterie restent. Cela ne fonctionne que si la tablette est configurée comme borne.

### Gestion Android [#android-beheer]

<DocScreenshot src="/screenshots/tablets/tab-kiosk-android.png" alt="Gestion Android sur l'onglet Borne" />

Tout dans ce groupe (repère **1**) ne vaut que pour une borne configurée. Sur un autre appareil, vous voyez l'avertissement à chaque ligne et les boutons sont désactivés. Par défaut, les interrupteurs sont désactivés. Les deux nombres sont vides : la tablette garde alors sa propre luminosité et sa propre mise en veille.

- **Verrouiller l'appareil** bloque la réinitialisation d'usine, le mode sans échec, les nouveaux utilisateurs, le transfert USB, la désinstallation et l'arrêt forcé. Désactivez-le avant d'installer une mise à jour par USB.
- **Supprimer le verrouillage de l'écran** retire le schéma ou le code PIN. Cela prend effet dès que ce schéma ou ce code PIN a été saisi une dernière fois.
- **Rester allumé en charge** garde l'écran allumé pendant les heures d'ouverture tant que le chargeur est branché. Le repos nocturne l'éteint malgré tout.
- **Verrouiller le volume** fige le volume défini dans **Son**.
- **Mises à jour pendant le sommeil** installe les mises à jour système pendant que l'écran dort, et les reporte tant que la tablette est utilisée.
- **Heure automatique** impose la date, l'heure et le fuseau horaire automatiques, pour que la veille suive les heures d'ouverture.
- **Luminosité de l'écran** est une luminosité fixe de la tablette elle-même, de 1 à 100, avec la luminosité automatique désactivée. Laisser vide conserve le réglage de la tablette.
- **Mise en veille de l'écran** est le nombre de secondes (15 à 3600) après lequel Android éteint l'écran si l'application ne le maintient pas allumé. Laisser vide conserve le réglage de la tablette.

## Appareil [#toestel]

Nom, type, langue et alertes. **Appliquer à toutes les bornes** copie la langue vers les autres appareils du même type, et laisse le nom, le type et les alertes en place.

<DocScreenshot src="/screenshots/tablets/tab-general.png" alt="Onglet Appareil avec nom, type, langue et alertes" />

Repère **1** :

- **Nom** est ce que vous voyez dans la liste et sur l'appareil, par exemple `Zelfbedieningskiosk`. 80 caractères maximum.
- **Type** est **Tablette**, **Borne** ou **Téléphone**. Le type détermine le texte de **Appliquer à toutes les …** et quelques valeurs par défaut : sur un téléphone, le mode borne, les tickets, le maintien de l'écran allumé et l'atténuation démarrent désactivés.
- **Langue** est la seule liste qui se replie, car il y a plus d'options que ce qui tient sur une rangée de boutons. **Par défaut** suit la langue de la tablette. Sinon, vous choisissez une langue de l'application Tillor. Les noms sont écrits dans leur propre langue.
- **Alertes** préviennent les personnes qui gèrent les réglages quand cet appareil est hors ligne depuis 10 minutes, ou quand la batterie passe sous 15 % sans chargeur. Pendant le repos nocturne, il n'y a pas d'alerte de mise hors ligne. Désactivées par défaut.

<Callout type="info">
La langue indiquée ici est celle de l'application sur la tablette. La langue du système Android apparaît dans **Diagnostic**, sous **Langue de l’appareil**.
</Callout>


# Automatisations (/fr-FR/ontwikkelaars/automatiseringen)

Les automatisations permettent à Tillor d'exécuter lui-même des actions, comme créer des tâches ou appeler votre système. Le mode d'emploi pour les utilisateurs se trouve dans [Automatisations](/automatiseringen). Cette page décrit ce que voit un intégrateur : le message de l'étape **Envoyer un webhook**, la **Requête API** vers une URL personnalisée ou vers l'API Tillor, et la structure d'un flux lorsque vous le gérez via l'API.

## Envoyer un webhook [#webhook-versturen]

L'étape **Envoyer un webhook** livre un message personnalisé à l'un des [webhooks](/ontwikkelaars/webhooks) de l'organisation. C'est la même livraison que pour les événements de webhook ordinaires, avec la même signature.

### Le message [#het-bericht]

L'étape effectue un `POST` avec `Content-Type: application/json` et ces en-têtes :

| En-tête | Contenu |
|---|---|
| `X-Webhook-Event-ID` | Un identifiant unique pour cette livraison. En cas de nouvelles tentatives, la valeur reste identique, vous pouvez donc dédoublonner dessus |
| `X-Webhook-Signature` | `sha256=<hex>`, le HMAC-SHA256 du corps avec le secret de signature du webhook |

Le corps a la même enveloppe que la charge utile d'un webhook :

```json
{
  "event": "automation.invoice_unpaid",
  "data": {
    "invoice": "2026-0042",
    "amountOutstanding": 125.5
  },
  "timestamp": 1735689600000,
  "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d",
  "triggeredBy": null
}
```

| Champ | Description |
|---|---|
| `event` | Le **Nom de l'événement** que vous avez saisi dans l'étape. N'importe quel texte est autorisé, le nom n'a pas besoin de figurer dans la liste des clés d'événement |
| `data` | La **Charge utile** de l'étape, une fois les variables remplacées, au format JSON |
| `timestamp` | Heure Unix en millisecondes de la livraison |
| `traceId` | Un UUID aléatoire par livraison. Contrairement aux événements du système, ce n'est pas l'identifiant de trace d'une action Tillor |
| `triggeredBy` | Toujours `null` |

Il n'y a pas de `spanId`. Le webhook n'a pas besoin d'être abonné à une clé d'événement : un message issu d'une automatisation est toujours livré au endpoint choisi, tant qu'il existe et qu'il est activé.

La vérification de la signature est décrite dans [Vérifier la signature](/ontwikkelaars/webhooks#handtekening-verifiëren).

### Tentatives et résultat [#pogingen-en-uitkomst]

Tillor effectue jusqu'à 5 tentatives dans l'étape, avec 1, 2, 4 et 8 secondes d'attente entre elles. Une tentative est réussie avec un statut 2xx. Une cible bloquée, par exemple une adresse interne, compte aussi comme tentative échouée.

- Si l'une des tentatives réussit, le flux continue par la sortie **Réussi**
- Si les cinq échouent, le flux continue par **Échec**. Le message est ensuite encore réessayé en arrière-plan selon le calendrier décrit dans [Comportement de livraison et nouvelles tentatives](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Si une tentative ultérieure réussit, cela ne se reflète plus dans l'exécution, car celle-ci a déjà continué

Si le webhook n'existe plus ou est désactivé, l'étape ne passe pas par **Échec**. L'exécution s'arrête alors avec le statut **Échec**.

## Requête API vers une URL personnalisée [#api-verzoek-naar-een-eigen-url]

Avec **Requête API** et **Envoyer à** sur **URL personnalisée**, une automatisation envoie une requête HTTP vers votre serveur.

| Élément | Comportement |
|---|---|
| Méthode | `GET`, `POST`, `PUT`, `PATCH` ou `DELETE` |
| URL | Doit commencer par `https://`. Les variables sont insérées encodées |
| Corps | JSON. Non envoyé pour `GET` et `DELETE`. Avec un corps, Tillor définit `Content-Type: application/json` |
| En-têtes | Libres. Les valeurs peuvent contenir des variables. `Host`, `Content-Length`, `Transfer-Encoding` et `Connection` sont ignorés |
| Cible | Les adresses privées et internes sont refusées, même si un nom de domaine ordinaire y renvoie |
| Redirections | Non suivies. Une réponse 3xx compte comme un échec |
| Délai d'expiration | 15 secondes |

<Callout type="warn" title="Pas de signature">
Contrairement à **Envoyer un webhook**, Tillor ne signe pas cette requête. Si vous voulez vérifier qu'une requête provient de votre automatisation, placez un secret dans un en-tête et contrôlez-le de votre côté. Les en-têtes sont stockés chiffrés, une clé ou un jeton qui s'y trouve est donc en sécurité.
</Callout>

Une réponse avec un statut 2xx continue par **Réussi**, tout autre statut par **Échec**. Si le serveur est injoignable ou dépasse le délai d'expiration, l'exécution s'arrête avec le statut **Échec**.

## Requête API vers l'API Tillor [#api-verzoek-naar-de-tillor-api]

Avec **Envoyer à** sur **Tillor API**, l'automatisation appelle l'API de sa propre organisation. Vous indiquez seulement un chemin, par exemple `/tasks`, et Tillor le place derrière `/api/orgs/{orgId}`. Votre référence d'API se trouve sur [OpenAPI](https://tillor.eu/api/openapi.json).

- **Identité** : la requête est exécutée en tant qu'utilisateur Workflow de l'organisation. Celui-ci a toutes les permissions au sein de cette organisation et nulle part ailleurs. Les modifications sont donc enregistrées au nom de **Flux de travail**
- **Pas de clé nécessaire** : Tillor effectue l'appel lui-même, sans clé API et sans passer par Internet
- **Chemin** : doit commencer par un seul `/`. `//`, `..` et `\` ne sont pas autorisés. Une chaîne de requête est permise, par exemple `/tasks?terrainId=…&limit=1`. Les variables dans le chemin sont insérées encodées
- **Bloqué** : les chemins `/automations` et `/automation-runs` sont refusés, même avec une chaîne de requête, des majuscules, un `/` final ou un codage en pourcentage. Une automatisation ne peut pas gérer des automatisations
- **Corps** : JSON, pour `POST`, `PUT` et `PATCH`. Pour `GET` et `DELETE`, il n'est pas envoyé
- **Menu de choix** : dans l'éditeur figure **Choisissez un endpoint API** avec les opérations de la spécification OpenAPI. Les opérations internes n'y figurent pas. Si vous en choisissez une, Tillor remplit la méthode, le chemin et un exemple de corps
- **Échec** : une réponse 2xx continue par **Réussi**. Un statut d'erreur, y compris un 404 pour un chemin inexistant, passe par **Échec**

### La réponse dans les étapes suivantes [#het-antwoord-in-latere-stappen]

Après la requête, ces variables sont disponibles :

| Variable | Contenu |
|---|---|
| `{response.status}` | Le code de statut HTTP |
| `{response.body}` | Les 4000 premiers caractères de la réponse sous forme de texte |
| `{response.data}` | La réponse au format JSON. `null` si ce n'est pas du JSON, ou si elle dépasse 100 000 caractères. Vous adressez les listes par un index, par exemple `{response.data.items.0.id}` |

Une deuxième requête API dans le même flux remplace `response`. Les variables fonctionnent comme dans [Variables et modèles](/automatiseringen/variabelen).

## La structure d'un flux [#de-opbouw-van-een-flow]

Vous pouvez aussi créer et modifier des automatisations via l'API. Les opérations figurent dans [OpenAPI](https://tillor.eu/api/openapi.json) sous le tag `automations`. La lecture requiert la permission `automations:read`, la création et la modification `automations:write` (ou toutes les permissions). L'utilisateur Workflow lui-même ne peut jamais les appeler. Il peut être plus pratique de construire un flux dans l'éditeur et de le lire comme exemple.

Une nouvelle automatisation est toujours désactivée. L'activer via `enabled` échoue tant que le flux a des problèmes ouverts, et vous ne pouvez pas enregistrer un flux activé qui a des problèmes.

La `definition` se compose d'étapes (`nodes`), de liens (`edges`) et, en option, de remarques (`notes`). Maximum 100 étapes, 200 liens et 50 remarques.

```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
    }
  ]
}
```

Une remarque (`notes`) est une explication sur le canevas. Elle n'est jamais exécutée et n'a pas de liens. `text` fait 2000 caractères maximum, `width` et `height` sont en pixels.

Un lien a un `sourceHandle` : la sortie de l'étape dont il part.

| Étape (`type`) | Sorties (`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` de chaque branche, plus `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` |

Toute action sauf `webhookSend` et `httpRequest` reçoit une sortie supplémentaire `error` dès que `continueOnError` est à `true` dans la `config`. Sans ce réglage, une action échouée arrête l'exécution. Avec ce réglage, le flux continue par `error`, avec `{error.message}` et `{error.step}` comme variables pour les étapes suivantes. La sortie `skipped` est utilisée lorsqu'une étape n'avait rien à faire, et `out` est alors la sortie ordinaire.

Pour `forEach`, la sortie `each` démarre une exécution propre par élément pour les étapes suivantes, et la sortie `done` est la suite ordinaire du flux lui-même.

Une sortie peut mener à plusieurs étapes. L'exécution continue elle-même avec le premier lien et démarre pour chaque autre lien une exécution propre avec les mêmes données, qui tourne en parallèle (comme la sortie `each` de `forEach`). Les liens qui forment une boucle sont refusés dans l'éditeur. Un flux a exactement un `trigger`.

### Réglages par étape [#instellingen-per-stap]

Les champs sous `config` sont les champs de l'éditeur. Les champs de texte acceptent des variables entre accolades.

| Étape | Champs dans `config` |
|---|---|
| `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` ou `cron`), `webhookVersion` (pour `webhook` : texte, à incrémenter pour remplacer l'adresse), `eventKey`, `date` (pour `dateReached` : un chemin `record.veld` vers une colonne `DateTime` d'un modèle dont un événement envoie l'intégralité, comme `reservation.checkIn` ou `contact.birthday`, ou vers une clé de date déclarée dans une colonne JSON, comme `document.userMetadata.insuranceExpiryDate` ; les anciens noms comme `reservationCheckIn` continuent de fonctionner), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` ou `after`), `dateTime` (`exact` : l'heure dans la date, ou `fixed` : le jour calendaire de la date dans le fuseau horaire de l'organisation, avec `dateHour` et `dateMinute`, du texte comme `"9"` et `"0"` ; le décalage compte sur l'horloge, donc à travers l'heure d'été et d'hiver), `repeatYearly` (booléen : seuls le jour et le mois comptent, chaque année), `hour` et `minute` (texte, par exemple `"8"` et `"0"`, minute de 0 à 59), `cron` (cinq champs ; le jour de la semaine peut être `1#2` ou `1L`, un sixième champ `W2:2026-10-05` répète toutes les deux semaines), `conditions`, `oncePerRecord` (booléen) |
| `condition` | `conditions` |
| `switch` | `field` (un chemin de variable sans accolades), `cases` : une liste de `{ "id", "key", "value" }` avec `key` comme nom de la branche et `value` comme valeur à laquelle le champ doit être égal. 8 branches maximum |
| `delay` | `mode` (`duration` ou `untilDate`), `duration` et `offset` sous la forme `{ "amount", "unit" }` avec `unit` valant `seconds`, `minutes`, `hours`, `days` ou `weeks`, `dateField` (chemin de variable), `direction` (`before` ou `after`) |
| `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` ou `URGENT`), `viewId`, `laneId`, `subtasks` (une par ligne), `dueIn` (`{ "amount", "unit" }`), `linkRecords` |
| `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` ou `COMPLETED`) |
| `taskFind` | `title` (titre exact), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (booléens) |
| `documentFind` | `customerId` (modèle), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` ou vide), `onlyActive`, `onlyValid` (booléens). Résultat sous `foundDocument` |
| `documentUpdate` | `documentId` (modèle), `documentType` (vide conserve le type), `status` (`ACTIVE`, `ARCHIVED` ou vide) |
| `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` ou `set`), `priority` (pour `set`), `maxPriority` (pour `raise`) |
| `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` ou `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }` avec `unit` valant `minutes`, `hours`, `days` ou `weeks`) |
| `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` |
| `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` ou `tablet`) |
| `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` ou `PAYCONIQ`) |
| `mandateRequest` | `customerId`, `mode` (`request` ou `reminder`) |
| `mandateCollect` | `invoiceId`, `delayDays` (texte, `"0"` par défaut, 7 au plus) |
| `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` ou `task`), `taskId` (pour `task`) |
| `inboxReply` | `threadId`, `body`, `keepAssistant` |
| `inboxTag` | `threadId`, `tagIds`, `archive` |
| `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` ou `BLACKLISTED`), `notes` |
| `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` ou `cancel`) |
| `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` ou `NFC`), `value`, `periodFrom`, `periodTo` (variables contenant une date, vide signifie aucune limite) |
| `accessMethodUpdate` | `scope` (`one` ou `customer`), `accessMethodId` (pour `one`), `customerId` (pour `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` ou `INACTIVE`), `periodTo` |
| `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` ou `thermal`) |
| `accessPointControl` | `accessPointId`, `action` (`open` ou `close`) |
| `meterSwitch` | `target` (`terrain` ou `meter`), `terrainId` (pour `terrain`), `meterId` (pour `meter`), `state` (`on` ou `off`) |
| `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` ou `lowBalance`), `amount` (pour `topUp`, en euros par badge) |
| `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` ou `playSound`), `url` (pour `playSound` : le chemin d'un son téléversé, tel que l'éditeur le remplit, ou un lien https vers un fichier mp3, wav ou m4a) |
| `deviceDisplay` | `kind` (`pdf` ou `image`), `url` (lien https). Apparaît sur chaque tablette configurée comme écran d'affichage, comme un PDF de facture |
| `controllerRelay` | `target` (`controller` ou `event` : le contrôleur de l'événement `controller:input:changed` qui a démarré le flux), `controllerId` (pour `controller`), `relay` (texte `"1"` à `"6"`), `action` (`pulse`, `on` ou `off`), `durationSeconds` (pour `pulse`, texte, de 0.001 à 3600 avec des décimales comme `"0.5"` ; le relais retombe de lui-même) |
| `controllerCommand` | `target` et `controllerId` comme pour `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` ou `refreshSettings`) |
| `deviceSlideshow` | `scope` (`displays` ou `device`), `mode` (`screensaver` ou `background`), `source` (`feed` ou `urls`). Pour `feed` : `itemsPath`, `imageField`, champs de filtre et de tri facultatifs |
| `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Aucun champ |
| `throttle` | `window` (`{ "amount", "unit" }` avec `unit` valant `minutes`, `hours`, `days` ou `weeks`), `key` (vide signifie par enregistrement qui a démarré le flux) |
| `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` ou `InboxMessage`), `recordId`. Le résultat se trouve sous `found` plus le modèle, comme `foundCustomer` |
| `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (uniquement `ACTIVE`) ou `terrainMeters`), `parentId` (identifiant du client ou du terrain). 100 éléments au plus, l'élément se trouve sous `item` |
| `waitUntil` | `conditions`, `interval` et `timeout` (`{ "amount", "unit" }` avec `unit` valant `minutes`, `hours`, `days` ou `weeks` ; l'intervalle est d'au moins 5 minutes) |
| `waitForEvent` | `eventKey`, `sameRecord` (booléen), `timeout` (`{ "amount", "unit" }`) |
| `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). La tâche se trouve sous `approvalTask.id` |
| Toute action sauf `webhookSend` et `httpRequest` | `continueOnError` (booléen) |
| `webhookSend` | `webhookId`, `event`, `payload` (JSON sous forme de texte) |
| `httpRequest` | `target` (`tillor` ou `custom`), `method`, `path` (pour `tillor`), `url` (pour `custom`), `headers` (liste de `{ "id", "key", "value" }`), `body` (JSON sous forme de texte) |

`conditions` a la forme `{ "match": "all" ou "any", "rules": [...] }`. Chaque règle est `{ "id", "field", "operator", "value", "values" }`. `operator` vaut `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` ou `isNotEmpty`. Vous n'utilisez `values` que pour `isOneOf`. Une liste de règles vide laisse tout passer.

## Démarrer une automatisation avec un webhook [#een-automatisering-starten-met-een-webhook]

Une automatisation avec le déclencheur `webhook` démarre à la suite d'un `POST` vers sa propre adresse :

```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'adresse complète figure dans l'éditeur, au niveau du déclencheur, ou via `GET /automations/{id}/webhook-url` (avec `automations:read`). Le jeton est le secret ; un en-tête d'authentification n'est pas nécessaire
- Le corps JSON devient la variable `body`, la chaîne de requête `query`, et l'heure `receivedAt`
- Réponse `200` avec `{ "accepted": true }` dès que l'exécution a démarré. Une adresse erronée, remplacée ou désactivée renvoie `404`, un corps de plus de 100 Ko renvoie `400`
- De nombreux appels rapprochés ne sont pas refusés : chaque appel valide démarre une exécution. Utilisez **Ignorer les répétitions** sur le déclencheur si le même appel peut arriver deux fois, voir [Ignorer les répétitions](/automatiseringen/triggers#herhalingen-negeren)

Une automatisation ne peut pas appeler son propre webhook via une **Requête API** vers l'API Tillor.

## Choisir une décision via l'API [#een-beslissing-kiezen-via-de-api]

La tâche d'une étape **Demander une décision** a une action par option que vous avez définie dans l'étape. Récupérez la tâche pour voir les `actions` avec leur `id`, et choisissez-en une avec `POST /tasks/{id}/actions/{actionId}/choose`. Si l'option demande une note, envoyez-la avec `{ "note": "..." }`. Le choix est définitif : il clôt la tâche et poursuit l'automatisation par la sortie de cette option. Les collègues assignés (y compris via un groupe) et les administrateurs peuvent choisir. Voir [OpenAPI](https://tillor.eu/api/openapi.json) pour les détails.

## Pour en savoir plus [#meer-lezen]

- [Webhooks](/ontwikkelaars/webhooks) pour la signature, les nouvelles tentatives et la liste des événements
- [API HTTP](/ontwikkelaars/http) pour l'authentification et le contexte d'organisation
- [Variables et modèles](/automatiseringen/variabelen) pour le mode d'emploi utilisateur


# Event-index (/fr-FR/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>


# Notifications externes (/fr-FR/ontwikkelaars/externe-notificaties)

Votre système envoie lui-même des e-mails aux clients (newsletter, confirmation de réservation, rappel) ? Enregistrez-les alors dans Tillor. Les collaborateurs les voient sur la fiche du client, sur la facture et dans l'aperçu **Notifications**, à côté des notifications que Tillor envoie lui-même.

Tillor **n'envoie rien** : vous enregistrez un message déjà envoyé. Dans l'application, les notifications externes portent toujours l'étiquette **Externe** avec le nom de votre source, afin de ne jamais passer pour une notification Tillor.

## Accès [#toegang]

L'utilisateur derrière la [clé API](/ontwikkelaars/http) a besoin de l'une de ces permissions dans l'organisation. Un administrateur les attribue dans les permissions des utilisateurs de l'organisation, dans le groupe **Notifications** (**Enregistrer des notifications externes** et **Gérer les notifications externes des autres**).

| Permission | Ce que vous pouvez faire |
|-----------|------------|
| `notifications:external:write` | Enregistrer des notifications et mettre à jour ou supprimer vos **propres** enregistrements |
| `notifications:external:manage-others` | Mettre à jour ou supprimer aussi les enregistrements d'autres utilisateurs ou intégrations |

<Callout type="info" title="Un utilisateur par intégration">
La propriété est rattachée à l'utilisateur de la clé API. Utilisez un utilisateur (de service) distinct par intégration, ainsi une intégration ne pourra jamais modifier les notifications d'une autre.
</Callout>

## Endpoints [#endpoints]

Tous les chemins se trouvent sous `/api/orgs/:orgId`. Schémas exacts : [OpenAPI](https://tillor.eu/api/openapi.json), tag `notifications`.

| Méthode | Chemin | Description |
|--------|-----|--------------|
| POST | `/notifications/external` | Enregistrer une notification |
| PATCH | `/notifications/external/{id}` | Mettre à jour le statut, les horaires ou le contenu |
| DELETE | `/notifications/external/{id}` | Supprimer définitivement |
| GET | `/notifications?source=EXTERNAL` | Lister les notifications enregistrées (filtrez aussi sur `externalSource`, `externalReference`, `customerId`, `invoiceId`) |
| GET | `/notifications/{id}` | Récupérer une notification |

Vous ne pouvez ni modifier ni supprimer via ces endpoints les notifications que Tillor a envoyées lui-même ; elles renvoient `404`.

## Enregistrer [#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 }]
    }
  }'
```

Tous les champs et limites figurent dans [OpenAPI](https://tillor.eu/api/openapi.json). Ces champs ont des règles à connaître à l'avance :

| Champ | Règle |
|------|-------|
| `externalSource` | Nom de votre système en minuscules, chiffres, `.`, `_` ou `-` (par ex. `mailchimp`). Les collaborateurs voient ce nom sur la notification |
| `externalReference` | Votre propre identifiant pour ce message, unique au sein de `externalSource` |
| `name` | Court libellé pour les collaborateurs (par ex. « Confirmation de réservation »). Il peut servir à la recherche |
| `customerId` / `invoiceId` | Au moins l'un des deux. Détermine où la notification apparaît. Si vous n'envoyez que `invoiceId`, Tillor rattache aussi le client de cette facture. Un identifiant inconnu, ou une facture d'un autre client, renvoie `400` |
| `status` | `SENT`, `FAILED`, `BOUNCED` ou `COMPLAINED`. Sans `sentAt` avec `SENT`, Tillor utilise le moment de l'enregistrement |
| `sentAt`, `readAt`, `clickedAt` | ISO 8601 avec fuseau horaire, par ex. `2026-09-19T08:15:00Z`. Les autres valeurs sont refusées |
| `email.attachments` | Uniquement des métadonnées (`filename`, `contentType`, `size`). Les fichiers eux-mêmes ne sont pas stockés |

### Réessayer en toute sécurité [#veilig-opnieuw-proberen]

`POST` est idempotent sur `externalSource` + `externalReference`. Si vous renvoyez la même combinaison (par exemple après un délai d'expiration), vous récupérez la notification **existante** et rien n'est modifié. Pour changer quelque chose, utilisez `PATCH`.

<Callout type="warn" title="Pas de données personnelles dans externalReference ou name">
`externalSource`, `externalReference` et `name` sont stockés non chiffrés car ils servent à la recherche. Utilisez un identifiant technique, pas une adresse e-mail ni un nom. Une `externalReference` contenant `@` est refusée. Le destinataire, l'objet, le contenu et les pièces jointes, eux, sont stockés chiffrés.
</Callout>

## Mettre à jour et supprimer [#bijwerken-en-verwijderen]

Avec `PATCH`, n'envoyez que les champs qui changent, par exemple quand un e-mail rebondit après coup :

```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` supprime définitivement la notification, contenu compris. Utilisez-le aussi pour répondre à une demande de suppression (RGPD).

Un `PATCH` qui ne change rien ne fait rien : ni modification, ni événement. Si vous modifiez le contenu (libellé, destinataire, expéditeur, objet, texte, HTML ou pièces jointes) ou supprimez une notification, cela figure dans le journal d'activité du client ou de la facture, avec l'utilisateur qui l'a fait. Les mises à jour du statut, de `readAt` ou de `clickedAt` n'y figurent pas, pour que vous puissiez continuer à synchroniser les ouvertures et les clics.

## HTML et confidentialité [#html-en-privacy]

Tillor affiche le HTML aux collaborateurs tel que le client l'a reçu, mais le traite comme un contenu non fiable :

- Lors de l'enregistrement, les scripts, formulaires, iframes, éléments intégrés et attributs d'événement (`onclick`, ...) sont supprimés. Les liens s'ouvrent dans un nouvel onglet
- L'aperçu s'exécute dans un cadre isolé, sans scripts et sans accès à la session Tillor
- Les images et polices externes ne se chargent **pas automatiquement**, de sorte qu'ouvrir une notification n'active aucun pixel de suivi. Le collaborateur peut charger les images notification par notification

Ne comptez donc pas sur le déclenchement du suivi « ouvert » dans votre système lorsqu'un collaborateur consulte la notification.

## Ce que Tillor ne fait pas avec les notifications externes [#wat-tillor-niet-doet-met-externe-notificaties]

- Ne les (ré)envoie pas et ne les réessaie pas automatiquement
- Ne récupère pas de mises à jour de statut chez votre fournisseur de messagerie : c'est vous qui tenez le statut à jour avec `PATCH`
- Ne les compte pas dans les listes **Notifications échouées**, **Notifications rejetées** et **Notifications en attente** ni dans les compteurs en haut de l'aperçu des notifications, car Tillor ne peut pas vérifier votre statut. Elles figurent bien sous **Communications récentes**

## Webhooks et SSE [#webhooks-en-sse]

| Événement | Quand |
|-------|-------|
| `notification-delivery:updated` | À l'enregistrement et à chaque `PATCH` qui modifie quelque chose. Contient la notification complète |
| `notification-delivery:deleted` | Lors d'un `DELETE`. Contient uniquement `id`, `source`, `externalSource`, `externalReference`, `customerId` et `invoiceId` |

Le champ `source` vaut `EXTERNAL` pour vos enregistrements et `INTERNAL` pour les notifications de Tillor. Filtrez dessus si vous voulez ignorer vos propres événements. Voir [Webhooks](/ontwikkelaars/webhooks) et [SSE](/ontwikkelaars/sse).

## Voir aussi [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - Clés API, en-têtes et limites de débit
- [Webhooks](/ontwikkelaars/webhooks) - Recevoir des événements via HTTP POST
- [OpenAPI](https://tillor.eu/api/openapi.json) - Schémas complets


# API HTTP (/fr-FR/ontwikkelaars/http)

L'API Tillor est une API REST. Authentifiez-vous avec une clé API et envoyez les bons en-têtes à chaque requête. Les clés API sont **par compte** - une seule clé fonctionne pour toutes les organisations auxquelles vous avez accès.

## Référence de l'API et OpenAPI [#api-referentie-en-openapi]

- **[Référence de l'API](/api-referentie)** - Chaque endpoint avec ses paramètres et des exemples ; testez les requêtes directement dans le navigateur
- **[Spécification OpenAPI](https://tillor.eu/api/openapi.json)** - Documentation complète de l'API au format JSON pour la génération de code ou l'import dans Postman/Insomnia

---

## Clés API [#api-sleutels]

### Création [#aanmaken]

Vous créez les clés API dans l'application Tillor via le menu utilisateur sous **Compte > Clés API** (repère **1** = menu, repère **2** = Clés API sur la capture d'écran). Vous pouvez aussi les créer via l'API avec une session connectée (pas de clé API). Voir la [spécification OpenAPI](https://tillor.eu/api/openapi.json) sous le tag `api-keys` pour les chemins et les schémas de requête et de réponse.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Clés API dans les paramètres du compte" />

La clé brute n'est renvoyée qu'**une seule fois** lors de la création ou de la régénération. Conservez-la en lieu sûr ; vous ne pourrez plus la récupérer ensuite.

### Limiter les droits [#rechten-beperken]

Par défaut, une clé peut tout ce que vous pouvez vous-même, dans chaque organisation dont vous êtes membre. Dans la fenêtre de la clé, activez **Limiter aux autorisations sélectionnées** et choisissez les droits dont l'intégration a besoin, par exemple uniquement lire les factures. Une clé limitée reçoit, dans chaque organisation, l'intersection de ses droits et de votre appartenance à cette organisation : une clé ne peut jamais faire plus que vous. Un appel en dehors des droits choisis reçoit `403 Forbidden`, comme un utilisateur sans ce droit. Une modification des droits s'applique en moins d'une minute. Via l'API : `scopes` (liste d'identifiants de droits comme `invoices:read`, ou `null` pour tout) à la création et à la mise à jour d'une clé.

### Utilisation [#gebruik]

Envoyez la clé API dans l'en-tête `x-api-key` :

```http
x-api-key: tkn_xxx
```

Les clés utilisent le préfixe `tkn_`. Pour les endpoints d'organisation, l'identifiant de l'organisation figure dans le chemin (`/orgs/org_abc123/...`) ; un en-tête distinct n'est pas nécessaire.

### Limites de débit [#rate-limits]

- **Par défaut :** 5000 requêtes par 60 secondes par clé
- En cas de dépassement : `429 Too Many Requests` avec `Retry-After`
- Chaque réponse à une clé API contient les en-têtes IETF `RateLimit-*` :

```http
RateLimit-Limit: 5000
RateLimit-Remaining: 4999
RateLimit-Reset: 58
RateLimit-Policy: 5000;w=60
```

`RateLimit-Reset` est le nombre de secondes avant le redémarrage de la fenêtre actuelle. Les clients de navigateur peuvent lire ces en-têtes via CORS (`Access-Control-Expose-Headers`).

### Sécurité [#beveiliging]

<Callout type="warn" title="Attention">
- **Jamais** d'exposition de clés API dans du code côté client ou dans des dépôts publics
- Régénérez les clés régulièrement via **Régénérer** dans l'application (OpenAPI : `POST /api/api-keys/:id/renew`)
- Supprimez les clés inutilisées avec `DELETE /api/api-keys/:id`
</Callout>

---

## URL de base et contexte d'organisation [#base-url-en-organisatie-context]

**URL de base :** `https://tillor.eu` (ou l'URL de votre déploiement ; OpenAPI mentionne `{APP_URL}/api`)

**Chemins d'organisation :** ajoutez l'identifiant de l'organisation dans le chemin :

```
/api/orgs/:orgId/...
```

**Exemple :**

```
GET https://tillor.eu/api/orgs/org_abc123/customers
```

**En-tête requis pour les endpoints d'organisation :** `x-api-key: tkn_xxx`. L'identifiant de l'organisation figure dans le chemin.

---

## Exemple : 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"
```

---

## Intégrations (marketplace) [#integraties-marketplace]

Les intégrations d'organisation (auparavant « apps » dans l'API) utilisent une ressource par type sous `/api/orgs/:orgId/integrations/{integrationType}`. Les permissions requises sont `organization:integrations:read` et `organization:integrations:write` (elles remplacent `organization:apps:*`).

| Méthode | Chemin | Description |
|--------|------|-------------|
| GET | `/integrations/{integrationType}` | Statut (`installed`, `available`) et `settings` masqués |
| POST | `/integrations/{integrationType}` | Installer (`settings` facultatif dans le corps ; OAuth peut renvoyer `redirectUrl`) |
| PUT | `/integrations/{integrationType}` | Mettre à jour les réglages (`settings` dans le corps) |
| DELETE | `/integrations/{integrationType}` | Désinstaller |

Avec `GET` et après `PUT`, `settings` ne contient que les champs **publics**, plus `{ configured: true }` par champ secret. Les mots de passe, clés API et jetons OAuth ne sont pas renvoyés. Laissez les champs secrets vides lors d'un `PUT` pour conserver la valeur existante.

Voir la [spécification OpenAPI](https://tillor.eu/api/openapi.json) (tag `integrations`) pour les schémas exacts.

---

## Voir aussi [#gerelateerd]

- [Référence de l'API](/api-referentie) - Chaque endpoint, à tester dans le navigateur
- [OpenAPI](https://tillor.eu/api/openapi.json) - Spécification de l'API (JSON)
- [MCP](/ontwikkelaars/mcp) - Connecter Cursor, Claude, ChatGPT ou Gemini via OAuth
- [Notifications externes](/ontwikkelaars/externe-notificaties) - Enregistrer les e-mails envoyés par votre propre système
- [Webhooks](/ontwikkelaars/webhooks) - Recevoir des événements via HTTP POST
- [Webhook entrant d'une automatisation](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Démarrer une automatisation avec un POST, sans clé API
- [SSE](/ontwikkelaars/sse) - Diffuser des événements via Server-Sent Events
- [Exemples](/ontwikkelaars/voorbeelden) - Exemples de code et de charges utiles


# Aperçu (/fr-FR/ontwikkelaars)

L'API Tillor offre un accès programmatique aux données de votre organisation. Utilisez des clés API pour l'authentification, des webhooks pour les événements sortants, SSE ou MQTT pour le streaming en temps réel, ou MCP pour connecter à Tillor des outils d'IA comme Cursor, Claude, ChatGPT et Gemini.

## Que pouvez-vous construire ? [#wat-kun-je-bouwen]

- **Intégrations** - Connectez Tillor à vos propres systèmes via l'API REST
- **Webhooks** - Recevez des messages HTTP POST lorsque des événements se produisent (facture payée, client créé, etc.)
- **Démarrer des automatisations** - Démarrez une automatisation depuis votre propre système avec un POST vers son [webhook entrant](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook)
- **Tableaux de bord en temps réel** - Diffusez des événements via SSE ou MQTT pour des mises à jour en direct dans votre application
- **Outils d'IA** - Laissez Cursor, Claude, ChatGPT ou Gemini appeler l'API via [MCP](/ontwikkelaars/mcp) (`https://mcp.tillor.dev`)

## Démarrage rapide [#snel-aan-de-slag]

1. **Créez une clé API** dans Tillor sous *Compte > Clés API*
2. **Envoyez la clé** dans l'en-tête `x-api-key` à chaque requête
3. **Placez l'identifiant de votre organisation dans le chemin** des endpoints d'organisation : `/orgs/org_abc123/...`

<Callout type="info" title="Mêmes événements">
Les webhooks et SSE livrent exactement les mêmes événements. La différence : les webhooks envoient un HTTP POST vers votre URL ; SSE est une connexion longue sur laquelle vous recevez les événements.
</Callout>

**Liens utiles :** [Référence de l'API](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json)

**Portée :** les clés API sont par compte (toutes les organisations) ; les webhooks sont par organisation.

<Callout type="idea" title="Documentation pour les outils d'IA">
Vous pouvez aussi utiliser ce site sous forme de texte pour des outils d'IA : [`/llms.txt`](/llms.txt) (index), [`/llms-full.txt`](/llms-full.txt) (toutes les pages réunies), et par page en ajoutant `.mdx` après le chemin (par exemple [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **Demander à l'IA (local)** dans la mise en page de la documentation charge cet export complet (`/llms-full.txt`) dans l'IA intégrée de Chrome, pour que vous n'ayez pas à être sur une page précise.
</Callout>

## Voir aussi [#zie-ook]

<Cards>
  <Card
    title="API HTTP"
    href="/ontwikkelaars/http"
    description="Clés API, authentification, URL de base et contexte d'organisation"
  />
  <Card
    title="MCP"
    href="/ontwikkelaars/mcp"
    description="Connectez Cursor, Claude, ChatGPT ou Gemini à Tillor via OAuth"
  />
  <Card
    title="Notifications externes"
    href="/ontwikkelaars/externe-notificaties"
    description="Enregistrez les e-mails que votre propre système a envoyés aux clients"
  />
  <Card
    title="Webhooks"
    href="/ontwikkelaars/webhooks"
    description="Recevez des événements via HTTP POST vers votre endpoint"
  />
  <Card
    title="Automatisations"
    href="/ontwikkelaars/automatiseringen"
    description="Le message de webhook, la requête API, les webhooks entrants et la structure d'un flux"
  />
  <Card
    title="SSE"
    href="/ontwikkelaars/sse"
    description="Diffusez des événements en temps réel via Server-Sent Events"
  />
  <Card
    title="MQTT"
    href="/ontwikkelaars/mqtt"
    description="Pub/sub via MQTT avec accès strict aux topics et JWT ou identifiants statiques"
  />
  <Card
    title="Métadonnées Mollie"
    href="/ontwikkelaars/mollie-metadata"
    description="Espace de noms tillor sur les paiements Mollie"
  />
  <Card
    title="API de chat du site web"
    href="/ontwikkelaars/website-chat"
    description="Votre propre interface de chat via REST et SSE"
  />
  <Card
    title="Exemples"
    href="/ontwikkelaars/voorbeelden"
    description="Exemples de code et de charges utiles pour HTTP, Webhooks et SSE"
  />
</Cards>


# MCP (/fr-FR/ontwikkelaars/mcp)

Avec MCP (Model Context Protocol), des outils comme Cursor, Claude, ChatGPT et Gemini appellent l'API Tillor pour vous. Vous vous connectez une fois via OAuth ; aucune clé API ne doit figurer dans votre configuration.

**URL :** `https://mcp.tillor.dev`

## Ce que vous pouvez en faire [#wat-je-ermee-kunt]

Une fois connecté, vous pouvez, dans l'outil d'IA :

1. Consulter les catégories d'API et les endpoints (à partir de la spécification OpenAPI)
2. Appeler des endpoints avec vos droits dans l'organisation choisie

Tout passe par la même API REST que l'[API HTTP](/ontwikkelaars/http). Ce que vous avez le droit de faire dépend de votre compte Tillor et de vos permissions dans cette organisation. Pour se connecter via OAuth, il faut la permission **Autoriser les applications OAuth** (`oauth:consent`) dans au moins une organisation. Sans cette permission, le consentement échoue et les jetons OAuth existants cessent de fonctionner.

## Authentification [#authenticatie]

1. L'outil se connecte à `https://mcp.tillor.dev` sans jeton
2. La découverte et l'enregistrement OAuth passent par l'hôte MCP ; la connexion et le consentement se font sur Tillor
3. Vous approuvez l'accès dans le navigateur
4. L'outil envoie ensuite un jeton Bearer avec les appels MCP

Envoyez votre organisation en en-tête lorsque l'outil le permet (Cursor, Gemini CLI) :

```http
X-Tillor-Org-Id: org_abc123
```

Sans cet en-tête (ChatGPT, application Gemini, Claude), vous transmettez `organizationId` dans `call_api_endpoint`. Les routes d'organisation se trouvent sous `/orgs/{organizationId}` ; l'API renseigne alors l'en-tête elle-même.

<Callout type="info" title="Aucune clé API nécessaire">
Pour le serveur MCP hébergé, vous utilisez OAuth (Connect / Authorize dans l'outil). Pour les scripts et vos propres intégrations, continuez à utiliser des [clés API](/ontwikkelaars/http).
</Callout>

## Connecter [#koppelen]

Choisissez votre outil :

<McpProviderGuide />

Ou ouvrez le [sélecteur d'installation](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) pour Cline, Zed, Warp, Codex et les autres.

## Outils [#tools]

| Outil | Rôle |
|------|------|
| `list_api_categories` | Liste les catégories d'API |
| `list_api_endpoints` | Endpoints d'une catégorie, avec le schéma d'entrée |
| `get_api_endpoint_schema` | Schéma d'un endpoint, par nom |
| `call_api_endpoint` | Appelle un endpoint |

Les noms d'endpoints ne sont pas des outils distincts : utilisez `call_api_endpoint`.

La référence REST complète reste [OpenAPI](https://tillor.eu/api/openapi.json). MCP est une couche au-dessus, pas une API de produit distincte.

## Voir aussi [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - clés API, en-têtes et URL de base
- [OpenAPI](https://tillor.eu/api/openapi.json) - spécification complète de l'API
- [Référence de l'API](/api-referentie) - chaque endpoint, à essayer dans le navigateur


# Métadonnées Mollie (/fr-FR/ontwikkelaars/mollie-metadata)

Mollie conserve des métadonnées pour chaque paiement. Tillor lit et écrit des champs dans l'espace de noms `tillor`. Liaison dans l'application : [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).

Trois types :

1. **Métadonnées de liaison** - Tillor les réécrit dans Mollie pour que le paiement soit reconnaissable
2. **Indications d'ingestion** - vous les ajoutez lors de la création du paiement Mollie
3. **Métadonnées comptables directes** - contournement de Tillor vers la comptabilité

## Métadonnées de liaison [#koppelingsmetadata]

```json
{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "clxgrp..."
  }
}
```

Tillor réécrit `paymentId`, `invoiceId`, `customerId` et `paymentGroupId` dans Mollie dès qu'un paiement est lié à une facture, à un client ou à un [groupe de paiements](/betalingsverwerking/groepen). Les métadonnées existantes qui ne viennent pas de Tillor sont conservées.

| Champ | Description |
|------|---------------|
| `paymentId` | Paiement Tillor |
| `invoiceId` | Facture Tillor |
| `customerId` | Client Tillor |
| `paymentGroupId` | Groupe de paiements, même si ce groupe n'est pas encore lié à une facture |

## Indication d'ingestion : `descriptionSuffix` [#ingestie-hint-descriptionsuffix]

Vous l'ajoutez vous-même lors de la création du paiement Mollie. Tillor l'utilise pour la description du paiement dès qu'une facture y est liée.

```json
{
  "tillor": {
    "descriptionSuffix": "Parkeerplaats P1"
  }
}
```

Format dans Tillor : `INV/XXXX/XXXX - {suffix}`.

## Indications d'ingestion pour les groupes de paiements [#ingestie-hints-voor-betalingsgroepen]

Pratique pour les shifts de caisse ou les activités : regrouper plusieurs paiements avant de comptabiliser une facture.

```json
{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}
```

Un seul des deux champs suffit. Les deux ensemble, c'est mieux si le libellé peut changer alors que l'ID reste stable.

| Champ | Description |
|------|---------------|
| `paymentGroupName` | Libellé visible dans Tillor. Correspond à des groupes ouverts existants par nom, ou devient le libellé d'un nouveau groupe |
| `paymentGroupExternalId` | Clé stable issue de votre système. La correspondance se fait sur cette clé plutôt que sur le nom ; le libellé suit `paymentGroupName` |

1. Tillor cherche un groupe **ouvert** avec cet ID externe (ou, sans ID, avec ce nom).
2. Aucune correspondance ? Un nouveau groupe ouvert est créé. Son nom est `paymentGroupName`, sinon `paymentGroupExternalId`.
3. Le paiement rejoint le groupe dès qu'il est **payé** dans Tillor.
4. Les groupes déjà liés à une facture ne sont pas réutilisés.

Les indications n'étaient pas encore sur le paiement Mollie lorsque Tillor a vu le paiement pour la première fois ? Le groupe est quand même rempli dès que le paiement est **payé**, qu'il n'est **pas** lié à une facture et ne fait **pas encore** partie d'un groupe. Cela se produit lors de la synchronisation suivante ou à la réception d'une notification Mollie.

<Callout type="info" title="Quand l'utiliser ?">
Étiquetez à l'avance chaque paiement Mollie depuis votre caisse. Le groupe apparaît sous *Administration > Paiements*, dans la section *Groupes de paiements*.
</Callout>

<Callout type="warn" title="Ne pas combiner avec invoiceId">
Un paiement groupé ne peut pas être lié seul à une facture. Si vous envoyez à la fois des indications de groupe et `invoiceId`, le groupe l'emporte.
</Callout>

## Métadonnées comptables directes (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping]

Par défaut, les paiements Mollie inconnus vont sur le compte d'attente **499000**. Avec `tillor.bookkeeping`, Tillor les comptabilise sur le client indiqué :

```json
{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}
```

| Champ | Description |
|------|---------------|
| `customerCode` | Code client dans la comptabilité - obligatoire |
| `documentType` | Par ex. INV, UF |
| `department` | Département |
| `fiscalYear` | Exercice comptable |
| `documentNumber` | Numéro de document |

Si `bookkeeping` est présent, le paiement n'arrive **pas** comme un paiement Tillor ordinaire. Les métadonnées servent à construire le rapport comptable.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Mollie (application)" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Groupes de paiements" href="/betalingsverwerking/groepen" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
</Cards>


# MQTT (/fr-FR/ontwikkelaars/mqtt)

Les identifiants MQTT donnent aux intégrations un accès pub/sub dans l'espace de noms de topics de votre organisation. Vous créez les identifiants dans Tillor sous **Compte > Développeurs** (par organisation). L'accès aux topics est limité à `tillor/{env}/{orgId}/integration` et à ses sous-topics (`{env}` = `prod`, `staging` ou `local`), sauf si un identifiant statique a `topicPrefix: null`.

Pour les mêmes événements en temps réel que les [webhooks](/ontwikkelaars/webhooks) et le [SSE](/ontwikkelaars/sse), utilisez ces canaux, pas MQTT.

## Gestion [#beheer]

| Méthode | Chemin | Description |
|--------|------|---------------|
| POST | `/api/orgs/:orgId/mqtt/credentials` | Générer des identifiants JWT (temporaires) |
| GET | `/api/orgs/:orgId/mqtt/static-credentials` | Récupérer les identifiants statiques |
| POST | `/api/orgs/:orgId/mqtt/static-credentials` | Créer un identifiant statique |
| DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Supprimer un identifiant statique |

Authentification : `x-api-key`, avec l'ID de l'organisation dans le chemin (comme pour l'[API HTTP](/ontwikkelaars/http)). Consultez la [spécification OpenAPI](https://tillor.eu/api/openapi.json) pour les schémas complets de requête et de réponse.

## Identifiants [#credentials]

Il en existe deux variantes :

### JWT (temporaire) [#jwt-tijdelijk]

- **Usage :** sessions courtes, accès temporaire
- **Expiration :** 1 heure par défaut ; configurable de 1 minute à 24 heures via `expiresInSeconds`
- **Idéal pour :** les tests, les connexions temporaires, ou lorsque vous récupérez les jetons dynamiquement
- **Création :** dans Tillor sous **Compte > Développeurs**, ou via `POST /api/orgs/:orgId/mqtt/credentials` avec, en option, `{ "clientId": "...", "expiresInSeconds": 3600 }`
- **Réponse :** `token` (à utiliser comme mot de passe MQTT), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt`
- **Nom d'utilisateur :** laissez-le vide à la connexion ; l'authentification JWT utilise uniquement le jeton comme mot de passe.
- **Client ID :** utilisez exactement le `clientId` de la réponse à la connexion (préfixe d'environnement compris, par ex. `prod-`).

Une connexion au broker via **mqtts** vérifie le certificat du serveur. Si vous utilisez un certificat d'AC **privée** (et non la chaîne publique habituelle), placez le PEM de cette AC dans l'environnement de votre client.

### Identifiants statiques [#statische-credentials]

- **Usage :** intégrations de longue durée, connexions permanentes
- **Forme :** userName, clientId et password fixes
- **Idéal pour :** les intégrations de production qui restent connectées en continu
- **Création :** dans Tillor sous **Compte > Développeurs**, ou via `POST /api/orgs/:orgId/mqtt/static-credentials` avec, en option, `{ "name": "mijn-integratie", "topicPrefix": null }`
- **Réponse :** `userName`, `clientId`, `password` (une seule fois), `topicPrefix` (`null` = aucun préfixe, ACL `#`), `brokerUrl` en option
- **Attention :** le mot de passe n'est affiché qu'une seule fois dans la réponse et ne peut plus être récupéré ensuite

---

## Accès aux topics [#topic-toegang]

Les abonnements aux topics sont **strictement limités**, sauf si `topicPrefix` vaut `null` (ACL `#`). Par défaut, vous ne pouvez publier et vous abonner que sur `tillor/{env}/{orgId}/integration` et `tillor/{env}/{orgId}/integration/#`.

- **Topics autorisés** - uniquement `tillor/{env}/{orgId}/integration` et ses sous-topics (par ex. `tillor/{env}/{orgId}/integration/connector/access-point-operation`)
- **Pas de contournement par joker** - même avec `#` ou `+`, vous n'accédez qu'à l'espace de noms de votre organisation
- **Par organisation** - les identifiants sont propres à une organisation ; vous n'avez pas accès aux topics des autres organisations

---

## Voir aussi [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - spécification complète de l'API
- [API HTTP](/ontwikkelaars/http) - API REST et clés API
- [Webhooks](/ontwikkelaars/webhooks) - mêmes événements via HTTP POST
- [SSE](/ontwikkelaars/sse) - flux d'événements via Server-Sent Events


# OAuth-clients (/fr-FR/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) (/fr-FR/ontwikkelaars/sse)

Le SSE fournit un flux de longue durée des mêmes événements que ceux reçus par les [webhooks](/ontwikkelaars/webhooks). Utilisez le SSE si vous préférez une connexion persistante aux rappels HTTP.

## Endpoint [#endpoint]

```
GET /api/orgs/:orgId/realtime/subscribe
```

## Authentification [#authenticatie]

Le SSE utilise la même authentification que les autres endpoints de l'API :

- **x-api-key** - votre clé API

L'ID de l'organisation figure dans le chemin de l'URL.

## Filtrage des événements [#event-filtering]

Utilisez le paramètre de requête `events` pour filtrer par type d'événement :

```
GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid
```

Utilisez `events=*` pour recevoir tous les événements (comme si vous omettiez le paramètre).

Consultez l'[index des événements](/ontwikkelaars/events) pour tous les événements, la permission requise par événement et un exemple de payload.

Quelques événements ont leur propre canal (journaux du contrôleur et E/S du contrôleur). Vous ne les recevez qu'avec `?channel=controller-logs` ou `?channel=controller-io` ; l'index des événements indique le canal.

Tillor ne livre que les événements pour lesquels le membre de l'organisation connecté a la permission. Sans `bank-transactions:read` (ou sync), vous ne recevez par exemple pas d'événements `bankAccountTransaction:*`, même sans filtre `events`.

Les données liées issues d'un autre domaine suivent les mêmes règles que l'API : sans `customers:read`, un `reservation:updated` arrive avec `customer: null` ; sans `payments:read`, un `invoice:paid` arrive avec `payment: null`. Une liste devient alors `[]`.

---

## Format des événements [#event-formaat]

Le payload a la même structure que les [livraisons de webhook](/ontwikkelaars/webhooks#webhook-payload) :

| Champ | Type | Description |
|-------|------|--------------|
| `event` | string | Clé de l'événement (par ex. `invoice:created`) |
| `data` | object | Payload propre à l'événement |
| `timestamp` | number | Horodatage Unix (ms) de l'émission de l'événement |
| `traceId` | string | ID de trace OpenTelemetry de l'action Tillor qui a provoqué cet événement (comme pour les [webhooks](/ontwikkelaars/webhooks#webhook-payload)) |
| `spanId` | string (facultatif) | Span au sein de cette trace |

Dans le flux SSE, cet objet JSON se trouve sur la ligne `data:` ; la clé de l'événement figure aussi sur la ligne `event:`. Consultez les [exemples SSE](/ontwikkelaars/voorbeelden/sse) pour un exemple brut.

---

## Exemple : 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);
    }
  }
}
```

---

## Exemple : 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"
```

---

## Reconnexion [#herverbinding]

Si la connexion se coupe, reconnectez-vous avec la même URL et les mêmes en-têtes. Le flux ne permet pas de reprise : après la reconnexion, vous ne recevez que les nouveaux événements.

---

## Voir aussi [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - spécification complète de l'API
- [API HTTP](/ontwikkelaars/http) - clés API et authentification
- [Webhooks](/ontwikkelaars/webhooks) - mêmes événements via HTTP POST
- [Exemples](/ontwikkelaars/voorbeelden) - exemples de code et de payload


# Exemples HTTP (/fr-FR/ontwikkelaars/voorbeelden/http)

Heures d'ouverture et jours fériés pour un site public : [API des heures d'ouverture](/ontwikkelaars/voorbeelden/opening-hours).

## Requête API avec 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"
```

## Créer une clé 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"}'
```

## Créer 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
  }'
```


# Aperçu (/fr-FR/ontwikkelaars/voorbeelden)

Des exemples prêts à l'emploi pour démarrer. Chaque exemple utilise les placeholders `org_abc123` et `tkn_xxx` ; remplacez-les par l'ID de votre organisation et votre clé API.

<Cards>
  <Card
    title="Exemples HTTP"
    href="/ontwikkelaars/voorbeelden/http"
    description="Exemples cURL et de requêtes pour l'API Tillor"
  />
  <Card
    title="API des heures d'ouverture"
    href="/ontwikkelaars/voorbeelden/opening-hours"
    description="Récupérer les heures d'ouverture résolues et les prochains jours fériés pour un site web"
  />
  <Card
    title="Exemples de webhooks"
    href="/ontwikkelaars/voorbeelden/webhooks"
    description="Payloads d'événements et exemples de POST de webhook"
  />
  <Card
    title="Exemples SSE"
    href="/ontwikkelaars/voorbeelden/sse"
    description="Node.js et cURL pour les Server-Sent Events"
  />
</Cards>


# API des heures d'ouverture (/fr-FR/ontwikkelaars/voorbeelden/opening-hours)

Utilisez l'API des heures d'ouverture **résolues** si vous affichez sur un site public des horaires saisonniers (par exemple **Zomer** / **Winter**) ou les prochains **jours fériés**. Tillor applique déjà les exceptions, les périodes saisonnières et l'horaire hebdomadaire habituel, et ajoute les jours fériés légaux de la plage demandée. Vous n'avez pas à le réimplémenter.

**Permission :** `organization:settings:read` ou `organization:settings:write`

<Callout type="warn" title="La clé API reste côté serveur">
N'appelez Tillor que depuis un serveur (Route Handler Next.js, Server Component ou backend). Placez la clé dans des variables d'environnement. Ne l'envoyez jamais au navigateur.
</Callout>

Authentification : voir [API HTTP](/ontwikkelaars/http). Essayez l'endpoint dans la [référence de l'API](/api-referentie) ou via [OpenAPI](https://tillor.eu/api/openapi.json) (tag `organization-settings`).

## Endpoint [#endpoint]

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours
```

En-têtes :

```http
x-api-key: tkn_xxx
```

Remplacez `org_abc123` par l'ID de votre organisation.

### Paramètres de requête [#queryparameters]

Utilisez **soit** `date`, **soit** `from`/`to`. Ne les combinez pas.

| Paramètre | Signification |
|-----------|-----------|
| *(aucun)* | Aujourd'hui, dans le fuseau horaire de l'organisation |
| `date` | Un seul jour calendaire (`YYYY-MM-DD`) |
| `from` | Premier jour (inclus). Sans `to` : uniquement ce jour |
| `to` | Dernier jour (inclus). Nécessite `from`. Maximum **366** jours |
| `languageIsoCode` | Langue des noms de jours fériés (`NL`, `FR`, …). Par défaut : la langue de l'organisation |

## Réponse [#response]

Chaque élément correspond à un jour calendaire, déjà résolu :

| Champ | Signification |
|------|-----------|
| `timeZone` | Fuseau horaire IANA de l'organisation |
| `from` / `to` | Plage demandée |
| `holidays` | Jours fériés légaux qui chevauchent `from`–`to` |
| `items[].date` | Jour calendaire `YYYY-MM-DD` |
| `items[].weekday` | `monday` … `sunday` |
| `items[].source` | `exception`, `period` ou `regular` |
| `items[].periodLabel` | Uniquement pour `source: "period"` : le libellé défini dans Tillor, par exemple `"Zomer"` ou `"Winter"` |
| `items[].holiday` | Uniquement si ce jour est un jour férié légal : `{ id, name, startDate, endDate }` |
| `items[].blocks` | Plages horaires en minutes depuis minuit |
| `items[].closed` | `true` si `blocks` est vide |

Priorité : **exception** (jour férié ou plage personnalisée) → dernière **période saisonnière** correspondante → horaire hebdomadaire **habituel**.

Les libellés de saison proviennent de *Paramètres > Heures d'ouverture*. Les périodes peuvent chevaucher le changement d'année (par exemple du 1er novembre au 31 mars). Les jours hors de toute période retombent sur l'horaire hebdomadaire habituel (`source: "regular"`, pas de `periodLabel`).

### Minutes en heure d'horloge [#minuten-naar-kloktijd]

`startMinutes` / `endMinutes` sont des minutes à partir de 00:00.

| Minutes | Heure |
|--------:|------|
| 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")}`;
}
```

## Exemples [#voorbeelden]

### Jour dans une période saisonnière [#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, horaires d'été.

### Jour hors des périodes saisonnières [#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 et 13:00–17:00.

### Plage à cheval sur une limite de période [#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"
```

| Date | `source` | `periodLabel` |
|-------|----------|---------------|
| 2026-03-30 | `regular` | - |
| 2026-03-31 | `regular` | - |
| 2026-04-01 | `period` | `Zomer` |
| 2026-04-02 | `period` | `Zomer` |

## Prochains jours fériés [#komende-feestdagen]

Les jours fériés légaux figurent dans la même réponse : `holidays` pour une liste (nom + dates), `items[].holiday` si ce jour calendaire est un jour férié. Les heures restent celles de l'horaire résolu ; un jour férié sans exception saisie dans Tillor suit l'horaire saisonnier ou hebdomadaire (`source` n'est alors pas `"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'exemple de `items` ci-dessus est abrégé ; la vraie réponse contient chaque jour de la plage. Les vacances scolaires ne font pas partie de cet endpoint ; elles restent disponibles via `GET /holidays?kind=school`.

## Next.js (serveur) [#nextjs-server]

Pour un widget hebdomadaire ou un « ouvert maintenant » sur un site public :

```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` est la liste pour un bloc « prochains jours fériés ». `items[].holiday` est utile dans un calendrier hebdomadaire. `items[].periodLabel` est le texte de saison (par exemple `"Zomer"` ou `"Winter"`). Un cache d'une heure suffit généralement.

## Invalider le cache (webhook) [#cache-ongeldig-maken-webhook]

À chaque modification des paramètres de l'organisation, Tillor envoie `organizationSettings:updated` (webhook et SSE). Abonnez-vous à cet événement et récupérez à nouveau les heures d'ouverture. Le payload est volontairement réduit (ni adresses IP d'imprimantes ni horaire complet) :

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

`openingHoursChanged` vaut `true` lorsque l'horaire d'ouverture, le fuseau horaire ou le pays par défaut change - c'est ce qui influence `GET .../opening-hours`. Si la valeur est `false`, vous pouvez conserver le cache des heures d'ouverture.

Exemple de Route Handler 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 });
}
```

Créer un webhook : voir [Webhooks](/ontwikkelaars/webhooks). Clé d'événement : `organizationSettings:updated` (permission `organization:settings:read` ou `organization:settings:write`).

## Horaire complet (facultatif) [#volledig-rooster-optioneel]

Nécessaire uniquement si vous voulez afficher vous-même le calendrier saisonnier (libellés + `fromMonth`/`untilDay`), sans résolution jour par jour :

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings
```

Lisez `openingHoursSchedule.periods` (libellés comme `"Zomer"`) et `openingHoursSchedule.weekdays` (horaire habituel). Pour le site web lui-même, `GET .../opening-hours` reste la source la plus simple.

## MCP [#mcp]

Dans Cursor ou Claude : endpoint `organizationSettings_listOpeningHours` (catégorie `organizationSettings`), arguments `organizationId`, `date` ou `from`/`to` en option, `languageIsoCode` en option.

## Voir aussi [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - authentification et en-têtes
- [Exemples HTTP](/ontwikkelaars/voorbeelden/http) - exemples cURL généraux
- [Webhooks](/ontwikkelaars/webhooks) - `organizationSettings:updated` pour la revalidation du cache
- [Paramètres de l'organisation](/gebruikers/organisaties) - configurer les heures d'ouverture dans Tillor


# Exemples SSE (/fr-FR/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);
    }
  }
}
```

## Message SSE [#sse-bericht]

Un message SSE (`text/event-stream`) ressemble à ceci :

```
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 ligne SSE `event` est `message`. Analysez la ligne `data` comme du JSON : elle contient l'événement Tillor (`event`), le payload (`data`) et `timestamp` (ms). Vous recevez le même objet JSON via les [webhooks](/ontwikkelaars/webhooks).


# Exemples de webhooks (/fr-FR/ontwikkelaars/voorbeelden/webhooks)

Les mêmes événements que pour le [SSE](/ontwikkelaars/voorbeelden/sse). La structure du payload est identique.

## Structure d'enveloppe [#wrapper-structuur]

```json
{
  "event": "entity:action",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

`traceId` correspond à l'action Tillor qui a provoqué l'événement (par ex. un appel d'API ou un traitement interne), pas à une nouvelle tentative de webhook ultérieure.

## Exemple de POST de webhook [#webhook-post-voorbeeld]

Une requête POST de webhook complète ressemble à ceci :

```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"
}
```

## Payloads d'événements [#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
}
```

Consultez l'[API des heures d'ouverture](/ontwikkelaars/voorbeelden/opening-hours) pour la revalidation du cache sur un site public.

## Enums [#enums]

| Entité | Enum | Valeurs |
|--------|------|---------|
| 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`, … (liste complète dans 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` |


# Webhooks (/fr-FR/ontwikkelaars/webhooks)

Les webhooks reçoivent des événements en temps réel par HTTP POST sur une URL que vous configurez. Les mêmes événements sont aussi disponibles via le [SSE](/ontwikkelaars/sse). Les webhooks sont configurés **par organisation** : chaque organisation a ses propres webhooks.

## Gestion [#beheer]

Consultez la [spécification OpenAPI](https://tillor.eu/api/openapi.json) pour les schémas complets de requête et de réponse.

| Méthode | Chemin | Description |
|--------|------|-------------|
| GET | `/api/orgs/:orgId/webhooks` | Récupérer les webhooks |
| GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Récupérer les statistiques de livraison |
| POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Réessayer des livraisons. Corps : `mode` (`failed` ou `force`) et, en option, `id` pour un seul webhook. `failed` : uniquement les livraisons définitivement échouées, immédiatement. `force` : les livraisons en attente et définitivement échouées, en arrière-plan, sans tenir compte des délais d'attente. |
| GET | `/api/orgs/:orgId/webhooks/:id` | Récupérer un webhook par ID |
| POST | `/api/orgs/:orgId/webhooks` | Créer un webhook |
| PATCH | `/api/orgs/:orgId/webhooks/:id` | Mettre à jour un webhook |
| DELETE | `/api/orgs/:orgId/webhooks/:id` | Supprimer un webhook |

## Créer 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 qui accepte les requêtes POST
- **subscribedEventKeys** - tableau de clés d'événements ou `["*"]` pour tous les événements. La liste complète se trouve dans Tillor sous **Menu du profil → Développeurs**, à **Ajouter un webhook** → **Événements abonnés**.

Quelques événements sont si fréquents que vous ne pouvez pas les choisir et qu'ils n'arrivent pas non plus via `*`, comme l'état physique des barrières, la saisie dans la boîte de réception, les journaux du contrôleur et la présence de véhicules. Ils ne figurent pas dans la liste ci-dessous. Les événements que vous pouvez choisir dépendent aussi de vos permissions.
- **enabled** - `true` pour activer la livraison

Vous ne pouvez choisir que les événements pour lesquels votre membre de l'organisation a la permission correspondante (par ex. les transactions bancaires pour `bankAccountTransaction:*`). Le joker `*` n'est disponible que pour les membres ayant un accès complet (`*`). En cas de combinaison invalide, l'API renvoie un message d'erreur. Un webhook transmet le payload complet, avec les données liées (comme le client d'une réservation). Vous devez donc aussi avoir le droit de lire ces domaines pour créer un webhook, modifier l'URL ou les événements, ou le réactiver.

---

## Payload du webhook [#webhook-payload]

Chaque livraison de webhook est un POST avec :

**En-têtes :**
- `Content-Type: application/json`
- `X-Webhook-Event-ID` - ID unique et stable de cette livraison logique (même valeur lors des nouvelles tentatives)
- `X-Webhook-Signature` - signature HMAC-SHA256 du corps, au format `sha256=<hex>` (voir [Vérifier la signature](#handtekening-verifiëren))

**Corps :**

```json
{
  "event": "invoice:created",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7",
  "triggeredBy": {
    "id": "usr_63x8jp68is",
    "name": "Niels"
  }
}
```

| Champ | Type | Description |
|------|------|--------------|
| `event` | string | Clé de l'événement (par ex. `invoice:created`) |
| `data` | object | Payload propre à l'événement |
| `timestamp` | number | Horodatage Unix (ms) de l'émission de l'événement |
| `traceId` | string | ID de trace OpenTelemetry de l'action Tillor qui a provoqué cet événement. Transmettez-le au support ; ce n'est pas un secret. |
| `spanId` | string (facultatif) | Span au sein de cette trace |
| `triggeredBy` | object \| null | Utilisateur qui a effectué l'action (`id`, `name`). `null` pour les actions système (cron, synchro bancaire, …) |

Consultez les [exemples](/ontwikkelaars/voorbeelden) pour des payloads complets.

---

## Vérifier la signature [#handtekening-verifiëren]

Chaque webhook possède son propre **secret de signature** (64 caractères hexadécimaux, visible dans le tableau des webhooks via **Afficher le secret de signature** sur *Menu du profil → Développeurs*). Tillor signe chaque POST avec ce secret pour que vous puissiez vérifier que la requête vient bien de Tillor et que le corps n'a pas été modifié.

**Comment Tillor signe :**

1. Calculez `HMAC-SHA256(signingSecret, raw_request_body)` (hex en minuscules).
2. Envoyez-le sous la forme `X-Webhook-Signature: sha256=<hex>`.

**Comment vous vérifiez :**

1. Lisez le corps **brut** de la requête (avant l'analyse JSON, sinon le hash ne correspond pas).
2. Calculez vous-même `HMAC-SHA256(signingSecret, raw_body)` en hex.
3. Comparez avec la valeur après `sha256=` de l'en-tête `X-Webhook-Signature` à l'aide d'une comparaison en **temps constant**.

```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="Traitez le secret comme un mot de passe">
Vous pouvez afficher le secret de signature dans Tillor via **Afficher le secret de signature** dans le tableau des webhooks. Conservez-le comme un secret (variable d'environnement, coffre-fort) et ne le journalisez jamais. Vous soupçonnez une fuite ? Supprimez le webhook et créez-en un nouveau ; vous obtenez ainsi un nouveau secret.
</Callout>

---

## Comportement de livraison et nouvelles tentatives [#leveringsgedrag-en-retries]

- Répondez avec un **statut 2xx** pour confirmer la réussite.
- Si une livraison échoue (statut non 2xx, erreur réseau ou cible bloquée), Tillor réessaie automatiquement avec des intervalles de plus en plus longs. Chaque tentative réutilise le même payload, la même signature et le même ID d'événement (idempotent).

| Tentative | Délai depuis la tentative précédente |
|---|---|
| 1 | immédiat |
| 2 | 1 seconde |
| 3 | 2 secondes |
| 4 | 4 secondes |
| 5 | 8 secondes |
| 6 | 5 minutes |
| 7 | 30 minutes |
| 8 | 2 heures |
| 9 | 6 heures |
| 10 | 24 heures |

- Si l'une des tentatives réussit (2xx) → la livraison est terminée.
- Si la tentative 10 (après 24 h) échoue aussi → la livraison est **définitivement marquée comme échouée** et n'est plus réessayée.
- Si le webhook est entre-temps **désactivé**, Tillor arrête les nouvelles tentatives.

```mermaid
flowchart TD
  A[Événement émis] --> B[Livraison vers votre endpoint]
  B -- 2xx --> Z[Terminé]
  B -- échec --> C[Nouvelle tentative<br/>1s, 2s, 4s, 8s,<br/>5m, 30m, 2h, 6h, 24h]
  C -- 2xx --> Z
  C -- toutes les tentatives échouent --> F[Échec définitif]
```

<Callout type="info" title="Idempotence">
Chaque nouvelle tentative réutilise les mêmes `X-Webhook-Event-ID` et `X-Webhook-Signature`. Dédupliquez de votre côté sur cet en-tête afin qu'une nouvelle tentative réussie après un 200 tardif ne provoque pas de double traitement.
</Callout>

### Notifications en cas d'échecs persistants [#meldingen-bij-aanhoudende-fouten]

Si les livraisons vers un endpoint de webhook continuent d'échouer, Tillor envoie **au maximum deux notifications par incident** (par endpoint) :

1. **Après 5 minutes d'échecs persistants** - e-mail à l'adresse e-mail de l'organisation (`supportEmail`, sinon `email`) et aux membres de l'organisation autorisés à modifier les paramètres de l'organisation, plus une notification push (si activée) pour ces membres. L'e-mail indique depuis quand les livraisons échouent. Les dates de l'e-mail utilisent le **fuseau horaire** défini sous *Paramètres > Général* (par défaut `Europe/Brussels`).
2. **En cas d'échec définitif** - les mêmes destinataires reçoivent une notification lorsque le premier événement de cet incident est marqué comme définitivement échoué après toutes les tentatives.

Vous ne recevez **pas** de notification par événement échoué. Dès que toutes les livraisons échouées d'un endpoint sont résolues (livrées avec succès), un nouvel incident repart avec les mêmes règles.

Sur **Menu du profil → Développeurs**, le tableau des webhooks affiche pour chaque endpoint un état de livraison compact (nombre en attente de nouvelle tentative et définitivement échoués). Cliquez sur l'icône **ℹ** pour les détails, y compris le message d'erreur complet et le payload de la tentative la plus récente.

- **Réessayer les livraisons échouées** (↻) : uniquement les livraisons définitivement échouées de ce webhook.
- **Forcer la nouvelle tentative** (⚡) : toutes les livraisons en attente et définitivement échouées de ce webhook, quels que soient les délais planifiés. Tillor lance cela en arrière-plan afin que les grandes files d'attente (par ex. des milliers d'événements) soient traitées en toute sécurité.
- **Forcer tout** en haut à droite, à côté de **Ajouter un webhook** : la même chose pour tous les webhooks activés de l'organisation.

---

## Types d'événements [#event-types]

Les clés d'événements utilisent le format `entity:action` ou `entity:subresource:action`. La liste complète, avec la permission par événement et un exemple de payload, se trouve dans l'[index des événements](/ontwikkelaars/events). Cette page est générée à partir du code et est donc toujours complète. Les mêmes clés figurent dans Tillor sous [Menu du profil → Développeurs](https://tillor.eu/orgs/org_abc123/developers), à **Ajouter un webhook** → **Événements abonnés**.


---

## Webhooks ou SSE [#webhooks-vs-sse]

| Cas d'usage | Recommandation |
|----------|-------------|
| Intégration côté serveur | **Webhooks** - votre serveur reçoit des POST |
| Journalisation simple | **Webhooks** - configuration minimale |
| Tableau de bord en temps réel, mises à jour en direct dans l'application | [SSE](/ontwikkelaars/sse) - une seule connexion, faible latence. |
| Nombreux types d'événements, filtrage côté client | [SSE](/ontwikkelaars/sse) - utilisez le paramètre de requête `events` pour limiter le trafic. |

---

## Voir aussi [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - spécification complète de l'API
- [API HTTP](/ontwikkelaars/http) - API REST et clés API
- [SSE](/ontwikkelaars/sse) - mêmes événements via Server-Sent Events
- [Automatisations](/ontwikkelaars/automatiseringen) - envoyer vos propres messages depuis une automatisation


# API du chat du site web (/fr-FR/ontwikkelaars/website-chat)

Vous installez le widget officiel dans l'application : voir [Mettre le chat sur votre site](/inbox/website-chat). Les options du snippet se trouvent sur [Paramètres du chat du site](/inbox/website-chat-instellingen). Cette page s'adresse aux développeurs : le SDK du widget pour votre propre formulaire et la couche REST pour une **interface de chat personnalisée**. Voir [OpenAPI](https://tillor.eu/api/openapi.json), tag `inbox`.

## SDK du widget [#widget-sdk]

Après le chargement du script du widget, `window.TillorInbox` est disponible. Il vous permet de transmettre des coordonnées depuis votre propre formulaire (page de contact, détail d'une vente, demande de devis). Toutes les méthodes attendent que la configuration du widget soit chargée.

| Méthode | Description |
|---------|--------------|
| `ready()` | Promise résolue dès que le widget est chargé |
| `getVisitor()` | Lit les coordonnées enregistrées dans `localStorage` et les champs du widget remplis ; synchrone, sans réseau |
| `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Remplit les champs du chat sans envoyer |
| `open()` | Ouvre la fenêtre de chat |
| `close()` | Ferme la fenêtre de chat |
| `toggle()` | Ouvre ou ferme la fenêtre de chat |
| `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Envoie un message avec les coordonnées |

`getVisitor()` renvoie cet objet :

| Champ | Description |
|------|--------------|
| `visitorId` | ID de ce visiteur dans ce navigateur (`localStorage`) |
| `name` | Nom complet (un seul champ dans le widget) |
| `firstName` / `lastName` | Déduits de `name` (premier mot / reste) |
| `email`, `phone` | Coordonnées |
| `customFields` | Champs supplémentaires issus des paramètres du widget |
| `message` | Brouillon dans le champ de message |
| `detailsSubmitted` | Indique si le formulaire du visiteur est considéré comme rempli |

Utilisez `getVisitor()` pour préremplir votre propre formulaire depuis `localStorage` (même navigateur, aussi après un rafraîchissement de la page).

Options pour `setVisitor` (deuxième argument) :

| Option | Par défaut | Explication |
|-------|-----------|--------|
| `open` | `false` | Ouvrir directement la fenêtre de chat |
| `markSubmitted` | `false` | Masquer le formulaire du visiteur si tous les champs obligatoires sont remplis |
| `onlyEmpty` | `false` | N'écraser que les champs vides |
| `persist` | `false` | Conserver les données dans `localStorage` (même navigateur, aussi après un nouvel onglet) |

Options pour `send` :

| Option | Par défaut | Explication |
|-------|-----------|--------|
| `open` | `false` | Ouvrir la fenêtre de chat avant l'envoi |
| `silent` | `true` si `open` vaut false | Pas de son, pas de message d'erreur dans le widget ; utilisez la Promise pour le succès ou l'échec |
| `markSubmitted` | `true` | Les coordonnées n'ont plus besoin d'être saisies à nouveau dans le widget |
| `metadata` | - | Indications facultatives pour Tillie (non visibles dans la fenêtre de chat) ; voir [metadata](#metadata-boekingsformulier) |

Avec `open: false` (par défaut), le bouton de chat reste fermé. Le message part bien vers Tillor ; votre propre formulaire peut remercier ou afficher une erreur. Avec `open: true`, la fenêtre de chat s'ouvre et le visiteur voit le comportement d'envoi habituel (son, coches, éventuelles erreurs du widget).

Vous voulez utiliser votre propre bouton à la place du bouton de chat flottant ? Mettez `data-launcher="false"` sur le snippet et appelez `TillorInbox.open()`.

### `metadata` (formulaire de réservation) [#metadata-boekingsformulier]

Utilisez `metadata` lorsque vous avez votre propre formulaire sur le site et que Tillie doit **uniquement envoyer une confirmation**, sans questions de suivi (par exemple parce que l'onglet se ferme ensuite).

| Clé | Type | Explication |
|---------|------|--------|
| `forceHandover` | `boolean` | Message de confirmation et transfert à un collègue, sans questions d'admission. Ignore aussi la pause de l'IA après un message de l'équipe (voir `ignoreAiPause`) |
| `ignoreAiPause` | `boolean` | Tillie répond aussi lorsqu'elle est en pause en mode **Automatique** après un message de l'équipe (30 minutes). Pratique pour un envoi de formulaire silencieux ; combinez avec `forceHandover` ou laissez Tillie mener l'admission normalement |
| `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Facultatif : flux pour le transfert (par défaut : déduit automatiquement du message) |
| `source` | `string` | Libellé d'intégration facultatif pour votre équipe (minuscules, chiffres, `-`, `_` ; 64 caractères max.) |

```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",
  },
});
```

### Remplacer le formulaire de contact (envoi silencieux) [#contactformulier-vervangen-stille-verzending]

Utilisez ceci si vous voulez garder le formulaire de contact existant, mais faire passer les messages par Tillor sans ouvrir la fenêtre de 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>
```

Vous n'avez pas besoin de définir `open` ni `silent` : sans `open: true`, la fenêtre reste fermée et Tillor traite l'appel comme un envoi silencieux.

### Relier le formulaire de contact (ouvrir le chat) [#contactformulier-koppelen-chat-openen]

Transmettre les champs et ouvrir la fenêtre de chat, pour que le visiteur voie la conversation :

```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>
```

Ou seulement remplir les champs et ouvrir la fenêtre, sans envoyer tout de suite :

```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 },
);
```

Une page de vente avec envoi direct et ouverture du 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,
});
```

Synchroniser en direct pendant que quelqu'un tape :

```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,
  });
});
```

### Appeler tôt (avant le script du widget) [#vroeg-aanroepen-vóór-het-widget-script]

Si vous appelez une méthode avant que le script soit chargé, mettez l'appel en file d'attente :

```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>
```

## Interface de chat personnalisée [#eigen-chat-ui]

Si vous créez votre propre interface de chat à la place du widget, vous utilisez la couche REST ci-dessous.

Authentification : en-tête `X-Tillor-Inbox-Widget-Key` (valeur issue de *Paramètres > Intégrations > Chat du site web*).

### Saisie [#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` lorsque le visiteur tape ; `false` lorsque le champ est vide ou que le visiteur arrête (le widget envoie `false` après environ 4 secondes sans saisie)
- `visitorName` / `visitorEmail` / `visitorPhone` sont facultatifs
- Utilisez le même `visitorId` que pour `POST …/inbox/website/messages` et `GET …/inbox/website/messages`

### Temps réel (SSE) [#realtime-sse]

```http
GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_…
X-Tillor-Inbox-Widget-Key: iwk_xxx
Accept: text/event-stream
```

| Événement | Quand |
|-------|-------|
| `inbox:website:message-created` | Nouveau message de l'équipe ou de l'IA |
| `inbox:website:message-updated` | Message de l'équipe ou de l'IA modifié ou supprimé |
| `inbox:website:typing-changed` | `data.staffTyping` ou `data.staffOutboundSenderType` change |

Le format du payload est le même que pour le [SSE de l'organisation](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Reconnectez-vous après une coupure ; il n'y a pas de reprise.

Le widget officiel utilise le SSE comme couche principale et récupère `GET …/messages` toutes les **5 secondes** en solution de repli (toutes les **secondes** avec le panneau ouvert lorsque le SSE se coupe un instant). Ainsi, les réponses sont marquées comme **remises** tant que le visiteur est sur la page.

### Activité des visiteurs [#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` ou `navigation` (pour la navigation, aussi `url`). Votre équipe voit ces événements sous forme de texte d'information grisé dans la conversation, voir [Conversations via le chat du site](/inbox/website-chat-gesprekken).

### Limites [#limieten]

`POST …/inbox/website/messages` et `POST …/inbox/website/attachments/upload` répondent `429` quand un visiteur ou un réseau envoie trop. Le corps contient `data.reason` = `INBOX_WIDGET_RATE_LIMITED` et `data.retryAfterSeconds`. Limites par organisation :

| Route | Par visiteur (`visitorId`) | Par réseau (adresse IP) |
|-------|----------------------------|-------------------------|
| `messages` | 10 par minute, 200 par jour | 30 par minute, 600 par jour |
| `attachments/upload` | 10 par heure | 50 par heure |

Attends `retryAfterSeconds` avant de réessayer, et affiche un message au visiteur au lieu de réessayer automatiquement.

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Chat du site web (application)" href="/inbox/website-chat" />
  <Card title="Paramètres du chat du site" href="/inbox/website-chat-instellingen" />
  <Card title="SSE" href="/ontwikkelaars/sse" />
  <Card title="OpenAPI" href="https://tillor.eu/api/openapi.json" />
</Cards>


# Un client à la barrière (/fr-FR/praktijk/gast-aan-de-slagboom)

Un client arrive à la barrière du Recreatiepark Het Meer et doit pouvoir passer sans l'aide de la réception. Cet exemple suit Jonas Maes, depuis la configuration de sa méthode d'accès jusqu'à ce qui se passe lorsqu'elle ne fonctionne pas (ou plus). Vous voyez comment une méthode d'accès, un contrôleur et un point d'accès fonctionnent ensemble.

```mermaid
flowchart LR
  A[Méthode d'accès chez le client] --> B[Client au point d'accès]
  B --> C{Le contrôleur et Tillor vérifient}
  C -->|valide| D[Autorisé, barrière ouverte]
  C -->|expiré ou bloqué| E[Refusé, visible dans le journal]
```

Avant de commencer :

- Votre parc a au moins un point d'accès relié à Tillor. Il figure sous **Actions rapides** sur la page **Contrôle d'accès**, avec un bouton **Ouvrir [nom du point d'accès]**.
- Le contrôleur de la barrière est relié à votre organisation. Un nouveau contrôleur apparaît sous **Contrôleurs** avec **En attente d'approbation** jusqu'à ce que vous cliquiez sur **Approuver**. Voir [Contrôleurs](/controllers).
- Pour un badge NFC : le badge doit déjà exister dans Tillor. Cela se fait automatiquement dès qu'il a été présenté une première fois devant un lecteur.

## La marche à suivre, étape par étape [#de-route-stap-voor-stap]

<Steps>
<Step>
### Ajouter une méthode d'accès [#voeg-een-toegangsmethode-toe]
Allez dans <UIPath>Clients > Jonas Maes > Contrôle d'accès</UIPath> et cliquez sur **Ajouter**. Choisissez le **Type** et renseignez éventuellement une **Date de début** et une **Date de fin**. Cette période détermine quand la méthode fonctionne.

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Onglet Contrôle d'accès avec le tableau des méthodes d'accès" />

<Tabs items={["Plaque", "Code QR", "Badge NFC"]}>
<Tab value="Plaque">
Choisissez **Reconnaissance de plaque d'immatriculation** et renseignez la **Plaque d'immatriculation**. La caméra du point d'accès lit la plaque et Tillor y associe le client.
</Tab>
<Tab value="Code QR">
Choisissez **Code QR**. Tillor crée le code lui-même. Dans le menu de la méthode, copiez l'**URL personnelle** et envoyez-la à Jonas. Il ouvre la page **Pass d'accès** et peut ajouter le pass à Apple Wallet ou à Google Wallet, si c'est configuré pour votre environnement.
</Tab>
<Tab value="Badge NFC">
Choisissez **NFC** et sélectionnez une carte NFC disponible dans la liste. Si la liste est vide, présentez d'abord le badge devant un lecteur. Voir [Gérer les badges](/nfc/nfc-tags).
</Tab>
</Tabs>

Voir [Contrôle d'accès](/toegangscontrole).
</Step>
<Step>
### Vérifier le contrôleur et le point d'accès [#controleer-controller-en-toegangspunt]
Le contrôleur ou la caméra du point d'accès reçoit de Tillor la liste des méthodes valides. Sous **Opérations du Contrôleur** sur la page **Contrôle d'accès**, vous voyez quand un pass ou un code QR a été transmis au point d'accès. Si l'opération n'y figure pas encore, la synchronisation est toujours en cours.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Opérations du contrôleur avec synchronisation et actions de liste blanche" />
</Step>
<Step>
### Suivre ce qui se passe à la barrière [#volg-wat-er-aan-de-slagboom-gebeurt]
Le bloc **Journal d'accès** affiche chaque tentative avec la date, la méthode, le client, le point d'accès et le statut. Un client qui entre figure dans le tableau **Véhicules dans le parc** avec le statut **À l'intérieur**. S'il repart, le statut devient **Parti**.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Journal d'accès avec plaques, client et statut" />
</Step>
<Step>
### Ouvrir vous-même la barrière si nécessaire [#open-de-slagboom-zelf-als-het-nodig-is]
Sous **Actions rapides**, cliquez sur **Ouvrir [nom du point d'accès]** et confirmez avec **Oui, ouvrir [nom du point d'accès]**. La fermeture n'est possible que si le point d'accès la prend en charge.
</Step>
</Steps>

## Que se passe-t-il avec une méthode expirée ? [#wat-gebeurt-er-bij-een-verlopen-methode]

Une fois la **Date de fin** dépassée, la méthode ne donne plus accès et la tentative apparaît dans le journal avec le statut **Expiré**. Les autres statuts que vous rencontrerez sont **Bloqué**, **Inactif** et **Refusé**.

Pour les plaques, un délai de grâce existe, afin que les clients ne se retrouvent pas la nuit devant une sortie fermée. Si **Autoriser la sortie des plaques expirées** est activé (par défaut), la barrière de sortie s'ouvre encore pendant la période de grâce. Elle dure 2 jours par défaut et 30 au maximum. Cela ne fonctionne qu'en dehors des heures d'ouverture. Si la réception est ouverte, le personnel traite le véhicule au comptoir. Une plaque bloquée ou inactive n'obtient jamais de délai de grâce, et les badges NFC et les codes QR n'en ont pas. Vous le configurez sous <UIPath>Support > Paramètres > Contrôle d'accès</UIPath>, voir [Paramètres du contrôle d'accès](/gebruikers/instellingen-toegangscontrole).

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Chaque tentative reste dans le journal d'accès. Vous pouvez filtrer par client, statut et point d'accès, et exporter vers Excel.
- Un véhicule qui n'a pas été vu à un point d'accès depuis 7 jours reçoit le statut **Véhicule fantôme**. Si la plaque est revue plus tard à une entrée, il repasse à **À l'intérieur**.
- Si vous prolongez la **Date de fin** de la méthode, elle refonctionne après la prochaine synchronisation avec le point d'accès.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le client est devant une barrière fermée">
Retrouvez la tentative dans le journal d'accès et lisez le statut. **Expiré** signifie que la **Date de fin** est dépassée, **Bloqué** ou **Inactif** que la méthode est désactivée. Si la méthode convient, vérifiez **Opérations du Contrôleur**. Si vous ne pouvez pas résoudre rapidement, ouvrez la barrière via **Actions rapides**.
</Accordion>
<Accordion title="Aucune tentative n'apparaît dans le journal">
Dans ce cas, Tillor n'a rien reçu. Vérifiez si le contrôleur est en ligne et si l'écran affiche un message. Voir [Messages à l'écran](/controllers/troubleshooting/scherm) et [Problèmes de connexion](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="La plaque n'est pas reconnue">
Vérifiez que la plaque a été saisie sans espaces ni fautes de frappe. Une plaque mal lue peut aussi laisser un véhicule en **Véhicule fantôme**.
</Accordion>
<Accordion title="Je ne vois aucune carte NFC dans la liste">
Le badge n'est pas encore connu de Tillor ou est déjà associé à un autre client. Présentez-le d'abord devant un lecteur, ou dissociez-le de l'autre client.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Contrôle d'accès" href="/toegangscontrole" />
  <Card title="Contrôleurs" href="/controllers" />
  <Card title="NFC" href="/nfc" />
  <Card title="Paramètres du contrôle d'accès" href="/gebruikers/instellingen-toegangscontrole" />
</Cards>


# Aperçu (/fr-FR/praktijk)

Dans la plupart des tâches, vous touchez plus d'un module : un nouveau client devient une occupation, un contrat, une facture et un paiement. Ces exemples parcourent un tel trajet du début à la fin. Ils utilisent l'organisation de démonstration Recreatiepark Het Meer, avec le client Jonas Maes et l'emplacement 12. Chaque étape renvoie à la page contenant l'explication complète.

<Cards>
  <Card title="Accueillir un client saisonnier" href="/praktijk/seizoensklant-binnenhalen" description="Client, occupation, contrat de location, facture, paiement et rapport de paiement" />
  <Card title="Facturer la consommation" href="/praktijk/verbruik-aanrekenen" description="Du compteur sur l'emplacement à la facture de services automatique" />
  <Card title="Une caravane résidentielle se libère" href="/praktijk/stacaravan-komt-vrij" description="Arrêter l'occupation, tâche de suivi et restitution de la garantie" />
  <Card title="Un client à la barrière" href="/praktijk/gast-aan-de-slagboom" description="Méthode d'accès, contrôleur, point d'accès et ce qui se passe à l'expiration" />
</Cards>

## Comment tout cela s'articule-t-il ? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Client] --> B[Occupation]
  T[Emplacement] --> B
  M[Compteur] --> T
  B --> V[Consommation]
  K --> O[Demande de signature]
  B --> F[Facture]
  V --> F
  F --> P[Paiement]
  P --> R[Rapport de paiement]
  K --> TM[Méthode d'accès]
  TM --> TP[Point d'accès]
  B -->|se termine| A[Automatisation]
  A --> TK[Tâche]
```

Lisez les exemples comme un parcours : vous pouvez y entrer à n'importe quel point. Pour relire les termes, consultez [Glossaire](/begrippen).

## Glossaire [#begrippen]

- **Occupation** : un client sur un emplacement pour une longue période. Voir [Occupation](/begrippen#bezetting).
- **Emplacement** : un endroit de votre parc. Voir [Emplacement](/begrippen#terrein).
- **Demande de signature** : un PDF signé en ligne. Voir [Demande de signature](/begrippen#ondertekenverzoek).
- **Automatisation** : une règle que Tillor exécute lui-même. Voir [Automatisation](/begrippen#automatisering).


# Accueillir un client saisonnier (/fr-FR/praktijk/seizoensklant-binnenhalen)

Accueillir un client saisonnier signifie, dans Tillor : créer le client, lui attribuer un terrain, faire signer le contrat de location, facturer le droit de stationnement et veiller à ce que le paiement arrive dans votre comptabilité. Cet exemple parcourt ce trajet pour Jonas Maes, qui loue le terrain 12 au Recreatiepark Het Meer pour la saison. Chaque étape renvoie vers la page qui donne l'explication complète.

```mermaid
flowchart LR
  A[Créer le client] --> B[Occupation sur le terrain 12]
  B --> C[Signer le contrat de location]
  C --> D[Facturer le droit de stationnement]
  D --> E[Paiement]
  E --> F[Rapport de paiement]
```

Avant de commencer :

- Le terrain 12 existe et n'a aucune occupation active. S'il en a une, il n'apparaît pas dans la liste de choix de **Créer une occupation**.
- Il existe un produit avec l'action **Prolonger l'occupation**, souvent le droit de stationnement. Voir [Associer des actions à un produit](/producten/acties-instellen).
- Vous avez le contrat de location prêt en PDF.
- Vous avez le droit **Gérer les demandes de signature** pour faire signer le contrat.
- Pour une signature à distance, le client a besoin d'une adresse e-mail ou d'un numéro de téléphone. Pour un mandat SEPA, une adresse e-mail est nécessaire.

## Le parcours étape par étape [#de-route-stap-voor-stap]

<Steps>
<Step>
### Créez le client [#maak-de-klant-aan]
Allez dans <UIPath>Clients > Aperçu</UIPath> et cliquez sur **Créer un nouveau client**. Si un scan d'identité attend dans la file, choisissez ce scan dans le menu : Tillor remplit les données à partir du document. Sinon, choisissez **Manuel** et remplissez **Prénom**, **Nom**, **Adresse e-mail** et **Numéro de téléphone**.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Boîte de dialogue Créer un nouveau client" />

Après la création, vous arrivez sur le profil de Jonas. Complétez-y l'adresse. Vous en saurez plus dans [Gestion des clients](/klantenbeheer) et [Scans d'identité](/identiteitsscans).
</Step>
<Step>
### Donnez le terrain 12 à Jonas [#geef-jonas-terrein-12]
Sur son profil, ouvrez l'onglet **Aperçu**, allez à la carte **Occupations** et cliquez sur **Créer une occupation**. Choisissez le terrain 12 sous **Terrain**. Remplissez si nécessaire **Payé jusqu'au**, le **Type** et la **Fréquence de loyer**. Le prix provient par défaut du terrain.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Carte Occupations sur le profil du client" />

Si le terrain 12 a des compteurs, vous pouvez aussi remplir maintenant les **Lectures de compteur de début (optionnel)**. Voir [Occupations](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Faites signer le contrat de location [#laat-het-huurcontract-tekenen]
Allez dans <UIPath>Administration > Signatures</UIPath> et cliquez sur **Demander des signatures**. Choisissez Jonas Maes comme **Client**, téléversez le contrat, ajoutez Jonas comme signataire avec **Client : Jonas Maes** et placez un champ de signature. Ajoutez éventuellement un collaborateur comme second signataire.

<Tabs items={["À distance", "À la réception"]}>
<Tab value="À distance">
Cliquez sur **Envoyer**. Jonas reçoit un e-mail avec un lien personnel, ou un SMS s'il n'y a qu'un numéro de téléphone. Il signe sur son propre appareil et confirme avec un code à 6 chiffres.
</Tab>
<Tab value="À la réception">
Cliquez sur **Envoyer**, ouvrez la demande et cliquez chez Jonas sur **Signer sur tablette**. Choisissez **Avec un code**, ou **Sans code** si vous avez vérifié son identité au comptoir. Le contrat s'ouvre sur la tablette, avec son nom en grandes lettres.
</Tab>
</Tabs>

Tous les détails se trouvent dans [Demander des signatures](/handtekeningen/handtekening-vragen) et [Comment signer](/handtekeningen/ondertekenen).
</Step>
<Step>
### Comptabilisez le droit de stationnement [#boek-het-staangeld]
Retournez à la carte **Occupations** sur le profil de Jonas, ouvrez le menu de l'occupation et choisissez **Prolonger l'occupation (facture)**. Cliquez sur **Créer le brouillon**. Tillor crée une facture brouillon avec le produit ayant l'action **Prolonger l'occupation**. Vérifiez la période sur la facture et cliquez sur **Comptabiliser la facture**.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Facture brouillon avec le bouton Comptabiliser la facture" />

La facture reçoit un numéro de facture et le statut <Status tone="success">Comptabilisé</Status>. Voir [Comptabiliser une facture](/facturen/boeken) et [Prolonger l'occupation](/bezettingen#facturatie-bezetting-verlengen).
</Step>
<Step>
### Choisissez comment Jonas paie [#kies-hoe-jonas-betaalt]
Comptabiliser n'envoie rien au client. Vous choisissez maintenant comment l'argent arrive.

<Tabs items={["Lien de paiement", "Prélèvement avec mandat", "À la réception"]}>
<Tab value="Lien de paiement">
Cliquez sur **Envoyer la notification** et choisissez un canal comme **E-mail**. Jonas reçoit le bouton **Consulter et payer en ligne** et finalise le paiement avec, par exemple, iDEAL ou Bancontact. S'il veut d'abord ne payer qu'une partie, créez un [lien pour un paiement partiel](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Voir [Payer en ligne](/betalingsverwerking/online).
</Tab>
<Tab value="Prélèvement avec mandat">
Demandez d'abord un mandat via <UIPath>Clients > Jonas Maes > Facturation</UIPath> et **Créer un mandat**. Dès que le statut est <Status tone="success">Actif</Status>, vous choisissez ce mandat sur la facture sous **Mandat de prélèvement**. Tillor prélève alors le montant deux jours après la comptabilisation, ou deux jours après l'association si la facture était déjà comptabilisée. Voir [Faire signer un mandat SEPA](/betalingsverwerking/mandaat) et [Prélever une facture](/betalingsverwerking/incasso).
</Tab>
<Tab value="À la réception">
Cliquez sur **Effectuer un paiement** et choisissez **Terminal**, **Espèces** ou **Virement**. Voir [Enregistrer un paiement](/betalingsverwerking/betaling-registreren).
</Tab>
</Tabs>
</Step>
<Step>
### Voyez arriver le paiement [#zie-de-betaling-binnenkomen]
Sous <UIPath>Administration > Paiements</UIPath> se trouve le paiement. Un paiement en ligne apparaît dès que Mollie le confirme. Un prélèvement a d'abord le statut <Status tone="warning">En attente</Status> et devient <Status tone="success">Payé</Status> après quelques jours. Quand tout est rentré, la facture passe à <Status tone="success">Payé</Status>.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Aperçu de tous les paiements" />

Vous en saurez plus dans [Retrouver des paiements](/betalingsverwerking/betalingen-bekijken).
</Step>
<Step>
### Voyez le paiement dans le rapport de paiement [#zie-de-betaling-in-het-betalingsrapport]
Allez dans <UIPath>Administration > Rapports de paiement</UIPath>. Les paiements du jour figurent sur le rapport avec le statut **Brouillon**. Tillor finalise le rapport lors du prochain contrôle quotidien, les jours ouvrables à 09:00. Si votre liaison comptable est active, Tillor transmet lui-même le rapport.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Liste des rapports de paiement" />

Voir [Rapports de paiement](/boekhouden/betalingsrapporten).
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- L'occupation de Jonas est en cours. Le terrain 12 n'est plus disponible pour d'autres clients et la consommation des compteurs du terrain va à Jonas.
- Dès que tout le monde a signé, la demande passe à <Status tone="success">Terminée</Status>. Le PDF signé avec les pages de preuve se trouve dans ses **Documents**. Si vous voulez qu'une automatisation fasse alors quelque chose, par exemple créer une tâche, utilisez le déclencheur **Demande de signature terminée**.
- Lors de la comptabilisation de la facture, Tillor place **Facturé jusqu'au** à la fin de la ligne de facture. Après le paiement, **Payé jusqu'au** avance. Voir [Payé jusqu'au, type, fréquence de loyer et prix](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).
- La saison suivante, vous prolongez la même occupation avec **Prolonger l'occupation (facture)**, ou pour toutes les occupations d'un client à la fois avec **Tout prolonger**.
- Les paiements Mollie figurent sur le rapport brouillon comme avance sur Mollie, jusqu'à ce que le versement soit connu.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le terrain 12 n'est pas dans la liste de Créer une occupation">
Un terrain ne peut être associé qu'à un seul client à la fois. S'il y a déjà une occupation active, il n'apparaît pas dans la liste. Terminez d'abord cette occupation, voir [Terminer une occupation](/bezettingen#een-bezetting-beëindigen).
</Accordion>
<Accordion title="Je ne peux pas envoyer la demande de signature">
Tillor contrôle la demande et indique ce qui manque : un signataire sans champ de signature, un signataire sans adresse e-mail ni numéro de téléphone, ou un titre vide. Corrigez et réessayez. Voir [Demander des signatures](/handtekeningen/handtekening-vragen#problemen).
</Accordion>
<Accordion title="Le bouton Comptabiliser la facture est grisé">
Passez la souris sur le bouton, Tillor affiche la raison. Il manque souvent une date de début ou de fin sur une ligne avec une occupation, ou le montant dépasse le maximum du mandat associé. Voir [Quand la comptabilisation échoue](/facturen/boeken#problemen).
</Accordion>
<Accordion title="Prolonger l'occupation (facture) ne donne pas de facture utilisable">
Il doit exister au moins un produit avec l'action **Prolonger l'occupation**. Sans un tel produit, Tillor ne peut pas construire la ligne. Créez le produit ou ajoutez l'action, voir [Associer des actions à un produit](/producten/acties-instellen).
</Accordion>
<Accordion title="Mandat SEPA est grisé sous Effectuer un paiement">
Jonas n'a pas de mandat avec le statut <Status tone="success">Actif</Status> dont le montant maximum est assez élevé. Vérifiez la carte **Mandats** dans son onglet **Facturation**.
</Accordion>
<Accordion title="La facture est En attente">
Le paiement est lancé, mais l'argent n'est pas encore définitivement rentré. C'est normal pour un prélèvement. Dès que le paiement est traité, le statut passe à **Payé**. Voir [Statuts](/facturen/statussen).
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Facturer la consommation" href="/praktijk/verbruik-aanrekenen" description="La suite : ce que Jonas consomme en eau et en électricité" />
  <Card title="Occupations" href="/bezettingen" />
  <Card title="Signatures" href="/handtekeningen" />
  <Card title="Factures" href="/facturen" />
  <Card title="Traitement des paiements" href="/betalingsverwerking" />
</Cards>


# Une caravane résidentielle se libère (/fr-FR/praktijk/stacaravan-komt-vrij)

Quand un client quitte une caravane résidentielle, il y a du travail : la caravane doit être contrôlée et la garantie doit être rendue au client. Cet exemple montre comment Tillor rassemble tout cela. Vous arrêtez l'occupation, une automatisation crée une tâche de contrôle, un collègue termine la tâche, puis vous réglez la garantie. Nous utilisons Jonas Maes et le terrain 12 du Recreatiepark Het Meer comme exemple, cette fois comme locataire d'une caravane résidentielle.

```mermaid
flowchart LR
  A[Arrêter l'occupation] --> B[Automatisation]
  B --> C[Tâche de contrôle avec sous-tâches]
  C --> D[Un collègue termine]
  D --> E[Garantie rendue par note de crédit]
```

Avant de commencer :

- Le terrain 12 a le type de terrain **Caravane résidentielle** et Jonas y a une occupation active. Voir [Types de terrain](/terreinen#terreintypes).
- Une automatisation est prête, qui crée une tâche à la fin d'une occupation. Comment la construire se trouve dans [Exemple : contrôle d'une caravane de location](/automatiseringen/voorbeeld-nalopen). Dans les environnements de démonstration, elle est déjà prête sous le nom **Contrôle caravane de location**, en pause, jusqu'à ce que vous activiez l'interrupteur **Actif**.
- Pour la garantie : le produit de garantie a l'option **Surveiller le solde du client sur ce compte** activée. Voir [Surveiller le solde du client](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

## Le parcours étape par étape [#de-route-stap-voor-stap]

<Steps>
<Step>
### Arrêtez l'occupation [#stop-de-bezetting]
Ouvrez le profil de Jonas, allez sous l'onglet **Aperçu** à la carte **Occupations**, ouvrez le menu de l'occupation et choisissez **Supprimer**. Choisissez sous **Date** le jour de son départ. Si le terrain a des compteurs, remplissez les **Lectures de compteur de fin (optionnel)**. Cliquez sur **Supprimer**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu d'actions d'une occupation" />

Le terrain 12 est ensuite de nouveau libre pour une nouvelle occupation. Voir [Terminer une occupation](/bezettingen#een-bezetting-beëindigen).
</Step>
<Step>
### Laissez l'automatisation créer la tâche de contrôle [#laat-de-automatisering-de-nalooptaak-maken]
Vous n'avez rien à faire. L'automatisation démarre dès que l'occupation se termine et vérifie d'abord si le terrain a le type de terrain **Caravane résidentielle**. Ensuite, elle cherche s'il existe déjà une tâche ouverte **Contrôle** pour ce terrain.

- S'il n'y a pas encore de tâche ouverte, elle crée une tâche **Contrôle terrain 12** avec cinq sous-tâches (**Nettoyage**, **Inventaire**, **Internet + TV**, **Cadre code QR** et **Vérifier les petits travaux**) et une échéance à 7 jours. La tâche va aussi au collègue qui a arrêté l'occupation.
- S'il y a déjà une tâche ouverte, par exemple parce que la caravane s'est libérée deux fois à peu d'intervalle, elle n'en crée pas de seconde. La priorité de la tâche existante monte d'un cran, jusqu'à **Haute**.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Étape Créer une tâche de contrôle dans l'automatisation" />

Vous suivez ce que l'automatisation a fait sous [Tests et exécutions](/automatiseringen/testen-en-uitvoeringen).
</Step>
<Step>
### Terminez la tâche [#werk-de-taak-af]
Le collègue trouve la tâche dans la carte **Tâches pour vous** du tableau de bord, sous l'onglet **Tâches** de Jonas, ou dans une vue sous **Tâches**. La tâche est liée au terrain 12 et à Jonas.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Fenêtre de tâche avec description, sous-tâches et propriétés" />

<Tabs items={["Avec des sous-tâches", "Avec des boutons de choix"]}>
<Tab value="Avec des sous-tâches">
Ouvrez la tâche et cochez chaque sous-tâche dès qu'elle est faite. À côté de la tâche figure un compteur comme **2/5**. Quand toutes les sous-tâches sont terminées, mettez le statut sur **Terminé**. Si vous mettez la tâche principale sur **Terminé**, les sous-tâches ouvertes sont terminées avec elle.
</Tab>
<Tab value="Avec des boutons de choix">
Si vous avez étendu l'automatisation avec l'étape **Demander une décision**, par exemple pour décider si la garantie est entièrement remboursée, des boutons figurent sur la tâche sous **Choisissez une action pour terminer cette tâche.** Un clic termine la tâche. Si le choix demande une raison, **Pourquoi ce choix ?** s'ouvre. Un choix effectué ne peut plus être annulé. Voir [Tâches avec boutons de choix](/taken/taakdetails#taken-met-keuzeknoppen) et [Demander une décision](/automatiseringen/logica#vraag-om-een-beslissing).
</Tab>
</Tabs>
</Step>
<Step>
### Vérifiez le solde de la garantie [#controleer-het-saldo-van-de-waarborg]
Ouvrez le profil de Jonas et allez à l'onglet **Facturation**. Dans le tableau **Comptes**, vous voyez le solde par compte. Le compte de la garantie indique ce que Jonas a encore en crédit.
</Step>
<Step>
### Créez la note de crédit pour la garantie [#maak-de-creditnota-voor-de-waarborg]
Ouvrez la facture de garantie de Jonas, cliquez sur les trois points en haut à droite et choisissez **Inverser la facture**. Tillor crée une facture brouillon avec les mêmes lignes en montants négatifs. Si vous retenez une partie, par exemple pour des dégâts, adaptez le montant. Cliquez sur **Comptabiliser la facture**. La facture devient une **Facture de crédit**.

Tillor refuse une facture qui ferait passer le solde du compte de garantie sous zéro. Ainsi, vous ne pouvez pas rembourser une garantie deux fois. Voir [Inverser une facture](/facturen/corrigeren#een-factuur-omkeren).
</Step>
<Step>
### Compensez le montant [#verreken-het-bedrag]
S'il y a encore une facture ouverte de Jonas, par exemple pour la dernière consommation, vous pouvez compenser le montant avec le mode de paiement **Virement interne**. Voir [Créer un virement interne](/betalingsverwerking/interne-overboeking).
</Step>
</Steps>

<Callout type="info" title="Reverser l'argent">
Tillor enregistre la note de crédit et la compensation. Remettre le montant sur le compte bancaire du client se fait via votre banque.
</Callout>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Le terrain est de nouveau libre. Un nouveau client peut y prendre une occupation ou y recevoir une réservation.
- Les périodes de consommation ouvertes de Jonas sont clôturées, avec les relevés de fin que vous avez remplis. La consommation jusqu'à la date de fin est conservée et vous pouvez encore la facturer. Voir [Facturer la consommation](/praktijk/verbruik-aanrekenen).
- La tâche et les actions qui la concernent figurent dans la chronologie de la tâche et sur le profil de Jonas. Les modifications de l'occupation figurent dans son onglet **Événements**.
- La note de crédit part en comptabilité comme n'importe quelle autre facture.

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Aucune tâche de contrôle n'a été créée">
Vérifiez trois choses. L'interrupteur **Actif** de l'automatisation est-il activé ? Le type de terrain du terrain 12 est-il **Caravane résidentielle** ? Regardez sous [Tests et exécutions](/automatiseringen/testen-en-uitvoeringen) si l'automatisation a démarré et où elle s'est arrêtée.
</Accordion>
<Accordion title="Il y a deux tâches de contrôle, ou au contraire une seule">
L'automatisation cherche une tâche ouverte avec exactement le même titre, **Contrôle** suivi du nom du terrain, pour le même terrain, le même client ou la même réservation. Si le titre ne correspond pas, elle ne trouve pas la tâche existante et en crée une nouvelle. Une tâche ouverte reçoit seulement une priorité plus haute, pas de seconde tâche.
</Accordion>
<Accordion title="Je ne peux pas terminer la tâche">
Si vous voyez **Terminée par son automatisation**, seule l'automatisation peut terminer la tâche et la tâche n'a pas de **Supprimer**. Voir [Détails de la tâche](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
<Accordion title="Je ne vois pas les boutons de choix">
Peut choisir la personne à qui la tâche est assignée, ainsi qu'un administrateur. Si personne n'est assigné, toute personne qui voit la tâche peut choisir. S'il y a une coche à la place des boutons, la tâche ne provient pas d'une étape **Demander une décision**.
</Accordion>
<Accordion title="Comptabiliser la facture est grisé pour la note de crédit de la garantie">
Le solde du compte de garantie passerait sous zéro. Vérifiez le tableau **Comptes** et le montant de la facture. Avec le droit **Outrepasser le solde du compte**, vous pouvez quand même comptabiliser, avec une justification qui figure dans la chronologie de la facture.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Exemple : contrôle d'une caravane de location" href="/automatiseringen/voorbeeld-nalopen" description="Voici comment construire vous-même l'automatisation" />
  <Card title="Tâches" href="/taken" />
  <Card title="Corriger une facture" href="/facturen/corrigeren" />
  <Card title="Occupations" href="/bezettingen" />
</Cards>


# Facturer la consommation (/fr-FR/praktijk/verbruik-aanrekenen)

Facturer la consommation fonctionne dans Tillor via le terrain : un compteur appartient à un terrain, un client arrive sur le terrain via une occupation, et la consommation du compteur va à ce client. Cet exemple suit le compteur d'électricité du terrain 12 du Recreatiepark Het Meer, de l'association à la facture de Jonas Maes. À la fin, vous verrez comment Tillor peut aussi créer et envoyer cette facture lui-même.

```mermaid
flowchart LR
  A[Compteur] -->|associer| B[Terrain 12]
  B --- C[Occupation de Jonas]
  A -->|relevés de compteur| D[Consommation de Jonas]
  D --> E[Consommation impayée]
  E --> F[Facture]
  F -.->|automatique| G[Facture de services à jour fixe]
```

Avant de commencer :

- Le compteur existe déjà sous <UIPath>Parc > Compteurs</UIPath> et n'est pas encore associé à un terrain. Un compteur déjà rattaché à un terrain n'apparaît pas dans la liste de choix.
- Jonas a une occupation active sur le terrain 12. Voir [Accueillir un client saisonnier](/praktijk/seizoensklant-binnenhalen). Sans occupation, Tillor ne sait pas à qui revient la consommation.
- Pour la facture automatique, Jonas a besoin d'une adresse e-mail ou d'un numéro de téléphone, et pour le prélèvement automatique d'un mandat actif.

## Le parcours étape par étape [#de-route-stap-voor-stap]

<Steps>
<Step>
### Associez le compteur au terrain 12 [#koppel-de-meter-aan-terrein-12]
Allez dans <UIPath>Parc > Terrains</UIPath>, ouvrez le terrain 12 et faites défiler jusqu'à la carte **Compteurs**. Cliquez sur **Ajouter un compteur**, choisissez le compteur et cliquez sur **Assigner le compteur**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Page de détail du terrain 12 avec la carte Compteurs" />

Voir [Gestion des compteurs](/meterbeheer/meter-koppelen) et [Terrains](/terreinen).
</Step>
<Step>
### Enregistrez le relevé de départ [#leg-de-beginstand-vast]
Si Jonas est déjà inscrit sur le terrain 12, vous remplissez le relevé de départ dans l'occupation. Si vous créez seulement maintenant l'occupation, remplissez **Lectures de compteur de début (optionnel)**. Si vous le laissez vide, Tillor reprend le dernier relevé connu. Ainsi, le premier lot de consommation démarre tout de suite au bon relevé. Voir [Occupations](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Suivez les relevés de compteur [#volg-de-meterstanden]
Les compteurs intelligents transmettent eux-mêmes leur relevé, le plus souvent chaque jour ou chaque semaine. Un compteur manuel, vous le relevez et le saisissez vous-même. Voir [Gestion des compteurs](/meterbeheer).

Vous voyez la consommation à deux endroits. Sur la page du compteur sous <UIPath>Parc > Compteurs</UIPath> se trouve la carte **Consommation**, avec par client la consommation impayée et réglée. Sur le profil de Jonas se trouve la carte **Lectures**, avec tous les compteurs de ses terrains.

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Page du compteur avec la carte Consommation" />

Si quelqu'un saisit un relevé inférieur au précédent, Tillor avertit. Si le relevé est pourtant correct (le compteur a été remplacé), Tillor clôture la période en cours et en commence une nouvelle. Voir [Lots de consommation](/meterbeheer/consumptie-batches).
</Step>
<Step>
### Regardez ce qui est impayé [#bekijk-wat-openstaat]
Allez dans <UIPath>Clients > Consommation impayée</UIPath>. Vous voyez par client le montant total, la **Dernière facture utilities** et le nombre de compteurs. Jonas y figure dès qu'il y a de la consommation qui n'est pas encore sur une facture.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Aperçu des clients avec consommation impayée" />
</Step>
<Step>
### Créez la facture [#maak-de-factuur]
Vous avez deux manières.

<Tabs items={["Depuis la liste", "Depuis le profil du client"]}>
<Tab value="Depuis la liste">
Cliquez à la fin de la ligne de Jonas sur l'icône d'envoi. La fenêtre **Créer la facture** affiche le montant total, la répartition par type et le nombre de compteurs. Cochez les canaux par lesquels Tillor envoie tout de suite la facture et cliquez sur **Créer la facture**. Tillor crée la facture, la comptabilise et l'envoie. Si Jonas a un mandat pour les factures de services, celui-ci est présélectionné sous **Prélever via mandat**.
</Tab>
<Tab value="Depuis le profil du client">
Ouvrez le profil de Jonas et cliquez dans la carte **Lectures** sur **Facturer la consommation**. Tillor place par période de consommation une ligne principale avec en dessous une ligne d'information contenant la date et les relevés de compteur. S'il existe déjà une facture brouillon adaptée, les lignes y sont ajoutées. Vérifiez la facture, comptabilisez-la et envoyez-la vous-même. Voir [Comptabiliser une facture](/facturen/boeken) et [Envoyer une facture](/facturen/versturen).
</Tab>
</Tabs>
</Step>
<Step>
### Laissez Tillor le faire lui-même [#laat-tillor-het-zelf-doen]
Ouvrez le profil de Jonas, allez dans <UIPath>Clients > Jonas Maes > Facturation</UIPath> et ouvrez la carte **Paramètres de facturation**. Vous y réglez :

- **Facturation automatique des services publics** : un jour du mois. Si vous choisissez le 31 et que le mois n'a pas 31 jours, la facture part le dernier jour du mois.
- **Mandat** : le mandat avec lequel Tillor prélève la facture de services. Voir [Prélever une facture](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
- **Montant minimum** : un seuil propre à Jonas. Si vous le laissez vide, c'est le minimum de l'organisation qui s'applique, sous <UIPath>Support > Paramètres > Facturation</UIPath>.

Le jour choisi, Tillor crée lui-même la facture et l'envoie. Si le montant impayé est sous le minimum, Tillor attend un prochain jour de facturation.
</Step>
</Steps>

## Que se passe-t-il ensuite ? [#wat-gebeurt-er-daarna]

- Les périodes de consommation facturées sont terminées. Si l'occupation se poursuit, Tillor démarre une nouvelle période au relevé de fin de la précédente, de sorte qu'il n'y ait pas de trou.
- Une fois la facture comptabilisée, elle suit son cours comme n'importe quelle autre facture : paiement, rappel et rapport de paiement. Voir [Accueillir un client saisonnier](/praktijk/seizoensklant-binnenhalen).
- À la fin de l'occupation, Tillor clôture les périodes ouvertes. La consommation jusqu'à la date de fin est conservée et vous pouvez encore la facturer.
- Si vous supprimez une facture brouillon avec de la consommation, la consommation revient dans **Consommation impayée**.

<Callout type="info" title="Consommation bien supérieure à l'habitude">
Si la consommation impayée d'électricité ou d'eau est au moins le double de ce que Jonas consomme habituellement, Tillor ne crée pas la facture automatique. Vous recevez un e-mail à l'adresse de support de l'organisation. Vérifiez le relevé de compteur et facturez vous-même la consommation si tout est correct.
</Callout>

## Un problème ? [#problemen]

<Accordions>
<Accordion title="Le compteur n'est pas dans la liste de Ajouter un compteur">
La liste n'affiche que les compteurs sans terrain. Si le compteur est déjà rattaché à un autre terrain, détachez-le d'abord via le menu du compteur sur ce terrain, avec **Détacher du terrain**.
</Accordion>
<Accordion title="Jonas n'a pas de consommation sur le compteur du terrain 12">
La consommation va au client qui a une occupation active sur le terrain. Vérifiez que Jonas a une occupation sur le terrain 12 et que le compteur est rattaché au terrain.
</Accordion>
<Accordion title="Jonas ne figure pas dans Consommation impayée">
La liste n'affiche par défaut que les clients sans facturation automatique. Mettez le filtre **Facturation automatique** sur **Avec date** pour voir les clients qui ont un jour de facturation automatique.
</Accordion>
<Accordion title="La facture automatique n'a pas été créée">
Il y a deux raisons fréquentes. Le montant impayé est sous le minimum, alors Tillor attend un prochain jour de facturation. Ou la consommation est bien supérieure à l'habitude, alors vous recevez un e-mail à l'adresse de support et la facture n'est pas créée tant que quelqu'un ne l'a pas vérifiée. Voir [Gestion des compteurs](/meterbeheer/verbruik-factureren#automatisch-factureren).
</Accordion>
<Accordion title="J'ai déjà facturé la consommation en dehors de Tillor">
Ouvrez la période dans la carte **Lectures** ou **Consommation**, cliquez sur l'icône d'avertissement à côté de la période et confirmez avec **Oui, marquer comme facturée**. La période se clôture alors sans facture. Vous ne pouvez l'annuler que pour les périodes sans lien avec une facture.
</Accordion>
</Accordions>

## Voir aussi [#zie-ook]

<Cards>
  <Card title="Gestion des compteurs" href="/meterbeheer" />
  <Card title="Lots de consommation" href="/meterbeheer/consumptie-batches" description="Comment les périodes de consommation sont suivies et facturées" />
  <Card title="Prélever une facture" href="/betalingsverwerking/incasso" />
  <Card title="Paramètres de facturation" href="/gebruikers/instellingen-facturatie" />
</Cards>