Primeiro: o Odoo já o faz sozinho
Antes de premir seja o que for, duas tarefas agendadas levam as devoluções para o stock: Amazon SP-API - Receber devoluções para stock automaticamente (Amazon SP-API - Auto receive returns to stock), a cada 15 minutos, e Amazon SP-API - Sincronizar devoluções (Amazon SP-API - Sync returns), a cada 3 horas. Ambas estão ativas ao instalar e terminam na mesma rotina de receção em stock, que percorre as devoluções da conta que ainda não estão concluídas, as mais recentes primeiro e até um limite de linhas por passagem. Essa rotina só trabalha se a caixa da conta estiver marcada, e está por omissão.
O botão é a exceção: processa uma devolução concreta sem a verificação prévia que a tarefa faz, que segundo a ajuda da sua caixa só trata as devoluções da Amazon finalizadas. Usa-o apenas quando souberes que essa devolução deve entrar já em stock, mesmo que a tarefa a tenha deixado ignorada.

Passo a passo
- Deixa ativada a automatização da conta. Está na ficha de
Contas(Accounts), separadorDevoluções e Avaliações(Returns & Reviews), grupoAutomatização de Stock de Devoluções (ATIVADA por omissão)(Return Stock Automation (ON by default)): caixaDevoluções: receber automaticamente em stock(Returns: auto-receive to stock), marcada por omissão. A sua ajuda diz:Cria e valida automaticamente as receções de devolução no Odoo para devoluções Amazon finalizadas.
- Abre a devolução em
Amazon › Análise / BI › Devoluções(Amazon › Analytics / BI › Returns). Cada troço do menu pede a permissãoVisualizador(Viewer). O botão está no ecrãDevoluções (BI), onde o campoConta(Account) da devolução se vê na ficha e na lista.
- Vê se o botão aparece. Com os valores por omissão, vê-se; as três condições que o ocultam estão mais abaixo.
- Verifica o teu acesso. Para abrir o menu pede-se
Visualizador, mas ao premir o botão o módulo exige, no mínimo, acesso de Operator. Se não o tiveres, pára com esta mensagem:You need at least Amazon Seller Connector Operator access for this action. Ask a manager to grant Operator or Manager access.Pede a um responsável que te dê acesso de Operator ou de Manager. O módulo verifica ainda que podes escrever nesse registo.
- Antes de premir, tem presente que essa devolução deve entrar já em stock: o botão não faz a verificação prévia da rotina automática. Prime
Receber em stock agorae lê o resultado (mais abaixo).

Quando não vês o botão
O botão fica oculto numa devolução quando se verifica qualquer uma destas condições:
- O
Âmbito de Processamento(Fulfillment Scope) da devolução é FBA. - O
Modo de Ligação de Stock(Stock Link Mode) está no valor que o módulo trata como não reabastecer. - O
Estado de Devolução de Stock(Stock Return State) já é o de concluído.
Essa condição é a mesma nos quatro ramos publicados do módulo, 17, 18, 19 e 20.
O que o botão faz por dentro
No Odoo 20, o botão trabalha com um único registo, o que tens aberto, e com a conta da Amazon dessa devolução. Chama a mesma rotina que as tarefas agendadas, mas com uma diferença: a rotina automática faz antes uma verificação prévia e, se não a passar, deixa a devolução ignorada e guarda o motivo. O botão não faz essa verificação, pelo que pode levar para stock uma devolução que a tarefa ainda deixaria ignorada. Depois, por esta ordem:
- Procura a ordem de vendas do Odoo que corresponde à encomenda da Amazon. Se a devolução não a tinha ligada, guarda-a nela.
- Procura as linhas de venda que correspondem à devolução. Se a devolução não tem SKU e essas linhas apontam para um único SKU, preenche-o.
- Procura as guias de saída entregues dessa encomenda.
Estas alterações (a ligação à encomenda e o SKU) só se conservam se a ação não terminar em erro: quando termina em erro, o Odoo não guarda o que essa ação tinha escrito.
Se faltar a ordem de vendas, as linhas de venda ou a guia de saída entregue, ao premir o botão o resultado é um erro que se mostra no ecrã com o motivo, e na devolução não fica guardado nada dessa ação, nem sequer o motivo. A tarefa automática, pelo contrário, deixa a devolução ignorada e guarda o motivo nela.
O que verás ao terminar
Se a rotina der um erro, o botão pára e mostra a mensagem do erro.
Se não houver erro, aparece uma notificação intitulada Devoluções Amazon (Amazon Returns) que não fica fixa no ecrã: de tipo sucesso se a devolução ficou processada e de tipo aviso em qualquer outro caso.
Para o verificar depois, recorda as condições acima: quando o Estado de Devolução de Stock chega ao de concluído, o botão deixa de se ver nessa devolução.

Receber em stock agora.Automática versus botão
| Aspeto | Tarefa automática | Botão Receber em stock agora |
|---|---|---|
| Quem a lança | As duas tarefas agendadas | Tu, numa devolução |
| Alcance | Devoluções da conta ainda não concluídas, com um limite por passagem | Apenas a devolução aberta |
| Verificação prévia | Sim; se não a passar, deixa a devolução ignorada e guarda o motivo | Não: o botão não a faz e pode levar para stock uma devolução que a tarefa ainda deixaria ignorada |
| Falta a ordem de vendas, as linhas de venda ou a guia entregue | A devolução fica ignorada e o motivo é guardado nela | É um erro: o botão pára, mostra o motivo no ecrã e não se guarda nada dessa ação |
A leitura prática: se uma devolução continua sem passar para stock, a tarefa deixa-a ignorada e anota o motivo nela, pelo que aí o podes consultar. O botão avisa-te com um erro se faltar a ordem de vendas, as linhas de venda ou a guia entregue, mas não deixa o motivo na devolução e, como não faz a verificação prévia, premi-lo sobre uma devolução que a tarefa ignorou é uma decisão tua.
O que precisa e quanto custa
O módulo é de pagamento único por versão do Odoo e está publicado para 17, 18, 19 e 20. Além disso, precisa da subscrição do FlexigoTech Cloud: o plano Conector custa 49 €/mês ou 490 €/ano sem IVA, para até 3 contas da plataforma.
Como a FlexigoTech te ajuda
A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiseres rever como ficam as tuas devoluções da Amazon no stock, consulta a página do módulo ou a sua ficha no Odoo Apps.
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
