Salta al contingut principal
Amazon

Què afegeix Amazon Connector a l'albarà d'Inventari: camps, botó i quan actua

El mòdul afegeix a l'albarà d'Inventari un botó, Enviar tracking Amazon, i un grup de camps, Amazon SP-API, per donar a Amazon el seguiment de l'enviament; Odoo l'envia sol en validar l'albarà o en canviar el seguiment, segons dues caselles del compte, i el botó serveix per reenviar-lo a mà.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 5 de novembre de 2026

L'essencial

Mòdul
Amazon
Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
6 min

Què afegeix el mòdul a l'albarà

El mòdul amplia l'albarà estàndard de l'app Inventari (Inventory) amb un botó i un grup de camps. La condició que mostra o amaga el botó és la mateixa a Odoo 17, 18, 19 i 20.

Esquema amb l'app Inventari a dalt i sota el botó i els camps que el mòdul li afegeix
Esquema fet amb codi a partir del codi publicat del mòdul, no és una pantalla d'Odoo; les etiquetes van en anglès.

A la fitxa de l'albarà, dins del grup Amazon SP-API, el mòdul afegeix aquests camps:

  • Amazon SP-API Account: el compte SP-API vinculat a l'albarà.
  • Amazon Order ID: l'identificador de la comanda a Amazon.
  • Amazon Sync State: només lectura. Els seus valors són Pending, Synced i Error; per defecte és Pending. El codi l'escriu, no tu.
  • Last Amazon Sync: data i hora, només lectura.
  • Tracking sent to Amazon: només lectura.
  • Amazon confirmShipment sent at: data i hora, només lectura. La seva ajuda explica que, un cop marcat, l'enviament automàtic no es repeteix ni en editar el seguiment ni en un reintent de la tasca programada; només un manual forçat pot reenviar-lo.
  • Last Amazon error: text, només lectura.
  • Payload Amazon i Amazon Response: només lectura, i només ho veuen els usuaris amb permís d'administració d'Ajustaments.

El grup sencer s'amaga si el mòdul no identifica un ID de comanda d'Amazon per a aquell albarà. Per cercar-lo mira primer el camp Amazon Order ID de l'albarà, després la comanda de venda vinculada i, finalment, altres dades de l'albarà. El botó Enviar tracking Amazon també s'amaga si l'albarà no és a l'estat Fet (Done) o no és d'una comanda d'Amazon.

Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo en anglès)

Pas a pas: quan actua el mòdul i què fer

  1. Revisa les tres caselles del compte. Són a la fitxa de Accounts, a la pestanya Orders & Fulfillment, dins del grup Order Sync. Auto sync on picking validation i Auto sync al cambiar tracking venen activades per defecte; Send confirmShipment asynchronously (via cron) (Send confirmShipment asynchronously (via cron)) ve desactivada. Cada camp del compte t'ho tens explicat a els camps del compte SP-API.
  2. Crea l'albarà. En crear-lo, el mòdul intenta identificar la comanda d'Amazon i, si ho aconsegueix, omple Amazon Order ID i Amazon SP-API Account quan estan buits. Per al compte usa el de l'albarà o el de la comanda de venda si està actiu; si no, busca els comptes actius de la companyia i, si n'hi ha un de sol, l'usa. Si n'hi ha diversos, intenta deduir quin correspon. Si no identifica cap comanda d'Amazon, no omple res.
  3. Valida l'albarà o canvia el seu seguiment. Aquest és el camí normal i no cal prémer res. En validar, Odoo intenta confirmar l'enviament a Amazon si Auto sync on picking validation està activada. En desar un albarà ja a Fet amb el seguiment canviat, ho intenta si Auto sync al cambiar tracking està activada. Amb la casella corresponent desactivada, aquest disparador no fa res.
  4. Si uses el mode asíncron, espera el reintent. Amb Send confirmShipment asynchronously (via cron) activada, la validació només deixa l'albarà en Pending i la tasca programada Amazon SP-API - Retry pending shipments (cada cinc minuts, activa en instal·lar) és l'única que envia. L'ajuda de la casella indica que aquesta tasca ha d'estar activa.
  5. Mira el grup Amazon SP-API després de validar. Amazon Sync State et diu en quin punt és l'albarà. Si és Pending, espera el següent intent. Si és Error, llegeix Last Amazon error.
  6. Reenvia a mà només si cal. El botó Enviar tracking Amazon apareix amb l'albarà a Fet i sent d'una comanda d'Amazon. Salta la comprovació de «ja enviat» i la de «ja sincronitzat amb el mateix seguiment», que el camí automàtic sí respecta. L'ajuda de Amazon confirmShipment sent at explica que aquest pestell evita la doble notificació al comprador; pensa-t'ho abans de saltar-lo. Si l'enviament falla, el botó s'atura amb Error while syncing Amazon: ….
  7. Comprova el resultat. Després d'un enviament acceptat, el mòdul omple Amazon Sync State, Last Amazon Sync, Tracking sent to Amazon i Amazon confirmShipment sent at, i buida Last Amazon error. També desa Payload Amazon i Amazon Response, que només veu qui tingui permís d'administració d'Ajustaments.
