## Contas / Light / Download via CEP + OCR Faz download da conta de energia elétrica mais recente na Agência Virtual da Light através do CPF ou CNPJ do titular e do CEP, e retorna os dados lidos com OCR. ### Site URL - https://agenciavirtual.light.com.br/AGV_Segunda_Via_VW/AcessoRapido_SegundaVia.ModalLoginAcessoRapido.aspx ### Request POST endpoint: `https://api.infosimples.com/api/v2/consultas/contas/light/download-cep-ocr` | Parameter | Description | | ------------ | ----------------------------------------------------------- | | token* | The token that will authenticate and authorize the request. | | cpf** | CPF of the individual to be queried. | | cnpj** | CNPJ of the company to be queried. | | cep* | Postal code (CEP) of the address to be queried. | | instalacao** | Installation code to be queried. | > * Required parameter. > ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly. ### Response examples (OK) ```json { "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": { "api_version": "v2", "product": "Consultas", "service": "contas/light/download-cep-ocr", "parameters": { "cpf": "123.456.789-01", "codigo_cliente:": "12345678", "instalacao": "1234567890" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.28", "requested_at": "2022-07-20T10:44:31.000-03:00", "elapsed_time_in_milliseconds": 583, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX1/NTp6cr8Odf2GJXT3kU7JLgeLucIwakChtvlEgjTZb0otuXlvbv6CzophprUrRrXmkexuXhNU/oQ==" }, "data_count": 1, "data": [ { "conta": [ { "vencimento": "08/08/2022", "mes_ano": "Jul/2022", "valor": "R$ 226,16" } ], "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "instalacao": "1234567890", "mensagem": "Exemplo de mensagem", "ocr": [ { "classe_subclasse": "Residencial/Residencial", "grupo": "B", "subgrupo": "B1", "ref_mes": "JUL", "ref_ano": "2022", "mes": 7, "ano": 2022, "valor": "R$ 226,16", "vencimento": "08/08/2022", "leitura_data": "11/07/2022", "proxima_leitura_data": "10/08/2022", "leitura_data_anterior": "09/06/2022", "codigo_barras": "123456789012345678901234567890123456789012345678", "aviso": "Exemplo de Texto", "numero_fatura": "1111111111111", "cliente": { "cpf": "123.456.789-01", "cnpj": "12.345.678/9012-34", "nome": "Exemplo de Nome", "instalacao": "1234567890", "classificacao": "Convencional", "padrao_de_conexao": "Bifásico", "pn": "1234567890", "normalizado_cpf": "12345678901", "normalizado_cnpj": "12345678901234" }, "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "energia": { "energia_ativa_fornecida_te": "222", "energia_ativa_injetada_te": "", "normalizado_energia_ativa_injetada_te": 0.0, "saldo_energia_instalacao": "", "normalizado_saldo_energia_instalacao": 0.0, "tarifa_aneel_tusd": "", "normalizado_tarifa_aneel_tusd": 0.0, "tarifa_aneel_te": "", "normalizado_tarifa_aneel_te": 0.0, "bandeiras_tarifarias": [ { "bandeira": "JUNHO 2022 - BANDEIRA VERDE", "dias": null }, { "bandeira": "JULHO 2022 - BANDEIRA VERDE", "dias": null } ], "normalizado_bandeiras_tarifarias": [ { "mes": "JUNHO ", "ano": "2022", "bandeira": "BANDEIRA VERDE" }, { "mes": "JULHO ", "ano": "2022", "bandeira": "BANDEIRA VERDE" } ], "historico_consumo": [ { "periodo": "JUL/22", "kwh": "222", "dias": "32" }, { "periodo": "JUN/22", "kwh": "212", "dias": null }, { "periodo": "MAI/22", "kwh": "252", "dias": null }, { "periodo": "ABR/22", "kwh": "247", "dias": null }, { "periodo": "MAR/22", "kwh": "255", "dias": null }, { "periodo": "FEV/22", "kwh": "266", "dias": null }, { "periodo": "JAN/22", "kwh": "240", "dias": null }, { "periodo": "DEZ/21", "kwh": "256", "dias": null }, { "periodo": "NOV/21", "kwh": "231", "dias": null }, { "periodo": "OUT/21", "kwh": "219", "dias": null }, { "periodo": "SET/21", "kwh": "258", "dias": null }, { "periodo": "AGO/21", "kwh": "214", "dias": null }, { "periodo": "JUL/21", "kwh": "300", "dias": null } ], "soma_tarifas_bruta": null, "soma_tarifas_liquida": "0,80220000", "adicional_bandeira_tarifaria": "Convencional", "normalizado_adicional_bandeira_tarifaria": [], "tarifas_bandeira_tarifaria": [ { "soma_tarifas_liquida": "0,80220", "bandeira": "BANDEIRA VERDE" }, { "soma_tarifas_liquida": "0,82094", "bandeira": "BANDEIRA AMARELA" }, { "soma_tarifas_liquida": "0,94420", "bandeira": "BANDEIRA VERMELHA" } ] }, "nota_fiscal": { "numero_serie": "Nº 111111111 Série X", "apresentacao_data": "", "pis": "111.11111.11-1", "cofins": "3,520%", "icms": "18%" }, "itens_fatura": [ { "item": "Energia Elétrica kWh", "cfop": "5.258", "unidade": "kWh", "quant": "222", "preco_unit": "1,02204", "valor": "226,86" }, { "item": "Contrib Ilum Pública Municipal", "cfop": "", "unidade": "", "quant": "", "preco_unit": "", "valor": "13,59" }, { "item": "Compensação DIC Mensal 05/2022", "cfop": "", "unidade": "", "quant": "", "preco_unit": "", "valor": "-14,29" } ], "subtotais": [ { "item": "Subtotal Faturamento (veja abaixo)", "valor": "226,86" }, { "item": "Subtotal Outros", "valor": "-0,70" } ], "energia_injetada": "", "normalizado_valor": 226.16 } ], "site_receipt": "https://www.exemplo.com/exemplo-de-url" } ], "site_receipts": [ "https://www.exemplo.com/exemplo-de-url" ] } ``` ### Preview file The preview file (`site_receipts`) in the response JSON is **generated by the source (website/app)** that processed the automation. ### Code snippets #### Python ```python # Tested with: Python 3.10.19, Python 3.14.0 import requests url = 'https://api.infosimples.com/api/v2/consultas/contas/light/download-cep-ocr' args = { "cpf": "VALUE_OF_PARAMETER_CPF", "cnpj": "VALUE_OF_PARAMETER_CNPJ", "cep": "VALUE_OF_PARAMETER_CEP", "instalacao": "VALUE_OF_PARAMETER_INSTALACAO", "token": "WRITE_YOUR_TOKEN_HERE", "timeout": "300" } response = requests.post(url, args) response_json = response.json() response.close() if response_json['code'] == 200: print("Retorno com sucesso: ", response_json['data']) elif response_json['code'] in range(600, 799): mensagem = "Resultado sem sucesso. Leia para saber mais: \n" mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message']) mensagem += "; ".join(response_json['errors']) print(mensagem) print("Cabeçalho da consulta: ", response_json['header']) print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts']) ``` ## We are here to help Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.