## OCR / Contas / RGE</h3>
Extrai dados via OCR do PDF de conta de energia elétrica da RGE.

### Request</h4>
URL for POST: `https://api.infosimples.com/api/v2/imagens/ocr/contas/rge`



| 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.6-20230412152345",
    "product": "Imagens",
    "service": "ocr/contas/rge",
    "parameters": {
      "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.1",
    "requested_at": "2023-04-20T09:06:11.000-03:00",
    "elapsed_time_in_milliseconds": 304,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX1/yNz9KtCby2Y5E0WwE5k4Yb+Q4mfjaF7HJMx+/d+b4nV3ob9RtfoGYsJkAXFc13NSAKSfHiMjWdA=="
  },
  "data_count": 1,
  "data": [
    {
      "ano": 2023,
      "aviso": "Exemplo de Texto",
      "cliente": {
        "cpf": "123.456.789-01",
        "normalizado_cpf": "12345678901",
        "cnpj": "12.345.678/9012-34",
        "normalizado_cnpj": "12345678901234",
        "nome": "Exemplo de Nome",
        "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.",
        "instalacao": "1234567890",
        "classificacao": "Convencional B3 Comercial Atacadista / Varejista",
        "fornecimento": "11111111111"
      },
      "codigo_barras": "123456789012345678901234567890123456789012345678",
      "energia": {
        "consumo": [
          {
            "descricao": "Exemplo de descrição",
            "unidade": "kWh",
            "quantidade_faturada": "227,0000",
            "tarifa_aneel": "0,43754000",
            "tarifa_com_tributos": "0,55255507",
            "valor_total": "125,43",
            "base_icms": "125,43",
            "aliquota_icms": "17,00",
            "icms": "21,32",
            "pis": "111.11111.11-1",
            "cofins": "3,95"
          },
          {
            "descricao": "Exemplo de descrição",
            "unidade": "kWh",
            "quantidade_faturada": "227,0000",
            "tarifa_aneel": "0,26162000",
            "tarifa_com_tributos": "0,33039648",
            "valor_total": "75,00",
            "base_icms": "75,00",
            "aliquota_icms": "17,00",
            "icms": "12,75",
            "pis": "111.11111.11-1",
            "cofins": "2,36"
          }
        ],
        "outros_debitos": [
          {
            "descricao": "Exemplo de descrição",
            "valor_total": "23,07"
          }
        ],
        "historico_consumo": [
          {
            "mes_ano": "ABR 23",
            "kwh": "227",
            "dias": "29"
          },
          {
            "mes_ano": "MAR 23",
            "kwh": "293",
            "dias": "32"
          },
          {
            "mes_ano": "FEV 23",
            "kwh": "283",
            "dias": "29"
          },
          {
            "mes_ano": "JAN 23",
            "kwh": "275",
            "dias": "28"
          },
          {
            "mes_ano": "DEZ 22",
            "kwh": "314",
            "dias": "31"
          },
          {
            "mes_ano": "NOV 22",
            "kwh": "320",
            "dias": "33"
          },
          {
            "mes_ano": "OUT 22",
            "kwh": "282",
            "dias": "30"
          },
          {
            "mes_ano": "SET 22",
            "kwh": "299",
            "dias": "31"
          },
          {
            "mes_ano": "AGO 22",
            "kwh": "295",
            "dias": "30"
          },
          {
            "mes_ano": "JUL 22",
            "kwh": "319",
            "dias": "33"
          },
          {
            "mes_ano": "JUN 22",
            "kwh": "260",
            "dias": "29"
          },
          {
            "mes_ano": "MAI 22",
            "kwh": "248",
            "dias": "30"
          },
          {
            "mes_ano": "ABR 22",
            "kwh": "296",
            "dias": "29"
          }
        ],
        "medidor": [
          {
            "numero_medidor": "1111111",
            "grandeza": "Energia Ativa-kWh",
            "postos_horarios": "único",
            "leitura_anterior": "8934",
            "leitura_atual": "9161",
            "constante_medidor": "1,00",
            "consumo_kwh": "227"
          }
        ]
      },
      "leituras": {
        "leitura_anterior_data": "11/11/1111",
        "leitura_atual_data": "11/11/1111",
        "proxima_leitura_data": "11/11/1111",
        "dias_leitura": "29"
      },
      "mes": 4,
      "normalizado_valor_total": 223.5,
      "nota_fiscal": {
        "numero": "1111111111",
        "data_emissao": "1111-11-11",
        "chave": "111111111111",
        "protocolo": "SPP1111111111"
      },
      "ref_ano": "2023",
      "ref_mes": "ABR",
      "tributos": [
        {
          "tributo": "ICMS",
          "base_calculo": "200,43",
          "aliquota": "17,00",
          "valor_total": "34,07"
        },
        {
          "tributo": "PIS/PASEP",
          "base_calculo": "166,36",
          "aliquota": "0,81",
          "valor_total": "1,34"
        },
        {
          "tributo": "COFINS",
          "base_calculo": "166,36",
          "aliquota": "3,79",
          "valor_total": "6,31"
        }
      ],
      "valor_total": "223,50",
      "vencimento": "14/04/2023"
    }
  ],
  "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/rge'
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 <a href="mailto:suporte@infosimples.com.br">suporte@infosimples.com.br</a> and receive help from our highly qualified technical team.