Modify Account Detail

Edit an existing accounting entry. The request has the same shape as the create endpoint, with the addition of id to identify the entry to modify.

Request parameters

Required: id (accounting entry ID), bookingTypeId (booking business type), txNo (transaction number), name (summary), accountAt (booking date), ledgerDate (ledger date), objectCode (object currency), debitFirstSubjectCode / debitSecondSubjectCode / debitSubjectCode (debit level 1/2/3 subject codes), creditFirstSubjectCode / creditSecondSubjectCode / creditSubjectCode (credit level 1/2/3 subject codes), and amount.
See the individual field docs for each field's format, allowed values, and meaning.

Business notes

The debit and credit subjects cascade level by level; once a leaf subject is selected, its full name becomes the corresponding debit/credit subject name. The allowed values for objectCode vary by channel — call GET /v1/datasets/refs/tenant_currencies_by_channel to fetch the currently available values.

Risk warning

This operation overwrites real accounting-entry data and affects bookkeeping results. Verify the target entry and its subjects, currency, and amount before calling.

Result

On success, the accounting entry is updated; see the 200 response for the returned content.

POSThttps://b-api.lbkrs.com/book/account_detail/update

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Permission

lb_hk_book.book_detail_update

The Broker ACCESS_TOKEN must be granted the permission above, or the call will be rejected.

Request body application/json

idstringrequired

The entry id passed in the edit scenario; present only in the edit endpoint.

sourceIdnumber

An enumerated value; values come from the book_source dynamic enumeration; disabled and not editable in edit mode; converted to a number before submission.

Call GET /v1/datasets/refs/book_source to retrieve the current data dictionary, and use the returned entry's key as this field's value.

bookingTypeIdstringrequired

Dropdown selection; values come from the book_business_types_by_source dynamic enum (loaded in cascade based on the source field). When the source is 0, this item is hidden and not submitted.

Call GET /v1/datasets/refs/book_business_types_by_source to retrieve the current data dictionary, and use the returned entry's key as this field's value.

aaidstring

A custom component selects the associated account; hidden and not submitted when the source is 0.

Pass the internal numeric ID of the customer's securities account (aaid), not the securities account number account_no (such as H00000000) or the customer ID member_id. One customer can have multiple aaid values.

txNostringrequired

Specifies Transaction No.. This field is required.

namestringrequired

This field is required.

accountAtstringrequired

A date, converted to the 'YYYY-MM-DD 00:00:00' format before submission.

ledgerDatestringrequired

A date, converted to the 'YYYY-MM-DD HH:mm:ss' format before submission.

objectCodestringrequired

An enumerated value; values come from the tenant_currencies_by_channel dynamic enumeration.

Call GET /v1/datasets/refs/tenant_currencies_by_channel to retrieve the current data dictionary, and use the returned entry's key as this field's value.

debitFirstSubjectCodestringrequired

Dropdown selection for the debit first-level account; the values come from the linked account-query interface.

debitSecondSubjectCodestringrequired

Dropdown selection; debit second-level account, loaded in linkage with the debit first-level account.

debitSubjectCodestringrequired

Dropdown selection for the debit lowest-level account, loaded in cascade based on the debit second-level account; once selected, the full name of the item is taken as the debit account name.

creditFirstSubjectCodestringrequired

Dropdown selection for the credit first-level account; the values come from the linked account-query interface.

creditSecondSubjectCodestringrequired

Dropdown selection; credit second-level account, loaded in linkage with the credit first-level account.

creditSubjectCodestringrequired

Dropdown selection for the credit lowest-level account, loaded in cascade based on the credit second-level account; once selected, the full name of the item is taken as the credit account name.

amountstringrequired

Amount involved in this business operation. This field is required.

remarkstring

Free text, up to 100 characters.

debitNamestring

Not a request field; when the debit leaf account is selected, its value is taken from the option's full name and attached on submit.

creditNamestring

Not a request field; when the credit leaf account is selected, its value is taken from the option's full name and attached on submit.

objectTypestring

objectType.

Allowed values: 0 Unknown, 1 Cash, 2 Stock, 3 Fund

Values

0: Unknown
1: Cash
2: Stock
3: Fund

audit_frontend_resourceobject

A snapshot of the original data fetched before editing, used for backend audit comparison; not a user-editable field.

Responses

HTTP 200The request was processed successfully. The response data does not contain additional business fields.