Què fa el botó «Fetch Labels/BOL» d'Amazon Connector for Odoo

On és el botó i quan es veu

Les fitxes dels plans d'entrada s'obren des del menú Amazon › FBA › Inbound / Send to Amazon. Cada tram d'aquest menú demana el permís Viewer: si no en tens cap, no veus aquell tram.

El botó Fetch Labels/BOL és a la pantalla Send to Amazon a Odoo 17, 18, 19 i 20. S'amaga quan el camp Shipments és buit, així que amb els valors per defecte no es veu. Aquest camp és a la fitxa, a la pestanya Placement & Transportation.

La tasca programada Amazon SP-API - Refresh open FBA inbound plans s'executa cada hora i està activa en instal·lar el mòdul. Crida l'actualització del pla, i el codi d'aquesta actualització crea o actualitza els enviaments del pla amb el que Amazon retorna, i marca com a inactius els que Amazon ja no retorna.

Amb Odoo en castellà el botó es diu Fetch Labels/BOL; en alemany, Etiketten/BOL abrufen; en francès, Récupérer les étiquettes/BOL; en italià, Recupera etichette/BOL; i en portuguès, Obter Etiquetas/BOL.

Un cas per seguir-lo pas a pas

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Casa Alba és una empresa inventada que envia mercaderia a un magatzem d'Amazon des del seu Odoo. La Marta, de logística, té accés d'Operator. Així recorre el botó:

1. La Marta obre Amazon › FBA › Inbound / Send to Amazon i entra al pla que vol preparar.
2. Va a la pestanya Placement & Transportation i mira Shipments. Si és buit, el botó no apareix. L'actualització de cada hora crea els enviaments del pla amb els que retorna Amazon, i tan bon punt n'hi ha algun el botó es veu.
3. Prem Fetch Labels/BOL. Abans de res, el mòdul comprova els seus permisos. La Marta els té, així que continua.
4. El mòdul recorre els enviaments actius del pla. Els enviaments donats de baixa no hi entren.
5. Per a cada enviament demana les etiquetes a Amazon amb el compte del pla (camp Account). Prova primer amb l'identificador de confirmació de l'enviament i, si no hi ha resposta, amb l'identificador d'Amazon de l'enviament. Descarta els buits i s'atura tan bon punt un intent retorna resposta.
6. Si hi ha resposta, la desa com a text a l'enviament.
7. Si el mode d'enviament comença per FREIGHT, demana a més el document BOL i també el desa a l'enviament.

Què comprova abans de demanar res

La primera línia del botó és una comprovació de permisos, abans de tocar cap enviament. Si el teu usuari no té accés d'Operator com a mínim, l'acció s'atura amb aquest missatge:

You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access.

Surt en prémer Fetch Labels/BOL i no es desa res. S'arregla com diu el missatge mateix: que un responsable et doni accés d'Operator o de Manager.

Tenir el grup no n'hi ha prou: el mòdul comprova a més que el teu usuari pugui escriure al pla, i aquesta comprovació també pot aturar l'acció per manca de permisos.

Què demana a Amazon i què canvia

De cada enviament actiu surt una petició d'etiquetes amb tres dades de l'enviament mateix: el tipus de pàgina, el tipus d'etiqueta i el nombre de bultos. Si l'enviament no porta tipus de pàgina o tipus d'etiqueta, el mòdul fa servir uns valors per defecte. El nombre de bultos només s'envia si l'enviament el té.

El codi del botó només escriu a l'enviament:

• La resposta d'etiquetes es desa com a text, només si hi ha hagut resposta. Es retalla als primers 20000 caràcters.
• Als enviaments FREIGHT, la resposta del BOL es desa igual, amb el mateix retall. Es demana amb l'identificador de confirmació de l'enviament o, si no n'hi ha, amb el d'Amazon.

La petició del BOL es fa encara que la d'etiquetes hagi fallat, perquè són dos blocs independents dins de cada enviament.

Què passa quan una petició falla

La petició d'etiquetes i la del BOL van cadascuna dins d'un bloc que atrapa els errors. Si una falla, el mòdul anota un avís al registre del servidor i continua amb el següent identificador o el següent enviament, sense aturar el botó. Per això, si després de prémer-lo un enviament continua sense resposta desada, la pista és en aquest registre, que consulta qui administra el servidor. En el cas de les etiquetes, l'avís inclou l'identificador que ha fallat.

Què aprendre del cas

• El botó depèn que hi hagi enviaments al pla. Si no apareix, mira primer Shipments.
• Només compten els enviaments actius.
• Si la comprovació de permisos atura l'acció, no s'ha demanat res a Amazon.
• El resultat viu a l'enviament, com a text.

Com ajuda FlexigoTech

El mòdul es publica a Odoo Apps per a Odoo 17, 18, 19 i 20 (fitxa, pàgina del mòdul). És de pagament únic per versió i necessita la subscripció a FlexigoTech Cloud, pla Connector: 49 €/mes o 490 €/any sense IVA. FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, per si necessites ajustar aquest flux a la teva operativa d'entrades.

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_inbound_plan_views.xml
• Codi del mòdul: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_inbound_plan.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html