Saltar para o conteúdo principal
Amazon

O que faz o botão «Receber em stock agora» do Amazon Connector for Odoo

O botão Receber em stock agora (Receive to Stock Now) do ecrã Devoluções (BI) (Returns (BI)) executa manualmente, sobre uma devolução concreta, a mesma rotina que o Odoo já executa sozinho, mas sem a verificação prévia da rotina automática, que segundo a ajuda da sua caixa só trata devoluções da Amazon finalizadas: o botão pode levar para stock uma devolução que a tarefa ainda deixaria ignorada. Vê-se com os valores por omissão e pode ser premido por quem tenha acesso de Operator ou Manager.

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

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.

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)

Passo a passo

  1. Deixa ativada a automatização da conta. Está na ficha de Contas (Accounts), separador Devoluções e Avaliações (Returns & Reviews), grupo Automatização de Stock de Devoluções (ATIVADA por omissão) (Return Stock Automation (ON by default)): caixa Devoluçõ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.
  1. Abre a devolução em Amazon › Análise / BI › Devoluções (Amazon › Analytics / BI › Returns). Cada troço do menu pede a permissão Visualizador (Viewer). O botão está no ecrã Devoluções (BI), onde o campo Conta (Account) da devolução se vê na ficha e na lista.
  1. 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.
  1. 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.
  1. 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 agora e lê o resultado (mais abaixo).
Esquema feito com código: de cima para baixo, o menu Amazon › Analytics / BI › Returns, o botão Receive to Stock Now e, ao lado, a mensagem de acesso de Operator ou Manager
Esquema feito com código a partir do código publicado do módulo (não é um ecrã do Odoo): o menu, o botão nas versões 17, 18, 19 e 20 e a mensagem que o pode travar. As etiquetas estão em inglês, o texto original do módulo.

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.

Esquema feito com código: a etiqueta do botão em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo (não é um ecrã do Odoo): com o Odoo em português de Portugal o botão chama-se Receber em stock agora.

Automática versus botão

AspetoTarefa automáticaBotão Receber em stock agora
Quem a lançaAs duas tarefas agendadasTu, numa devolução
AlcanceDevoluções da conta ainda não concluídas, com um limite por passagemApenas a devolução aberta
Verificação préviaSim; se não a passar, deixa a devolução ignorada e guarda o motivoNã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 entregueA 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