---
title: "Ajustar número de parcelas de uma recorrência (estender ou reduzir)"
method: PATCH
path: "/v1/lancamentos/recorrencias/{recorrenciaId}/ajustarparcelas"
tags: ["Financeiro > Lançamentos"]
---

# Ajustar número de parcelas de uma recorrência (estender ou reduzir)

`PATCH /v1/lancamentos/recorrencias/{recorrenciaId}/ajustarparcelas`

## Request

- Base URL: `https://api.trinks.com`
- URL: `https://api.trinks.com/v1/lancamentos/recorrencias/{recorrenciaId}/ajustarparcelas`
- Auth: API key in header `X-Api-Key`

Permite ajustar o número total de parcelas de uma recorrência existente, **estendendo** (criando novas parcelas futuras) ou **reduzindo** (removendo parcelas futuras).
            
**Estender recorrência (aumentar parcelas):**
- Informe um valor de NovoNumeroDeParcelas **maior** que o número atual.
- O sistema cria novas parcelas futuras automaticamente, mantendo o padrão da recorrência (tipo, intervalo, competência).
- Exemplo: Recorrência de 6 parcelas → ajustar para 10 parcelas = cria 4 novas parcelas futuras.
            
**Reduzir recorrência (diminuir parcelas):**
- Informe um valor de NovoNumeroDeParcelas **menor** que o número atual.
- O sistema **remove parcelas futuras** (DataVencimento > hoje), mesmo se estiverem marcadas como pagas.
- Exemplo: Recorrência de 12 parcelas → ajustar para 8 parcelas = remove as 4 últimas parcelas, independente do status do pagamento.
            
**Limites:**
- **Mensalmente**: Máximo 12 parcelas
- **Quinzenalmente**: Máximo 24 parcelas
- **Semanalmente**: Máximo 52 parcelas
- **Duração total**: Não pode ultrapassar 365 dias
- **Mínimo**: 2 parcelas (recorrências com menos de 2 parcelas não fazem sentido)
            
**Validações:**
- NovoNumeroDeParcelas deve respeitar os limites do tipo de recorrência.

## Path parameters

- `recorrenciaId` integer, required

## Headers

- `estabelecimentoId` string, required

## Request body

- AjustarParcelasRecorrenciaRequest
  - `novoNumeroDeParcelas` integer, required: Novo numero de parcelas (Mensalmente: até 12, Quinzenalmente: até 24, Semanalmente: até 52). A duracao total nao pode ultrapassar 365 dias.

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/trinks/apis/trinks-api.md) - [All operations](https://skmtc.dev/trinks/apis/trinks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trinks/apis/trinks-api/revisions/1b5b1e3825ef?raw)
