> **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

1. **Leia o tipo antes do texto.** *Situação* e *Informação* não pedem ação.
2. **Na Exportação, a coluna Info explica o pedido.** É onde está o motivo real de
   um resultado vazio.
3. **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".
4. **Ao abrir chamado**, informe o **status exato**, a **empresa** e o **horário**.
   Com isso o suporte começa do meio do caminho.