Skip to content
Chart of Accounts

Update Account Items

Edits an existing accounting subject.

Request parameters

  • Required: id (subject ID), feature (subject attribute), level (subject level), name (subject name), direct (subject direction).
  • Optional: outSubjectCode (external subject code), audit_frontend_resource (audit context: pre-edit record snapshot).
  • In edit mode feature and level cannot be changed but are still submitted with the request.
  • See the field definitions for format, value ranges, and business meaning.

Risk warning

This operation changes a real accounting-subject configuration and affects downstream bookkeeping and accounting. Confirm the target record and parameters before calling.

Result

On success the accounting subject is updated. Refer to the 200 response definition for returned data.

POSThttps://b-api.lbkrs.com/book/updateAccountItems

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_book.book_items_edit

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

Request body application/json

idstringrequired

Account Item ID associated with this request.

featurestringrequired

The account attribute ID; this field is disabled in edit mode but is still submitted with the form.

levelstringrequired

Account level. Read-only when editing but still submitted with the form.

Allowed values: 1 Level 1, 2 Level 2, 3 Level 3

Values
1
Level 1
2
Level 2
3
Level 3
namestringrequired

This field is required.

directstringrequired

Debit/credit direction.

Allowed values: 1 Debit, 2 Credit, 3 Common

Values
1
Debit
2
Credit
3
Common
outSubjectCodestring

The account code used for syncing to external systems; optional.

audit_frontend_resourceobject

A snapshot of the complete row data before editing, used for back-end audit comparison. It is not a business 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