Què fa el botó «Run Returns Import» d'Amazon a Odoo

On és el botó i quins permisos demana el menú

El botó Run Returns Import és a la pantalla Accounts, a la qual s'arriba per Amazon › Configuration › Accounts. En aquest menú, el tram Amazon demana el permís Viewer, i els trams Configuration i Accounts demanen Manager; si no tens el permís d'un tram, no veus aquest tram. El que ve a continuació descriu el codi publicat per a Odoo 20.

Cinc idees equivocades sobre el botó

Mite: «El botó és la forma normal de portar les devolucions»

Realitat: Odoo ja ho fa sol, i el botó és l'excepció per llançar-ho a mà. A la fitxa del compte, pestanya Returns & Reviews, grup Returns Import, hi ha la casella Enable returns sync, que ve marcada per defecte. Amb ella marcada, dues tasques programades, actives en instal·lar el mòdul, criden la mateixa importació sense que premis res:

• Amazon SP-API - Sync returns, cada tres hores.
• Amazon SP-API - Auto receive returns to stock, cada quinze minuts.

La diferència amb el botó: les tasques indiquen com a origen CRON i s'executen amb un ajust que evita publicar missatges al compte; el botó indica com a origen Manual i no porta aquest ajust. A més, les dues tasques només llancen aquesta importació als comptes que tenen aquesta casella marcada; el codi del botó no la consulta.

Mite: «Si veus el botó, el pots prémer»

Realitat: el botó és a la vista a la pantalla Accounts a Odoo 17, 18, 19 i 20, però el primer que fa l'acció és comprovar els teus permisos. Si no tens accés de Manager del connector (ni de Configuració), s'atura amb aquest missatge:

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

Solució: demana a qui gestioni els permisos que et doni l'accés de Manager. Hi ha una segona comprovació: després de la dels grups, el codi verifica que pots escriure al compte. Les tasques programades criden directament la importació, sense passar per aquest control.

Mite: «En prémer, les devolucions apareixen a l'instant»

Realitat: la importació depèn que Amazon prepari un informe, i l'acció espera dins de la mateixa pulsació. En ordre:

1. Comprova els permisos, com acabes de veure.
2. Demana a Amazon que creï l'informe de devolucions.
3. Consulta una vegada i una altra l'estat de l'informe, amb una pausa entre intents. Deixa de preguntar quan Amazon el dona per acabat, cancel·lat o fallit, o quan s'acaben els intents.
4. Si està acabat, descarrega el document de l'informe i l'importa, amb un màxim de línies per execució.
5. Munta un resum amb les files de l'informe, les processades, les creades, les actualitzades, les saltades i les que tenen error.

El resum també indica el compte i l'origen. És el primer que convé mirar després de prémer.

Mite: «Si Amazon no lliura l'informe, el botó es trenca»

Realitat: quan l'informe acaba cancel·lat o fallit, o no arriba a temps, la importació no continua: anota el resultat, el publica com a missatge al compte (excepte a les tasques, que ho ometen) i acaba sense importar res. El botó continua a la vista a la pantalla, de manera que pots tornar a prémer-lo més tard.

Mite: «Importar devolucions és el mateix que rebre-les a l'estoc i abonar-les»

Realitat: són opcions separades, quasi totes a la pestanya Returns & Reviews de la fitxa del compte:

• Returns: auto-receive to stock, al grup Return Stock Automation (ON by default). Ve marcada. La seva ajuda diu: «Automatically creates and validates return pickings in Odoo for finalized Amazon returns.» Si està marcada, després d'importar, l'acció llança aquesta recepció amb les línies d'aquesta execució i afegeix al resum quantes ha avaluat, quantes ha fet, quantes ha saltat i quantes han donat error.
• Auto-create credit notes (opt-in). Ve desmarcada. La seva ajuda diu: «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). Ve desmarcada. La seva ajuda diu: «Reads Amazon return attributes by SKU for prepaid-label and returnless-refund policies.»

Una altra opció, External returns API (opt-in), és a la pestanya Orders & Fulfillment, grup External Shipment Sync (ON by default), i ve desmarcada. La seva ajuda diu: «Enriches return lines from Amazon External Fulfillment Returns API when an External Return ID is available.» La tasca de les tres hores recorre també els comptes amb la sincronització d'atributs o amb aquesta API externa marcades, i llança aquestes sincronitzacions a més de la importació quan correspon.

Versions i rètol segons l'idioma

El botó és a la pantalla Accounts en totes les branques publicades del mòdul: Odoo 17, 18, 19 i 20. El seu rètol canvia amb l'idioma del teu Odoo: amb Odoo en català és Run Returns Import, i les traduccions publicades inclouen també alemany, francès, italià i portuguès.

Què costa i com t'ajudem

El mòdul és de pagament únic per versió d'Odoo i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any, sense IVA, fins a tres comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials, vigila la sincronització i avisa per correu si falla. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció; les dades es queden al teu Odoo. Tens la fitxa d'Odoo Apps i la pàgina del mòdul.

Si estàs implantant Odoo, a FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida.

Continua llegint

Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
• Codi del mòdul: 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