Saltar para o conteúdo principal
Amazon

O que faz o botão «Reparar problema do listing» do Amazon Connector

O botão Reparar problema do listing (Repair Listing Issue) envia à Amazon o atributo unit_count de uma publicação, testando combinações de tipo e valor e, se nenhuma servir, tenta removê-lo. Vê-se sempre no ecrã Listagens, e antes de o premir convém saber o que a fila automática já tenta.

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
7 min

Antes de premir: o que o Odoo já tenta sozinho

O botão é o caminho manual. A mesma reparação é também lançada pela tarefa agendada Amazon SP-API - Fila de reparação automática v2 (Amazon SP-API - Auto-repair queue v2), que corre a cada 3 minutos e vem ativa ao instalar. Essa tarefa verifica as publicações ativas de uma conta que estão em estado de erro e, quando o problema é de unit_count, executa a reparação que o botão executa. A diferença: se a Amazon aceita o envio mas ainda não dá estado final, a tarefa não pára com um aviso, mas agenda uma nova tentativa se a caixa de novas tentativas em segundo plano estiver ativa.

  • Verifica que a tarefa Amazon SP-API - Fila de reparação automática v2 continua ativa.
  • Na ficha de uma conta (Contas, Accounts), no separador Catálogo e Listagens (Catalog & Listings), dentro do grupo Reparar Erros de Listagem Automaticamente (Auto-repair Listing Errors), vê a caixa As novas tentativas de reparação são executadas em segundo plano (opt-in). Vem ativada por defeito e a sua ajuda diz: `Ativa as repetições em fila para erros transitórios (p. ex.
  • Tem em conta que essa reparação automática de erros só atua sobre publicações cujo ASIN foi lido da Amazon: as restantes ficam registadas como não reparadas automaticamente.
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 o pode premir

  • Entra em Amazon › Catálogo › Listagens. Cada troço do menu pede a permissão Visualizador (Viewer).
  • Abre uma publicação: o botão Reparar problema do listing está no ecrã Listagens e vê-se sempre, sem condição de estado, no Odoo 17, 18, 19 e 20.
Esquema feito com código: o menu Amazon, Catálogo, Listagens, o botão Reparar problema do listing e, ao lado, duas das mensagens que o podem parar
Esquema do botão Reparar problema do listing e de duas das mensagens que o detêm (esquema feito com código, não uma captura do Odoo).
  • Verifica o teu acesso. Para o botão funcionar é necessário, no mínimo, o acesso de Operator do conector; se não o tiveres, aparece You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access. O código também exige que possas escrever nessa publicação.
Esquema feito com código a partir das traduções do módulo: o texto do botão em castelhano, alemão, francês, italiano e português
Com o Odoo em castelhano o botão chama-se Reparar problema do listing; em alemão, Angebotsproblem beheben; em francês, Réparer le problème d'annonce; em italiano, Ripara problema inserzione; em português, Reparar problema do listing (esquema, não um ecrã do Odoo).
  • Prime o botão e lê a confirmação: A reparação da listagem Amazon pode alterar atributos de catálogo como unit_count. Continuar? (Amazon listing repair may change catalog attributes such as unit_count. Continue?). Aceitar significa que a publicação pode mudar na Amazon.

O que o botão verifica, por ordem

No Odoo 20.0, o botão percorre estas verificações por esta ordem:

  • Que a publicação tenha um produto do Odoo associado. Se não, pára com O vínculo não tem produto Odoo associado. (Binding has no linked Odoo product.).
  • Que exista tipo de produto da Amazon. Se a publicação não o tiver, o botão lê-o da Amazon; se continuar sem tipo, pára com Não foi possível detetar product_type para o SKU …. Preencha o Tipo de Produto Amazon manualmente no vínculo. (Could not detect product_type for SKU …. Fill in Amazon Product Type manually on the binding.).
  • Que existam atributos carregados. Se o campo do separador Catálogo, grupo Payload do Catálogo (vê-se sem rótulo, só o seu conteúdo) estiver vazio, o botão carrega os atributos a partir da Amazon.
  • Que valores permite a Amazon. O módulo pede-lhe a definição do tipo de produto e tenta extrair dela os valores permitidos para unit_count.

O que muda em cada tentativa

  • O botão envia à Amazon uma substituição do atributo unit_count. Parte do valor atual de unit_count na publicação, testa combinações de tipo e valor uma a uma e pára num máximo de 180.
  • Guarda cada resposta da Amazon (envio, estado, problemas). O estado da publicação passa a erro se a Amazon devolver um erro bloqueante e a ativo se não.
  • Após um envio sem erro bloqueante, volta a ler a publicação a cada 5 segundos, até 40 segundos, para ver se o problema de unit_count desapareceu.
  • Se desapareceu, guarda a combinação no conteúdo de atributos do teu Odoo e mostra uma notificação de sucesso: unit_count corrigido e verificado para … após … tentativa(s). Tipo: … | valor: … (unit_count fixed and verified for … after … attempt(s). Type: … | value: …).
  • Se a Amazon continuar a rejeitar, passa à combinação seguinte.
  • Se no fim da espera continuar sem haver estado final, o botão não dá por assente que esteja resolvido e avisa disso. Com a caixa de novas tentativas ativa, tenta agendar uma nova tentativa automática.
  • Se nenhuma combinação servir, tenta remover unit_count da publicação. Se a Amazon o aceitar e, ao reler, já não restarem erros, o botão avisa de sucesso com unit_count removido e listagem saneada para … após … tentativa(s) de reparação. … (unit_count removed and listing sanitized for … after … repair attempt(s). …).
  • Se nem assim ficar resolvido, o botão pára com Não foi possível corrigir unit_count para … após … tentativa(s). Último erro: … (Could not fix unit_count for … after … attempt(s). Last error: …). Com a caixa de novas tentativas ativa e tendo feito alguma tentativa, pode agendar uma nova tentativa; quando o faz, a mensagem termina com Foi colocada em fila uma nova tentativa automática na fila de reparação automática. (An automatic retry was queued in the auto-repair queue.). Se o máximo de novas tentativas foi ultrapassado, não a agenda e a linha não aparece.

Erros que pode dar ao premir

  • You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access.: falta-te o acesso; pede-o a quem gere as permissões.
  • O vínculo não tem produto Odoo associado.: associa um produto do Odoo à publicação e repete.
  • Não foi possível detetar product_type para o SKU …. Preencha o Tipo de Produto Amazon manualmente no vínculo.: faz o que a mensagem diz.
  • unit_count não pode ser corrigido porque a Amazon devolveu um erro de bloqueio não relacionado. Problema: … (unit_count cannot be fixed because Amazon returned an unrelated blocking error. Issue: …): a resposta da Amazon traz outro erro bloqueante diferente de unit_count. O botão pára e não continua a testar valores.
  • Se esse erro for de imagens ou multimédia, o botão tenta primeiro limpar as entradas de compliance_media com URL temporário ou caducado. Se conseguir, segue para a tentativa seguinte. Se não, pára com outra mensagem: unit_count não pode ser corrigido porque a Amazon devolveu um erro de média não relacionado com unit_count. (unit_count cannot be fixed because Amazon returned a media error unrelated to unit_count.), seguida do problema e, quando existe, do URL afetado.

Depois de premir

  • No separador Problemas (Issues) da publicação, dentro do grupo Fila de reparação (Repair Queue), vê a caixa Tentativa de reparação automática pendente (Auto Repair Retry Pending), só de leitura. Fica marcada quando se agenda uma nova tentativa de reparação: fá-lo o botão Reparar problema do listing se agendar uma, e também outros caminhos, como a tarefa Amazon SP-API - Fila de reparação automática v2, os botões Enviar stock (Push Stock) e Executar Reparação Automática de Erros (Run Auto-repair Errors) ou guardar uma ficha de produto. Fica vazia a partir de outras ações: os botões Detetar Canal (Detect Channel), Pré-visualizar catálogo (Preview Catalog), Pré-visualizar oferta (Preview Offer), Publicar catálogo (Publish Catalog) e Enviar oferta (Push Offer), ao guardar uma ficha de produto e quando a tarefa da fila de reparação processa a fila.

Como a FlexigoTech ajuda

O módulo está publicado no Odoo Apps para 17.0, 18.0, 19.0 e 20.0, e a ligação passa pela FlexigoTech Cloud, que vigia a sincronização e avisa por e-mail se falhar. Se precisas de implementar o Odoo com este conector ou uma integração à medida, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores. Tens a página do módulo e a sua ficha no Odoo Apps.

Continue a ler

Campos de Pagamentos e Contabilidade da conta do Amazon Connector: o que significa cada um e o que preencherChecklist dos campos de Pagamentos e Contabilidade da conta do Amazon Connector para Odoo: o que significa cada um segundo a sua ajuda e o que decidir.Campos da conta SP-API do Amazon Connector for Odoo: o que diz cada ajuda e o que definirComparação dos campos de faturas, auditoria de reembolsos e relatórios FBA da conta SP-API no Amazon Connector for Odoo: a sua ajuda e os seus valores.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes