---
title: "Sc Study"
method: POST
path: "/api/v1/sc/study"
tags: ["curto"]
---

# Sc Study

`POST /api/v1/sc/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/sc/study`
- Auth: none declared

O estudo do ponto: a MÁXIMA (que dimensiona o equipamento) e a MÍNIMA
(que ajusta a sensibilidade da proteção) na mesma resposta. Elas são
procedimentos DIFERENTES do §7.1.2 — c_min, fatores de correção iguais a 1,
motores desprezados e cabo corrigido pela temperatura —, e devolver só uma
obrigaria a tela a escolher qual apresentar.

## Request body

- ScStudyIn: As entradas do `short_circuit.calcular_curto` — a topologia é Fonte → (Transformador) → (Reator) → (Cabo) → ponto de cálculo, cada elemento opcional.
  - `Vn_kV` number, required: tensão nominal da fonte (kV)
  - `Scc_MVA` number, nullable
  - `Icc_rede_kA` number, nullable
  - `XR_rede` number
  - `Icc_1ph_rede_kA` number, nullable
  - `XR_1ph_rede` number, nullable
  - `tipo_aterramento` 'solido' | 'resistivo' | 'isolado'
  - `Rn_ohm` number
  - `usar_trafo` boolean
  - `Sn_kVA` number
  - `Vcc_pct` number: impedância percentual Z (%)
  - `Pcu_W` number
  - `Vn2_kV` number
  - `XR_trafo` number, nullable: da plaqueta; PREVALECE sobre o Pcu
  - `U_rT_HV_kV` number, nullable: tensão ATRIBUÍDA
  - `U_rT_LV_kV` number, nullable
  - `usar_reator` boolean
  - `reator_ukr_pct` number
  - `reator_irr_A` number
  - `usar_cabo` boolean
  - `secao_mm2` number
  - `material` 'Cu' | 'Al'
  - `comprimento_m` number
  - `num_conductors` integer
  - `T_op` number: temperatura do cabo (°C) — 20 na MÁXIMA
  - `motores` MotoresIn: Grupo de motores na barra de cálculo (§6.10). Eles ENTRAM na corrente máxima e são DESPREZADOS na mínima (§7.1.2, item 4) — não é opção da tela.
    - `P_kW` number, required: potência somada do grupo (kW)
    - `n` integer: número de motores
    - `cos_phi` number
    - `rendimento` number
    - `Xd_sub_pu` number: reatância subtransitória (pu)
    - `RX_ratio` number, nullable: None = classe do §6.10
  - `Tk_s` number, nullable: duração da falta; sem ela não há Ith a reportar
  - `theta_e_C` number
  - `c_factor` number, nullable: o fator de tensão c NO PONTO de falta na corrente MÁXIMA (nulo = Tabela 1 da IEC 60909-0). A fonte segue com o c do ponto de conexão (Fórmula 4). 1,0 com `aplicar_kt=False` = a base de tensão nominal, FORA do §7.1.2 — as premissas dizem. A mínima não muda
  - `aplicar_kt` boolean: a correção K_T do §6.3.3 no transformador, na corrente MÁXIMA; False = sem correção (fora do §7.1.2). A mínima nunca a aplica

## Response `200`

Successful Response

- ScStudyOut: O estudo de UM ponto: os DOIS procedimentos do §7.1.2 lado a lado, porque eles decidem coisas diferentes — a máxima dimensiona o equipamento e a mínima ajusta a sensibilidade da proteção. Devolver só uma delas obrigaria a tela a escolher, e a escolha não é da tela.
  - `tensao_referencia_kV` number, required
  - `maxima` CorrentesOut, required: A família de correntes de UM procedimento (§7.1.2 máxima OU mínima).
    - `Icc_3ph_kA` number, required
    - `Icc_2ph_kA` number, required
    - `Icc_1ph_kA` number, required
    - `Icc_2ph_terra_kA` number, required: bifásica-terra, corrente de FASE (§7.4)
    - `Icc_terra_kA` number, required: bifásica-terra, corrente de TERRA
    - `ip_kA` number, required
    - `ip_1ph_kA` number, required
    - `ip_2ph_terra_kA` number, required
    - `Iassi_kA` number, required: RMS assimétrica — convenção ANSI/IEEE C37.010
    - `Ith_kA` number, nullable: Cláusula 14; None sem duração informada
    - `XR_total` number, required
    - `kappa` number, required
    - `m_dc` number, nullable: parcela CC do Ith; só existe com duração informada
    - `n_ac` number, nullable
    - `c_factor` number, required
    - `I_motor_kA` number
  - `minima` CorrentesOut, required: A família de correntes de UM procedimento (§7.1.2 máxima OU mínima).
    - `Icc_3ph_kA` number, required
    - `Icc_2ph_kA` number, required
    - `Icc_1ph_kA` number, required
    - `Icc_2ph_terra_kA` number, required: bifásica-terra, corrente de FASE (§7.4)
    - `Icc_terra_kA` number, required: bifásica-terra, corrente de TERRA
    - `ip_kA` number, required
    - `ip_1ph_kA` number, required
    - `ip_2ph_terra_kA` number, required
    - `Iassi_kA` number, required: RMS assimétrica — convenção ANSI/IEEE C37.010
    - `Ith_kA` number, nullable: Cláusula 14; None sem duração informada
    - `XR_total` number, required
    - `kappa` number, required
    - `m_dc` number, nullable: parcela CC do Ith; só existe com duração informada
    - `n_ac` number, nullable
    - `c_factor` number, required
    - `I_motor_kA` number
  - `impedancias` object: total, trafo, cabo, reator e fonte
  - `Z_mod_ohm` number, required
  - `K_T` number, nullable: correção do §6.3.3
  - `c_Q` number, required
  - `z0_fonte` string, required
  - `z0_trafo_bloqueado` boolean, required: o delta do Dyn bloqueia a sequência zero de montante
  - `z0_incoerente` boolean
  - `premissas` string[]
  - `norma` string
  - `engine_id` string
  - `validado` string
  - `tier` string

## Other responses

- `422`: entrada recusada pela IEC 60909
- `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)