Salta al contingut principal
Mirakl

La tasca «Mirakl - Sync Returns» de Mirakl Connector: què fa i què mirar

La tasca programada Mirakl - Sync Returns corre cada 30 minuts i ve activa en instal·lar: a cada passada demana les seves devolucions, pàgina a pàgina, als marketplaces actius que tenen aquesta sincronització activada. Si sembla que no fa res, mira quins marketplaces es queden fora de la passada, si FlexigoTech Cloud ha fet una pausa i si el marketplace ha respost amb un 404 a les devolucions.

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ó 17.0 i 20.0 · a les fonts enllaçades al final
Lectura
5 min

Què fa la tasca a cada passada

La tasca programada Mirakl - Sync Returns és a totes les versions publicades de Mirakl Connector (Odoo 17, 18, 19 i 20), corre cada 30 minuts i ve activa en instal·lar.

A Odoo 20.0, a cada passada, la tasca comprova que qui l'executa és administrador, busca els marketplaces actius amb la sincronització de devolucions activada, es queda amb els que pot cridar i, per a cadascun, demana les seves devolucions al marketplace per pàgines i processa una per una les que arriben. Les fitxes dels marketplaces s'obren des del menú Mirakl › Configuration › Marketplaces; per veure el menú Mirakl n'hi ha prou amb ser usuari intern d'Odoo.

Esquema fet amb codi: la tasca programada de devolucions, que corre cada 30 minuts, i el menú dels marketplaces
Esquema fet amb codi a partir del codi publicat del mòdul, no una captura d'Odoo: la tasca, que corre cada 30 minuts i ve activa en instal·lar (Odoo 17.0, 18.0, 19.0 i 20.0), i el menú dels marketplaces.

Amb Odoo en anglès la tasca es diu Mirakl - Sync Returns; l'esquema següent recull el seu nom en altres idiomes.

Esquema amb el nom de la tasca en castellà, alemany, francès, italià i portuguès
Esquema fet amb codi a partir de les traduccions publicades del mòdul, no una captura d'Odoo: el nom de la tasca segons l'idioma 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)

Com es comporta la tasca

Corre cada 30 minuts i exigeix un administrador

La freqüència és cada 30 minuts. A Odoo 17.0 la tasca es repeteix sense fi. A Odoo 20.0, el primer que fa cada passada és comprovar l'usuari: si es llança amb algú que no és administrador, s'atura amb Only an administrator can run this scheduled action. i no es processa cap marketplace.

No tots els marketplaces entren a la passada

A Odoo 20.0, la cerca parteix dels marketplaces actius amb la sincronització de devolucions activada; la resta no es toca. Després, el mòdul filtra els que pot cridar: primer els de connexió directa i després els que van per FlexigoTech Cloud, i d'aquests només els que tenen una clau desada. A més, si el permís desat no inclou el servei del mòdul (això es comprova sense sortir a la xarxa), cap dels de FlexigoTech Cloud es crida en aquesta passada. Els de connexió directa segueixen el seu curs.

Una pausa de FlexigoTech Cloud talla la resta de la passada

Si FlexigoTech Cloud no deixa passar la petició (perquè no hi ha subscripció o hi ha una pausa del servei), no es marca ni s'esborra res i la passada es talla aquí: els marketplaces que quedaven esperen la següent, que segueix el seu curs. Per això els de connexió directa van primer: una pausa no deixa cap d'ells sense atendre. La pausa només compta per a l'informe de salut de FlexigoTech Cloud, amb codis i mai text. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo.

Un error en un marketplace no frena els altres

Qualsevol altre error en un marketplace s'anota al registre del servidor d'Odoo i el mòdul intenta deixar una línia de registre de tipus error amb el text de l'error; després passa al marketplace següent. Si ni tan sols es pot escriure aquesta línia, el mòdul deixa un avís al registre del servidor, i aquest error del registre no substitueix l'error original.

Si el marketplace respon amb un 404 a les devolucions

Si el marketplace respon amb un 404 (HTTP 404) a la petició de devolucions, el mòdul deixa una línia de registre de tipus avís amb el text Returns endpoint not available (HTTP 404). Després, si el marketplace té activat el suport per comandes, el mòdul passa a un altre mètode de sincronització; si no, avança a aquest moment la marca de darrera sincronització de devolucions i acaba sense processar res.

Una resposta que el connector no reconeix no és una pàgina buida

Si arriba una pàgina sense devolucions, la passada d'aquell marketplace acaba. Però si la resposta té una forma que el connector no reconeix, el mòdul deixa una línia de registre de tipus error i no avança la finestra de sincronització, per no deixar passar devolucions que no ha llegit.

Pàgines, topall i quan s'atura

La tasca demana pàgines d'una mida fixada, processa cada devolució i la compta. S'atura quan una pàgina porta menys devolucions que la mida de pàgina, quan ja ha llegit el total que anuncia el marketplace o quan arriba al topall de pàgines per passada (com a mínim, una pàgina).

Què mirar si sembla que no fa res

  • La tasca apareix entre les accions planificades d'Odoo amb el nom Mirakl - Sync Returns i està activa.
  • El marketplace és actiu i amb la sincronització de devolucions activada; si no, no entra a la cerca (les seves fitxes s'obren des de Mirakl › Configuration › Marketplaces).
  • Si es connecta per FlexigoTech Cloud, té una clau desada i el servei és vigent. FlexigoTech Cloud vigila la sincronització i avisa per correu si falla.
  • Si un altre marketplace de la mateixa passada va donar una pausa de FlexigoTech Cloud, la passada es va tallar i els que quedaven esperen la següent.
  • Si el marketplace va respondre amb un 404, busca una línia de registre de tipus avís amb el text Returns endpoint not available (HTTP 404).
  • Si hi ha una línia de registre de tipus error, llegeix-ne el text: és l'error d'aquell marketplace.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Mirakl Connector és un mòdul de pagament únic per versió i necessita la subscripció a FlexigoTech Cloud (pla Connector: 49 € al mes o 490 € a l'any, sense IVA). Pots veure el mòdul a la seva pàgina o a la fitxa d'Odoo Apps.

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ó 17.0 i 20.0) i a les fonts enllaçades

Fonts