POST

/BizEvent/NoticeOfConversion

When to Use

  • Create conversion event notice records for investment class conversions
  • Record conversion details including source/target investments, quantities, and conversion factors
  • Create dual event records (source redemption and target allotment) for conversion tracking

Prerequisites

  • Valid source and target investment identifiers (native or external)
  • Valid account identifier (native or external)
  • TransactionDate in YYYY-MM-DD format

Considerations

  • Returns two event records upon successful creation: source investment redemption and target investment allotment
  • ConversionFactor specifies unit allocation ratio between source and target investments
  • ConversionMethod describes the calculation methodology used

Description

Creates two linked conversion event records: source investment redemption and target investment allotment. Returns both event records with assigned BizEventIDs for tracking purposes. Accepts conversion factor and method specifications.

Conversion Event Records

Conversion creates two linked event records representing the source redemption and target allotment for investment class conversions.

Required Headers - See Authentication

HeaderValueDescription
Content-Typeapplication/jsonRequest content type
Authorization{accessToken}Bearer token for API access
Version2.0API version identifier

Request Body

Parameter Type Required Description
ProductID >
integer
Native 7G identifier for the product.
externalBizTransactionId
 string
Optional
External transaction identifier for system integration.
externalProductId >
string
External system identifier for the product (alternative to productID).
fromInvestmentID >
integer
Native 7G identifier for the source investment.
fromExternalInvestmentId >
string
External system identifier for the source investment (alternative to fromInvestmentID).
toInvestmentID >
integer
Native 7G identifier for the target investment.
toExternalInvestmentId >
string
External system identifier for the target investment (alternative to toInvestmentID).
AccountID >
integer
Native 7G identifier for the account.
externalAccountId >
string
External system identifier for the account (alternative to accountID).
amount
 decimal
Optional
Monetary value of the conversion.
quantity
 decimal
Optional
Number of units being converted from the source investment.
comment
 string
Optional
Additional notes or reason for conversion.
transactionDate
 date
Optional
Effective date for the conversion (YYYY-MM-DD format).
conversionFactor
 decimal
Optional
Multiplier for unit conversion calculations between source and target investments.
conversionMethod
 string
Optional
Method identifier for the conversion calculation.
ProductID
integer
Native 7G identifier for the product.
externalBizTransactionId
string
Optional
External transaction identifier for system integration.
externalProductId
string
External system identifier for the product (alternative to productID).
fromInvestmentID
integer
Native 7G identifier for the source investment.
fromExternalInvestmentId
string
External system identifier for the source investment (alternative to fromInvestmentID).
toInvestmentID
integer
Native 7G identifier for the target investment.
toExternalInvestmentId
string
External system identifier for the target investment (alternative to toInvestmentID).
AccountID
integer
Native 7G identifier for the account.
externalAccountId
string
External system identifier for the account (alternative to accountID).
amount
decimal
Optional
Monetary value of the conversion.
quantity
decimal
Optional
Number of units being converted from the source investment.
comment
string
Optional
Additional notes or reason for conversion.
transactionDate
date
Optional
Effective date for the conversion (YYYY-MM-DD format).
conversionFactor
decimal
Optional
Multiplier for unit conversion calculations between source and target investments.
conversionMethod
string
Optional
Method identifier for the conversion calculation.

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
    }
  ]
}
GET Get BizEvents POST Conversion PUT Cancel Event