Editar lançamento (simples ou recorrente)

Atualiza apenas os campos enviados de um lançamento financeiro existente. Campos não enviados permanecerão inalterados.

Edição de lançamento simples:

  • Envie apenas os campos que deseja alterar.
  • Omita o objeto "RecorrenciaEdicao".

Edição de lançamento recorrente (operação em lote):
Informe o objeto "RecorrenciaEdicao" com:

  • EditarEsteERecorrentesFuturos (opcional):
    • true: Aplica as alterações ao lançamento atual e a todas as parcelas futuras da recorrência (DataVencimento >= data do lançamento atual).
    • false ou omitido: Aplica alterações apenas ao lançamento atual (comportamento de edição individual).

Validações:

  • Lançamentos inativos não podem ser editados.
  • Categorias que não permitem edição recusam a alteração.
  • Se o lançamento não pertence a uma recorrência e você informar EditarEsteERecorrentesFuturos=true, a validação retornará erro.
  • Para marcar como pago (StatusPagamento = 1), envie FormaPagamentoId, Valor e DataPagamento no mesmo corpo. StatusPagamento = 2 apaga a data e a forma de pagamento.
  • Em lote, StatusPagamento, DataVencimento, DataPagamento e DataCompetencia não são aceitos, e parcelas inativas não são alteradas.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required
Body Params
int32 | null
date-time | null
date-time | null
date-time | null
string | null

Texto vazio apaga a descrição; omitida mantém a atual

double | null
int32 | null

1 = Pago, 2 = Não Pago. 2 apaga a data e a forma de pagamento; 1 exige FormaPagamentoId e Valor no mesmo corpo

string | null

CPF ou CNPJ de profissional ativo ou fornecedor. Texto vazio não remove o vínculo atual

int32 | null

O id de GET /v1/formaspagamentos

recorrenciaEdicao
object
Headers
string
required
Responses
204

Sucesso, sem corpo

Errors

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json