Wat doet de knop Sync FBA Ledger Detail in Odoo

Wat Odoo zelf doet, zonder dat je iets indrukt

De geplande taak Amazon SP-API - Sync FBA ledger detail report (opt-in) draait één keer per dag en is actief vanaf het moment dat de module wordt geïnstalleerd. Ze behandelt alleen de actieve accounts waarvoor de synchronisatie van het detail is ingeschakeld en start voor elk ervan dezelfde synchronisatie als de knop.

Er zijn verschillen met de handmatige uitvoering: de samenvatting vermeldt de geplande taak als herkomst in plaats van handmatig, wordt niet geplaatst in de chatter van het account en, als één account faalt, laat de taak een waarschuwing achter in het serverlog en gaat door met het volgende. De knop maakt die selectie van accounts niet: hij werkt op het account waarin je hem indrukt.

De knop zit in de takken van Odoo 17, 18, 19 en 20 en is altijd zichtbaar in het scherm Accounts, zonder enige voorwaarde.

Het geval Casa Olivar: van het menu tot de samenvatting

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

Casa Olivar is een verzonnen winkel die olijfolie en conserven verkoopt via FBA en de connector draait op Odoo 20. Marta, van administratie, heeft het recht Manager en wil de gebeurtenisgeschiedenis van een account bekijken zonder op de taak van de dag te wachten.

1. Ze gaat naar Amazon › Configuration › Accounts en opent het account.
2. In het tabblad FBA Reports (opt-in), binnen de groep Reimbursement Claim Audit (find money Amazon owes you), staat het selectievakje FBA reimbursement audit, standaard uitgeschakeld. Marta wil dat de synchronisatie ook langs de claimaudit van het account loopt, dus schakelt ze het in.
3. Ze drukt op Sync FBA Ledger Detail. De actie blijft Amazon bevragen, met een pauze tussen de vragen, tot het rapport klaar is, mislukt of de pogingen op zijn.
4. Wanneer de actie met een samenvatting eindigt, bewaart het account de datum en de tekst van de uitvoering en plaatst die samenvatting in zijn chatter.
5. Als de status van het rapport in de samenvatting niet DONE is, wordt er van die uitvoering niets geïmporteerd en kan Marta haar later opnieuw starten. Is het DONE maar levert Amazon het rapportdocument niet aan, dan geeft de samenvatting dat aan en wordt er evenmin iets geïmporteerd. Is er een document, dan voegt de samenvatting toe hoeveel rijen het rapport bevatte en hoeveel er zijn vastgelegd, bijgewerkt of overgeslagen.

Haar collega Íñigo heeft alleen het recht Viewer: hij ziet de onderdelen Configuration en Accounts van het menu niet en komt dus niet bij dit scherm.

De volgende dag doet de geplande taak weer hetzelfde zonder dat iemand iets indrukt, maar alleen op de actieve accounts waarvoor de synchronisatie van het detail is ingeschakeld.

Wat er wordt gecontroleerd voordat Amazon wordt aangeroepen

De route Amazon › Configuration › Accounts heeft rechten per onderdeel: Amazon vraagt Viewer, en zowel Configuration als Accounts vragen Manager. Zonder dat recht zie je die onderdelen niet.

Wanneer je de knop indrukt, is het eerste een controle op de server: als je geen supergebruiker bent, moet je het recht Manager van de connector hebben of dat van Instellingen. Daarna controleert hij of je in dat account mag schrijven. De supergebruiker slaat de groepscontrole over, en de geplande taak komt er ook niet langs omdat ze rechtstreeks de synchronisatie aanroept.

Wat er intern gebeurt, in volgorde

1. Controleert de rechten, zoals je net zag.
2. Werkt met één enkel account.
3. Vraagt Amazon het FBA-grootboekdetailrapport aan te maken. Als Amazon de identificatie van het rapport niet teruggeeft, stopt de actie.
4. Bevraagt de status van het rapport tot die DONE, CANCELLED of FATAL is, of tot de pogingen op zijn. Het aantal pogingen en de seconden ertussen neemt hij uit het account; is er geen waarde, dan gebruikt de code twaalf pogingen met tien seconden pauze.
5. Als het rapport niet op DONE uitkomt, bewaart hij de datum en de samenvatting met de status waarin het bleef, plaatst die in de chatter en stopt zonder iets te importeren.
6. Als het DONE is maar Amazon geen rapportdocument geeft, doet hij hetzelfde: samenvatting bewaard, niets geïmporteerd en geen rijtellingen.
7. Als er een document is, downloadt hij het en geeft het door aan de import van de gebeurtenisgeschiedenis van het grootboek van het account.
8. Als FBA reimbursement audit is ingeschakeld, loopt de synchronisatie ook langs de claimaudit van het account.
9. Bewaart de datum en de samenvatting en plaatst de samenvatting in de chatter.

De samenvatting bevat het account, de herkomst (handmatig als jij hem start), de identificatie en de status van het rapport en, als er daadwerkelijk wordt geïmporteerd, het aantal rijen, vastgelegde, bijgewerkte en overgeslagen.

Wat er in je Odoo verandert en wat niet

• De gebeurtenisgeschiedenis van het grootboek van het account wordt aangevuld.
• Het account bewaart de datum en de samenvatting van de laatste uitvoering, en de chatter krijgt een notitie met de samenvatting.
• Met FBA reimbursement audit ingeschakeld loopt de synchronisatie ook langs de claimaudit. De hulptekst zegt dat de synchronisatie bij inschakelen ook gebeurtenissen van verloren, beschadigd en teruggevonden verzamelt, en dat de audit ze vergelijkt met de vergoedingen uit de uitbetalingen om de eenheden te vinden die Amazon nog verschuldigd is, met geschatte waarde en uiterste claimdatum. Het is een analyse die alleen leest.
• Volgens de code zelf is het een onafhankelijke synchronisatie die de FBA-voorraad niet aanraakt: ze verzamelt alleen geschiedenis per gebeurtenis voor de vergoedingsaudit.

De melding die de actie kan stoppen

Bij het indrukken van Sync FBA Ledger Detail kan deze melding verschijnen: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Hij verschijnt wanneer je geen supergebruiker bent en niet het recht Manager van de connector noch dat van Instellingen hebt. Het wordt opgelost zoals de tekst zelf zegt: vraag een manager je het toegangsrecht Manager te geven.

Wat je van dit geval leert

• De dagelijkse taak synchroniseert de actieve accounts waarvoor de synchronisatie van het detail is ingeschakeld; de knop dient om haar handmatig te starten op het account dat je open hebt.
• Het recht wordt gecontroleerd bij het indrukken, naast de beperking van het menu.
• De status van het rapport in de samenvatting zegt je of er is geïmporteerd.
• Het selectievakje FBA reimbursement audit bepaalt of de synchronisatie ook langs de claimaudit loopt.

Hoe FlexigoTech je helpt

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. De pagina van de module en de vermelding in Odoo Apps bevatten de aankoopdetails. De module is een eenmalige betaling per versie en vereist het abonnement op FlexigoTech Cloud, plan Connector (€ 49 per maand of € 490 per jaar, excl. btw). De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als ze faalt.

Lees verder

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

Bronnen

• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.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/precios.html
• flexigotech.com/en/services.html