kobana finance payables

Comandos de kobana finance payables. Toda opción global (Opciones globales) vale aquí.

Comando	HTTP	Descripción
payables aggregates	GET /v1/payables/aggregates	Sumar totales de cuentas por pagar
payables ids	GET /v1/payables/ids	Listar IDs de cuentas por pagar
payables list	GET /v1/payables	Listar cuentas por pagar
payables create	POST /v1/payables	Crear cuenta por pagar
payables get	GET /v1/payables/{id}	Obtener cuenta por pagar por ID
payables update	PATCH /v1/payables/{id}	Actualizar o liquidar cuenta por pagar
payables delete	DELETE /v1/payables/{id}	Eliminar cuenta por pagar
payables cancel-dispatch	POST /v1/payables/{id}/cancel-dispatch	Cancelar el envío al banco
payables send-to-bank	POST /v1/payables/{id}/send-to-bank	Enviar cuenta por pagar al banco

payables aggregates

Sumar totales de cuentas por pagar

kobana finance payables aggregates [OPCIONES]

GET /v1/payables/aggregates

Sums payables for the workspace tied to the token: count, total, pending, paid, overdue_count. Requires scope finance/payables with access level read. Filter by company_id and a period; omit all filters for all-time.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
company_id	string	no	Scope to one company. Omit to aggregate across the whole tenant.
month	integer	no	Calendar month (1–12). Requires year. Mutually exclusive with start_date/end_date.
year	integer,null	no	Calendar year. Requires month.
start_date	string	no	Window start (ISO 8601). Requires end_date. Mutually exclusive with month/year.
end_date	string	no	Window end (ISO 8601). Requires start_date.

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Payable totals for the scope.
400	Malformed query (unknown param, bad pairing, invalid date/uuid).

payables ids

Listar IDs de cuentas por pagar

kobana finance payables ids [OPCIONES]

GET /v1/payables/ids

Every payable id the token can see. Requires scope finance/payables with access level read. Pairs with ?updated_at[gte]= on the listing. The delta reports what changed; this reports what still exists. A delta can never report a disappearance — the row it would have to describe is gone — so an id that stops appearing here is the only signal that something left. Diff this set against your mirror and drop what is missing. Takes no filters: the sweep must cover exactly what the listing shows, and a filter applied here but not to your mirror would read as mass deletion. Note that deletion is not the only exit: a payable whose payment approval is rejected leaves the visible set while its row stays put, and it disappears from this sweep exactly as a deleted one would.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
limit	string	no	Page size. Default 1000, max 10000 — far above the listing's 100, because a row here is one UUID.
cursor	string	no	Opaque cursor from the previous page's meta.next_cursor.

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Live payable ids.
400	Malformed query. This endpoint takes no filters or sort — passing one is a 400.

payables list

Listar cuentas por pagar

kobana finance payables list [OPCIONES]

GET /v1/payables

