## OCR / Contas / Elektro Extrai dados via OCR do PDF de conta de energia elétrica da Elektro. ### Request URL for POST: `https://api.infosimples.com/api/v2/imagens/ocr/contas/elektro` | Parameter | Description | | ----------- | -------------------------------------------------------------------------------- | | token* | The token that will authenticate and authorize the request. | | pdf_base64* | Arquivo PDF da conta de energia convertido para uma string codificada em Base64. | > * 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", "api_version_full": "2.2.20-20240716121325", "product": "Imagens", "service": "ocr/contas/elektro", "parameters": { "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.1", "requested_at": "2024-07-16T15:51:47.000-03:00", "elapsed_time_in_milliseconds": 518, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX1+vMNGew6Lx7laUQsQwptLjDZnurcW0S3BVswe+e+ORMz85tK2AT6qJKyDad7vUZDaEdPD25IRRMQ==" }, "data_count": 1, "data": [ { "ano": 2024, "aviso": "Exemplo de Texto", "cliente": { "codigo": "111", "cpf": "123.456.789-01", "cnpj": "12.345.678/9012-34", "nome": "Exemplo de Nome", "classificacao": "RESIDENCIAL-MONOFASICO", "tensao_nominal": "/127", "limites_tensao": "117 a 133 / a", "endereco": "Avenida Paulista, 1636. São Paulo. SP. Brasil." }, "codigo_barras": "123456789012345678901234567890123456789012345678", "composicao_fornecimento": { "energia": "R$ 63,87", "normalizado_energia": 63.87, "encargos": "", "normalizado_encargos": 33.16, "distribuicao": "R$ 6,45", "normalizado_distribuicao": 6.45, "tributos": "R$ 23,00", "normalizado_tributos": 23.0, "transmissao": "R$ 13,80", "normalizado_transmissao": 13.8, "perdas": "R$ 6,51", "normalizado_perdas": 6.51 }, "consumo": { "medidor": "1111111", "constante": "1", "leitura_anterior": "33672", "leitura_atual": "33867" }, "controle_n": "11-11111111111111-11", "emissao_data": "11/11/1111", "energia": { "historico_consumo": [ { "periodo": "FEV/24", "kwh": "195.0" }, { "periodo": "JAN/24", "kwh": "0.0" }, { "periodo": "DEZ/23", "kwh": "0.0" }, { "periodo": "NOV/23", "kwh": "0.0" }, { "periodo": "OUT/23", "kwh": "0.0" }, { "periodo": "SET/23", "kwh": "0.0" }, { "periodo": "AGO/23", "kwh": "0.0" }, { "periodo": "JUL/23", "kwh": "0.0" }, { "periodo": "JUN/23", "kwh": "0.0" }, { "periodo": "MAI/23", "kwh": "0.0" }, { "periodo": "ABR/23", "kwh": "0.0" }, { "periodo": "MAR/23", "kwh": "0.0" }, { "periodo": "FEV/23", "kwh": "0.0" } ] }, "informacoes_gerais": "", "itens_fatura": [ { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "30,00", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "0,105667", "valor": "3,17", "base_icms": "3,75", "aliq_icms": "12,00%", "icms": "0,45", "valor_total": "3,62" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "70,00", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "0,181571", "valor": "12,71", "base_icms": "15,07", "aliq_icms": "12,00%", "icms": "1,80", "valor_total": "14,51" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "95,00", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "0,272526", "valor": "25,89", "base_icms": "30,70", "aliq_icms": "12,00%", "icms": "3,68", "valor_total": "29,57" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "30,00", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "0,116000", "valor": "3,48", "base_icms": "4,13", "aliq_icms": "12,00%", "icms": "0,49", "valor_total": "3,97" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "70,00", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "0,199286", "valor": "13,95", "base_icms": "16,54", "aliq_icms": "12,00%", "icms": "1,98", "valor_total": "15,93" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "95,00", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "0,298947", "valor": "28,40", "base_icms": "33,68", "aliq_icms": "12,00%", "icms": "4,04", "valor_total": "32,44" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "17,26", "base_icms": "20,47", "aliq_icms": "12,00%", "icms": "2,45", "valor_total": "19,71" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "18,93", "base_icms": "22,45", "aliq_icms": "12,00%", "icms": "2,69", "valor_total": "21,62" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "", "base_icms": "129,17", "aliq_icms": "3,45%", "icms": "", "valor_total": "4,45" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "", "base_icms": "129,17", "aliq_icms": "0,75%", "icms": "", "valor_total": "0,97" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "", "base_icms": "0,00", "aliq_icms": "0,00%", "icms": "0,00", "valor_total": "8,99" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "", "base_icms": "0,00", "aliq_icms": "0,00%", "icms": "0,00", "valor_total": "-36,19" }, { "codigo": "111", "descricao": "Exemplo de descrição", "quantidade": "", "quantidade_residual": "", "quantidade_faturada": "", "tarifa": "", "valor": "123,79", "base_icms": "", "aliq_icms": "", "icms": "17,58", "valor_total": "119,59" } ], "leitura_anterior_data": "11/11/1111", "leitura_data": "11/11/1111", "leitura_proxima_data": "11/11/1111", "mes": 2, "normalizado_valor": 119.59, "nota_fiscal": { "numero_serie": "Nº 111111111 Série X", "apresentacao_data": "11/11/1111" }, "numero_dias": 30, "tributos": [ { "tributo": "ICMS", "aliquota": "00,00", "base_calculo": "20%", "total": "00,00" } ], "valor": "R$ 119,59", "vencimento": "08/03/2024" } ], "site_receipts": [] } ```` ### Code examples for API integration #### Python ```python # Tested with: Python 3.10.19, Python 3.14.0 import requests import base64 url = 'https://api.infosimples.com/api/v2/imagens/ocr/contas/elektro' args = { "pdf_base64": base64.b64encode(open("path/to/file", "rb").read()).decode("ascii"), "token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO" } response = requests.post(url, args) response_json = response.json() response.close() if response_json['code'] == 200: print("Successful result: ", response_json['data']) elif response_json['code'] in range(600, 799): mensagem = "Unsuccessful result. Read on to learn more: \n" mensagem += "Code: {} ({})\n".format(response_json['code'], response_json['code_message']) mensagem += "; ".join(response_json['errors']) print(mensagem) print("Response headers: ", response_json['header']) ``` ## We are ready to help Still have questions or need help with your integration? Contact us at suporte@infosimples.com.br and receive help from our highly qualified technical team.