Managing Client Investment Deployments
PublishedArticle Content
--- id: KB-DEPLOY-001 module: deployment sub_module: deployment title: Managing Client Investment Deployments category: how-to applies_to: - user_type: advisor - role: financial_advisor products: - IFANOW Portfolio Management platform_area: portfolio related_workflows: - goal-based-investment-planning - asset-allocation-management depends_on: - KB-ADVICE-001 - KB-MUTUALFUND-001 - KB-GOAL-001 access_level: advisor source: code_extraction source_files: - repo: ifanow-futurewise files: - DeploymentController.java - DeploymentService.java - DeploymentDao.java last_extracted: '2026-02-17' confidence: high version: 1 tags: - investment deployment - portfolio allocation - goal-based investing - asset management - client investments - fund purchasing - exclusions --- ``` ## Overview Investment Deployments help you manage and track how client funds are allocated across different investment vehicles to achieve their financial goals. This feature allows you to organize client investments into goal-based and non-goal-based categories, track available amounts, exclude portions from investment, and execute actual investment purchases. Key capabilities include viewing all client deployments with breakdowns, adding new deployment entries for client assets, setting exclusion amounts with reasons, purchasing mutual fund schemes directly from deployments, and archiving completed or inactive deployments. ## Prerequisites and Access You need an active IFANOW advisor account with portfolio management permissions. Navigate to the client's portfolio section and select "Deployments" from the investment management menu. Ensure the client has completed goal planning and asset allocation before creating deployments. ## How-To Steps ### How to View Client Deployment List View all investment deployments for a specific client and family member, categorized by goal-based and non-goal-based investments. 1. Select the client from your client list 2. Choose the specific family member from the dropdown 3. Click "View Deployments" in the portfolio section 4. The system displays two separate lists: Goal-Based Deployments (linked to specific financial goals) and Non-Goal-Based Deployments (general investments) 5. Each deployment shows asset details, available amounts, equity/debt breakdown, and any exclusions The deployment list refreshes automatically and shows current available amounts after deducting exclusions and completed purchases. ### How to Add New Deployment Create a new investment deployment entry for client assets that need to be allocated. 1. Click "Add New Deployment" button 2. Select the client and family member 3. Choose the asset category type (Mutual Funds, Stocks, etc.) 4. Enter the total derived amount available for deployment 5. Specify the asset ID and deployment status 6. If this deployment is generated from advice, link the advice ID 7. Click "Save Deployment" 8. The system creates the deployment record and automatically sets up equity/debt breakdowns based on asset type 9. Default exclusion entry is created with zero amount For equity-based assets like stocks, the full amount is allocated to equity portion. For debt instruments, the amount goes to debt portion. ### How to Update Exclusion Amount Set aside portions of deployment amounts that should not be invested, with reasons for the exclusion. 1. Open the specific deployment from your deployment list 2. Click "Edit Exclusions" 3. Enter the exclusion amount (cannot exceed total available amount) 4. Provide a clear reason for the exclusion in the text field 5. Click "Update Exclusion" 6. The system recalculates available amount by subtracting exclusion from total 7. Asset breakdown is updated with 50-50 equity-debt split of remaining amount Exclusions are commonly used for emergency funds, immediate expenses, or amounts awaiting better investment opportunities. ### How to Purchase Mutual Fund Scheme Execute actual mutual fund purchases directly from deployment amounts using available schemes. 1. Navigate to the deployment you want to invest from 2. Click "Purchase Scheme" 3. Select equity or debt category based on your investment strategy 4. Choose from the filtered list of available mutual fund schemes 5. Enter the purchase amount (system validates against available deployment balance) 6. Select which specific deployments to use for funding this purchase 7. Review the scheme details including NAV and expected units 8. Click "Confirm Purchase" 9. The system creates mutual fund entry, advice records, and updates deployment balances proportionally The purchase amount is deducted proportionally from selected deployments' equity or debt portions based on scheme category. ### How to View Combined Deployment Details Get comprehensive details for one or multiple deployments including investment breakdowns and remaining amounts. 1. Select one or more deployments using checkboxes 2. Click "View Combined Details" 3. Review the detailed breakdown showing: - Total equity and debt target amounts - Current investments and allocations - Remaining amounts available for investment - All scheme purchases made from these deployments 4. Use this information for portfolio rebalancing decisions This view helps you understand the complete investment status across multiple deployment sources. ### How to Archive Completed Deployment Move completed or inactive deployments to archived status to keep your active deployment list clean. 1. Locate the deployment you want to archive 2. Ensure all intended investments have been completed 3. Click the "Archive" button next to the deployment 4. Confirm the archival action in the popup dialog 5. The deployment moves to archived status and no longer appears in active deployment lists Archived deployments can still be viewed in historical reports but won't be available for new investment activities. ## Rules and Limits - Exclusion amounts cannot exceed the total available deployment amount - Equity-based assets (stocks, equity funds) allocate the full amount to equity portion initially - Debt instruments allocate the full amount to debt portion initially - After exclusions are set, remaining amounts are split 50-50 between equity and debt breakdowns - Purchase amounts cannot exceed available balances in the selected deployment category - Mutual fund purchases require valid scheme codes and current NAV values - Deployment status must be active to allow new purchases or exclusion updates - Each deployment must be linked to a specific client and family member - Goal-based deployments require existing asset percentage allocation to goals - Archived deployments cannot be modified or used for new investments ## Common Questions **Q: Can I change the exclusion amount after setting it initially?** A: Yes, you can update exclusion amounts and reasons anytime before archiving the deployment. The system will recalculate available amounts and asset breakdowns automatically. **Q: What happens if I purchase more than the available deployment balance?** A: The system validates purchase amounts against available balances and will prevent transactions that exceed deployment capacity. You'll see an error message indicating insufficient deployment balance. **Q: How do I know which schemes are available for purchase from my deployment?** A: The system filters available schemes based on your deployment's asset type and category. For mutual fund deployments, you'll see equity and debt schemes categorized separately with current NAV prices. **Q: Can I use multiple deployments to fund a single scheme purchase?** A: Yes, when making a purchase you can select multiple deployments to combine their available amounts for a larger investment in a single scheme. **Q: What's the difference between goal-based and non-goal-based deployments?** A: Goal-based deployments are linked to specific client financial goals and show which goals they're intended to fulfill. Non-goal-based deployments are general investment amounts not tied to particular goals. ## Troubleshooting **Problem:** Cannot update exclusion amount - "Zero rows updated" error **Cause:** The exclusion record doesn't exist or deployment ID is incorrect **Fix:** Refresh the deployment list and ensure you're editing the correct deployment record. If the problem persists, the deployment may need to be recreated. **Problem:** Scheme purchase fails with "Zero rows updated" error **Cause:** Invalid scheme code, insufficient deployment balance, or NAV data unavailable **Fix:** Verify the scheme code is active, check your deployment has sufficient available balance, and ensure the mutual fund NAV data is current. **Problem:** Deployment details not found error **Cause:** Deployment has been archived or deleted, or you don't have access to the client **Fix:** Check if the deployment was archived recently, verify client access permissions, or contact your administrator if the client should be accessible. **Problem:** Cannot add new deployment - validation errors **Cause:** Required fields missing, invalid asset category, or client/advisor relationship issues **Fix:** Ensure all required fields (client ID, family member, asset category, amount) are filled correctly and verify you have active advisor relationship with the client. ## Related Features This feature integrates with Goal Planning for linking deployments to specific financial objectives, Advice Management for tracking purchase recommendations and execution, Mutual Fund Management for scheme selection and NAV data, and Asset Allocation for determining appropriate investment breakdowns. It also connects to Client Portfolio Overview for displaying investment status and Portfolio Reporting for tracking deployment performance over time.
Edit Article
Changes from Previous Version
--- +++ @@ -2,147 +2,148 @@ ## Overview -Investment Deployments help you manage and track how client funds are allocated across different investment vehicles to achieve their financial goals. This feature allows you to organize client investments into goal-based and non-goal-based categories, track available amounts, exclude portions from investment, and execute actual investment purchases. Key capabilities include viewing all client deployments with breakdowns, adding new deployment entries for client assets, setting exclusion amounts with reasons, purchasing mutual fund schemes directly from deployments, and archiving completed or inactive deployments. +Investment Deployment allows you to convert financial advice into actual investment allocations for your clients. This feature helps you take recommended asset allocations and deploy them into specific mutual fund schemes or other investment instruments, tracking both goal-based and non-goal-based investments. + +• View all client deployments organized by goal-based and non-goal investments +• Add new deployments from existing advice recommendations +• Purchase specific mutual fund schemes using deployment amounts +• Set exclusions to reserve portions of deployment amounts +• Archive completed or obsolete deployment records ## Prerequisites and Access -You need an active IFANOW advisor account with portfolio management permissions. Navigate to the client's portfolio section and select "Deployments" from the investment management menu. Ensure the client has completed goal planning and asset allocation before creating deployments. +You need an active IFANOW advisor account with portfolio management permissions. Your clients must have existing asset allocations or advice recommendations before creating deployments. + +**Navigation:** Portfolio Management > Client Portfolio > Deployments ## How-To Steps -### How to View Client Deployment List +### How to View Client Deployment Lists -View all investment deployments for a specific client and family member, categorized by goal-based and non-goal-based investments. +View all investment deployments for a specific client or family member to understand current allocation status. -1. Select the client from your client list -2. Choose the specific family member from the dropdown -3. Click "View Deployments" in the portfolio section -4. The system displays two separate lists: Goal-Based Deployments (linked to specific financial goals) and Non-Goal-Based Deployments (general investments) -5. Each deployment shows asset details, available amounts, equity/debt breakdown, and any exclusions +1. Navigate to the client's portfolio section +2. Select the family member from the dropdown if applicable +3. Click "View Deployments" +4. Review the two sections: Goal-Based Deployments (linked to specific financial goals) and Non-Goal Deployments (general investments) +5. Each deployment shows the asset type, available amount, and equity/debt breakdown -The deployment list refreshes automatically and shows current available amounts after deducting exclusions and completed purchases. +The system automatically categorizes deployments based on whether they're linked to specific client goals. Goal-based deployments will show associated goal information and allocation percentages. -### How to Add New Deployment +### How to Add a New Deployment -Create a new investment deployment entry for client assets that need to be allocated. +Create a new deployment record to allocate funds for investment from existing advice recommendations. -1. Click "Add New Deployment" button -2. Select the client and family member -3. Choose the asset category type (Mutual Funds, Stocks, etc.) -4. Enter the total derived amount available for deployment -5. Specify the asset ID and deployment status -6. If this deployment is generated from advice, link the advice ID -7. Click "Save Deployment" -8. The system creates the deployment record and automatically sets up equity/debt breakdowns based on asset type -9. Default exclusion entry is created with zero amount +1. Click "Add New Deployment" from the deployment list +2. Select the asset category (Mutual Funds, Stocks, etc.) +3. Choose the specific asset from the filtered list +4. Enter the total amount to be deployed +5. If this deployment comes from existing advice, link it by selecting the advice ID +6. Click "Save Deployment" -For equity-based assets like stocks, the full amount is allocated to equity portion. For debt instruments, the amount goes to debt portion. +The system automatically creates equity/debt breakdowns based on the asset type selected. Equity-focused assets allocate the full amount to equity, while debt instruments allocate to the debt portion. -### How to Update Exclusion Amount +⚠️ **Warning:** You can only create deployments for assets that have existing advice recommendations or goal allocations. -Set aside portions of deployment amounts that should not be invested, with reasons for the exclusion. +### How to Purchase Mutual Fund Schemes -1. Open the specific deployment from your deployment list -2. Click "Edit Exclusions" -3. Enter the exclusion amount (cannot exceed total available amount) -4. Provide a clear reason for the exclusion in the text field -5. Click "Update Exclusion" -6. The system recalculates available amount by subtracting exclusion from total -7. Asset breakdown is updated with 50-50 equity-debt split of remaining amount +Execute actual mutual fund purchases using available deployment amounts. -Exclusions are commonly used for emergency funds, immediate expenses, or amounts awaiting better investment opportunities. +1. Select one or more deployments to use for the purchase +2. Click "Purchase Scheme" +3. Search and select the specific mutual fund scheme +4. Enter the purchase amount (cannot exceed total deployment balance) +5. Choose which deployments to deduct from if using multiple sources +6. Review the unit calculation based on current NAV +7. Confirm the purchase -### How to Purchase Mutual Fund Scheme +The system automatically calculates units based on the current Net Asset Value (NAV) and proportionally reduces the selected deployment amounts. This creates an advice record tracking the actual investment. -Execute actual mutual fund purchases directly from deployment amounts using available schemes. +### How to Set Deployment Exclusions -1. Navigate to the deployment you want to invest from -2. Click "Purchase Scheme" -3. Select equity or debt category based on your investment strategy -4. Choose from the filtered list of available mutual fund schemes -5. Enter the purchase amount (system validates against available deployment balance) -6. Select which specific deployments to use for funding this purchase -7. Review the scheme details including NAV and expected units -8. Click "Confirm Purchase" -9. The system creates mutual fund entry, advice records, and updates deployment balances proportionally +Reserve portions of deployment amounts that should not be invested, such as emergency funds or pending client decisions. -The purchase amount is deducted proportionally from selected deployments' equity or debt portions based on scheme category. +1. Open the deployment details +2. Click "Edit Exclusions" +3. Enter the exclusion amount (cannot exceed total deployment amount) +4. Provide a reason for the exclusion +5. Save the exclusion + +The system recalculates available amounts and adjusts the equity/debt breakdown proportionally after applying exclusions. The excluded amount becomes unavailable for scheme purchases. + +### How to Archive Completed Deployments + +Move finished or obsolete deployment records to archived status to keep active lists clean. + +1. Select the deployment to archive +2. Click the "Archive" option +3. Confirm the archival action + +Archived deployments remain in the system for historical reference but no longer appear in active deployment lists. This action cannot be undone through the interface. ### How to View Combined Deployment Details -Get comprehensive details for one or multiple deployments including investment breakdowns and remaining amounts. +See comprehensive investment details across multiple related deployments. -1. Select one or more deployments using checkboxes +1. Select multiple deployments using checkboxes 2. Click "View Combined Details" -3. Review the detailed breakdown showing: - - Total equity and debt target amounts - - Current investments and allocations - - Remaining amounts available for investment - - All scheme purchases made from these deployments -4. Use this information for portfolio rebalancing decisions +3. Review the consolidated view showing total equity and debt allocations +4. See all scheme investments made from these deployments +5. Check remaining amounts available for investment -This view helps you understand the complete investment status across multiple deployment sources. - -### How to Archive Completed Deployment - -Move completed or inactive deployments to archived status to keep your active deployment list clean. - -1. Locate the deployment you want to archive -2. Ensure all intended investments have been completed -3. Click the "Archive" button next to the deployment -4. Confirm the archival action in the popup dialog -5. The deployment moves to archived status and no longer appears in active deployment lists - -Archived deployments can still be viewed in historical reports but won't be available for new investment activities. +This view helps you understand the overall investment picture when client funds are spread across multiple deployment records. ## Rules and Limits -- Exclusion amounts cannot exceed the total available deployment amount -- Equity-based assets (stocks, equity funds) allocate the full amount to equity portion initially -- Debt instruments allocate the full amount to debt portion initially -- After exclusions are set, remaining amounts are split 50-50 between equity and debt breakdowns -- Purchase amounts cannot exceed available balances in the selected deployment category -- Mutual fund purchases require valid scheme codes and current NAV values -- Deployment status must be active to allow new purchases or exclusion updates -- Each deployment must be linked to a specific client and family member -- Goal-based deployments require existing asset percentage allocation to goals -- Archived deployments cannot be modified or used for new investments +• Deployments can only be created for assets with existing advice recommendations or goal allocations +• Purchase amounts cannot exceed the available deployment balance after exclusions +• Exclusion amounts cannot exceed the total deployment amount +• Equity-focused assets (stocks, equity mutual funds) allocate 100% to equity portion +• Debt instruments allocate 100% to debt portion with zero equity allocation +• Archived deployments cannot be modified or used for new purchases +• Each deployment must be linked to a specific client and family member +• Mutual fund purchases require valid scheme codes and current NAV data +• Deployment amounts are proportionally reduced when purchasing schemes from multiple deployments ## Common Questions -**Q: Can I change the exclusion amount after setting it initially?** -A: Yes, you can update exclusion amounts and reasons anytime before archiving the deployment. The system will recalculate available amounts and asset breakdowns automatically. +**Q: Can I invest more than the deployment amount shows?** +A: No, you can only purchase schemes up to the available deployment balance minus any exclusions you've set. -**Q: What happens if I purchase more than the available deployment balance?** -A: The system validates purchase amounts against available balances and will prevent transactions that exceed deployment capacity. You'll see an error message indicating insufficient deployment balance. +**Q: What's the difference between goal-based and non-goal deployments?** +A: Goal-based deployments are linked to specific client financial goals and show allocation percentages, while non-goal deployments are general investment amounts not tied to particular objectives. -**Q: How do I know which schemes are available for purchase from my deployment?** -A: The system filters available schemes based on your deployment's asset type and category. For mutual fund deployments, you'll see equity and debt schemes categorized separately with current NAV prices. +**Q: Can I change exclusions after setting them?** +A: Yes, you can edit exclusion amounts and reasons anytime, which will recalculate the available investment amount. -**Q: Can I use multiple deployments to fund a single scheme purchase?** -A: Yes, when making a purchase you can select multiple deployments to combine their available amounts for a larger investment in a single scheme. +**Q: Why don't I see certain mutual fund schemes when purchasing?** +A: The system only shows schemes that match the deployment's asset category (equity or debt) and have current NAV data available. -**Q: What's the difference between goal-based and non-goal-based deployments?** -A: Goal-based deployments are linked to specific client financial goals and show which goals they're intended to fulfill. Non-goal-based deployments are general investment amounts not tied to particular goals. +**Q: Can I undo a scheme purchase?** +A: Scheme purchases create permanent advice records and cannot be reversed through the deployment interface. You would need to handle reversals through the mutual fund management section. ## Troubleshooting -**Problem:** Cannot update exclusion amount - "Zero rows updated" error -**Cause:** The exclusion record doesn't exist or deployment ID is incorrect -**Fix:** Refresh the deployment list and ensure you're editing the correct deployment record. If the problem persists, the deployment may need to be recreated. +**Problem:** "No deployment details found" message appears +**Cause:** The selected client has no existing advice recommendations or asset allocations +**Fix:** Create advice recommendations or goal-based asset allocations first, then return to create deployments -**Problem:** Scheme purchase fails with "Zero rows updated" error -**Cause:** Invalid scheme code, insufficient deployment balance, or NAV data unavailable -**Fix:** Verify the scheme code is active, check your deployment has sufficient available balance, and ensure the mutual fund NAV data is current. +**Problem:** Cannot purchase schemes - "Insufficient deployment balance" error +**Cause:** The purchase amount exceeds available deployment funds after exclusions +**Fix:** Check exclusion amounts and reduce purchase amount, or add additional deployment funds -**Problem:** Deployment details not found error -**Cause:** Deployment has been archived or deleted, or you don't have access to the client -**Fix:** Check if the deployment was archived recently, verify client access permissions, or contact your administrator if the client should be accessible. +**Problem:** Mutual fund scheme not appearing in purchase options +**Cause:** The scheme category doesn't match the deployment type or lacks current NAV data +**Fix:** Verify the deployment is set for the correct asset category (equity/debt) and contact support if NAV data is missing -**Problem:** Cannot add new deployment - validation errors -**Cause:** Required fields missing, invalid asset category, or client/advisor relationship issues -**Fix:** Ensure all required fields (client ID, family member, asset category, amount) are filled correctly and verify you have active advisor relationship with the client. +**Problem:** "Zero rows updated" error when setting exclusions +**Cause:** The deployment record may be archived or linked to completed advice +**Fix:** Verify the deployment status and ensure it's not archived before setting exclusions + +**Problem:** Combined deployment details show zero amounts +**Cause:** All selected deployments may be fully invested or archived +**Fix:** Check individual deployment statuses and select active deployments with remaining balances ## Related Features -This feature integrates with Goal Planning for linking deployments to specific financial objectives, Advice Management for tracking purchase recommendations and execution, Mutual Fund Management for scheme selection and NAV data, and Asset Allocation for determining appropriate investment breakdowns. It also connects to Client Portfolio Overview for displaying investment status and Portfolio Reporting for tracking deployment performance over time. +This feature connects with Goal-Based Planning for linking deployments to client objectives, Advice Management for creating investment recommendations, and Mutual Fund Management for executing actual purchases. It also integrates with Portfolio Analytics for tracking deployment performance and Asset Allocation tools for maintaining target investment mixes.