Mollie

Mollie-betalingen (iDEAL, creditcard, Bancontact, terminal, enz.) worden gesynchroniseerd in Tillor en gekoppeld aan betalingsrapporten via de Mollie-settlement.

Koppelen in Tillor

1. Ga naar Instellingen > Integraties en kies Mollie in de lijst.
2. Volg de Mollie OAuth-stappen als de koppeling nog niet actief is.
3. Op de detailpagina kiest u onder Websiteprofiel een Hoofdprofiel (het Mollie-websiteprofiel voor betalingen en synchronisatie) en een Standaard terminal (het pinapparaat dat Tillor standaard voorstelt bij facturen).
4. Klik op Opslaan. Zonder beide keuzes werken Mollie-betalingen en terminalbetalingen in Tillor niet.

Statusiconen in de keuzelijsten

Links van de profiel- en terminalnaam staat een gekleurd icoon. Dat is de status bij Mollie, niet de naam zelf.

Kies bij voorkeur een geverifieerd profiel en een actieve terminal. Tillor slaat geen placeholder-keuze op: beide velden moeten een echt Mollie-id hebben voordat betalingen en synchronisatie lopen.

Mollie-settlements

Voor rapportdag D zoekt Tillor een settlement in deze volgorde:

1. Settlement aangemaakt op dag D
2. Anders settlement aangemaakt op dag D+1 (typisch: omzet van D wordt de volgende ochtend uitbetaald)

Vastgelegde regels:

• Elke settlement-id staat op maximaal één betalingsrapport.
• Heeft een rapport al een settlement? Die koppeling blijft; Tillor vervangt ze niet.
• Ontbreken zowel D als D+1 (bijv. weekend): het rapport kan al bestaan met alleen handmatige/bankrekeningbetalingen; zodra Mollie publiceert, vult de dagelijkse synchronisatie Mollie aan.

Voorbeelden

Concreet (D+1): omzet van dinsdag 20 mei staat in settlement stl_6necch, aangemaakt woensdag 21 mei om 06:08. Tillor koppelt stl_6necch aan PAYR/2026/140 (rapportdag 20 mei), niet aan het rapport van 21 mei.

Bestaand rapport: stond PAYR/2026/140 al in Tillor zonder gekoppelde Mollie-afrekening en met twee handmatige regels? Na de synchronisatie wordt stl_6necch alsnog gekoppeld; bestaande regels blijven; Mollie-betalingen uit die settlement komen erbij.

Al gekoppeld: rapport 15 mei heeft al stl_old. Tillor wijzigt die id niet. Losse Mollie-betalingen met dezelfde settlement-id op de betaling worden nog wel gekoppeld via de orphan-stap (onderaan).

Synchronisatie op bestaande rapporten

Na het aanmaken van ontbrekende rapporten zoekt Tillor alleen rapporten zonder gekoppelde Mollie-afrekening in een rollend venster van één kalendermaand vóór gisteren t/m gisteren. Rapporten die al een Mollie-afrekening hebben, worden in deze cron niet opnieuw via de Mollie-settlement-lijst opgehaald.

Betalingen die al een settlementId van Mollie op de betaling hebben, maar nog niet op een rapport staan, worden gekoppeld zodra het rapport dezelfde settlement-id heeft (orphan-stap, voor elk rapport met settlement).

Mollie-betalingen in Tillor

Tillor haalt Mollie-betalingen elke 15 minuten op (per organisatie met actieve Mollie-koppeling). Webhooks van Mollie werken daarnaast direct bij.

Een betaling komt op een rapport als:

• ze in de gekoppelde settlement staat (lijst van Mollie), of
• de betaling al een settlement-id heeft die bij het rapport hoort.

Settlement-betalingen die niet in Tillor bestaan, verschijnen als onbekende Mollie-betaling op het rapport.

Op een betalingsrapport zie je gekoppelde Mollie-betalingen in de tabel Betalingen:

Mollie-metadata

Mollie slaat metadata op bij elke betaling. Tillor gebruikt drie soorten in de tillor-namespace: koppelingsmetadata (Tillor schrijft terug naar Mollie zodat de betaling herkenbaar is), ingestie-hints (jij zet ze bij het aanmaken van de Mollie-betaling om Tillor's gedrag te sturen) en directe boekhoudmetadata (volledige bypass van Tillor naar de boekhouding).

Tillor-koppelingsmetadata

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

Zorgt voor webhook-koppeling en bekende betalingen in het rapport. Tillor schrijft paymentId, invoiceId, customerId en paymentGroupId bij naar Mollie zodra een betaling aan een factuur, klant of betalingsgroep gekoppeld wordt. Bestaande niet-Tillor metadata blijft behouden.

Ingestie-hint: descriptionSuffix

Optioneel veld dat jij bij het aanmaken van de Mollie-betaling zet. Tillor gebruikt het voor de betalingsbeschrijving zodra er een factuurkoppeling is; bij terugschrijven naar Mollie blijft een bestaande suffix behouden.

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

Formaat in Tillor: INV/XXXX/XXXX - {suffix} (bijv. "Parkeerplaats P1" → INV/2024/0001 - Parkeerplaats P1).

Ingestie-hints voor betalingsgroepen

Bij het aanmaken van een Mollie-betaling kun je hints meegeven die Tillor bij ingestie gebruikt om de betaling automatisch in een betalingsgroep te bucketen. Handig voor POS-shifts, activiteitenboekingen, tafelbetalingen, of elk scenario waar je meerdere betalingen wil bundelen voor je een factuur boekt.

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

Eén van beide velden is genoeg om de auto-bucketing te activeren. Beide samen is de aanrader wanneer het label in jouw systeem kan veranderen (activiteitenhernoeming, shift-relabel, ...) maar het onderliggende ID stabiel blijft.

Wat doet Tillor bij ingestie?

1. Tillor zoekt een open betalingsgroep met deze externe ID (of, als paymentGroupExternalId ontbreekt, met deze naam).
2. Geen match? Er wordt een nieuwe open groep aangemaakt. De naam is paymentGroupName als die meegegeven is, anders paymentGroupExternalId.
3. De betaling wordt aan de groep gekoppeld zodra ze de status PAID heeft.
4. Toegewezen groepen (al gekoppeld aan een factuur) worden niet hergebruikt; late betalingen met dezelfde sleutel komen in een verse open groep terecht.

Directe boekhoudmetadata (tillor.bookkeeping)

Onbekende Mollie-betalingen worden standaard op suspense (499000) geboekt. Met tillor.bookkeeping worden ze direct op de opgegeven klant geboekt:

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