After Event Adjustment

Update Post Adjust Detail

Update a line item of a post-execution adjustment, changing its confirmed value and related parameters.

Request parameters

Required: adjustment_id (adjustment ID), confirmed_value.
Optional: item_id (line-item ID), event_id, aaid (securities account), target (adjustment target).
adjustment_id is the id of a row returned by POST /v1/datasets/corp_action_post_adjust_records (only records in Pending state can be edited), or the adjustment_id returned by post_adjust.
item_id is the line row's amount_item_id, fee_item_id, or quantity_item_id (depending on whether you edit the amount, fee, or quantity); query the line rows with POST /v1/datasets/corp_action_post_adjust_detail_items (same ann_id, adjustment_id and group_id).
When item_id is 0 (the line has no detail yet), also send aaid, target, and event_id from the same line row; omit these three fields when item_id is not 0.
confirmed_value precision: 4 decimal places for quantity, 2 for amount and fee.
Examples: {"adjustment_id":"45","confirmed_value":"1200.5","item_id":"8812"}; {"adjustment_id":"45","confirmed_value":"100","item_id":"0","aaid":"10000000","target":"ADJUSTMENT_TARGET_QUANTITY","event_id":"9001"}.
See each field's documentation for format, value range, and business meaning.

Business notes

Updates the confirmed value of a post-execution adjustment identified by adjustment_id (optionally narrowed by item_id, aaid, etc.). The confirmed value becomes the basis for the adjustment's final effect and is normally modified before confirmation.

Risk warning

This operation modifies a pending post-execution adjustment line item; the confirmed value affects the eventual real funds, positions, or quantity changes. Confirm the adjustment record and confirmed value before calling.

Result

On success the post-execution adjustment line item is updated; the resulting state and returned data are defined by the 200 response.

POSThttps://b-api.lbkrs.com/v1/update/post_adjust_detail

Authorization

AuthorizationstringheaderRequired

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

Permission

corporate.after_event_adjustment_update

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

Request body application/json

adjustment_idstringrequired

Adjustment ID; use the id of a row returned by POST /v1/datasets/corp_action_post_adjust_records (only Pending records can be edited), or the adjustment_id returned by post_adjust. This field is required.

confirmed_valuestringrequired

This field is required.

event_idstring

Event ID from the line row's event_id. Send only when item_id is 0.

item_idstring

Line-item ID: the line row's amount_item_id, fee_item_id, or quantity_item_id (depending on whether you edit the amount, fee, or quantity); query the line rows with POST /v1/datasets/corp_action_post_adjust_detail_items (same ann_id, adjustment_id and group_id).

Pass 0 when the line has no detail yet, together with aaid, target, and event_id.

aaidstring

The line row's aaid. Send only when item_id 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.

targetstring

Adjustment target. Send only when item_id is 0.

Allowed values: ADJUSTMENT_TARGET_AMOUNT Amount, ADJUSTMENT_TARGET_QUANTITY Quantity, ADJUSTMENT_TARGET_FEE Fee

Values

ADJUSTMENT_TARGET_AMOUNT: Amount
ADJUSTMENT_TARGET_QUANTITY: Quantity
ADJUSTMENT_TARGET_FEE: Fee

Responses

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