Metadati Mollie
Namespace tillor sui pagamenti Mollie per collegamento, gruppi e contabilità
Ultimo aggiornamento il
Mollie salva dei metadati per ogni pagamento. Tillor legge e scrive i campi nel namespace tillor. Collegamento nell'app: Mollie.
Tre tipi:
- Metadati di collegamento - Tillor li riscrive su Mollie, così il pagamento è riconoscibile
- Suggerimenti di acquisizione - li imposti tu quando crei il pagamento Mollie
- Metadati contabili diretti - bypass da Tillor verso la contabilità
Metadati di collegamento
{
"tillor": {
"paymentId": "clx123...",
"invoiceId": "clx456...",
"customerId": "clx789...",
"paymentGroupId": "clxgrp..."
}
}Tillor riscrive paymentId, invoiceId, customerId e paymentGroupId su Mollie non appena un pagamento è collegato a una fattura, a un cliente o a un gruppo di pagamento. I metadati esistenti non provenienti da Tillor restano invariati.
| Campo | Descrizione |
|---|---|
paymentId | Pagamento Tillor |
invoiceId | Fattura Tillor |
customerId | Cliente Tillor |
paymentGroupId | Gruppo di pagamento, anche se il gruppo non è ancora collegato a una fattura |
Suggerimento di acquisizione: descriptionSuffix
Lo imposti tu quando crei il pagamento Mollie. Tillor lo usa per la descrizione del pagamento non appena esiste un collegamento a una fattura.
{
"tillor": {
"descriptionSuffix": "Parkeerplaats P1"
}
}Formato in Tillor: INV/XXXX/XXXX - {suffix}.
Suggerimenti di acquisizione per i gruppi di pagamento
Utile per i turni POS o le attività: raggruppa più pagamenti prima di registrare una fattura.
{
"tillor": {
"paymentGroupName": "Yoga sunrise - Lake Como",
"paymentGroupExternalId": "act_42"
}
}Basta uno dei due campi. Meglio usarli entrambi se l'etichetta può cambiare ma l'ID resta stabile.
| Campo | Descrizione |
|---|---|
paymentGroupName | Etichetta visibile in Tillor. Corrisponde ai gruppi aperti esistenti per nome, oppure diventa l'etichetta di un nuovo gruppo |
paymentGroupExternalId | Chiave stabile del tuo sistema. La corrispondenza avviene su questa invece che sul nome; l'etichetta segue paymentGroupName |
- Tillor cerca un gruppo aperto con questo ID esterno (o, senza ID, con questo nome).
- Nessuna corrispondenza? Nuovo gruppo aperto. Il nome è
paymentGroupName, altrimentipaymentGroupExternalId. - Il pagamento entra nel gruppo non appena in Tillor risulta pagato.
- I gruppi già collegati a una fattura non vengono riutilizzati.
I suggerimenti non erano ancora sul pagamento Mollie quando Tillor ha visto il pagamento per la prima volta? Il gruppo viene comunque riempito non appena il pagamento è pagato, non è collegato a una fattura e non è ancora in un gruppo. Succede alla sincronizzazione successiva o con una notifica Mollie in arrivo.
Quando usarli?
Assegna in anticipo i tag a ogni pagamento Mollie dal tuo POS. Il gruppo compare in Amministrazione > Pagamenti, nella sezione Gruppi di pagamento.
Da non combinare con invoiceId
Un pagamento raggruppato non può essere collegato singolarmente a una fattura. Se invii sia i suggerimenti di gruppo sia invoiceId, vince il gruppo.
Metadati contabili diretti (tillor.bookkeeping)
I pagamenti Mollie sconosciuti vanno per impostazione predefinita sul conto transitorio 499000. Con tillor.bookkeeping Tillor li registra sul cliente indicato:
{
"tillor": {
"bookkeeping": {
"customerCode": "100001",
"documentType": "INV",
"department": "a",
"fiscalYear": "2026",
"documentNumber": "00042"
}
}
}| Campo | Descrizione |
|---|---|
customerCode | Codice cliente nella contabilità - obbligatorio |
documentType | Ad es. INV, UF |
department | Reparto |
fiscalYear | Anno contabile |
documentNumber | Numero documento |
Se bookkeeping è presente, il pagamento non arriva come normale pagamento Tillor. I metadati vengono usati nella creazione del report contabile.