Metadatos de Mollie
Espacio de nombres tillor en los pagos de Mollie para la conexión, los grupos y la contabilidad
Última actualización el
Mollie guarda metadatos en cada pago. Tillor lee y escribe campos en el espacio de nombres tillor. Conexión en la app: Mollie.
Hay tres tipos:
- Metadatos de conexión - Tillor los escribe de vuelta en Mollie para que el pago sea reconocible
- Pistas de ingestión - las pones tú al crear el pago en Mollie
- Metadatos contables directos - saltan Tillor y van directamente a la contabilidad
Metadatos de conexión
{
"tillor": {
"paymentId": "clx123...",
"invoiceId": "clx456...",
"customerId": "clx789...",
"paymentGroupId": "clxgrp..."
}
}Tillor escribe paymentId, invoiceId, customerId y paymentGroupId en Mollie en cuanto un pago está vinculado a una factura, a un cliente o a un grupo de pagos. Los metadatos existentes que no son de Tillor se conservan.
| Campo | Descripción |
|---|---|
paymentId | Pago de Tillor |
invoiceId | Factura de Tillor |
customerId | Cliente de Tillor |
paymentGroupId | Grupo de pagos, incluso si ese grupo aún no está vinculado a una factura |
Pista de ingestión: descriptionSuffix
La pones tú al crear el pago en Mollie. Tillor la usa para la descripción del pago en cuanto hay una factura vinculada.
{
"tillor": {
"descriptionSuffix": "Parkeerplaats P1"
}
}Formato en Tillor: INV/XXXX/XXXX - {suffix}.
Pistas de ingestión para grupos de pagos
Útil para turnos de TPV o actividades: agrupa varios pagos antes de contabilizar una factura.
{
"tillor": {
"paymentGroupName": "Yoga sunrise - Lake Como",
"paymentGroupExternalId": "act_42"
}
}Basta con uno de los dos campos. Usar ambos es mejor si la etiqueta puede cambiar pero el ID se mantiene estable.
| Campo | Descripción |
|---|---|
paymentGroupName | Etiqueta visible en Tillor. Coincide por nombre con grupos abiertos existentes, o se convierte en la etiqueta de un grupo nuevo |
paymentGroupExternalId | Clave estable de tu sistema. Se busca por ella en lugar de por nombre; la etiqueta sigue a paymentGroupName |
- Tillor busca un grupo abierto con este ID externo (o, sin ID, con este nombre).
- ¿No hay coincidencia? Se crea un grupo abierto nuevo. El nombre es
paymentGroupName; si no,paymentGroupExternalId. - El pago entra en el grupo en cuanto está pagado en Tillor.
- Los grupos que ya están vinculados a una factura no se reutilizan.
¿Las pistas no estaban aún en el pago de Mollie cuando Tillor lo vio por primera vez? El grupo se rellena igualmente en cuanto el pago está pagado, no está vinculado a una factura y todavía no está en ningún grupo. Esto ocurre en la siguiente sincronización o con una notificación entrante de Mollie.
¿Cuándo usarlo?
Etiqueta de antemano cada pago de Mollie desde tu TPV. El grupo aparece en Administración > Pagos, sección Grupos de pago.
No lo combines con invoiceId
Un pago agrupado no puede vincularse por separado a una factura. Si envías tanto pistas de grupo como invoiceId, gana el grupo.
Metadatos contables directos (tillor.bookkeeping)
Los pagos de Mollie desconocidos van por defecto a la cuenta de espera 499000. Con tillor.bookkeeping, Tillor los contabiliza en el cliente indicado:
{
"tillor": {
"bookkeeping": {
"customerCode": "100001",
"documentType": "INV",
"department": "a",
"fiscalYear": "2026",
"documentNumber": "00042"
}
}
}| Campo | Descripción |
|---|---|
customerCode | Código de cliente en la contabilidad - obligatorio |
documentType | P. ej. INV, UF |
department | Departamento |
fiscalYear | Ejercicio contable |
documentNumber | Número de documento |
Si bookkeeping está presente, el pago no entra como un pago normal de Tillor. Los metadatos se usan al generar el informe contable.