POST

/BizTransaction/Conversion

Usage Notes

When

  • Switch between investment classes within the same account
  • Execute investment-to-investment conversions
  • Process product rebalancing within an account

Requirements

  • Account must hold the source investment
  • Both investments must exist with active pricing
  • Sufficient holdings in source investment

Notes

  • Creates TWO linked BizTransaction records (from-investment redemption and to-investment deposit)
  • Response returns array with both transaction records
  • Conversion factor and method determine unit calculation

Description

Creates a conversion that switches from one investment to another within the same account. Returns TWO linked transaction records representing the redemption and deposit legs.

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
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 identifier controlling pricing methodology for the conversion operation.
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 date for both conversion records. Format: YYYY-MM-DD. Same date used for both redemption/deposit transactions. Cannot be empty or default value.
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
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 identifier controlling pricing methodology for the conversion operation.
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 date for both conversion records. Format: YYYY-MM-DD. Same date used for both redemption/deposit transactions. Cannot be empty or default value.
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).

Example Requests

bash
# Amount-based conversion
curl -X POST 'https://api.7g.com.au/BizTransaction/Conversion' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 50000.00,
    "conversionFactor": 1.0,
    "conversionMethodID": 1,
    "accountID": 12345,
    "fromComment": "Fee class upgrade - reached wholesale threshold",
    "fromInvestmentID": 25,
    "toComment": "Converted to wholesale class - lower fees",
    "toInvestmentID": 26,
    "transactionDate": "2025-08-14",
    "productID": 10
  }'

# Quantity-based conversion
curl -X POST 'https://api.7g.com.au/BizTransaction/Conversion' \
  -H 'Authorization: {accessToken}' \
  -H 'Version: 2.0' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 40000.00,
    "conversionFactor": 1.0,
    "conversionMethodID": 1,
    "accountID": 12345,
    "fromInvestmentID": 25,
    "toInvestmentID": 26,
    "transactionDate": "2025-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"
    }
  ]
}
GET Get BizTransactions POST Transfer POST Deposit GET Get Account Holdings