Mollie-metadata

Mollie slaat metadata op bij elke betaling. Tillor leest en schrijft velden in de tillor-namespace. Koppeling in de app: Mollie.

Drie soorten:

1. Koppelingsmetadata - Tillor schrijft terug naar Mollie zodat de betaling herkenbaar is
2. Ingestie-hints - jij zet ze bij het aanmaken van de Mollie-betaling
3. Directe boekhoudmetadata - bypass van Tillor naar de boekhouding

Koppelingsmetadata

{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "clxgrp..."
  }
}

Tillor schrijft paymentId, invoiceId, customerId en paymentGroupId bij naar Mollie zodra een betaling aan een factuur, klant of betalingsgroep hangt. Bestaande niet-Tillor metadata blijft staan.

Ingestie-hint: descriptionSuffix

Zet je zelf bij het aanmaken van de Mollie-betaling. Tillor gebruikt het voor de betalingsbeschrijving zodra er een factuurkoppeling is.

{
  "tillor": {
    "descriptionSuffix": "Parkeerplaats P1"
  }
}

Formaat in Tillor: INV/XXXX/XXXX - {suffix}.

Ingestie-hints voor betalingsgroepen

Handig voor POS-shifts of activiteiten: meerdere betalingen bundelen vóór je een factuur boekt.

{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}

Eén van beide velden is genoeg. Beide samen is beter als het label kan veranderen maar het ID stabiel blijft.

1. Tillor zoekt een open groep met deze externe ID (of, zonder ID, met deze naam).
2. Geen match? Nieuwe open groep. Naam is paymentGroupName, anders paymentGroupExternalId.
3. De betaling komt in de groep zodra ze in Tillor betaald is.
4. Groepen die al aan een factuur hangen worden niet hergebruikt.

Stonden de hints nog niet op de Mollie-betaling toen Tillor de betaling voor het eerst zag? De groep wordt alsnog gevuld zodra de betaling betaald is, niet aan een factuur hangt en nog niet in een groep zit. Dat gebeurt bij de volgende synchronisatie of bij een inkomende Mollie-melding.

Directe boekhoudmetadata (tillor.bookkeeping)

Onbekende Mollie-betalingen gaan standaard naar wachtrekening 499000. Met tillor.bookkeeping boekt Tillor ze op de opgegeven klant:

{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}

Als bookkeeping aanwezig is, komt de betaling niet als gewone Tillor-betaling binnen. De metadata wordt gebruikt bij het bouwen van het boekhoudrapport.