Saltar para o conteúdo principal
Amazon

Tarefa de recomendações de reabastecimento da Amazon: glossário

A tarefa pede à Amazon uma vez por dia o relatório de recomendações de reabastecimento de cada conta que o tenha ativado, consulta-o até estar pronto e importa as suas linhas. Vem ativa ao instalar e existe no Odoo 17.0, 18.0, 19.0 e 20.0; se não fizer nada, comece por ver as condições da conta.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
Amazon
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 17.0 e 20.0 · nas fontes indicadas no fim
Leitura
5 min

Esta tarefa pede à Amazon, uma vez por dia, o relatório de recomendações de reabastecimento de cada conta que o tenha ativado e, depois, importa as respetivas linhas no Odoo. Os termos seguintes aparecem pela ordem em que os vai encontrar.

A tarefa, a sua frequência e as suas versões

Tarefa agendada
Chama-se Amazon SP-API - Sincronizar relatório de recomendações de reabastecimento (opt-in) (Amazon SP-API - Sync restock recommendations report (opt-in)). Ao executar-se, percorre as contas da Amazon do módulo e lança a sincronização nas que cumprem as condições explicadas mais abaixo.
Esquema com o nome da tarefa agendada em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo, não um ecrã do Odoo: o nome da tarefa muda consoante o idioma do seu Odoo.
Uma vez por dia
A tarefa corre uma vez por dia. Em cada passagem, o código pede à Amazon um relatório novo para cada conta que entra.
Ativa ao instalar
Vem ativa ao instalar o módulo e está em todos os ramos publicados: 17.0, 18.0, 19.0 e 20.0. No Odoo 17.0 a tarefa repete-se sem fim.
Esquema da tarefa agendada, que corre uma vez por dia e vem ativa ao instalar, junto ao menu de contas
Esquema feito com código a partir do código publicado do módulo, não um ecrã do Odoo: a tarefa uma vez por dia, ativa ao instalar no Odoo 17.0, 18.0, 19.0 e 20.0, e o menu de contas, com os rótulos em inglês como no código.
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo em inglês)

Que contas percorre

Opt-in e conta ativa
A tarefa só toma as contas que estão ativas e que têm ativada a sincronização de recomendações de reabastecimento. O nome da tarefa termina em (opt-in). Uma conta que não cumpra as duas condições não entra na passagem.
Contas
Menu Amazon › Configuração › Contas (Amazon › Configuration › Accounts), onde se abrem as fichas das contas. Cada troço pede uma permissão: Amazon pede Visualizador (Viewer); Configuração (Configuration) e Contas (Accounts) pedem Gestor (Manager). Se não tiver a permissão de um troço, não o vê.
Nome
Campo Nome (Name) da conta. Vê-se na ficha de Contas, separador Identidade (Identity), grupo Conta (Account), e também na lista de contas. É o nome com que a tarefa identifica a conta quando regista uma falha.

O que faz em cada passagem

Origem
O texto de resultado de cada passagem leva uma linha Origem: … (Source). Indica CRON se a lançar a tarefa agendada e Manual caso contrário. Além disso, regista a conta (Conta: …) e, quando a Amazon criou o relatório, o seu identificador.
Consultas de estado
Depois de pedir o relatório, o código consulta o seu estado várias vezes. O número de tentativas e a espera entre elas saem dos valores da conta; se estiverem vazios ou a zero, usa 12 tentativas com 10 segundos entre uma e outra. Deixa de consultar assim que o estado é DONE, CANCELLED ou FATAL.
Estado do relatório
Com DONE, a passagem segue em frente. Com CANCELLED ou FATAL, o texto de resultado diz que a Amazon não gerou um relatório utilizável. Com qualquer outro estado ao esgotar as tentativas, regista que a espera se esgotou. Nestes dois últimos casos, a tarefa guarda a data e o resultado e a passagem dessa conta termina aí.
Documento do relatório
Com o relatório em DONE, o código precisa do respetivo documento. Se a Amazon o dá por terminado mas sem documento, regista esse facto, guarda o resultado e termina. Se o traz, descarrega o texto e importa-o nas linhas de recomendações de reabastecimento, até um máximo por passagem que sai dos valores da conta (se estiver vazio ou a zero, usa 10000 linhas).
Filas
Ao importar, o texto de resultado conta as linhas do relatório, as processadas, as criadas, as atualizadas, as saltadas e as que deram erro: Filas reporte, Filas procesadas, Creadas, Actualizadas, Saltadas e Con error (em inglês: Report rows, Processed rows, Created, Updated, Skipped e With error).
Resultado guardado
Quando a passagem termina com o relatório importado, sem documento, cancelado, falhado ou com a espera esgotada, o código escreve na conta a data e a hora da última execução e o texto de resultado, cortado a 5000 carateres. Nesses casos, se a lançar a tarefa agendada, não se publica mensagem no histórico (chatter) da conta, pelo que não espere ver lá esse resultado.

Se a tarefa não faz nada

Falha de uma conta
Se a sincronização de uma conta lançar uma exceção, a tarefa apanha-a, regista um aviso no registo do servidor com o nome da conta e segue com as restantes. Uma falha numa conta não interrompe a passagem das outras.

Com isto, a ordem para rever é esta:

  • A tarefa continua ativa. Vem ativa ao instalar o módulo.
  • A conta cumpre as duas condições: está ativa e tem ativada a sincronização de recomendações de reabastecimento. Localize-a em Amazon › Configuração › Contas pelo seu Nome.
  • A Amazon pode ter devolvido CANCELLED ou FATAL, ou não ter terminado o relatório dentro das tentativas de consulta. A passagem acaba para essa conta e a seguinte volta a pedir um relatório novo.
  • Um relatório DONE sem documento também corta a passagem dessa conta antes de importar o que quer que seja.
  • Um histórico (chatter) vazio não prova que a tarefa não correu: quando a passagem da tarefa termina com o relatório importado, sem documento, cancelado, falhado ou com a espera esgotada, não se publica lá nenhuma mensagem.
  • A subscrição: o módulo precisa do FlexigoTech Cloud. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no seu Odoo.

Custo e ajuda com a colocação em funcionamento

O módulo é de pagamento único por versão do Odoo (publicado para 17.0, 18.0, 19.0 e 20.0) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Os preços por versão estão na ficha do Odoo Apps e na página do módulo.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser que revejamos como fica esta sincronização na sua instalação, escreva-nos.

Continue a ler

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

Fontes