Como ler a fila da NFC-e e resolver a nota travada#

Filtros (chips) e o que cada um mostra#

O campo de filtro livre aceita trechos de situação, motivo da SEFAZ (xMotivo), mensagem de validação, chave de acesso e cStat.

Situações possíveis e a ação de cada uma#

As ações dependem do estado e das evidências. Regenerar XML só aparece em bloqueada_validacao_homologacao; Preparar assinatura em pendente; Colocar na fila em assinatura_pendente; Transmitir agora em envio_pendente. O bloqueio por evidências remove essas ações. Uma nota rejeitada permanece bloqueada, mesmo após corrigir o cadastro. Fontes: nfceAcoesPermitidas, em , e nfceBloqueadaPorEvidenciaMonitor, em .

O texto de "Próxima ação" que a tela escreve#

Confirmações que a tela pede antes de agir#

O que cada ação grava fica registrado no histórico da nota, com o texto: "XML regenerado pelo Monitor NFC-e após correção do cadastro.", "NFC-e validada e encaminhada para assinatura digital.", "NFC-e colocada na fila segura de transmissão para a SEFAZ.".

Como cancelar uma NFC-e autorizada#

Antes de começar — permissão fiscal.nfce_eventos.

1. Abra Fiscal > Monitor NFC-e.
2. Clique no chip Cancelar autorizada.
3. Encontre a nota (o filtro livre busca por venda, chave ou protocolo) e clique em Solicitar cancelamento.
4. Leia o aviso do modal: "A nota só será marcada como cancelada depois que a SEFAZ registrar o evento. Se houver rejeição, a nota continuará autorizada."
5. Confira o bloco Documento conferido — venda, final da chave e protocolo.
6. Preencha Justificativa fiscal com 15 a 255 caracteres.
7. Clique em Enviar para cancelamento.
8. Volte ao chip Andamento dos eventos e acompanhe até o evento ficar Registrado na SEFAZ.

Se o seu perfil puder acompanhar mas não cancelar, o resumo da tela diz: "Seu perfil pode acompanhar as notas, mas não pode solicitar cancelamento. Peça a permissão fiscal.nfce_eventos ao administrador.".

Como inutilizar uma faixa de numeração#

Antes de começar — permissão fiscal.nfce_eventos. Use somente para uma faixa que não virou NFC-e.

1. Abra Fiscal > Monitor NFC-e e clique no chip Inutilizar numeração.
2. Clique em Inutilizar faixa.
3. Leia o aviso: "Use somente para números que não foram utilizados em nenhuma NFC-e. A faixa e o ambiente serão enviados para registro na SEFAZ."
4. Preencha ambiente, ano, série, número inicial, número final e a justificativa.
5. Clique em Enviar para inutilização.
6. Acompanhe em Andamento dos eventos.

Acompanhar os eventos#

O chip Andamento dos eventos lista cancelamentos e inutilizações com o resultado da SEFAZ. Quando há evento em processamento, a lista atualiza sozinha a cada 3 segundos e você pode sair e voltar sem perder o andamento.

Cada linha mostra ainda Tentativa N de 8, o cStat e o protocolo do evento quando existir.

Como conferir que deu certo#

Como funciona por dentro#

O motivo da SEFAZ não escolhe o fluxo. O sistema classifica o cStat em uma decisão estruturada: 100 e 150 autorizam; 656 é consumo indevido; 103 a 109 significam "ainda não conclusivo" e mantêm a nota na fila; qualquer outro valor é rejeição. O texto do motivo explica o retorno, mas é o código que decide o caminho.

Falha fechada é deliberada. Quando a resposta da SEFAZ não permite provar o desfecho depois do envio, o sistema move a nota para Em revisão e a tira da fila automática — porque retransmitir pode duplicar um documento autorizado.

O QR Code é conferido por UF. O endereço de consulta do QR Code e o autorizador da NFC-e entram por UF, contra a fonte oficial; UF sem endereço conferido falha fechada na emissão. Emitir com o endereço de outra UF é rejeição garantida, e pior que não emitir, porque a venda já aconteceu.

Contingência offline. Quando o PDV identifica queda de conexão, a venda continua localmente e o evento fiscal passa a carregar tipo_emissao_nfce = contingencia_offline. Para emitir de verdade offline, o caixa precisa do pacote fiscal local (certificado A1, senha, CSC, série e configuração fiscal da loja), e a contingência fica bloqueada se faltar qualquer um destes itens: permissão de contingência offline, certificado A1, senha, CSC ID, CSC token, CNPJ, inscrição estadual, código do município, UF, série NFC-e ou prazo de envio válido (mesmo documento, seção "Contingencia offline no MVP").

Quando o pacote não está pronto, o caixa não para. A venda é concluída e o evento sobe para a retaguarda com status_nfce = em_revisao, mensagem fiscal e lista de bloqueios — é exatamente esse caso que aparece aqui como Em revisão.

A série da NFC-e é de cada caixa. Dois caixas na mesma série produzem duplicidade de numeração. A série da NFC-e se define no cadastro do PDV, não na loja.

Limitação declarada: UF atendida#

As tabelas de autorizador e de endereço de QR Code da NFC-e contêm somente UF conferida contra a fonte oficial — hoje CE e RN. Para outra UF, a emissão falha fechada com erro explicando que a UF não está mapeada, e o override do cofre (webservice_autorizacao) é o que pode suprir o autorizador. Incluir uma UF é alteração de código. O override cadastrado na loja sempre vence a tabela, que é só o padrão.

O que conferir na sua loja: qual endereço de autorizador está cadastrado no cadastro fiscal da loja. O produto conhece o padrão da tabela, mas o endereço efetivo é o do cadastro — e é ele que manda. Endereço errado ou ausente para a sua UF é causa de rejeição, não de fila: o Monitor mostra a mensagem crua do autorizador.