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

# Billing Recovery

`POST /api/v1/billing/recovery`

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

## Request body

- RecuperacaoIn
  - `parcelas` ParcelaIn[], required
    - `competencia` string, required: AAAA-MM
    - `valor_rs` number, required: valor recebido indevidamente, em módulo
    - `descricao` string
  - `data_constatacao` string, required: AAAA-MM-DD — é ela que resolve o alcance
  - `data_calculo` string, nullable
  - `ipca` object: competência AAAA-MM → variação % do mês
  - `atribuicao` 'distribuidora' | 'consumidor' | 'terceiro'
  - `sentido` 'a_maior' | 'a_menor'
  - `juros_am` number: juros ao mês (%)
  - `dobro` boolean, nullable: None = o padrão do regime; nunca conveniência
  - `regime_alcance` 'vigente' | 'literal'
  - `comp_referencia` string, nullable

## Response `200`

Successful Response

- RecuperacaoOut: A cascata do art. 323, § 2º na ordem LITERAL (dobro → IPCA sobre o dobrado → juros sobre o atualizado), com as DUAS leituras do termo inicial dos juros lado a lado: o núcleo não escolhe por quem vai protocolar.
  - `atribuicao` string, required
  - `sentido` string, required
  - `alcance_ciclos` integer, required
  - `alcance_fundamento` string, required
  - `regime_alcance` string, required
  - `alcance_alternativo` integer, nullable
  - `total_alternativo_rs` object, nullable
  - `dobro_devido` boolean, required
  - `juros_am` number, required
  - `principal_rs` number, required
  - `principal_no_alcance_rs` number, required
  - `principal_precluso_rs` number, required
  - `dobrado_rs` number, required
  - `atualizado_rs` number, required
  - `juros_rs` object, required
  - `total_rs` object, required
  - `divergencia_juros_rs` number, required
  - `prazo_devolucao` string, required
  - `parcelas` ParcelaOut[]
    - `competencia` string, required
    - `descricao` string, required
    - `valor_rs` number, required
    - `no_alcance` boolean, required
    - `meses_ate_constatacao` integer, required
    - `dobro_aplicado` boolean, required
    - `valor_dobrado` number, required
    - `fator_ipca` number, required
    - `valor_atualizado` number, required
    - `juros_rs` object, required
    - `total_rs` object, required
    - `ipca_faltante` string[]
  - `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)