De taak «Mirakl - Facturen synchroniseren»: wat ze doet en wat je checkt als er niets gebeurt

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Taller Aralar is een verzonnen bedrijf dat verkoopt op een Mirakl-marktplaats en net Mirakl Connector in zijn Odoo heeft geïnstalleerd. Er gaan dagen voorbij en in Odoo verschijnt geen enkele factuur van de marktplaats. Voordat hij iets aanpast, loopt de beheerder van Odoo na wat de taak Mirakl - Facturen synchroniseren doet en waar ze kan blijven steken zonder iets te doen. Die controle volgt hieronder.

Wat de taak bij elke ronde doet

De taak kijkt niet naar één bepaalde marktplaats: ze loopt een voor een alle marktplaatsen langs die aan de voorwaarde voldoen. In Odoo 20 doet ze bij elke run het volgende, in deze volgorde:

1. Ze controleert of degene die haar uitvoert beheerder is. Zo niet, dan stopt ze met Alleen een beheerder kan deze geplande actie uitvoeren. (Only an administrator can run this scheduled action.) en doet ze niets meer.
2. Ze zoekt de marktplaatsen die actief zijn en waarvoor de factuursynchronisatie is ingeschakeld.
3. Daarvan laat ze de marktplaatsen weg die ze niet kan aanroepen: die via FlexigoTech Cloud lopen zonder opgeslagen sleutel en, als de opgeslagen machtiging van de module de dienst van de module niet bevat, alle marktplaatsen op die route (die controle gaat niet via het netwerk). De marktplaatsen die rechtstreeks verbinden komen eerst.
4. Voor elke marktplaats die overblijft vraagt ze de facturen op. Gaat er bij één iets mis, dan probeert de module de fout te noteren en gaat ze door met de volgende. De uitzondering is een pauze van FlexigoTech Cloud, die de hele ronde afbreekt.

Wat ze met de facturen van elke marktplaats doet

Als een marktplaats aan de beurt is, doet de taak dit:

• Ze gebruikt het facturen-endpoint dat de marktplaats heeft ingesteld of, als dat leeg is, /invoices.
• Ze vraagt de facturen pagina voor pagina op, met een paginagrootte en een maximum aantal pagina's (minstens één). Ze stopt als een pagina leeg binnenkomt, als die minder facturen bevat dan de paginagrootte, als het totaal dat Mirakl meldt is bereikt of als het maximum aantal pagina's is bereikt.
• Ze verwerkt elke ontvangen factuur. Faalt er één, dan noteert ze de fout bij die factuur en gaat ze door met de rest.

Stelt de operator /invoices niet beschikbaar, dan noteert de module de waarschuwing Facturen-endpoint niet beschikbaar (HTTP 404). Deze operator stelt /invoices niet beschikbaar. (Invoices endpoint not available (HTTP 404). This operator does not expose /invoices.), legt ze het huidige moment vast als datum van de laatste factuursynchronisatie en rondt ze die marktplaats af. Bij elke andere fout in het verzoek noteert ze de fout en stopt ze met het lezen van pagina's van die marktplaats.

Laat FlexigoTech Cloud de aanroep niet door (zonder abonnement of met een pauze van de relay), dan wordt de ronde afgebroken: er wordt niets gemarkeerd of gewist en de volgende ronde gaat verder. De module telt de pauze, met de bijbehorende code, alleen mee in het gezondheidsrapport van FlexigoTech Cloud. Doordat de rechtstreekse marktplaatsen eerst komen, blijft er geen enkele daarvan door die pauze onaangeroepen.

Hoe vaak ze draait en sinds wanneer

De taak draait één keer per dag en staat na installatie uitgeschakeld: zolang niemand haar inschakelt, doet ze niets. In Odoo 17 herhaalt de taak zich zonder einde. Ze zit in de gepubliceerde branches 17, 18, 19 en 20.

De kaarten van de marktplaatsen open je via het menu Mirakl › Configuratie › Marktplaatsen (Mirakl › Configuration › Marketplaces).

De controle van Taller Aralar, stap voor stap

1. Hij controleert of de taak is ingeschakeld, want ze staat na installatie uitgeschakeld.
2. Hij houdt er rekening mee dat de taak één keer per dag draait, dus hij verwacht de facturen niet meteen.
3. Hij zorgt ervoor dat de taak door een beheerder wordt uitgevoerd. Zo niet, dan stopt ze met Alleen een beheerder kan deze geplande actie uitvoeren..
4. Hij houdt in gedachten dat de taak alleen actieve marktplaatsen met ingeschakelde factuursynchronisatie oppakt: voldoet de zijne niet aan beide, dan doet ze niet mee aan de ronde. De kaarten open je via Mirakl › Configuratie › Marktplaatsen.
5. Loopt de marktplaats via FlexigoTech Cloud, dan houdt hij in gedachten dat ze zonder opgeslagen sleutel niet wordt aangeroepen, en dat ook geen enkele marktplaats op die route wordt aangeroepen als de opgeslagen machtiging de dienst van de module niet bevat.
6. Stelt de operator /invoices niet beschikbaar, dan noteert de module de waarschuwing Facturen-endpoint niet beschikbaar (HTTP 404). Deze operator stelt /invoices niet beschikbaar., legt ze het huidige moment vast als datum van de laatste factuursynchronisatie en rondt ze die marktplaats af.
7. Bij andere fouten onthoudt hij dat de module probeert een logregel op te slaan die aan de marktplaats is gekoppeld en dat ze de fout ook in het serverlog schrijft.

Wat het voorbeeld leert

Brengt de taak niets binnen, controleer dan in deze volgorde: eerst of ze is ingeschakeld, want ze staat na installatie uitgeschakeld en draait niet zolang dat zo blijft. Daarna, in de volgorde waarin de code ze toepast: beheerder, marktplaats die aan de voorwaarden voldoet, route van FlexigoTech Cloud en ten slotte de genoteerde fouten.

Bij fouten probeert de module een logregel te schrijven met het niveau, de bewerking, de methode, het aangeroepen adres, de status van het antwoord en de foutmelding. Gaat er bij het aanmaken van die regel iets mis, dan laat ze een waarschuwing achter in het serverlog.

Zo helpt FlexigoTech

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Mirakl Connector is gepubliceerd in Odoo Apps voor 17, 18, 19 en 20: bekijk de pagina in Odoo Apps of de pagina van de module.

Lees verder

Gecontroleerd in de broncode van de connector (versie 17.0 en 20.0) en in de gelinkte bronnen

Bronnen

• Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): data/ir_cron_data.xml
• Broncode van de module: flexigobe_mirakl_connector 17.0 (e430de3e): data/ir_cron_data.xml
• Broncode van de module: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
• Broncode van de module: 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