Returns a cursor-paginated page of payables (accounts payable) for the workspace tied to the token's sub claim. Each row includes nested entity references (person, category, classification_center, each {id, name}) and aggregate counts (tax_charges_count, classification_center_allocations_count, category_allocations_count, attachments_count) — full child collections live in the per-resource detail endpoints. Each row also carries the settlement amounts (interest_amount, discount_amount, ticket_amount) and a derived nominal_amount = amount + interest - discount. Status is the raw DB enum (pending / paid / cancelled); derive overdue client-side via status === "pending" AND due_date < today. Default sort is due_date ascending. Payables awaiting human approval (see the create endpoint) are omitted from this list until an operator approves them in the app; a bill is still retrievable by id via GET /payables/{id}. To list the approval queue instead, filter it explicitly — ?payment_approval=pending_approval (read-only; there is no approve/reject action on this API). Each row carries its payment_approval state. Requires scope finance/payables with access level read.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
company_id	string	no	Filter by owning company UUID. Accepts [in].
status	string	no	Raw status. To find overdue payables, combine status=pending&due_date[lt]=<today ISO>. Accepts [in]=pending,cancelled. Valores: pending, paid, cancelled.
type	string	no	Billing kind. Accepts [in]. Valores: normal, recurring, installment.
person_id	string	no	Filter by person UUID. Accepts [in].
category_id	string	no	Filter by category UUID. Accepts [in].
classification_center_id	string	no	Filter by primary classification-center UUID (not the rateio). Accepts [in].
financial_account_id	string	no	Filter by settlement account UUID. Accepts [in].
payment_method_kind	string	no	Payment method enum (utility/tribute are payable-only). Accepts [in]. Valores: bank_billet, utility, tribute, ted, pix, credit_card, debit_card, cash, check, direct_debit, other, none.
payment_approval	string	no	Read-only view of the human payment-approval gate. By default the list hides gated bills; filter this explicitly to list the approval queue — e.g. ?payment_approval=pending_approval. Accepts [in]. There is no approve/reject action on this API; that stays a human action in the app. Valores: pending_approval, partially_approved, creation_approved, creation_rejected.
due_date	string	no	ISO date filter. Range operators: [gte], [lte], [gt], [lt]. Example: ?due_date[gte]=2026-01-01&due_date[lte]=2026-12-31.
payment_date	string	no	ISO date filter on the actual payment date. Range operators supported.
competence_date	string	no	ISO date filter on the accounting period. Range operators supported.
updated_at	string	no	ISO timestamp filter on the last write. Range operators supported. This is the incremental-sync window: poll ?updated_at[gte]=<end of your last poll>&sort_by=updated_at to fetch only what changed. Deletions do NOT appear here — a deleted payable has no row to return; reconcile them against GET /v1/payables/ids.
amount	string	no	Decimal filter on amount (BRL). Range operators supported.
document_number	string	no	Filter by exact document number. Accepts [in].
ir_relevant	string	no	Filter by tax-relevance flag. Valores: true, false.
group_id	string	no	Filter siblings of a recurring/installment series.
sort_by	string	no	Field to order by. Default: sort_by=due_date&sort_order=asc. Valores: amount, competence_date, created_at, due_date, payment_date, updated_at.
sort_order	string	no	Order direction. Defaults to asc; ignored without sort_by. Valores: asc, desc.
limit	integer	no	Page size. Default 25, max 100.
cursor	string	no	Opaque cursor for the next page. Round-trip meta.next_cursor from the previous response.
fields	string	no	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.

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Page of payables plus pagination metadata.
400	Malformed query (unknown filter / operator, invalid limit, bad cursor).

payables create

Crear cuenta por pagar

kobana finance payables create [OPCIONES]

POST /v1/payables

Creates a single payable (or an installment/recurring series). Requires scope finance/payables with access level write. workspace_id is always taken from the token. A person is required — send person: {id} or person: {name}. {name} (person / category / classification_center) is find-or-create; sending both id and name inside the same nested object returns 400. classification_centers[] (rateio) and tax_charges[] are accepted; the rateio Σ is validated against amount. When payment approval is enabled for the workspace (a per-workspace setting, on by default), the created payable enters an approval queue: it is returned here (with its id) but is hidden from GET /payables until an operator approves it in the app — fetch it by id meanwhile. With the setting off, the payable appears on GET /payables immediately. Pass an X-Idempotency-Key header on retries.

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Cuerpo de la solicitud

