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

# Os monitores de CT-e, NFS-e e NFC-e/SP

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

Além da NF-e, o GaxWeb monitora **CT-e**, **NFS-e** e **NFC-e de São Paulo**. Cada
um tem seu próprio par de telas em **Monitores**, e cada um se liga separadamente.

> ⚠️ **Ligar o monitor de NF-e não liga os outros.** São independentes — é comum a
> empresa receber notas normalmente e estranhar que os fretes ou as notas de
> serviço não aparecem. Cada tipo tem seu par **Ativo/Inativo + Ciclo** em
> *Administração › Empresas → aba Monitor*.

## O que cada um tem

| Monitor | Telas | Usa NSU? |
|---|---|---|
| **CTe/AN** | Empresas · DFe | Sim |
| **NFSe/AN** | Empresas · DFe | Sim |
| **NFCe/SP** | Empresas · DFe | ❌ **Nã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.

## Por que a NFC-e/SP é diferente

Repare que a tela de Empresas do **NFC-e/SP não tem as colunas NSU atual e Último
NSU**. Não é falta: o NSU é o marcador do **Ambiente Nacional**, e a NFC-e de São
Paulo vem do **ambiente estadual paulista**, que funciona de outro jeito.

Por isso o NFC-e/SP tem duas regras próprias:

- **Certificado do próprio CNPJ.** Matriz não consulta filial e filial não
  consulta matriz — cada uma precisa do seu.
- Além do **Ciclo**, o cadastro tem um campo **Período** só para este monitor.

> 🏪 Se você tem PDV em São Paulo e as vendas não estão aparecendo, comece
> conferindo **de quem é o certificado** vinculado àquela empresa.

## O monitor de NFS-e e a questão do município

A NFS-e é a captura mais irregular, e a razão está fora do GaxWeb: cada prefeitura
decide como disponibiliza. Municípios no padrão nacional sincronizam no
repositório (ADN) e são capturados normalmente; os que operam só com emissor
próprio dependem do que a prefeitura libera.

> ❓ Antes de concluir que "o GaxWeb não pega a minha NFS-e", confirme com o
> suporte se o seu município está homologado. Não dá para deduzir isso da tela.

## Roteiro quando um tipo não chega

1. O monitor **daquele tipo** está **Ativo** no cadastro da empresa? (Não basta o
   de NF-e.)
2. A empresa aparece na tela **Empresas** daquele monitor?
3. O que diz a coluna **Informações**?
4. É NFC-e/SP? Confira se o certificado é do **próprio CNPJ**.
5. É NFS-e? Confirme a cobertura do município.