POST
/BizTransaction/AdjustQuantity
When to Use
- Reconciliation Corrections: Adjust unit holdings to match external registry or custodian records
- Corporate Action Processing: Handle stock splits, consolidations, or rights issues affecting unit quantities
- System Migration: Correct quantities during platform transitions or data conversions
- Error Corrections: Fix transaction processing errors that resulted in incorrect unit holdings
- Manual Adjustments: Process authorized corrections from fund administrators or operations teams
- Compliance Requirements: Implement adjustments required by audit findings or regulatory directives
Prerequisites
- Target account must be active and accessible
- Investment must be active within the specified product
- Account must not be locked for settlement or transaction restrictions
Considerations
- Adjustment Types: Ensure correct adjustment type is specified ('I' for Increase, 'D' for Decrease, 'A' for Absolute) for intended outcome
- Business Rules: Decrease adjustments cannot result in negative quantities below minimum holding requirements
- Audit Compliance: All adjustments create permanent audit records required for regulatory compliance
- Position Impact: Adjustments affect total account values, performance calculations, and tax reporting
- Settlement Timing: Adjustments may affect T+1/T+2 settlement cycles and cash management
- Reversal Process: Incorrect adjustments require separate corrective transactions - original records are immutable
Description
Processes quantity adjustments for investment holdings. This endpoint handles corrections, reconciliations, and other authorized quantity changes that don't involve cash transactions. The adjustment creates a permanent audit trail while updating the account's unit balance according to the specified adjustment type.
Required Headers - See Authentication
| Header | Value | Description |
|---|---|---|
| Content-Type | application/json | Request content type |
| Authorization | {accessToken} | Bearer token for API access |
| Version | 2.0 | API version identifier |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
adjustmentType |
string | Adjustment method controlling how quantity affects holdings ('I' = Increase - adds to current, 'D' = Decrease - subtracts from current, 'A' = Absolute - sets exact value). | |
quantity |
number (double) | Quantity value with adjustmentType-dependent semantics (for 'I'/'D' = relative change amount, for 'A' = absolute final value). | |
amount |
number (double) | Optional |
Optional monetary amount for financial reporting and audit trail context (NOT used for pricing - quantity parameter is authoritative). |
comment |
string | Optional |
Audit trail documentation explaining adjustment reason, authorization source, and business context (appears on account statements). |
transactionDate |
string (date) | Transaction effective date determining financial period allocation and pricing date (format: YYYY-MM-DD, must not be DateOnly.MinValue per controller line 232). | |
accountID |
integer (int32) | Native account identifier specifying which account's holdings will be adjusted (system modifies Holdings record for accountID + investmentID). | |
externalAccountId |
string | External account identifier for cross-platform integration (resolves to internal accountID for holdings lookup). | |
externalBizTransactionId |
string | Optional |
External transaction identifier preventing duplicate adjustment processing and linking to originating system records. |
investmentID |
integer (int32) | Native investment identifier specifying which investment class holdings will be adjusted within target account. | |
externalInvestmentId |
string | External investment identifier for cross-platform integration using security codes, ISIN, or APIR codes. | |
productID |
integer (int32) | Native product identifier validating investment and account belong to correct fund structure. | |
externalProductId |
string | External product identifier for cross-system product correlation (resolves to internal productID for validation). |
adjustmentType
Adjustment method controlling how quantity affects holdings ('I' = Increase - adds to current, 'D' = Decrease - subtracts from current, 'A' = Absolute - sets exact value).
quantity
Quantity value with adjustmentType-dependent semantics (for 'I'/'D' = relative change amount, for 'A' = absolute final value).
amount
Optional monetary amount for financial reporting and audit trail context (NOT used for pricing - quantity parameter is authoritative).
comment
Audit trail documentation explaining adjustment reason, authorization source, and business context (appears on account statements).
transactionDate
Transaction effective date determining financial period allocation and pricing date (format: YYYY-MM-DD, must not be DateOnly.MinValue per controller line 232).
accountID
Native account identifier specifying which account's holdings will be adjusted (system modifies Holdings record for accountID + investmentID).
externalAccountId
External account identifier for cross-platform integration (resolves to internal accountID for holdings lookup).
externalBizTransactionId
External transaction identifier preventing duplicate adjustment processing and linking to originating system records.
investmentID
Native investment identifier specifying which investment class holdings will be adjusted within target account.
externalInvestmentId
External investment identifier for cross-platform integration using security codes, ISIN, or APIR codes.
productID
Native product identifier validating investment and account belong to correct fund structure.
externalProductId
External product identifier for cross-system product correlation (resolves to internal productID for validation).
Example Requests
json
{
"adjustmentType": "I",
"quantity": 1000.00,
"amount": 1250.00,
"comment": "Reconciliation adjustment - stock split 1:1.25",
"transactionDate": "2025-08-14",
"accountID": 12345,
"externalAccountId": "",
"externalBizTransactionId": "ADJ-2024-001",
"investmentID": 25,
"externalInvestmentId": "",
"productID": 10,
"externalProductId": ""
}Response Examples
json
{
"result": true,
"message": "Quantity adjustment processed successfully",
"recordCount": 1,
"data": {
"bizTransactionID": 1001,
"externalBizTransactionId": "ADJ-2024-001",
"bizTransactionTypeID": 5,
"typeName": "Quantity Adjustment",
"movementReasonCode": "RECONCILIATION",
"parentBizTransactionID": null,
"transactionDate": "2025-08-14T00:00:00Z",
"productID": 10,
"externalProductId": "FUND-001",
"accountID": 12345,
"externalAccountId": "ACC-12345",
"accountNumber": "ACC001234",
"bizEntityName": "Smith Family Trust",
"investmentID": 25,
"externalInvestmentId": "INV-GROWTH",
"securityCode": "GRW001",
"investmentName": "Growth Investment Class A",
"investmentPrice": 1.2500,
"comment": "Reconciliation adjustment - stock split 1:1.25",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": 1250.00,
"quantity": 1000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:15Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
}
}