Saltar para o conteúdo principal
Amazon

O que faz «Executar Reparação Automática de Erros» no Amazon Connector para Odoo

O botão Executar Reparação Automática de Erros (Run Auto-repair Errors) percorre as publicações de uma conta Amazon que estão em erro, tenta corrigir as que reconhece e deixa um resumo na conta. Antes de mais, verifica se és Gestor: sem essa permissão, pára com uma mensagem de acesso.

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 20.0 · nas fontes indicadas no fim
Leitura
6 min

Antes de carregar: o que o Odoo já repara sozinho

No Odoo 20, com os valores por defeito, a tarefa agendada Amazon SP-API - Fila de reparação automática v2 (Amazon SP-API - Auto-repair queue v2) corre a cada 3 minutos e está ativa desde a instalação. Processa as novas tentativas em fila com as mesmas peças que o botão usa: corrige unit_count se existir um problema desse tipo, repara o conteúdo multimédia de conformidade (compliance_media) se o problema for de imagem e, se a publicação continuar em erro e não tiver nenhum desses dois problemas, tenta enviar o catálogo completo, desde que esteja ativa a definição da conta que permite tentar publicar o catálogo completo (ativa por defeito no código).

Além disso, quando falha um envio de existências, o módulo consulta os problemas guardados dessa publicação e repara os de unit_count ou de imagem. Se a reparação correr bem, volta a enviar as existências; se a Amazon ainda não acabou de a validar, deixa o envio em fila. Chega-se a esse envio ao guardar uma ficha de artigo, ao validar uma guia que afete artigos e na tarefa Amazon SP-API - Sincronizar associações pendentes (preço/stock) (Amazon SP-API - Sync pending bindings (price/stock)), que corre a cada minuto.

O botão é a via manual: lança essa reparação de uma só vez sobre as publicações ativas em erro da conta e do respetivo marketplace.

  • Verifica a caixa As novas tentativas de reparação são executadas em segundo plano (opt-in) (Repair retries run in the background (opt-in)) na ficha de Contas (Accounts), separador Catálogo e Listagens (Catalog & Listings), grupo Reparar Erros de Listagem Automaticamente (Auto-repair Listing Errors). A sua ajuda diz «Ativa as repetições em fila para erros transitórios (p. ex. aceite sem um estado final).» e vem ativa por defeito. Com ela ativa, o botão agenda novas tentativas nos casos que ficam pendentes.
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)

Quando aparece e quem pode carregar

  • O teu utilizador é Gestor (Manager) do conector ou tem acesso às Definições. O caminho é Amazon › Configuração › Contas (Amazon › Configuration › Accounts): os troços Configuração e Contas exigem Gestor, e Amazon exige Visualizador (Viewer).
Esquema feito com código, não um ecrã do Odoo: o menu Amazon, Configuration, Accounts; o botão Run Auto-repair Errors, presente no Odoo 17, 18, 19 e 20; e, de lado, a mensagem de permissões que o pode travar
Esquema (não é uma captura do Odoo) com o caminho do menu, o botão e a mensagem de falta de permissões; as etiquetas estão em inglês, o texto original do código.
  • Abre o ecrã de Contas: o botão Executar Reparação Automática de Erros vê-se sem condições, nas versões 17, 18, 19 e 20.
Esquema feito com código a partir das traduções publicadas do módulo, não um ecrã do Odoo: a etiqueta do botão em castelhano, alemão, francês, italiano e português
Esquema (não é uma captura do Odoo): com o Odoo em português, o botão chama-se Executar Reparação Automática de Erros; o esquema inclui também a etiqueta em castelhano, alemão, francês e italiano.

Ao carregar: o que faz com cada publicação

