PUT

/Investment/Price

When to Use

  • Pricing Error Correction: Fix NAV calculation errors, data feed issues, or manual entry mistakes identified before investor reporting
  • Fund Administrator Adjustments: Update pricing after fund administrator NAV recalculations, expense restatements, or valuation corrections
  • Corporate Action Processing: Modify pricing to reflect stock splits, mergers, acquisitions, or special distributions affecting unit values
  • Pricing Committee Approvals: Apply pricing adjustments authorized by pricing committee for fair value determination or suspended securities
  • Distribution Price Adjustments: Update ExPrice, ExNAV, and ExRedemptionPrice after distribution calculation refinements
  • Interest Rate Updates: Correct term deposit or bond interest rates following rate change announcements or data entry errors

Common Scenarios

  • Same-Day NAV Correction: Update today's pricing after identifying calculation error before investor transactions processed
  • Data Feed Error Recovery: Replace incorrect pricing from automated external data feed with corrected values from fund administrator
  • Ex-Distribution Price Refinement: Adjust ex-distribution pricing after final distribution amount confirmed by trustee
  • Compliance-Driven Correction: Update pricing to meet regulatory requirements or auditor recommendations before financial year-end

Prerequisites

  • Valid Bearer token with investment price modification permissions and pricing data update authority
  • Price record must exist for the specified investment and PriceDate combination - use POST to create new dates
  • Verification that no completed transactions reference this pricing (system may restrict updates if transactions exist)
  • Pricing committee or fund administrator approval documentation for pricing changes and corrections
  • Understanding of complete replacement semantics - all fields will be overwritten with provided values (missing optionals set to null)
  • Awareness of portfolio valuation impact - updates immediately reflect in BizEntity Account Holdings displays for all investors

Important Considerations

⚠️ Price Update Impacts and Restrictions

  • Transaction History Impact: Price updates affect all transactions using this pricing - existing investor balances and holdings may recalculate based on new pricing
  • Complete Replacement Semantics: PUT replaces ALL price components - missing optional fields will be set to null, potentially losing existing data
  • Audit Trail Requirements: All pricing changes logged for regulatory audit trail - include justification documentation before executing updates
  • Portfolio Valuation Cascade: Price updates immediately flow to BizEntity Account Holdings displays - investor portfolio values update in real-time
  • Decimal Precision Validation: Updated prices must still comply with investment's NoOfDecimalPlaces configuration - precision mismatches cause validation failures
  • Business Rule Restrictions: Some platforms restrict price updates after transactions processed, reporting periods closed, or regulatory submissions made

Description

Updates existing investment price records with complete replacement of all pricing components. This endpoint performs comprehensive validation to ensure changes maintain price integrity and comply with business rules.

⚠️ Price Update Restrictions

Price records cannot be updated if:

  • Transactions have been processed using the current pricing
  • Price date is more than 30 days old (configurable)
  • Portfolio valuations have been finalized
  • Regulatory reporting has been submitted

Alternative: Create a new price record for future dates instead.

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
Parent product identifier for validation (must match existing price record's product, cannot be changed during update).
ExternalProductId
 string
Optional
External product identifier for cross-system correlation (must match existing record if previously set).
InvestmentID >
integer
Native investment identifier specifying which investment's pricing is being updated (together with PriceDate, identifies the price record).
ExternalInvestmentId
 string
Optional
External investment identifier for cross-system correlation (must match existing record if previously set).
Cost
 decimal
Optional
Total cost per unit including transaction expenses and fees (used for cost-basis calculations and tax reporting).
IndirectCost
 decimal
Optional
Indirect cost component per unit for embedded expenses (platform fees, custody costs, used for fee disclosure).
IndirectFee
 decimal
Optional
Indirect fee component per unit for embedded fees (performance fees, platform fees, used for PDS fee disclosure).
ExNAV
 decimal
Optional
Ex-distribution Net Asset Value after distribution deduction (required for Distribution processing workflows).
ExPrice
 decimal
Optional
Ex-distribution unit price for purchases after distribution cutoff (typically Price minus per-unit distribution amount).
ExRedemptionPrice
 decimal
Optional
Ex-distribution redemption price for withdrawals after distribution cutoff (typically RedemptionPrice minus per-unit distribution).
InterestRate
 decimal
Optional
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a., used for interest calculations).
ManagementFeePerUnit
 decimal
Optional
Management fee charged per unit for this pricing period (used for fee disclosure on investor statements).
NAV
 decimal
Optional
Net Asset Value per unit representing underlying asset value (typically basis for Price and RedemptionPrice calculations).
NetGainLossPerUnitExcelManagementFee
 decimal
