Saltar para o conteúdo principal

Amazon

O que faz o botão Sincronizar faturas emitidas pela Amazon no Amazon Connector for Odoo

O botão Sincronizar faturas emitidas pela Amazon lança manualmente a reconciliação das faturas emitidas pela Amazon, a mesma que o Odoo já executa todos os dias com uma tarefa agendada. Só aparece no Odoo 19 e 20, só se a opção Reconciliar faturas emitidas pela Amazon (VCS) estiver ativada, e exige permissão de Gestor (Manager) ou de Definições.

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 botão e quando se vê

O botão Sincronizar faturas emitidas pela Amazon está no ecrã Contas (Accounts), que se abre a partir de Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Os níveis Configuração e Contas exigem a permissão Gestor, e o nível Amazon exige Visualizador (Viewer). Só com Visualizador vês o nível Amazon, mas não os outros dois.

Esquema feito com código a partir do código publicado do módulo, não um ecrã do Odoo: o menu Amazon › Configuration › Accounts, o botão Sync Amazon-Issued Invoices e, ao lado, a mensagem que o pode travar — O caminho de menu e o botão, com a mensagem de falta de permissão ao lado, num esquema com os rótulos em inglês do código e não numa captura.

No ecrã Contas, o botão existe apenas no Odoo 19 e 20 (não no 17 nem no 18), embora o módulo seja publicado para Odoo 17, 18, 19 e 20. Além disso, o botão fica oculto enquanto a opção Reconciliar faturas emitidas pela Amazon (VCS) não estiver ativada, e com os valores por defeito não está: por defeito não o vais ver.

O rótulo muda com o idioma do Odoo. Com o Odoo em alemão lê-se Von Amazon ausgestellte Rechnungen synchronisieren, em francês Synchroniser les factures émises par Amazon, em italiano Sincronizza le fatture emesse da Amazon e em português Sincronizar faturas emitidas pela Amazon.

Esquema feito com código a partir das traduções publicadas do módulo, não um ecrã do Odoo: o rótulo do botão em alemão, francês, italiano e português — O rótulo do botão consoante o idioma do Odoo, num esquema e não numa captura.

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)

O que acontece primeiro: a tarefa diária

O caminho normal não passa pelo botão. A tarefa agendada Amazon SP-API - Reconciliar faturas emitidas pela Amazon (VCS, opcional) corre todos os dias e está ativa desde a instalação. Percorre as contas ativas que têm a opção Reconciliar faturas emitidas pela Amazon (VCS) ativada e lança em cada uma a mesma reconciliação que o botão lança, com a origem CRON. Se uma conta falhar, a tarefa regista um aviso no registo do servidor e continua com as restantes.

O botão é a exceção: serve para lançar essa reconciliação manualmente, sem esperar pela execução seguinte. É isto que muda em relação à tarefa:

	Tarefa diária	Botão
Contas que trata	Todas as ativas com a opção ativada	A conta que tens aberta
Origem no relatório	`CRON`	`Manual`
Mensagem no histórico da conta	Não	Sim
Se houver erros ou linhas tardias assinaladas	Continua e conta-o no relatório	Pára com um erro

Um caso: lançá-lo manualmente antes do fecho

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Menaje Levante S.L., uma empresa inventada que vende na Amazon e faz a contabilidade no Odoo 20, tem ativada a opção Reconciliar faturas emitidas pela Amazon (VCS). A pessoa da administração, com permissão Gestor, não quer esperar pela tarefa desta noite e lança-a manualmente:

Entra em Amazon › Configuração › Contas e abre a conta da Amazon. Como a opção está ativada, vê o botão.
Carrega em Sincronizar faturas emitidas pela Amazon. A primeira coisa que o Odoo faz é verificar que o utilizador é Gestor (ou está em Definições) e que pode escrever nessa conta. Se falhar, a ação pára aí.
O Odoo lança a reconciliação apenas para essa conta, com a origem Manual.
Com a contagem que obtém, compõe um relatório. Se não houver erros nem linhas tardias assinaladas, guarda na conta a data e o resultado dessa execução (o texto é cortado se for muito longo) e deixa o relatório como mensagem no histórico da conta.
Ela lê essa mensagem no histórico.

Se a contagem tivesse trazido erros ou linhas tardias assinaladas para revisão, o clique teria terminado com um erro no ecrã em vez do relatório. Como a ação pára, não se guarda nada do que esse clique ia alterar.

O que diz o relatório

O relatório começa com Reconciliação das faturas emitidas pela Amazon concluída., segue com Conta: … (Account: …) e Origem: … (Source: …) e termina com estas contagens:

Linha do relatório	O que conta
`Scanned invoice numbers`	Os números de fatura revistos
`Amazon-issued (booked new entry)`	As emitidas pela Amazon, para as quais se regista um lançamento novo
`Seller-issued (linked, nothing new)`	As emitidas pelo vendedor: ligam-se e não se cria nada de novo
`Skipped (seller invoice still in draft)`	As ignoradas porque a fatura do vendedor continua em rascunho
`Late-arriving lines flagged for review`	As linhas que chegam tarde e se assinalam para revisão
`Late-arriving lines relinked (seller-issued)`	As linhas que chegam tarde e voltam a ligar-se como emitidas pelo vendedor
`Errors`	Os erros

Que erros pode dar

Falta de permissão

Se o teu utilizador não é Gestor nem está em Definições, ao carregar no botão aparece: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access. A verificação é feita antes de lançar o que quer que seja, pelo que a reconciliação nem chega a executar-se. O que fazer diz-o a própria mensagem: que um gestor te dê o acesso Gestor.

Erros ou linhas tardias assinaladas

Ao carregar manualmente, o botão soma os Errors e as Late-arriving lines flagged for review. Se a soma não for zero, pára com um erro e não se guarda o que esse clique ia alterar. A tarefa diária não pára por isto: conta-o no seu relatório e continua.

Outra falha durante a reconciliação

Se a reconciliação falhar por outra causa, o código volta a lançar essa falha quando a lanças com o botão. Na tarefa diária, em contrapartida, a falha fica como uma linha Erro: … do relatório.

O que aprender com o caso

A tarefa diária é o caminho normal; o botão serve para te adiantares a ela quando precisas.
Se não vês o botão, verifica primeiro a versão (19 ou 20) e a opção Reconciliar faturas emitidas pela Amazon (VCS).
Quem o carrega precisa de permissão de Gestor ou de Definições, além de poder escrever nessa conta.
O relatório distingue o emitido pela Amazon, o emitido pelo vendedor, o ignorado por estar em rascunho e o que exige revisão.

Preço e ajuda

O módulo é de pagamento único por versão do Odoo (preço na ficha do Odoo Apps) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA. Mais detalhes na página do módulo.

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

O que faz o botão «Criar a família na Amazon», passo a passoO que verifica e o que envia o botão Criar a família na Amazon do conector SP-API para Odoo, quando aparece e o que fazer perante cada erro possível.

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_account_views.xml
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