Què fa el botó «Test SP-API Connection» del connector d'Amazon per a Odoo

On és el botó i qui hi arriba

Les fitxes dels comptes s'obren des del menú Amazon › Configuration › Accounts. Cada tram del menú demana un permís i, si no el tens, no veus aquest tram: Amazon demana Viewer, Configuration demana Manager i Accounts també demana Manager. El botó Test SP-API Connection és a la pantalla de Accounts a les branques 17.0, 18.0, 19.0 i 20.0, i a les quatre es veu sempre.

Un cas per recórrer-lo de dalt a baix

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

Ferretería Norte és una empresa inventada que ja fa servir Odoo i acaba de crear el seu compte d'Amazon al mòdul. La Lucía, que administra el sistema i té el permís Manager del connector, obre Amazon › Configuration › Accounts, entra a la fitxa del compte i va a la pestanya Identity, grup Marketplace. Allà hi ha Marketplace ID, que també surt a la llista de Accounts. L'ajuda del camp posa com a exemple per a ES A1RKKUPIHCS9HS, i aquest és també el seu valor per defecte al codi. La Lucía comprova que el valor correspon al marketplace on ven, perquè el botó l'utilitza en la seva petició, i prem Test SP-API Connection.

Com que la Lucía té el permís Manager del connector i pot modificar el compte, el botó continua: demana a Amazon la llista de comandes i, en acabar, la fitxa rep el missatge Amazon SP-API connection validated successfully.. Si un usuari sense el permís Manager del connector ni el de Configuració arriba a llançar l'acció, el mòdul l'atura abans de parlar amb Amazon i mostra l'avís que s'explica més avall.

Què fa el botó, per ordre

Aquest és el recorregut que segueix el codi d'Odoo 20.0, i el botó existeix amb el mateix nom a les altres branques publicades:

1. Comprova el teu permís. Deixa passar el superusuari del sistema; a qualsevol altre usuari li exigeix el permís Manager del connector o el de Configuració. Com que els grups no basten, comprova a més que tinguis permís d'escriptura sobre el compte.
2. Per a cada compte, calcula una data de fa dos dies (en UTC) i demana a Amazon, amb una lectura, la llista de comandes creades des d'aquesta data al marketplace del compte. Fa servir el valor de Marketplace ID sense espais sobrants als extrems.
3. Quan la petició ha acabat, publica a la fitxa del compte el missatge Amazon SP-API connection validated successfully.

El botó no fa res més amb la resposta: la petició serveix de prova i el que queda a la vista és aquest missatge. Totes les crides a SP-API del mòdul passen per un punt comú, i la petició d'aquest botó també.

El missatge que pot aturar el botó

Al prémer el botó, la comprovació de permisos pot aturar l'acció amb aquest missatge:

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

Surt perquè l'usuari no té el permís Manager del connector ni el de Configuració. Com que és el primer que fa el botó, l'acció s'atura aquí i no s'arriba a demanar res a Amazon. El que toca és el que diu l'avís: demanar a un responsable que concedeixi aquest permís.

El que el botó no substitueix

La petició del botó fa servir el mateix mètode de crides a SP-API al qual arriben, sense prémer res, diverses tasques programades del codi d'Odoo 20.0, totes actives en instal·lar. Però aquestes tasques demanen altres coses:

• Definicions de tipus de producte: Amazon SP-API - Auto-repair queue v2, cada tres minuts, i Amazon SP-API - Sync pending bindings (price/stock), cada minut.
• Una comanda concreta: Amazon SP-API - Messaging context refresh, cada trenta minuts; Amazon SP-API - Messaging sync, cada quinze minuts; Amazon SP-API - Retry pending shipments, cada cinc minuts, i Amazon: Import Orders, cada quinze minuts.
• Un token de dades restringides: també Amazon: Import Orders.

Per això el missatge de validació et diu que la petició de la llista de comandes ha anat bé, no que cadascuna d'aquestes tasques ho vagi a fer.

Què aprendre del cas

• Abans de prémer, mira Marketplace ID a la pestanya Identity: és el valor que viatja a la petició.
• L'avís d'accés parla de permisos, no de la connexió amb Amazon. El botó només continua si l'usuari té el permís Manager del connector o el de Configuració i a més pot modificar el compte.
• El resultat correcte queda escrit a la fitxa del compte.

Amb Odoo en català el botó es mostra com Test SP-API Connection.

Cost i versions

El mòdul està publicat per a Odoo 17.0, 18.0, 19.0 i 20.0, és de pagament únic per versió (el preu de cadascuna és a la fitxa d'Odoo Apps) i necessita la subscripció a FlexigoTech Cloud. El pla Connector costa 49 €/mes o 490 €/any sense IVA, amb fins a 3 comptes de la plataforma. La connexió passa per FlexigoTech Cloud, que guarda xifrades les credencials. Tens el detall a la pàgina del mòdul.

Com ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si estàs posant en marxa el compte d'Amazon al teu Odoo i vols que algú revisi permisos i dades del compte amb tu, escriu-nos.

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/precios.html
• flexigotech.com/en/services.html