Create Post Adjust

Create a post-execution adjustment for a specific corporate action announcement, correcting quantity, amount, or fee discrepancies in that announcement's already-executed result according to the submitted line items.

Request parameters

Required: ann_id (the associated announcement ID), items (adjustment line items, each an object)
Optional: remark
See each field's description for format, value range, and business meaning.

Business notes

The adjustment applies only to the announcement referenced by ann_id. Each entry in items describes one detail to be corrected.

Risk warning

This operation modifies the result of an already-executed corporate action and may cause real changes to funds, positions, or fees. Verify the announcement and adjustment details before calling.

Result

On success, a Pending post-event adjustment is created and its adjustment_id returned. It takes effect only after confirm_post_adjust; before that, edit lines with update_post_adjust_detail or remove it with delete_post_adjust_detail.

POSThttps://b-api.lbkrs.com/v1/post_adjust

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

ann_idstringrequired

Announcement ID associated with this request.

itemsarray<object>required

Adjustment items. Each item is an object (not a JSON string; strings return 500). This field is required.

Child attributes

group_idstringrequired

Sub-position group ID: the group id returned by sub_position_view_detail.

event_idstringrequired

Event ID: the row id returned by corp_action_stock_events for the same ann_id.

expected_amount_totalstring

Expected adjustment to the credited amount. Pass at least one of expected_amount_total, expected_quantity_total, expected_fee_total.

expected_quantity_totalstring

Expected adjustment to the credited quantity.

expected_fee_totalstring

Expected adjustment to the withholding tax.

remarkstring

Responses

HTTP 200The request was processed successfully. data.adjustment_id is the new adjustment ID, used by update_post_adjust_detail, confirm_post_adjust and delete_post_adjust_detail.