📈 Investment Resource

Investment product lifecycle and precision pricing management

Investment product lifecycle management from creation through pricing to transaction processing. Handles unit/share class definitions, pricing history management, regulatory compliance settings (APIR codes), and automated portfolio valuation with decimal precision control and distribution eligibility configuration.

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

📊 Product Lifecycle Control

Investment product definitions with unit/share class configuration, allotment rules (min/max amounts), distribution eligibility settings, term structures (days/months), and APIR code regulatory compliance for Australian market requirements.

💰 Precision Pricing Management

Time-series pricing data with configurable decimal precision (0-6 places), NAV vs transaction price separation, management fee tracking, interest rate recording, and automatic portfolio valuation updates flowing to investor holdings.

🔗 Transaction Integration

Seamless integration with BizTransaction deposit/redemption operations, automated Account Holdings valuation updates, distribution processing workflows, and external system connectivity through dual-ID architecture (native + external IDs).

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 (30 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 6 properties: 4 direct ID lookups (InvestmentID, ExternalInvestmentId, ProductID, ExternalProductId) + 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

Common Use Cases

📊

Investment Product Lifecycle Management

Create and manage investment product definitions including unit/share classes, lifecycle dates (start/end/cutoff), allotment rules (min/max amounts), and regulatory compliance settings (APIR codes, decimal precision) for managed funds, term deposits, and direct equities.

💰

Pricing Strategy & Valuation Updates

Maintain time-series pricing data with daily NAV updates, management fee tracking, and ex-distribution pricing adjustments. Support multiple pricing scenarios (buy/sell spreads, redemption prices) flowing automatically to investor Account Holdings for portfolio valuations.

🎯

Distribution Eligibility Configuration

Configure distribution settings including allowDistribution flags, distribution periods (monthly/quarterly/annual), and dividend calculation rules (including first day). Integration with Distribution workflow for automated corporate action processing and DRP eligibility management.

🔗

Transaction Processing Integration

Enable deposit/redemption transaction processing through isActive control flags, pricing availability validation, and allotment threshold enforcement. Seamless integration with BizTransaction resource for investor buy/sell operations and automated holdings updates.

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.