O que faz o botão «Testar Ligação SP-API» do conector da Amazon para Odoo

Onde está o botão e quem lhe chega

As fichas das contas abrem-se a partir do menu Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Cada troço do menu pede uma permissão e, se não a tiveres, não vês esse troço: Amazon pede Visualizador (Viewer), Configuração pede Gestor (Manager) e Contas também pede Gestor. O botão Testar Ligação SP-API está no ecrã de Contas nos ramos 17.0, 18.0, 19.0 e 20.0, e nos quatro vê-se sempre.

Um caso para percorrer do princípio ao fim

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

Ferretería Norte é uma empresa inventada que já usa o Odoo e acabou de criar a sua conta da Amazon no módulo. A Lucía, que administra o sistema e tem a permissão Gestor do conector, abre Amazon › Configuração › Contas, entra na ficha da conta e vai ao separador Identidade (Identity), grupo Marketplace. Aí está ID do marketplace (Marketplace ID), que também aparece na lista de Contas. A ajuda do campo dá como exemplo para ES A1RKKUPIHCS9HS, e esse é também o seu valor por defeito no código. A Lucía verifica que o valor corresponde ao marketplace em que vende, porque o botão o usa no seu pedido, e carrega em Testar Ligação SP-API.

Como a Lucía tem a permissão Gestor do conector e pode modificar a conta, o botão avança: pede à Amazon a lista de encomendas e, ao terminar, a ficha recebe a mensagem Ligação Amazon SP-API validada com sucesso. (Amazon SP-API connection validated successfully.). Se um utilizador sem a permissão Gestor do conector nem a das Definições chegar a lançar a ação, o módulo pára-a antes de falar com a Amazon e mostra o aviso que se explica mais abaixo.

O que faz o botão, por ordem

Este é o percurso que segue o código do Odoo 20.0, e o botão existe com o mesmo nome nos restantes ramos publicados:

1. Verifica a tua permissão. Deixa passar o superutilizador do sistema; a qualquer outro utilizador exige a permissão Gestor do conector ou a das Definições. Como os grupos não bastam, verifica ainda que tens permissão de escrita sobre a conta.
2. Para cada conta, calcula uma data de há dois dias (em UTC) e pede à Amazon, com uma leitura, a lista de encomendas criadas desde essa data no marketplace da conta. Usa o valor de ID do marketplace sem espaços a mais nos extremos.
3. Quando o pedido terminou, publica na ficha da conta a mensagem Ligação Amazon SP-API validada com sucesso.

O botão não faz mais nada com a resposta: o pedido serve de prova e o que fica à vista é essa mensagem. Todas as chamadas à SP-API do módulo passam por um ponto comum, e o pedido deste botão também.

A mensagem que pode parar o botão

Ao carregar no botão, a verificação de permissões pode parar a ação com esta mensagem:

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

Aparece porque o utilizador não tem a permissão Gestor do conector nem a das Definições. Como é a primeira coisa que o botão faz, a ação pára aí e nem se chega a pedir nada à Amazon. O que cabe fazer é o que diz o aviso: pedir a um gestor que conceda essa permissão.

O que o botão não substitui

O pedido do botão usa o mesmo método de chamadas à SP-API a que chegam, sem carregar em nada, várias tarefas agendadas do código do Odoo 20.0, todas ativas ao instalar. Mas essas tarefas pedem outras coisas:

• Definições de tipos de artigo: Amazon SP-API - Fila de reparação automática v2 (Amazon SP-API - Auto-repair queue v2), de três em três minutos, e Amazon SP-API - Sincronizar associações pendentes (preço/stock) (Amazon SP-API - Sync pending bindings (price/stock)), a cada minuto.
• Uma encomenda concreta: Amazon SP-API - Atualização do contexto de mensagens (Amazon SP-API - Messaging context refresh), a cada trinta minutos; Amazon SP-API - Sincronização de mensagens (Amazon SP-API - Messaging sync), a cada quinze minutos; Amazon SP-API - Reenviar envios pendentes (Amazon SP-API - Retry pending shipments), a cada cinco minutos, e Amazon: Importar Encomendas (Amazon: Import Orders), a cada quinze minutos.
• Um token de dados restritos: também Amazon: Importar Encomendas.

Por isso a mensagem de validação diz-te que o pedido da lista de encomendas correu bem, não que cada uma dessas tarefas o vá fazer.

O que aprender com o caso

• Antes de carregar, vê ID do marketplace no separador Identidade: é o valor que viaja no pedido.
• O aviso de acesso fala de permissões, não da ligação com a Amazon. O botão só avança se o utilizador tiver a permissão Gestor do conector ou a das Definições e puder, além disso, modificar a conta.
• O resultado correto fica escrito na ficha da conta.

Com o Odoo em português de Portugal, o botão chama-se Testar Ligação SP-API.

Custo e versões

O módulo está publicado para o Odoo 17.0, 18.0, 19.0 e 20.0, é de pagamento único por versão (o preço de cada uma está na ficha do Odoo Apps) e precisa da subscrição do FlexigoTech Cloud. O plano Conector custa 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais. Tens o detalhe na página do módulo.

Como ajuda a FlexigoTech

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se estás a pôr em marcha a conta da Amazon no teu Odoo e queres que alguém reveja contigo as permissões e os dados da conta, escreve-nos.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
• Código do módulo: 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