Sincronizar metadados do marketplace no conector da Amazon: mitos e realidade

Onde está e o que faz, por ordem

O botão está no ecrã Contas, a que se chega pelo menu Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Para ver esse menu completo é preciso a permissão Gestor (Manager) nos níveis Configuração (Configuration) e Contas; o nível Amazon pede Visualizador (Viewer). O botão existe em todas as ramificações publicadas do módulo: Odoo 17, 18, 19 e 20.

Ao carregar no botão, o módulo faz isto, por esta ordem:

1. Verifica as tuas permissões: tens de ter a permissão Gestor do conector da Amazon ou acesso às Definições. Depois verifica ainda que podes escrever na conta.
2. Pede à Amazon a lista de marketplaces em que a conta participa.
3. Percorre essa lista e, de cada marketplace que traga identificador, prepara os dados: nome (se não trouxer nome, usa o identificador), identificador, região e endpoint da conta, código de país, domínio e alias do canal de venda calculados a partir do domínio.
4. Se o módulo já tiver esse marketplace, atualiza-o com esses dados e soma um a Actualizados; se não, cria um novo e soma um a Creados.
5. Publica uma mensagem na ficha da conta com a contagem de criados e atualizados.

Seis ideias erradas sobre este botão

«Só aparece em algumas versões ou em algum estado»

Não. O botão Sincronizar Metadados do Marketplace vê-se sempre no ecrã Contas, no Odoo 17, 18, 19 e 20. O que muda de pessoa para pessoa é se chega até esse ecrã: o nível Configuração e o nível Contas pedem Gestor, pelo que quem tiver apenas Visualizador não verá o caminho até à conta.

«Se vejo o menu da Amazon, posso carregar no botão»

Ver o nível Amazon (que pede Visualizador) não basta. O botão verifica a permissão no servidor, e não apenas no ecrã: se não tiveres a permissão Gestor do conector nem acesso às Definições, a ação é interrompida com esta mensagem:

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

Aparece ao carregar no botão. Resolve-se como diz a própria mensagem: alguém com permissão de gestor do conector tem de te conceder esse acesso. O código acrescenta uma segunda verificação depois dos grupos: que possas escrever na conta, porque estas ações leem os seus registos com privilégios elevados, acima da regra por empresa. Os processos do servidor que já correm com privilégios de superutilizador passam sem essa verificação.

«Sincroniza toda a conta da Amazon»

O que o botão faz é trabalhar com a lista de marketplaces. Por cada um guarda o nome, o identificador, a região, o endpoint, o código de país, o domínio e os alias do canal de venda. Esses são os dados que escreve, e o próprio código do método mostra-o.

«De cada vez que carrego no botão criam-se marketplaces novos»

Por cada marketplace que chega com identificador, se o módulo já o tiver, atualiza-o e soma um a Actualizados. Se não o tiver, cria um novo e soma um a Creados. Os marketplaces que chegam sem identificador são ignorados, sem criar nada.

A mensagem que fica na conta dá-te essas duas contagens, pelo que, depois de cada clique, podes ver quantos registos foram criados e quantos foram atualizados.

Se o que volta da Amazon não for uma resposta com marketplaces, não há nada para percorrer e a mensagem final sai com zero criados e zero atualizados.

«A região e o endpoint são detetados automaticamente»

Não são detetados: são copiados da conta. Todos os marketplaces que a chamada devolve são guardados com a Região (Region) e o Endpoint SP-API (SP-API Endpoint) da conta, que se veem na ficha de Contas, separador Identidade (Identity), grupo Marketplace. Antes de carregares no botão, revê ambos os campos.

A Região tem estas opções: Europa (eu-west-1), América do Norte (us-east-1) e Extremo Oriente (us-west-2). Por defeito o código usa Europa (eu-west-1) e, para o endpoint, https://sellingpartnerapi-eu.amazon.com. Se, ao guardar o marketplace, esses valores chegassem vazios, o código aplica esses mesmos.

«Se não aparece erro, não sei o que aconteceu»

Ao terminar, o módulo publica uma mensagem na ficha da conta. Com o Odoo em português de Portugal lê-se assim:

Sincronização de metadados do marketplace concluída. Conta: …. Criados: …. Atualizados: …. (Marketplace metadata sync finished. Account: …. Created: …. Updated: ….)

Aí constam o nome da conta e as duas contagens.

Uma verificação rápida antes de carregar

• Tens a permissão Gestor do conector (ou acesso às Definições).
• A Região e o Endpoint SP-API da conta são os que queres para todos os marketplaces que forem guardados.
• Depois de carregares, abres a ficha da conta e lês a mensagem com Creados e Actualizados.

Outros botões do módulo explicam-se igualmente passo a passo, por exemplo Pré-visualização na Amazon.

O que há a ter em conta sobre o módulo

O módulo é de pagamento único por versão do Odoo (17, 18, 19 e 20) e necessita da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar. Tens a ficha do módulo em a página de flexigotech.com.

Se estás a implementar o Odoo e queres ligar as tuas contas da Amazon com ajuda, na FlexigoTech implementamos o Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida.

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