Edit Company Task Settlement

Updates settlement only when both cash and security settlement dates are on or after the accounting date and the source is not an institutional reversal.

Request parameters

Required: task_id (Task ID), modify_action (Modify Action), trade_ledger_date (Trade Ledger Date)
Optional: trade_amount (Trade Amount), ibond_amount (IBond Amount), trade_quantity (Trade Quantity), expected_balance_settlement_date (Expected Balance Settlement Date), expected_equity_settlement_date (Expected Equity Settlement Date)
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.lbkrs.com/billing/company_task_edit

Production: https://b-api.lbkrs.com · Test: https://b-api.longbridge.xyz

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_clearing.contract_manage_query

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

Request body application/json

task_idnumberrequired

Task ID associated with this request.

modify_actionnumberrequired

Specifies Modify Action. This field is required.

0 · Modify both cash and securities.1 · Cash-only adjustment.2 · Securities-only adjustment.

trade_amountstring

Required when modify_action is 0/1; must not exceed the original trade_amount.

ibond_amountstring

trade_quantitystring

Required when modify_action is 0 or 2; must not exceed the original trade_quantity.

expected_balance_settlement_datestring

expected_equity_settlement_datestring

trade_ledger_datenumberrequired

From getNearThreeLedgerDate, in YYYYMMDD format.

Responses

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