O que fazer com «Preencha o ID do Vendedor para importar anúncios da Amazon.»

Quando surge a mensagem

Surge ao clicar no botão Importar Anúncios da Amazon (Import Listings from Amazon) na ficha de uma conta, e apenas pelo motivo que a secção seguinte explica. O botão está sempre visível no Odoo 17, 18, 19 e 20, e a mensagem consta do código publicado de todas essas versões. As ffichas de contas abrem-se a partir do menu Amazon › Configuração › Contas.

A condição, tal como o código a verifica

No Odoo 20.0, o método que importa os anúncios começa por verificar o campo ID de Vendedor (Merchant ID): se estiver vazio, ou só contiver espaços em branco, lança a mensagem e a ação é interrompida. Como esta verificação vem antes de tudo o resto, não se procura nenhum artigo do Odoo, não se pede nada à Amazon e não se guarda nenhuma alteração da importação.

A verificação só olha para se existe texto. Com o campo preenchido, a importação segue em frente e usa esse valor no pedido à Amazon.

O campo está na ficha da conta, separador Identidade, grupo Marketplace. A sua ajuda diz: Obrigatório para a Listings API (fase 2). Exemplo: A2XXXXXXXXXXXX.

Caso: uma conta acabada de criar

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

Imagine a Marta, responsável de comércio eletrónico de uma empresa inventada, Distribuciones Ribera. Acabou de criar uma conta da Amazon no Odoo e quer trazer os seus anúncios. Abre a conta, clica em Importar Anúncios da Amazon e o Odoo responde-lhe com o aviso, sem importar nada. Com o Odoo em português de Portugal vê-o assim:

A Marta não tem de investigar nada de estranho: o aviso fala de um campo concreto. Estes são os seus passos:

1. Abre Amazon › Configuração › Contas. Para lá chegar precisa da permissão Visualizador (Viewer) no nível Amazon e Gestor (Manager) em Configuração e em Contas.
2. Abre a ficha da conta.
3. Vai ao separador Identidade, grupo Marketplace, e olha para ID de Vendedor (Merchant ID). Está vazio (também bastaria que tivesse apenas espaços: o código trata-o da mesma forma).
4. Escreve o ID de vendedor. O exemplo da ajuda do campo, A2XXXXXXXXXXXX, mostra o aspeto que tem.
5. Volta a clicar em Importar Anúncios da Amazon.

Com o campo preenchido, a verificação é superada e a importação passa à fase seguinte.

O que faz a importação quando o campo está preenchido

Superada a verificação, no Odoo 20.0 o código segue esta ordem. Toma o marketplace da conta e procura os artigos do Odoo que têm referência interna e passam os filtros da conta: a empresa e, se estiverem ativados, apenas vendáveis e apenas ativos. Depois pede à Amazon os anúncios desse vendedor, página a página e até um número máximo de elementos por importação, e para cada SKU recebido cria ou atualiza a ligação de artigo dessa conta e desse marketplace. As referências comparam-se sem distinguir maiúsculas de minúsculas, e um elemento sem SKU é ignorado.

Em cada ligação, o código guarda dados do anúncio que a Amazon devolve, como o estado, a quantidade e o preço. Nessa fase, o ID de vendedor que escreveu é usado no pedido enviado à Amazon.

O que acontece com um SKU da Amazon que não coincide com nenhuma referência do Odoo depende da conta. Se tiver ativada a criação de artigos ao importar, o código procura primeiro esse SKU entre todos os artigos, incluindo os arquivados, e só se não o encontrar cria um artigo novo e liga-o. Se essa criação não estiver ativada, o código cria a ligação sem artigo do Odoo associado. Há também conflito, e o artigo não é ligado, quando a referência do Odoo já está ligada a outro SKU dessa conta e desse marketplace.

O que aprender com o caso

• O aviso é lançado pelo módulo antes de falar com a Amazon, pelo que não indica uma falha da Amazon nem da ligação: indica que falta o ID de vendedor na conta.
• Um campo só com espaços conta como vazio.
• O campo está na ficha da conta, separador Identidade, grupo Marketplace. Se não vir o menu ou um nível do percurso, falta-lhe a permissão desse nível.
• Olhar para o campo antes de clicar no botão permite ver de antemão se está vazio.

Como a FlexigoTech o ajuda

O módulo tem pagamento único por versão do Odoo, publicado para 17, 18, 19 e 20 (ficha na Odoo Apps, página em flexigotech.com). Precisa 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 e avisa por e-mail se a sincronização falhar. A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, caso precise de ajuda para deixar a conta da Amazon pronta no seu Odoo.

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): models/amazon_spapi_account.py
• Código do módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html