Guia de Utilização da

API do Setor Elétrico

1

Introdução
Primeiramente, gostaríamos de agradecer o
seu interesse em utilizar a API do Setor Elétrico,
uma iniciativa da ​Way2 Tecnologia​, empresa de
Florianópolis que fornece soluções de software
para vários agentes do Setor Elétrico como
Geradoras, Distribuidoras, Comercializadoras,
Grandes Consumidores e a própria Câmara de
Comercialização de Energia Elétrica
Motivação
Pensamos diariamente aqui na Way2 em criar boas
experiências para nossos clientes e parceiros de
forma bastante aderente ao nosso propósito de
transformar a relação das pessoas e organizações
com a Energia.
Em nossa trajetória de quase 15 anos, percebe-
mos que há uma grande dificuldade de obter de
forma automatizada alguns dados importantes e
frequentemente utilizados pelos agentes do setor
elétrico, como por exemplo as Bandeiras Tarifárias.
Pensando em resolver essa dor e também em
praticar o nosso propósito, criamos a API do Setor
Elétrico para disponibilizar informações relevan-
tes do nosso setor de forma gratuita, organizada e
automatizada.
2
Quais dados estão disponíveis na API?
Nessa fase inicial do projeto, disponibilizamos três serviços de dados:
Bandeiras Tarifárias
Dados das bandeiras tarifárias (Verde, Amarela,
Vermelha e Vermelha 2) e seus custos adicionais
desde Janeiro de 2018. A atualização das
bandeiras é feita mensalmente.
Tarifas das Concessionárias
Dados das tarifas (Grupos A e B) de to-
das as distribuidoras e cooperativas do
país a partir de 2016. A atualização das ta-
rifas é feita mensalmente e os valores são
disponibilizados conforme o site da ANE-
EL, ou seja, sem a incidência de impostos
(PIS/COFINS e ICMS).
33
Preço da Liquidação das Diferenças (Semanal)
Dados do PLD por submercado (N, S, NE e SE/CO)
e patamares (Leve, Médio e Pesado). Os dados
são originados do site da CCEE e são atualizados
semanalmente.
Preço da Liquidação das Diferenças (Horário)
Dados do PLD horário por submercado (N, S, NE e
SE/CO). Os dados são originados do site da CCEE
e são atualizados diariamente.
Horário de Ponta
Dados de horário de ponta (ou horário de pico)
retornado por distribuidora. Os dados são originados
diretamente das distribuidoras.
É preciso algum tipo
de autenticação?
Sim. Para acessar a API do Setor Elétrico,
você precisará de uma chave (token/
apikey) que será enviada pela nossa
equipe logo após o seu cadastro no site
www.apidosetoreletrico.com.br.
Essa chave será utilizada no próprio endereço
da API como um parâmetro junto à tag
“apikey”.
Caso você não tenha recebido, por favor,
entre em contato conosco através do email:
apidosetoreletrico@way2.com.br

4
 {

​Bandeiras Tarifárias “total”: 3,

“items”: [
{
“id”: 23,
É permitido consultar as bandeiras​tarifárias e​suas “flagType”: 0,
tarifas em um período compreendido entre duas “month”: “2019-01-01T00:00:00”,
datas. Para isso, acesse o endpoint: “value”: 0
},
{
“id”: 24,
https://apise.way2.com.br/v1/bandeiras?apikey= “flagType”: 0,
“month”: “2019-02-01T00:00:00”,
“value”: 0
e enviar os seguintes parâmetros na Query String: },
{
datainicial: data inicial do período que se deseja “id”: 25,
“flagType”: 0,
pesquisar. Formato: yyyy-mm-dd.
“month”: “2019-03-01T00:00:00”,
“value”: 0
datafinal: data final do período que se deseja
}
pesquisar. Formato: yyyy-mm-dd. ]
}
Os dois acima parâmetros são​opcionais. Caso
não sejam enviados, será retornada a bandeira do
mês corrente. Código Descrição