Nombre	Tipo	Obligatorio	Descripción
company_id	string (uuid)	sí	Owning company UUID. Must belong to the tenant.
description	string	sí
amount	number	sí	A number in BRL (up to 13 integer digits, 2 decimals). Always positive — cost polarity is implicit.
due_date	string (date-time)	sí	When this payable is due (ISO 8601).
competence_date	string (date-time)	no	Accounting period (ISO 8601). Defaults to due_date when omitted.
type	string	no	Defaults to normal. recurring requires recurrence_period and stores the series ahead up to the workspace's provisioning horizon (default 12 months) as rows sharing group_id; installment requires total_installments (2–120). A title that belongs to a series keeps its type; a standalone normal title may become recurring. Valores: normal, recurring, installment.
person	object	no	{id} for an existing person, or {name} to find-or-create one with supplier polarity, scoped to (workspace, company). Never both.
category	object	no	{id} for an existing category, or {name} to find-or-create one with debit polarity. Never both. On update, sent without categories it replaces a category rateio with this single category.
classification_center	object	no	{id} for an existing classification center, or {name} to find-or-create one with cost polarity — matches a center typed cost or both; creates as cost when no match. Never both.
payment_method_kind	string	no	Valores: bank_billet, utility, tribute, ted, pix, credit_card, debit_card, cash, check, direct_debit, other, none, null.
operation_kind	string	no	Valores: payment, transfer, null.
financial_account_id	string (uuid)	no	Optional pre-set settlement account. Must belong to the tenant and match company_id.
expected_account_id	string (uuid)	no	Projected settlement account (forecast). Independent of financial_account_id.
document	string	no	Free-form reference of the source document (e.g. NF-12345, BOL-001); what the search / documentContains filters match. Distinct from document_number.
document_date	string (date-time)	no
document_number	string	no	Structured document number — the bare identifier (e.g. 12345). Mirrors the "Nº de documento" field in the app UI; the canonical field for manually-entered document numbers. Distinct from the free-form document.
notes	string	no
ir_relevant	boolean	no
recurrence_period	string	no	Required for type=recurring and rejected for any other type (weekly | biweekly | monthly | quarterly | yearly).
total_installments	integer	no	Required for type=installment and rejected for any other type — number of parcelas (2–120). A title that belongs to a series keeps its type and total_installments.
classification_centers	array<object>	no	Rateio. Replace-all set; the server validates Σ against amount (0.01 tolerance). Spread across installments.
categories	array<object>	no	Category rateio. Replace-all set; an empty array clears it (and category); omit to leave it alone. Effective amounts must sum to amount (tolerance: the larger of 0.01 and 0.005 per row). When present, category is ignored and becomes rows[0]; every category must be of type debit (422 otherwise). The cents a percentage leaves go to the last slice sent without an amount.
custom_classifications	array<object>	no	Custom-classifier assignments. Replace-all set; one value per dimension for native single-select. Replicated onto every installment.
tax_charges	array<object>	no	Withholding/tax charges. Replace-all set. Attached to the first record of a series.
payment_source	string	no	Origin of the payable shown on the approval screen: ai_agent when an AI agent created it, manual otherwise. Defaults to manual. Valores: manual, ai_agent.
barcode	string	no
bank	object	no
bank_account	object	no
pix	object	no
transfer_purpose	string	no
judicial_deposit_number	string	no	Judicial deposit identifier (digits only, up to 20). Set with operation_kind = transfer + payment_method_kind = ted; bank.code is the depositary bank and no bank_account is needed.
tax_kind	string	no	Tribute kind. Set with payment_method_kind = tribute; the barcode goes in barcode. Valores: itbi, icms, iss, iptu, fgts, dare, darf, gru, gps, null.
tax_data	object	no
beneficiary	object	no
scheduled_to	string (date-time)	no	Scheduled payment date (ISO 8601). Suggested default is due_date.
receipt_emails	array<object>	no	Replace-all list of receipt (comprovante) recipients for this payable — they receive the receipt as an attachment once one is attached. Omit to leave the current list untouched; send [] or null to clear it. Additional to the workspace-wide recipient list, never a replacement for it.
custom_metadata	object	no	Metadados do usuário: objeto JSON livre. Envie null para limpar. Máx. 64 KB serializado, 16 níveis.

Otros campos y objetos anidados: kobana schema finance.payables.create.

Respuestas

HTTP	Descripción
201	Payable created. The Location header points at the new row. The body is the full detail shape (arrays + reconciliation). X-Idempotent-Replay: true marks a replayed response.
400	Malformed JSON, or id and name sent together inside the same nested entity reference.
409	X-Idempotency-Key reused with a different body.
422	Schema validation failure, or domain violation: missing person, company / account not in tenant, account does not match company, or rateio Σ ≠ amount.

payables get

Obtener cuenta por pagar por ID

kobana finance payables get [ID] [OPCIONES]

GET /v1/payables/{id}

List-row shape plus the expanded child arrays the list only counts: classification_center_allocations[] and category_allocations[] (rateio) and tax_charges[], plus the reconciliation group (null when not reconciled). Returns the same shape as the rows from the list endpoint. Requires scope finance/payables with access level read. 404 covers both "doesn't exist" and "not in the tenant" — the API does not distinguish.

Argumentos de la ruta: id

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
fields	string	no	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.

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Get a payable by id
404	Payable not found within the tenant.

payables update

Actualizar o liquidar cuenta por pagar

kobana finance payables update [ID] [OPCIONES]

PATCH /v1/payables/{id}

Partial update. Only fields present in the body are written; unknown / response-only fields (id, created_at, transaction_id, denorm names, counts, is_reconciled) are silently dropped. Requires scope finance/payables with access level write. Settle: send status:"paid" with payment_date and financial_account_id (or rely on a previously-set account) — a debit payment transaction is generated automatically. The settlement amounts (interest_amount / discount_amount / ticket_amount) are persisted on the row. Set status back to pending to revert, or cancelled to cancel. draft is never accepted. Settling generates a payment transaction, so pass an X-Idempotency-Key header on retries — without it a retried settle is a second movement in the ledger.

