Hath DataHathData
API de consultaSob demanda

API Light com leitura: a conta de luz em campos

A mesma 2ª via da Light pelo CNPJ e CEP, mas a Hath lê o PDF e devolve os campos prontos para o seu sistema: instalação, mês de referência, vencimento, valor, consumo em kWh e código de barras.

Ler contas da Light pela API Ver todas as consultas

Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026

  1. 1

    Entrada

    cnpjcepcampos
  2. 2

    Fonte oficial

    LightAgência Virtual, Acesso rápido Segunda Via de Conta

  3. 3

    Saída

    JSON lido e PDF da conta

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Todos os números são fictícios; cada campo vem do que está impresso na conta.

Parâmetros

  • cnpjobrigatório

    Quem paga a energia: o titular cadastrado na distribuidora.

  • cepopcional

    Onde fica a unidade consumidora; separa endereços do mesmo titular.

  • camposopcional

    Quais campos ler; sem ele, volta o conjunto padrão abaixo.

Campos retornados

status
concluida quando o órgão respondeu; em_andamento enquanto a fonte não libera (o resultado chega por webhook); fonte_indisponivel quando o portal está fora do ar, que nunca vira "nada consta".
resultado.contas[].consumo_kwh
O consumo do mês em kWh, lido do quadro de consumo da conta.
resultado.contas[].valor
O total a pagar, em reais, como número.
resultado.contas[].mes_referencia
Ano e mês da conta, no formato AAAA-MM, para ordenar o histórico.
resultado.situacao
negativa, positiva, positiva_com_efeito_de_negativa ou nao_emitida: o mesmo vocabulário em todas as fontes.
resultado.numero_certidao
O número ou código de controle impresso no documento, para validar no próprio órgão.
resultado.emissao
Data e hora da emissão, como o documento registra.
resultado.valida_ate
A validade lida no documento; null quando o órgão não fixa prazo.
resultado.texto_completo
O texto integral do documento, extraído do PDF, para guardar e pesquisar sem abrir o arquivo.
RespostaJSON
{"protocolo": "a1b2c3d4","status": "concluida","consulta": "light_segunda_via_ocr","orgao": "Light","cnpj": "00000000000100","cep": "20000000","resultado": {"situacao": "negativa","numero_certidao": "000000/2026","emissao": "2026-10-27T10:15:00-03:00","valida_ate": "2026-11-26","contas": [{"instalacao": "0000000000","mes_referencia": "2026-10","vencimento": "2026-11-12","valor": 0,"consumo_kwh": 0,"codigo_barras": "000000000000000000000000000000000000000000000000"}],"texto_completo": "Texto integral do documento, lido do PDF emitido pelo órgão (exemplo)."},"pdf_url": "https://…/conta.pdf"}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

  • Regular

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Na fonte oficial

Agência Virtual da Light, formulário de acesso rápido: titular, endereço da unidade e Prosseguir

Tela de onde sai o PDF que a Hath lê; registrada em 27/10/2026, sem dado de cliente.

Como ler o resultado

A leitura serve para lançar a conta sem digitar: rateio de energia por filial, conferência de consumo mês a mês, agendamento de pagamento. O PDF original volta junto, porque é ele que vale numa auditoria.

Valor e vencimento chegam como número e data, prontos para o contas a pagar; o código de barras vem como texto corrido, sem espaços, do jeito que o banco aceita colar.

Perguntas frequentes

Qual a diferença para a 2ª via simples?

A simples devolve o PDF e o código de barras. Esta lê a conta e devolve também valor, vencimento, mês e consumo em campos.

Lê fatura agrupada?

A 2ª via da Light emite o demonstrativo por instalação; cada demonstrativo é lido como uma conta.

Dá para montar o histórico de consumo?

Sim: com o mês de referência e o consumo em kWh de cada conta, a série mensal sai direto da resposta, por unidade.

API Light 2ª via com leitura da conta na sua integração

Sob demanda. Acesso no mesmo dia, com crédito para testar.

Ler contas da Light pela API

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.