PUT
Atualizar lançamento

Authorizations

Authorization
string
header
required

HTTP Basic com o token como usuário e o secret como senha: curl -u dpz_tk_…:dpz_sk_…. Crie a chave em https://despezzas.com/settings/api-keys.

Path Parameters

id
string
required

Identificador do recurso.

Example:

"8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b"

Body

application/json

Mesmos campos da criação, todos opcionais: só o que for enviado é alterado. Em séries, edition_type define o alcance.

account_id
string | null

Conta — obrigatório quando não há cartão.

Example:

"3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f"

amount
integer

Valor (positivo). Em centavos.

Example:

25990

category_id
string | null

Categoria.

Example:

"b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"

competence_date
string | null

Competência (Business). null limpa.

Example:

null

contact_id
string | null

Contato (Business). null limpa.

Example:

null

cost_center_id
string | null

Centro de custo (Business). null limpa.

Example:

null

credit_card_id
string | null

Cartão — obrigatório quando não há conta.

Example:

null

currency
string | null

Moeda. Padrão: BRL.

Example:

"BRL"

date
string

Data (YYYY-MM-DD ou ISO 8601).

Example:

"2026-09-15"

description
string | null

Descrição.

Example:

"Compra do mês"

document_number
string | null

Número do documento (Business). null limpa.

Example:

null

edition_date
string | null

Data de referência para edition_type (YYYY-MM-DD).

Example:

null

edition_type
enum<string> | null

Alcance ao editar uma série (recorrência/parcelas). Padrão: THIS.

Available options:
THIS,
THIS_AND_NEXT,
ALL,
null
Example:

null

frequency
enum<string>

Frequência de uma recorrência (type = RECURRENT). Padrão: MONTHLY.

Available options:
DAILY,
WEEKLY,
BIWEEKLY,
MONTHLY,
BIMONTHLY,
QUARTERLY,
SEMIANNUAL,
YEARLY
Example:

"MONTHLY"

installments
integer

Quantidade de parcelas (type = PARCELLED).

Example:

1

is_expense
boolean

true = despesa, false = receita.

Example:

true

is_full_amount
boolean

Se amount é o total a parcelar (senão é o valor de cada parcela).

Example:

false

paid
boolean

Pago/recebido (lançamentos de conta). Padrão: false.

Example:

true

show_on_balance
boolean

Se entra no saldo. Padrão: true.

Example:

true

subcategory_id
string | null

Subcategoria.

Example:

"d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a"

tag_ids
string[]

Tags a aplicar (substitui as atuais).

Example:
title
string

Título.

Example:

"Supermercado Pão de Açúcar"

type
enum<string>

Tipo. Padrão: FIXED.

Available options:
FIXED,
RECURRENT,
PARCELLED,
TRANSFER
Example:

"FIXED"

Response

Sucesso.

amount
integer
required

Valor, sempre positivo — o sinal vem de is_expense. Em centavos.

Example:

25990

createdAt
string<date-time>
required

Criação.

Example:

"2026-09-01T09:00:00.000Z"

date
string<date-time>
required

Data do lançamento.

Example:

"2026-09-15T00:00:00.000Z"

id
string
required

Id do lançamento.

Example:

"8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b"

installments
integer
required

Quantidade de parcelas (1 quando à vista).

Example:

1

is_expense
boolean
required

true = despesa, false = receita.

Example:

true

paid
boolean
required

Pago/recebido.

Example:

true

title
string
required

Título.

Example:

"Supermercado Pão de Açúcar"

type
enum<string>
required

Tipo do lançamento.

Available options:
FIXED,
RECURRENT,
PARCELLED,
TRANSFER
Example:

"FIXED"

updatedAt
string<date-time>
required

Última alteração.

Example:

"2026-09-15T14:32:10.000Z"

account_id
string | null

Conta (lançamentos de conta).

Example:

"3a9e7d21-4b5c-4d6e-8f70-1a2b3c4d5e6f"

bill_id
string | null

Fatura à qual pertence.

Example:

null

billed_at
string<date-time> | null

Data de faturamento (cartão).

Example:

null

category_id
string | null

Categoria.

Example:

"b1a2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"

competence_date
string<date-time> | null

Competência (Business).

Example:

null

connected_transaction_id
string | null

Liga as parcelas/recorrências de uma mesma série.

Example:

null

contact_id
string | null

Contato (Business).

Example:

null

cost_center_id
string | null

Centro de custo (Business).

Example:

null

credit_card_id
string | null

Cartão (lançamentos de cartão — sempre pagos).

Example:

null

currency
string | null

Moeda.

Example:

"BRL"

description
string | null

Descrição livre.

Example:

"Compra do mês"

document_number
string | null

Número do documento (Business).

Example:

null

excluded_dates
string[]

Sempre vazio (campo legado).

Example:
frequency
enum<string>

Frequência (só faz sentido em RECURRENT).

Available options:
DAILY,
WEEKLY,
BIWEEKLY,
MONTHLY,
BIMONTHLY,
QUARTERLY,
SEMIANNUAL,
YEARLY
Example:

"MONTHLY"

installment_number
integer | null

Número desta parcela.

Example:

null

is_bill_payment
boolean | null

Se é o pagamento de uma fatura.

Example:

false

is_full_amount
boolean

Em parcelamentos, se amount foi informado como o total da compra.

Example:

false

is_previous_balance
boolean | null

Se é saldo anterior de fatura.

Example:

false

is_remote
boolean

Sempre true (campo legado).

Example:

true

logo_url
string | null

Logo do estabelecimento.

Example:

null

merchant_cnae
string | null

CNAE do estabelecimento (Open Finance).

Example:

null

merchant_cnpj
string | null

CNPJ do estabelecimento (Open Finance).

Example:

null

merchant_name
string | null

Nome do estabelecimento (Open Finance).

Example:

null

operation_type
string | null

Tipo de operação informado pelo banco (Open Finance).

Example:

null

paid_at
string<date-time> | null

Quando foi pago.

Example:

"2026-09-15T14:32:10.000Z"

payment_dates
string[]

Sempre vazio (campo legado).

Example:
profile_id
string | null

Perfil de Acesso / empresa (nulo no contexto pessoal).

Example:

null

reconciled_at
string<date-time> | null

Quando foi conciliado.

Example:

null

reconciled_by_user_id
string | null

Quem conciliou.

Example:

null

reconciled_with_transaction_id
string | null

Lançamento real com o qual este previsto foi conciliado.

Example:

null

show_on_balance
boolean

Se entra no saldo.

Example:

true

subcategory_id
string | null

Subcategoria.

Example:

"d7e8f9a0-b1c2-4d3e-8f4a-5b6c7d8e9f0a"

user_id
string

Dono do lançamento.

Example:

"0d6b923c-3392-424e-a152-2ee32474e8d5"