---
title: "Inativar lançamento (simples ou recorrente)"
method: PATCH
path: "/v1/lancamentos/{lancamentoId}/inativar"
tags: ["Financeiro > Lançamentos"]
---

# Inativar lançamento (simples ou recorrente)

`PATCH /v1/lancamentos/{lancamentoId}/inativar`

Marca um lançamento financeiro como inativo (soft delete). O lançamento não é removido permanentemente do banco de dados e pode ser consultado usando o filtro apenasAtivos=false.
            
**Inativação de lançamento simples:**
- Omita o request body ou envie InativarEsteERecorrentesFuturos=false.
- Inativa apenas o lançamento especificado.
            
**Inativação de lançamento recorrente (operação em lote):**
Envie no request body:
- **InativarEsteERecorrentesFuturos** (opcional):
  - **true**: Inativa o lançamento atual **e todas as parcelas futuras** da recorrência (DataVencimento >= data do lançamento atual).
  - **false ou omitido**: Inativa **apenas o lançamento atual**.
            
**Validações:**
- Lançamentos já inativos não podem ser inativados novamente.
- Apenas categorias que permitem exclusão podem ser inativadas.
- Se o lançamento não pertence a uma recorrência e você informar InativarEsteERecorrentesFuturos=true, a validação retornará erro.

## Path parameters

- `lancamentoId` integer, required

## Headers

- `estabelecimentoId` string, required

## Request body

- InativarLancamentoRequest
  - `inativarEsteERecorrentesFuturos` boolean, nullable

## Response `204`

No Content

## Other responses

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

---

[API](https://skmtc.net/trinks/apis/trinks-api.md) · [All operations](https://skmtc.net/trinks/apis/trinks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trinks/trinks-api/revisions/1b5b1e3825ef/schema)