POST
/BizEvent/NoticeOfRedemption
When to Use
- Process investor withdrawal requests with CGT calculation preparation, tax reporting requirements, and exit fee disclosure
- Coordinate large redemption workflows requiring extended notice periods (>10% of fund NAV) with liquidity assessment and fund manager approval
- Generate redemption notices for retirement phase SMSF withdrawals with minimum pension payment compliance and preservation age verification
- Trigger market impact assessments for significant redemptions affecting fund liquidity positions and rebalancing requirements
- Create pre-transaction coordination layer before BizTransaction/Redemption execution ensuring proper settlement timing and cash flow management
Prerequisites
- Valid Bearer token with event creation permissions
- Sufficient account holdings verified via Holdings query - redemption quantity/amount cannot exceed available balance
- Investment redemption status validated (not suspended for withdrawals due to market conditions or regulatory restrictions)
- Valid InvestmentPrice record for transactionDate - required for settlement value calculations
- Market conditions allowing redemptions - verify fund is not subject to temporary withdrawal suspension
Considerations
⚠️ Critical Redemption Processing Rules
- CGT Implications: All redemptions trigger capital gains tax calculations - transactionDate determines financial year allocation and tax reporting obligations
- Large Redemption Thresholds: Withdrawals >10% of fund NAV may require extended notice periods (30-90 days) and fund manager approval
- Exit Fee Disclosure: Exit fees must be disclosed in investor communications - percentage-based or fixed amount depending on product configuration
- Holdings Validation: System validates sufficient holdings before processing - insufficient balance results in rejection at service layer
- Settlement Timing: Redemption settlement typically T+3 to T+7 depending on underlying asset liquidity and fund rules
Description
Creates a notice of redemption event to confirm investor withdrawal requests and settlement details. Generates event records for compliance audit trail and triggers stakeholder notification workflows. Supports both amount-based and quantity-based redemptions with automatic settlement calculations.
Redemption Processing
Redemption notices confirm the acceptance and processing of investor withdrawal requests. The system calculates settlement amounts using current unit prices and applicable exit fees.
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 investment. | |
externalProductId |
string | Your external identifier for the product (alternative to productID). | |
externalBizTransactionId |
string | Optional |
External transaction identifier for cross-system reference and audit trail. |
InvestmentID |
integer | Native 7G identifier for the investment being redeemed from. | |
externalInvestmentId |
string | Your external identifier for the investment (alternative to investmentID). | |
AccountID |
integer | Native 7G identifier for the account containing the holdings to redeem. | |
externalAccountId |
string | Your external identifier for the account (alternative to accountID). | |
amount |
decimal | Optional |
Monetary value to be redeemed. System calculates corresponding unit quantity based on current pricing. |
quantity |
decimal | Optional |
Number of units to redeem. System calculates monetary value based on current unit pricing. |
comment |
string | Optional |
Additional notes, redemption reason, or special instructions for processing. |
transactionDate |
date | Optional |
Effective date when the redemption is processed (YYYY-MM-DD format). Defaults to current date if not specified. |
ProductID
Native 7G identifier for the product containing the investment.
externalProductId
Your external identifier for the product (alternative to productID).
externalBizTransactionId
External transaction identifier for cross-system reference and audit trail.
InvestmentID
Native 7G identifier for the investment being redeemed from.
externalInvestmentId
Your external identifier for the investment (alternative to investmentID).
AccountID
Native 7G identifier for the account containing the holdings to redeem.
externalAccountId
Your external identifier for the account (alternative to accountID).
amount
Monetary value to be redeemed. System calculates corresponding unit quantity based on current pricing.
quantity
Number of units to redeem. System calculates monetary value based on current unit pricing.
comment
Additional notes, redemption reason, or special instructions for processing.
transactionDate
Effective date when the redemption is processed (YYYY-MM-DD format). Defaults to current date if not specified.
Example Requests
json
{
"productID": 100,
"externalProductId": "PROD-001",
"externalBizTransactionId": "REDEMP-001",
"investmentID": 200,
"externalInvestmentId": "INV-REDEMP-001",
"accountID": 5678,
"externalAccountId": "ACC-001",
"amount": 25000.00,
"quantity": 1000.00,
"comment": "Partial redemption for liquidity needs",
"transactionDate": "2024-03-15"
}Response Examples
json
{
"result": true,
"message": "Redemption notice created successfully",
"recordCount": 1,
"data": {
"bizEventID": 50002,
"bizEventTypeID": 52,
"bizEventStatusID": 1,
"productID": 100,
"externalProductId": "PROD-001",
"investmentID": 200,
"externalInvestmentId": "INV-REDEMP-001",
"accountID": 5678,
"externalAccountId": "ACC-001",
"accountNumber": "ACC123456",
"bizEntityName": "Smith Family Trust",
"bizEventDate": "2024-03-15",
"amount": 25000.00,
"quantity": 1000.00,
"comment": "Partial redemption for liquidity needs",
"conversionMethodID": null,
"conversionFactor": null,
"createdDate": "2024-03-15T14:20:00Z",
"updatedDate": null
}
}