Argumentos de la ruta: id

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Cuerpo de la solicitud

Nombre	Tipo	Obligatorio	Descripción
description	string	no
amount	number	no	A number in BRL (up to 13 integer digits, 2 decimals). Always positive — cost polarity is implicit.
due_date	string (date-time)	no	When this payable is due (ISO 8601).
competence_date	string (date-time)	no	Accounting period (ISO 8601). Defaults to due_date when omitted.
type	string	no	Defaults to normal. recurring requires recurrence_period and stores the series ahead up to the workspace's provisioning horizon (default 12 months) as rows sharing group_id; installment requires total_installments (2–120). A title that belongs to a series keeps its type; a standalone normal title may become recurring. Valores: normal, recurring, installment.
person	object	no	{id} for an existing person, or {name} to find-or-create one with supplier polarity, scoped to (workspace, company). Never both.
category	object	no	{id} for an existing category, or {name} to find-or-create one with debit polarity. Never both. On update, sent without categories it replaces a category rateio with this single category.
classification_center	object	no	{id} for an existing classification center, or {name} to find-or-create one with cost polarity — matches a center typed cost or both; creates as cost when no match. Never both.
payment_method_kind	string	no	Valores: bank_billet, utility, tribute, ted, pix, credit_card, debit_card, cash, check, direct_debit, other, none, null.
operation_kind	string	no	Valores: payment, transfer, null.
financial_account_id	string (uuid)	no	Optional pre-set settlement account. Must belong to the tenant and match company_id.
expected_account_id	string (uuid)	no	Projected settlement account (forecast). Independent of financial_account_id.
document	string	no	Free-form reference of the source document (e.g. NF-12345, BOL-001); what the search / documentContains filters match. Distinct from document_number.
document_date	string (date-time)	no
document_number	string	no	Structured document number — the bare identifier (e.g. 12345). Mirrors the "Nº de documento" field in the app UI; the canonical field for manually-entered document numbers. Distinct from the free-form document.
notes	string	no
ir_relevant	boolean	no
recurrence_period	string	no	Required for type=recurring and rejected for any other type (weekly | biweekly | monthly | quarterly | yearly).
total_installments	integer	no	Required for type=installment and rejected for any other type — number of parcelas (2–120). A title that belongs to a series keeps its type and total_installments.
classification_centers	array<object>	no	Rateio. Replace-all set; the server validates Σ against amount (0.01 tolerance). Spread across installments.
categories	array<object>	no	Category rateio. Replace-all set; an empty array clears it (and category); omit to leave it alone. Effective amounts must sum to amount (tolerance: the larger of 0.01 and 0.005 per row). When present, category is ignored and becomes rows[0]; every category must be of type debit (422 otherwise). The cents a percentage leaves go to the last slice sent without an amount.
custom_classifications	array<object>	no	Custom-classifier assignments. Replace-all set; one value per dimension for native single-select. Replicated onto every installment.
tax_charges	array<object>	no	Withholding/tax charges. Replace-all set. Attached to the first record of a series.
barcode	string	no
bank	object	no
bank_account	object	no
pix	object	no
transfer_purpose	string	no
judicial_deposit_number	string	no	Judicial deposit identifier (digits only, up to 20). Set with operation_kind = transfer + payment_method_kind = ted; bank.code is the depositary bank and no bank_account is needed.
tax_kind	string	no	Tribute kind. Set with payment_method_kind = tribute; the barcode goes in barcode. Valores: itbi, icms, iss, iptu, fgts, dare, darf, gru, gps, null.
tax_data	object	no
beneficiary	object	no
scheduled_to	string (date-time)	no	Scheduled payment date (ISO 8601). Suggested default is due_date.
receipt_emails	array<object>	no	Replace-all list of receipt (comprovante) recipients for this payable — they receive the receipt as an attachment once one is attached. Omit to leave the current list untouched; send [] or null to clear it. Additional to the workspace-wide recipient list, never a replacement for it.
custom_metadata	object	no	Metadados do usuário: objeto JSON livre. Envie null para limpar. Máx. 64 KB serializado, 16 níveis.
status	string	no	Settle (paid), revert (pending) or cancel (cancelled). draft is never accepted. Valores: pending, paid, cancelled.
payment_date	string (date-time)	no	Settlement date (ISO 8601). Required when moving to status=paid.
interest_amount	number	no	Late-payment interest paid at settlement (BRL), in BRL.
discount_amount	number	no	Discount obtained at settlement (BRL), in BRL.
ticket_amount	number	no	"Valor liquidado" — the actual amount that left the bank (BRL), in BRL.
custom_metadata_mode	string	no	Como o custom_metadata enviado é reconciliado com o valor armazenado: replace (padrão) substitui o objeto inteiro, merge faz deep merge sobre o valor atual. Aceito apenas na atualização. Valores: replace, merge.

