Saltar para o conteúdo principal
Amazon

Amazon Connector: a tarefa que associa depósitos bancários e liquidações

Uma vez por dia, a tarefa Amazon SP-API - Conciliar depósitos bancários de liquidações (Amazon SP-API - Match settlement bank deposits) procura o depósito bancário de cada liquidação da Amazon e só o associa se não houver dúvida. Só analisa liquidações sem linha bancária associada, de contas que o tenham ativado e com depósito dos últimos 60 dias; não reconcilia nem contabiliza nada.

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 17.0 e 20.0 · nas fontes indicadas no fim
Leitura
5 min
Esquema com a tarefa agendada que associa depósitos bancários a liquidações, uma vez por dia, e o menu das liquidações
Esquema feito com código a partir do código publicado do módulo, não uma captura do Odoo: a tarefa, que corre uma vez por dia e vem ativa ao instalar (Odoo 17, 18, 19 e 20), e o menu das liquidações. As etiquetas estão em inglês, o texto original do código do módulo.

O que faz a tarefa e quando corre

O que faz exatamente a tarefa em cada passagem?

Analisa as liquidações da Amazon que ainda não têm uma linha de extrato bancário associada e, para cada uma, tenta identificar a linha do banco que corresponde ao depósito. Se a identificar sem ambiguidade, associa-a à liquidação, regista quando o fez e publica uma mensagem nessa liquidação. Só associa e deixa nota: com esta tarefa o módulo não reconcilia nem gera lançamentos contabilísticos, e também não chama a Amazon, porque trabalha com registos que já estão no teu Odoo.

Com que frequência corre e vem ativa de origem?

Corre uma vez por dia, todos os dias, e vem ativa ao instalar o módulo. Existe em todas as versões publicadas (Odoo 17, 18, 19 e 20), e no Odoo 17 a tarefa está configurada para se repetir sem fim.

Onde vejo as liquidações com que trabalha e o que deixa escrito?

As fichas abrem-se a partir do menu Amazon › Finanças › Liquidações (pagamentos e taxas) (Amazon › Finances › Settlements (payouts & fees)). Cada nível do menu exige a permissão Visualizador (Viewer): se não a tiveres, não vês esse nível. A ficha mostra o campo Liquidação Amazon (Amazon Settlement) e a lista mostra-o como ID da liquidação Amazon (Amazon Settlement ID). É só de leitura: quem o escreve é o código, não tu, e, entre outros caminhos, preenche-o a tarefa Amazon SP-API - Sincronizar liquidações (Amazon SP-API - Sync settlements), que também corre uma vez por dia e vem ativa ao instalar. Quando a tarefa de conciliação associa um depósito, publica na liquidação esta mensagem: Depósito bancário correspondido: linha de extrato "…" de … (…) identificada como o pagamento desta liquidação. (Bank deposit matched: statement line "…" of … (…) identified as this settlement's payout.). As reticências são a referência da linha, a sua data e o seu montante.

Esquema com o nome da tarefa 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: o nome da tarefa consoante o idioma do teu Odoo. Em português, Amazon SP-API - Conciliar depósitos bancários de liquidações.
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 analisa em cada passagem

Que contas e que liquidações entram em cada passagem?

Entram as que cumprem tudo isto em simultâneo:

  • A liquidação é de uma conta Amazon que tem ativada a conciliação de depósitos bancários. Se nenhuma conta a tiver ativada, a tarefa termina sem analisar nada.
  • A liquidação ainda não tem linha de extrato bancário associada.
  • A sua data de depósito está dentro dos últimos 60 dias, contados a partir de hoje.

E se o depósito de uma liquidação for mais antigo?

Se a sua data de depósito ficar fora desses 60 dias, a tarefa não a analisa. Também não a analisa se já tiver linha associada.

Há um limite de liquidações por passagem?

Sim: até 200 liquidações por passagem, ordenadas por data de depósito da mais recente para a mais antiga. As que ficarem fora dessas primeiras 200 não são tocadas nessa passagem.

O que acontece com as liquidações que já têm uma linha associada?

Não entram na pesquisa e, além disso, o método de associação pára sem fazer nada se a liquidação já tiver linha. A tarefa não substitui uma associação existente.

Quando associa e o que verificar se não faz nada

Como decide que linha do banco associar?

Se não encontrar nenhuma linha candidata para essa liquidação, não faz nada com ela. Se encontrar apenas uma, associa-a. Se houver várias com o mesmo montante, prefere a que mencione a Amazon na sua referência ou no nome do seu contacto, mas só se for exatamente uma. Se continuar a haver dúvida, não associa nenhuma: tratando-se de dinheiro, o módulo não adivinha. Nesse caso, a decisão sobre qual é a linha correta é tua.

O que verifico se a tarefa não associa nada?

Percorre estas condições:

  • A tarefa continua ativa (vem ativa ao instalar).
  • Há liquidações no menu Amazon › Finanças › Liquidações (pagamentos e taxas): a tarefa só trabalha com as que já existem.
  • Há contas com a conciliação de depósitos bancários ativada: sem nenhuma, a tarefa termina sem analisar nada.
  • A liquidação não tem já uma linha associada.
  • A sua data de depósito está dentro dos últimos 60 dias.
  • Não há mais de 200 liquidações com depósito mais recente à frente.
  • Não há várias linhas bancárias com o mesmo montante sem que exatamente uma mencione a Amazon.

O que acontece se uma liquidação der erro?

Cada liquidação é processada em separado e os seus erros são capturados: se uma falhar, o módulo escreve um aviso no registo do servidor com o seu ID da Amazon e continua com as restantes. O código descreve a tarefa como uma que nunca lança erros.

Como a FlexigoTech te ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. O módulo está publicado no Odoo Apps para 17, 18, 19 e 20 (ficha, página do módulo). A ligação passa pela FlexigoTech Cloud, que guarda as credenciais cifradas e avisa por e-mail se a sincronização falhar; o plano Conector custa 49 €/mês ou 490 €/ano, sem IVA.

Continue a ler

Verificado no código do conector (versão 17.0 e 20.0) e nas fontes indicadas

Fontes