Saltar para o conteúdo principal
Amazon

Tarefa «Sincronizar relatório de reembolsos FBA» do Amazon Connector: glossário

A tarefa Amazon SP-API - Sincronizar relatório de reembolsos FBA (opt-in) (Amazon SP-API - Sync FBA reimbursements report (opt-in)) corre uma vez por dia e vem ativa ao instalar. Em cada passagem percorre as contas da Amazon ativas com a sincronização de reembolsos FBA habilitada, pede um relatório à Amazon, espera que esteja pronto, entrega as suas linhas ao importador e guarda o resultado na conta.

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

A tarefa existe, com o mesmo nome, nas ramificações 17, 18, 19 e 20 do Amazon Connector for Odoo, FBA & FBM Seller SP-API.

Esquema com a tarefa agendada de reembolsos FBA, que corre uma vez por dia e vem ativa ao instalar, e o menu Amazon, Configuration, Accounts
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo. Os rótulos estão em inglês, como no código.

A tarefa e o seu calendário

Tarefa agendada
A tarefa Amazon SP-API - Sincronizar relatório de reembolsos FBA (opt-in) trabalha sobre as contas da Amazon do módulo e executa um método que as percorre. O rótulo inclui (opt-in): no código, a tarefa só percorre as contas que têm a sincronização de reembolsos FBA habilitada.
Frequência
Corre uma vez por dia, ou seja, todos os dias, e vem ativa ao instalar o módulo. No Odoo 17 a tarefa está definida para se repetir sem fim.
Conta incluída
Em cada passagem a tarefa procura as contas que estão ativas e têm a sincronização de reembolsos FBA habilitada. Se uma conta não cumprir as duas condições, a tarefa não lhe toca; se nenhuma as cumprir, não há nada para percorrer.

Com o Odoo em português de Portugal, a tarefa chama-se Amazon SP-API - Sincronizar relatório de reembolsos FBA (opt-in). O esquema mostra como se chama com o Odoo noutros idiomas.

Esquema com o nome da tarefa em espanhol, 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. Espanhol: Amazon SP-API - Sincronizar relatório de reembolsos FBA (opt-in). Alemão: Amazon SP-API - FBA-Erstattungsbericht synchronisieren (Opt-in). Francês: Amazon SP-API - Synchroniser le rapport des remboursements FBA (opt-in). Italiano: Amazon SP-API - Sincronizza report rimborsi FBA (opt-in). Português: Amazon SP-API - Sincronizar relatório de reembolsos FBA (opt-in).
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 com uma conta

Pedido do relatório
Para cada conta, a passagem pede à Amazon que crie um relatório de reembolsos. Com o identificador que a Amazon devolve segue em frente; a linha ID do relatório: … (Report ID: …) recolhe-o no resultado.
Consulta do estado
A passagem pergunta à Amazon pelo relatório até que o seu estado seja DONE, CANCELLED ou FATAL, ou até esgotar as tentativas. Entre uma tentativa e a seguinte espera alguns segundos. Se o número de tentativas ou a espera da conta estiverem vazios ou a zero, usa doze tentativas e dez segundos de espera; no mínimo faz uma tentativa e espera um segundo.
Estado do relatório
A linha Estado do relatório: … (Report status: …) mostra o último estado que a Amazon deu, ou UNKNOWN se não chegou nenhum. Se não for DONE, a passagem pára aí e não importa nada. Com CANCELLED ou FATAL acrescenta A Amazon não gerou um relatório de reembolsos utilizável. (Amazon did not generate a usable reimbursements report.). Em qualquer outro estado acrescenta O sondagem do relatório expirou. Tente novamente dentro de alguns minutos. (Report polling timed out. Try again in a few minutes.).
Documento do relatório
Com o relatório em DONE, a passagem precisa do identificador do seu documento. Se faltar, acrescenta Relatório CONCLUÍDO sem reportDocumentId. (DONE report without reportDocumentId.) e pára. Se o tiver, obtém o conteúdo do documento e passa-o ao importador.
Importação
O conteúdo obtido do documento passa ao importador das linhas de reembolso FBA do módulo, juntamente com a conta, o identificador do relatório e o do seu documento, o marketplace da conta e o limite de linhas por passagem da conta. Se esse limite estiver vazio ou a zero, a passagem entrega 10000.
Contadores
Depois de importar, o resultado soma estas linhas: Filas reporte (Report rows), Filas procesadas (Processed rows), Creadas (Created), Actualizadas (Updated), Saltadas (Skipped) e Con error (With error), cada uma com a sua cifra.
Auditoria de reembolsos
Se a conta tiver ativada a auditoria de reembolsos, logo após importar a passagem atualiza as reclamações de reembolso dessa conta.
Resultado guardado
Ao terminar, quer tenha importado quer tenha parado antes, a passagem escreve na conta a data e hora da execução e o texto do resultado, cortado aos cinco mil carateres. O texto começa com Sincronização dos reembolsos FBA da Amazon concluída. (Amazon FBA reimbursements sync finished.), Conta: … (Account: …) e Origem: … (Source: …); a origem é CRON se a lançar a tarefa e Manual noutro caso. Quando a lança a tarefa, não publica esse texto no chatter da conta.

O que verificar se não faz nada

Aviso no registo
Se a passagem de uma conta lançar um erro, a tarefa apanha-o, regista um aviso no registo do servidor com o nome da conta e continua com a seguinte. Por isso a falha de uma conta não pára as restantes. O nome é o campo Nome (Name), que se vê na ficha de Contas (Accounts), no separador Identidade (Identity), grupo Conta (Account), e também na lista de Contas.
Menu e permissões
As contas abrem-se a partir de Amazon › Configuração › Contas (Amazon › Configuration › Accounts). O troço Amazon pede a permissão Visualizador (Viewer); Configuração (Configuration) e Contas pedem Gestor (Manager). Se não tiver a permissão de um troço, não o vê.

Com isto, uma revisão ordenada quando a tarefa parece não fazer nada:

  • A tarefa vem ativa ao instalar: verifique que continua ativa.
  • A conta tem de estar ativa e com a sincronização de reembolsos FBA habilitada; se não, a tarefa não a percorre.
  • O texto do resultado fica guardado na conta: se a linha Estado reporte não for DONE, a passagem parou antes de importar; a linha seguinte do resultado diz se a Amazon não gerou um relatório utilizável ou se expirou o tempo de espera do relatório.
  • Se o relatório chegou a DONE, veja os contadores Saltadas e Con error do resultado.
  • Procure no registo do servidor o aviso com o nome da conta.

Subscrição e ajuda da FlexigoTech

O módulo é de pagamento único por versão do Odoo (publicado para 17, 18, 19 e 20) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA, até três contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que 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 aquilo que a subscrição dá; os dados ficam no seu Odoo. Pode ver o módulo na página da FlexigoTech.

Se está a implementar o Odoo e quer rever como a sincronização de reembolsos se encaixa nas suas contas da Amazon, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

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

Fontes