## 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. ### URL do site - https://agenciavirtual.light.com.br/AGV_Segunda_Via_VW/AcessoRapido_SegundaVia.ModalLoginAcessoRapido.aspx ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/contas/light/download-cep-ocr` | Parâmetro | Descrição | | ------------ | -------------------------------------------------------------------------------------------------------- | | token* | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. | | cpf** | CPF do indivíduo a ser consultado. | | cnpj** | CNPJ da empresa a ser consultada. | | cep* | CEP do endereço a ser consultado. | | instalacao** | Código da instalação a ser consultada. | > * Parâmetro obrigatório. > ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente. ### Exemplos de respostas (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" ] } ``` ### Arquivo de visualização de consulta O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API é **emitido pela fonte original**. ### Exemplos de códigos para integração com a API #### Python ```python # Testado com: 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": "VALOR_DO_PARAMETRO_CPF", "cnpj": "VALOR_DO_PARAMETRO_CNPJ", "cep": "VALOR_DO_PARAMETRO_CEP", "instalacao": "VALOR_DO_PARAMETRO_INSTALACAO", "token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO", "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']) ``` ## Estamos prontos para ajudar Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.