Abans de començar
- Això és per a les comandes que prepares tu (FBM). Una devolució FBA la rep Amazon al seu magatzem: el mòdul no crea cap moviment local per a ella i la quantitat es quadra amb la sincronització de l'inventari FBA.
- Les devolucions han d'estar entrant a Odoo. La tasca «Amazon SP-API - Sync returns» les porta cada 3 hores a Amazon › Returns & Cases › Returns.
- La comanda ha de tenir el seu albarà de sortida lliurat a Odoo. Sense un lliurament validat no hi ha res sobre què fer la devolució.

Pas a pas
- Obre Amazon › Configuration › Accounts i entra al compte d'Amazon que vols configurar.
- Ves a la pestanya «Returns & Reviews» i busca el grup «Return Stock Automation».
- Comprova que «Returns: auto-receive to stock» està marcada.
- Decideix quan es considera tancada una devolució. De sèrie, «Returns stock: require refund amount» està marcada (només entra el que Amazon ja ha reemborsat), «Returns stock: allow pending-action returns» està desmarcada (el que té una acció pendent espera) i «Returns stock: require return delivery date» està desmarcada.
- Deixa marcada «Returns stock: strict SKU matching» si l'SKU que fas servir a Amazon és la referència del producte a Odoo. Així mai no entra al magatzem un producte diferent del que es va vendre.
- Si vols la factura rectificativa preparada, marca al grup «Credit Notes (opt-in)» la casella «Auto-create credit notes (opt-in)»: crea la rectificativa en esborrany i ve desmarcada.
- Prem «Run Return Stock Automation» per fer la primera passada sense esperar la tasca programada.

Què mira Odoo abans de tocar l'estoc
La tasca «Amazon SP-API - Auto receive returns to stock» passa cada 15 minuts per les devolucions del compte que encara no són a Done. Comença per les més recents i en revisa fins a 300 per passada si no has canviat aquest màxim. El resum de cada passada queda al mateix compte.
Una devolució es queda fora, amb el motiu escrit a la línia, quan passa alguna d'aquestes coses:
| Situació | Nota a la línia |
|---|---|
| La quantitat retornada és zero | Return quantity is zero. |
| Amazon marca una acció pendent i no les admets | Pending action still required. |
| Exigeixes reemborsament i Amazon encara no ha reemborsat | Refund amount is required before stock return. |
| No hi ha estat de tancament, ni reemborsament, ni data de lliurament | Return does not look finalized yet. |
| Algú la va marcar per no reposar-la | Return marked as do not restock. |
Aquestes línies queden a Skipped i la tasca les torna a mirar a la seva passada següent: tan bon punt una compleix les condicions, entra sola.
Si no troba la comanda o el lliurament
Amb la devolució a punt, el mòdul busca la comanda de venda i el seu albarà de sortida lliurat, prepara la devolució amb l'assistent de devolucions d'Odoo i la valida. La línia passa a Done amb la nota Stock return processed in picking %s., on hi va el nom de l'albarà nou.
Quan alguna cosa no casa, la nota ho diu: Sale order not found for Amazon order %s., No sale lines mapped for return reference %(ref)s in order %(order)s. o No delivered outgoing picking found for %s.. A la passada automàtica la línia es queda a Skipped; si la llances tu, a Error. Passa, per exemple, quan l'SKU retornat no és el venut i tens marcada la coincidència estricta. S'arregla així:
- Obre la línia a Amazon › Returns & Cases › Returns.
- Omple l'origen a «Source Sale Order», «Source Sale Line» o «Source Delivery Picking». La vinculació automàtica no trepitja aquests camps si ja tenen valor.
- Prem «Receive to Stock Now». Processa aquella línia a l'instant, sense esperar que la devolució sembli tancada. El botó no apareix a les devolucions FBA, a les marcades com a Do not restock ni a les que ja estan fetes.

Les que no han de tornar al magatzem
Un article trencat o incomplet no hauria de sumar estoc vendible. Abans que la tasca el reculli, canvia a la línia «Stock Link Mode» a Do not restock: la devolució queda a Skipped amb la seva nota i no es mou res. Per trobar-les després, la llista té els filtres «Do Not Restock» i «Manual Stock Review».
Cada línia porta el seu estat d'estoc: Pending mentre espera, Done quan ja ha entrat, Skipped si s'ha apartat i Error si ha fallat en llançar-la a mà.
I la factura rectificativa al client?
El reemborsament al comprador el fa Amazon. A Odoo, el botó «Create Credit Note Draft» de cada línia prepara la rectificativa en esborrany, i «Refresh Amazon Refund» torna a consultar a Amazon l'estat del reemborsament. Si vas marcar «Auto-create credit notes (opt-in)», la rectificativa en esborrany es crea sola.
Funciona igual a totes les versions?
Sí. Aquests ajustos, tasques i missatges són al mòdul publicat per a Odoo 17, 18, 19 i 20.
Continua llegint
Comprovat al codi del connector (versió 17.0, 18.0, 19.0 i 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: views/amazon_spapi_account_views.xml
- Codi del mòdul: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: models/amazon_spapi_account.py
- Codi del mòdul: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: data/ir_cron_data.xml
- Codi del mòdul: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: models/amazon_spapi_return_line.py
- Codi del mòdul: flexigobe_amazon_seller_connector · 17.0 9a6d49f · 18.0 aecae86 · 19.0 fa9ae73 · 20.0 be50529: views/amazon_spapi_return_line_views.xml
- Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (e9fb0850): views/menu_views.xml
- apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
