Metadados do Mollie
Espaço de nomes tillor nos pagamentos Mollie para ligação, grupos e contabilidade
Última atualização em
O Mollie guarda metadados em cada pagamento. O Tillor lê e escreve campos no espaço de nomes tillor. Ligação na aplicação: Mollie.
Três tipos:
- Metadados de ligação - o Tillor escreve de volta no Mollie para que o pagamento seja reconhecível
- Sugestões de ingestão - define-as ao criar o pagamento Mollie
- Metadados contabilísticos diretos - contornam o Tillor e vão diretamente para a contabilidade
Metadados de ligação
{
"tillor": {
"paymentId": "clx123...",
"invoiceId": "clx456...",
"customerId": "clx789...",
"paymentGroupId": "clxgrp..."
}
}O Tillor escreve paymentId, invoiceId, customerId e paymentGroupId no Mollie assim que um pagamento fica associado a uma fatura, a um cliente ou a um grupo de pagamentos. Os metadados existentes que não sejam do Tillor mantêm-se.
| Campo | Descrição |
|---|---|
paymentId | Pagamento do Tillor |
invoiceId | Fatura do Tillor |
customerId | Cliente do Tillor |
paymentGroupId | Grupo de pagamentos, mesmo que esse grupo ainda não esteja associado a uma fatura |
Sugestão de ingestão: descriptionSuffix
Define-a você ao criar o pagamento Mollie. O Tillor usa-a na descrição do pagamento assim que existir uma ligação a uma fatura.
{
"tillor": {
"descriptionSuffix": "Parkeerplaats P1"
}
}Formato no Tillor: INV/XXXX/XXXX - {suffix}.
Sugestões de ingestão para grupos de pagamentos
Útil para turnos de POS ou atividades: agrupar vários pagamentos antes de lançar uma fatura.
{
"tillor": {
"paymentGroupName": "Yoga sunrise - Lake Como",
"paymentGroupExternalId": "act_42"
}
}Basta um dos dois campos. Ambos em conjunto é melhor quando a etiqueta pode mudar mas o ID se mantém estável.
| Campo | Descrição |
|---|---|
paymentGroupName | Etiqueta visível no Tillor. Corresponde a grupos abertos existentes pelo nome ou torna-se a etiqueta de um novo grupo |
paymentGroupExternalId | Chave estável do seu sistema. A correspondência faz-se por ela em vez do nome; a etiqueta segue paymentGroupName |
- O Tillor procura um grupo aberto com este ID externo (ou, sem ID, com este nome).
- Sem correspondência? Novo grupo aberto. O nome é
paymentGroupName, caso contráriopaymentGroupExternalId. - O pagamento entra no grupo assim que estiver pago no Tillor.
- Os grupos que já estão associados a uma fatura não são reutilizados.
As sugestões ainda não estavam no pagamento Mollie quando o Tillor o viu pela primeira vez? O grupo é preenchido mesmo assim, assim que o pagamento estiver pago, não esteja associado a uma fatura e ainda não esteja num grupo. Isto acontece na sincronização seguinte ou numa notificação recebida do Mollie.
Quando usar?
Marque previamente cada pagamento Mollie a partir do seu POS. O grupo aparece em Administração > Pagamentos, secção Grupos de pagamentos.
Não combinar com invoiceId
Um pagamento agrupado não pode ficar associado a uma fatura isoladamente. Se enviar tanto sugestões de grupo como invoiceId, o grupo prevalece.
Metadados contabilísticos diretos (tillor.bookkeeping)
Por defeito, os pagamentos Mollie desconhecidos vão para a conta de espera 499000. Com tillor.bookkeeping, o Tillor lança-os no cliente indicado:
{
"tillor": {
"bookkeeping": {
"customerCode": "100001",
"documentType": "INV",
"department": "a",
"fiscalYear": "2026",
"documentNumber": "00042"
}
}
}| Campo | Descrição |
|---|---|
customerCode | Código do cliente na contabilidade - obrigatório |
documentType | Por ex. INV, UF |
department | Departamento |
fiscalYear | Ano fiscal |
documentNumber | Número do documento |
Quando bookkeeping está presente, o pagamento não entra como um pagamento Tillor normal. Os metadados são usados ao construir o relatório contabilístico.