POST
/BizEvent/NoticeOfConversion
When to Use
- Coordinate investment class conversions (Class A→Class B units) with proper notice periods, regulatory compliance tracking, and investor approval verification
- Process wholesale-to-retail unit class changes with fee structure transitions, minimum investment threshold adjustments, and disclosure requirements
- Execute corporate action-triggered conversions with automated conversionFactor calculations, unit allocation precision, and holdings rebalancing
- Manage tax-deferred conversions where noChangeOfBeneficialOwner=true minimizes CGT implications and preserves cost base for investors
- Create dual-event coordination layer before BizTransaction/Conversion execution (source redemption + target allotment) ensuring atomic transaction processing
Prerequisites
- Valid Bearer token with event creation permissions
- Source and target investments must be within same product hierarchy - cross-product conversions not supported
- ConversionFactor calculated and validated (e.g., 0.85 = 100 source units become 85 target units) based on pricing methodology
- Investment configuration allows conversions - verify both fromInvestmentID and toInvestmentID have compatible conversion settings
- Valid InvestmentPrice records for both source and target investments on transactionDate
Considerations
⚠️ Critical Conversion Processing Rules
- Dual-Transaction Pattern: Creates TWO BizEvent records (source redemption + target allotment) - both must succeed or entire conversion rolls back
- ConversionFactor Precision: Multiplier affects final unit allocation (0.85 factor on 1000 units = 850 target units) - verify factor accuracy before processing
- Tax Treatment: CGT implications depend on beneficial ownership change - same entity conversions may defer tax liability
- Notice Period Requirements: Regulatory mandates may require 14-30 day notice periods for unit class conversions depending on jurisdiction
- Atomic Processing: Both events must complete successfully - partial conversion failures require full rollback and investor notification
Description
Creates a notice of conversion event to notify stakeholders of investment type conversions. Generates event records for audit trail and triggers investor communication workflows. Supports conversion between different investment classes with configurable conversion factors.
Conversion Process
Conversion notices are generated when investors switch between investment types (e.g., Class A to Class B units). The system calculates converted quantities using the specified conversion factor and method.
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 |
|---|---|---|---|
ProductID |
integer | Native 7G identifier for the product containing the investments. | |
externalBizTransactionId |
string | Optional |
External transaction identifier for cross-system reference and audit trail. |
externalProductId |
string | Your external identifier for the product (alternative to productID). | |
fromInvestmentID |
integer | Native 7G identifier for the source investment class being converted from. | |
fromExternalInvestmentId |
string | Your external identifier for the source investment (alternative to fromInvestmentID). | |
toInvestmentID |
integer | Native 7G identifier for the target investment class being converted to. | |
toExternalInvestmentId |
string | Your external identifier for the target investment (alternative to toInvestmentID). | |
AccountID |
integer | Native 7G identifier for the account containing the holdings to be converted. | |
externalAccountId |
string | Your external identifier for the account (alternative to accountID). | |
amount |
decimal | Optional |
Monetary value of the conversion. Used for conversion calculations and audit trail. |
quantity |
decimal | Optional |
Number of units being converted from the source investment. |
comment |
string | Optional |
Additional notes, reason for conversion, or investor instructions. |
transactionDate |
date | Optional |
Effective date when the conversion occurs (YYYY-MM-DD format). Defaults to current date if not specified. |
conversionFactor |
decimal | Optional |
Multiplier to calculate converted units (e.g., 0.85 means 100 source units = 85 target units). |
conversionMethod |
string | Optional |
Method used for the conversion calculation (e.g., NAV_Based, Fixed_Ratio, Price_Based). |
ProductID
Native 7G identifier for the product containing the investments.
externalBizTransactionId
External transaction identifier for cross-system reference and audit trail.
externalProductId
Your external identifier for the product (alternative to productID).
fromInvestmentID
Native 7G identifier for the source investment class being converted from.
fromExternalInvestmentId
Your external identifier for the source investment (alternative to fromInvestmentID).
toInvestmentID
Native 7G identifier for the target investment class being converted to.
toExternalInvestmentId
Your external identifier for the target investment (alternative to toInvestmentID).
AccountID
Native 7G identifier for the account containing the holdings to be converted.
externalAccountId
Your external identifier for the account (alternative to accountID).
amount
Monetary value of the conversion. Used for conversion calculations and audit trail.
quantity
Number of units being converted from the source investment.
comment
Additional notes, reason for conversion, or investor instructions.
transactionDate
Effective date when the conversion occurs (YYYY-MM-DD format). Defaults to current date if not specified.
conversionFactor
Multiplier to calculate converted units (e.g., 0.85 means 100 source units = 85 target units).
conversionMethod
Method used for the conversion calculation (e.g., NAV_Based, Fixed_Ratio, Price_Based).
Example Requests
json
{
"productID": 100,
"externalBizTransactionId": "CONV-001",
"externalProductId": "PROD-001",
"fromInvestmentID": 200,
"fromExternalInvestmentId": "INV-CLASS-A",
"toInvestmentID": 201,
"toExternalInvestmentId": "INV-CLASS-B",
"accountID": 5678,
"externalAccountId": "ACC-001",
"amount": 25000.00,
"quantity": 1000.00,
"comment": "Class A to Class B conversion per investor request",
"transactionDate": "2024-02-15",
"conversionFactor": 0.85,
"conversionMethod": "NAV_Based"
}Response Examples
json
{
"result": true,
"message": "Conversion notice created successfully",
"recordCount": 2,
"data": [
{
"bizEventID": 50003,
"bizEventTypeID": 50,
"bizEventStatusID": 1,
"productID": 100,
"externalProductId": "PROD-001",
"investmentID": 200,
"externalInvestmentId": "INV-CLASS-A",
"accountID": 5678,
"externalAccountId": "ACC-001",
"accountNumber": "ACC123456",
"bizEntityName": "Smith Family Trust",
"bizEventDate": "2024-02-15",
"amount": 25000.00,
"quantity": 1000.00,
"comment": "Class A to Class B conversion per investor request (source redemption)",
"conversionMethodID": 1,
"conversionFactor": 0.85,
"createdDate": "2024-02-15T10:15:00Z",
"updatedDate": null
},
{
"bizEventID": 50004,
"bizEventTypeID": 50,
"bizEventStatusID": 1,
"productID": 100,
"externalProductId": "PROD-001",
"investmentID": 201,
"externalInvestmentId": "INV-CLASS-B",
"accountID": 5678,
"externalAccountId": "ACC-001",
"accountNumber": "ACC123456",
"bizEntityName": "Smith Family Trust",
"bizEventDate": "2024-02-15",
"amount": 25000.00,
"quantity": 850.00,
"comment": "Class A to Class B conversion per investor request (target allotment)",
"conversionMethodID": 1,
"conversionFactor": 0.85,
"createdDate": "2024-02-15T10:15:00Z",
"updatedDate": null
}
]
}