Pular para conteúdo

Erros Comuns - ecosif-masterdata

Este documento lista os erros mais comuns ao integrar com a API ecosif-masterdata e como resolvê-los.

Erros de Autenticação

401 Unauthorized - "Token expirado"

Problema: Token JWT expirou

Solução: Fazer login novamente no ecosif-auth e usar novo token

401 Unauthorized - "Token inválido"

Problema: Token malformado ou assinatura inválida

Soluções: 1. Verifique se está incluindo "Bearer " antes do token 2. Verifique se o token não foi corrompido 3. Verifique se está usando a mesma chave secreta (AUTH_TOKEN_SECRET) em todos os serviços

Erros de Validação

400 Bad Request

Problema: Dados de entrada inválidos

Solução: Verifique os dados enviados no body da requisição

406 Not Acceptable

Problema: Violação de regra de negócio

Exemplos: - Conta pai não existe ao criar conta filha - Conta pai já tem filhos e tentou adicionar mais - Código contábil já existe no plano

Solução: Verifique as regras de negócio antes de fazer a requisição

409 Conflict

Problema: Recurso já existe

Exemplos: - CNPJ já cadastrado - Código de filial já existe para a empresa

Solução: Verifique se o recurso já existe antes de criar

Erros de Recursos

404 Not Found

Problema: Recurso não encontrado

Solução: Verifique se o ID ou código existe no sistema

Próximos Passos