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.

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.


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
- Que l'albarà sigui en
Fet. - Que l'albarà pengi d'una comanda de venda que tingui comanda de Mirakl.
- 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. - Que la comanda de venda tingui una instància de Mirakl vinculada.
- Si tot està en ordre, envia el seguiment a Mirakl a través d'aquesta instància.
- 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
Feti 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
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): views/stock_picking_views.xml
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/stock_picking.py
- Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
