kobana finance reconciliations

Comandos de kobana finance reconciliations. Toda opção global (Opções globais) vale aqui.

Comando	HTTP	Descrição
reconciliations create	POST /v1/reconciliations	Criar conciliação
reconciliations get	GET /v1/reconciliations/{id}	Obter conciliação por ID
reconciliations delete	DELETE /v1/reconciliations/{id}	Excluir conciliação

reconciliations create

Criar conciliação

kobana finance reconciliations create [OPÇÕES]

POST /v1/reconciliations

Reconciles billings against bank transactions (n:m), settling every billing (paid/received). Requires scope finance/reconciliations with access level 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.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Workspace-Id	string	sim	Workspace to act on, as a UUID. The token identifies the organization; this header picks which of its workspaces the request reads or writes. It is checked against the token's organization, so a workspace owned by anyone else answers UNKNOWN_WORKSPACE — the same code as one that does not exist. Omitting it answers WORKSPACE_REQUIRED (400).

Corpo da requisição

Nome	Tipo	Obrigatório	Descrição
billings	array<object>	sim	Billings to reconcile. All must share one kind and one company.
transaction_ids	array<string (uuid)>	sim	Bank transactions to reconcile the billings against.
custom_metadata	object	não	Metadados do usuário: objeto JSON livre. Envie null para limpar. Máx. 64 KB serializado, 16 níveis.

Outros campos e objetos aninhados: kobana schema finance.reconciliations.create.

Respostas

HTTP	Descrição
201	Reconciliation created; the Location header points at GET /reconciliations/{id}.
400	Malformed JSON body.
404	A billing or transaction was not found within the tenant.
409	X-Idempotency-Key reuse with a different body.
422	Validation failure: mixed polarity/company, wrong transaction polarity, a member already reconciled/linked, or a cancelled/draft billing.

reconciliations get

Obter conciliação por ID

kobana finance reconciliations get [ID] [OPÇÕES]

GET /v1/reconciliations/{id}

Returns the reconciliation's light id-list shape (source, kind, billing_ids, transaction_ids). Requires scope finance/reconciliations with access level read. 404 when not in the tenant.

Argumentos do caminho: id

Parâmetros de consulta

Nome	Tipo	Obrigatório	Descrição
fields	string	não	Comma-separated top-level fields to return, e.g. fields=description,amount,due_date. Omit for every field. id is always included; naming an object field returns it whole. An unknown name is a 400 whose details lists unknown and available.

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Workspace-Id	string	sim	Workspace to act on, as a UUID. The token identifies the organization; this header picks which of its workspaces the request reads or writes. It is checked against the token's organization, so a workspace owned by anyone else answers UNKNOWN_WORKSPACE — the same code as one that does not exist. Omitting it answers WORKSPACE_REQUIRED (400).

Respostas

HTTP	Descrição
200	The reconciliation.
404	Reconciliation not found within the tenant.

reconciliations delete

Excluir conciliação

kobana finance reconciliations delete [ID] [OPÇÕES]

DELETE /v1/reconciliations/{id}

Dissolves a manual reconciliation: reverts every member billing to pending and clears the links. Requires scope finance/reconciliations with access level delete. Imported (fintera) reconciliations are read-only → 422.

Argumentos do caminho: id

Cabeçalhos

Nome	Tipo	Obrigatório	Descrição
X-Workspace-Id	string	sim	Workspace to act on, as a UUID. The token identifies the organization; this header picks which of its workspaces the request reads or writes. It is checked against the token's organization, so a workspace owned by anyone else answers UNKNOWN_WORKSPACE — the same code as one that does not exist. Omitting it answers WORKSPACE_REQUIRED (400).

Respostas

HTTP	Descrição
200	Reconciliation dissolved.
404	Reconciliation not found within the tenant.
422	The reconciliation is imported (source: fintera) and cannot be dissolved via the API.