Mollie-Metadaten

Mollie speichert Metadaten zu jeder Zahlung. Tillor liest und schreibt Felder im tillor-Namespace. Verknüpfung in der App: Mollie.

Es gibt drei Arten:

1. Verknüpfungsmetadaten - Tillor schreibt sie zurück an Mollie, damit die Zahlung erkennbar ist
2. Ingestion-Hinweise - Sie setzen sie beim Anlegen der Mollie-Zahlung
3. Direkte Buchhaltungsmetadaten - Umgehung von Tillor Richtung Buchhaltung

VerknüpfungsmetadatenLink zu diesem Abschnitt kopieren

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

Tillor schreibt paymentId, invoiceId, customerId und paymentGroupId an Mollie zurück, sobald eine Zahlung an einer Rechnung, einem Kunden oder einer Zahlungsgruppe hängt. Bestehende Nicht-Tillor-Metadaten bleiben erhalten.

Ingestion-Hinweis: descriptionSuffixLink zu diesem Abschnitt kopieren

Sie setzen ihn selbst beim Anlegen der Mollie-Zahlung. Tillor verwendet ihn für die Zahlungsbeschreibung, sobald eine Rechnungsverknüpfung besteht.

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

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

Ingestion-Hinweise für ZahlungsgruppenLink zu diesem Abschnitt kopieren

Praktisch für POS-Schichten oder Aktivitäten: Mehrere Zahlungen bündeln, bevor Sie eine Rechnung buchen.

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

Eines der beiden Felder genügt. Beide zusammen sind besser, wenn sich die Bezeichnung ändern kann, die ID aber stabil bleibt.

1. Tillor sucht eine offene Gruppe mit dieser externen ID (oder, ohne ID, mit diesem Namen).
2. Kein Treffer? Neue offene Gruppe. Der Name ist paymentGroupName, sonst paymentGroupExternalId.
3. Die Zahlung kommt in die Gruppe, sobald sie in Tillor bezahlt ist.
4. Gruppen, die bereits an einer Rechnung hängen, werden nicht wiederverwendet.

Waren die Hinweise noch nicht an der Mollie-Zahlung gesetzt, als Tillor die Zahlung zum ersten Mal sah? Dann wird die Gruppe trotzdem noch befüllt, sobald die Zahlung bezahlt ist, nicht an einer Rechnung hängt und noch in keiner Gruppe ist. Das geschieht bei der nächsten Synchronisierung oder bei einer eingehenden Mollie-Benachrichtigung.

Direkte Buchhaltungsmetadaten (tillor.bookkeeping)Link zu diesem Abschnitt kopieren

Unbekannte Mollie-Zahlungen gehen standardmäßig auf das Wartekonto 499000. Mit tillor.bookkeeping bucht Tillor sie auf den angegebenen Kunden:

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

Wenn bookkeeping vorhanden ist, kommt die Zahlung nicht als gewöhnliche Tillor-Zahlung herein. Die Metadaten werden beim Erstellen des Buchhaltungsberichts verwendet.

Siehe auchLink zu diesem Abschnitt kopieren