O que faz o botão «Sincronizar anúncios suprimidos» do Amazon Connector for Odoo

O normal: a sincronização já corre sozinha

A tarefa agendada Amazon SP-API - Sincronizar relatório de anúncios suprimidos (opt-in) (Amazon SP-API - Sync suppressed listings report (opt-in)) executa-se uma vez por dia e vem ativa ao instalar o módulo. Percorre as contas ativas que têm a sincronização de anúncios suprimidos ativada e lança, para cada uma, o mesmo processo que o botão, com origem CRON e sem deixar o resumo no chatter da conta.

O botão é a exceção: serve para lançar esse mesmo processo à mão, sem esperar pela tarefa. Enquanto a tarefa percorre as contas com a sincronização ativada, o botão atua sobre a conta da ficha em que o carrega.

Onde está e quando aparece

O caminho é Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Cada troço do menu pede uma permissão e, se não a tiver, não vê esse troço: Amazon pede Visualizador (Viewer), enquanto Configuração (Configuration) e Contas (Accounts) pedem Gestor (Manager).

O botão está no ecrã Contas e vê-se sempre, sem depender de nenhum estado. Existe nas ramas publicadas do módulo, para Odoo 17, 18, 19 e 20.

Um caso: a Marta, da Hogar Norte

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

A Hogar Norte é uma loja inventada que vende na Amazon e tem o catálogo no Odoo. A Marta, responsável pelo catálogo, tem a permissão Gestor do conector. Numa manhã quer rever de imediato os anúncios suprimidos de uma das suas contas, sem esperar pela tarefa de cada dia.

Abre Amazon › Configuração › Contas, entra na ficha da conta e carrega em Sincronizar anúncios suprimidos. O Odoo verifica a sua permissão, pede o relatório à Amazon, espera que esteja pronto, descarrega-o e importa-o. No fim, no chatter da conta fica o resumo com Origen: Manual (Source: Manual).

O colega Pablo só tem a permissão Visualizador: vê o troço Amazon do menu, mas não Configuração. Se alguém que não é gestor nem tem acesso às Definições chegasse a lançar a ação, deparar-se-ia com a mensagem de permissões que explicamos a seguir.

O que verifica antes de começar

O primeiro passo é a permissão. Se o seu utilizador não está no grupo de gestores do conector nem no das Definições, a ação para com esta mensagem:

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

A solução é a que diz a própria mensagem: pedir a um gestor que lhe dê acesso Gestor. Com a permissão em ordem, o módulo verifica ainda que pode escrever nessa conta, porque estas ações leem os seus registos com permissões elevadas, acima da regra por empresa. Depois trabalha com uma só conta de cada vez.

O que faz, por ordem

1. Prepara o pedido do relatório de anúncios suprimidos e envia-o à Amazon, que responde com um identificador de relatório.
2. Consulta o estado do relatório várias vezes, com uma pausa entre consultas, até a Amazon o dar por terminado, cancelado ou falhado, ou até se esgotarem as tentativas. Se a conta não tiver valores para isto, o código usa doze tentativas com dez segundos de pausa.
3. Se o relatório não terminou bem, ou terminou sem documento para descarregar, regista o resultado e para: não há importação.
4. Se há documento, descarrega-o e importa as suas linhas, com o marketplace da conta e um máximo de dez mil linhas por execução se a conta não tiver outro valor.
5. Guarda na conta a data da execução e o texto do resultado, e publica esse resumo no chatter da conta.

O que muda no seu Odoo

A conta guarda a data da última execução e o resultado. Numa execução manual, esse resultado é publicado também como mensagem na ficha da conta. Começa com Sincronização das listagens suprimidas da Amazon concluída. (Amazon suppressed listings sync finished.), segue com a conta, a origem e o identificador e estado do relatório (Estado do relatório: …, Report status) e, se o relatório foi importado, com estes contadores:

• Linhas do relatório: … (Report rows)
• Linhas processadas: … (Processed rows)
• Criados: … (Created)
• Atualizado: … (Updated)
• Ignorado: … (Skipped)
• Com erro: … (With error)

O resumo que se guarda na conta é cortado a um comprimento máximo, pelo que um resultado muito longo pode ficar truncado.

O que aprender com o caso

• O habitual é não carregar em nada: a tarefa diária faz o mesmo trabalho nas contas ativas que tenham a sincronização ativada.
• O botão serve para executar à mão uma conta concreta, e executa-o quem tenha permissão Gestor ou acesso às Definições.
• O resumo indica com Origen se a execução foi manual ou da tarefa agendada.

Custo e ajuda com a colocação em funcionamento

O módulo é de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA, para até 3 contas Amazon. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Pode vê-lo na página do módulo.

Se está a implementar o Odoo e quer deixar o conector e as suas permissões bem distribuídos, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve 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/en/services.html
• flexigotech.com/precios.html