Salta al contingut principal
Mirakl

Mirakl Connector: l'avís dels comptes de Finances en comptabilitzar

L'avís surt en prémer Post to Accounting en una liquidació de Mirakl quan la instància té buit almenys un dels seus tres comptes de Finances. Es resol configurant en aquesta instància els comptes que el mateix missatge enumera després de Faltan: i tornant a prémer el botó.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
Mirakl
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
4 min

On surt i què diu

Les liquidacions s'obren des del menú Mirakl › Finances › Settlements & Invoices. A la seva fitxa hi ha el botó Post to Accounting. S'amaga quan la liquidació ja té emplenat el camp Journal Entry; amb els valors per defecte, es veu. En prémer-lo pot aparèixer aquest missatge, que atura l'acció:

Configure the Finance accounts on the Mirakl instance '…' before posting settlements. Missing: …

Esquema fet amb codi del menú de liquidacions, el botó de comptabilitzar i el missatge dels comptes de Finances
Esquema fet amb codi a partir del codi publicat del mòdul (no és una captura d'Odoo): el menú, el botó i el missatge, amb els rètols en anglès del codi, per a Odoo 17, 18, 19 i 20.
Same stock on every Mirakl marketplace, sent from Odoo
Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo en anglès)

El que no t'expliquen d'aquest avís

La condició és només una: algun dels tres comptes està buit

El codi reuneix tres comptes de la instància de Mirakl: Marketplace Clearing Account, Commission Expense Account i Payout / Bank Suspense Account. Si qualsevol d'ells està buit, el mòdul atura l'acció amb l'avís. Amb els tres emplenats, aquest missatge no surt.

El missatge ja et diu què configurar

Després de Faltan: el mòdul escriu el nom de cada compte buit, separats per comes i en l'ordre en què s'han citat més amunt. Entre cometes simples apareix el nom de la instància, així saps quina has d'obrir si en gestiones més d'una.

Per exemple, si estiguessin buits el compte pont del marketplace i el de despeses de comissions, el final del missatge seria Faltan: Cuenta puente del marketplace, Cuenta de gastos de comisiones.

Amb Odoo en castellà el veus com a l'apartat anterior. Aquest esquema reuneix el mateix text en altres idiomes:

Esquema fet amb codi del mateix missatge en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul (no és una captura d'Odoo): el text de l'avís segons l'idioma d'Odoo.

Es comprova abans de calcular cap import

Al codi d'Odoo 20, la comprovació dels comptes va abans de construir les línies de l'assentament. L'avís no depèn, doncs, dels imports de la liquidació. A més, el mòdul exigeix els tres comptes encara que després deixi fora una línia de l'assentament quan el seu import és zero.

Cada compte alimenta una línia concreta de l'assentament

Quan els tres comptes estan emplenats, el codi d'Odoo 20 els reparteix així:

  • Payout / Bank Suspense Account: la línia Mirakl payout (net).
  • Commission Expense Account: la línia Mirakl commission & fees i també la línia Mirakl other / subscription fees, que recull el residu que fa quadrar l'assentament.
  • Marketplace Clearing Account: la línia Mirakl marketplace clearing.

Cadascuna d'aquestes línies només s'afegeix si el seu import no és zero. Si la instància té un compte analític configurat, el codi l'aplica a les dues línies que van al compte de despeses de comissions.

Com queda l'assentament quan els comptes estan complets

A Odoo 20, el codi prepara un assentament de tipus assentament comptable amb la referència Mirakl settlement … i el nom de la liquidació. Va al diari de liquidacions de la instància: si la instància no en té cap, el mòdul en busca o en crea un amb codi MRKL. La data de l'assentament és la de la transacció de pagament de la liquidació; si aquesta falta, fa servir la data de creació i, si tampoc n'hi ha, la d'avui. Si la liquidació està en una divisa diferent de la de l'empresa, les línies es converteixen a la divisa de l'empresa i conserven l'import original.

Què fer, per ordre

  1. Fixa't en el nom de la instància entre cometes i en els comptes que surten després de Faltan:.
  2. Obre aquesta instància de Mirakl i configura aquests comptes de Finances.
  3. Torna a la liquidació, des de Mirakl › Finances › Settlements & Invoices, i prem de nou Post to Accounting.
  4. Si la liquidació continua sense Journal Entry, el botó continua visible.

El missatge és al codi publicat d'Odoo 17, 18, 19 i 20. Per a altres avisos del connector, mira què fa el botó Provar connexió.

Com ajuda FlexigoTech

Mirakl Connector és un mòdul de pagament únic per versió d'Odoo, publicat per a Odoo 17, 18, 19 i 20, i necessita la subscripció a FlexigoTech Cloud: la connexió passa per aquest servei, que guarda xifrades les credencials, vigila la sincronització i avisa per correu si falla. El pla Connector costa 49 €/mes o 490 €/any sense IVA. FlexigoTech implanta Odoo i desenvolupa connectors i integracions a mida; pots veure la fitxa a Odoo Apps o la pàgina del mòdul.

Continua llegint

Mirakl Connector: «Set the Mirakl API key before testing the connection»Quan surt l'error de clau d'API buida a Mirakl Connector per a Odoo, quina condició el provoca i com resoldre'l en prémer Test Connection.Mirakl Connector: «This binding has no Mirakl instance configured.»Quan surt a Mirakl Connector l'avís de vincle sense instància de Mirakl configurada, quina condició el provoca i què fer quan apareix.Què fa el botó Test Connection de Mirakl Connector, pas a pasQuè fa el botó Test Connection de Mirakl Connector a Odoo: quan apareix, què comprova, què desa a la fitxa i quins errors pot donar.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts