Monitores: por onde comecar (GaxWeb 5.0)

Tiago Camara

Tiago Camara

Última atualização em Aug 27, 2026

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

Os monitores são o coração do GaxWeb: eles consultam a Sefaz de tempos em tempos e trazem os documentos emitidos contra o seu CNPJ, sem você fazer nada.

O menu Monitores é onde se acompanha essa busca. Cada tipo de documento tem o seu, com telas próprias.

Monitor Manual completo
NFe/AN — o mais completo, com Tentativas e Ciência O monitor de NF-e
CTe/AN, NFSe/AN e NFCe/SP Os monitores de CT-e, NFS-e e NFC-e/SP

O monitor não se liga aqui

Esta é a confusão mais comum: o menu Monitores só mostra. Quem liga é o cadastro da empresa:

Administração › Empresas → botão direito na empresa → Editar → aba Monitor → ponha em Ativo o tipo de documento desejado, e escolha o Ciclo.

⚠️ São dois campos, e a diferença derruba muita gente: Ativo/Inativo é o que liga; o Ciclo é só a janela de horário. Definir apenas o Ciclo não liga nada, e nenhuma mensagem avisa.

🔀 Cada tipo é independente. Ligar o de NF-e não liga o de CT-e nem o de NFS-e.

Depois de ligar: o que esperar

  • A empresa entra numa fila: de 5 a 60 minutos até a primeira nota.
  • A busca é retroativa, a partir de cerca de 179 dias antes do cadastro.
  • A Sefaz aceita uma consulta por hora. Não existe "buscar agora".

🛑 Não deixe o monitor parado. A Fazenda desativa a distribuição para quem fica 60 dias sem monitorar — e é a causa mais comum de "parou de chegar nota do nada".

Diagnóstico rápido: "não está chegando nota"

Nesta ordem — quase sempre para nos dois primeiros:

  1. A empresa aparece na tela Empresas daquele monitor? Se não, ele não está Ativo.
  2. Tem certificado válido e vinculado? Confira a Validade e a coluna Vínculos em Administração › Certificados.
  3. A "Última consulta" é recente? A coluna Informações diz o motivo em texto — é o diagnóstico mais direto que existe.
  4. NSU atual muito atrás do Último NSU? Está atrasado, mas rodando.
  5. Na tela Tentativas (só NF-e), qual código de retorno se repete?

Para entender a mensagem que apareceu, veja O que significa cada status e mensagem do GaxWeb.

Para ir além

  • Ligar o monitor de uma empresaA tela de Empresas: cadastro, monitores e eCac
  • Certificado vencido ou sem vínculoA tela de Certificados
  • As notas capturadasDocumentos fiscais: por onde começar