dinzo.api
Referência da APILançamentos

Excluir lançamento

Exclui um lançamento persistido ou registra um tombstone para uma projeção (fatura, parcela ou ocorrência de recorrência). Para regras/recorrências use scope ('this'|'future'|'all'), preserve_posted (padrão true) e hide_series (oculta a série de parcelas inteira). Retorna um corpo JSON (200, não 204) descrevendo o que foi excluído/ocultado.

DELETE
/v1/transactions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Chave de API no cabeçalho Authorization: Bearer dz_live_...

In: header

Path Parameters

id*string

Query Parameters

scope?string

this | future | all

preserve_posted?string

true (padrão): ocorrências POSTED são preservadas

hide_series?string

true: oculta a série de parcelas inteira

date?string

Alvos por id de regra com scope this/future: o dia da ocorrência/corte (YYYY-MM-DD)

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://example.com/v1/transactions/string"
{  "deleted_transaction_id": "9f2b6a1c-4e3d-4a2b-8c1e-2b7d5f0a1c33"}

PATCHEditar lançamento

Edita um lançamento persistido ou uma projeção. Para ids projetados de recorrência/parcela `scope` é obrigatório ('this' | 'future' | 'all'). Editar um handle de fatura (mocked-bill:) registra o pagamento; editar uma parcela projetada a materializa; editar uma ocorrência de recorrência materializa/bifurca a série. O corpo de resposta varia conforme o alvo — devolve os ids afetados e mensagens de orientação.

POSTMarcar como transferência

Marca um lançamento (e, se informado `counterpart_id`, sua contraparte) como transferência interna: gera um `transfer_group_id` novo e oculta a(s) linha(s) dos resultados. As categorias definidas pelo usuário são mantidas. 409 quando o lançamento (ou a contraparte) já pertence a uma transferência; 404 quando o alvo não existe.