Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026
O GaxWeb usa um código de status para dizer o que aconteceu com uma empresa, um certificado, uma consulta à Sefaz ou um pedido de exportação. Ele aparece na coluna Status das listas e na coluna Info da tela de Exportação.
Esta página explica os que você vai encontrar no dia a dia, agrupados pelo que fazer — não pelo número.
Antes de tudo: os cinco tipos
Todo status tem um tipo, que já indica a gravidade:
| Tipo | O que significa |
|---|---|
| Situação | Estado normal do registro. Não é problema. |
| Informação | Aviso sem gravidade. |
| Alerta | ⚠️ Algo merece atenção, mas o processo seguiu. |
| Erro | ❌ O processo falhou. |
| Throwable | 🔥 Falha técnica inesperada. Abra chamado. |
Na tela de Exportação, o filtro Status usa exatamente esses cinco tipos. Filtrar por Alerta e Erro mostra só o que deu problema.
Certificado
| Status | O que aconteceu | O que fazer |
|---|---|---|
| Certificado a vencer | Está perto do vencimento. | Providencie a renovação antes que pare. Em Certificados, o filtro Status = Vencendo lista todos. |
| Certificado vencido | Passou da validade. | Nenhuma consulta funciona. Cadastre o novo e vincule às empresas. |
| Certificado revogado | Foi revogado pela autoridade certificadora. | Não há conserto: é preciso emitir outro. |
| Sem certificado digital | A empresa não tem certificado vinculado. | Vincule em Empresas → menu Empresa → Atualizar certificado. |
🔗 Cuidado com o mais silencioso: certificado cadastrado mas com Vínculos = 0 não dá erro — simplesmente nada acontece. Confira essa coluna em Administração › Certificados.
CNPJ e cadastro
| Status | O que aconteceu | O que fazer |
|---|---|---|
| CNPJ não confere | O CNPJ do certificado não é o da empresa. | Para NFC-e SP e NFS-e, cada CNPJ precisa do seu próprio certificado: matriz não consulta filial. |
| CPF não confere | Mesma coisa, para pessoa física. | Verifique o titular do certificado. |
| CNPJ inválido | O número não é válido. | Corrija o cadastro da empresa. |
| CNPJ não cadastrado | O documento não está na base consultada. | Confirme se a empresa existe e está ativa na Receita. |
| Não ativo na UF informada | A empresa não tem inscrição ativa naquele estado. | Confira a UF do cadastro. |
Consumo e plano
| Status | O que aconteceu | O que fazer |
|---|---|---|
| Pouco crédito | O plano está chegando ao limite. | Acompanhe o consumo; avalie subir de plano. |
| Sem créditos | O limite do plano acabou. | A captura para até a renovação do ciclo ou a troca de plano. |
| Créditos expirados | Os créditos venceram. | Fale com o comercial. |
| Consumo indevido | ⚠️ É a famosa mensagem 656. Mais de um sistema consultando a Sefaz com o mesmo certificado. | Não é preciso desligar o GaxWeb: ajuste o Ciclo para uma janela mais estreita e os dois convivem. |
🔁 Sobre a 656: a Sefaz aceita uma consulta por hora por certificado. Quando o GaxWeb e outro sistema consultam juntos, os dois se atropelam. O ciclo restrito resolve sem perder a captura.
A nota não veio, ou veio incompleta
| Status | O que aconteceu | O que fazer |
|---|---|---|
| Sem XML | Chegaram os dados da nota, mas não o arquivo. | Em NF-e, o filtro Situação → Sem XML lista todas. Veja Como recuperar notas antigas. |
| Sem protocolo | Falta o protocolo de autorização. | Costuma se resolver sozinho na próxima consulta. |
| Sem assinatura | Falta a assinatura digital válida. | Se persistir, abra chamado com a chave da nota. |
| Nenhum documento localizado | A consulta rodou e não achou nada. | Normal quando não houve emissão no período. |
| NSU solicitado muito antigo | O ponto de leitura pedido está fora da janela da Sefaz. | A Sefaz não devolve documentos muito antigos por esse caminho: use a recuperação por chave. |
| Sem atividade / 48h sem atividade | A empresa não teve movimento. | ⚠️ Atenção: a Fazenda desativa a distribuição após 60 dias sem monitorar. |
Situação do documento
Estes não são erro — descrevem o estado da nota:
| Status | Significa |
|---|---|
| Cancelado | A nota foi cancelada pelo emitente. |
| Contingência | Emitida em contingência (sistema da Sefaz fora do ar na emissão). |
| Denegado | A Sefaz negou a autorização. |
| Confirmado | Operação confirmada na manifestação. |
| Não realizado | Operação declarada como não realizada. |
| Duplicidade | O documento já existia na base. |
Exportação
| Status | O que aconteceu | O que fazer |
|---|---|---|
| Processando / Executando | O pedido está na fila ou rodando. | Aguarde. Ligue o Reload de 30s para acompanhar. |
| Finalizado | Terminou com sucesso. | Botão direito → Efetuar download. |
| Finalizado Alerta | ⚠️ Terminou, mas sem trazer nada. | Quase sempre é filtro: as opções de Situação vêm desmarcadas. Marque ao menos uma e refaça com Replicar exportação. |
| Finalizado Erro / Exception | Falhou. | Leia a coluna Info. Se não estiver claro, abra chamado citando o ID do pedido. |
| Timeout | Demorou além do limite. | Refaça com um período menor. |
| Aguardando / Ocioso | Na fila, sem processar ainda. | Aguarde. |
GaxUp e gaxweb-agent
| Status | O que aconteceu | O que fazer |
|---|---|---|
| Sem Diretório | A pasta configurada não existe no computador. | Confira o caminho na configuração do GaxUp. |
| Sem Comunicação | O terminal não está falando com o GaxWeb. | Veja se o computador está ligado, com internet, e o serviço rodando. |
| Sem Importação | Comunicou, mas não havia arquivo novo. | Normal se nada foi emitido. |
| Já processado | O arquivo já tinha sido enviado antes. | Não é erro — evita duplicidade. |
Específicos do SAT e da NFC-e
Quebra de sequência — há um vão na numeração dos documentos: entre o número inicial e o final da série, faltam documentos.
📊 Existe relatório pronto para isso. Em Aplicativos › Relatórios há "Quebra de Sequência - SAT" (lista as séries com quebra) e "Sequenciamento - SAT" (verifica a sequência no período, apontando as lacunas). Para NFC-e, os equivalentes são "Quebra NFCe" e "Sequência NFCe".
Vale rodar antes de fechar o mês: documento faltando na numeração é o que o fisco cobra.
Data maior que último cupom — a data consultada é posterior ao último cupom que o equipamento registrou. Se não for esperado, fale com o suporte informando a empresa e o período.
Falhas técnicas
Estes indicam problema do lado do serviço consultado, não do seu cadastro:
Indisponível · Não disponível · Nenhum serviço compatível · Bad Response · Server Error · Client Error · Falha no schema XML · Erro interno do servidor · Runtime error · Captcha inválido
Costumam ser passageiros e se resolvem na consulta seguinte. Se um deles se repetir por mais de um dia na mesma empresa, abra chamado informando a empresa, o tipo de documento e o horário.
Como usar isto no dia a dia
- Leia o tipo antes do texto. Situação e Informação não pedem ação.
- Na Exportação, a coluna Info explica o pedido. É onde está o motivo real de um resultado vazio.
- Na tela de Monitores, a coluna Informações traz o retorno da última consulta — é o diagnóstico mais direto de "não está chegando nota".
- Ao abrir chamado, informe o status exato, a empresa e o horário. Com isso o suporte começa do meio do caminho.