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
Contase procure a caixa no separadorEncomendas 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.

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.

- Chega por
Amazon › Análise / BI › Devoluções: se não vir um troço do menu, falta-lhe a permissãoVisualizador. - 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 Amazoncom 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.

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
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_return_line_views.xml
- Código do módulo: flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_return_line.py
- 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/precios.html
- flexigotech.com/en/services.html
