Métadonnées Mollie
Espace de noms tillor sur les paiements Mollie pour la liaison, les groupes et la comptabilité
Dernière mise à jour le
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.
Trois types :
- Métadonnées de liaison - Tillor les réécrit dans Mollie pour que le paiement soit reconnaissable
- Indications d'ingestion - vous les ajoutez lors de la création du paiement Mollie
- Métadonnées comptables directes - contournement de Tillor vers la comptabilité
Métadonnées de liaison
{
"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. 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
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.
{
"tillor": {
"descriptionSuffix": "Parkeerplaats P1"
}
}Format dans Tillor : INV/XXXX/XXXX - {suffix}.
Indications d'ingestion pour les groupes de paiements
Pratique pour les shifts de caisse ou les activités : regrouper plusieurs paiements avant de comptabiliser une facture.
{
"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 |
- Tillor cherche un groupe ouvert avec cet ID externe (ou, sans ID, avec ce nom).
- Aucune correspondance ? Un nouveau groupe ouvert est créé. Son nom est
paymentGroupName, sinonpaymentGroupExternalId. - Le paiement rejoint le groupe dès qu'il est payé dans Tillor.
- 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.
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.
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.
Métadonnées comptables directes (tillor.bookkeeping)
Par défaut, les paiements Mollie inconnus vont sur le compte d'attente 499000. Avec tillor.bookkeeping, Tillor les comptabilise sur le client indiqué :
{
"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.