## OCR / Contas / Light (Grupo A4) Extrai dados via OCR do PDF de conta de energia elétrica da Light do Grupo A4. ### Request URL for POST: `https://api.infosimples.com/api/v2/imagens/ocr/contas/light/ocr-grupo-a4` | 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/ocr-grupo-a4", "parameters": { "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.1", "requested_at": "2022-10-11T09:55:16.000-03:00", "elapsed_time_in_milliseconds": 401, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX18NBuNDeibbPqtT7g43OxXaIpcu+vgBOmvj8sltZE547+EoL7hmFcutvP8RmFoXX3ZTKe4xx/b+ug==" }, "data_count": 1, "data": [ { "ano": 2022, "aviso": "Exemplo de Texto", "classe": "Comercial", "cliente": { "cpf": "123.456.789-01", "cnpj": "12.345.678/9012-34", "nome": "Exemplo de Nome", "instalacao": "1234567890", "padrao_de_conexao": "TRIFÁSICO", "codigo": "111", "normalizado_cpf": "12345678901", "normalizado_cnpj": "12345678901234" }, "codigo_barras": "123456789012345678901234567890123456789012345678", "debitos": [], "emissao_data": "05/07/2022", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "energia": { "consumo": [ { "seg": "HPT", "leitura_atual": "397", "leitura_anterior": "381", "constante": "0,0240" }, { "seg": "HTF", "leitura_atual": "20", "leitura_anterior": "19", "constante": "2,4000" } ], "demanda": [ { "seg": "HPT", "leitura": "1,0", "constante": "0,0960", "medida": "0,0", "contratada": "0,00" }, { "seg": "HTF", "leitura": "1,0", "constante": "0,0960", "medida": "0,0", "contratada": "200,00" } ], "dmcr": [ { "seg": "HPT", "leitura_atual": "1,0", "constante": "0,0240", "medida": "0,0" }, { "seg": "HTF", "leitura_atual": "33,0", "constante": "0,0240", "medida": "1,0" } ], "ufer": [ { "seg": "HPT", "leitura_atual": "0", "leitura_anterior": "0", "constante": "0,0240", "medida": "0,0" }, { "seg": "HTF", "leitura_atual": "857", "leitura_anterior": "801", "constante": "2,4000", "medida": "137,4" } ], "kva_kq": [ { "seg": "HPT", "leitura_atual": "0", "leitura_anterior": "0", "constante": "0,0240", "medido": "0,0" }, { "seg": "HTF", "leitura_atual": "2", "leitura_anterior": "2", "constante": "2,4000", "medido": "0,0" } ], "bandeiras_tarifarias": [ { "bandeira": "JUNHO 2022 - BANDEIRA VERDE" }, { "bandeira": "JUNHO 2022 - BANDEIRA VERDE" } ], "normalizado_bandeiras_tarifarias": [ { "mes": "JUNHO", "ano": "2022", "bandeira": "BANDEIRA VERDE" }, { "mes": "JUNHO", "ano": "2022", "bandeira": "BANDEIRA VERDE" } ], "historico_consumo": [ { "periodo": "MAI/22", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "ABR/22", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "MAR/22", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "FEV/22", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "JAN/22", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "DEZ/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "NOV/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "OUT/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "SET/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "AGO/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "JUL/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 }, { "periodo": "JUN/21", "consumo_fora_ponta": 0, "consumo_ponta": 0, "demanda_fora_ponta": 0, "demanda_ponta": 100, "consumo_reativo_fora_ponta": 100, "consumo_reativo_ponta": 0, "demanda_reativa_fora_ponta": 0, "demanda_reativa_ponta": 0 } ] }, "grandezas_contratadas": [ { "item": "Demanda", "quant": "1" } ], "itens_fatura": [ { "item": "Demanda Ativa kW HFP/Único", "cfop": "5.253", "quant": "200,0", "valor_unitario": "28,29553692", "valor": "5.659,09", "unidade": "", "pis": "0", "base_icms": "", "aliquota": "", "icms": "", "tarifa": "" }, { "item": "Energia Injetada kWh HFP TUSD", "cfop": "5.949", "quant": "2", "valor_unitario": "0,17730000", "valor": "-0,35", "unidade": "", "pis": "0", "base_icms": "", "aliquota": "", "icms": "", "tarifa": "" }, { "item": "Energia Injetada FP/Único", "cfop": "5.949", "quant": "2", "valor_unitario": "0,42283750", "valor": "-0,83", "unidade": "", "pis": "0", "base_icms": "", "aliquota": "", "icms": "", "tarifa": "" }, { "item": "Energia Reativa kWh HFP/Único", "cfop": "5.949", "quant": "137", "valor_unitario": "0,45927824", "valor": "62,90", "unidade": "", "pis": "0", "base_icms": "", "aliquota": "", "icms": "", "tarifa": "" }, { "item": "Energia Fornecida kWh HFP TUSD", "cfop": "5.949", "quant": "2", "valor_unitario": "0,22162500", "valor": "0,43", "unidade": "", "pis": "0", "base_icms": "", "aliquota": "", "icms": "", "tarifa": "" }, { "item": "Energia Fornecida kWh HFP TE", "cfop": "5.949", "quant": "2", "valor_unitario": "0,42283750", "valor": "0,83", "unidade": "", "pis": "0", "base_icms": "", "aliquota": "", "icms": "", "tarifa": "" } ], "leitura_data": "30/06/2022", "leitura_data_anterior": "31/05/2022", "mes": 6, "micro_geracao": { "energia_gerada": { "ponta": "0", "fora_ponta": "22.354" }, "saldo_total_credito": { "ponta": "1", "fora_ponta": "5" } }, "modalidade_tarifaria": "THS Verde A4", "normalizado_valor": 5722.07, "nota_fiscal": { "numero": "1111111111" }, "numero_fatura": "1111111111111", "proxima_leitura_data": "31/07/2022", "ref_ano": "2022", "ref_mes": "JUN", "subclasse": "Comercial Ger Distribuida", "subgrupo": "A4", "tarifa": { "tipo": "Tarifa Horária THS Verde A4 (sem impostos)", "itens": [ { "item": "DEMANDA", "tusd": "21.86000000" }, { "item": "CONSUMO P VERDE", "tusd": "1.45465000" }, { "item": "CONSUMO FP VERDE", "tusd": "0.51557000" }, { "item": "CONSUMO P AMARELO", "tusd": "1.47339000" }, { "item": "CONSUMO FP AMARELO", "tusd": "0.53431000" }, { "item": "CONSUMO P VERMELHO", "tusd": "1.59665000" }, { "item": "CONSUMO FP VERMELHO", "tusd": "0.65757000" } ] }, "tributos": { "icms": { "base_calculo": "5.722,42", "aliquota": "20%", "valor": "1.144,48" }, "pis": { "base_calculo": "", "aliquota": "0,610%", "valor": "27,91" }, "cofins": { "base_calculo": "", "aliquota": "2,820%", "valor": "129,07" } }, "valor": "5.722,07", "vencimento": "15/07/2022" } ], "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/ocr-grupo-a4' 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.