📈 Investment Resource

Investment product lifecycle and precision pricing management

Investment records define tradeable unit classes with allotment rules, distribution settings, pricing precision, and lifecycle dates. Pricing data managed through separate InvestmentPrice endpoints flows automatically to Account Holdings for real-time portfolio valuations.

8
Endpoints
31+18
DTO Properties
2-Tier
Structure
0-6
Decimal Precision

Usage Notes

When

  • Create and manage investment products (unit classes, share classes, term deposits)
  • Configure pricing, allotment rules, and distribution settings
  • Manage time-series pricing data for portfolio valuations

Requirements

  • Valid Bearer token with investment permissions
  • Parent Product must exist before creating investments

Notes

  • Investments define unit/share classes within parent Products
  • InvestmentPrice records provide historical pricing for transaction valuations
  • Price updates automatically flow to Account Holdings for portfolio valuations
  • NoOfDecimalPlaces (0-6) effectively immutable after transactions exist

Available Endpoints

Core Investment Operations

GET Get Investments Retrieve investment products with pricing history and classification filters
POST Create Investment Register investment product with unit classes and distribution settings
PUT Update Investment Update investment with pricing and metadata validation
DELETE Delete Investment Remove investment (restricted if active transactions exist)

Price Management Operations

GET Get Prices Historical pricing with NAV and audit trails
POST Create Price Register pricing with validation and audit timestamp
PUT Update Price Update pricing with effective date validation
DELETE Delete Price Remove pricing (restricted if referenced by transactions)

Core Data Transfer Objects

InvestmentDTO POST, PUT, GET Investment endpoints Investment product definition (31 properties) with lifecycle dates, allotment thresholds, distribution settings, decimal precision control, and regulatory compliance configuration
InvestmentPriceDTO All Price endpoints Time-series pricing data (18 properties) with NAV components, pricing variants, cost tracking, management fees, interest rates, and audit timestamps for transaction processing and portfolio valuation

Filter Data Transfer Objects

GET endpoints use filter classes to bind query parameters. These are request-only structures for filtering and pagination.

InvestmentFilter GET /Investment 7 properties: 4 direct ID lookups (InvestmentID, ExternalInvestmentId, ProductID, ExternalProductId) + AsAtDate temporal query + pagination (PageNumber, PageSize)
InvestmentPriceFilter GET /Investment/Price 7 properties: 4 direct ID lookups (InvestmentID, ExternalInvestmentId, ProductID, ExternalProductId) + 3 date filters (PriceDate, FromPriceDate, ToPriceDate) - no pagination

Business Rules & Constraints

Product-Price Architecture & Dependencies

  • Parent-Child Relationship: Investment records define unit/share classes within parent Product records - Product must exist before Investment creation
  • Time-Series Pricing: InvestmentPrice records provide historical pricing snapshots for transaction valuation - multiple price dates per investment supported
  • Cascading Deletion Protection: Investment deletion requires ALL associated InvestmentPrice records deleted first - protects transaction valuation integrity
  • Immediate Valuation Impact: Price updates automatically flow to BizEntity Account Holdings displays - portfolio valuations update for investor views
  • Transaction Processing Chain: Investment (product definition) → InvestmentPrice (valuation) → BizTransaction (execution) → Account Holdings (portfolio tracking)

Regulatory Compliance & Reporting

  • APIR Code Requirements: Australian public investment offerings require valid APIR codes (securityCode field) for ASIC reporting and regulatory compliance
  • Tax Statement Inclusion: isIncludedInAnnualReporting flag controls whether investment appears on investor annual tax statements and compliance reports
  • Decimal Precision Standards: noOfDecimalPlaces setting (0-6) must align with regulatory disclosure requirements and fund terms - affects all transaction calculations and investor statements
  • AllotmentCutoffDate Enforcement: System automatically rejects new investments after cutoff date regardless of IsActive status - enforces regulatory closure requirements
  • Audit Trail: Investment modifications logged for regulatory audit - price history immutability ensures valuation accuracy for historical compliance reporting

Transaction Processing & Business Logic

  • IsActive Control: Only active investments (isActive=true) process deposits/redemptions through BizTransaction endpoints - controls transaction processing
  • Price Date Snapshots: Transaction valuations use nearest price date snapshot - missing price dates cause transaction validation failures
  • AllowDistribution Eligibility: Distribution processing workflows require allowDistribution=true - controls distribution declaration and payment operations
  • Allotment Threshold Enforcement: allotmentMinAmount and allotmentMaxAmount validated during transaction processing - prevents non-compliant investment amounts
  • Decimal Precision Consistency: All transaction calculations respect noOfDecimalPlaces setting - precision mismatch causes calculation errors and statement display issues

Holdings & Valuation Integration

Investment pricing directly integrates with BizEntity Account Holdings for real-time portfolio valuations. Price updates automatically reflect in holder accounts.