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"

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