Salta al contingut principal
Mirakl

Què fa el botó «Push Mirakl Tracking», pas a pas

El botó Push Mirakl Tracking és a l'albarà d'una comanda de Mirakl que ja és en Fet i comunica a Mirakl el número de seguiment del transportista. Abans d'enviar, el mòdul comprova l'estat, el vincle amb la comanda de Mirakl, el número de seguiment i la instància; si una d'aquestes comprovacions falla, l'acció s'atura abans d'intentar l'enviament. Amb l'ajust adequat de la instància, Odoo fa aquest mateix enviament sol en validar el lliurament.

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
5 min

Quan apareix el botó a l'albarà

El botó és a l'albarà (moviment d'Inventari) i existeix a les branques 17.0, 18.0, 19.0 i 20.0 del mòdul. S'amaga quan l'albarà no és d'una comanda de Mirakl o quan el seu estat no és Fet. Dit en positiu: només el veus en un albarà de Mirakl ja validat. La part de «comanda de Mirakl» depèn d'una dada interna, Is Mirakl Order, que no es veu en cap vista.

Esquema fet amb codi del botó Push Mirakl Tracking, present a Odoo 17, 18, 19 i 20, amb el rètol en anglès del codi del mòdul
Esquema fet amb codi a partir del codi publicat del mòdul, no és una pantalla d'Odoo: el botó Push Mirakl Tracking a Odoo 17.0, 18.0, 19.0 i 20.0.

El rètol depèn de l'idioma del teu Odoo: en anglès és Push Mirakl Tracking, en alemany Mirakl-Tracking übertragen, en francès Envoyer le suivi à Mirakl, en italià Invia tracciamento Mirakl i en portuguès Enviar Seguimento Mirakl.

Esquema fet amb codi amb el text del botó en anglès, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no és una pantalla d'Odoo.
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)

Un cas de principi a fi

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Imagina una botiga inventada, Almenara Hogar, que ven en un marketplace Mirakl amb el connector. Vegem tres lliuraments, amb el que fa el codi d'Odoo 20.0.

Primer lliurament: el camí automàtic

A la instància de Mirakl d'Almenara Hogar hi ha activat l'ajust d'enviar el seguiment en validar el lliurament. El magatzem deixa el número del transportista a l'albarà i valida. Quan la validació acaba, Odoo comprova que l'albarà és en Fet, que és d'una comanda de Mirakl, que la instància té aquest ajust actiu i que hi ha número de seguiment. Llavors envia el seguiment a Mirakl sense que ningú premi res. Aquest és el camí normal: el botó no fa falta.

Si en aquest camí l'enviament falla, la validació del lliurament no s'interromp: el mòdul deixa a l'albarà una nota amb el motiu de l'error.

Segon lliurament: sense número de seguiment

El magatzem valida un altre albarà sense número del transportista. Com que l'ajust està actiu, el mòdul no envia res i deixa a l'albarà una nota que explica que falta el número de seguiment i que cal afegir-lo al lliurament i prémer Push Mirakl Tracking.

El magatzem afegeix el número del transportista al lliurament i prem el botó. Aquest és l'ús del botó com a excepció: reintentar a mà un enviament que no ha sortit sol.

Tercer lliurament: l'enviament falla en prémer

En un altre albarà, en prémer el botó, la crida a Mirakl falla. El mòdul deixa a l'albarà una nota amb el motiu de l'error i el botó et mostra l'error en pantalla. En el camí automàtic, en canvi, la nota queda a l'albarà i la validació continua endavant.

Què comprova el botó i en quin ordre

  1. Que l'albarà sigui en Fet.
  2. Que l'albarà pengi d'una comanda de venda que tingui comanda de Mirakl.
  3. Que hi hagi número de seguiment. El mòdul el llegeix de la referència de seguiment del transportista de l'albarà (l'aporta el mòdul opcional stock_delivery; si no està instal·lat, el connector no falla). Si la referència té diverses línies, pren la primera, i d'aquesta el que va abans de la primera coma o punt i coma.
  4. Que la comanda de venda tingui una instància de Mirakl vinculada.
  5. Si tot està en ordre, envia el seguiment a Mirakl a través d'aquesta instància.
  6. Si l'enviament surt bé, deixa una nota a l'albarà amb el text Mirakl tracking pushed successfully. Si falla, veus l'error en pantalla.

Si falla alguna de les quatre primeres comprovacions, l'acció s'atura amb un avís abans d'intentar l'enviament del pas cinc.

Què passa si falta la subscripció

Quan el marketplace va per FlexigoTech Cloud i aquesta base de dades no té el servei del connector, la validació del lliurament segueix el seu curs normal a Odoo i res va a Mirakl: el seguiment i la factura queden pendents d'enviar més tard. Si prems el botó en aquest estat, el seguiment queda pendent, sense marcar res com a enviat, i l'acció s'interromp.

El que passa en la mateixa validació

En la mateixa validació, el mòdul també pot crear la factura si la instància té activa la casella Auto-create invoice on delivery validation. És a la fitxa de Mirakl Instances, pestanya Orders and Returns, grup Sales Bridge, i ve desactivada per defecte. És una cosa diferent del seguiment. Si t'interessa la factura, mira el missatge sobre comptabilitzar la factura abans d'enviar-la a Mirakl; i si el que necessites és desfer una comanda, el botó «Cancel in Mirakl».

Què aprendre del cas

  • L'enviament del seguiment és automàtic en validar si la instància ho té activat; el botó serveix per reintentar a mà.
  • El botó només apareix amb l'albarà en Fet i d'una comanda de Mirakl.
  • Sense número de seguiment no hi ha enviament: afegeix el número del transportista al lliurament i torna a prémer.
  • Després de prémer, si l'enviament surt bé queda una nota a l'albarà; si falla, veus l'error en pantalla.

Cost i ajuda

Mirakl Connector és un mòdul de pagament únic per versió d'Odoo (publicat a Odoo Apps per a 17.0, 18.0, 19.0 i 20.0) i necessita la subscripció a FlexigoTech Cloud: pla Connector, 49 €/mes o 490 €/any sense IVA, fins a 3 comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials i avisa per correu si la sincronització falla. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo. Tens la fitxa a Odoo Apps i la pàgina del mòdul.

Si estàs implantant Odoo i vols deixar la logística i el seguiment ben connectats, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida.

Continua llegint

L'error «Post the invoice before sending it to Mirakl.» a Mirakl ConnectorQuan surt l'error «Post the invoice before sending it to Mirakl.» a Mirakl Connector per a Odoo, què comprova el codi i com resoldre'l.La tasca «Mirakl - Accept Orders», passada a passadaQuè fa a cada passada la tasca programada Mirakl - Accept Orders de Mirakl Connector per a Odoo, cada quant corre i què revisar si no accepta res.Què fa el botó `Cancel in Mirakl` de Mirakl Connector, pas a pasQuè fa el botó Cancel in Mirakl de Mirakl Connector per a Odoo: quan apareix, què comprova, què canvia a la comanda i quins errors pot donar.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts