🐛 Erros Comuns - ecosif-moviments

📋 Visão Geral

Este documento lista erros comuns e suas soluções.

🔐 Erros de Autenticação

401 Unauthorized

Causas: - Token ausente no header - Token inválido ou expirado - Token mal formatado

Soluções:

# Verificar formato do header
Authorization: Bearer <token>  # Correto
Authorization: <token>         # Errado
Authorization: Bearer<token>   # Errado (falta espaço)

# Obter novo token
curl -X POST http://localhost:8080/api/auth/signin \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"senha123"}'

📝 Erros de Validação

400 Bad Request - Partidas Não Conferem

Mensagem:

Partidas dobradas não conferem. Débitos: 1000.00, Créditos: 500.00

Causa: Soma de débitos diferente da soma de créditos no documento.

Solução: - Verificar se todos os lançamentos do documento somam zero - Garantir que cada débito tem seu crédito correspondente

Exemplo correto:

// Débito
{"documentId": 1, "debcre": "D", "valor": 1000.00}
// Crédito
{"documentId": 1, "debcre": "C", "valor": 1000.00}

400 Bad Request - Conta Contábil Inválida

Mensagem:

Conta contábil não encontrada ou inativa: 999

Causa: Conta contábil não existe ou está inativa.

Solução: - Verificar se conta existe no plano de contas - Verificar se conta está ativa (status = 'A') - Consultar plano de contas via ecosif-masterdata

400 Bad Request - Período Fechado

Mensagem:

Período 11/2025 está fechado ou consolidado

Causa: Tentativa de criar lançamento em período fechado.

Solução: - Verificar status do período no calendário - Abrir novo mês se necessário via /monthOpening

📦 Erros de Recursos

404 Not Found - Lote Não Encontrado

Mensagem:

Lote não encontrado: 999

Solução: - Verificar se ID está correto - Listar lotes disponíveis via /allbatch/{company}/{branch}

404 Not Found - Documento Não Encontrado

Mensagem:

Documento não encontrado: 999

Solução: - Verificar se documento existe no lote - Listar documentos via /alldocument/{batchId}

📥 Erros de Importação

400 Bad Request - Arquivo Vazio

Mensagem:

File is empty

Solução: - Verificar se arquivo foi enviado corretamente - Verificar tamanho do arquivo

400 Bad Request - Formato Inválido

Mensagem:

Formato de arquivo inválido. Esperado: CSV ou IPL

Solução: - Verificar extensão do arquivo (.csv, .ipl) - Verificar estrutura do arquivo (colunas CSV, formato IPL)

🔄 Erros de Consolidação

400 Bad Request - Mês Não Consolidável

Mensagem:

Mês não está consolidável. Há períodos anteriores não consolidados

Causa: Tentativa de consolidar mês sem consolidar meses anteriores.

Solução: - Consolidar meses anteriores primeiro - Verificar status dos meses no calendário

💰 Erros de Cálculo de Cotas

200 OK - Validações do Cálculo

O endpoint retorna lista de mensagens quando há problemas:

Exemplos:

// Mês não consolidado
["MOVIMENTO NAO CONSOLIDADO"]

// Sem dia livre
["SEM DIA LIVRE"]

// Patrimônio líquido negativo
["VALOR DO PATRIMONIO LIQUIDO É NEGATIVO= : -1000.00"]

// Sem conta PL
["SEM CONTA PL"]

Soluções: - Consolidar mês antes de calcular - Verificar configuração de contas PL - Verificar se há dia livre no calendário

🔧 Erros de Servidor

500 Internal Server Error

Causas: - Erro interno do servidor - Problema de conexão com banco - Erro em processamento assíncrono

Soluções: - Verificar logs do servidor - Verificar conectividade com banco - Tentar novamente após alguns segundos - Contatar suporte se persistir

📊 Troubleshooting Geral

Verificar Health do Serviço

curl http://localhost:8082/actuator/health

Resposta esperada:

{
  "status": "UP"
}

Verificar Logs

Se usando Docker:

docker logs -f ecosif-moviments

Verificar Conectividade

# Verificar se serviço está rodando
curl http://localhost:8082/actuator/info

# Verificar banco de dados
docker exec db_ecosif-moviments pg_isready -U postgres

📞 Suporte

Se o erro persistir:

Verificar logs do serviço
Verificar documentação em /docs
Contatar suporte: support@ecosif.net.br

Última Atualização: 2025-11-27