POST
/BizTransaction/Conversion
When to Use
- Convert between different investment classes or asset categories
- Process fee optimization conversions (retail to wholesale units)
- Execute mandatory conversions during fund restructures or mergers
- Implement corporate action conversion requirements
- Handle portfolio rebalancing between investment types
Prerequisites
- Source investment must have sufficient units for conversion
- Valid conversion path configured between source and target investments
- Both investments must be active and support conversion operations
Important Considerations
⚠️ Critical Implementation Notes
- Dual Transaction Nature: Creates linked redemption (-ve) and allotment (+ve) transactions requiring coordinated processing
- Conversion Factor Accuracy: Factor determines unit allocation ratio (1.0 = equal, 0.95 = 5% reduction) - critical for calculations
- Tax-Effective Structuring: May trigger taxable events unless explicitly structured as tax-deferred rollover
- Corporate Action Compliance: Mandatory conversions must comply with ASIC requirements and investor notification obligations
- Regulatory Approval Requirements: Some conversions require prior ASIC approval or investor consent procedures
Description
Processes investment conversions by simultaneously redeeming holdings from a source investment and allocating equivalent value to a target investment. The system handles conversion factors, pricing calculations, and maintains complete audit trails for both sides of the conversion.
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 |
|---|---|---|---|
amount |
number (double) | Dollar amount to convert from source investment (creates TWO transactions: from-redemption with calculated negative quantity, to-allotment with conversionFactor-adjusted quantity). | |
conversionFactor |
number (double) | Optional |
Conversion ratio multiplier determining target investment quantity from source quantity (from-quantity × conversionFactor = to-quantity, e.g., 1.0 = equal unit exchange, 0.95 = 5% reduction). |
conversionMethodID |
integer (int32) | Optional |
Conversion calculation method controlling pricing methodology and CGT treatment (determines taxable event vs rollover relief). |
accountID |
integer (int32) | Native account identifier where conversion executes (same account for both from-redemption and to-allotment transactions within account). | |
externalAccountId |
string | External account identifier for cross-platform integration (resolves to internal accountID for dual-transaction creation). | |
fromComment |
string | Optional |
Audit comment for source investment redemption transaction (appears on account statements under redemption transaction). |
fromExternalBizTransactionId |
string | Optional |
External identifier for source investment redemption transaction preventing duplicate from-investment reductions during integration failures. |
fromInvestmentID |
integer (int32) | Native source investment identifier from which units will be redeemed (creates negative-quantity BizTransaction, system validates sufficient holdings). | |
fromExternalInvestmentId |
string | External source investment identifier for cross-platform integration (resolves to internal fromInvestmentID for holdings validation). | |
quantity |
number (double) | Exact unit quantity to convert from source investment (creates TWO transactions: from-investment with negative quantity, to-investment with quantity × conversionFactor). | |
toComment |
string | Optional |
Audit comment for target investment allotment transaction (appears on account statements under allotment transaction). |
toExternalBizTransactionId |
string | Optional |
External identifier for target investment allotment transaction preventing duplicate to-investment increases during integration failures. |
toInvestmentID |
integer (int32) | Native target investment identifier receiving converted units (creates positive-quantity BizTransaction, must differ from fromInvestmentID). | |
toExternalInvestmentId |
string | External target investment identifier for cross-platform integration (resolves to internal toInvestmentID for holdings update). | |
transactionDate |
string (date) | Transaction settlement date for dual-transaction conversion determining pricing dates and CGT event date (format: YYYY-MM-DD, must not be DateOnly.MinValue per controller line 209). | |
productID |
integer (int32) | Native product identifier validating both investments and account belong to correct fund structure. | |
externalProductId |
string | External product identifier for cross-system product correlation (resolves to internal productID for validation). |
amount
Dollar amount to convert from source investment (creates TWO transactions: from-redemption with calculated negative quantity, to-allotment with conversionFactor-adjusted quantity).
conversionFactor
Conversion ratio multiplier determining target investment quantity from source quantity (from-quantity × conversionFactor = to-quantity, e.g., 1.0 = equal unit exchange, 0.95 = 5% reduction).
conversionMethodID
Conversion calculation method controlling pricing methodology and CGT treatment (determines taxable event vs rollover relief).
accountID
Native account identifier where conversion executes (same account for both from-redemption and to-allotment transactions within account).
externalAccountId
External account identifier for cross-platform integration (resolves to internal accountID for dual-transaction creation).
fromComment
Audit comment for source investment redemption transaction (appears on account statements under redemption transaction).
fromExternalBizTransactionId
External identifier for source investment redemption transaction preventing duplicate from-investment reductions during integration failures.
fromInvestmentID
Native source investment identifier from which units will be redeemed (creates negative-quantity BizTransaction, system validates sufficient holdings).
fromExternalInvestmentId
External source investment identifier for cross-platform integration (resolves to internal fromInvestmentID for holdings validation).
quantity
Exact unit quantity to convert from source investment (creates TWO transactions: from-investment with negative quantity, to-investment with quantity × conversionFactor).
toComment
Audit comment for target investment allotment transaction (appears on account statements under allotment transaction).
toExternalBizTransactionId
External identifier for target investment allotment transaction preventing duplicate to-investment increases during integration failures.
toInvestmentID
Native target investment identifier receiving converted units (creates positive-quantity BizTransaction, must differ from fromInvestmentID).
toExternalInvestmentId
External target investment identifier for cross-platform integration (resolves to internal toInvestmentID for holdings update).
transactionDate
Transaction settlement date for dual-transaction conversion determining pricing dates and CGT event date (format: YYYY-MM-DD, must not be DateOnly.MinValue per controller line 209).
productID
Native product identifier validating both investments 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
{
"amount": 50000.00,
"conversionFactor": 1.0,
"conversionMethodID": 1,
"accountID": 12345,
"fromComment": "Fee class upgrade - reached wholesale threshold",
"fromExternalBizTransactionId": "CONV-OUT-2024-001",
"fromInvestmentID": 25,
"quantity": null,
"toComment": "Converted to wholesale class - lower fees",
"toExternalBizTransactionId": "CONV-IN-2024-001",
"toInvestmentID": 26,
"transactionDate": "2024-08-14",
"productID": 10
}Response Examples
json
{
"result": true,
"message": "Conversion processed successfully",
"recordCount": 2,
"data": [
{
"bizTransactionID": 2001,
"externalBizTransactionId": "CONV-OUT-2024-001",
"bizTransactionTypeID": 2,
"typeName": "Redemption",
"movementReasonCode": "CONVERSION_OUT",
"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-A",
"securityCode": "GRA001",
"investmentName": "Growth Investment Class A",
"investmentPrice": 1.2500,
"comment": "Converting from Growth Class A",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": -50000.00,
"quantity": -40000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:15Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
},
{
"bizTransactionID": 2002,
"externalBizTransactionId": "CONV-IN-2024-001",
"bizTransactionTypeID": 1,
"typeName": "Deposit",
"movementReasonCode": "CONVERSION_IN",
"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": 26,
"externalInvestmentId": "INV-GROWTH-B",
"securityCode": "GRB001",
"investmentName": "Growth Investment Class B",
"investmentPrice": 1.2500,
"comment": "Converting to Growth Class B",
"corporateActionID": null,
"externalCorporateActionId": null,
"corporateActionName": null,
"amount": 50000.00,
"quantity": 40000.00,
"transactionClosingAmount": null,
"transactionClosingQuantity": null,
"accountClosingAmount": null,
"accountClosingQuantity": null,
"createdDate": "2025-08-14T10:30:16Z",
"updatedDate": null,
"bizTransactionStatusID": 1,
"statusName": "Complete"
}
]
}