## OCR / Contas / Light Extrai dados via OCR do PDF de conta de energia elétrica da Light. ### Request URL for POST: `https://api.infosimples.com/api/v2/imagens/ocr/contas/light` | 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", "product": "Imagens", "service": "ocr/contas/light", "parameters": { "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5" }, "client_name": "Infosimples", "token_name": "Produção", "billable": true, "price": "0.1", "requested_at": "2021-12-03T09:10:15.000-03:00", "elapsed_time_in_milliseconds": 50, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX18xy1HcEkQfBD9RnIxceasaqbGL5qUlxB9Joa9s4FjWeVxx3Kv5+ms1lsmzwANRecf7gh2h8KUMOg==" }, "data_count": 1, "data": [ { "ano": 2021, "aviso": "", "classe_subclasse": "Comercial/Comercial", "cliente": { "cpf": "123.456.789-01", "cnpj": "12.345.678/9012-34", "nome": "Exemplo de Nome", "instalacao": "1234567890", "classificacao": "Convencional", "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": "3.307", "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": "SETEMBRO 2021 - BANDEIRA VERMELHA", "dias": null }, { "bandeira": "OUTUBRO 2021 - BANDEIRA VERMELHA", "dias": null } ], "normalizado_bandeiras_tarifarias": [ { "mes": "SETEMBRO ", "ano": "2021", "bandeira": "BANDEIRA VERMELHA" }, { "mes": "OUTUBRO ", "ano": "2021", "bandeira": "BANDEIRA VERMELHA" } ], "historico_consumo": [ { "periodo": "OUT/21", "kwh": "3.307", "dias": "30" }, { "periodo": "SET/21", "kwh": "3.526", "dias": null }, { "periodo": "AGO/21", "kwh": "2.881", "dias": null }, { "periodo": "JUL/21", "kwh": "2.410", "dias": null }, { "periodo": "JUN/21", "kwh": "2.891", "dias": null }, { "periodo": "MAI/21", "kwh": "3.410", "dias": null }, { "periodo": "ABR/21", "kwh": "4.536", "dias": null }, { "periodo": "MAR/21", "kwh": "5.934", "dias": null }, { "periodo": "FEV/21", "kwh": "5.396", "dias": null }, { "periodo": "JAN/21", "kwh": "5.846", "dias": null }, { "periodo": "DEZ/20", "kwh": "5.689", "dias": null }, { "periodo": "NOV/20", "kwh": "4.442", "dias": null }, { "periodo": "OUT/20", "kwh": "5.015", "dias": null } ], "soma_tarifas_bruta": "1,30023", "soma_tarifas_liquida": "0,83605000", "adicional_bandeira_tarifaria": "291,22", "normalizado_adicional_bandeira_tarifaria": [ { "bandeira": "Bandeira Vermelha", "valor": "291,22" } ], "tarifas_bandeira_tarifaria": [ { "soma_tarifas_liquida": "0,69405", "bandeira": "BANDEIRA VERDE" }, { "soma_tarifas_liquida": "0,70748", "bandeira": "BANDEIRA AMARELA" }, { "soma_tarifas_liquida": "0,83605", "bandeira": "BANDEIRA VERMELHA" } ], "consumo": [ { "medidor": "8548146", "grandeza": "Energia kWh", "seg": "Tarifa Convencional", "leitura_anterior": "10.259", "leitura_atual": "10.376", "constante": "80", "medido": "9.360" } ] }, "energia_injetada": "0", "grupo": "B", "itens_fatura": [ { "item": "Energia Elétrica kWh", "cfop": "5.253", "unidade": "kWh", "quant": "1.204", "preco_unit": "1,30023", "valor": "1.565,72" }, { "item": "Energia Injetada kWh - TUSD", "cfop": "5.949", "unidade": "kWh", "quant": "2.103", "preco_unit": "0,38946", "valor": "-818,95" }, { "item": "Energia Injetada kWh - TE", "cfop": "5.949", "unidade": "kWh", "quant": "2.103", "preco_unit": "0,65675", "valor": "-1.381,00" }, { "item": "Energia Fornecida kWh - TUSD", "cfop": "5.253", "unidade": "kWh", "quant": "2.103", "preco_unit": "0,57274", "valor": "1.204,33" }, { "item": "Energia Fornecida kWh - TE", "cfop": "5.253", "unidade": "kWh", "quant": "2.103", "preco_unit": "0,65675", "valor": "1.381,00" }, { "item": "Contrib Ilum Pública Municipal", "cfop": "", "unidade": "", "quant": "", "preco_unit": "", "valor": "114,30" } ], "leitura_data": "27/10/2021", "leitura_data_anterior": "27/09/2021", "mes": 10, "normalizado_saldo_energia_instalacao": 0.0, "normalizado_valor": 2065.4, "nota_fiscal": { "numero_serie": "Nº 111111111 Série X", "apresentacao_data": "", "pis": "0,660%", "cofins": "3,040%", "icms": "32%" }, "numero_fatura": "1111111111111", "proxima_leitura_data": "26/11/2021", "ref_ano": "2021", "ref_mes": "OUT", "saldo_energia_instalacao": "0", "subgrupo": "B3", "subtotais": [ { "item": "Subtotal Faturamento (veja abaixo)", "valor": "1.565,72" }, { "item": "Subtotal Outros", "valor": "114,30" } ], "tributos": { "pis": { "base_calculo": "7.844,32", "aliquota": "0,76%", "valor": "59,61" }, "cofins": { "base_calculo": "7.844,32", "aliquota": "3,52%", "valor": "276,12" } }, "valor": "R$ 2.065,40", "vencimento": "10/11/2021" } ], "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/light' 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.