Criar conciliação
POST/reconciliations
Reconciles billings against bank transactions (n:m), settling every billing (paid/received). Requires scope finance.reconciliations.write. All billings must share one polarity and one company; transaction polarity must match (payable↔debit, receivable↔credit). A billing already reconciled/linked, cancelled or draft is rejected (422). Pass an X-Idempotency-Key header on retries.
Requisição
Respostas
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Reconciliation created; the Location header points at GET /reconciliations/{id}.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance.reconciliations.write scope.
A billing or transaction was not found within the tenant.
X-Idempotency-Key reuse with a different body.
Validation failure: mixed polarity/company, wrong transaction polarity, a member already reconciled/linked, or a cancelled/draft billing.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries ratelimit-limit, ratelimit-remaining, ratelimit-reset and retry-after — wait out retry-after rather than retrying immediately.
Unhandled server error.