⚠️ Erros Comuns - ecosif-querys¶

📋 Visão Geral¶

Este documento lista os erros mais comuns e como resolvê-los.

🔐 401 Unauthorized¶

Problema: Token ausente ou inválido.

Solução: 1. Verifique se o header Authorization está presente 2. Verifique se o token está válido (não expirado) 3. Obtenha um novo token via ecosif-auth

🚫 403 Forbidden¶

Problema: Usuário não tem acesso à empresa/filial.

Solução: 1. Verifique se o usuário tem permissão para a empresa/filial 2. Contate o administrador para adicionar permissões

❌ 400 Bad Request¶

Problema: Dados inválidos.

Soluções: - Formato de data inválido: Use MM/YYYY (ex: "01/2025") - Range inválido: Período inicial não pode ser maior que final - Dia inválido: dayStart não pode ser maior que dayEnd

🔍 404 Not Found¶

Problema: Empresa, filial ou conta não encontrada.

Solução: 1. Verifique se empresa/filial existe 2. Verifique se conta existe no plano de contas

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