## OCR / Contas / CEMIG Extrai dados via OCR do PDF de conta de energia elétrica da CEMIG (Companhia Energética de Minas Gerais). ### Request URL for POST: `https://api.infosimples.com/api/v2/imagens/ocr/contas/cemig` | 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/cemig", "parameters": { "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.1", "requested_at": "2023-02-07T11:18:08.000-03:00", "elapsed_time_in_milliseconds": 334, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX19wdpNQJKIh83LUodscthBUxy4DVHIEAVT+JmxhEzvqwV1XU0ArJC9KsoKsYlXHVbYuJkajLrJ9cQ==" }, "data_count": 1, "data": [ { "ano": "2021", "aviso": "Exemplo de Texto", "cliente": { "cpf": "123.456.789-01", "cnpj": "12.345.678/9012-34", "nome": "Exemplo de Nome", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "classe": "Industrial", "subclasse": "Industrial", "modalidade_tarifaria": "THS Verde A4", "instalacao": "1234567890", "numero": "1111111111" }, "codigo_barras": "123456789012345678901234567890123456789012345678", "emissao_data": "11/11/1111", "energia": { "saldo_energia_instalacao": "", "normalizado_saldo_energia_instalacao": 0.0, "bandeiras_tarifarias": [ { "periodo": "AGO/2021", "bandeira": "Band. Verm. P2" }, { "periodo": "AGO/2021", "bandeira": "Band. Verm. P2" } ], "historico_consumo": [ { "periodo": "AGO/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "JUL/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "JUN/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "MAI/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "ABR/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "MAR/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "FEV/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "JAN/21", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "DEZ/20", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "NOV/20", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "OUT/20", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "OUT/20", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" }, { "periodo": "SET/20", "demanda_hp": "0", "demanda_hfp": "0", "energia_hp": "0", "energia_hfp": "0", "energia_hr": "0", "kwh": "", "media_kwh_dia": "0", "dias": "" } ], "adicional_bandeira_tarifaria": "627,38", "cip": "", "valores_faturados": [ { "descricao": "Exemplo de descrição", "quantidade": "10", "preco": "18,96196633", "valor": "189,59", "unidade": "", "piscofins": "0,00", "base_icms": "", "aliq_icms": "", "icms": "", "tarifa": "" }, { "descricao": "Exemplo de descrição", "quantidade": "20", "preco": "15,54881239", "valor": "310,96", "unidade": "", "piscofins": "0,00", "base_icms": "", "aliq_icms": "", "icms": "", "tarifa": "" }, { "descricao": "Exemplo de descrição", "quantidade": "4.620", "preco": "0,56344858", "valor": "2.603,11", "unidade": "", "piscofins": "0,00", "base_icms": "", "aliq_icms": "", "icms": "", "tarifa": "" }, { "descricao": "Exemplo de descrição", "quantidade": "560", "preco": "2,14117095", "valor": "1.199,02", "unidade": "", "piscofins": "0,00", "base_icms": "", "aliq_icms": "", "icms": "", "tarifa": "" }, { "descricao": "Exemplo de descrição", "quantidade": "700", "preco": "0,34875471", "valor": "244,10", "unidade": "", "piscofins": "0,00", "base_icms": "", "aliq_icms": "", "icms": "", "tarifa": "" }, { "descricao": "Exemplo de descrição", "quantidade": "140", "preco": "0,34875471", "valor": "48,80", "unidade": "", "piscofins": "0,00", "base_icms": "", "aliq_icms": "", "icms": "", "tarifa": "" } ] }, "impostos": [ { "imposto": "ICMS", "base_calculo": "4.284,62", "aliquota": "18,00", "valor": "771,21", "normalizado_base_calculo": 4284.62, "normalizado_aliquota": 18.0, "normalizado_valor": 771.21 }, { "imposto": "PASEP", "base_calculo": "3.824,37", "aliquota": "0,79", "valor": "30,18", "normalizado_base_calculo": 3824.37, "normalizado_aliquota": 0.79, "normalizado_valor": 30.18 }, { "imposto": "COFINS", "base_calculo": "3.824,37", "aliquota": "3,64", "valor": "139,16", "normalizado_base_calculo": 3824.37, "normalizado_aliquota": 3.64, "normalizado_valor": 139.16 } ], "informacoes_tecnicas": [], "leitura_anterior_data": "11/11/1111", "leitura_data": "11/11/1111", "leitura_proxima_data": "11/11/1111", "mes": "AGO", "pix_qrcode_url": "https://www.exemplo.com/exemplo-de-url", "valor": "4.595,58", "vencimento": "01/10/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/cemig' 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.