La tasca «Mirakl - Sync Invoices»: què fa i què mirar si no fa res

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

Taller Aralar és una empresa inventada que ven en un marketplace Mirakl i acaba d'instal·lar Mirakl Connector al seu Odoo. Passen els dies i a Odoo no apareix cap factura del marketplace. Abans de tocar res, la persona que porta Odoo repassa què fa la tasca Mirakl - Sync Invoices i en quins punts pot quedar-se sense fer res. Aquest repàs és el que segueix.

Què fa la tasca a cada passada

La tasca no mira un marketplace concret: recorre un darrere l'altre tots els que compleixen la condició. A Odoo 20, quan corre, fa el següent i en aquest ordre:

1. Comprova que qui l'executa és administrador. Si no ho és, s'atura amb Only an administrator can run this scheduled action. i no fa res més.
2. Cerca els marketplaces que estiguin actius i tinguin habilitada la sincronització de factures.
3. D'aquests, deixa fora els que no pot cridar: els que van per FlexigoTech Cloud sense clau desada i, si el permís que el mòdul té desat no inclou el servei del mòdul, tots els d'aquesta ruta (aquesta comprovació no surt a la xarxa). Els marketplaces que es connecten de manera directa van primer.
4. Per a cada marketplace que queda, demana les seves factures. Si alguna cosa falla en un, el mòdul intenta anotar l'error i continua amb el següent. L'excepció és una pausa de FlexigoTech Cloud, que talla el recorregut.

Què fa amb les factures de cada marketplace

Quan li toca a un marketplace, la tasca fa això:

• Utilitza l'endpoint de factures que tingui el marketplace o, si està buit, /invoices.
• Demana les factures per pàgines, amb una mida de pàgina i un màxim de pàgines (com a mínim una). S'atura quan una pàgina arriba buida, quan porta menys factures que la mida de pàgina, quan ja s'ha assolit el total que informa Mirakl o quan arriba al màxim de pàgines.
• Processa cada factura rebuda. Si una falla, anota l'error amb aquesta factura i continua amb les altres.

Si l'operador no exposa /invoices, el mòdul anota l'avís Invoices endpoint not available (HTTP 404). This operator does not expose /invoices., apunta el moment actual com a data de l'última sincronització de factures i acaba amb aquest marketplace. Amb qualsevol altre error en la petició anota l'error i deixa de llegir pàgines d'aquest marketplace.

Si FlexigoTech Cloud no deixa passar la crida (sense subscripció o amb una pausa del relé), la passada es talla: no es marca ni s'esborra res i la passada següent continua. El mòdul només compta la pausa, amb el seu codi, a l'informe de salut de FlexigoTech Cloud. Com que els marketplaces directes van primer, cap d'ells es queda sense cridar per aquesta pausa.

Cada quant corre i des de quan

La tasca corre un cop al dia i ve desactivada en instal·lar: fins que algú l'activi, no fa res. A Odoo 17 la tasca es repeteix sense fi. Està a les branques publicades 17, 18, 19 i 20.

Les fitxes dels marketplaces s'obren des del menú Mirakl › Configuration › Marketplaces.

El repàs de Taller Aralar, pas a pas

1. Confirma que la tasca està activada, perquè ve desactivada en instal·lar.
2. Té en compte que la tasca corre un cop al dia, així que no espera veure les factures a l'instant.
3. S'assegura que la tasca l'executa un administrador. Si no, s'atura amb Only an administrator can run this scheduled action..
4. Té present que la tasca només agafa marketplaces actius i amb la sincronització de factures habilitada: si el seu no compleix les dues coses, no entra a la passada. Les seves fitxes s'obren des de Mirakl › Configuration › Marketplaces.
5. Si el marketplace va per FlexigoTech Cloud, té present que sense clau desada no es crida, i que tampoc es crida cap d'aquesta ruta si el permís desat no inclou el servei del mòdul.
6. Si l'operador no exposa /invoices, el mòdul anota l'avís Invoices endpoint not available (HTTP 404). This operator does not expose /invoices., apunta el moment actual com a data de l'última sincronització de factures i acaba amb aquest marketplace.
7. Si hi ha altres errors, recorda que el mòdul intenta desar una fila de registre associada al marketplace i que també escriu l'error al log del servidor.

Què ensenya el cas

Si la tasca no porta res, convé revisar, per aquest ordre: primer que estigui activada, perquè ve desactivada en instal·lar i, mentre ho estigui, no corre. Després, en l'ordre en què el codi les aplica: administrador, marketplace que compleixi les condicions, ruta de FlexigoTech Cloud i, finalment, els errors anotats.

Sobre els errors, el mòdul intenta escriure una fila de registre amb el nivell, l'operació, el mètode, l'adreça cridada, l'estat de la resposta i el missatge d'error. Si en crear la fila es produeix un error, deixa un avís al log del servidor.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Mirakl Connector està publicat a Odoo Apps per a 17, 18, 19 i 20: pots veure la fitxa d'Odoo Apps o la pàgina del mòdul.

Continua llegint

Comprovat al codi del connector (versió 17.0 i 20.0) i a les fonts enllaçades

Fonts

• Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): data/ir_cron_data.xml
• Codi del mòdul: flexigobe_mirakl_connector 17.0 (e430de3e): data/ir_cron_data.xml
• Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
• Codi del mòdul: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html