## Contas / Enel / SP / Download + OCR Faz o download e OCR da última conta de energia elétrica disponível na Agência Virtual da Enel, para o estado de São Paulo (SP). ### URL do site - https://portalhome.eneldistribuicaosp.com.br/#/login ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/contas/enel/sp/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_email* | Login_email | | login_senha* | Login_senha | | 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", "api_version_full": "2.2.21-20240911154934", "product": "Consultas", "service": "contas/enel/sp/download-ocr", "parameters": { "login_email_md5": "e379c59a3573be16480533ae3f53ea1b", "login_senha_md5": "e379c59a3573be16480533ae3f53ea1b", "ocr": "1" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.3", "requested_at": "2024-09-12T10:00:04.000-03:00", "elapsed_time_in_milliseconds": 468, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX195du5LIJtbDskDBBEJxlxVhs8aJQYBlrh4Itz3HsmetoWQWTQSVROz48CxgaHryuVwXRm/XPCs+A==" }, "data_count": 1, "data": [ { "contas": [ { "valor": 221.53, "status": "Pendente", "mes_referencia": "09/2024", "vencimento": "24/09/2024", "codigo_barras": "123456789012345678901234567890123456789012345678", "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" } ], "endereco": "Avenida Paulista, 1636. São Paulo. SP. Brasil.", "instalacao": "1234567890", "lista_instalacoes": [ "1234567890", "1234567890", "1234567890" ], "nome": "Exemplo de Nome", "ocr": [ { "classe": "Residencial", "subclasse": "Residencial", "subgrupo": "B1", "ref_mes": "09", "ref_ano": "2024", "mes": 9, "ano": 2024, "valor": "R$221,53", "vencimento": "24/09/2024", "emissao_data": "11/11/1111", "leitura_data": "11/11/1111", "leitura_proxima_data": "11/11/1111", "leitura_anterior_data": "11/11/1111", "codigo_barras": "123456789012345678901234567890123456789012345678", "aviso": "Exemplo de Texto", "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" }, "endereco": "Avenida Paulista, 1636. São Paulo. SP. Brasil.", "energia": { "historico_consumo": [ { "periodo": "SET/24", "kwh": 258, "dias": 32 }, { "periodo": "AGO/24", "kwh": 197, "dias": 31 }, { "periodo": "JUL/24", "kwh": 262, "dias": 30 }, { "periodo": "JUN/24", "kwh": 230, "dias": 31 }, { "periodo": "MAI/24", "kwh": 285, "dias": 30 }, { "periodo": "ABR/24", "kwh": 296, "dias": 31 }, { "periodo": "MAR/24", "kwh": 335, "dias": 30 }, { "periodo": "FEV/24", "kwh": 386, "dias": 29 }, { "periodo": "JAN/24", "kwh": 282, "dias": 32 }, { "periodo": "DEZ/23", "kwh": 324, "dias": 30 }, { "periodo": "NOV/23", "kwh": 258, "dias": 30 }, { "periodo": "OUT/23", "kwh": 320, "dias": 28 }, { "periodo": "SET/23", "kwh": 258, "dias": 33 } ], "saldo_energia_instalacao": "", "energia_injetada": "", "normalizado_energia_injetada": 0.0, "normalizado_saldo_energia_instalacao": 0.0 }, "nota_fiscal": { "pis_pasep": "0,81", "cofins": "3,70", "icms": "18,00" }, "itens_fatura": [ { "item": "USO SIST. DISTR. (TUSD)", "quant": "258,000", "preco_c_tributos": "0,47643", "preco_c_icms": "", "valor": "122,92", "pis_cofins": "4,53", "base_icms": "122,92", "aliq_icms": "18%", "icms": "22,12", "tarifa": "0,37317" }, { "item": "ENERGIA (TE)", "quant": "258,000", "preco_c_tributos": "0,33581", "preco_c_icms": "", "valor": "86,64", "pis_cofins": "3,19", "base_icms": "86,64", "aliq_icms": "18%", "icms": "15,59", "tarifa": "0,26307" }, { "item": "ADIC. BANDEIRA VERMELHA PT. I", "quant": "0,000", "preco_c_tributos": "0,00000", "preco_c_icms": "", "valor": "4,13", "pis_cofins": "0,14", "base_icms": "4,13", "aliq_icms": "18%", "icms": "0,74", "tarifa": "0,00000" }, { "item": "COSIP - SÃO PAULO - MUNICIPAL", "quant": "", "preco_c_tributos": "", "preco_c_icms": "", "valor": "7,84", "pis_cofins": "0,01", "base_icms": "0,00", "aliq_icms": "0%", "icms": "0,00", "tarifa": "" } ], "preco_te": "", "preco_tusd": "", "data_apresentacao": "", "distribuidora": "Eletropaulo Metropolitana Eletricidade de São Paulo S.A", "grupo": "B", "normalizado_valor": 221.53, "normalizado_preco_te": 0.0, "normalizado_preco_tusd": 0.0 } ], "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/enel/sp/download-ocr' args = { "login_email": "VALOR_DO_PARAMETRO_LOGIN_EMAIL", "login_senha": "VALOR_DO_PARAMETRO_LOGIN_SENHA", "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.