Skip to content
Details

Modify Account Detail

Edit an accounting entry (sharing the same form as create, differing only in the additional id). It changes real accounting-entry data.

Request parameters

  • Required: id (Account Detail ID), bookingTypeId (Booking Type ID), txNo (Transaction No.), name (Description), accountAt (Account Date), ledgerDate (Ledger Date), objectCode (Object Code), debitFirstSubjectCode (Debit First-level Subject Code), debitSecondSubjectCode (Debit Second-level Subject Code), debitSubjectCode (Debit Third-level Subject Code), creditFirstSubjectCode (Credit First-level Subject Code), creditSecondSubjectCode (Credit Second-level Subject Code), creditSubjectCode (Credit Third-level Subject Code), amount (Amount)
  • Optional: sourceId (Book Source), aaid (Associated Account ID), remark (Remark), debitName (Debit Subject Full Name), creditName (Credit Subject Full Name), objectType (Object Type), audit_frontend_resource (Audit Frontend Resource Snapshot)
  • See each field for its format, allowed values, default behavior, and business meaning.

Result

On success, the endpoint completes the described business operation. See the 200 response schema for returned data.

POSThttps://b-api.longbridge.xyz/book/account_detail/update

Authorization

AuthorizationstringheaderRequired

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

Request body application/json

idstringrequired

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

sourceIdnumber

A dropdown selection; 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.

txNostringrequired

Specifies Transaction No.. This field is required.

namestringrequired

Specifies Description. 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

A dropdown selection; 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

Specifies Object Type.

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.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs