Amazon-taak voor EU EPR-rapporten in Odoo: wat hij bij elke run doet

Wat de taak doet en hoe vaak hij draait

De geplande taak Amazon SP-API - Sync EU EPR reports (opt-in) draait één keer per dag, elke dag, en staat standaard actief na installatie van de module. Hij zit in alle gepubliceerde branches van de connector: Odoo 17, 18, 19 en 20. In Odoo 17 is de taak zo ingesteld dat hij zich eindeloos herhaalt. In Odoo 20 doet de taak bij elke run wat hieronder staat.

Bij elke run zoekt de taak de Amazon-accounts die aan twee voorwaarden tegelijk voldoen: ze zijn actief en de synchronisatie van EPR-rapporten staat aan. Accounts die niet aan allebei voldoen, blijven onaangeroerd. De naam van de taak verschilt per taal van je Odoo; het schema laat zien hoe hij er in vijf talen uitziet.

Een voorbeeld van begin tot eind

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

Hogar Atlántico is een voor dit voorbeeld verzonnen winkel. Ze verkoopt op Amazon met twee accounts die in Odoo zijn aangemaakt. Marta, van administratie, ziet ze in het menu Amazon › Configuration › Accounts, waar elk account wordt herkend aan zijn Name. Een van de accounts is actief en heeft de synchronisatie van EPR-rapporten ingeschakeld. Het andere is actief, maar heeft die niet ingeschakeld.

De run van de dag begint. De taak zoekt actieve accounts met de synchronisatie ingeschakeld en vindt alleen het eerste. Het tweede blijft onaangeroerd, ook al is het actief.

Voor het eerste account start de taak de synchronisatie met de aanduiding dat die van de geplande taak komt en dat een fout in één deel niet de hele run mag laten mislukken. Binnenin is de volgorde vast: eerst Monthly, daarna Quarterly en tot slot Annual.

Stel dat het kwartaaldeel een fout geeft. De run stopt niet: hij noteert de fout van dat deel in de resultaattekst en gaat verder met het jaardeel. Aan het eind slaat hij op het account de datum en het tijdstip van de uitvoering op, samen met die tekst.

De volgende ochtend vindt Marta geen nieuw bericht op het scherm van het account. Dat is te verwachten: wanneer de taak de synchronisatie start, wordt het resultaat niet als bericht op het scherm gepubliceerd.

Wat er bij elke run gebeurt, in volgorde

1. De taak zoekt de actieve accounts waarvoor de synchronisatie van EPR-rapporten is ingeschakeld.
2. Voor elk account start hij de synchronisatie met als herkomst de geplande taak.
3. Binnen het account doorloopt hij Monthly, Quarterly en Annual, in die volgorde. Als een deel mislukt, voegt hij de titel van dat deel en de fout toe aan de resultaattekst en gaat hij door met het volgende.
4. Hij slaat op het account de datum en het tijdstip van de run en de resultaattekst op, die wordt ingekort tot maximaal 5000 tekens. De tekst bevat de naam van het account en de herkomst.
5. Hij publiceert het resultaat niet als bericht op het scherm van het account.
6. Als de run van een account op een andere manier mislukt, laat hij een waarschuwing achter in het serverlogboek met de naam van het account en de fout, en gaat de taak verder met de andere accounts.

Wat je controleert als het lijkt of er niets gebeurt

• Het account is actief. De zoekopdracht bevat alleen actieve accounts.
• Het account heeft de synchronisatie van EPR-rapporten ingeschakeld. Dit is de tweede voorwaarde van de zoekopdracht: zonder die voorwaarde doet het account niet mee aan de run.
• De taak is nog actief. Hij staat na installatie actief en draait één keer per dag; in Odoo 17 herhaalt hij zich eindeloos.
• Verwacht geen bericht op het scherm. Wanneer de taak de synchronisatie start, wordt het resultaat daar niet gepubliceerd. Wat wel op het account blijft staan, zijn de datum en het tijdstip van de laatste uitvoering en de resultaattekst.
• Een fout in één deel betekent niet dat er niets is gedaan. De andere delen worden gewoon uitgevoerd en de fout wordt genoteerd in de resultaattekst.
• Het serverlogboek. Als de run van een account op een andere manier mislukt, staat er een waarschuwing met de naam en de fout.
• Je rechten. Om vanuit het menu bij de accounts te komen heb je de rechten Manager nodig op de onderdelen Configuration en Accounts, en Viewer op het onderdeel Amazon. Ontbreekt er één, dan is dat onderdeel niet zichtbaar.

Wat je van dit voorbeeld leert

De taak is opt-in: een actief account is niet genoeg, het moet ook de synchronisatie van EPR-rapporten ingeschakeld hebben. Elk account wordt apart verwerkt en binnen elk account wordt elk deel apart verwerkt, zodat een fout beperkt blijft en genoteerd wordt. En omdat de taak niets op het scherm publiceert, is de op het account opgeslagen datum van de laatste uitvoering het bewijs dat hij gedraaid heeft.

Kosten en hulp

De module is een eenmalige aankoop per Odoo-versie en vraagt een abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar excl. btw, met maximaal 3 Amazon-accounts (het plan Pro, € 98 per maand of € 980 per jaar excl. btw, maximaal 10). De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als die mislukt. De module is gepubliceerd in Odoo Apps voor 17, 18, 19 en 20; hier vind je de pagina in Odoo Apps en de pagina van de module.

Als je Odoo aan het implementeren bent en wilt nakijken hoe je Amazon-accounts erbij staan, of je hebt een integratie op maat nodig, dan implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het connectoren en integraties op maat.

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_amazon_seller_connector 20.0 (8576afa5): data/ir_cron_data.xml
• Broncode van de module: flexigobe_amazon_seller_connector 17.0 (165f66af): data/ir_cron_data.xml
• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html