Esquema amb el text del botó Enviar tracking Amazon en alemany, francès i italià
Esquema fet amb codi a partir de les traduccions publicades, no és una pantalla d'Odoo: en alemany Amazon-Tracking senden, en francès Envoyer le suivi Amazon, en italià Invia tracking Amazon.

Què comprova el mòdul abans d'enviar

Al camí automàtic, abans d'enviar res el mòdul talla en silenci en aquests casos:

  • L'albarà no és de sortida: el mòdul només confirma a Amazon lliuraments de sortida, no devolucions.
  • L'albarà no és a Fet.
  • No troba l'ID de la comanda d'Amazon ni un compte actiu que correspongui.
  • Amazon confirmShipment sent at ja té valor.
  • L'albarà no té número de seguiment. Si n'hi ha diversos separats per espais, comes, punts i coma o salts de línia, el mòdul en pren el primer.
  • L'albarà ja figura com a Synced amb aquest mateix seguiment.

Hi ha un altre cas: si Amazon ja informa la comanda com a enviada, el mòdul no envia. Intenta omplir els camps d'estat a partir d'aquest estat extern, però només si aquell albarà és l'únic de sortida de la comanda. Amb diversos albarans de sortida per a la mateixa comanda no ho marca per si sol, perquè l'estat extern és ambigu. Aquesta comprovació d'Amazon també s'aplica en prémer el botó.

Per al transportista, el mòdul busca el mapatge del compte. Si no hi ha mapatge, l'enviament porta Other com a codi de transportista.

Pending, Error i servei suspès

Si falla l'enviament automàtic, el mòdul passa l'albarà a Error i desa el text a Last Amazon error. Si el que falta són les dades d'enviament (seguiment o transportista), l'albarà queda Pending i el camp de l'últim error es buida, per reintentar-ho quan hi hagi dades completes o Amazon ja el doni com a enviat.

Si el compte funciona a través de FlexigoTech Cloud i el connector no té servei, la validació de l'albarà segueix endavant i la confirmació queda Pending (tret que ja estigui sincronitzada o enviada). La tasca de reintents l'envia quan el servei torna, i no es marca res com a error. Sense subscripció, o amb el servei suspès, s'atura el que dóna la subscripció; les dades es queden al teu Odoo.

Subscripció i ajuda de FlexigoTech

El mòdul és de pagament únic per versió d'Odoo (17, 18, 19 i 20) i necessita la subscripció a FlexigoTech Cloud: el pla Connector costa 49 €/mes o 490 €/any sense IVA. Ho pots veure a la fitxa d'Odoo Apps o a la pàgina del mòdul. Si estàs implantant Odoo i vols ajustar el flux d'albarans amb Amazon, FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida.

Continua llegint

Camps del compte SP-API d'Amazon Connector per a Odoo: glossariGlossari dels camps del compte d'Amazon Connector per a Odoo: què diu l'ajuda de cada un, el valor per defecte i què convé posar.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts