Skip to Content

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:

  1. Metadados de ligação - o Tillor escreve de volta no Mollie para que o pagamento seja reconhecível
  2. Sugestões de ingestão - define-as ao criar o pagamento Mollie
  3. 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.

CampoDescrição
paymentIdPagamento do Tillor
invoiceIdFatura do Tillor
customerIdCliente do Tillor
paymentGroupIdGrupo 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.

CampoDescrição
paymentGroupNameEtiqueta visível no Tillor. Corresponde a grupos abertos existentes pelo nome ou torna-se a etiqueta de um novo grupo
paymentGroupExternalIdChave estável do seu sistema. A correspondência faz-se por ela em vez do nome; a etiqueta segue paymentGroupName
  1. O Tillor procura um grupo aberto com este ID externo (ou, sem ID, com este nome).
  2. Sem correspondência? Novo grupo aberto. O nome é paymentGroupName, caso contrário paymentGroupExternalId.
  3. O pagamento entra no grupo assim que estiver pago no Tillor.
  4. 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"
    }
  }
}
CampoDescrição
customerCodeCódigo do cliente na contabilidade - obrigatório
documentTypePor ex. INV, UF
departmentDepartamento
fiscalYearAno fiscal
documentNumberNú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.

Ver também

Esta página foi útil?

Nesta página