Saltar para o conteúdo principal
Amazon

O que faz «Obter Detalhes de Devolução Externa» no Amazon Connector for Odoo

O botão Obter Detalhes de Devolução Externa (Fetch External Return Details) atualiza os detalhes de uma linha de devolução a partir do respetivo ID de devolução externa: aparece sempre no ecrã Devoluções (BI), exige acesso de Operador e, se tudo correr bem, avisa-o com uma notificação; a tarefa Amazon SP-API - Sincronizar devoluções executa esse mesmo processo a cada três horas, consoante tenha uma caixa da conta marcada.

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

Primeiro, o que o Odoo faz sem que carregue em nada

O caminho normal não é o botão. A tarefa agendada Amazon SP-API - Sincronizar devoluções (Amazon SP-API - Sync returns) executa-se a cada três horas e está ativa ao instalar o módulo. Inclui um passo que chama o mesmo processo que o botão. O que decide se esse passo é percorrido é uma caixa da conta: API externa de devoluções (opt-in) (External returns API (opt-in)). Vê-a na ficha de Contas, separador Encomendas e Expedição, grupo Sincronização Externa de Envios (ATIVADA por omissão), e no código vem desativada por omissão. A sua ajuda diz: «Enriquece as linhas de devolução a partir da Amazon External Fulfillment Returns API quando está disponível um External Return ID.»

  • Abra a ficha da sua conta em Contas e procure a caixa no separador Encomendas e Expedição.
  • Decida se quer que seja a tarefa agendada a atualizar as devoluções externas: essa caixa é a que decide o caminho automático.
  • Reserve o botão para atualizar manualmente uma linha concreta.
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)

Onde está o botão e quem pode carregar nele

O botão Obter Detalhes de Devolução Externa está no ecrã Devoluções (BI) (Returns (BI)) e existe no Odoo 17, 18, 19 e 20. As fichas de devolução abrem-se a partir do menu Amazon › Análise / BI › Devoluções, e cada troço desse menu exige a permissão Visualizador (Viewer). Tudo o que se segue sobre verificações, notificações e erros é o comportamento do código do Odoo 20.

Esquema feito com código: o caminho de menu Amazon, Analytics / BI, Returns; o botão Fetch External Return Details e, ao lado, as mensagens que podem aparecer ao carregar nele
Esquema gerado a partir do código publicado do módulo (não é uma captura do Odoo): caminho do menu, botão e mensagens associadas.
  • Chega por Amazon › Análise / BI › Devoluções: se não vir um troço do menu, falta-lhe a permissão Visualizador.
  • O botão aparece sempre: nenhuma condição da vista o oculta, por isso não tem de esperar por nenhum estado.
  • Ver o botão não basta: ao carregar nele, o módulo verifica que o seu utilizador tem pelo menos acesso de Operador do conector.
  • Além disso, o módulo verifica que pode escrever nessa linha de devolução.
  • O botão trabalha sobre uma única linha de cada vez.

Antes de carregar

  • O seu utilizador tem acesso de Operador ou de Manager do conector.
  • A linha de devolução tem uma conta Amazon atribuída.
  • A linha tem um ID de devolução externa.

O que faz o botão, por ordem

Esta é a ordem que o código segue ao carregar:

  • Primeiro verifica o seu acesso. Se não tiver acesso de Operador (ou de Manager), para com a mensagem de acesso e não se tenta mais nada. As execuções com permissões de superutilizador passam sem essa verificação.
  • Depois exige que a linha tenha conta Amazon e um ID de devolução externa (sem contar espaços em branco no princípio e no fim). Se faltar algum dos dois, para aí.
  • Com esse ID, segue com a sincronização da linha usando a respetiva conta Amazon; se terminar bem, mostra a notificação de sucesso.
  • Se algo falhar durante a sincronização, regista a falha na linha e mostra-lha (mais abaixo, o detalhe).

Depois de carregar: o que verificar

Se tudo correu bem, verá uma notificação com o título Devoluções Amazon (Amazon Returns) e o texto «Detalhes de devolução External Fulfillment atualizados com sucesso.» (External Fulfillment return details refreshed successfully.). Não é uma notificação fixa: não fica no ecrã até a fechar.

  • Confirme que apareceu a notificação Devoluções Amazon com esse texto.
  • Se não apareceu e viu um erro, passe à secção de erros.

Como se chama consoante o idioma do seu Odoo

O rótulo muda com o idioma: com o Odoo em português de Portugal, o botão chama-se Obter Detalhes de Devolução Externa.

Esquema feito com código com o rótulo do botão em castelhano, alemão, francês, italiano e português
Esquema gerado a partir das traduções publicadas do módulo (não é uma captura do Odoo): o mesmo botão consoante o idioma do Odoo.

Erros e como resolvê-los

  • Se ao carregar aparecer You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access., o seu utilizador não tem acesso de Operador. Peça a um responsável que lhe dê acesso de Operador ou de Manager. Esta mensagem aparece ao verificar o acesso, antes da parte que regista erros na linha.
  • Se o processo falhar depois dessa verificação, o botão regista na linha que a sincronização terminou em erro, com a data e hora da tentativa e o texto do erro, e mostra-lhe esse erro.
  • Quando tiver resolvido a causa, pode voltar a carregar no botão.

Preço e como a FlexigoTech o ajuda

O módulo é de pagamento único por versão do Odoo (17, 18, 19 e 20; o preço de cada uma, em a ficha) e 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 cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição proporciona; os dados ficam no seu Odoo. Mais dados em a página do módulo.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser ver como explicamos outro botão do conector, veja Pré-visualização na Amazon.

Continue a ler

O que faz o botão «Pré-visualizar na Amazon» do Amazon Connector for OdooO que faz o botão «Pré-visualizar na Amazon» do conector da Amazon para Odoo: quando aparece, o que verifica, o que guarda e que erros pode dar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes