---
title: "Criar lançamento (simples ou recorrente)"
method: POST
path: "/v1/lancamentos"
tags: ["Financeiro > Lançamentos"]
---

# Criar lançamento (simples ou recorrente)

`POST /v1/lancamentos`

Cria um novo lançamento financeiro (receita ou despesa), com suporte a **lançamentos recorrentes**.
            
**Lançamento simples:**
- Preencha os campos obrigatórios: Categoria, DataVencimento, Valor, StatusPagamento.
- Omita o objeto "Recorrencia" no request.
            
**Lançamento recorrente:**
Informe o objeto "Recorrencia" com:
- **TipoRecorrencia** (obrigatório):
  - 1 = Mensalmente (máximo 12 parcelas)
  - 2 = Quinzenalmente (máximo 24 parcelas)
  - 3 = Semanalmente (máximo 52 parcelas)
- **NumeroDeParcelas** (obrigatório): Mínimo 2, máximo conforme tipo. Duração total não pode ultrapassar 365 dias.
- **FormaDeAplicarCompetencia** (obrigatório): Define como a data de competência é aplicada nas parcelas (1, 2 ou 3).
- **ConsiderarRecorrenciaPagaNaDataVencimento** (obrigatório): Se true, todas as parcelas são automaticamente marcadas como pagas na data de vencimento (requer FormaPagamentoId).

## Headers

- `estabelecimentoId` string, required

## Request body

- LancamentoCreateRequest
  - `categoria` integer, required
  - `dataPagamento` string, date-time, nullable
  - `dataVencimento` string, date-time, required
  - `dataCompetencia` string, date-time, nullable
  - `descricao` string, nullable
  - `valor` number, double, required
  - `statusPagamento` integer, required — 1 = Pago, 2 = Não Pago
  - `profissionalOuFornecedorDocumento` string, nullable
  - `formaPagamentoId` integer, nullable
  - `recorrencia` RecorrenciaRequest
    - `tipoRecorrencia` integer, required — 1 = Mensalmente, 2 = Quinzenalmente, 3 = Semanalmente
    - `numeroDeParcelas` integer, required — Numero de parcelas (Mensalmente: até 12, Quinzenalmente: até 24, Semanalmente: até 52). A duracao total nao pode ultrapassar 365 dias.
    - `formaDeAplicarCompetencia` integer, required — 1 = Igual para todas as parcelas, 2 = Igual a data de pagamento de cada parcela, 3 = Igual a 30 dias antes da data de pagamento de cada parcela
    - `considerarRecorrenciaPagaNaDataVencimento` boolean — Se true, todas as parcelas da recorrência serão criadas como pagas na data de vencimento, replicando a forma de pagamento do lançamento original

## Response `201`

Created

- LancamentoDetailsDTO
  - `id` integer
  - `tipo` integer
  - `tipoNome` string, nullable
  - `categoria` integer
  - `categoriaNome` string, nullable
  - `grupo` integer
  - `grupoNome` string, nullable
  - `dataPagamento` string, date-time, nullable
  - `dataVencimento` string, date-time
  - `dataCompetencia` string, date-time, nullable
  - `descricao` string, nullable
  - `valor` number, double
  - `statusPagamento` integer
  - `statusPagamentoNome` string, nullable
  - `profissionalOuFornecedorDocumento` string, nullable
  - `profissionalOuFornecedorNome` string, nullable
  - `formaPagamentoId` integer, nullable
  - `formaPagamentoNome` string, nullable
  - `dataCriacao` string, date-time
  - `dataAtualizacao` string, date-time
  - `ativo` boolean
  - `recorrencia` RecorrenciaDTO
    - `idRecorrencia` integer
    - `tipoRecorrencia` integer
    - `tipoRecorrenciaNome` string, nullable
    - `totalParcelas` integer
    - `inicioRecorrencia` string, date-time
    - `fimRecorrencia` string, date-time, nullable
    - `formaDeAplicarCompetencia` integer, nullable
    - `formaDeAplicarCompetenciaNome` string, nullable
    - `recorrenciaAtiva` boolean

## 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/versions/1b5b1e3825ef/schema)