Pular para o conteúdo
  • Não há sugestões porque o campo de pesquisa está em branco.

O que fazer quando encontro um "Erro" no log de coleta/tentativas de coleta?

O que fazer quando encontro um "Erro" no log de coleta/tentativas de coleta?

Existem 4 status possíveis de um robô de coleta:

  1. Sucesso: este status significa que a última tentativa de acesso à agência virtual foi bem sucedida. Ou seja, que o robô conseguiu acessar a agência virtual com as credenciais e configurações informadas. Atenção, o status "Sucesso" NÃO significa que um arquivo foi coletado, apenas que o robô conseguiu realizar o login com as credenciais cadastradas.


    Os erros são divididos em três tipos: 
  2. Erro do usuário: acontece quando o robô não consegue concluir a operação do início ao fim (desde o login até o download) devido à problemas relacionados à informações de sua configuração. Por exemplo, as credenciais estão inválidas ou o número de UC informado não é encontrado na lista de UCs associadas à credencial configurada no robô. Em geral, neste tipo de erro o usuário precisa tomar uma ação de revisar as configurações do robô.
  3. Erro do provedor: acontece quando o robô encontra algum problema relacionado à agência virtual. Por exemplo, a agência virtual está instável ou não conclui a solicitação de download. Em geral, neste tipo de erro o usuário precisa tomar uma ação de entrar em contato com a concessionária para que o problema seja resolvido.
  4. Erro do sistema: acontece quando há algum problema no sistema da CUBi ou que ainda não houve tempo suficiente para fazer a primeira coleta após a configuração (ou reconfiguração) do robô. Em geral, neste tipo de erro a equipe da CUBi precisa atuar para corrigir o erro.


Atenção, os tipos de erros nem sempre são representados de forma inequívoca. Por exemplo, vamos assumir que em determinada Unidade todas as configurações foram feitas corretamente (credenciais de login válidos e número de UC correto), mas o robô está encontrando um erro pois não consegue achar o número de UC no filtro da agência virtual. O robô pode associar este erro a um "Erro do usuário" assumindo que o número de UC configurado está incorreto. Mas a verdade é que o sistema da agência virtual está com problema e parou de indexar algumas UCs temporariamente. Neste caso o correto seria "Erro do provedor".

Por isso, considere os tipos de erro como uma primeira sugestão de diagnóstico e não como um diagnóstico definitivo. Nunca considere o tipo de erro isoladamente para tomar uma ação, consulte também as mensagens e detalhes do status atual do robô de coleta para te ajudar no diagnóstico. As linhas que definem a causa de um erro podem ser bastante tênues e, muitas vezes, impossíveis de se traçar. Por isso, para todos casos de erro, recomenda-se testar manualmente de acordo com os testes especificados abaixo.

Onde encontrar os detalhes do status atual do robô de coleta?

  1. Vá em “Coleta de Faturas >> Tentativas de Coleta” ou em Unidades > Ver detalhes > Coleta de Faturas > Histórico de coleta;

  2. Nessas páginas você vai encontrar o botão "Ver detalhes do status atual", clique nele;
  3. Você verá uma barra aparecer na direita da sua tela com informações sobre o último acesso. Atenção, este status é referente apenas à última tentativa de coleta de cada Unidade, não é possível acessar informações de tentativas anteriores;
  4. Nessa página, você já terá mais contexto sobre o erro, veja exemplo abaixo
    Screenshot 2026-07-02 at 08.53.21Screenshot 2026-07-02 at 08.53.09



Como faço o diagnóstico de problemas de coleta automatizada?

Para diagnosticar um problema de coleta de faturas temos que testar 3 principais hipóteses listadas abaixo. Elas podem ser testadas simplesmente fazendo um teste manual de acesso à agência virtual (atenção o teste precisa ir do login até o download efetivo do arquivo, não parar o teste antes de executar o download):
  1. Credenciais são inválidas: você não consegue acessar manualmente. Nestes casos, você precisa reconfigurar o robô com dados válidos de login;
  2. Credenciais são válidas mas a agência virtual não completa o download: você consegue acessar, mas não consegue chegar até o download do documento na agência virtual. Nestes casos, o problema é na agência virtual, você precisa abrir um chamado na concessionária ou acionar a ouvidoria;
  3. Credenciais são válidas, a agência virtual completa o download mas o sistema da CUBi não está funcionando corretamente: você consegue acessar e fazer o download, mas o arquivo não é exibido no sistema da CUBi. Neste caso, avalie se o robô está ativado e com as configurações corretas e se a emissão do documento não aconteceu entre o período de espera entre as últimas duas tentativas de coleta. Se nenhuma dessas condições se aplicar, entre em contato com o suporte da CUBi.

 

Não encontrou o que procurava?

Volte para a página inicial e procure pela palavra chave ou entre em contato conosco pelo suporte@cubienergia.com!