API Reference

Introdução

Monitoramento de Unidades Consumidoras

Objetivo da funcionalidade

O monitoramento nos permite acessar qualquer área logada de qualquer distribuidora ou cooperativa de energia do Brasil, contanto que tenhamos as Credenciais (login & senha do portal da distribuidora) necessárias para cada uma delas.

As informações necessárias para acessar as distribuidoras e cadastrar corretamente as Unidades Consumidoras (UCs) podem ser encontradas na Documentação dos acessos as Distribuidoras.

Uma vez realizado o Cadastro das Credenciais , validamos se os dados passados estão de acordo com o esperado. Caso ainda falte alguma informação informaremos pela lista de Erros de Cadastro.

Com as UCs cadastradas iremos acessar as áreas logadas, buscar pela sua instalação e retornar as informações de pagamento da UC e o PDF das faturas solicitadas. Este processo acontece diariamente para toda UC com Monitoramento Ativo.

No momento do acesso a área logada da UC podemos nos deparar com dois problemas de Erro de Credencial: erro de Login e Senha e erro de UC não encontrada. Esses erros também são listados , classificados para direcionar os ajustes necessários no cadastro e disponíveis para consulta via uma rota separada.

  • Erro de Login e Senha: mesmo que tenha cadastrado adequadamente os dados necessários para acessa a agência virtual é possível que algum dos dados esteja incorreto de acordo com a distribuidora
  • Erro de UC não encontrada: nesse caso conseguimos acessar a área logada da distribuidora, porém a instalação que foi cadastrada não foi encontrada. Isso geralmente ocorre porque:
    • O login informado não pertence a UC cadastrada
    • O dado de instalação da UC cadastrado não corresponde ao identificador único que a distribuidora utiliza para organizar as UCs dentro da sua área logada
    • A UC informada esta encerrada de acordo com a distribuidora

A cada hora os Status de Pagamento, os PDFs e os Dados Extraídos e Normalizados das UCs acessadas nesse intervalo são disponibilizadas no sistema.