---
title: "Genset Step"
method: POST
path: "/api/v1/tools/genset/step"
tags: ["ferramentas"]
---

# Genset Step

`POST /api/v1/tools/genset/step`

## 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/genset/step`
- Auth: none declared

## Request body

- GensetIn: Degrau de carga no grupo gerador (ISO 8528-5) — `study_genset_step`. Bloco de carga (`step_kVA`) OU partida direta de motor (`motor=True` + `P_kW`).
  - `V_V` number, required: tensão nominal do gerador (V)
  - `Sn_kVA` number, required: potência nominal do gerador (kVA)
  - `xd_pct` number: reatância transitória X'd (%)
  - `XR` number: relação X/R do gerador
  - `step_kVA` number, nullable: degrau em bloco (kVA)
  - `step_pf` number: FP do degrau em bloco
  - `motor` boolean: degrau = partida direta de motor
  - `P_kW` number, nullable: potência do motor (kW)
  - `eta` number
  - `pf` number: FP nominal do motor
  - `ip_in` number: Ip/In do motor
  - `pf_lr` number: FP de rotor bloqueado
  - `cable_mm2` number, nullable: cabo gerador→carga
  - `cable_len_m` number
  - `cable_material` 'Cu' | 'Al'
  - `cable_parallel` integer
  - `iso_class` 'G1' | 'G2' | 'G3' | 'G4'
  - `dv_limit_pct` number, nullable: limite próprio; None = o da classe (G4 exige)

## Response `200`

Successful Response

- GensetOut
  - `V_V` number, required
  - `Sn_kVA` number, required
  - `xd_pct` number, required
  - `XR` number, required
  - `step_kVA` number, nullable
  - `step_pf` number, nullable
  - `step_load_pct` number, nullable
  - `motor_In_A` number, nullable
  - `motor_I_start_A` number, nullable
  - `Z_fonte` ImpedanciaOut, required: Impedância complexa do núcleo, nomeada — é o 'porquê' do afundamento.
    - `R_ohm` number, required
    - `X_ohm` number, required
  - `Z_cabo` ImpedanciaOut, required: Impedância complexa do núcleo, nomeada — é o 'porquê' do afundamento.
    - `R_ohm` number, required
    - `X_ohm` number, required
  - `Z_carga` ImpedanciaOut, required: Impedância complexa do núcleo, nomeada — é o 'porquê' do afundamento.
    - `R_ohm` number, required
    - `X_ohm` number, required
  - `V_term_pu` number, required
  - `V_term_V` number, required
  - `dv_pct` number, required: afundamento transitório (%)
  - `iso_class` string, required
  - `dv_limit_pct` number, required
  - `ok` boolean, required: dv ≤ limite da classe
  - `contactor_ok` boolean, nullable: tensão suficiente para o contator não abrir
  - `max_step_kVA` number, nullable: maior degrau aceitável
  - `max_step_pct` number, nullable
  - `avisos` string[]
  - `norma` string
  - `tier` string: anon · free · full

## Other responses

- `422`: entrada incompleta ou fora da norma
- `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)