Saltar para o conteúdo principal
Amazon

Botão «Gerar Relatório IA» do Amazon Connector for Odoo: o que faz, passo a passo

O botão Gerar Relatório IA (Generate AI Report) cria no momento um relatório de IA para a conta Amazon e leva-o à respetiva ficha; antes verifica se tem permissão de gestor e, se a IA estiver desativada ou se tiver sido atingido o limite de custo, deixa na mesma um relatório em vez de dar erro. Não é preciso carregar nele para ter relatórios: uma tarefa agendada gera um por conta ativa todas as semanas.

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

O caminho normal e onde está o botão

Tenho de carregar no botão para ter um relatório de IA?

Não necessariamente. O módulo traz uma tarefa agendada, IA Amazon - Resumo semanal (Amazon AI - Weekly digest), que corre todas as semanas e está ativa ao instalar. Percorre as contas ativas (por defeito, até 100) e gera um relatório por conta com o mesmo método que o botão utiliza. Por isso Gerar Relatório IA é a exceção: serve para pedir um relatório manualmente, sem esperar pela tarefa.

Onde está o botão e quando aparece?

Está no ecrã Contas (Accounts), que se abre a partir do menu Amazon › Configuração › Contas (Amazon › Configuration › Accounts). Para chegar lá são necessárias permissões: o nível Amazon pede Visualizador (Viewer), e os níveis Configuração e Contas pedem Gestor (Manager); se não tiver a permissão de um nível, não o vê. O botão não tem nenhuma condição de visualização: vê-se sempre, no Odoo 17, 18, 19 e 20. Que se veja não significa que o possa utilizar, como explica a secção seguinte.

Esquema feito com código do menu Amazon, Configuration, Accounts e do botão Generate AI Report, com a mensagem de permissões que o pode deter
Esquema feito a partir do código publicado do módulo (não é uma captura do Odoo): o menu, o botão no Odoo 17, 18, 19 e 20 e, a um lado, a mensagem que o pode parar.
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 verifica e o que faz ao carregar

O que verifica primeiro o botão?

As permissões, e fá-lo no servidor: não depende de o botão se ver no ecrã. Salvo se a ação for executada com privilégios de superutilizador, quem carrega tem de pertencer ao grupo de gestores do conector da Amazon ou ao das Definições. Caso contrário, a ação é interrompida com a mensagem You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access. e não se cria nenhum relatório. Depois verifica ainda se tem permissão de escrita sobre essa conta. A solução é a que a própria mensagem indica: que um gestor lhe atribua o acesso de Gestor.

O que faz quando tem permissão?

No código do Odoo 20, o botão pede ao modelo de relatórios que gere o relatório semanal dessa conta, e fá-lo por esta ordem. Primeiro vê se a IA está desativada: se estiver, cria o relatório sem chamar a API de IA. Se não, prepara a ficha de dados da conta. Depois verifica se foi atingido o limite mensal de custo da conta: se sim, cria o relatório com os dados de partida e o corpo já preenchido, também sem chamar a API. Se não se der nenhum desses casos, prepara as instruções para a IA e o idioma do relatório. No final, abre a ficha do relatório devolvido.

O que acontece se a IA estiver desativada ou se tiver sido atingido o limite de custo?

Não há erro. O próprio método explica que uma IA desativada, uma chave em falta, uma recusa, o limite de custo ou uma falha do serviço dão como resultado um relatório «amável» em vez de uma exceção. Com a IA desativada, o relatório leva a nota IA desativada nas Definições (AI disabled in Settings). Com o limite de custo atingido, a nota é O limite mensal de custo de IA foi atingido. (The monthly AI cost limit has been reached.) e guardam-se também os dados de partida. Em ambos os casos o relatório é criado sem chamar a API, e cada clique cria um relatório novo.

O que pede o módulo à IA?

As instruções pedem que responda apenas com os dados que lhe são passados, sem inventar valores nem SKU, e que o diga claramente se não houver dados suficientes. Pedem uma análise dos SKU urgentes de reposição, uma revisão dos que mais vendem com a sua cobertura e a sua tendência, um sinal dos SKU com stock em FBA que não se vendem e, só se existirem, os alertas da conta. Pedem também que a previsão de baixa confiança seja apresentada com esse aviso, nunca como certeza. O resultado pedido é um resumo em markdown e uma lista de ações, uma por SKU relevante.

O que vê depois e o que acontece quando falha

O que vejo no final?

Abre-se, na mesma janela, a ficha do relatório. Quando a IA está desativada ou foi atingido o limite de custo, o título do relatório começa por Relatório de IA (AI Report) e a seguir leva o nome da conta. O nome da conta é o campo Nome (Name), que vê na ficha de Contas, separador Identidade (Identity), grupo Conta (Account), e também na lista de Contas.

O que acontece se a tarefa semanal falhar com uma conta?

Cada conta é processada dentro do seu próprio bloco protegido, pelo que uma falha não pára as restantes nem a tarefa. O módulo deixa um aviso no registo do servidor e tenta guardar um relatório intitulado Relatório de IA (erro) (AI Report (error)) com uma nota que começa por Erro inesperado: … (Unexpected error: …). Se nem isso puder ser guardado, a falha fica apenas no registo do servidor.

Em que idioma sai o relatório e em que versões existe o botão?

Segundo o comentário do código, as instruções à IA estão em castelhano, mas o idioma de saída segue o do Odoo do vendedor. O código toma o idioma do contacto da empresa da conta e, se não o tiver, o do utilizador ou o da sessão; se não houver nenhum, inglês. O botão existe nas ramificações 17, 18, 19 e 20, e o módulo está publicado no Odoo Apps para essas mesmas versões. O rótulo muda com o idioma do seu Odoo: em português é Gerar Relatório IA.

Esquema feito com código do rótulo Generate AI Report em vários idiomas
Esquema feito a partir das traduções publicadas do módulo (não é uma captura do Odoo): em castelhano, Generar informe IA; em alemão, KI-Bericht erstellen; em francês, Générer un rapport IA; em italiano, Genera report AI; em português, Gerar Relatório IA.

Se precisar de ajuda com o conector

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser rever quem deve ter acesso de gestor ou ajustar o que o conector faz com as suas contas, pode ver a ficha no Odoo Apps ou a página do módulo.

Continue a ler

O que faz o botão «Pré-visualizar na Amazon» do Amazon Connector for OdooO que faz o botão «Pré-visualizar na Amazon» do conector da Amazon para Odoo: quando aparece, o que verifica, o que guarda e que erros pode dar.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