Update Financial Transaction by Reference Number

patch

https://api.deben.io/external/api/v1/data/financialTransaction/referenceNumber/{referenceNumber}

Update an existing financial transaction record using its external reference number (e.g., invoice number).
Only provided fields will be updated. Webhook notifications are sent upon successful update.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

referenceNumber

string

required

External reference number of the financial transaction (e.g., invoice number)

Body Params

batchReferenceNumber

string

Batch reference number (auto-generated if not provided)

referenceNumber

string

required

length ≥ 1

External reference number for the transaction (e.g., invoice number, bill number)

correlatedReferenceNumber

string

Reference number of the original transaction.
Required for CREDIT_NOTE and DEBIT_NOTE transaction types.

accountTypeIndicator

object

required

classification

object

required

direction

object

transactionType

object

required

postingDate

date

required

Accounting entry/posting date (cannot be in the future)

dueDate

date

Payment due date (must be after posting date)

valueDate

date

Value date at bank

amount

number

required

≥ 0.01

Transaction amount (must be positive)

currency

object

required

counterparty

object

intentBanksInfo

array of objects

Intent bank accounts for this transaction

intentBanksInfo

metadata

array of objects

Custom metadata attributes

metadata

200Financial transaction updated successfully

400Bad Request - Validation errors or invalid parameters

401Unauthorized - Invalid or missing API key

404Resource not found