PUT
/Investment/Price
Usage Notes
When
- Fix NAV calculation errors or data feed issues
- Update pricing after fund administrator recalculations
- Correct ex-distribution pricing or interest rates
Requirements
- Price record must exist for the specified investment and PriceDate
- Updated prices must match investment's NoOfDecimalPlaces configuration
Notes
- PUT replaces ALL fields - missing optional fields become null
- Price updates immediately affect portfolio valuations
- Updates affect all transactions using this pricing
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.
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 | 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
Parent product identifier for validation (must match existing price record's product, cannot be changed during update).
ExternalProductId
External product identifier for cross-system correlation (must match existing record if previously set).
InvestmentID
Native investment identifier specifying which investment's pricing is being updated (together with PriceDate, identifies the price record).
ExternalInvestmentId
External investment identifier for cross-system correlation (must match existing record if previously set).
Cost
Total cost per unit including transaction expenses and fees (used for cost-basis calculations and tax reporting).
IndirectCost
Indirect cost component per unit for embedded expenses (platform fees, custody costs, used for fee disclosure).
IndirectFee
Indirect fee component per unit for embedded fees (performance fees, platform fees, used for PDS fee disclosure).
ExNAV
Ex-distribution Net Asset Value after distribution deduction (required for Distribution processing workflows).
ExPrice
Ex-distribution unit price for purchases after distribution cutoff (typically Price minus per-unit distribution amount).
ExRedemptionPrice
Ex-distribution redemption price for withdrawals after distribution cutoff (typically RedemptionPrice minus per-unit distribution).
InterestRate
Interest rate percentage for term deposits and bonds (e.g., 5.25 = 5.25% p.a., used for interest calculations).
ManagementFeePerUnit
Management fee charged per unit for this pricing period (used for fee disclosure on investor statements).
NAV
Net Asset Value per unit representing underlying asset value (typically basis for Price and RedemptionPrice calculations).
NetGainLossPerUnitExcelManagementFee
Net gain/loss per unit excluding management fees (used for performance reporting and fee analysis).
Price
Standard unit price for BizTransaction deposit operations (must comply with investment's NoOfDecimalPlaces precision, immediately affects new transactions).
PriceDate
Effective date identifying the price record being updated (YYYY-MM-DD format, cannot be changed - use DELETE + POST to change dates).
RedemptionPrice
Unit price for BizTransaction redemption operations (must comply with investment's NoOfDecimalPlaces precision).
UpdatedDate
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
bash
# Update investment price
curl -X PUT 'https://api.7g.com.au/Investment/Price' \
-H 'Authorization: {accessToken}' \
-H 'Version: 2.0' \
-H 'Content-Type: application/json' \
-d '{
"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"
}
}