Tratamento de Erros & Códigos SEFAZ

Ao emitir notas fiscais para a SEFAZ ou portal ADN da Receita Federal, o processador fiscal valida o documento em duas etapas:

1. Validação Estrutural Local (HTTP 400 / 422): Formato dos campos (CNPJ, NCM, alíquotas, cálculos matemáticos do total).
2. Autorização pela SEFAZ Estadual: Resposta com código numérico cStat e mensagem descritiva xMotivo.

---

Códigos SEFAZ Mais Frequentes (cStat)

cStat	Tipo	Significado	Ação Recomendada
100	Sucesso	Autorizado o uso da NF-e	Nota autorizada. Prossiga com o download do DANFE/XML.
101	Sucesso	Cancelamento de NF-e homologado	O documento foi cancelado com sucesso.
135	Sucesso	Evento registrado e vinculado à NF-e	Carta de Correção (CC-e) ou Manifestação aceita.
204	Rejeição	Duplicidade de NF-e [ch:...]	Chave de acesso já existente na base da SEFAZ.
215	Rejeição	Falha de schema XML	Verifique campos ausentes ou formatação inválida.
539	Rejeição	Duplicidade com diferença no CNPJ do emitente	Série e número já foram utilizados por outro emitente.
610	Rejeição	Total da NF difere do somatório dos Itens	O somatório dos produtos e frete/desconto não bate com vNF.

---

Estrutura de Retorno em Caso de Rejeição SEFAZ

{
  "id": "clt1983hx0001va93jflam789",
  "status": "REJEITADA",
  "cStat": 610,
  "xMotivo": "Rejeicao: Total da NF difere do somatorio dos Itens (vNF informado: 150.00, calculado: 140.00)",
  "erros": [
    {
      "campo": "total.valorTotal",
      "mensagem": "Divergência de R$ 10,00 no somatório total da nota"
    }
  ]
}