Naar hoofdinhoud
Amazon

Zo boek je Amazon-retouren terug in de Odoo-voorraad

Met de Amazon-connector komt de retour van een order die je zelf hebt verzonden vanzelf terug in het Odoo-magazijn. Elke 15 minuten bekijkt de module de retouren die van Amazon zijn binnengekomen en zodra er een is afgerond, maakt hij de retourlevering aan op basis van de oorspronkelijke levering en valideert hij die. Jouw werk is de instellingen van het account goed te zetten en af en toe te kijken naar de retouren die blijven hangen.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 4 november 2026

In het kort

Module
Amazon
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 17.0, 18.0, 19.0 en 20.0 · in de bronnen onderaan
Leestijd
5 min

Voordat je begint

  • Dit geldt voor orders die je zelf verwerkt (FBM). Een FBA-retour ontvangt Amazon in zijn eigen magazijn: de module maakt er geen lokale voorraadbeweging voor aan en de hoeveelheid wordt rechtgezet via de synchronisatie van de FBA-voorraad.
  • De retouren moeten in Odoo binnenkomen. De taak "Amazon SP-API - Sync returns" haalt ze elke 3 uur op naar Amazon › Returns & Cases › Returns.
  • De order moet in Odoo een gevalideerde levering hebben. Zonder gevalideerde levering is er niets om de retour op te baseren.
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Video: Your Odoo doesn't talk to Amazon, Temu or Shopify? (video in het Engels)

Stap voor stap

  1. Open Amazon › Configuration › Accounts en ga naar het Amazon-account dat je wilt instellen.
  2. Ga naar het tabblad "Returns & Reviews" en zoek de groep "Return Stock Automation".
  3. Controleer of "Returns: auto-receive to stock" aangevinkt is.
  4. Bepaal wanneer een retour als afgerond geldt. Standaard is "Returns stock: require refund amount" aangevinkt (alleen wat Amazon al heeft terugbetaald, komt binnen), "Returns stock: allow pending-action returns" uitgevinkt (wat nog een openstaande actie heeft, wacht) en "Returns stock: require return delivery date" uitgevinkt.
  5. Laat "Returns stock: strict SKU matching" aangevinkt als de SKU die je op Amazon gebruikt de referentie van het product in Odoo is. Zo komt er nooit een ander product in het magazijn dan het verkochte.
  6. Wil je de creditfactuur klaar hebben staan, vink dan in de groep "Credit Notes (opt-in)" het vakje "Auto-create credit notes (opt-in)" aan: het maakt de creditfactuur in concept aan en staat standaard uit.
  7. Klik op "Run Return Stock Automation" om de eerste ronde te draaien zonder op de geplande taak te wachten.
Schema van de weg van een Amazon-retour naar de Odoo-voorraad
De weg van elke retour met de labels die je in Odoo ziet: binnen via "Sync returns", gecontroleerd door "Auto receive returns to stock" en afgerond in een gevalideerde retourlevering. Schema gemaakt op basis van de code van de module.

Wat Odoo controleert voordat het de voorraad aanraakt

De taak "Amazon SP-API - Auto receive returns to stock" loopt elke 15 minuten de retouren van het account na die nog niet op Done staan. Ze begint bij de recentste en bekijkt er tot 300 per ronde, als je dat maximum niet hebt veranderd. De samenvatting van elke ronde staat in het account zelf.

Een retour valt af, met de reden op de regel, als een van deze dingen speelt:

SituatieNotitie op de regel
De geretourneerde hoeveelheid is nulReturn quantity is zero.
Amazon meldt een openstaande actie en je staat die niet toePending action still required.
Je eist een terugbetaling en Amazon heeft nog niet terugbetaaldRefund amount is required before stock return.
Er is geen afsluitende status, geen terugbetaling en geen leverdatumReturn does not look finalized yet.
Iemand heeft hem gemarkeerd als niet terug op voorraadReturn marked as do not restock.

Die regels komen op Skipped en de taak bekijkt ze bij haar volgende ronde opnieuw: zodra er een aan de voorwaarden voldoet, komt hij vanzelf binnen.

