---
title: "Billing Demand"
method: POST
path: "/api/v1/billing/demand"
tags: ["fatura"]
---

# Billing Demand

`POST /api/v1/billing/demand`

## 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/billing/demand`
- Auth: none declared

## Request body

- DemandaIn
  - `ciclos` CicloDemandaIn[], required
    - `competencia` string, required: AAAA-MM
    - `dm_kw` number, required: demanda medida (kW)
  - `demand_rs_kw` number, required: tarifa de demanda (R$/kW), sem tributos
  - `over_rs_kw` number, nullable: tarifa de ultrapassagem; None = 2 × a de demanda
  - `gen_rs_kw` number: tarifa da parcela de geração
  - `loss_mode` 'nenhum' | 'multiplicacao' | 'divisao'
  - `loss_p` number
  - `accessor` 'consumidor' | 'geradora' | 'distribuidora'
  - `tol_pct` number, nullable: None = a do art. 301 pelo acessante
  - `d_ger_kw` number: demanda da central geradora
  - `current_kw` number, nullable: contratada de hoje; None = sem comparação
  - `step_kw` number
  - `band_pct` number: faixa de indiferença (%)
  - `primary_reading` 'faturada' | 'medida'

## Response `200`

Successful Response

- DemandaOut: As DUAS leituras e a recomendação. Quando elas discordam não há número único: o laudo apresenta a faixa e requer a memória de cálculo da parcela de geração — por isso `readings_agree` viaja no contrato.
  - `recommended_kw` number, required
  - `readings_agree` boolean, required
  - `divergence_rs` number, required
  - `leituras` object, required
  - `series_kw` number[], required: as medidas já com o fator de perdas
  - `labels` string[], required
  - `tol_pct` number, required
  - `gen_parcel_zeroed` boolean, required
  - `avisos` string[]
  - `notas` string[]
  - `norma` string
  - `tier` string

## Other responses

- `422`: entrada recusada pela REN 1.000
- `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)