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