0 Bandeira Verde
A seguir está um exemplo de retorno das Bandeiras
1 Bandeira Amarela
entre Jan e Março de 2019 e os códigos da
2 Bandeira Vermelha - Patamar 1
propriedade fl
​ agType​​:
3 Bandeira Vermelha - Patamar 2
 Consulta das
Concessionárias
Todas as concessionárias de energia listadas no site
da Aneel estão presentes nesse serviço. Exemplos:
Celesc, Cemig, Eletropaulo, etc. Os nomes de cada
concessionária podem ser consultados através do
seguinte endpoint (sem parâmetros):

GET https://apise.way2.com.br/v1/agentes?apikey=

Obs.: Conhecer o nome da concessionária é impor-

tante para a consulta das tarifas, serviço descrito no
próximo item.

66
 [
{
“agente”: “CELESC-DIS”,

Consulta de Tarifas
“validadesde”: “2020-08-22T00:00:00.000Z”,
“subgrupo”: “A1”,
“modalidade”: “Azul”,
“acessante”: “ARCELORMITTAL BRASIL (VEGA DO SUL)”,
A partir do nome da concessionária listado no “classe”: “”,
endpoint “agentes”, é possível consultar as suas “subclasse”: “”,
“posto”: “FP”,
tarifas acessando o endpoint: “tarifademandatusd”: “6.56”,
“tarifaconsumotusd”: “49.85”,
“tarifaconsumote”: “260.89”
GET https://apise.way2.com.br/v1/tarifas?apikey= },
{
“agente”: “CELESC-DIS”,
“validadesde”: “2020-08-22T00:00:00.000Z”,
enviando os seguintes parâmetros na Query String:
“subgrupo”: “A1”,
“modalidade”: “Azul”,
agente: nome do agente/concessionária cuja tarifa
“acessante”: “ARCELORMITTAL BRASIL (VEGA DO SUL)”,
será consultada; “classe”: “”,
“subclasse”: “”,
ano: ano do reajuste tarifário. Formato: yyyy. “posto”: “P”,
“tarifademandatusd”: “6.16”,
A seguir está o exemplo do retorno (parcial) desse “tarifaconsumotusd”: “49.85”,
serviço contendo as tarifas da concessionária “tarifaconsumote”: “422.96”
CELESC-DIS no ano de 2020: },

...mais

7
 {

PLD Semanal “total”: 12,

“items”: [
{
Para consultar o PLD semanal,​
​​ é preciso acessar “name”: “SE/CO Pesada”,
“values”: [
o serviço:
{
“dateTime”: “2020-10-01T03:17:37+00:00”,
“value”: 176.84
GET https://apise.way2.com.br/v1/pldsemanal?apikey= }
]
},

e enviar os seguintes parâmetros na Query String: {

“name”: “SE/CO Média”,
datainicial: data inicial do período que se deseja “values”: [
{
pesquisar. Formato: yyyy-mm-dd. “dateTime”: “2020-10-01T03:17:37+00:00”,
“value”: 175.38
datafinal: data final do período que se deseja
}
pesquisar. Formato: yyyy-mm-dd. ]
},
Os dois acima parâmetros são​opcionais. Caso {
não sejam enviados, os preços da semana corrente “name”: “SE/CO Leve”,
serão retornados, conforme mostrado no exemplo “values”: [
{
a​ seguir:
“dateTime”: “2020-10-01T03:17:37+00:00”,
“value”: 168.78
}

88
 ] { “values”: [
}, “name”: “NE Pesada”, {
{ “values”: [ “dateTime”: “2020-10-01T03:17:37+00:00”,
“name”: “S Pesada”, { “value”: 176.84
“values”: [ “dateTime”: “2020-10-01T03:17:37+00:00”, }
{ “value”: 163.05 ]
“dateTime”: “2020-10-01T03:17:37+00:00”, } },
“value”: 176.84 ] {
} }, “name”: “N Média”,
] { “values”: [
}, “name”: “NE Média”, {
{ “values”: [ “dateTime”: “2020-10-01T03:17:37+00:00”,
“name”: “S Média”, { “value”: 175.38
“values”: [ “dateTime”: “2020-10-01T03:17:37+00:00”, }
{ “value”: 161.61 ]
“dateTime”: “2020-10-01T03:17:37+00:00”, } },
“value”: 175.38 ] {
} }, “name”: “N Leve”,
] { “values”: [
}, “name”: “NE Leve”, {
{ “values”: [ “dateTime”: “2020-10-01T03:17:37+00:00”,
“name”: “S Leve”, { “value”: 168.78
“values”: [ “dateTime”: “2020-10-01T03:17:37+00:00”, }
{ “value”: 158.02 ]
“dateTime”: “2020-10-01T03:17:37+00:00”, } }
“value”: 168.78 ] ]
} }, }
] {
}, “name”: “N Pesada”,

9
 {
“statusCode”: 200,

PLD Horário “body”: [

{
“dia”: “2020-10-01T00:00:00.000Z”,
Para consultar o PLD ​​horário,​é preciso acessar “hora”: 0,
“submercado”: “NORDESTE”,
o serviço:
“preco”: “166.18”
},
{
GET https://apise.way2.com.br/v1/pldhorario?apikey= “dia”: “2020-10-01T00:00:00.000Z”,
“hora”: 0,
“submercado”: “NORTE”,

e enviar os seguintes parâmetros na Query String: “preco”: “178.11”

},
dia: dia que se deseja pesquisar. Formato: yyyy- {
“dia”: “2020-10-01T00:00:00.000Z”,
mm-dd. “hora”: 0,
“submercado”: “SUDESTE”,
submercado: submercado que se deseja
“preco”: “178.11”
pesquisar. Valores aceitos: NORDESTE, NORTE, },
SUDESTE, SUL. {
“dia”: “2020-10-01T00:00:00.000Z”,
Os dois acima parâmetros são​opcionais. Caso “hora”: 0,
não sejam enviados, os 96 preços do dia corrente “submercado”: “SUL”,
“preco”: “178.11”
serão retornados, conforme mostrado no exemplo
},
a​ seguir:
...mais
 Horário de Ponta
Para consultar os horários de ponta,​é preciso
acessar o serviço(sem parâmetros):

GET
https://apise.way2.com.br/v1/horarios-de-ponta?apikey=

Obs.: Conhecer o nome da distribuidora é

importante para a consulta dos horários de
ponta a fim de distinguir as informações uma
das outras.

11
Queremos o
seu feedback!
Esperamos que você aproveite ao máximo a API do Setor
Elétrico e que a utilização colabore para os resultados da
sua empresa.
Esta é uma iniciativa gratuita da Way2 Technology, entretanto,
é um projeto colaborativo, significa que queremos o seu
feedback para ajudar no aprimoramento da API, tornando-a
cada vez mais robusta, inteligente e eficaz para todos os
agentes do setor.
Caso tenha uma sugestão de melhoria, por favor, encaminhe
um e-mail para ​​apidosetoreletrico@way2.com.br

12
 Somos uma empresa de tecnologia comprometida
com o desenvolvimento do setor elétrico e para isso
disponibilizamos soluções de medição e gestão de
energia em tempo real.
Há 15 anos no mercado atendemos geradoras de
diferentes fontes de energia, distribuidoras, comer-
cializadoras e grandes consumidores em todo o
Brasil, nossas tecnologias somadas a um time de
especialistas nos torna referência no setor.
Focados no sucesso de nossos clientes temos o
compromisso, através da aplicação da inteligência
de dados, de incrementar a eficiência operacional,
assegurar a adequação regulatória e oferecer a me-

SOMOS
lhor experiência em todas as interações com o nosso
#timedeelite.
A energia elétrica é invisível e complexa de geren-
ciar, existindo ainda muita margem para melhorar a
eficiência das empresas do setor elétrico e dos gran-

A WAY2
des consumidores de energia. Nosso trabalho não
é apenas gerenciar a energia, mas transformar a
relação das pessoas e das empresas com a energia.
Conheça a Way2 >>
14