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

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



| 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.20-20240805095103",
    "product": "Imagens",
    "service": "ocr/contas/neoenergia",
    "parameters": {
      "pdf_base64_md5": "2c75dd8328a129c3bf9079292be2aab5"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.1",
    "requested_at": "2024-08-07T08:36:34.000-03:00",
    "elapsed_time_in_milliseconds": 522,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX183OdZPQK0bI/hnUuq3kjGw+GzE6wdrRbLUDq0kxZjER/nOCe/4Fivh+rolytVxoM8SXGtwWFg1rQ=="
  },
  "data_count": 1,
  "data": [
    {
      "ano": "2024",
      "aviso": "Exemplo de Texto",
      "cliente": {
        "nome": "Exemplo de Nome",
        "cpf": "123.456.789-01",
        "normalizado_cpf": "12345678901",
        "cnpj": "12.345.678/9012-34",
        "normalizado_cnpj": "12345678901234",
        "endereco": "Avenida Paulista, 1636. São Paulo. SP. Brasil.",
        "classificacao": "B1 RESIDENCIAL -RESIDENCIAL",
        "padrao_de_conexao": "Conv. Monômia - Trifásico",
        "instalacao": "1234567890"
      },
      "codigo_barras": "123456789012345678901234567890123456789012345678",
      "energia": {
        "historico_consumo": [
          {
            "periodo": "MAR24",
            "kwh": "210",
            "dias": "31"
          },
          {
            "periodo": "FEV24",
            "kwh": "204",
            "dias": "28"
          },
          {
            "periodo": "JAN24",
            "kwh": "239",
            "dias": "33"
          },
          {
            "periodo": "DEZ23",
            "kwh": "221",
            "dias": "30"
          },
          {
            "periodo": "NOV23",
            "kwh": "226",
            "dias": "32"
          },
          {
            "periodo": "OUT23",
            "kwh": "227",
            "dias": "29"
          },
          {
            "periodo": "SET23",
            "kwh": "242",
            "dias": "30"
          },
          {
            "periodo": "AGO23",
            "kwh": "266",
            "dias": "33"
          },
          {
            "periodo": "JUL23",
            "kwh": "219",
            "dias": "30"
          },
          {
            "periodo": "JUN23",
            "kwh": "290",
            "dias": "31"
          },
          {
            "periodo": "MAI23",
            "kwh": "260",
            "dias": "30"
          },
          {
            "periodo": "ABR23",
            "kwh": "246",
            "dias": "29"
          },
          {
            "periodo": "MAR23",
            "kwh": "266",
            "dias": "31"
          }
        ],
        "consumo": {
          "medidor": "1111111",
          "grandeza": "Energia Ativa-Kwh",
          "postos_horarios": "Único",
          "leitura_anterior": "21.760,00",
          "leitura_atual": "21.970,00",
          "constante_medidor": "1,00000",
          "consumo_kwh": "210,00"
        }
      },
      "itens_fatura": [
        {
          "item": "Consumo-TUSD",
          "unidade": "kWh",
          "quantidade": "210,00",
          "preco_tributado": "0,50897410",
          "valor_item": "106,88",
          "pis_cofins": "4,48",
          "base_icms": "106,88",
          "aliquota_icms": "18,00",
          "icms": "19,24",
          "tarifa_unit": "0,39599000"
        },
        {
          "item": "Consumo-TE",
          "unidade": "kWh",
          "quantidade": "210,00",
          "preco_tributado": "0,50897410",
          "valor_item": "106,88",
          "pis_cofins": "4,48",
          "base_icms": "79,14",
          "aliquota_icms": "18,00",
          "icms": "14,24",
          "tarifa_unit": "0,39599000"
        },
        {
          "item": "Ilum. Púb. Municipal",
          "unidade": "",
          "quantidade": "",
          "preco_tributado": "0,50897410",
          "valor_item": "106,88",
          "pis_cofins": "4,48",
          "base_icms": "",
          "aliquota_icms": "18,00",
          "icms": "",
          "tarifa_unit": "0,39599000"
        },
        {
          "item": "Multa-NF 110793289",
          "unidade": "",
          "quantidade": "",
          "preco_tributado": "0,50897410",
          "valor_item": "106,88",
          "pis_cofins": "4,48",
          "base_icms": "",
          "aliquota_icms": "18,00",
          "icms": "",
          "tarifa_unit": "0,39599000"
        },
        {
          "item": "Juros-NF 110793289",
          "unidade": "",
          "quantidade": "",
          "preco_tributado": "0,50897410",
          "valor_item": "106,88",
          "pis_cofins": "4,48",
          "base_icms": "",
          "aliquota_icms": "18,00",
          "icms": "",
          "tarifa_unit": "0,39599000"
        },
        {
          "item": "IPCA-NF-110793289",
          "unidade": "",
          "quantidade": "",
          "preco_tributado": "0,50897410",
          "valor_item": "106,88",
          "pis_cofins": "4,48",
          "base_icms": "",
          "aliquota_icms": "18,00",
          "icms": "",
          "tarifa_unit": "0,39599000"
        }
      ],
      "leitura_anterior_data": "11/11/1111",
      "leitura_data": "11/11/1111",
      "leitura_proxima_data": "11/11/1111",
      "mes": "03",
      "normalizado_valor": 210.97,
      "nota_fiscal": {
        "numero": "1111111111",
        "chave": "111111111111",
        "protocolo": "SPP1111111111",
        "emissao_data": "11/11/1111"
      },
      "numero_dias": "31",
      "tributos": [
        {
          "nome_tributo": "PIS",
          "base_calculo": "152,53",
          "aliquota": "0,91",
          "valor_tributo": "1,38"
        },
        {
          "nome_tributo": "PIS",
          "base_calculo": "152,53",
          "aliquota": "4,21",
          "valor_tributo": "1,38"
        },
        {
          "nome_tributo": "PIS",
          "base_calculo": "186,02",
          "aliquota": "18,00",
          "valor_tributo": "1,38"
        }
      ],
      "valor": "210,97",
      "vencimento": "14/03/2024"
    }
  ],
  "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/neoenergia'
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.