Optional
Net gain/loss per unit excluding management fees (used for performance reporting and fee analysis).
Price >
decimal
Standard unit price for BizTransaction deposit operations (must comply with investment's NoOfDecimalPlaces precision, immediately affects new transactions).
PriceDate >
date
Effective date identifying the price record being updated (YYYY-MM-DD format, cannot be changed - use DELETE + POST to change dates).
RedemptionPrice >
decimal
Unit price for BizTransaction redemption operations (must comply with investment's NoOfDecimalPlaces precision).
UpdatedDate
 datetime
Optional
Timestamp when price record was last updated (ISO 8601 format, defaults to current UTC time if not provided).
ProductID
integer
Parent product identifier for validation (must match existing price record's product, cannot be changed during update).
ExternalProductId
string
Optional
External product identifier for cross-system correlation (must match existing record if previously set).
InvestmentID
integer
Native investment identifier specifying which investment's pricing is being updated (together with PriceDate, identifies the price record).
ExternalInvestmentId
string
Optional
External investment identifier for cross-system correlation (must match existing record if previously set).
Cost
decimal
Optional
Total cost per unit including transaction expenses and fees (used for cost-basis calculations and tax reporting).
IndirectCost
decimal
Optional
Indirect cost component per unit for embedded expenses (platform fees, custody costs, used for fee disclosure).
IndirectFee
decimal
Optional
Indirect fee component per unit for embedded fees (performance fees, platform fees, used for PDS fee disclosure).
ExNAV
decimal
Optional
Ex-distribution Net Asset Value after distribution deduction (required for Distribution processing workflows).
ExPrice
decimal
Optional
Ex-distribution unit price for purchases after distribution cutoff (typically Price minus per-unit distribution amount).
ExRedemptionPrice
decimal
Optional
Ex-distribution redemption price for withdrawals after distribution cutoff (typically RedemptionPrice minus per-unit distribution).
InterestRate
decimal
Optional
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a., used for interest calculations).
ManagementFeePerUnit
decimal
Optional
Management fee charged per unit for this pricing period (used for fee disclosure on investor statements).
NAV
decimal
Optional
Net Asset Value per unit representing underlying asset value (typically basis for Price and RedemptionPrice calculations).
NetGainLossPerUnitExcelManagementFee
decimal
Optional
Net gain/loss per unit excluding management fees (used for performance reporting and fee analysis).
Price
decimal
Standard unit price for BizTransaction deposit operations (must comply with investment's NoOfDecimalPlaces precision, immediately affects new transactions).
PriceDate
date
Effective date identifying the price record being updated (YYYY-MM-DD format, cannot be changed - use DELETE + POST to change dates).
RedemptionPrice
decimal
Unit price for BizTransaction redemption operations (must comply with investment's NoOfDecimalPlaces precision).
UpdatedDate
datetime
Optional
Timestamp when price record was last updated (ISO 8601 format, defaults to current UTC time if not provided).

Complete Replacement Update

PUT operations require all fields to be provided:

  • Investment & Product IDs: Must match the existing price record
  • PriceDate: Must match the record being updated
  • All pricing fields: Will be replaced with provided values
Important: Missing optional fields will be set to null.

Example Requests

json
{
  "ProductID": 100,
  "ExternalProductId": "FUND-001",
  "InvestmentID": 12345,
  "ExternalInvestmentId": "INV-001",
  "Cost": 1.0130,
  "IndirectCost": 0.0025,
  "IndirectFee": 0.0050,
  "ExNAV": 0.9880,
  "ExPrice": 0.9905,
  "ExRedemptionPrice": 0.9855,
  "InterestRate": 5.25,
  "ManagementFeePerUnit": 0.0075,
  "NAV": 1.0005,
  "NetGainLossPerUnitExcelManagementFee": 0.0455,
  "Price": 1.0030,
  "PriceDate": "2025-08-16",
  "RedemptionPrice": 0.9980,
  "UpdatedDate": "2025-08-16T14:30:00Z"
}

Response Examples

json
{
  "result": true,
  "message": "Investment price updated successfully",
  "recordCount": 1,
  "data": {
    "productID": 100,
    "externalProductId": "FUND-001",
    "investmentID": 12345,
    "externalInvestmentId": "INV-001",
    "cost": 1.0130,
    "indirectCost": 0.0025,
    "indirectFee": 0.0050,
    "exNAV": 0.9880,
    "exPrice": 0.9905,
    "exRedemptionPrice": 0.9855,
    "interestRate": 5.25,
    "managementFeePerUnit": 0.0075,
    "nav": 1.0005,
    "netGainLossPerUnitExcelManagementFee": 0.0455,
    "price": 1.0030,
    "priceDate": "2025-08-16",
    "redemptionPrice": 0.9980,
    "updatedDate": "2025-08-16T14:30:00Z"
  }
}
GET Get investment prices POST Create investment prices GET Get investments