## Contas / Light / Download + OCR Faz download da conta de energia elétrica mais recente na Agência Virtual da Light e retorna os dados da conta lidos com OCR. ### URL do site - https://agenciavirtual.light.com.br/portal ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/contas/light/download-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. | | login* | Login (email ou cpf) usado para login na Light. | | senha* | Senha usada para login na Light. | | codigo_cliente** | Alguns logins possuem mais de um código de cliente associado. Se for este o caso, este parâmetro será usado para identificar o código de cliente correto. Se este campo não for informado, o primeiro código de cliente disponível será usado. | | codigo_instalacao** | Alguns logins possuem mais de um código de instalação associado. Se for este o caso, este parâmetro será usado para identificar o código de instalação correto. Se este campo não for informado, o primeiro código de instalação disponível será usado. | | mes** | Mês da conta a ser buscada, no formato MM/AAAA. Se não for informado, será buscada a conta mais recente disponível. | > * 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", "parameters": { "codigo_cliente": "1111111111", "codigo_instalacao": "1111111111", "email": "exemplo@email.com", "senha_md5": "e379c59a3573be16480533ae3f53ea1b" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.24", "requested_at": "2022-12-23T19:09:19.000-03:00", "elapsed_time_in_milliseconds": 574, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX1/K8S1jMEkKDxlj9a0OkRJA+ahzzrvmlAtn2AEKEKcGDeasfY9IsvtySAWChZPP9Jp82vVl+Wn4MA==" }, "data_count": 1, "data": [ { "conta_paga": false, "mes": "Dez/2022", "normalizado_valor": 165.11, "ocr": [{ "ano": 2023, "aviso": "Exemplo de Texto", "classe_subclasse": "Outros Serviços e Outras Ativ", "cliente": { "cpf": "123.456.789-01", "cnpj": "12.345.678/9012-34", "nome": "Exemplo de Nome", "instalacao": "1234567890", "classificacao": "Único", "padrao_de_conexao": "TRIFÁSICO", "pn": "1234567890", "normalizado_cpf": "12345678901", "normalizado_cnpj": "12345678901234" }, "codigo_barras": "123456789012345678901234567890123456789012345678", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "energia": { "energia_ativa_fornecida_te": "", "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": [], "normalizado_bandeiras_tarifarias": [], "historico_consumo": [], "soma_tarifas_bruta": null, "soma_tarifas_liquida": "0,81062", "adicional_bandeira_tarifaria": "", "normalizado_adicional_bandeira_tarifaria": [], "tarifas_bandeira_tarifaria": [], "consumo": [ { "medidor": "1111111", "grandeza": "Energia Ativa-Kwh", "seg": "Único", "leitura_anterior": "12.457", "leitura_atual": "12.551", "constante": "800,0000", "medido": "75.200", "normalizado_medidor": 1111111.0, "normalizado_leitura_anterior": 11111.0, "normalizado_leitura_atual": 11111.0, "normalizado_constante": 111.0, "normalizado_medido": 11111.0 } ] }, "energia_ativa_injetada_te": null, "energia_injetada": null, "grupo": "Grupo BT", "itens_fatura": [ { "item": "Energia Elétrica kWh", "unidade": "kWh", "quant": "75.200", "preco_com_tributos": null, "valor": "83.371,09", "pis": "111.11111.11-1", "base": null, "aliquota": "22,000 18341,64", "icms": null, "tarifa": "0,81062" }, { "item": "Contrib Ilum Pública Municipal", "unidade": null, "quant": null, "preco_com_tributos": null, "valor": "1.279,46", "pis": "111.11111.11-1", "base": null, "aliquota": null, "icms": null, "tarifa": null }, { "item": "TOTAL", "unidade": null, "quant": null, "preco_com_tributos": null, "valor": null, "pis": "111.11111.11-1", "base": "83.371,09", "aliquota": null, "icms": null, "tarifa": null } ], "leitura_data": "11/11/1111", "leitura_data_anterior": "25/08/2023", "mes": 9, "normalizado_energia_injetada": 0.0, "normalizado_saldo_energia_instalacao": 0.0, "normalizado_valor": 84650.55, "nota_fiscal": { "numero_serie": "Nº 111111111 Série X", "apresentacao_data": "11/11/1111", "pis": "111.11111.11-1", "cofins": "", "icms": "" }, "numero_fatura": "1111111111111", "proxima_leitura_data": "11/11/1111", "ref_ano": "2023", "ref_mes": "SET", "saldo_energia_instalacao": null, "subgrupo": "Comercial", "subtotais": [], "tributos": { "pis": { "base_calculo": "65.029,45", "aliquota": "1,11%", "valor": "721,82" }, "cofins": { "base_calculo": "65.029,45", "aliquota": "5,15%", "valor": "3.349,01" } }, "valor": "R$84.650,55", "vencimento": "09/10/2023" }], "valor": "R$ 165,11", "vencimento": "02/01/2023", "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-ocr' args = { "login": "VALOR_DO_PARAMETRO_LOGIN", "senha": "VALOR_DO_PARAMETRO_SENHA", "codigo_cliente": "VALOR_DO_PARAMETRO_CODIGO_CLIENTE", "codigo_instalacao": "VALOR_DO_PARAMETRO_CODIGO_INSTALACAO", "mes": "VALOR_DO_PARAMETRO_MES", "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.