Pular para o conteúdo principal

Dimensionador e Range de Preços

Recurso utilizado para consultar a dimensão de um sistema fotovoltaico e consultar um range (preço mínimo, médio e máximo) de preços a partir de alguns parâmetros.

Calcular o Porte e Range de Preços do Sistema

POST
/sizer-prices

Cabeçalho

É necessário comprovar autorização com o access_token para realizar essa operação.

Authorization: Bearer access_token

accept: application/json

Exemplo de headers

{
"Authorization": "Bearer your_jwt_access_token",
"accept": "application/json"
}

Parâmetros

uf string Opcional *
Unidade Federativa do sistema.

municipalitie string Opcional *
Município do sistema.

cep string Opcional *
Código de Endereçamento Postal - CEP.

client_type string Obrigatório
Tipo do cliente que por padrão é residencial.

connection_type string Obrigatório
Tipo de conexão do cliente que por padrão é bifasica.

average_bill_value number Obrigatório
Média do valor (R$) da conta de energia dos últimos 12 meses.

* uf e municipalitie ou cep ou apenas uf deverão ser fornecidos.

Exemplo de corpo de requisição - cidade e estado

{
"uf": "MG",
"municipalitie": "Itajubá",
"client_type": "residencial",
"connection_type": "bifasica",
"average_bill_value": 500
}

Exemplo de corpo de requisição - cep

{
"cep": "01153000",
"client_type": "residencial",
"connection_type": "bifasica",
"average_bill_value": 500
}

Resposta

Valores de Resposta

kwp number Obrigatório
Porte do sistema em kwp.

min_price number - Obrigatório
Preço mínimo calculado.

price_average number - Obrigatório
Preço médio calculado.

max_price number - Obrigatório
Preço máximo calculado.

protocol string Obrigatório
Identificador único da requisição.

Código de Status de Resposta

CódigoDescrição
200Sucesso
400Erro de dados enviados pelo cliente
404Erro ao encontrar dado utilizado no cálculo do porte/preço dos kits (exemplo: cep, kits, cidade, estado, tarifa e etc)
500Erro do servidor

Exemplo de resposta

{
"kwp": 5.5,
"min_price": 19078.2,
"price_average": 22521.06,
"max_price": 27711.89,
"protocol": "4f822883-cbc5-44b0-9570-b1151ba8f530"
}

Calcular o Porte e o Range de Preços do Sistema com Filtro de Módulos e Inversores

POST
/filter-sizer-prices

Cabeçalho

É necessário comprovar autorização com o access_token para realizar essa operação.

Authorization: Bearer access_token

accept: application/json

Exemplo de headers

{
"Authorization": "Bearer your_jwt_access_token",
"accept": "application/json"
}

Parâmetros

uf string Opcional *
Unidade Federativa do sistema.

municipalitie string Opcional *
Município do sistema.

cep string Opcional *
Código de Endereçamento Postal - CEP.

client_type string Obrigatório
Tipo do cliente que por padrão é residencial.

connection_type string Obrigatório
Tipo de conexão do cliente que por padrão é bifasica.

average_bill_value number Obrigatório
Média do valor (R$) da conta de energia dos últimos 12 meses.

module_brand number
Marca do módulo.

inverter_brand number
Marca do inversor.

* uf e municipalitie ou cep ou apenas uf deverão ser fornecidos.

Exemplo de corpo de requisição - cidade e estado

{
"uf": "MG",
"municipalitie": "Itajubá",
"client_type": "residencial",
"connection_type": "bifasica",
"average_bill_value": 500,
"module_brand": "ja solar",
"inverter_brand": "sungrow"
}

Exemplo de corpo de requisição - cep

{
"cep": "01153000",
"client_type": "residencial",
"connection_type": "bifasica",
"average_bill_value": 500,
"module_brand": "ja solar",
"inverter_brand": "sungrow"
}

Resposta

Valores de Resposta

kwp number Obrigatório
Porte do sistema em kwp.

min_price number - Obrigatório
Preço mínimo calculado.

price_average number - Obrigatório
Preço médio calculado.

max_price number - Obrigatório
Preço máximo calculado.

protocol string Obrigatório
Identificador único da requisição.

filter_modules boolean Obrigatório
Identificador da aplicação de um filtro de módulo.

filter_inverters boolean Obrigatório
Identificador da aplicação de um filtro de inversor.

Código de Status de Resposta

CódigoDescrição
200Sucesso
400Erro de dados enviados pelo cliente
404Erro ao encontrar dado utilizado no cálculo do porte/preço dos kits (exemplo: cep, kits, cidade, estado, tarifa e etc)
500Erro do servidor

Exemplo de resposta

{
"kwp": 7.2,
"min_price": 20581.21,
"price_average": 28163.94,
"max_price": 40588.26,
"protocol": "161001ca-26da-40ab-a604-a053dae2d8f5",
"filter_modules": false,
"filter_inverters": false
}