Feature 285017: Pricing - Set element "CalculateTotalLoanAmount" for "Single Premium Non/Refundable" Scenarios

OVERVIEW

• Currently, the system generates the pricing requests to OB API service “POST full Product Search” with element “CalculateTotalLoanAmount” as “true” when POS field “Add [UFMIP/VAFF/USDAGF] to loan amount” is set to UNCHECKED. This is an issue because sending “true” to the pricing engine will trigger the pricing engine to calculate the [UFMIP/VAFF/USDAGF] and add it to the loan amount prior to searching for loan products. Also this may cause additional issues as certain products are returned as ineligible (with disqualifier reason related to loan amount exceeding county limits) when they should be returned as eligible (since the UFMIP/VAFF/USDAGF will not be financed into the loan amount).

Description

• The system will generate pricing requests to OB API service “POST full Product Search” with element “CalculateTotalLoanAmount” always as “false” regardless of how the POS indicator “add [UFMIP/VAFF/USDAGF” to loan amount” is set. This means that instead of the pricing engine calculating the total loan amount, it will take in the value(s) provided in the pricing request.

Detailed Functionality

• When the POS indicator “add [UFMIP/VAFF/USDAGF” to loan amount” is set as UNCHECKED, then system will pass element “TotalLoanAmount” with value same as element “BaseLoanAmount” and element “upfrontPMI_MIP_GF_FinanceAmount” will be set to “0.00”.
• Alternatively, when the POS indicator “add [UFMIP/VAFF/USDAGF” to loan amount” is set as CHECKED, then system will pass element “TotalLoanAmount” with value of sum of element “BaseLoanAmount” and element “upfrontPMI_MIP_GF_FinanceAmount”.
• 

Configuration & Prerequisite Information

• There are no additional configuration settings for this feature, however it will only impact the environments that are connected to pricing engine “Optimal Blue” under the API version “3”.

Acceptance Criteria

Use Case # 1:

• VERIFY The elements (“BaseLoanAmount”, “TotalLoanAmount”) in pricing request to OB API service “POST full Product Search” are provided with same values when POS indicator “Add  [UFMIP, VAFF, USDAGF] to loan amount?” are set to UNCHECKED.

1. Create a new loan via New Price Quote or other method
2. Navigate to Interview/Prospect page, and complete the scenario as follows:
   1. Set Loan Type to “FHA” and set “Add UFMIP to loan amount?” to UNCHECKED
   2. Set Loan Type to “VA” and set “Add VA Funding Fee to loan amount?” to UNCHECKED.
   3. Set Loan Type to “USDA” and set “Add USDA Guarantee Fee to loan amount?” to UNCHECKED.
3. Click button “Shop for Rates” and wait for system to load the next page “Pricing Results”
4. Click the Pricing Engine link at bottom left of footer section to review the pricing request files.
   Alternatively, you can navigate to the Integration Services screens and review the vendor request files from the category “Shop for Rates – Optimal Blue”.
5. VERIFY The following elements are provided with the following values:
   1. “CalculateTotalLoanAmount” as “false”
   2. “LoanType” as “FHA”, or “VA” or “USDA”
   3. “TotalLoanAmount” matching value as “BaseLoanAmount”
   4. “upfrontPMI_MIP_GF_FinancedAmount” as “0.00”

Use Case # 2:

• VERIFY The elements (“BaseLoanAmount”, “TotalLoanAmount”) in pricing request to OB API service “POST full Product Search” are provided with different values when POS indicator “Add  [UFMIP, VAFF, USDAGF] to loan amount?” are set to CHECKED.

1. Create a new loan via New Price Quote or other method
2. Navigate to Interview/Prospect page, and complete the scenario as follows:
   1. Set Loan Type to “FHA” and set “Add UFMIP to loan amount?” to CHECKED
   2. Set Loan Type to “VA” and set “Add VA Funding Fee to loan amount?” to CHECKED.
   3. Set Loan Type to “USDA” and set “Add USDA Guarantee Fee to loan amount?” to CHECKED.
3. Click button “Shop for Rates” and wait for system to load the next page “Pricing Results”
4. Click the Pricing Engine link at bottom left of footer section to review the pricing request files.
   Alternatively, you can navigate to the Integration Services screens and review the vendor request files from the category “Shop for Rates – Optimal Blue”.
5. VERIFY the following elements are provided with the following values:
   1. “CalculateTotalLoanAmount” as “false”
   2. “LoanType” as “FHA”, or “VA” or “USDA”
   3. “TotalLoanAmount” with value greater than “BaseLoanAmount”
6. “upfrontPMI_MIP_GF_FinancedAmount” as non-zero value

Use Case # 3:

• VERIFY The elements (“BaseLoanAmount”, “TotalLoanAmount”) in locking request to OB API service “POST Save Loan” (and “POST Change Request Product Search”) are provided with same values when POS indicator “Add  [UFMIP, VAFF, USDAGF] to loan amount?” are set to UNCHECKED.

1. Continue with Test Case #1
2. Apply an “FHA”, “VA”, or “USDA” loan product
3. Navigate to Locking & Adjustments screen
4. Click button “Submit Lock Request” and wait for system to complete the lock status update to either “Lock Requested” or “Locked”
5. Click the Pricing Engine link at bottom left of footer section to review the pricing request files.
   Alternatively, you can navigate to the Integration Services screens and review the vendor request files from the category “Locking Workflow – Optimal Blue”.
6. VERIFY The following elements are provided with the following values:
   1. “CalculateTotalLoanAmount” as “false”
   2. “LoanType” as “FHA”, or “VA” or “USDA”
   3. “TotalLoanAmount” matching value as “BaseLoanAmount”
7. “upfrontPMI_MIP_GF_FinancedAmount” as “0.00”
8. Repeat steps 1 thru 7 for other “FHA”, “VA”, or “USDA” loan products

Use Case # 4:

• VERIFY The elements (“BaseLoanAmount”, “TotalLoanAmount”) in locking request to OB API service “POST Save Loan” ( and “POST Change Request Product Search”) are provided with different values when POS indicator “Add  [UFMIP, VAFF, USDAGF] to loan amount?” are set to CHECKED.

1. Continue with Test Case #2
2. Apply an “FHA”, “VA”, or “USDA” loan product
3. Navigate to Locking & Adjustments screen
4. Click button “Submit Lock Request” and wait for system to complete the lock status update to either “Lock Requested” or “Locked”
5. Click the Pricing Engine link at bottom left of footer section to review the pricing request files.
   Alternatively, you can navigate to the Integration Services screens and review the vendor request files from the category “Locking Workflow – Optimal Blue”.
6. VERIFY The following elements are provided with the following values:
   1. “CalculateTotalLoanAmount” as “false”
   2. “LoanType” as “FHA”, or “VA” or “USDA”
   3. “TotalLoanAmount” with value greater than “BaseLoanAmount”
7. “upfrontPMI_MIP_GF_FinancedAmount” as non-zero value
8. Repeat steps 1 thru 7 for other “FHA”, “VA”, or “USDA” loan products