Salta al contingut principal
Mirakl

Una comanda de Mirakl a Odoo, de la compra al cobrament

Una comanda d'un marketplace que funciona amb Mirakl recorre a Odoo set parades: entra, s'accepta, es prepara, s'envia amb seguiment, es factura, es cobra a la liquidació i, de vegades, torna com a devolució. Aquesta cronologia explica què fa el connector a cadascuna i cada quant ho fa.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 3 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
3 min

Leroy Merlin, Decathlon o Bricodepot venen amb Mirakl per sota. Per a Odoo tant fa l'operador: el connector, publicat per a Odoo 17, 18, 19 i 20, parla amb l'API de Mirakl de cada marketplace que configuris i segueix sempre el mateix calendari.

El recorregut

  1. Quan el client compra La comanda neix al marketplace amb l'estat pendent d'acceptació. Odoo encara no en sap res.
  2. En els 10 minuts següents La tasca Mirakl - Sync Orders la porta a Odoo. Apareix a Mirakl › Operations › Orders amb l'estat d'acceptació pendent.
  3. A la passada d'acceptació següent Mirakl - Accept Orders també s'executa cada 10 minuts i accepta el que tinguis configurat per acceptar sol. Si el marketplace no demana acceptació, l'estat queda com a no requerit; si alguna cosa falla, en error i a la vista.
  4. En acceptar Es crea la comanda de venda d'Odoo amb les seves línies i el client. L'estoc queda compromès per a la resta de canals.
  5. En preparar i validar l'albarà El seguiment del transportista passa al marketplace. L'estat de seguiment de la comanda canvia de pendent a sincronitzat, o a error si Mirakl el rebutja.
  6. En facturar La factura de client es publica a Odoo i després s'envia a Mirakl. L'ordre importa: una factura en esborrany no s'envia.
  7. Quan arriba la liquidació Settlements & Invoices recull els pagaments de l'operador amb el seu estat: pendent, en procés, transferit o pagat. Cada document porta a més el seu estat comptable: sense comptabilitzar, comptabilitzat o conciliat.
  8. Si hi ha devolució Les devolucions se sincronitzen cada 30 minuts i apareixen a Operations › Returns. El reemborsament té el seu propi estat: pendent, parcial, reemborsat o error.
Llista de comandes de Mirakl a Odoo amb estat d'acceptació i d'enviament
Comandes d'un marketplace Mirakl dins d'Odoo, cadascuna amb el seu estat. Captura d'Odoo amb dades de demostració.
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)

Mentrestant, l'estoc i el preu

Mentre la comanda avança, tres tasques més mantenen l'aparador al dia. Les ofertes surten cada 5 minuts. L'estoc va pel flux STO01 cada 10 minuts i els preus pel PRI01 cada 15. Així, quan una comanda acceptada reserva unitats, la resta de marketplaces ho veuen en minuts.

Comanda de venda d'Odoo creada des d'una comanda de Mirakl
La comanda de venda que crea el connector en acceptar. D'aquí en surt tota la resta: albarà, factura i devolució. Captura d'Odoo amb dades de demostració.

Els dos avisos que surten més

En enviar la factura poden aparèixer dos missatges. Post the invoice before sending it to Mirakl. vol dir que la factura continua en esborrany: publica-la i torna-la a enviar. This invoice is not linked to a Mirakl order. apareix quan la factura no ve d'una comanda del marketplace, per exemple si l'has creada a mà. La solució és facturar des de la mateixa comanda de venda.

Albarà validat d'una comanda de Mirakl amb el seguiment ja enviat
Albarà validat: el seguiment ja ha viatjat al marketplace. Captura d'Odoo amb dades de demostració.

El que no va sol

La sincronització de factures des de Mirakl, que s'executa un cop al dia, ve desactivada en instal·lar: s'activa si el teu operador la fa servir. Els missatges dels clients tampoc no s'activen sols. Així no entra a Odoo informació que ningú no mirarà.

Mira el vídeo a YouTube
Vídeo de demostració del connector de Mirakl a Odoo, amb l'API de Mirakl simulada.

Si la teva pregunta és per què una comanda no avança, mira primer el seu estat d'acceptació i el seu estat de seguiment a la llista. Gairebé sempre un dels dos està en error i el missatge et diu el motiu.

Continua llegint

Com mapejar categories i atributs de Mirakl a Odoo, pas a pasCom preparar el catàleg d'un marketplace Mirakl a Odoo: diccionari de categories, atributs, llistes de valors, mapatge i exportació, amb els errors típics.Exemple: un fabricant que ven en diversos marketplaces Mirakl amb fulls de càlculCas d'exemple d'un fabricant que ven en diversos marketplaces Mirakl amb fulls de càlcul i què canvia quan ho porta tot a Odoo amb el connector.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
  • Codi del mòdul: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
  • youtube.com/shorts/nbJU8l2bbCM