NF-e e NFC-e
Como identificar o código e a mensagem de um erro de NF-e ou NFC-e
Antes de alterar a nota, localize a resposta completa da operação que falhou. Você precisa saber o código, a mensagem e se o problema aconteceu ao emitir, consultar, cancelar ou realizar outro serviço. Um aviso curto como “erro na SEFAZ” não permite escolher uma correção segura.
Antes de alterar a nota, localize a resposta completa da operação que falhou. Você precisa saber o código, a mensagem e se o problema aconteceu ao emitir, consultar, cancelar ou realizar outro serviço. Um aviso curto como “erro na SEFAZ” não permite escolher uma correção segura.
Este guia ajuda a reunir essas informações em qualquer emissor de NF-e, modelo 55, ou NFC-e, modelo 65. Os nomes das telas variam entre os programas. Se os detalhes não estiverem visíveis, peça ao suporte o retorno registrado para aquela tentativa.
Onde procurar primeiro
Abra o histórico de transmissão, o detalhe do documento ou o registro da comunicação da operação. Procure a tentativa correspondente ao horário do problema, e não apenas o último aviso que aparece na lista de notas. Alguns emissores também apresentam detalhes no pedido de venda ou no painel fiscal; a documentação da Omie exemplifica esses diferentes pontos de consulta.
Anote a mensagem por inteiro. Um complemento como o número do item pode indicar qual produto precisa ser conferido. Preserve também palavras que identificam o serviço, por exemplo “evento”, “lote” ou “inutilização”. Elas mudam o caminho do diagnóstico.
Se o sistema só exibir uma mensagem genérica, não escolha um código parecido por conta própria. Solicite o detalhe técnico antes de aplicar a solução de outra rejeição.
O que significam cStat e xMotivo
Na resposta XML da SEFAZ, cStat identifica o status, enquanto xMotivo traz sua descrição. Confira também a identificação do ambiente, tpAmb: 1 corresponde a produção e 2 a homologação. Esses campos estão previstos no MOC 7.0, Visão Geral, leiautes de retorno.
O lugar onde o status aparece importa. Um lote pode ter cStat 104, indicando que foi processado, e conter o resultado individual da nota em protNFe/infProt. É esse resultado que deve ser examinado para saber o que aconteceu com o documento. Não trate a mensagem externa do lote como confirmação de autorização.
O mesmo cuidado vale para eventos: identifique a resposta do evento correspondente à chave, ao tipo e à sequência enviados. Uma rejeição de cancelamento não informa, por si só, que a emissão original foi rejeitada.
Alguns retornos também trazem cMsg e xMsg, campos de mensagens adicionais. Eles não substituem cStat e xMotivo. A NT 2026.002 v1.11 prevê autorização com alerta, código 120, inicialmente para NFC-e. Nessa situação, o documento foi autorizado, mas o alerta deve ser analisado. Alertas também podem acompanhar uma rejeição; leia o status principal antes de decidir o próximo passo. NT 2026.002, seção 2.
Os nomes técnicos ajudam o suporte a localizar os dados, mas você não precisa editar o XML para fazer essa conferência. Quando o programa traduz a resposta para campos de tela, peça que ele mostre o código e a descrição sem eliminar os detalhes.
Quando o número veio da consulta do QR Code
A consulta pública da NFC-e tem uma tabela própria. Nela, 100 indica hash inválido, enquanto cStat 100 no protocolo informa autorização de uso. Registre portal, mensagem completa, modelo, ambiente e versão do QR antes de pesquisar a solução. Não transforme uma falha de consulta em rejeição de emissão. Manual DANFE NFC-e v6.0, páginas 38–39.
A mensagem veio da SEFAZ ou do próprio sistema?
Uma falha pode ocorrer antes de existir resposta fiscal. A documentação de integração da TecnoSpeed, por exemplo, distingue o retorno com cStat de uma exceção do aplicativo durante a assinatura ou a validação do arquivo. Essa diferença é útil mesmo quando você usa outro emissor.
Há cStat e mensagem fiscal identificados: descubra primeiro se o retorno informa recebimento, processamento, autorização ou rejeição. Quando for rejeição, siga o artigo daquele código, no serviço e no modelo correspondentes. Se a mensagem citar um item, comece por ele.
Há erro de assinatura, conexão, timeout ou uma exceção, sem resposta fiscal confirmada: peça ao suporte que identifique em qual etapa o processo parou. Uma tela sem retorno não prova que a SEFAZ recusou ou deixou de receber o documento.
A tela e a consulta apresentam situações diferentes: registre as duas evidências e solicite a conciliação. Não gere uma nova nota apenas para fazer a tela mudar de estado.
O erro surgiu depois de uma autorização: identifique a operação posterior que falhou. Pode ser um evento, uma impressão ou a entrega do arquivo, situações que precisam ser investigadas separadamente.
Informações que ajudam a resolver sem adivinhação
Reúna, em um atendimento privado e autorizado:
Código e mensagem completos, com o número do item quando existir
Operação realizada e modelo do documento
Ambiente, UF e data e hora da tentativa
Número e série da nota, chave quando disponível e referência do pedido no seu sistema
Recibo, protocolo ou identificador do evento, se houver
Versão do emissor e indicação de atualização recente
O que já foi consultado ou alterado depois do erro
Não envie senha, certificado com chave privada, PIN ou token de acesso. Um XML pode conter dados pessoais e comerciais; compartilhe-o somente pelo canal autorizado para o atendimento. Em fóruns públicos, prefira uma descrição do problema e trechos devidamente anonimizados.
Exemplo hipotético
Uma loja vê “lote processado” ao transmitir uma NF-e, mas o documento continua pendente no emissor. No retorno detalhado, o lote tem código 104 e a nota traz a rejeição 778, com indicação do item 3.
O próximo passo é conferir o NCM daquele item conforme a regra aplicável, seguindo o artigo da 778. Não há motivo para tratar o caso como indisponibilidade da SEFAZ ou tentar mudar a numeração. O exemplo pressupõe um retorno 778 efetivamente recebido; a aplicação da regra deve ser conferida no autorizador utilizado. Depois de corrigir a causa na origem, será necessário obter e conferir o novo resultado individual da nota.
Como confirmar que você encontrou o problema certo
O diagnóstico deve permitir responder: qual operação falhou, qual documento ou item ela envolvia, qual foi a resposta e em qual ambiente isso aconteceu. Se alguma dessas informações ainda estiver ausente, deixe a dúvida registrada em vez de presumir uma causa.
Quando o retorno de uma transmissão for inconclusivo, consulte a situação antes de repetir o envio ou criar outro documento. Depois da correção, confira o resultado definitivo da operação. Uma mensagem removida da tela, um arquivo impresso ou uma tentativa concluída no programa não substituem essa verificação.
O suporte deve cuidar da identificação do retorno e da comunicação. O contador deve participar quando a solução exigir definir classificação fiscal, impostos, documento adequado ou tratamento de uma operação já registrada.
Revisão documental: 09/10/2026. Versão 3, após revisão técnica e editorial independente. Este guia ensina a identificar o retorno; as condições e exceções de cada rejeição devem ser conferidas no artigo específico.
Referências consultadas
MOC 7.0, Visão Geral, seções 5.1, 5.2 e 5.8: mensagens de autorização e eventos
TecnoSpeed: diferenças entre retorno fiscal e exceção na integração