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.


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.

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
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 (88c7e241): views/amazon_spapi_account_views.xml
- Código do módulo: flexigobe_amazon_seller_connector 20.0 (88c7e241): models/amazon_spapi_account.py
- Código do módulo: flexigobe_amazon_seller_connector 20.0 (88c7e241): models/amazon_ai_insight.py
- apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
- flexigotech.com/en/services.html
