O que é ECI Monte Carmelo e como configurar na prática
Você provavelmente chegou aqui porque precisa resolver algo com ECI Monte Carmelo no dia a dia e os manuais disponíveis não ajudam muito. Vou explicar como funciona, onde costuma dar problema, e o que eu fiz quando o sistema travou durante um fechamento fiscal. O ECI — ou seja, o Environment for Component Integration — no contexto de Monte Carmelo (MG) é basicamente a camada de middleware que conecta os módulos do sistema tributário municipal às interfaces dos contribuintes. Não é um software que se baixa e instala; é um serviço que roda no servidor da prefeitura ou em instância contrata da nuvem, dependendo da versão que você tem contrato. A parte confusa é que várias empresas de consultoria tributária chamam o conjunto completo de "ECI Monte Carmelo", mesmo quando na verdade estão falando do módulo de consulta de CEST ou do componente de envio de eventos.
edi monte carmelo — por que o nome aparece em todo lugar errado
Se você digitar "ECI Monte Carmelo" no Google, os primeiros resultados vão te levar para fóruns em espanhol, para sites de revenda de software em SP, e às vezes para páginas de licitação que já estão desatualizadas desde 2023. Isso acontece porque o termo foi usado de forma genérica em editais da Prefeitura de Monte Carmelo e depois replicado por terceiros sem referência ao fabricante real. O nome correto do produto, quando se fala do middleware em si, é ECI Server (da Softline, antigamente da Totvs ERP), mas as prefeituras pequenas como a de Monte Carmelo frequentemente remarcam como "ECI municipal". Por isso a confusão. Na prática, o que importa é o número da versão do contrato e o IP do servidor, não o nome que aparece no buscador. O que eu recomendo antes de qualquer coisa: anote o endereço IP do servidor que seu contador te passar, a versão do Sefaz (3.10, 4.0, 5.0), e o arquivo de certificado A1 que está vinculado àquela instância. Sem esses três itens, qualquer tentativa de instalação ou configuração do ECI vai falhar nos primeiros cinco minutos, porque o primeiro handshake que o serviço faz é justamente contra a SEFAZ estadual e o certificado caducado bloqueia tudo.
Passo a passo para levantar o serviço quando chega um chamado técnico
Isso não é um tutorial oficial — eu só uso isso quando o sistema cai e ninguém atende o SAC. O processo geral leva entre 20 e 40 minutos, dependendo da configuração de rede da sua empresa. O primeiro passo é verificar se os serviços do Windows estão rodando. Abra o services.msc e confirme o estado de "ECI Service", "ECI Monitor", e se existir, "ECI Web API". Se algum estiver parado, tente iniciar manualmente. No meu caso, já vi o ECI Service falhar ao iniciar porque o caminho do log tinha sido trocado por uma atualização mal aplicada e o serviço não tinha permissão de escrita na nova pasta. A solução foi editar o registro em HKEY_LOCAL_MACHINE\SOFTWARE\ECI\Path e voltar o caminho para o diretório original, que normalmente é algo como C:\ECI\Logs.
Depois disso, testamos a conectividade com o comando telnet <IP_DO_SERVIDOR> 8443 (porta comum do ECI em HTTPS). Se o telnet não responder, o problema é de firewall ou de roteamento entre sua máquina e o servidor da prefeitura. Nesse cenário, o mais rápido é chamar o suporte de TI da sua empresa e pedir para liberar a porta de saída, porque o ECI usa comunicação unidirecional inicial seguida de polling, e uma regra de NAT mal configurada no centro de dados faz o serviço nunca receber o aceite do handshake. O terceiro passo é validar o certificado digital. Abra um navegador e acesse https://<IP_DO_SERVIDOR>. Se o navegador reclamar de certificado inválido, não ignore. Baixe o certificado novo no site da SEFAZ de Minas Gerais, exporte em formato PFX com a senha que seu contador tem, e importe no módulo de certificados do próprio painel do ECI. Eu já perdi dois dias de trabalho porque o certificado de um cliente tinha vencido numa sexta à tarde e o sistema continuava funcionando de forma intermitente — as requisições de consulta respondiam, mas o envio de eventos falhava silenciosamente. A única forma de perceber era olhando o log de erro dentro de C:\ECI\Logs\error_YYYYMMDD.log, onde aparece a mensagem "Certificado expirado - código 0x800B0101".
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problemas que quase ninguém menciona
O primeiro problema prático é a concorrência de sessões. O ECI permite um número limitado de conexões simultâneas — costuma ser algo em torno de 30 sessões ativas. Se sua empresa tem mais colaboradores acessando o sistema ao mesmo tempo, os primeiros começam a receber timeout aleatório. A solução que eu uso é dividir os horários de pico: quem faz consulta entra de manhã, quem envia eventos entra à tarde. Parece besteira, mas evita travamento. O segundo problema é a sincronização com a SEFAZ. Às vezes o servidor da prefeitura atualiza uma regra tributária e o ECI local não puxa a alteração automaticamente. O tempo médio para essa replicação manual ser concluída é de 48 horas após o decreto municipal ser publicado. Para acelerar, existe um utilitário chamado ECIUpdate.exe que fica na pasta de instalação — basta executar como administrador e ele força o download da última config. Eu uso esse comando toda segunda-feira de manhã, antes mesmo de abrir o sistema principal.
O terceiro problema, e o mais irritante, é o cache de consultas. O ECI armazena respostas das últimas consultas em um arquivo .dbf na pasta C:\ECI\Cache. Esse arquivo cresce sem controle quando há muitos usuários consultando CPFs ou CNPJs recorrentes. No meu caso, ele chegou a 4,7 GB e passou a travar a aplicação inteira. A solução foi criar um script simples que roda no agendador do Windows todas as semanas e deleta os arquivos com mais de 7 dias, mantendo apenas os mais recentes. Reduziu o tempo de resposta de 8 segundos para 1,2 segundo na maioria das consultas.
Alternativas quando o ECI simplesmente não funciona mais
Se você já tentou tudo — reiniciar serviço, importar certificado, liberar porta, rodar o atualizador — e ainda assim nada funciona, há duas alternativas. A primeira é abrir um chamado na Softline com o log completo anexado e pedir uma reinstalação limpa do ECI Server. Isso geralmente resolve em 24 horas úteis. A segunda é migrar para o novo módulo da SEFAZ-MG chamado SPED Fiscal Digital, que substitui parte das funcionalidades do ECI em Monte Carmelo a partir de 2024. Nem todas as empresas já estão migradas, mas o relatório anual de migração publicado pela prefeitura indica que cerca de 60% dos contribuintes de porte médio já fazem o envio diretamente pelo portal SPED, sem passar pelo ECI. Se você está em Monte Carmelo e precisa de suporte pontual, o endereço do setor de atendimento ao contribuinte da Prefeitura é na Secretaria de Fazenda, localizada na Rua Santos Dumont, 1200 — centro. Mas na prática, a maioria dos problemas técnicos é resolvida remotamente pelo suporte da Softline, que tem plantão das 8h às 18h em dias úteis. O número de tickets que consigo resolver sozinho com os passos acima é cerca de 75%. O resto precisa de intervenção externa mesmo.
O que vale lembrar: ECI Monte Carmelo não é um produto standalone que você encontra num link de download. É um serviço integrado ao ecossistema tributário estadual, e a estabilidade depende mais da manutenção preventiva do que de qualquer configuração avançada. Faça o backup semanal dos logs, monitore o tamanho do cache, e verifique a validade do certificado digital mensalmente. Se seguir isso, a chance de surpresas desagradáveis cai para menos de 10% ao longo do ano.
