<!-- GERADO AUTOMATICAMENTE por paginas/montar.py.
     NAO EDITE ESTE ARQUIVO: edite paginas/_fonte/ e rode montar.py.
     O bloco comum vem de _fonte/comum-listas.md -- fonte unica, para que os
     artigos das varias telas nao possam divergir entre si. -->

# A tela de Relatórios: os prontos e o Report Builder

> **Aplica-se a:** GaxWeb 5.0.0 (alpha) — update 27.08.2026

**Aplicativos › Relatórios** guarda relatórios que cruzam os seus documentos e
respondem perguntas que a lista não responde — principalmente **documento
faltando na numeração**.

Pode trazer relatórios **prontos**, e você pode criar os seus.

## Relatórios prontos que podem estar disponíveis

> ⚠️ **Confira o que aparece na sua tela.** A lista abaixo é o que existe no
> sistema; o que **você** enxerga depende do seu perfil e da **Visibilidade** de
> cada relatório. Se algum não aparecer para você, fale com o suporte.


| Relatório | O que mostra |
|---|---|
| **Quebra de Sequência - SAT** | 🔎 As séries SAT do perfil onde **há quebra entre o número inicial e o final** — ou seja, **documentos faltando**. |
| **Sequenciamento - SAT** | Verifica a sequência dos documentos SAT no período, **identificando as lacunas**. |
| **Apoio Escrituração - SAT** | Resumo mensal de documentos SAT emitidos, processados e cancelados. |
| **Apoio Escrituração - CFe** | O mesmo, para CF-e. |
| **Movimento Diário - CFe** | Resumo **diário** de CF-e emitidos, processados e cancelados. |
| **Sequência NFCe** | Sequenciamento das NFC-e. |
| **Quebra NFCe** | As quebras de sequência nas NFC-e. |
| **Apoio CFe** | Apoio à escrituração de CF-e. |

> 📅 **Rotina que vale ouro no fechamento do mês:** rode *Quebra de Sequência* e
> *Sequenciamento* antes de entregar ao contador. Documento faltando na numeração é
> exatamente o que o fisco cobra depois — e é o tipo de coisa que ninguém percebe
> olhando a lista de notas.

## As colunas

| Coluna | O que mostra |
|---|---|
| **ID** | Número do relatório. |
| **Nome** | Como ele se chama. |
| **Descrição** | O que ele faz. |
| **Visibilidade** | 👁️ **público** (todos do perfil veem) ou **privado** (só quem criou). |
| **Usuário** | Quem criou. |
| **Criação** / **Atualização** | Quando foi criado e alterado. |

**Filtro no cabeçalho** para ID, Nome e Descrição.

## O que fazer com um relatório

**Botão direito** sobre a linha:

| Ação | O que faz |
|---|---|
| **Visualizar relatório** | Roda e mostra o resultado. |
| **Editar relatório** | Abre para alterar. |
| **Exportar Excel** | 📗 Baixa o resultado em Excel. |
| **Excluir** | Remove o relatório. |
| **Recarregar item** | Atualiza a linha. |

E o botão **Novo relatório**, no topo, abre o construtor.

> 💡 **Precisa de um relatório recorrente?** Crie uma vez e deixe **público** — a
> equipe inteira passa a usar o mesmo, e ninguém refaz filtro toda semana.

## A tela por partes

As telas de Administração seguem o mesmo desenho das listas de documentos, com um
ícone a mais.

## Os ícones do canto superior direito

| Ícone | O que faz |
|---|---|
| 📗 **Exportar resultado para Excel** | Baixa em Excel o que está na tela, com os filtros aplicados. |
| 🔄 **Recarregar toda a tabela** | Busca os dados de novo no servidor. |
| ☷ **Exibir/Ocultar colunas** | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". |
| 🧹 **Vacuum (compactar tabela)** | Compacta a tabela no banco. *Só existe nas telas de Administração.* |
| ☰ **Mais filtros** | Abre e fecha o painel **Outros filtros**, à direita. |

> 🧹 **Tela bagunçada?** Há também **Reiniciar storage local**. O GaxWeb guarda no
> seu navegador a largura e a ordem das colunas; se a tela ficou torta ou uma
> coluna sumiu e não volta, esse botão devolve o padrão. Mexe só no seu navegador,
> não altera dado nenhum.

## Reload, Registros e páginas

No topo: **Reload** (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e
**Registros** (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As
páginas ficam no rodapé.

> ⚠️ **A seleção por caixinha vale só na página aberta.** Marcou itens e virou a
> página? A marcação anterior se perde. Aumente **Registros** antes de marcar.

## A lista rola para o lado

As colunas passam da largura da tela. **Role para a direita** antes de concluir
que uma informação não existe — ou esconda as colunas que não usa.

## Como filtrar

**1. Filtro por coluna** — a caixinha abaixo do título. Nem toda coluna tem.
**2. Painel "Outros filtros"** — à direita, pelo ícone ☰.
**3. Ordenação** — clique no título da coluna.

Os três se somam.

> 🔍 **"Sumiu da lista".** O painel já vem com **Situação = 1:Ativo**: registros
> inativos ficam ocultos por padrão. Clique no **X** ao lado do campo Situação
> para ver todos. É a causa nº 1 de "meu cadastro desapareceu".

### O painel tem duas seções

Repare que **Situação** aparece duas vezes: uma na seção do **Perfil** e outra na
do registro que você está vendo. São filtros diferentes — o primeiro restringe
pelo perfil, o segundo pelo próprio cadastro.

## Abrir, editar e o histórico

**Botão direito sobre a linha:**

| Ação | O que faz |
|---|---|
| **Editar** | Abre o cadastro. |
| **Alterações** | 🕓 **Mostra quem mudou o quê, e quando.** Existe em toda a Administração e só aparece aqui. |
| **Recarregar item** | Atualiza só aquela linha. |

> ⏱️ **"Quem alterou isso?"** — use **Alterações**. É o histórico do registro, e
> resolve discussão sem precisar abrir chamado.

> 🖱️ **Duplo clique não faz nada.** Para abrir, use o botão direito → Editar.

## Ao salvar, a janela não fecha

Ela passa a se chamar **"Editando &lt;nome&gt; (ID nn)"** e continua aberta. **Se
apareceu o ID no título, gravou.** Pode fechar.

## Se um relatório que você usava não está aqui

Se você usava algo na versão 4.6 que não aparece:

1. Confira a **Visibilidade** — se foi criado como *privado* por outra pessoa, ele
   não aparece para você.
2. Veja se o filtro **Situação** do painel não está escondendo registros.
3. Se mesmo assim não achar, fale com o suporte informando **o nome do relatório**
   como era usado antes. Nem tudo que existia na 4.6 tem equivalente pronto aqui —
   alguns precisam ser recriados no construtor.