Metadane Mollie
Przestrzeń nazw tillor w płatnościach Mollie dla powiązań, grup i księgowości
Ostatnio zaktualizowano
Mollie zapisuje metadane przy każdej płatności. Tillor odczytuje i zapisuje pola w przestrzeni nazw tillor. Powiązanie w aplikacji: Mollie.
Są trzy rodzaje:
- Metadane powiązania - Tillor zapisuje je z powrotem w Mollie, aby płatność była rozpoznawalna
- Wskazówki ingestii - ustawiasz je przy tworzeniu płatności Mollie
- Bezpośrednie metadane księgowe - pominięcie Tillor w drodze do księgowości
Metadane powiązania
{
"tillor": {
"paymentId": "clx123...",
"invoiceId": "clx456...",
"customerId": "clx789...",
"paymentGroupId": "clxgrp..."
}
}Tillor dopisuje paymentId, invoiceId, customerId i paymentGroupId w Mollie, gdy tylko płatność zostanie powiązana z fakturą, klientem lub grupą płatności. Istniejące metadane inne niż Tillor pozostają bez zmian.
| Pole | Opis |
|---|---|
paymentId | Płatność w Tillor |
invoiceId | Faktura w Tillor |
customerId | Klient w Tillor |
paymentGroupId | Grupa płatności, także gdy grupa nie jest jeszcze powiązana z fakturą |
Wskazówka ingestii: descriptionSuffix
Ustawiasz ją sam przy tworzeniu płatności Mollie. Tillor używa jej w opisie płatności, gdy istnieje powiązanie z fakturą.
{
"tillor": {
"descriptionSuffix": "Parkeerplaats P1"
}
}Format w Tillor: INV/XXXX/XXXX - {suffix}.
Wskazówki ingestii dla grup płatności
Przydatne przy zmianach POS lub aktywnościach: zgrupuj wiele płatności, zanim zaksięgujesz fakturę.
{
"tillor": {
"paymentGroupName": "Yoga sunrise - Lake Como",
"paymentGroupExternalId": "act_42"
}
}Wystarczy jedno z pól. Oba razem są lepsze, gdy etykieta może się zmienić, a ID ma pozostać stabilne.
| Pole | Opis |
|---|---|
paymentGroupName | Widoczna etykieta w Tillor. Dopasowuje istniejące otwarte grupy po nazwie albo staje się etykietą nowej grupy |
paymentGroupExternalId | Stabilny klucz z Twojego systemu. Dopasowanie następuje po nim zamiast po nazwie; etykieta podąża za paymentGroupName |
- Tillor szuka otwartej grupy z tym zewnętrznym ID (lub, bez ID, z tą nazwą).
- Brak dopasowania? Powstaje nowa otwarta grupa. Jej nazwą jest
paymentGroupName, a w razie brakupaymentGroupExternalId. - Płatność trafia do grupy, gdy tylko zostanie w Tillor opłacona.
- Grupy, które są już powiązane z fakturą, nie są ponownie używane.
Jeśli wskazówek nie było jeszcze w płatności Mollie, gdy Tillor zobaczył ją po raz pierwszy, grupa i tak zostanie uzupełniona, gdy płatność będzie opłacona, nie będzie powiązana z fakturą i nie będzie jeszcze w grupie. Dzieje się to przy następnej synchronizacji lub po przychodzącym powiadomieniu z Mollie.
Kiedy tego używać?
Oznaczaj każdą płatność Mollie z poziomu swojego POS. Grupa pojawi się w Administracja > Płatności, w sekcji Grupy płatności.
Nie łącz z invoiceId
Zgrupowanej płatności nie można osobno powiązać z fakturą. Jeśli wyślesz jednocześnie wskazówki grupy i invoiceId, wygrywa grupa.
Bezpośrednie metadane księgowe (tillor.bookkeeping)
Nieznane płatności Mollie trafiają domyślnie na rachunek przejściowy 499000. Dzięki tillor.bookkeeping Tillor księguje je na wskazanego klienta:
{
"tillor": {
"bookkeeping": {
"customerCode": "100001",
"documentType": "INV",
"department": "a",
"fiscalYear": "2026",
"documentNumber": "00042"
}
}
}| Pole | Opis |
|---|---|
customerCode | Kod klienta w księgowości - wymagane |
documentType | Np. INV, UF |
department | Dział |
fiscalYear | Rok obrotowy |
documentNumber | Numer dokumentu |
Jeśli bookkeeping jest obecne, płatność nie trafia do Tillor jako zwykła płatność. Metadane są używane przy tworzeniu raportu księgowego.