---
title: "Pfc Study Route"
method: POST
path: "/api/v1/tools/pfc/study"
tags: ["ferramentas"]
---

# Pfc Study Route

`POST /api/v1/tools/pfc/study`

## Request

- Base URL: `https://app.estudoseletricos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.estudoseletricos.com/api/v1/tools/pfc/study`
- Auth: none declared

## Request body

- PfcIn: Correção de fator de potência (REN ANEEL 1.000) — `reactive.pfc_study`. Sem `tarifa_kwh`/`custo_por_kvar` o estudo sai SEM as contas de dinheiro (multa, economia, payback ficam nulos) — preço não se inventa.
  - `cargas` CargaIn[], required
    - `name` string
    - `P_kW` number, required: potência ativa (kW)
    - `fp` number, required: fator de potência atual
    - `h_dia` number: horas por dia
  - `fp_meta` number: 0,92 é o regulatório
  - `step_kvar` number: degrau comercial do banco
  - `tarifa_kwh` number, nullable: R$/kWh
  - `custo_por_kvar` number, nullable: R$/kvar instalado
  - `V_kV` number, nullable: tensão do banco (kV)
  - `carga_min_pct` number, nullable: carga mínima (%) — checa sobrecorreção
  - `use_catalog` boolean: usar unidades de catálogo
  - `Un_cap_kV` number, nullable: tensão nominal do capacitor
  - `dias_mes` number
  - `postos` PostosIn: A apuração do EREX por POSTO (REN 1.000): a referência 0,92 vale indutiva das 06h às 24h e capacitiva das 00h às 06h — o posto noturno cobra a sobrecorreção do banco fixo em carga leve. Exige a tarifa do reativo.
    - `consumo_dia_kwh` number, required: posto indutivo 06h–24h (kWh/mês)
    - `fp_dia` number, required: FP no posto indutivo
    - `consumo_noite_kwh` number: posto capacitivo 00h–06h (kWh/mês)
    - `fp_noite` number: módulo do FP no posto capacitivo
  - `estagios` EstagiosIn: O banco AUTOMÁTICO em estágios manobrados pelo controlador de FP.
    - `n` integer: número de estágios
    - `esquema` 'linear' | 'binario': linear = estágios iguais · binário = pesos 1:2:4…
  - `manobra` ManobraIn: A manobra do banco (IEEE C37.012): inrush de energização isolada e, no banco automático, a back-to-back entre estágios. Exige a tensão do banco.
    - `Scc_MVA` number, required: potência de curto no ponto do banco
    - `back_to_back` boolean: energizar um estágio com outro em serviço
    - `L_bb_uH` number, nullable: indutância entre estágios (µH); sem ela, a estimativa DECLARADA do núcleo
  - `figura` boolean: o triângulo de potências em PNG, do MESMO gerador do memorial

## Response `200`

Successful Response

- PfcOut
  - `P_kW` number, required
  - `Q_kvar` number, required
  - `S_kVA` number, required
  - `fp_atual` number, required
  - `fp_meta` number, required
  - `Qc_kvar` number, required: reativo necessário para a meta
  - `Qc_com_kvar` number, required: banco comercial adotado
  - `Q_final` number, required
  - `S_final` number, required
  - `kwh_dia` number, nullable
  - `V_kV` number, nullable
  - `In_A` number, nullable: corrente nominal do banco
  - `norma` string, nullable: IEC 60831 (BT) ou 60871 (MT)
  - `multa_mes` number, nullable: None sem tarifa informada
  - `economia_ano` number, nullable
  - `investimento` number, nullable
  - `payback_meses` number, nullable
  - `carga_min_pct` number, nullable
  - `fp_carga_min` number, nullable: FP na carga mínima — sobrecorreção fica visível
  - `q_resid_min` number, nullable
  - `Q_efetivo_kvar` number, nullable
  - `postos` PostosOut
    - `ere_dia` number, required: excedente indutivo (06h–24h), R$/mês
    - `ere_noite` number, required: excedente capacitivo (00h–06h), R$/mês
    - `total` number, required
  - `estagios` EstagiosOut
    - `esquema` string, required
    - `n_estagios` integer, required
    - `estagios_kvar` number[], required
    - `resolucao_kvar` number, required: o menor degrau — a resolução do controlador
    - `n_niveis` integer, required
    - `total_kvar` number, required
  - `manobra` ManobraOut
    - `In_A` number, required
    - `i_pk_iso_kA` number, required: pico do inrush — banco isolado
    - `f_iso_Hz` number, required
    - `ratio_iso` number, required
    - `i_design_A` number, required: corrente de projeto da proteção e do cabo
    - `design_factor` number, required
    - `classe_bt` boolean, required
    - `back_to_back` boolean, required
    - `L_bb_uH` number, nullable
    - `i_pk_bb_kA` number, nullable
    - `f_bb_Hz` number, nullable
    - `needs_reactor` boolean, nullable
    - `notas` string[]
  - `complementos_fora` string[]: COBERTURA: o complemento pedido que não se aplica, e por quê
  - `figura_png_b64` string, nullable: o triângulo de potências — o do memorial
  - `avisos` string[]
  - `tier` string: anon · free · full

## Other responses

- `422`: entrada fora do domínio
- `429`: teto de chamadas

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)