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

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



| 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/energisa",
    "parameters": {
      "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.1",
    "requested_at": "2023-01-27T18:30:14.000-03:00",
    "elapsed_time_in_milliseconds": 364,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX18JS/Gg97gqMrcMT4epD8csLQz0SgHEIjcU3RQOpIlf5RK4Plufr6vFaJFKtYZXWY3lKSDKcqPCoQ=="
  },
  "data_count": 1,
  "data": [
    {
      "ano": 2023,
      "aviso": "Exemplo de Texto",
      "classe_subclasse": "RESIDENCIAL / RESIDENCIAL",
      "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.",
        "padrao_de_conexao": "TRIFASICO",
        "instalacao": "1234567890",
        "classificacao": "CONVENCIONAL"
      },
      "codigo_barras": "123456789012345678901234567890123456789012345678",
      "emissao_data": "11/11/1111",
      "energia": {
        "saldo_energia_instalacao": "1081",
        "normalizado_saldo_energia_instalacao": 1081,
        "historico_consumo": [
          {
            "periodo": "JAN/23",
            "convencional": "903"
          },
          {
            "periodo": "DEZ/22",
            "convencional": "892"
          },
          {
            "periodo": "NOV/22",
            "convencional": "1074"
          },
          {
            "periodo": "OUT/22",
            "convencional": "1674"
          },
          {
            "periodo": "SET/22",
            "convencional": "939"
          },
          {
            "periodo": "AGO/22",
            "convencional": "656"
          },
          {
            "periodo": "JUL/22",
            "convencional": "391"
          },
          {
            "periodo": "JUN/22",
            "convencional": "539"
          },
          {
            "periodo": "MAI/22",
            "convencional": "210"
          },
          {
            "periodo": "ABR/22",
            "convencional": ""
          },
          {
            "periodo": "MAR/22",
            "convencional": ""
          },
          {
            "periodo": "FEV/22",
            "convencional": ""
          },
          {
            "periodo": "JAN/22",
            "convencional": ""
          }
        ]
      },
      "energia_injetada": "1.172,00",
      "grupo": "BAIXA TENSÃO",
      "itens_fatura": [
        {
          "cci": "0601",
          "item": "Consumo em kWh",
          "quant": "1.310,00",
          "preco_sem_tributos": "0,621950",
          "preco_com_tributos": "0,787940",
          "valor": "1.032,20",
          "base_icms": "1.032,20",
          "aliq_icms": "18",
          "icms": "185,79",
          "base_piscofins": "846,41",
          "pis": "111.11111.11-1",
          "cofins": "26,01"
        },
        {
          "cci": "0601",
          "item": "Energia Atv Injetada",
          "quant": "1.172,00",
          "preco_sem_tributos": "0,621950",
          "preco_com_tributos": "0,707350",
          "valor": "-829,02",
          "base_icms": "-398,74",
          "aliq_icms": "18",
          "icms": "-71,77",
          "base_piscofins": "-757,24",
          "pis": "111.11111.11-1",
          "cofins": "-23,27"
        },
        {
          "cci": "0601",
          "item": "Energia Atv Injetada mUC 11/2022 mPT",
          "quant": "38,00",
          "preco_sem_tributos": "0,621950",
          "preco_com_tributos": "0,707350",
          "valor": "-26,87",
          "base_icms": "-12,93",
          "aliq_icms": "18",
          "icms": "-2,33",
          "base_piscofins": "-24,55",
          "pis": "111.11111.11-1",
          "cofins": "-0,75"
        }
      ],
      "leitura_data": "11/11/1111",
      "leitura_data_anterior": "02/12/2022",
      "mes": 1,
      "normalizado_valor": 176.31,
      "nota_fiscal": {
        "pis": "111.11111.11-1",
        "cofins": "3,0729%"
      },
      "proxima_leitura_data": "11/11/1111",
      "ref_ano": "2023",
      "ref_mes": "Janeiro",
      "subgrupo": "B1",
      "valor": "176,31",
      "vencimento": "17/01/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/energisa'
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.