dinzo.api
Referência da APILançamentos

Listar possíveis duplicatas

Agrupa lançamentos que parecem duplicados (mesma descrição, valor e tipo) dentro de uma janela from/to opcional (YYYY-MM-DD). Retorna os grupos com suas linhas, contagens e o período efetivamente analisado.

GET
/v1/transactions/duplicates

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

from?string

YYYY-MM-DD

to?string

YYYY-MM-DD

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/transactions/duplicates"
{  "groups": [    {      "description": "Netflix",      "amount": 44.9,      "type": "DEBIT",      "transactions": [        {          "id": "aa11bb22-cc33-4dd4-8ee5-ff6600112233",          "description": "Netflix",          "amount": 44.9,          "type": "DEBIT",          "status": "POSTED",          "date": "2026-08-10",          "account_id": "1a2b3c4d-5e6f-4a1b-9c8d-7e6f5a4b3c2d",          "category_id": "c0ffee00-1111-4222-8333-444455556666",          "source": "OPEN_FINANCE"        },        {          "id": "bb22cc33-dd44-4ee5-8ff6-001122334455",          "description": "Netflix",          "amount": 44.9,          "type": "DEBIT",          "status": "POSTED",          "date": "2026-08-10",          "account_id": "1a2b3c4d-5e6f-4a1b-9c8d-7e6f5a4b3c2d",          "category_id": null,          "source": "MANUAL"        }      ]    }  ],  "group_count": 1,  "duplicate_row_count": 2,  "period": {    "from": "2026-08-01",    "to": "2026-08-24"  }}

POSTCriar lançamento

Cria um lançamento simples, uma compra parcelada (`installments`) ou uma regra de recorrência (`recurrence`). Aceita `id` (uuid) do cliente para idempotência em criações simples (replay do mesmo payload devolve a linha com `deduped: true` e status 200; payload divergente devolve 409 id_conflict). Criação simples/parcelada devolve o lançamento criado (201); recorrência devolve o id da regra (201, ou 200 quando reaproveita uma regra equivalente).

POSTAtualizar ou excluir lançamentos em massa

Aplica uma atualização (`set`) ou exclusão (`delete: true`) a um conjunto de lançamentos, selecionados por `ids` (só ids persistidos, sem projeções mocked-*) e/ou `filter`, com `expected_count` opcional de guarda. Sujeito a rate limit próprio (10/hora). Retorna as contagens de itens afetados e ignorados.