Otros campos y objetos anidados: kobana schema finance.payables.update.

Respuestas

HTTP	Descripción
200	Updated payable (full detail shape).
400	Malformed JSON, or id and name sent together inside the same nested entity reference.
404	Payable not found within the tenant.
409	X-Idempotency-Key reused with a different body.
422	Schema validation failure, or domain violation: settling without an account, FK out of scope, or rateio Σ ≠ amount.

payables delete

Eliminar cuenta por pagar

kobana finance payables delete [ID] [OPCIONES]

DELETE /v1/payables/{id}

Hard-deletes the payable. Requires scope finance/payables with access level delete. Dissolves any reconciliation the payable is part of and removes the auto-created payment transaction (manually-linked transactions are preserved). Calling DELETE twice on the same id returns 200 then 404 (Stripe-style). Deletes a single row — series-aware delete is not yet exposed. A payable already sent to the bank cannot be deleted (422) while its payment is in flight or after it was paid; it can again once the bank rejected or the payment was canceled.

Argumentos de la ruta: id

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Payable deleted.
404	Payable not found within the tenant.
422	The payable was already sent to the bank (payment in flight or paid) and cannot be deleted.

payables cancel-dispatch

Cancelar el envío al banco

kobana finance payables cancel-dispatch [ID] [OPCIONES]

POST /v1/payables/{id}/cancel-dispatch

Undoes a payable's bank dispatch on the Kobana side and mirrors the payment as canceled (the kobana_* mirror is kept, not cleared — the bill returns to the manual rail because canceled is terminal). Requires scope finance/payable_dispatches with access level write and a required X-Idempotency-Key. A bill that was never dispatched, or whose execution already reached a terminal state (confirmed / canceled / …), returns 422. Returns the refreshed payable detail.

Argumentos de la ruta: id

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Dispatch cancelled. Body is the refreshed payable detail (kobana_status = canceled).
400	Missing / blank X-Idempotency-Key.
404	Payable not found within the tenant.
409	X-Idempotency-Key reused with a different body.
422	Not cancellable: the bill was never dispatched, or its execution already reached a terminal state.

payables send-to-bank

Enviar cuenta por pagar al banco

kobana finance payables send-to-bank [ID] [OPCIONES]

POST /v1/payables/{id}/send-to-bank

Dispatches an approved payable to the bank through the Kobana gateway (creates the payment, then envelopes and approves it on the gateway side). Requires scope finance/payable_dispatches with access level write — the money resource is deliberately separate from finance/payables (dispatching money is not editing a bill), while a token with no finance/… scope needs just the write (or all) access level. X-Idempotency-Key is required. Only an official bill dispatches — one whose payment_approval is null or creation_approved; a bill still awaiting approval (pending_approval / partially_approved) or creation_rejected returns 422. The payable must also carry the payment coordinates for its method and a Kobana-mirrored source account. Returns the refreshed payable detail with the execution mirror (kobana_status, kobana_payment_uid) populated. Note: the Kobana sandbox example_bank does not execute outbound payments, so the full confirmed cycle is only observable against an environment that actually settles.

Argumentos de la ruta: id

Encabezados

Nombre	Tipo	Obligatorio	Descripción
X-Workspace-Id	string	sí	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).

Respuestas

HTTP	Descripción
200	Dispatched. Body is the refreshed payable detail with the Kobana mirror populated.
400	Missing / blank X-Idempotency-Key.
404	Payable not found within the tenant.
409	X-Idempotency-Key reused with a different body.
422	Not dispatchable: bill not official (awaiting approval / rejected), missing payment coordinates, source account not mirrored in Kobana, or the Kobana integration is not connected.