Como configurar seu primeiro monitor de notas

Tiago Camara

Tiago Camara

Última atualização em Aug 27, 2026

Aplica-se a: GaxWeb 5.0

Os monitores são o coração do GaxWeb: eles consultam a SEFAZ de tempos em tempos e baixam suas notas automaticamente.

Onde se ativa

O monitor não se liga pela tela de Monitores — ele se liga no cadastro da empresa:

  1. Vá em Administração › Empresas.
  2. Abra a empresa (botão direito → Editar).
  3. Vá à aba Monitor.
  4. Ponha em Ativo o monitor de cada tipo de documento que a empresa recebe — NF-e/AN, CT-e/AN, NFS-e Nacional, NFC-e SP.
  5. Escolha o Ciclo de cada um.

⚠️ São dois campos por tipo de documento, e a diferença importa:

Campo O que faz
Ativo / Inativo É o que liga o monitor. Sem isto, não há consulta.
Ciclo Apenas a janela de horário em que a consulta acontece.

Definir só o Ciclo não liga o monitor — a empresa continua sem ser monitorada, e nenhuma mensagem avisa. Se as notas não estão chegando, este é o primeiro campo a conferir.

O Ciclo é a janela de horário da consulta: Integral (24 horas), Diurno (6h às 18h), Noturno (18h às 6h) ou faixas de seis horas. Se a empresa já usa outro sistema consultando a SEFAZ com o mesmo certificado, um ciclo restrito evita o conflito que gera a mensagem 656 (consumo indevido).

Na aba eCAC, do mesmo cadastro, liga-se a busca das mensagens da Receita.

Cadastrar a empresa não liga monitor nenhum. É o passo que mais falta quando alguém diz "cadastrei e não chegou nota".

O que acontece depois de ativar

  • A empresa entra numa fila: da ativação até a primeira nota podem passar de 5 a 60 minutos.
  • O GaxWeb busca retroativo, a partir de cerca de 179 dias antes da data de cadastro da empresa.
  • A SEFAZ aceita uma consulta por hora. Consultar além disso pode causar bloqueio das portas de consulta — por isso não existe "buscar agora" à vontade.

Duas regras que evitam dor de cabeça

  • Certificado do próprio CNPJ para NFC-e SP e NFS-e: matriz não consulta filial e filial não consulta matriz.
  • Não deixe o monitor parado: a Fazenda desativa a distribuição para quem fica 60 dias sem monitorar. O monitoramento contínuo é o que evita perder notas.

Como acompanhar

Em Monitores › (tipo) › Empresas você vê, para cada empresa:

  • qual certificado está sendo usado;
  • a última consulta;
  • o NSU atual e o último NSU — se o primeiro está bem abaixo do segundo, ainda há notas a baixar;
  • a coluna Info, com o motivo de eventuais falhas.

O NFC-e SP não usa NSU. Para ele, acompanhe pela última consulta e, na tela de DFe, pelas colunas Baixado e Integrado.

No monitor de NF-e existe ainda a tela Tentativas, que mostra o código de retorno da SEFAZ em cada consulta — é onde aparece a causa real de um monitor parado.


Ficou com dúvida? Fale com a gente no WhatsApp