Quando o ícone do Agente de Comunicação está vermelho ou aparece offline, esta situação pode ocorrer por diferentes motivos, desde falhas de autenticação (e-mail e/ou senha inválidos) até conflitos em atualizações do sistema ou versão incompatível do agente.
Para identificar e corrigir a situação, siga o processo sequencial abaixo. Cada etapa deve ser tentada na ordem apresentada. Caso uma etapa não resolva o problema, prossiga para a próxima até restabelecer a comunicação.
Identifique o tipo de erro
Antes de iniciar qualquer correção, clique no ícone (bolinha) vermelho do Agente de Comunicação no sistema e observe qual mensagem de erro é exibida. A partir dessa mensagem, você saberá qual caminho seguir:
• Se a mensagem for referente a credenciais, autenticação, e-mail ou senha de gerente inválidos, vá para o Passo 1;
• Se o ícone estiver vermelho, mas não demonstra erro ou fica travado sem mensagem específica, vá para o Passo 2;
• Se a mensagem for referente a instalação, reinstalação ou necessidade de uma versão específica do agente, vá para o Passo 3.
1. Atualize Credenciais do Usuário Gerente
Quando a mensagem indica problema de autenticação, o erro está relacionado às credenciais. Isso ocorre quando o e-mail ou a senha do usuário Gerente foram alterados no portal ONVIO, mas essa mudança não foi atualizada no sistema Contábil. Este procedimento aplica-se tanto ao Domínio instalado localmente quanto ao Domínio Web:
1. Acesse o portal ONVIO através do navegador (onvio.com.br) e confirme que seu e-mail e senha do Thomson Reuters ID estão corretos e atualizados;
2. No sistema Contábil, conecte-se com o usuário Gerente e acesse o menu Controle > Permissões > Usuários;
3. Localize e selecione o cadastro do usuário Gerente;
4. No quadro Opções, identifique o campo Usuário para acessar ONVIO/Suporte e clique no botão com reticências [...];
5. Na janela que abrir, informe o e-mail e a senha (os mesmos validados no portal ONVIO) e clique em [Gravar];
6. Clique novamente em [Gravar] para salvar definitivamente as alterações no cadastro do usuário.
Após concluir este passo, aguarde alguns instantes e verifique se o ícone do Agente ficou verde. Para usuários do Domínio Web, se o problema persistir após este passo, será necessário acionar o suporte técnico, pois o Agente de Comunicação fica hospedado no servidor em nuvem e requer intervenção especializada.
2. Reinicie os Serviços do Agente (Correção Rápida)
Quando o ícone vermelho não demonstra mensagem de erro ou fica travado, isso indica um travamento temporário do serviço no Windows. Realize este passo somente se usa o Sistema Domínio Local. Se usa Domínio Web, pule esta etapa e acione o suporte técnico.
1. Feche completamente o sistema Domínio;
2. Pressione simultaneamente as teclas Ctrl + Shift + Esc para abrir o Gerenciador de Tarefas do Windows;
3. Acesse a aba Detalhes, localize e finalize os seguintes processos: Agente_comunicacao.exe e ServicoDominioAtendimento.exe;
4. Abra o menu Iniciar do Windows, digite Agente de Comunicação na busca e execute o aplicativo;
5. Aguarde aproximadamente 2 minutos e verifique se o ícone do agente mudou para a cor verde.
3. Reinstale o Agente de Comunicação
Se a mensagem de erro indicar problemas de instalação, versão incompatível, impossibilidade de inicializar a ferramenta (botões iniciar/parar desabilitados) ou se os passos anteriores não resolveram, pode haver arquivos corrompidos ou travados durante alguma atualização do sistema. A reinstalação do Agente resolve conflitos de arquivos e restaura a configuração padrão.
Desinstalação
1. Pressione as teclas Ctrl + Shift + Esc para abrir o Gerenciador de Tarefas do Windows;
2. Na aba Detalhes, finalize os processos Agente_comunicacao.exe e ServicoDominioAtendimento.exe;
3. Abra o menu Iniciar do Windows;
4. Digite Adicionar ou remover programas na busca e pressione Enter;
5. Na lista de programas instalados, localize Agente de Comunicação;
6. Clique no botão reticencias [...] sobre o programa e selecione [Desinstalar];
7. Confirme a desinstalação e aguarde a conclusão do processo.
Reinstalação
1. Acesse a pasta C:\Contabil e verifique se existem pastas duplicadas do Agente (pastas com nomes similares ou renomeadas). Caso existam, exclua-as, mantendo apenas a pasta original Agente de Comunicação com o Domínio Atendimento;
2. Acesse o caminho C:\Contabil\Agente de Comunicação com o Domínio Atendimento;
3. Em seguia, acesse a pasta DownloadAgente (caso tenha personalizado a instalação, acesse a pasta conforme sua configuração);
4. Em seguia, acesse a pasta DownloadAgente no seu computador (caso tenha personalizado a instalação, acesse a pasta conforme sua configuração);
5. Clique com o botão direito do mouse no arquivo InstalaAgente.exe e selecione a opção Executar como administrador;
6. Clique no botão [Avançar] sucessivamente até concluir a instalação;
7. Abra o menu Iniciar do Windows, digite Agente de Comunicação na busca, clique com o botão direito do mouse no resultado e selecione Executar como administrador;
8. Na interface do Agente, acesse a guia Inicialização e, no quadro Iniciar/Parar comunicação com o Domínio Atendimento, clique no botão [Iniciar] (quando o serviço iniciar corretamente, o botão ficará desabilitado);
9. Verifique se o ícone ficou verde no sistema.
Informações Complementares
• Antes de atualizar a versão do sistema Domínio, sempre finalize o processo ServicoDominioAtendimento.exe no Gerenciador de Tarefas. Esta prática preventiva evita que arquivos do Agente fiquem travados durante a atualização, prevenindo o erro de ícone vermelho;
• Para usuários do Domínio Web, o Agente de Comunicação fica hospedado no servidor em nuvem. Nestes casos, se o ícone estiver vermelho, execute apenas o Passo 1 (Atualização de Credenciais). Se o problema persistir, acione o suporte técnico;
• Se ao tentar alterar a senha no portal ONVIO o sistema informar que a senha já foi usada anteriormente, crie uma senha completamente nova e diferente. O sistema de integração precisa reconhecer uma mudança efetiva nas credenciais para restabelecer a autenticação;
• Verifique se o certificado digital da empresa está dentro do prazo de validade. Certificados vencidos ou com problemas de instalação impedem que o Agente estabeleça comunicação segura e, consequentemente, bloqueiam o envio de eventos para o eSocial.