Als de order of de levering niet wordt gevonden

Is de retour klaar, dan zoekt de module de verkooporder en de bijbehorende gevalideerde levering, bereidt hij de retour voor met de retourwizard van Odoo en valideert hij die. De regel gaat naar Done met de notitie Stock return processed in picking %s., met daarin de naam van de nieuwe levering.

Klopt er iets niet, dan staat dat in de notitie: Sale order not found for Amazon order %s., No sale lines mapped for return reference %(ref)s in order %(order)s. of No delivered outgoing picking found for %s.. In de automatische ronde blijft de regel op Skipped staan; start je hem zelf, dan op Error. Dat gebeurt bijvoorbeeld als de geretourneerde SKU niet de verkochte is en je strikte matching hebt aangevinkt. Zo los je het op:

  • Open de regel in Amazon › Returns & Cases › Returns.
  • Vul de herkomst in bij "Source Sale Order", "Source Sale Line" of "Source Delivery Picking". De automatische koppeling overschrijft die velden niet als ze al een waarde hebben.
  • Klik op "Receive to Stock Now". Die verwerkt de regel meteen, zonder te wachten tot de retour afgerond lijkt. De knop verschijnt niet bij FBA-retouren, bij retouren gemarkeerd als Do not restock en bij retouren die al verwerkt zijn.
Lijst met Amazon-retouren in Odoo
De lijst met Amazon-retouren in Odoo, met aanvraagdatum, order, SKU, hoeveelheid, status en reden van elke retour. Schermafbeelding van Odoo met vervaagde gegevens.

Retouren die niet terug in het magazijn horen

Een kapot of onvolledig artikel hoort de verkoopbare voorraad niet te verhogen. Zet, voordat de taak het oppakt, op de regel "Stock Link Mode" op Do not restock: de retour komt op Skipped met zijn notitie en er beweegt niets. Om ze later terug te vinden, heeft de lijst de filters "Do Not Restock" en "Manual Stock Review".

Elke regel heeft zijn eigen voorraadstatus: Pending zolang hij wacht, Done als hij binnen is, Skipped als hij opzij is gezet en Error als hij mislukte toen je hem handmatig startte.

En de creditfactuur voor de klant?

De terugbetaling aan de koper doet Amazon. In Odoo zet de knop "Create Credit Note Draft" op elke regel de creditfactuur in concept klaar, en "Refresh Amazon Refund" vraagt bij Amazon opnieuw de status van de terugbetaling op. Heb je "Auto-create credit notes (opt-in)" aangevinkt, dan wordt de creditfactuur in concept vanzelf aangemaakt.

Werkt het in alle versies hetzelfde?

Ja. Deze instellingen, taken en meldingen zitten in de module die is gepubliceerd voor Odoo 17, 18, 19 en 20.

Lees verder

Retouren in een webshop zonder ERP: de termijnen en wat er onderweg verloren gaatDe termijnen van de Spaanse wet voor een retour bij verkoop op afstand, welke papieren dat oplevert en waar je de grip verliest met spreadsheets.Zo begin je met Odoo als je al op Amazon verkooptGids voor Amazon-verkopers zonder Odoo: wat er verandert, in welke volgorde je het inricht en wat de connector doet met orders, FBA, afrekeningen en retouren.Amazon-woordenlijst voor wie in Odoo werktFBA, FBM, SP-API, LWA, settlement, VCS, gestrande voorraad en meer: wat elke Amazon-term betekent en waar je hem in Odoo ziet met de connector.
Gecontroleerd in de broncode van de connector (versie 17.0, 18.0, 19.0 en 20.0) en in de gelinkte bronnen

Bronnen

  • Broncode van de module: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: views/amazon_spapi_account_views.xml
  • Broncode van de module: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: models/amazon_spapi_account.py
  • Broncode van de module: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: data/ir_cron_data.xml
  • Broncode van de module: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: models/amazon_spapi_return_line.py
  • Broncode van de module: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: views/amazon_spapi_return_line_views.xml
  • Broncode van de module: flexigobe_amazon_seller_connector 20.0 (e9fb0850): views/menu_views.xml
  • apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector