Saltar para o conteúdo principal
Amazon

Tarefa de transações de IVA do Amazon Connector: o que faz e quando corre

A tarefa agendada Amazon SP-API - Sincronizar relatório de transações de IVA (opt-in) (Amazon SP-API - Sync VAT transactions report (opt-in)) corre uma vez por dia e vem ativa ao instalar o módulo. Em cada passagem percorre as contas da Amazon que estão ativas e têm a sincronização de transações de IVA ativada, pede o relatório à Amazon e, se chegar concluído, importa-o. Se não faz nada com uma conta, começa por verificar essas duas condiçõ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 17.0 e 20.0 · nas fontes indicadas no fim
Leitura
4 min

O que é esta tarefa e quando corre

É a tarefa do Amazon Connector for Odoo, FBA & FBM Seller SP-API que trata do relatório de transações de IVA da Amazon.

O que é esta tarefa agendada e de quanto em quanto tempo corre?

É uma tarefa agendada definida sobre as contas da Amazon do módulo. Corre uma vez por dia e vem ativa ao instalar. O que executa é o método que percorre as contas e lança, conta a conta, a sincronização do relatório de transações de IVA.

Está em todas as versões do Odoo?

A tarefa está nos ramos 17, 18, 19 e 20, os mesmos para os quais o módulo está publicado no Odoo Apps. No Odoo 17 a tarefa está configurada para se repetir sem fim.

Que contas entram em cada passagem?

Apenas as contas da Amazon que estão ativas e têm a sincronização de transações de IVA ativada. O rótulo da tarefa inclui opt-in: a tarefa vem ativa, mas uma conta inativa, ou sem essa sincronização ativada, não entra na passagem.

Esquema feito com código: a tarefa agendada de transações de IVA, que corre uma vez por dia e vem ativa ao instalar, e o menu Amazon, Configuração, Contas
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 contas.

Consoante o idioma do Odoo, a tarefa chama-se assim: em castelhano, Amazon SP-API - Sincronizar relatório de transações de IVA (opt-in); em alemão, Amazon SP-API - USt-Transaktionsbericht synchronisieren (Opt-in); em francês, Amazon SP-API - Synchroniser le rapport des transactions TVA (opt-in); em italiano, Amazon SP-API - Sincronizza report transazioni IVA (opt-in); em português, Amazon SP-API - Sincronizar relatório de transações de IVA (opt-in).

Esquema feito com código com o nome da tarefa agendada 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 Odoo.
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 faz em cada passagem

O que faz a tarefa com cada conta, por ordem?

Primeiro procura as contas que cumprem as duas condições. Depois, para cada uma, pede à Amazon que crie o relatório de transações de IVA. A seguir consulta o estado do relatório várias vezes, com uma pausa entre consultas, e deixa de consultar quando a Amazon o dá por concluído, cancelado ou com erro fatal. Se estiver concluído e trouxer documento, descarrega o documento e entrega-o ao importador do módulo, com um máximo de linhas por passagem.

Quantas vezes consulta e quanto espera?

As tentativas de consulta, a espera entre elas e o máximo de linhas por passagem saem de valores da conta. Se algum não tiver valor, o código usa doze tentativas, dez segundos de espera e dez mil linhas.

O que acontece se a Amazon não concluir o relatório ou a sincronização de uma conta falhar?

Se o relatório acabar cancelado, com erro fatal ou continuar sem estar pronto quando as tentativas se esgotam, essa conta não importa nada nessa passagem: guarda-se a data da execução e um resumo do resultado, e a tarefa segue para a conta seguinte. O mesmo acontece se a Amazon der o relatório por concluído mas sem documento. A conta volta a ser tentada na passagem seguinte da tarefa, que é uma vez por dia. Se a sincronização de uma conta falhar com um erro, a tarefa segue com as restantes contas e termina com normalidade.

O que se guarda na conta e o resultado é publicado no chatter?

Quando a passagem chega ao fim (com o relatório importado, não concluído ou sem documento), guardam-se na conta a data da execução e o texto do resultado, cortado a cinco mil carateres. Se a sincronização chegar a importar, esse resumo conta as linhas do relatório e quantas foram processadas, criadas, atualizadas, ignoradas ou deram erro. A tarefa pede à sincronização que não publique o resultado no chatter da conta; o que fica é o resumo guardado na conta.

O que verificar se não faz nada

Porque é que não acontece nada com a minha conta?

A tarefa só recolhe contas ativas e com a sincronização de transações de IVA ativada: se à tua conta falta uma das duas coisas, fica fora da passagem. Além disso, verifica que a tarefa não foi desativada (vem ativa ao instalar). Para localizar a conta, abre Amazon › Configuração › Contas e procura-a por Nome, que aparece na lista e na ficha de Contas, separador Identidade, grupo Conta. Se não vês esse menu, é uma questão de permissões: cada nível pede a sua e, se não a tens, não vês esse nível. Amazon pede Visualizador, Configuração pede Gestor e Contas também pede Gestor.

A subscrição influencia?

A ligação passa pelo FlexigoTech Cloud: guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no teu Odoo. O módulo é de pagamento único por versão e precisa do plano Conector (49 € por mês ou 490 € por ano, sem IVA, até 3 contas da plataforma).

Se estás a implementar o Odoo e queres rever a ligação com a Amazon, ou precisas de uma integração à medida, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores. Tens a página do módulo para ver como se compra.

Continue a ler

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

Fontes