> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/uplaces-ai/leitura-de-relatorio.md).

# Ler o relatório com IA

Leia o relatório de vendas com IA: clique em O que isso quer dizer? e receba os números do relatório explicados em texto simples, no painel de administração.

Os relatórios da Uplaces mostram tabelas e totais. Com a Uplaces IA ligada, cada relatório ganha o botão **O que isso quer dizer?**: ao clicar, a IA lê os números que estão na tela e explica em texto o que eles mostram, por exemplo se a venda está concentrada em poucos clientes ou qual mês fugiu do padrão.

O relatório continua o mesmo, calculado pelo sistema. A IA só interpreta o resultado que já está na tela: não busca outros dados e não inventa número.

## Antes de começar

* O módulo **Uplaces IA** precisa estar ligado em **Módulos**. Veja [Pedidos com IA para vendas B2B: o que é a Uplaces IA e como ativar](/uplaces-ai.md).
* A empresa precisa ter saldo de créditos, porque cada leitura consome créditos. Veja [Créditos da IA](/uplaces-ai/creditos-da-ia.md).
* O usuário precisa ter permissão para ver relatórios de vendas. Sem ela, o relatório nem aparece.
* A leitura funciona nos relatórios de **Vendas**, **Produtos** e **Clientes** do painel de administração.

{% hint style="info" %}
O botão fica nos relatórios do painel de administração.
{% endhint %}

{% stepper %}
{% step %}

## Abrir um relatório

1. No menu lateral, abra **Relatórios** e clique em **Ver relatórios**.
2. Escolha o relatório. Eles estão agrupados em três cartões:
   * **Vendas:** **Por mês**, **Por Vendedores X Clientes** e **Por Clientes X Produtos**.
   * **Produtos:** **Mais vendidos** e **Curva ABC**.
   * **Clientes:** **Que mais compram** e **Curva ABC**.
3. Se quiser olhar um recorte, aplique o filtro de período, de clientes ou de vendedores antes de pedir a leitura.
   {% endstep %}

{% step %}

## Pedir a leitura

Acima do relatório aparece uma caixa com o botão **O que isso quer dizer?** e, ao lado, a linha **Responde:** com as perguntas que aquela leitura costuma esclarecer. As perguntas mudam conforme o relatório e conforme a quantidade de linhas: um relatório de poucas linhas não oferece perguntas de tendência, por exemplo.

1. Com o relatório e o filtro que você quer na tela, clique em **O que isso quer dizer?**.
2. Aguarde alguns segundos. A tela mostra o indicador de carregamento enquanto a IA lê.
3. A explicação aparece abaixo do botão, em parágrafos.

{% hint style="info" %}
O filtro que você aplicou vai junto. Se a tela mostra só o último trimestre ou só um vendedor, a leitura fala desse recorte, e não da empresa inteira.
{% endhint %}
{% endstep %}

{% step %}

## Entender o que a IA leu

A IA recebe os totais e as linhas do relatório, já calculados. Em relatórios muito longos, ela considera as primeiras linhas, que são as de maior peso porque o relatório já vem ordenado, junto com os totais, que sempre entram.

O que a leitura costuma trazer, conforme o relatório:

* Relatório **Por mês:** o que explica a variação entre os meses e se a tendência é de alta ou de queda.
* **Que mais compram** e **Curva ABC** de clientes: se a venda está concentrada em poucos clientes e quais merecem atenção.
* **Mais vendidos** e **Curva ABC** de produtos: quais produtos concentram o faturamento e o que oferecer junto com os campeões.
* **Por Vendedores X Clientes:** como está a distribuição entre os vendedores.
* **Por Clientes X Produtos:** o que os clientes compram juntos e quem parou de comprar um produto.

{% hint style="warning" %}
A leitura é um apoio para quem analisa, não uma decisão pronta. Confira com a tabela do relatório antes de agir, principalmente antes de ligar para um cliente ou mudar a oferta de um produto.
{% endhint %}
{% endstep %}
{% endstepper %}

## Resultado

A explicação em texto aparece no próprio relatório, e a tabela continua logo abaixo para você conferir. Quando a leitura é concluída, o rodapé da caixa mostra quantos créditos foram usados e o saldo que sobrou.

## Quanto custa

Cada leitura usa créditos da empresa. O valor aparece no rodapé da caixa depois que a leitura termina, e o extrato registra cada uso. Veja [Créditos da IA](/uplaces-ai/creditos-da-ia.md).

* Relatório sem dados no período não gasta crédito: a tela pede para ajustar o período ou o filtro.
* Se a IA não consegue montar a explicação, o crédito é devolvido.
* O relatório em si continua gratuito. Só a leitura por IA consome crédito.

## Problemas comuns

<details>

<summary>O botão O que isso quer dizer? não aparece</summary>

O módulo Uplaces IA não está ligado em **Módulos**, ou o usuário não tem permissão para ver relatórios de vendas. Peça ao administrador para conferir os dois.

</details>

<details>

<summary>A tela avisa que a análise por IA não está liberada para os relatórios desta conta</summary>

A leitura de relatórios está desligada para a empresa. Fale com o suporte da Uplaces para liberar.

</details>

<details>

<summary>A tela avisa que a análise está indisponível por falta de créditos</summary>

O saldo acabou. Compre créditos em **Uplaces IA › Painel e créditos**. Veja [Créditos da IA](/uplaces-ai/creditos-da-ia.md).

</details>

<details>

<summary>A tela diz que o relatório não tem dados no período selecionado</summary>

Não há o que explicar. Ajuste o período ou o filtro e clique de novo.

</details>

<details>

<summary>Aparece "Não foi possível analisar agora"</summary>

Foi uma falha momentânea. Tente de novo em instantes. Se o relatório carregar normalmente, a falha foi só da leitura, e o crédito não é descontado.

</details>

## Perguntas frequentes

<details>

<summary>A IA pode errar na explicação?</summary>

Pode. Ela interpreta números que o sistema já calculou, e por isso não inventa valores, mas a interpretação pode não ser a mais útil para o seu negócio. Use como ponto de partida e confira com a tabela.

</details>

<details>

<summary>A IA vê os dados de outras empresas?</summary>

Não. Ela só recebe o relatório que está na tela, da sua empresa e com o filtro que você aplicou.

</details>

<details>

<summary>Posso fazer perguntas livres sobre o relatório?</summary>

Não. A leitura responde às perguntas listadas na linha **Responde:**, e não há campo para digitar uma pergunta própria.

</details>

<details>

<summary>Preciso ligar algo para o relatório continuar funcionando?</summary>

Não. Sem o módulo, o relatório funciona normalmente, só não aparece o botão.

</details>

## Veja também

* [Relatórios de vendas](/relatorios.md): o que cada relatório mostra e como filtrar
* [Créditos da IA](/uplaces-ai/creditos-da-ia.md)
* [Pedidos com IA para vendas B2B: o que é a Uplaces IA e como ativar](/uplaces-ai.md)
* No site: [pedidos com IA](https://uplaces.com.br/pedidos-com-ia/) e [gestão de pedidos](https://uplaces.com.br/gestao-de-pedidos/)