Tratamento de Erros

Formato padrão

{ "statusCode": 400, "message": "CNPJ inválido", "error": "Bad Request" }

Códigos HTTP

Código	Significado
200	✅ Sucesso
400	❌ JSON inválido ou campos faltando
401	🔒 Token inválido ou expirado
403	🚫 Sem permissão
404	🔍 Recurso não encontrado
422	❌ SEFAZ rejeitou o documento
429	🐢 Rate limit
500	💥 Erro interno

Erro fiscal (422)

{
  "statusCode": 422,
  "message": "Nota rejeitada pela SEFAZ",
  "rejection": { "code": "539", "description": "Duplicidade de NF-e" }
}

Erros comuns

Erro	Solução
401 Token expirado	Faça login novamente
422 Rejeição 539	Nota já existe — use próximo número
422 Rejeição 225	Campos obrigatórios faltando
400 Certificado não encontrado	Upload certificado primeiro