POST
/BizTransaction/AdjustQuantity
Usage Notes
When
- Apply relative quantity adjustments (increase or decrease)
- Process balance corrections for reconciliation
- Execute administrative quantity changes
Requirements
- Account and Investment must exist
- Adjustment type classification required
- TransactionDate required
Notes
- Specify positive quantity for increase, negative for decrease
- Comment field required for audit trail
- Transaction records are permanent
Description
Creates a quantity adjustment that increases or decreases holdings by a relative amount. Use for administrative corrections and reconciliation adjustments with audit trail.
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: 'I' for Increase (adds to current holdings), 'D' for Decrease (subtracts from current holdings), 'A' for Absolute (sets exact value). | |
quantity |
number (double) | Quantity value for the adjustment. For 'I' and 'D' types, this is the amount to add or subtract from current holdings. For 'A' type, this is the absolute value to set holdings to. | |
amount |
number (double) | Optional |
Optional monetary amount for financial reporting. Not used for pricing - quantity parameter is authoritative. |
comment |
string | Optional |
Optional field to document the reason for the adjustment. Useful for internal record-keeping and appears on account statements. |
transactionDate |
string (date) | Date of the adjustment transaction. Format: YYYY-MM-DD. Cannot be empty or default value. | |
accountID |
integer (int32) | Account identifier for the adjustment transaction. Account must exist in the system. | |
externalAccountId |
string | External account identifier for dual-ID integration. Used to match with records in external systems. | |
externalBizTransactionId |
string | Optional |
External system reference for dual-ID integration. Optional field to match transactions with records in external systems. |
investmentID |
integer (int32) | Investment identifier for the adjustment transaction. Investment must exist and be active. | |
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: 'I' for Increase (adds to current holdings), 'D' for Decrease (subtracts from current holdings), 'A' for Absolute (sets exact value).
quantity
Quantity value for the adjustment. For 'I' and 'D' types, this is the amount to add or subtract from current holdings. For 'A' type, this is the absolute value to set holdings to.
amount
Optional monetary amount for financial reporting. Not used for pricing - quantity parameter is authoritative.
comment
Optional field to document the reason for the adjustment. Useful for internal record-keeping and appears on account statements.
transactionDate
Date of the adjustment transaction. Format: YYYY-MM-DD. Cannot be empty or default value.
accountID
Account identifier for the adjustment transaction. Account must exist in the system.
externalAccountId
External account identifier for dual-ID integration. Used to match with records in external systems.
externalBizTransactionId
External system reference for dual-ID integration. Optional field to match transactions with records in external systems.
investmentID
Investment identifier for the adjustment transaction. Investment must exist and be active.
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
bash
# Increase quantity adjustment
curl -X POST 'https://api.7g.com.au/BizTransaction/AdjustQuantity' \
-H 'Authorization: {accessToken}' \
-H 'Version: 2.0' \
-H 'Content-Type: application/json' \
-d '{
"adjustmentType": "I",
"quantity": 1000.00,
"amount": 1250.00,
"comment": "Reconciliation adjustment - stock split 1:1.25",
"transactionDate": "2025-08-14",
"accountID": 12345,
"investmentID": 25,
"productID": 10
}'
# Decrease quantity adjustment
curl -X POST 'https://api.7g.com.au/BizTransaction/AdjustQuantity' \
-H 'Authorization: {accessToken}' \
-H 'Version: 2.0' \
-H 'Content-Type: application/json' \
-d '{
"adjustmentType": "D",
"quantity": 500.00,
"comment": "Error correction - duplicate transaction reversal",
"transactionDate": "2025-08-14",
"accountID": 12345,
"investmentID": 25,
"productID": 10
}'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"
}
}