Saltar para o conteúdo principal
Amazon

Campos da conta SP-API da Amazon no Odoo: o que significa cada um e o que definir

Estes são os campos de devoluções e de stock FBA da ficha de conta do Amazon Connector for Odoo: o que diz a ajuda de cada um, qual vem marcado de origem e o que convém definir consoante o que queres que o Odoo faça com o stock e as notas de crédito. Estão no menu «Amazon › Configuração › Contas», e vários deles vêm desmarcados.

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

Onde estão e como lá chegar

Os campos deste glossário estão na ficha da conta, que se abre a partir do menu Amazon › Configuração › Contas. Cada troço pede uma permissão: Amazon pede Visualizador (Viewer), e Configuração e Contas pedem Gestor (Manager). Se não tiveres uma delas, não vês esse troço.

A ficha reparte os campos por separadores: Devoluções e Avaliações, FBA e Stock e Encomendas e Expedição. Atenção: os campos de devoluções não estão todos no mesmo separador. A localização alternativa para devoluções está em FBA e Stock.

Esquema feito com código, não um ecrã do Odoo: o menu Amazon, Configuration, Accounts e a ficha da conta com os campos de devoluções e de stock FBA
Esquema feito com código a partir do código publicado do módulo (não é uma captura do Odoo): o menu e os campos da ficha que se explicam abaixo, com os rótulos do código.
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)

Devoluções: quando entram em stock

Os três primeiros campos estão no grupo Automatização de Stock de Devoluções (ATIVADA por omissão) do separador Devoluções e Avaliações. Definem condições para receber uma devolução em stock.

Stock de devoluções: permitir devoluções com ação pendente
Vem desmarcado. A sua ajuda diz: Se desativado, as devoluções marcadas como ação pendente não são recebidas em stock. Com o valor de origem, essas devoluções não entram em stock. Marca-o apenas se quiseres que entrem.
Esquema feito com código, não um ecrã do Odoo: a ajuda do campo de devoluções com ação pendente 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 é uma captura do Odoo): a mesma ajuda consoante o idioma do Odoo.
Stock de devoluções: exigir valor de reembolso
Vem marcado. A sua ajuda: Receber a devolução em stock apenas quando a Amazon reportar um montante reembolsado > 0. Deixa-o assim se quiseres essa condição.
Stock de devoluções: exigir data de entrega da devolução
Vem desmarcado. A sua ajuda: Se ativado, return_delivery_date tem de estar presente antes de receber o stock. Marca-o se quiseres que a devolução só seja recebida com a data de entrega da devolução presente.
Stock de devoluções: localização interna alternativa
Está no separador FBA e Stock, grupo Localizações. A sua ajuda: Localização interna opcional usada quando a Amazon confirma uma devolução mas o Odoo não consegue criar uma receção de devolução padrão a partir dos movimentos entregues. Se vazio, é usada a localização de origem da receção entregue quando possível. Preenche-a se preferires outra localização para esse caso.

Devoluções: notas de crédito e dados da Amazon

Os três primeiros estão no separador Devoluções e Avaliações; o último, em Encomendas e Expedição.

Criar notas de crédito automaticamente (opt-in)
Vem desmarcado. A sua ajuda: Cria automaticamente um rascunho de nota de crédito do cliente quando o valor de reembolso da devolução é reportado e a venda está contabilizada no Odoo. O que se cria é um rascunho, e a ajuda impõe duas condições: que o valor de reembolso seja reportado e que a venda esteja contabilizada.
Lançar notas de crédito automaticamente (opt-in)
Vem desmarcado. A sua ajuda: Se ativado, as notas de crédito internas geradas a partir de devoluções são lançadas imediatamente. Se preferires revê-las antes de as contabilizar, deixa-o desmarcado.
Sincronizar atributos de devolução (opcional)
Vem desmarcado. A sua ajuda: Lê os atributos de devolução da Amazon por SKU para políticas de etiqueta pré-paga e reembolso sem devolução. Faz sentido se trabalhares com essas políticas.
API externa de devoluções (opt-in)
Está em Encomendas e Expedição, grupo Sincronização Externa de Envios (ATIVADA por omissão). Embora o título do grupo diga ATIVADA por omissão, este campo vem desmarcado. A sua ajuda: Enriquece as linhas de devolução a partir da Amazon External Fulfillment Returns API quando está disponível um External Return ID.

Inventário FBA: o que lê e onde o deixa

Todos estes campos estão no separador FBA e Stock.

Sincronização oficial do inventário FBA
Grupo Sincronização de Inventário FBA (ATIVA por omissão) · Envios Concluídos (opt-in). Vem marcado. Segundo a sua ajuda, se estiver ativado lê o stock FBA atual da Amazon com a Reports API e, como alternativa em direto, com getInventorySummaries.
Tipo de relatório do inventário FBA
Mesmo grupo. A sua ajuda: GET_LEDGER_SUMMARY_VIEW_DATA é a fonte recomendada para a sincronização de stock físico. GET_AFN_* reflete a disponibilidade comercial da Amazon. Entre os seus valores figuram GET_AFN_INVENTORY_DATA_BY_COUNTRY e GET_AFN_INVENTORY_DATA. Vê qual tens selecionado e escolhe consoante queiras stock físico ou disponibilidade comercial.
Aplicar stock FBA oficial às localizações Odoo
Grupo Localizações. Vem desmarcado. Segundo a sua ajuda, se estiver ativo ajusta as localizações do Odoo configuradas à quantidade da Amazon. Decide primeiro que localizações configuras e depois marca-o.
Localização FBA predefinida
Grupo Localizações. A sua ajuda: Localização predefinida apenas para o país do marketplace principal da conta ou para relatórios sem país. Os fluxos transfronteiriços requerem uma rota FBA explícita. Pensa nela nesses termos: serve para o país principal ou para relatórios sem país.
Localização FBA Em Trânsito
Grupo Localizações. A sua ajuda: Localização interna que contém mercadorias expedidas para a Amazon mas ainda não rececionadas. Escolhe uma localização interna que represente essa mercadoria.
Sincronizar expedições processadas por FBA (opcional)
Está no mesmo grupo que a sincronização de inventário. Vem desmarcado, embora o título do grupo diga ATIVA por omissão. A sua ajuda: Lê os envios FBA realmente expedidos da Amazon utilizando a Reports API.

Como ajuda a FlexigoTech

O módulo está publicado na Odoo Apps para 17, 18, 19 e 20, é de pagamento único por versão e precisa da subscrição da FlexigoTech Cloud (plano Conector: 49 €/mês ou 490 €/ano sem IVA). A ligação passa pela FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Tens a ficha da Odoo Apps e a página do módulo.

Se estás a implementar o Odoo e queres que alguém te ajude a decidir estes valores com a tua contabilidade e os teus armazéns, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

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