> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/pt/other-features/custom-analytics.md).

# Relatórios personalizados

> Peça ao Assistente de IA os dados de inventário de que você precisa e crie relatórios personalizados além dos relatórios padrão. Visualize em gráficos, salve para executar novamente ou exporte para o Excel.

![Relatórios Personalizados](https://assets.boxhero.io/docs/images/980a2afbb393abc7edc6b81724d9d79a08cea4cd103ace17bed7e9bc11e34fea-1600x940.png)

---

## Destaques

- **Peça ao Assistente de IA** os dados de inventário de que você precisa usando linguagem simples.
- **Crie relatórios personalizados** combinando condições como item, atributo, preço, intervalo de datas, parceiro e muito mais.
- **Salve os relatórios usados com frequência** para acessá-los novamente a qualquer momento.
- **Restaure versões anteriores** de um relatório com o histórico de versões integrado.
- **Visualize seus dados** em gráficos ou exporte-os para o Excel.

## Casos de uso

O recurso padrão `Relatórios de inventário` oferece uma visão rápida de métricas importantes, como a quantidade média em estoque e o giro de inventário em um período selecionado. Como esses relatórios usam variáveis e fórmulas predefinidas, eles podem não cobrir todos os tipos de relatório de que sua equipe precisa.

Os `Relatórios Personalizados` oferecem mais flexibilidade para trabalhar com os dados do seu inventário. Basta pedir ao **Assistente de IA** os dados de que você precisa, incluindo as condições e colunas desejadas, e obter um relatório personalizado em segundos. Eles são especialmente úteis quando:

- Você não consegue obter os dados de que precisa nos relatórios de inventário padrão
- Você quer detalhar os dados por condições específicas, como item, fornecedor, cliente ou membro da equipe
- Você precisa comparar dados de períodos diferentes, como mensal, trimestral ou em relação ao ano anterior
- Você precisa de dados específicos para embasar relatórios ou a tomada de decisões

[Video](https://customer-0jrbilsa8yt3k758.cloudflarestream.com/962c957b64db1649124faed7790e9ce9/iframe?poster=https%3A%2F%2Fcustomer-0jrbilsa8yt3k758.cloudflarestream.com%2F962c957b64db1649124faed7790e9ce9%2Fthumbnails%2Fthumbnail.jpg%3Fheight%3D1080%26time%3D12s&letterboxColor=transparent)

---

## Como usar os Relatórios Personalizados

### 1. Abra o Assistente de IA

Acesse `Relatórios` > `Relatórios Personalizados`.

Se for a primeira vez, o **Assistente** **de IA** será aberto automaticamente. Caso contrário, clique em `+ Novo relatório` para iniciar um novo relatório e peça ao Assistente de IA os dados de que você precisa.

![](https://assets.boxhero.io/docs/images/7548249fe4cdac38b1a4e66ef8731ea4bb89577cfbc7d3a7c497a0545496fb09-2800x1508.jpg)

> **Caution**
>
> Tanto **administradores** quanto **membros** podem criar e visualizar relatórios personalizados. Você pode restringir o acesso configurando [permissões personalizadas](https://www.boxhero.io/docs/pt/concepts/members#custom-roles-and-permissions).

### 2. Solicite seus dados

Peça ao `Assistente de IA` os dados de que você precisa em linguagem simples.

Por exemplo, digite: _"Mostre os níveis de estoque da semana passada por categoria"_ e o assistente criará um relatório com base na sua solicitação.

![](https://assets.boxhero.io/docs/images/257d4c464937618ac578fa8f8476293c79e03721cdfb65c80fef10e575c7897b-2800x1500.jpg)

> **Tip**
>
> Seja o mais específico possível sobre as **condições** e as **colunas** que você deseja. Quanto mais detalhes você fornecer, mais o relatório corresponderá às suas necessidades.

> "Mostre os dados de vendas do mês passado."\
> "Mostre o total de unidades vendidas e a receita de vendas por item no mês passado, os 10 principais por receita."

![](https://assets.boxhero.io/docs/images/1c6197501ae47ac9ec59fa963b88c0339cd0c860d4d1386b66832731e8e59bd7-2800x1507.jpg)

Se você executa o mesmo relatório repetidamente com valores de pesquisa diferentes, peça ao Assistente de IA para adicionar um **campo** **de entrada**. Depois de adicioná-lo, você pode informar novos valores a cada vez sem precisar criar o relatório novamente.

![](https://assets.boxhero.io/docs/images/75a18087e7509aabe03f19cc1b5c6ab5a60b6337917341181246540f6e6dcc30-2800x1508.jpg)

> **Tip**
>
> Use **campos** **de entrada** para valores que mudam com frequência, como nomes de itens, datas ou fornecedores.

### 3. Use seus dados

Os resultados aparecem em uma tabela. Clique em `Exportar Excel` para baixá-los ou em `Adicionar gráfico` para visualizá-los em forma de gráfico — os tipos barras, linhas, pizza, barras empilhadas e área empilhada são todos compatíveis.

![](https://assets.boxhero.io/docs/images/636a62381e6e474216eae3d5e413f6e44ebba7ac4dd1f55d0aed75ad891397f3-2800x1503.jpg)

![](https://assets.boxhero.io/docs/images/03949f5e4294caf9399194bf9c62d2c53144577b0e8365ebabe428535d8bd297-2800x1507.jpg)

Os resultados são salvos automaticamente em `Meus relatórios`, para que você possa abri-los e executá-los novamente a qualquer momento. Se fizer uma alteração sem querer, você pode reverter o relatório para uma versão anterior — clique em `...` (mais) > `Histórico de versões`.

![](https://assets.boxhero.io/docs/images/0c654c9356739769131e0db53a065e456ab8b4ecd00c00eebd8d04d107b21f37-2800x1636.jpg)

> **Note**
>
> Seus dados são sincronizados automaticamente **uma vez por dia**. Para ver os dados mais recentes, clique no **botão de sincronização** (🔄) no canto inferior esquerdo antes de executar o relatório.

> **Caution**
>
> Para campos com vários estados, como o [status do pedido](https://www.boxhero.io/docs/pt/key-features/purchase-and-sales#purchase-order-status), a interpretação da IA pode ser diferente do que você pretendia. Dados excluídos também podem ser tratados de forma diferente do esperado. Confira o resultado antes de usá-lo no seu trabalho.

---

## Modelos

Os Relatórios Personalizados incluem modelos integrados que você pode executar imediatamente. Experimente um modelo para ver os resultados. Se achar algum útil, clique em `Salvar em Meus relatórios` e ajuste-o às suas necessidades.

![](https://assets.boxhero.io/docs/images/5a1435d61d0d1f4d0f295a29677ea5c1d98685289dcb53c843d26de211c73422-2800x1509.jpg)

#### Exemplos

- Inventário total diário
- Resumo semanal de transações
- Tendência mensal de compras e vendas
- Data da última saída de estoque por item
- Avaliação de inventário FIFO
- Inventário disponível

---

## Edição de SQL

Se você tiver familiaridade com SQL, pode editar as consultas diretamente usando a sintaxe do [DuckDB SQL](https://duckdb.org/docs/current/sql/introduction) para personalizar um relatório exatamente como desejar.

Selecione um relatório, clique no botão `...` no canto superior direito e escolha `Editar SQL`.

![](https://assets.boxhero.io/docs/images/1d3e74c9c95497f17d9185ffb7e06f5e287d3a894246c51e89526d7e02509b17-2800x1507.jpg)

Você também pode adicionar um campo de entrada incluindo `{{variable_name}}` na sua consulta. Por exemplo:

```sql
select sku, name
from items
where name ilike '%' || {{item_name}} || '%';
```

Isso cria um **campo** **de entrada** chamado item_name. Digite uma palavra-chave, como _sweater_, e os resultados mostrarão todos os itens que têm "sweater" no nome.

![](https://assets.boxhero.io/docs/images/fccc6947094e4b6f0e085af9cf346e75a5956c4024e76b44dcefb8ebba20134c-2800x1609.jpg)

> **Caution**
>
> Sempre revise os resultados antes de confiar neles.

---

## Perguntas frequentes

**Ainda tem dúvidas?** Confira as perguntas frequentes sobre Relatórios Personalizados:

- [Relatórios personalizados](https://www.boxhero.io/docs/pt/faq/reporting/custom-analytics)