Wat doet de knop Run Returns Import van Amazon in Odoo?

Waar de knop staat en welke rechten het menu vraagt

De knop Run Returns Import staat in het scherm Accounts, dat je bereikt via Amazon › Configuration › Accounts. In dat menu vraagt het onderdeel Amazon het recht Viewer, en de onderdelen Configuration en Accounts vragen Manager; heb je het recht voor een onderdeel niet, dan zie je dat onderdeel niet. Wat hierna volgt beschrijft de gepubliceerde code voor Odoo 20.

Vijf misverstanden over de knop

Mythe: «De knop is de gewone manier om retouren binnen te halen»

Werkelijkheid: Odoo doet dit al zelf, en de knop is de uitzondering om het handmatig te starten. In het accountformulier, tabblad Returns & Reviews, groep Returns Import, staat het selectievakje Enable returns sync, dat standaard is aangevinkt. Is het aangevinkt, dan roepen twee geplande taken, actief vanaf de installatie van de module, dezelfde import aan zonder dat je iets indrukt:

• Amazon SP-API - Sync returns, elke drie uur.
• Amazon SP-API - Auto receive returns to stock, elk kwartier.

Het verschil met de knop: de taken geven als herkomst CRON op en draaien met een instelling die voorkomt dat er berichten op het account worden geplaatst; de knop geeft als herkomst Manual op en heeft die instelling niet. Bovendien starten de twee taken deze import alleen voor accounts waarvan dat selectievakje is aangevinkt; de code van de knop raadpleegt het niet.

Mythe: «Als je de knop ziet, kun je erop klikken»

Werkelijkheid: de knop is zichtbaar in het scherm Accounts in Odoo 17, 18, 19 en 20, maar het eerste wat de actie doet is je rechten controleren. Heb je geen toegang als Manager van de connector (of tot Instellingen), dan stopt hij met deze melding:

You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Oplossing: vraag degene die de rechten beheert om je de toegang als Manager te geven. Er is een tweede controle: na die van de groepen controleert de code of je naar het account kunt schrijven. De geplande taken roepen de import rechtstreeks aan, zonder deze controle.

Mythe: «Na het klikken staan de retouren meteen klaar»

Werkelijkheid: de import hangt ervan af dat Amazon een rapport klaarmaakt, en de actie wacht daarop binnen dezelfde klik. In volgorde:

1. Hij controleert de rechten, zoals je net zag.
2. Hij vraagt Amazon het retourrapport aan te maken.
3. Hij vraagt steeds opnieuw de status van het rapport op, met een pauze tussen de pogingen. Hij stopt met vragen wanneer Amazon het als afgerond, geannuleerd of mislukt aanmerkt, of wanneer de pogingen op zijn.
4. Is het afgerond, dan downloadt hij het rapportdocument en importeert hij het, met een maximumaantal regels per uitvoering.
5. Hij stelt een samenvatting op met de rijen van het rapport, de verwerkte, de aangemaakte, de bijgewerkte, de overgeslagen en die met een fout.

De samenvatting vermeldt ook het account en de herkomst. Het is het eerste wat je na het klikken moet bekijken.

Mythe: «Als Amazon het rapport niet levert, gaat de knop kapot»

Werkelijkheid: eindigt het rapport geannuleerd of mislukt, of komt het niet op tijd, dan gaat de import niet verder: hij noteert het resultaat, plaatst het als bericht op het account (behalve bij de taken, die dat overslaan) en eindigt zonder iets te importeren. De knop blijft zichtbaar in het scherm, dus je kunt later opnieuw klikken.

Mythe: «Retouren importeren is hetzelfde als ze in voorraad ontvangen en crediteren»

Werkelijkheid: het zijn aparte opties, bijna allemaal in het tabblad Returns & Reviews van het accountformulier:

• Returns: auto-receive to stock, in de groep Return Stock Automation (ON by default). Standaard aangevinkt. De help zegt: «Automatically creates and validates return pickings in Odoo for finalized Amazon returns.» Is het aangevinkt, dan start de actie na het importeren die ontvangst met de regels van die uitvoering en voegt hij aan de samenvatting toe hoeveel er zijn beoordeeld, hoeveel er zijn uitgevoerd, hoeveel er zijn overgeslagen en hoeveel er een fout gaven.
• Auto-create credit notes (opt-in). Standaard uitgevinkt. De help zegt: «Automatically creates a draft customer credit note when the return refund amount is reported and the sale is accounted in Odoo.»
• Sync return attributes (opt-in). Standaard uitgevinkt. De help zegt: «Reads Amazon return attributes by SKU for prepaid-label and returnless-refund policies.»

Een andere optie, External returns API (opt-in), staat in het tabblad Orders & Fulfillment, groep External Shipment Sync (ON by default), en is standaard uitgevinkt. De help zegt: «Enriches return lines from Amazon External Fulfillment Returns API when an External Return ID is available.» De taak van drie uur doorloopt ook de accounts waarvoor de synchronisatie van attributen of deze externe API is aangevinkt, en start die synchronisaties naast de import wanneer dat van toepassing is.

Versies en label per taal

De knop staat in het scherm Accounts in alle gepubliceerde branches van de module: Odoo 17, 18, 19 en 20. Zijn label verandert met de taal van je Odoo: met Odoo in het Spaans is het de Spaanse tekst van de knop, en de gepubliceerde vertalingen omvatten ook Duits, Frans, Italiaans en Portugees. Met Odoo in het Nederlands staat het label in het Engels: Run Returns Import.

Wat het kost en hoe we je helpen

De module kent een eenmalige betaling per Odoo-versie en vereist het abonnement op FlexigoTech Cloud, plan Connector: € 49 per maand of € 490 per jaar, excl. btw, tot drie accounts van het platform. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld bewaart, de synchronisatie bewaakt en per e-mail waarschuwt als er iets misgaat. Zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert; de gegevens blijven in je Odoo. Je vindt de Odoo Apps-pagina en de pagina van de module.

Ben je Odoo aan het implementeren: bij FlexigoTech implementeren we Odoo 17, 18, 19 en 20 en ontwikkelen we connectors en integraties op maat.

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/en/services.html
• flexigotech.com/precios.html