Erros comuns da SEFAZ e como resolver

Quando você tenta emitir uma NF-e e a SEFAZ rejeita, aparece um código numérico junto da mensagem. Cada código tem uma causa específica. Esse tutorial é o catálogo dos 10 erros mais comuns que MEI/pequeno comerciante encontra — com a causa real, como resolver passo a passo, e quando vale chamar o contador.

Use o índice à direita pra pular direto pro código que apareceu pra você. Cada erro tem o mesmo formato: causa → solução → quando chamar ajuda.

Como ler a mensagem de erro

Quando uma NF-e é rejeitada, o programa mostra:

❌ NF-e rejeitada Código: 539 Motivo: Rejeição: Duplicidade de NFe...

Anote sempre o código numérico — é o que identifica o erro. A mensagem em texto é uma tradução; o código é universal.

539 — Duplicidade de NF-e

Causa: você tentou emitir uma NF-e com chave de acesso já existente no banco da SEFAZ. Geralmente acontece quando:

Programa travou no meio do envio anterior
Você cancelou o envio mas a SEFAZ já tinha recebido
Tentou re-enviar uma nota que já foi autorizada

Solução:

Vá em Notas emitidasFiltrosÚltimas 24h
Procure se já existe nota com esse número/série
Se existe: a nota já foi emitida — não precisa reenviar
Se não aparece, clique em Consultar status na SEFAZ no menu de ações da nota — o programa busca no servidor e atualiza

Quando chamar suporte: se a nota não aparece em nenhum lugar mas a SEFAZ insiste que existe — pode ser inconsistência de banco local. Abra ticket em /suporte.

778 — NCM inválido

Causa: o NCM (8 dígitos) cadastrado num produto da nota não existe na tabela oficial ou está mal formatado.

Solução:

Identifique qual produto da nota tem NCM problemático (o erro mostra o número do item)
Vá em CadastrosProdutos e abra o produto
Confira o NCM — deve ter exatamente 8 dígitos sem ponto ou traço
Consulte o NCM correto em nfe.fazenda.gov.br
Corrija e salve

Erros comuns:

6109.10.00 → escrever assim (com pontos) não funciona. Tem que ser 61091000 puro.
61091000 válido vira 6109100 ao salvar (faltou 1 dígito) — confira que tem 8 zeros incluindo os finais.
NCM 9999.99 — não existe, é genérico de teste.

Quando chamar contador: se você não sabe qual NCM corresponde ao seu produto. Cada item tem um NCM oficial — não pode inventar.

226 — IE do emitente irregular

Causa: a Inscrição Estadual cadastrada no seu emitente está inválida, baixada ou suspensa na Receita.

Solução:

Consulte sua IE em sintegra.gov.br — selecione seu estado
Se aparece "Habilitada": o problema é digitação errada
- Vá em Emitente e confira o número da IE
Se aparece "Baixada" ou "Suspensa": problema na empresa
- Procure seu contador imediatamente
- Você precisa regularizar a IE antes de emitir

MEI deve usar ISENTO (em maiúsculas) no campo IE — sem número, sem espaço, sem ponto. Se você digitou Isento (minúsculas) ou deixou em branco, a SEFAZ rejeita.

227 — IE do destinatário inválida

Causa: a IE cadastrada no cliente que você selecionou está irregular ou foi digitada errada.

Solução:

Identifique o destinatário (aparece no erro)
Vá em CadastrosContatos e abra o cadastro dele
Consulte a IE em sintegra.gov.br do estado dele
Se irregular: mude o Indicador IE pra 2 - Isento ou 9 - Não contribuinte
- Indicador 1 exige IE ativa — se ele não tem, use 2 ou 9
Se for digitação errada: corrija o número e salve

233 — Município do emitente diverge da UF

Causa: o município cadastrado no seu emitente não pertence à UF selecionada. Ex: você selecionou SP mas o município é "Salvador" (BA).

Solução:

Vá em EmitenteEndereço
Confira município e UF
Use o CEP correto pra autopreencher — geralmente o problema é que alguém alterou município manualmente

281 — Certificado vencido

Causa: seu certificado A1 expirou.

Solução: veja o tutorial completo Certificado A1 venceu.

Resumo:

Compre certificado A1 novo na sua AC (Certisign, Serasa, etc)
Importe no programa em EmitenteCertificado
Tente emitir de novo

Cuidado: enquanto o certificado vence você não emite nada. Plano: renove 1 semana antes do vencimento, nunca no dia.

282 — Certificado revogado

Causa: a Autoridade Certificadora revogou seu certificado. Acontece quando:

Você reportou perda/roubo do certificado
A empresa fechou e a AC foi notificada
Detecção de uso fraudulento

Solução:

Você sabe por que foi revogado: emita um certificado novo na AC
Não sabe: ligue urgentemente pra AC (Certisign 4007-1995, Serasa 0800 773 7720). Pode ter sido erro deles.

587 — CPF do destinatário inválido

Causa: o CPF da pessoa física no destinatário falhou no algoritmo de validação (dígitos verificadores errados).

Solução:

Confirme o CPF com o cliente — talvez tenha trocado dígitos
Vá em CadastrosContatos e abra o cliente
Corrija o número (só dígitos, sem ponto ou traço)
Salve e tente emitir de novo

Dica: o programa valida CPF/CNPJ no cadastro. Se você consegue salvar, o número é matematicamente válido. Erro 587 geralmente acontece quando você importa via CSV com CPFs errados — o importador pode ter deixado passar.

692 — Versão do XML inválida

Causa: o programa está usando uma versão antiga do layout que a SEFAZ não aceita mais. A NF-e tem versões periódicas (4.00, NT 2020.006, etc) — a Receita atualiza e desativa versões antigas.

Solução:

Atualize o NF-e Desktop pra última versão: Menu superiorVerificar atualizações
Reinicie o programa
Tente emitir de novo

Se ainda assim falhar: pode ser problema do nosso lado — abra ticket em /suporte informando o código 692 e a UF da nota.

999 / Falha na conexão SEFAZ

Causa: a SEFAZ caiu (fora do ar) ou está com instabilidade. Não é problema seu — é deles.

Solução:

Aguarde 5–10 minutos e tente de novo
Verifique o status da SEFAZ do seu estado:
- nfe.fazenda.gov.br/portal/disponibilidade.aspx
Se estiver tudo verde no portal mas você ainda não emite:
- Pode ser sua internet — teste em fast.com
- Pode ser firewall corporativo bloqueando

Continua não funcionando após algumas horas?

Considere o modo contingência (pra NFC-e) se for venda urgente
Aguarde — geralmente a SEFAZ resolve em poucas horas

Erros não listados aqui

Se você recebeu um código que não está nesta lista:

Procure o código no portal nacional NF-e: nfe.fazenda.gov.br → "Lista de Rejeição" (PDF oficial)
Abra ticket em /suporte com:
- Código exato
- Mensagem completa que apareceu
- O que você estava fazendo
- Print da tela de erro

A gente cataloga o erro e atualiza esse tutorial.

Próximo passo

Aprendeu a debugar os erros mais comuns. Se o problema foi com o certificado, veja o tutorial dedicado de Certificado A1 venceu. Se o programa nem chega a tentar emitir, o checklist diagnóstico te guia.