No Odoo 20, o botão faz isto:

  • Permissões. Em primeiro lugar, verifica o teu acesso. Se não és Gestor nem tens acesso às Definições, pára com You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access. e não se guarda nada. Verifica também que podes escrever na conta.
  • Seleção. Procura as publicações (bindings) dessa conta, do marketplace indicado pela conta (ID do marketplace (Marketplace ID), separador Identidade (Identity)), que estejam ativas e em erro.
  • Leitura prévia. Se a conta tiver ativa a leitura prévia do catálogo (uma definição ativa por defeito no código), volta a ler a publicação na Amazon. Se essa leitura falhar, regista-o e passa à seguinte.
  • ASIN. Se a Amazon ainda não devolveu o ASIN da publicação, o botão não a repara: conta como não resolvida e deixa uma nota. A leitura prévia é a que pode trazer esse ASIN.
  • Problemas guardados. Relê os problemas guardados e recalcula na publicação os contadores de erros, avisos e informação. Se não restar nenhum erro bloqueante, a publicação deixa de estar em erro, limpa-se a sua nova tentativa pendente, se a tinha, e conta como resolvida.
  • unit_count. Se algum problema for de unit_count, lança a sua correção. Conforme o resultado, conta como corrigida, pendente (e em fila se houver uma nova tentativa agendada) ou com erro. Se a Amazon ainda não deu estado final, fica pendente e, com a caixa de segundo plano ativa, agenda-se uma nova tentativa.
  • Imagens. Se algum problema for de imagem, procura o tipo de artigo (se a publicação não o tiver, lê-o da Amazon) e tenta remover as entradas de compliance_media com URL temporário ou caducado e, se o conseguir, volta a ler a publicação. Se não houver nada a limpar ou a Amazon o rejeitar, fica como nota.
  • Publicação. Só se a definição de publicar o catálogo completo estiver ativa (está por defeito no código), a publicação continuar em erro e não tiver tido problema de unit_count nem de imagem, envia o catálogo completo para a Amazon. Se falhar, conta-o, regista-o e, com a caixa de segundo plano ativa, agenda uma nova tentativa.
  • Leitura final e resumo. Volta a ler a publicação (se falhar, apenas o regista) e dá-a por não resolvida se continuar em erro ou com erros. No final, guarda na conta a data e o resultado, e publica o resumo no chatter da conta.

Depois de carregar: o que verificar

O resumo começa por Reparação automática de erros da listagem concluída. (Listing error auto-repair finished.) e Conta: …, e continua com estas linhas:

LinhaO que conta
Vínculos avaliados: …Publicações recolhidas
Importação anterior OK: … e Erro da importação anterior: …Leituras prévias corretas e falhadas
unit_count corrigido: … e unit_count com erro: …Resultado da correção de unit_count
Pendentes assíncronos: … e Fila v2 agendada: …Pendentes de estado final e novas tentativas agendadas
Publicação do catálogo completo OK: … e Erro na publicação do catálogo completo: …Envios do catálogo completo
Vínculos resolvidos: … e Vínculos não resolvidos: …Estado final de cada publicação

Se houver notas, aparecem a seguir a Notas (últimas 15):, com as últimas e cada uma encurtada.

  • Abre a mensagem do chatter da conta e compara Bindings evaluados com resolvidos e não resolvidos.
  • Lê as notas: indicam em que publicação e em que passo (leitura, unit_count, imagem, publicação) ficou algo por resolver.
  • Em cada publicação não resolvida, abre a sua ficha de Listagens, separador Problemas (Issues), grupo Fila de reparação (Repair Queue). O campo Tentativa de reparação automática pendente (Auto Repair Retry Pending, só de leitura) é marcado pelo módulo ao agendar uma nova tentativa; esvazia-se quando a publicação é resolvida ou quando as tentativas se esgotam.
  • Se ficarem pendentes ou novas tentativas agendadas, a tarefa da fila corre a cada 3 minutos: volta a ver a ficha da publicação mais tarde.

Como ajuda a FlexigoTech

O módulo é de pagamento único por versão do Odoo (publicado para 17, 18, 19 e 20) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma. Tens a ficha no Odoo Apps e a página do módulo. A FlexigoTech implementa o 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