Fiscal — solução de problemas#
NFC-e rejeitada ou travada, nota em revisão, contingência bloqueada, certificado A1 vencido ou inválido, rejeição da SEFAZ e prazo de envio. Para quem opera o fiscal da loja — gerente, responsável fiscal e contador.
Antes de começar — duas coisas que valem para toda esta página:
- Corrigir cadastro é diferente de reprocessar documento. Você corrige o cadastro do produto, do cliente ou da loja. Reprocessar o documento fiscal é ato de quem responde pelo fiscal.
- O sistema não decide por você o que é obrigação legal. Onde esta página fala de prazo, ela diz se é configuração do sistema ou norma externa — e para a norma externa, quem decide é o seu contador.
Passo a passo#
- Abra Fiscal > Monitor NFC-e.
- Filtre pelos chips: Rejeitadas, Em revisão, Contingência ou Pendentes.
- Localize a nota e leia a mensagem dela, com a causa apontada.
- Encontre o seu sintoma na tabela abaixo e execute a ação segura.
- Se a ação exige um direito ou um acesso que você não tem, a linha diz quem faz.
Como ler o monitor#
O Monitor NFC-e é a fila do que não autorizou. Ele não mostra as notas autorizadas no fluxo normal: ele mostra o que precisa de decisão.
| Chip | O que traz |
|---|---|
| Todas | a fila operacional completa |
| Rejeitadas | notas que a SEFAZ recusou, com o motivo |
| Em revisão | notas que precisam de revisão de dados fiscais antes de seguir |
| Contingência | notas emitidas offline, aguardando transmissão |
| Pendentes | notas na fila, ainda não enviadas |
| Cancelar autorizada | notas autorizadas que podem receber evento de cancelamento |
| Inutilizar numeração | faixas de numeração a inutilizar |
| Andamento dos eventos | o acompanhamento dos eventos enviados |
As ações disponíveis por nota são: regenerar XML (após correção do cadastro), preparar assinatura, agendar envio e processar envio. Nas notas autorizadas, a ação de evento é o cancelamento.
Sintomas e ações#
A NFC-e foi rejeitada#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| A nota aparece em Rejeitadas com o motivo da SEFAZ | a SEFAZ registrou uma rejeição; o motivo identifica o fato a conferir | Consulte as evidências e encaminhe para conciliação. O Monitor bloqueia regeneração e envio enquanto a nota permanecer rejeitada. Preserve o XML e o estado fiscal. |
| A nota é rejeitada por numeração duplicada | Dois caixas na mesma série de NFC-e | A série da NFC-e pertence ao caixa, não à loja. Verifique o cadastro de cada terminal em Checkout — caixas. Corrigir série é ato de quem administra os terminais. |
A nota diz bloqueada_validacao_homologacao | Validação no ambiente de homologação | Trate como "Em revisão": corrija o cadastro indicado, regenere o XML e execute o ensaio. |
A nota diz bloqueada_consumo_indevido | A SEFAZ pediu intervalo entre consultas | "Aguarde a janela minima de 1 hora antes de nova tentativa SEFAZ." A nota fica segura na fila. Não fique tentando: cada tentativa reinicia a janela. |
A nota diz assinatura_pendente | O XML foi preparado, mas não assinado | Use preparar assinatura antes de agendar o envio. |
A nota diz envio_pendente | Está na fila de transmissão | Use processar envio, ou aguarde o envio automático. |
A nota diz pendente | XML ainda não validado | Corrija o cadastro, valide o XML e prepare a assinatura. |
A nota aparece como denegada | A SEFAZ negou o documento | Consulte o seu contador. Documento denegado não é rejeição simples: tem tratamento próprio. |
| A nota está cancelada | Já houve evento de cancelamento | Não imprima o DANFE fiscal e não retransmita. Encerre o monitoramento dessa nota. |
A nota está em revisão fiscal#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| A nota está em Em revisão | o desfecho fiscal é inconclusivo ou há evidências divergentes | Confira a consulta pela chave e encaminhe para conciliação. Preserve XML e estado; não regenere nem retransmita enquanto houver bloqueio. |
| O problema é o produto | Produto sem perfil fiscal, ou com regra fiscal sensível | Resolva pela tela de resolução por NCM, no Cockpit do Contador, ou pela ficha do produto. |
| O problema é uma decisão fiscal que ninguém tomou | Existe uma proposta de regra fiscal aguardando decisão | Abra Contador > Trabalho fiscal > Sugestões da IA e trate a proposta. A revisão assistida abre de dentro da proposta. |
| A decisão é de adoção de regra para a empresa | A regra precisa ser adotada ou homologada | Contador > Governança fiscal. Quem decide é quem tem o direito de adotar ou homologar regra fiscal. |
| Não sei quem resolve | A dúvida é tributária, não operacional | Encaminhe ao contador. O sistema escreve o que foi decidido; ele não decide o tributo. |
A contingência está bloqueada ou indisponível#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "certificado A1/CSC ainda nao configurado" ao tentar emitir contingência | O pacote fiscal do caixa está incompleto | "Configure certificado A1 e CSC na retaguarda, depois toque em atualizar pacote fiscal no PDV antes de emitir contingencia offline." |
| A loja não permite contingência | O parâmetro Permite contingência offline está desligado naquela loja | Quem administra a loja decide. Não ligue por conta própria: é decisão operacional e fiscal. |
O XML de contingência é recusado por falta de tpEmis=9 | O XML foi gerado sem a marcação de emissão offline | "Reemita a NFC-e em contingencia offline pelo PDV para gerar XML com tpEmis=9 antes de enviar a fila fiscal." |
| O XML é recusado por falta de QR Code | Pacote fiscal do PDV desatualizado | "Atualize o pacote fiscal do PDV e gere novamente a NFC-e de contingencia com QR Code e URL de consulta." |
| O XML é recusado por falta de URL de consulta | Pacote fiscal sem a URL exigida | "Atualize o pacote fiscal do PDV para incluir a URL de consulta exigida no XML de contingencia." |
| O XML é recusado por falta de assinatura local | Certificado local do caixa não está pronto | "Atualize o pacote fiscal e confirme se o certificado local do PDV esta pronto para assinar a NFC-e offline." |
| O cliente pede o cupom e o caixa não imprime o DANFE | Nota em contingência ainda não autorizada | "DANFE fiscal bloqueado ate a NFC-e em contingencia ser autorizada pela SEFAZ." A venda está registrada e a nota será transmitida. |
O certificado A1 está vencido ou inválido#
O sistema avisa antes de vencer, e recusa depois.
| Situação | Mensagem | O que fazer |
|---|---|---|
| Faltam 30 dias ou menos | "Atenção: o certificado vence em N dia(s), em DD/MM/AAAA. Programe a renovação." | Programe a renovação com quem cuida do certificado da loja. |
| Faltam 7 dias ou menos | "Urgente: o certificado vence em N dia(s), em DD/MM/AAAA. Providencie a renovação agora." | Renove agora. É o aviso mais grave antes do bloqueio. |
| Já venceu | "Certificado vencido em DD/MM/AAAA. Envie um novo A1 antes de operar documentos fiscais." | Envie um novo A1 na aba Certificado da loja. |
| Ainda não vale | "O certificado ainda não está válido. Início da validade: DD/MM/AAAA." | Confira se o arquivo enviado é o certificado correto e se a data do sistema está certa. |
| CNPJ diferente do da loja | "O certificado pertence ao CNPJ … , mas a loja está cadastrada com o CNPJ …. Selecione o A1 correto ou corrija o cadastro da loja." | Selecione o A1 correto. Corrigir CNPJ de loja é ato de quem responde pelo cadastro fiscal. |
| Arquivo não é de pessoa jurídica | "O certificado A1 não informa um CNPJ ICP-Brasil válido. Confirme se o arquivo pertence a uma pessoa jurídica." | Use o certificado PJ da loja. |
| Erro ao ler o certificado ou senha recusada | Senha incorreta, arquivo corrompido ou exportação incompleta | Reexporte o A1 e envie de novo. Se persistir, é com quem emitiu o certificado. |
| A Distribuição DF-e recusa | "O certificado A1 ainda nao e valido ou esta vencido. Atualize a aba Certificado da loja." | Atualize o certificado na loja. |
Onde enviar: Administração > Lojas, abra a loja e vá para a aba Certificado. O certificado e a senha ficam armazenados criptografados, e a senha nunca é exibida — ela só é aberta em memória durante uma operação fiscal. O mesmo A1 atende NF-e, NFC-e e Distribuição DF-e.
Prazo de envio vencido#
Aqui é onde a distinção entre configuração e lei mais importa.
| O que existe no sistema | O que isso significa |
|---|---|
| Prazo contingência (h) | uma janela configurada por loja, com padrão de fábrica de 24 horas. É o prazo que a loja se dá para regularizar a fila de transmissão |
| A fila de transmissão | notas de contingência ficam em fila e são transmitidas quando a comunicação volta |
O que a documentação não afirma: que 24 horas é o prazo legal. Não é. O prazo legal de transmissão em contingência é norma da sua UF e do seu regime, e quem decide sobre ele é o seu contador.
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Notas de contingência acumuladas além do prazo configurado | A comunicação não voltou, ou a fila não foi processada | Restabeleça a comunicação e processe a fila pelo Monitor NFC-e. Se o volume for grande, escale: reprocessar em lote é ato de quem responde pelo fiscal. |
| Preciso saber se ainda estou dentro do prazo legal | Dúvida tributária | Pergunte ao contador. O sistema mostra a fila; ele não calcula prazo legal. |
| Uma nota ficou fora do ar por dias | Risco fiscal | Registre o período e o volume e leve ao contador antes de simplesmente transmitir. |
A SEFAZ rejeitou e não sei o que significa#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Mensagem com código e motivo da SEFAZ | Rejeição é resposta da SEFAZ, com o motivo no próprio retorno | O monitor mostra o motivo (xMotivo/cStat). Corrija o que ele aponta. Se o motivo não for claro para você, encaminhe ao contador com o código. |
| Rejeição por esquema/validação do XML | Dado fiscal incompleto ou incompatível | Corrija o cadastro apontado e regenere o XML. |
| Rejeição por credenciamento | A loja não está habilitada para emitir naquele ambiente/UF | Não é ajuste de tela. Escale: envolve credenciamento junto à SEFAZ. |
| Rejeição que se repete mesmo após corrigir | A causa não é a que você corrigiu | Não fique reenviando. Leve o código, o motivo e o horário ao contador. Cada reenvio desnecessário pode gerar bloqueio por consumo indevido. |
| Erro de transmissão, TLS ou indisponibilidade | Problema de comunicação com a SEFAZ | Trate como "reenviar quando disponível": a nota fica segura na fila e sobe quando a comunicação volta. |
Campos e o que significam#
| Campo | O que é | Observação |
|---|---|---|
| Status da NFC-e | o estado operacional da nota na fila fiscal | Os estados incluem pendente, em revisão, rejeitada, bloqueada por validação de homologação, bloqueada por consumo indevido, assinatura pendente, envio pendente, contingência offline, autorizada, cancelada, denegada e inutilizada. |
| Chave de acesso | o identificador da nota | É o que você informa ao escalar um problema fiscal. Nunca é um dado sensível. |
| cStat / xMotivo | o código e o motivo devolvidos pela SEFAZ | É a fonte da verdade da rejeição. |
| Protocolo de autorização | o número que a SEFAZ devolveu ao autorizar | Sem ele, o DANFE fiscal não é liberado. |
| Ambiente | Homologação (teste) ou Produção (valendo) | Confirmar antes de qualquer operação real é obrigatório. |
| Permite contingência offline | se a loja pode emitir sem comunicação | Decisão da loja, configurada na aba NFE/NFCe. |
| Prazo contingência (h) | a janela configurada para regularizar a fila | Padrão 24. Não é o prazo legal. |
| Série NF-e (modelo 55) | a série da NF-e da loja | A série da NFC-e é de cada caixa. |
| ID token CSC / CSC | credenciais da NFC-e no portal da SEFAZ | Segredos. Nunca aparecem em print, chamado ou log. |
Resultado esperado#
- A nota sai de Rejeitadas ou Em revisão e aparece como autorizada, com protocolo de autorização.
- O DANFE fiscal fica liberado para impressão — o que exige nota autorizada e protocolo.
- A fila de contingência esvazia depois da transmissão, e as notas passam a autorizadas.
- O aviso do certificado volta para a classe ok: "Certificado válido até DD/MM/AAAA."
Se algo der errado#
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Corrigi o cadastro e a nota continua rejeitada | A nota mantém o estado Rejeitada, que bloqueia regeneração e transmissão no Monitor | Consulte a situação pela chave e encaminhe as evidências para conciliação fiscal antes de qualquer novo envio. Corrigir o cadastro não libera essas ações. |
| "acao fiscal invalida" | A ação não se aplica ao estado atual da nota | Atualize a tela: o estado mudou. Use a ação coerente com o estado que aparece agora. |
| Não consigo cancelar a nota | A nota não está autorizada, ou você não tem o direito de evento | O cancelamento só existe para nota autorizada. Verifique o direito fiscal.nfce_eventos com quem administra perfis. |
| A nota certa não aparece na lista de canceláveis | Ela saiu da janela de cancelamento, ou não está autorizada | Confirme com o contador o que fazer. Não tente contornar. |
| O DANFE não imprime mesmo com a nota autorizada | Documento autorizado incompleto, ou protocolo ausente | Confirme o protocolo de autorização. Se a nota está autorizada sem protocolo, escale. |
| O contador pede os XMLs e alguns estão em revisão | Nota em revisão não entra no SPED | Resolva as notas em revisão antes do fechamento. Ver Fechamento do mês. |
| O SPED é rejeitado por versão de leiaute | Versão do leiaute desatualizada | Confirme com o contador a versão vigente. Ver Fechamento do mês. |
| Preciso conferir a prontidão do ambiente fiscal | Verificação técnica | Existe uma rota de status de prontidão do runtime fiscal que devolve apenas indicadores e avisos, nunca senha, CSC ou conteúdo do certificado. Peça a quem opera a instalação. |
Como funciona por dentro#
- O DANFE fiscal não é liberado por "ter vendido". Ele exige nota autorizada com protocolo; em contingência, exige a autorização depois da transmissão. É por isso que o cupom sai mas o DANFE fiscal não.
- O SPED escritura o autorizado. Nota rejeitada ou em revisão não entra no SPED Fiscal — daí a insistência em limpar a fila fiscal antes de fechar o mês.
- Os estados são finais ou não. Autorizada, rejeitada, cancelada, denegada e inutilizada são estados finais. Os demais são estados de fila, e cada um tem uma próxima ação definida.
- O sistema guarda a cadeia e os eventos. Cada tentativa de envio e cada evento ficam registrados, com a ação recomendada para cada estado. Isso é o que permite auditar depois.
- O certificado é validado contra o CNPJ da loja. O sistema não aceita um A1 de outro CNPJ no cadastro daquela loja: certificado errado é pior que certificado ausente, porque emite em nome de outra pessoa.
Limites declarados desta página#
Dois pontos não são lacuna de documentação — são limites do produto ou da norma. Estão aqui para você não procurar resposta onde não existe:
- Prazo legal de transmissão em contingência. O sistema tem uma janela configurável, não um prazo legal. Quem define o prazo é a norma da sua UF, e quem decide é o contador. O ERPia não valida esse prazo: ele apenas conta as horas desde a emissão em contingência.
- Códigos de rejeição da SEFAZ. Esta página trata os que foram conferidos no código. A SEFAZ tem muito mais códigos do que os documentados — rejeição fora da lista vai para a fila do Monitor NFC-e com a mensagem crua do autorizador.
Os demais pontos desta seção são valores da sua instalação, e não dúvida: o estado de Permite contingência offline e do Prazo contingência (h), o cofre de segredos (que muda onde o certificado vive, não o que você faz na tela) e o aviso de validade do certificado aparecem no cadastro fiscal da loja e em Administração › Parâmetros.
Divergência conhecida#
A origem descreve, em documento de segurança, que o pacote fiscal do PDV precisa migrar para armazenamento cifrado com chave por instalação antes de produção. O pacote já é gerado com SQLCipher habilitado no build Windows, e existe um script de validação específico para o Android. O estado da sua instalação (se o pacote fiscal já está no armazenamento cifrado) não se lê pelo manual: é verificação de quem opera a instalação. O que você faz na tela não muda por causa disso — muda apenas onde o certificado e o CSC vivem no disco do caixa. Em caso de dúvida sobre segurança do pacote, escale para quem opera; não tente migrar armazenamento por conta própria.
Onde aprofundar#
- A tela do monitor, chip a chip: Monitor NFC-e.
- Emitir NF-e (modelo 55): Emissão de NF-e.
- Regra tributária por produto: Perfis fiscais.
- Gerar e validar os arquivos do período: SPED, SINTEGRA e XML.
- A nota no caixa e a contingência pelo lado do PDV: Fiscal no caixa.