# Relatórios — Visão Geral

A página de **Relatórios** permite extrair, filtrar e baixar dados da sua operação logística em diversos formatos. É o ponto central para análise de pedidos, envios, eventos, integrações, filiais e pesquisa de satisfação.

---

## Onde acessar

- **URL:** [https://dashboard.abbiamolog.com/reports](https://dashboard.abbiamolog.com/reports)
- **Menu:** Na barra lateral (sidebar) do painel, o item **"Relatórios"** aparece com ícone de documento.

---

## O que o cliente vê ao entrar

### Cabeçalho

| Elemento | Descrição |
|----------|-----------|
| **Menu lateral duplo** | Botão para abrir/fechar a sidebar |
| **Título** | "Relatórios" |
| **Dicionário** | Abre o dicionário de colunas (PT ou EN), explicando cada coluna dos relatórios |
| **Novo relatório** | Abre o modal de criação de novo relatório |

### Área de filtros e busca

- **Campo de busca:** filtra pelo nome do relatório.
- **Botão atualizar:** recarrega a lista manualmente.
- **Filtros avançados:**
  - Nome
  - Tipo do relatório
  - Formato (CSV, JSON)
  - Status (Na fila, Processando, Completo, Falha, Expirado)
- **Controle de colunas:** permite mostrar/ocultar colunas da tabela.

### Tabela de relatórios

| Coluna | O que mostra |
|--------|-------------|
| **Nome** | Nome dado ao relatório |
| **Tipo** | Badge indicando a categoria (Pedidos, Eventos, etc.) |
| **Formato** | Ícone de CSV ou JSON |
| **Status** | Badge com o estado atual do relatório |
| **Filiais** | Chips das filiais incluídas ou "Todos" |
| **Criado em** | Data e hora de criação |
| **Ações** | Menu (⋮) com opções: baixar, gerar novamente, excluir |

### Paginação

No rodapé da tabela: tamanhos de página (50, 100, 150, 200) e navegação entre páginas.

### Estado vazio

Se não houver relatórios ou nenhum resultado dos filtros, aparece a mensagem:

> *"Nenhum relatório encontrado, ainda... Crie um novo agora mesmo!"*

---

## Tipos de relatório

| Tipo | Descrição |
|------|-----------|
| **Pedidos (ORDERS)** | Dados completos dos pedidos — com filtros de período, filiais, transportadoras e status |
| **Eventos (EVENTS)** | Registros de eventos logísticos |
| **Envios (DELIVERIES)** | Dados dos envios realizados |
| **Integrações de Pedidos** | Informações das integrações de pedidos com sistemas externos |
| **Integrações de Transportadoras** | Dados das integrações com transportadoras |
| **Filiais (SELLERS)** | Dados cadastrais das filiais |
| **Pesquisa de Satisfação (CSAT)** | Respostas da pesquisa de satisfação — com filtro de período |

---

## Status do relatório

| Status | Significado |
|--------|-------------|
| **Na fila (QUEUED)** | Aguardando processamento |
| **Processando (PROCESSING)** | O arquivo está sendo gerado com os filtros aplicados |
| **Completo (DONE)** | Pronto para download |
| **Falha (FAILED)** | Houve um erro na geração |
| **Expirado (EXPIRED)** | Não está mais disponível — gere novamente se necessário |
**Atualização automática:** Se você acabou de gerar um relatório, não precisa atualizar a página manualmente: enquanto ele estiver **Na fila** ou **Processando**, a lista se atualiza sozinha até o arquivo ficar pronto para download.

---

## Formatos disponíveis

| Formato | Observação |
|---------|------------|
| **CSV** | Formato padrão, compatível com Excel, Google Sheets etc. |
| **JSON** | Ideal para integrações e consumo programático |

---

## Comportamentos automáticos

- **Polling de status:** relatórios recentes com status pendente são atualizados a cada 5 segundos (até 2 horas).
- **Filtros persistentes:** as condições de filtro são salvas no navegador por grupo de filiais e por página (`reports`). Ao retornar, os filtros permanecem como estavam.
- **Reset de paginação:** ao alterar texto de busca ou condições de filtro, a tabela volta para a primeira página.

---

## Próximos passos

- [**Como usar**](https://abbiamo-guide.netlify.app/go/products/relatorios/como-usar/) — passo a passo para criar, baixar, filtrar e excluir relatórios.
- [**Troubleshooting**](https://abbiamo-guide.netlify.app/go/products/relatorios/troubleshooting/) — resolver divergências de datas, timezone e problemas de status.