<!-- 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. -->

# O monitor de NF-e: acompanhar e diagnosticar

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

**Monitores › NFe/AN** é onde se acompanha a busca automática de notas fiscais no
Ambiente Nacional — e onde se descobre **por que uma empresa parou de receber**.

É o monitor mais completo: tem **quatro telas**, duas a mais que os outros.

## As quatro telas

| Tela | Para que serve |
|---|---|
| **Empresas** | Quais empresas estão sendo monitoradas e o estado de cada uma. |
| **DFe** | Cada documento que o monitor trouxe, com seu NSU. |
| **Tentativas** | 🔧 **O histórico das consultas à Sefaz**, com o código de retorno de cada uma. |
| **Ciência** | A ciência automática da operação. |

## Como ler a tela de Empresas do monitor

É a tela de diagnóstico do "não está chegando nota". Cada linha é uma empresa
monitorada, e quatro colunas contam a história toda:

| Coluna | O que olhar |
|---|---|
| **Certificado digital** | Sem certificado válido não há consulta. |
| **Última consulta** | 🕐 Se está vazia ou antiga, as consultas **pararam**. |
| **Informações** | 💬 **A mensagem do sistema sobre a última consulta.** É o diagnóstico mais direto que existe. |
| **Status** | O estado atual do monitoramento. |

> 🎯 **Comece pela coluna Informações.** Ela diz, em texto, por que a última
> consulta não trouxe nada — certificado vencido, consumo indevido, sem
> movimento. Veja *O que significa cada status e mensagem do GaxWeb*.

> ⚠️ **A empresa não aparece nesta lista?** Então ela **não está sendo
> monitorada**. Vá em *Administração › Empresas → aba Monitor* e ponha o monitor
> daquele tipo em **Ativo** — lembrando que definir só o **Ciclo** não liga nada.

## As telas de cada monitor

| Tela | Para que serve |
|---|---|
| **Empresas** | Quais empresas estão sendo monitoradas e o estado de cada uma. |
| **DFe** | Os documentos que o monitor trouxe, um a um, com o NSU de cada. |

## Filtrar e navegar

Vale aqui tudo o que vale nas outras listas: **filtro no cabeçalho** de algumas
colunas, **painel "Outros filtros"** pelo ícone ☰, **rolagem horizontal** (as
colunas passam da largura da tela) e **paginação** no rodapé, com o seletor
**Registros** no topo.

Os ícones do canto superior direito são os mesmos: **Exportar resultado para
Excel**, **Recarregar toda a tabela**, **Exibir/Ocultar colunas**, **Vacuum** e
**Mais filtros** — além do **Reiniciar storage local**, que devolve o padrão se a
tela ficar torta.

> 🔍 O filtro **Informações**, no cabeçalho da coluna, é o mais útil: dá para
> procurar todas as empresas com a mesma mensagem de erro de uma vez.

## O NSU: o marcador da Sefaz

A Sefaz numera sequencialmente tudo o que disponibiliza para o seu CNPJ. Esse
número é o **NSU**, e é assim que o GaxWeb sabe de onde continuar.

| Coluna | O que significa |
|---|---|
| **NSU atual** | Até onde o GaxWeb já leu. |
| **Último NSU** | O último que a Sefaz tem disponível. |

> 📊 **NSU atual muito abaixo do Último NSU** significa que a busca está **em
> curso, porém atrasada** — não é erro. Costuma se resolver sozinha, já que a
> Sefaz aceita uma consulta por hora. Se a diferença não diminui ao longo do dia,
> aí vale investigar.

## A tela Tentativas

É o diagnóstico fino, e só a NF-e tem. Cada linha é uma consulta à Sefaz:

| Coluna | O que mostra |
|---|---|
| **cStat** | 🔑 O **código de retorno da Sefaz** naquela consulta. |
| **NSU** / **Ult. NSU** / **Max NSU** | Onde a consulta começou, terminou e o teto disponível. |
| **Qtd** | Quantos documentos vieram. |
| **Informações** | A mensagem daquela tentativa. |

> 🎯 **Quando o cliente diz "não chega nota e ninguém sabe por quê", esta tela
> responde.** O erro repetido no `cStat` e na coluna *Informações* aponta a causa
> real — e é o que o suporte precisa para agir.

## A tela Ciência

Mostra as notas em que a **ciência da operação** foi registrada automaticamente.
A ciência é ligada empresa a empresa, em *Administração › Empresas → aba Monitor*,
no campo **NF-e ciência** (Ativo/Inativo).

> ⚖️ **Ciência é declaração enviada à Sefaz**, com efeito fiscal — não é um
> marcador interno. O acesso a ela é controlado em *Segurança › Grupos de
> Permissões*.

## Roteiro: "esta empresa parou de receber"

1. **A empresa aparece em Empresas?** Se não, o monitor não está **Ativo**.
2. **Tem certificado, válido e vinculado?**
3. **A Última consulta é recente?** A coluna **Informações** diz o motivo.
4. **NSU atual muito atrás do Último NSU?** Atrasado, mas rodando.
5. **Em Tentativas**, qual o `cStat` que se repete?
6. Parou do nada, sem erro? A Fazenda **desativa a distribuição após 60 dias sem
   monitorar**.