First Magnus Spec
Price My Loan
Functional Design
Initial Publication Date:
11/28/2006
Author:
Jose Durazo
Extranet Location:
|Team Composition |
|Role |Name |Email |
|Technical Analyst |Jose Durazo |Jose.Durazo@ |
|Technical Lead |Ashok Shukla |Ashok.Shukla@ |
|Technical Oversight |Michael Martin |Michael.Martin@ |
|QC Oversight |Josh Ziegler |Joshua.Ziegler@ |
|QC Lead |Dheeraj Gupta |Dheeraj.Gupta@ |
|Trinity Project Manager |Yogesh Johar |Yogesh.Johar@ |
|Project Manager |Vikram Singh |Vikram.Singh@ |
|Business Sponsor: |Brandi Shoemaker |Brandi.Shoemaker@ |
|Training / Online Support | | |
|Business Sponsor: |Reiah Zurita |Reiah.Zurita@ |
|Pricing | | |
TABLE OF CONTENTS
This table of contents can be updated by clicking in the table, pressing the F9 key, then choosing Update Entire Table in the resulting dialog.
1 VERSION HISTORY 2
2 OVERVIEW 7
2.1 Narrative 7
3 DESIGN DETAILS 7
3.1 General Functionality 7
3.2 Price My Loan Icon 7
3.3 Product Finder Search Results Screen – Outside Loan 8
3.3.1 Select Branch Screen 10
3.4 Product Finder Compare Price Screen − Outside Loan 12
3.5 New Online Lock / Express Lock Logic − In Loan Context 13
3.5.1 Selecting A Branch 14
3.5.2 Detecting Pricing Errors – In Loan Context 15
3.5.3 Pricing Parameters Screen 15
3.5.4 Price Loan Screen 22
3.5.5 Lock Request Details Screen 31
3.5.6 Fields Used By The Lock Process 31
3.5.6.1 Fields Passed In 31
3.5.6.2 Fields Calculated From Fields Passed In 37
3.6 Register Loan Screen 37
3.7 Product Finder Changes In Loan Context 43
3.7.1 Product Finder Search / Search Results Screen − Inside a Loan 43
3.7.2 Product Finder Compare Price Screen − Inside a Loan 45
3.8 Loans Available For Online Lock Screen 47
3.9 Pipeline Report − Loan Level Results Screen 47
3.10 Loan Level Changes 48
3.10.1 Secondary Main Screen 48
3.10.2 Info Screens 49
3.10.3 Confirm Lock Information Screen 49
3.11 General 50
3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder 50
3.11.1.1 Outside The Context Of A Loan 51
3.11.1.2 Inside The Context Of A Loan 51
3.11.2 General Screen Flow / Pricing Loan 52
3.11.3 Pricing Error Screen 53
3.12 Data Validations 55
3.12.1 New Data Validation Rule: Inconsistent Buydown Information 55
3.13 Scripts 55
4 PRIVILEGES 55
4.1 Deleted Privileges 55
4.2 New / Existing Privileges 55
5 OTHER CONSIDERATIONS / RED FLAGS 55
6 APPENDIX 56
6.1 Existing Request Lock Icon Locations 56
VERSION HISTORY
|Version / |Changes |
|Date / | |
|Updated By | |
|0.16 |PML-47 changed UI to require a Rep to be assigned to a loan when express locking / locking online. Exception: Pricing |
|3/12/2007 |Analysts. |
|Jose Durazo | |
| |Price Loan Screen − Lock Now Button logic, step 5, p. 29 − in the context of a loan direct the User to the Register / Lock |
| |Loan screen if Rep is missing on loan) |
| |Register / Lock Loan Screen − Register | Lock Now Button, p. 42 − additional Field Validation logic to make sure Rep is |
| |selected when appropriate − additional Functional Description logic to assign Rep added.) |
| |Register / Lock Loan Screen − Screen Title and Purpose, p. 38 − change title to reflect that in the context of a loan, not |
| |just Address information may be requested. Generalized name to be "Additional Information".) |
| |Register / Lock Loan Screen − Branch Label, p. 39 − new field added to give users more information while selecting a Rep for |
| |the loan about to be locked.) |
| |Register / Lock Loan Screen − Rep Dropdown, p. 39 − new dropdown lets users select a Rep when applicable while attempting to |
| |lock a loan.) |
| |Register / Lock Loan Screen − Register | Lock Now Button, p. 42 − additional Field Validation logic to make sure Rep is |
| |selected when appropriate − additional Functional Description logic to assign Rep added.) |
|0.15 |Confirm Lock Information Screen, p. 49 − defined that when a User clicks the View Online Pricing button if some fields used |
|3/8/07 |in the pricing process are missing on screen an error is displayed. |
|Jose Durazo | |
|0.14 |PML-60 Pricing Error Screen − Product Not Available Online Error, p. 54, change "call or e-mail" to "contact". |
|2/28/2007 | |
|Jose Durazo |PML-61 Price Loan Screen − Lock Now Button Logic − Step 5, p. 29 − updated this logic so that if a TBD address is present in |
| |the loan in context the User is sent to the Register Loan screen to provide a non-TBD address. |
|0.13 |Updated Figure 3.11-1: Price Loan Entry Points, p. 53, based on Jira ticket PML-52. Still some changes pending in this FD |
|2/20/2007 |based on that ticket, but this figure was updated for a meeting tomorrow so I'm updating it in the FD |
|Jose Durazo | |
|0.12 |Inside The Context Of A Loan, p. 51 − don't pass in the first lien's FileID when pricing a 2nd lien from Product Finder in |
|1/18/2007 |the context of a 1st lien loan and simultaneous search for 2nd liens. Instead, pass in null in this situation, which will |
|Jose Durazo |cause a new loan to be created if the User prices and locks the second lien. |
|0.11 |PML-11 |
|1/11/2007 | |
|Jose Durazo |Register Loan Screen − Register | Lock Now Button, p. 42 − Added logic so that whenever this screen is displayed, upon |
| |returning control to the Price Loan screen the loan is guaranteed to be registered and to have been updated with all of the |
| |parameters passed to the Price Loan process. The specific change is in the case where this screen was displayed because |
| |address information was missing. In this case the logic only said that the address information was saved upon successfully |
| |submitting this screen. But as of this FD version, all data passed to the Price Loan process is saved. |
| |Price Loan Screen − Lock Now Button − New Submit Process For Price Loan Screen, p. 28: Modified steps 4, 5, and 6, to |
| |prevent duplicating a loan save process if the loan was saved through the Register Loan screen, and to instead only save the |
| |loan data based on the passed-in parameters if the Register Loan screen was not displayed. |
|0.10 |PML-9 |
|1/3/2006 | |
| |Lock Request Pending Error, p. 54, and Loan Is Locked Error directly below − added these two errors to the errors that can be|
| |displayed when a User tries to get pricing in the context of a loan. |
| |3.5.2 Detecting Pricing Errors – In Loan Context, p. 15 − added error conditions in case the loan has a pending lock request |
| |or is currently locked. |
|0.9 |PML-8 |
|12/21/2006 |Pricing Error Screen, p. 53 – defined a shared Pricing Error Screen to allow a shared code to be used when errors are |
|Jose Durazo |detected when attempting to price a loan instead of maintaining code in multiple places. The User experience is not hurt by |
| |this functionality, while it saves on development time and maintenance costs. |
| |Changed how errors are detected in the context of the loan, to show a shared error screen if an error is detected. Also |
| |added an error that needs to be detected: checking whether the product is available online. See details in section 3.5.2 |
| |Detecting Pricing Errors – In Loan Context, p. 15. |
| |Across all Price Loan entry points, changed the previously defined javascript error so that the error is displayed in the |
| |shared screen listed in #1 above. |
|0.8 | New Data Validation for inconsistent loan vs. product buydown information. Section 3.12.1, p. 55. |
|12/19/2006 |Pricing Parameters screen − added back details for the Temporary Subsidy Buydown Dropdown, p. 18 |
|Jose Durazo |Pricing Parameters screen − Price Loan Button − Form Validation Logic, p. 22 − on saving this screen, disallow Temporary |
| |Subsidy Buydown = Yes if the product doesn't allow it. |
| |Added back the Has Temporary Buydown field in the list of fields passed in when pricing a loan. See Has Temporary Buydown?, |
| |p. 34. |
| |2nd lien product parameters passed in outside the context of a loan, section 3.11.1.1, p. 51 − added back the Has Temporary |
| |Buydown field. |
| |2nd lien product parameters passed in, in the context of a loan, section 3.11.1.2, p. 51 − added back the Has Temporary |
| |Buydown field. |
| |Figure 3.5-1: Example Picture - Pricing Parameters Screen, p. 16. Added the Temporary Subsidy Dropdown back in the Type of |
| |Mortgage section. |
|0.7 |Compare Price Screen − In Loan − Price Loan Icon, p. 46 − changed error when can't price loan because margin is missing. |
|12/18/2006 |Product Finder Compare Price Screen − Price Loan Column p. 12 − changed error when can't price loan because margin is |
|Jose Durazo |missing. |
| |price loan in the context of a loan − Error! Reference source not found. logic, p. Error! Bookmark not defined.. Changed |
| |text of error seen when loan can't be priced because a margin is missing. |
| |Figure 3.5-1: Example Picture - Pricing Parameters Screen, p. 16 − removed the [Temporary Subsidy] Buydown and MI Pmt Type |
| |fields from this image, from the details for this screen, and from all lists of pricing parameters in this FD. |
| |Pricing Parameters Screen − MI Plan Optn Dropdown, p. 19 − completed the details that define when this field is hidden vs. |
| |displayed, modifiable vs. read only, and what values are displayed. |
| |Price Loan Screen − Pricing Adjustments Section − Max Rebate Before And After, p. 27 − specified what's changing in the logic|
| |that determines whether a Max Rebate adjustment is displayed in the pricing adjustments grid, and when it is displayed what |
| |its value should be. The calculation is the same but two values are now retrieved from parameters passed into the screen. |
| |Product Finder Search Results − In Loan − Price Loan Icon, p. 44 − changed error when can't price loan because margin is |
| |missing. |
| |Product Finder Search Results − Outside Loan − Price Loan Column, p. 8 .. changed error when can't price loan because margin |
| |is missing. |
|0.6 |Non-Functional Change: Added section 3.11.2 General Screen Flow / Pricing Loan, p. 52 to show an overview of which entry |
|12/15/2006 |points go to the Pricing Parameters screen vs. directly to the Price Loan screen. |
|Jose Durazo |Pricing Parameters Screen − Corrected description of Amortization Term Text Box, p. 18. |
| |Pricing Parameters Screen − PMI MIP Funding Fee Financed Text Box, p. 18, Defined the calculation used to determine the |
| |initial value for this field. |
| |Pricing Parameters Screen − Price Loan Button details, p. 21 − Functional Description − defined the fact that Base Factor is |
| |calculated from the values on this screen when the User clicks Price Loan successfully. |
| |Removed the Duplicate Loans For SSN section which is no longer used. No section of this FD checks for duplicate loans. |
| |Pricing Parameters Screen − Corrected Amortization Type text box description, see Type of Mortgage Section, p. Amortization |
| |Type Text Box, p. 17. |
|0.5 |12/14/2006 Made changes based on pre-signoff business and dev / qc review: |
| | |
| |Product Finder Search Results − Outside Loan Context. Clarified when the Product Finder Search Results screen is |
| |re-displayed vs. moving directly on to the next screen in the process, when the Select Branch screen needs to be displayed |
| |after the User clicks the Price Loan Icon. See details in Price Loan Column, p. 8. |
| |Product Finder Search Results − Outside Loan Context − Search Criteria Entered − defined pricing parameter values to be used |
| |when a 2nd lien's Price Loan icon is clicked in the context of a simultaneous 1st / 2nd lien search. See details under the |
| |heading Case 1: Search Criteria Entered, p. 9. |
| |Product Finder Compare Price Screen − Outside Loan Context − Search Criteria Entered − Price Loan Column, p. 12 − defined |
| |pricing parameter values to be used when a 2nd lien's Price Loan icon is clicked in the context of a simultaneous 1st / 2nd |
| |lien search. |
| |Section 3.5.1 Selecting A Branch, p. 14 − Defined when the user is returned to the screen used to trigger the Price Loan |
| |process in the case where the loan in context didn't have an assigned branch. |
| |Pricing Parameters screen − Lowest Middle Fico Text Box details, p. 19 − changed the limit on this field from 800 to 900 to |
| |match Secondary Main. |
| |Register Loan Screen, p. 37, removed duplicate loan section from this screen, and all functionality related to detecting and |
| |displaying duplicate loans. |
| |Register Loan screen − added details for the Property Street, City, State, and Zip fields. See details starting with |
| |Property Street, p. 41. |
| |Register Loan screen − Register | Lock Now Button, p. 42 − clarified what happens when the user clicks this button when the |
| |screen was loaded for the purpose of registering the loan vs. providing address information. |
| |Register Loan screen − Register / Lock Now button − Form Validation Logic, p. 43 − defined additional values for Property |
| |Number and Property Street that cause LT to show an error for disallowed TBD addresses. |
| |Product Finder Search Results − In Loan Context − defined when the user is returned to this screen vs. moved directly to the |
| |price loan / pricing parameters screen after selecting a branch. See Price Loan Icon details, p. 44. |
| |Product Finder Search Results − Inside Loan Context − defined pricing parameter values to be used when a 2nd lien's Price |
| |Loan icon is clicked in the context of a simultaneous 1st / 2nd lien search. See Price Loan Icon details, p. 44. |
| |Product Finder Compare Price − Inside Loan Context − Search Criteria Entered − defined pricing parameter values to be used |
| |when a 2nd lien's Price Loan icon is clicked in the context of a simultaneous 1st / 2nd lien search. See Price Loan Icon |
| |details, p. 46 for details. |
| |Added section 3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder, p. 50, with subsections |
| |Outside The Context Of A Loan, p. 51, and Inside The Context Of A Loan, p. 51. |
| |Product Finder Search Results Outside Loan − Price Loan Column, p. 8 − changed to clarify that the Near Miss grid doesn't get|
| |the Price Loan column but 2nd Lien Product grid for a simultaneous search do get the Price Loan column and functionality. |
|0.4 |Pricing Parameters Screen, p. 15, entry points heading: Clarified functionality already defined at the entry points |
|12/11/2006 |themselves: that when a User searches for products in Product Finder by entering search criteria, the Pricing Parameters |
|Jose Durazo |Screen is not seen. |
|0.3 |All details filled in after reviews by the Business, Development and QC teams. |
|12/11/2006 | |
|Jose Durazo | |
|0.2 |Added most FD content over the last several days. Still does not incorporate changes based on business review this morning.|
|12/06/2006 | |
|Jose Durazo | |
|0.1 |Created |
|11/28/2006 | |
|Jose Durazo | |
OVERVIEW
1 Narrative
This project creates functionality that lets users price a potential loan outside the context of a loan, and provide required pricing parameters on one centralized screen. Only pricing parameters are required before pricing a loan. Data only required to lock / register a loan is required when a user attempts to execute a lock.
More background information and the solution scope for this project are at:
Note that this design depends on the Product Finder Phase 2 project already being implemented. The functional design for that project is at:
DESIGN DETAILS
1 General Functionality
Except as otherwise stated, the functionality in this document conforms to the guidelines in the following document:
If screen shots or other functionality deviates from the Design Guideline document without saying the deviation is intentional, this should be considered a conflict that needs to be resolved. The spec should either be changed to conform to the Design Guideline doc or the intentional exception should be documented.
2 Price My Loan Icon
Before the Price My Loan project, various locations in LoanTracker display this Request Lock icon:
[pic]
The list of these existing locations is in section 6.1 Existing Request Lock Icon Locations, p. 56.
In all of these locations the following changes occur:
1. The icon is replaced with the new Price Loan icon. The actual icon to be used is TBD and depends on the result of . But the following placeholder may be used initially: [pic]
2. On hovering over this icon in any location, the following text is displayed:
[pic]
3 Product Finder Search Results Screen – Outside Loan
Overview
The product finder search results screen outside the context of a loan is changed to display a Price Loan column in its results.
Entry Point
This screen is entered by navigating to product finder using the Loan Tools > Product Finder entry point, then using Find My Product or Choose My Product to search for a product.
Security
The security of this screen is not changed by this document.
Figure 3.3-1: Product Finder Search Results - Outside Loan Context
[pic]
Table 3.3-1: Product Finder Search Results − Outside Loan − Field And Control Details
|Product Finder Search Results − Outside Loan − Field And Control Details |
|Price Loan |([pic] 1214 Product Finder Search Results Outside Loan − Price Loan Column, p. 8 − changed to clarify that the Near Miss grid|
|Column |doesn't get the Price Loan column but 2nd Lien Product grid for a simultaneous search do get the Price Loan column and |
| |functionality.) |
| |The Price Loan column appears in the results 1st and 2nd lien grids as the rightmost column only when at least one product in|
| |these grids is online lockable (a product is Online Lockable only when its Loan Product Details screen has the Available |
| |Online checkbox checked). It does not appear in the Near Miss grid. |
| | |
| |When this column is displayed, the new price loan icon defined in section 3.2, p. 7, is displayed in each row that represents|
| |an Online Lockable product. (the cell is empty for rows that don't represent products, or that represent products that aren't|
| |Online Lockable). |
| | |
| |For any row in which the Price Loan icon is displayed, clicking the icon does the following: |
| | |
| |If the User has access to no branches, |
| | |
| |The click is ignored |
| | |
| |If the User has access to more than one branch |
| | |
| |The Select Branch Screen, p. 10, is displayed to let the User select a branch. |
| | |
| |([pic] 1214 Product Finder Search Results − Outside Loan Context. Clarified when the Product Finder Search Results screen is|
| |re-displayed vs. moving directly on to the next screen in the process, when the Select Branch screen needs to be displayed |
| |after the User clicks the Price Loan Icon. See details in Price Loan Column, p. 8.) |
| |When control returns from that screen, if the User Canceled out of it, the process of Price Loan is aborted and this screen |
| |is re-displayed. If the User didn't cancel out of that screen, they selected a branch. If the branch has no margin for the |
| |selected product in the last published rate sheet, this screen is re-displayed in order to show them the error message |
| |defined below. If the branch has a margin for the selected product this screen is not re-displayed but instead the logic |
| |continues below at Case 1: Search Criteria Entered, p. 9, below to determine whether to show the Pricing Parameters screen |
| |or the Price Loan screen directly. |
| | |
| |If the User has access to exactly one branch this screen is still displayed, or if the User has access to more than one |
| |branch but selected a specific one to price a loan with this screen is redisplayed. Then: |
| | |
| |If the branch to be used to price the loan doesn't have a margin for the selected product in the last published rate sheet, |
| |the Pricing Error Screen, p. 53 is displayed showing the Missing Margin error. |
| | |
| |If the branch to be used to price the loan has a margin for the selected product in the last published rate sheet: |
| | |
| |([pic] 1214 Product Finder Search Results − Outside Loan Context − Search Criteria Entered − defined pricing parameter values|
| |to be used when a 2nd lien's Price Loan icon is clicked in the context of a simultaneous 1st / 2nd lien search. See details |
| |under the heading Case 1: Search Criteria Entered, p. 9.) |
| | |
| |Case 1: Search Criteria Entered |
| |If the User arrived at the product finder search results screen by entering search criteria, the Price Loan Screen, p. 22, is|
| |loaded, passing it a value for each parameter defined in section 3.5.6.1, p. 31. |
| | |
| |The value for each parameter is the values that would have been saved to the loan if the user had selected to Register Loan |
| |instead of Price Loan. In other words, the values are what the User entered on the search screen, plus any default values |
| |that are saved to a loan when it's created. |
| | |
| |Exception: If this is a 2nd lien product found only as a result of a simultaneous search, the values are passed in as |
| |defined in section 3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder, p. 50. |
| | |
| |Note that the product finder search parameter "DTI" maps to the Ratio 2 parameter, as follows: |
| | |
| |DTI = 0-40 : Ratio 2 = 40 |
| |DTI = 40.01−45: Ratio 2 = 45 |
| |DTI = 45.01−50: Ratio 2 = 50 |
| |DTI = 50.01−55: Ratio 2 = 55 |
| | |
| |This applies any time the product finder search criteria are passed into the Price Loan screen or the Pricing Parameters |
| |screen, but this is not repeated in the FD for the other product finder sections. |
| | |
| |Case 2: Choose My Product |
| |If the User didn't enter search criteria, the Pricing Parameters Screen, p. 15, is loaded. This screen passes it a value for|
| |each parameter specified in section 3.5.6.1, p. 31. The value for each parameter is the one that would have been saved to |
| |the loan if the user had selected to Register Loan instead of Price Loan. |
1 Select Branch Screen
Overview
This is a new screen whose purpose is to allow users with access to multiple branches to price a loan in the context of the Product Finder Search Ressults screen.
Entry Point
This screen is entered by clicking a Price Loan icon in the Product Finder Search Results screen, as defined in the Price Loan Column details, p. 8.
Security
No special security is defined for this screen as a whole.
Figure 3.3-2: Select Branch For Pricing Screen
[pic]
Table 3.3-2: Select Branch For Pricing Screen -- Field and Control Details
|Select Branch For Pricing Screen − Field And Control Details |
|Branch Dropdown |Tab Order: 1 |
| | |
| |Control: Dropdown |
| | |
| |List Values: This dropdown contains one item for every branch the User has access to. Each entry is displayed as above in |
| |the format: |
| | |
| |[Branch ID] − [Branch Short Name] |
| | |
| |The branches are displayed such that branches with smaller BranchID numbers display above branches with bigger BranchID |
| |numbers. Note that this screen is expected to be seen only by FMFC Employee users. In the unexpected case where the |
| |logged in user is not an FMFC employee, the dropdown displays no values in that case. |
| | |
| |Default Value: The user's primary branch is selected by default. This is the branch selected in the Branch dropdown in the|
| |Employment Information section of the Employee Details screen. |
| | |
| |Functional Description: |
| |This is a standard dropdown. |
|OK Button |Tab Order: 2 |
| | |
| |Control: Button |
| | |
| |Functional Description: |
| |When the User clicks this button, this screen returns the selected branch to the screen that called this screen. |
|Cancel Button |Tab Order: 3 |
| | |
| |Control: Button |
| | |
| |Functional Description: |
| |When the User clicks this button this screen returns control to the screen that called this screen, letting it know that |
| |the User cancelled. |
4 Product Finder Compare Price Screen − Outside Loan
Overview
The Product Finder Compare Price screen (outside the context of a loan) allows a user to see basic pricing information among different products, given a set of loan parameters entered by that user.
The Price My Loan project enhances this screen by allowing Users to fully price a loan directly from this screen without first registering it.
Entry Point
This screen is entered from the Product Finder Search results screen pictured in section 3.3 Product Finder Search Results Screen – Outside Loan, p. 8 above.
Security
This document doesn't define any new security for this screen.
Table 3.4-1: Product Finder Compare Price Screen
[pic]
Table 3.4-2: Product Finder Compare Price Screen - Field and Control Details
|Product Finder Compare Price Screen − Field And Control Details |
|Price Loan |The Price Loan Column is a new column added on this screen. |
|Column | |
| |This column displays on the Compare Price screen when at least one product for which pricing is being compared is Online |
| |Lockable. |
| | |
| |When this column is displayed, each row that represents an online lockable product contains the Price Loan icon defined in |
| |section 3.2, p. 7 above. This column is empty for all other rows. |
| | |
| |When the user clicks a Price Loan icon |
| | |
| |If the branch to be used to price the loan doesn't have a margin for the selected product in the last published rate sheet, the|
| |Pricing Error Screen, p. 53 is displayed showing the Missing Margin error. |
| | |
| |If the branch to be used to price the loan has a margin for the selected product in the last published rate sheet: |
| | |
| | |
| |the Price Loan Screen, p. 22, is loaded, passing it a value for each parameter defined in section 3.5.6.1, p. 31. The value |
| |for each parameter is the one that would have been saved to the loan if the user had selected to Register Loan instead of Price|
| |Loan. In other words, the values are what the User entered on the search screen before arriving at this screen, plus any |
| |default values that are saved to a loan when it's created. |
| | |
| |([pic] 1214 Product Finder Compare Price Screen − Outside Loan Context − Search Criteria Entered − Price Loan Column, p. 12 − |
| |defined pricing parameter values to be used when a 2nd lien's Price Loan icon is clicked in the context of a simultaneous 1st /|
| |2nd lien search.) |
| | |
| |Exception: If this is a 2nd lien product found only as a result of a simultaneous search, the values are passed in as defined |
| |in section 3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder, p. 50. |
| | |
| |The Branch sent in is the one selected in the Branch dropdown if displayed on this screen. Otherwise the branch defined in the|
| |Compare Price / Branch field details, on p. 69 of the Product Finder Phase 2 functional design is passed into the price loan |
| |logic. |
| | |
| |The Product Finder Phase 2 functional design is at |
| | |
| | - Product Finder Ph-2.doc. |
5 New Online Lock / Express Lock Logic − In Loan Context
Overview
Current Behavior
Before the Price My loan project, when any user attempts to price or lock a loan via the Request Lock screen the following logic is used to make sure the loan has enough information to lock a loan:
If the loan is missing any of these items:
Branch
Product
Loan Amount
Property Number
Property State
Purchase Amount (only required for Purchases and Refi's with Doc Type = Streamline)
Appraised Value (only required for Refi's with Doc Type ≠ Streamline)
LoanTracker displays an error message such as this:
[pic]
Also, before the Price My Loan project the only entry points that let the User view pricing or Online Lock / Express lock a loan are places that are either inside a loan or can provide an existing loan number to lock.
New Behavior
After the Price My Loan project, we allow users to enter the Request Lock screen to price or lock a loan from contexts that don't include a loan to exist before the loan can be priced, as defined in sections 3.3 and 3.4, pages 8 and 12 respectively. In addition, the required field checking is changed so that many of the fields can be provided on a new screen provided for that purpose.
1 Selecting A Branch
([pic] 1214 Section 3.5.1 Selecting A Branch, p. 14 − Defined when the user is returned to the screen used to trigger the Price Loan process in the case where the loan in context didn't have an assigned branch.)
If this logic was triggered in the context of a loan without a branch assigned, the Select Branch Screen defined on p. 10 is displayed.
When the control returns from that screen:
If the User canceled out of that screen, this logic is aborted and control is returned to the screen the User was on before this logic was triggered.
If the User selected a branch on that screen, that's the branch that will be used to price the loan assuming no further error conditions are discovered:
If the loan has a product assigned with its Available Online checkbox checked and the selected branch has a margin in the latest published rate sheet with regard to that product:
The screen the User was on before triggering this logic is not re-displayed. Instead, the Pricing Parameters screen in the next section is loaded directly, sending it all of the parameters defined in section 3.5.6.1 Fields Passed In, p. 31 together with the BranchID corresponding to the User's selection in the Select Branch Screen.
Otherwise the logic in the following section occurs.
2 Detecting Pricing Errors – In Loan Context
([pic] 1221 Changed how errors are detected in the context of the loan, to show a shared error screen if an error is detected. Also added an error that needs to be detected: checking whether the product is available online. See details in section 3.5.2 Detecting Pricing Errors – In Loan Context, p. 15.)
Now that logic is here the loan has a branch assigned which is automatically used to price the loan, or the User has selected a branch to price the loan.
([pic] 0103 3.5.2 Detecting Pricing Errors – In Loan Context, p. 15 − added error conditions in case the loan has a pending lock request or is currently locked.)
If
1) the loan has no product assigned, or
2) the loan has a product assigned which doesn't have its Available Online checkbox checked on the Loan Product Details screen, or
3) the branch being used to price this loan does not have a margin with respect to its assigned product in the latest published rate sheet
4) the loan has a pending lock request
5) the loan is currently locked
each of these situations is an error condition that doesn't allow the pricing process to continue. The Pricing Error Screen, p. 53, is displayed with content that corresponds to the first error condition detected above.
If none of these error conditions are detected, the Pricing Parameters Screen, p. 15, is displayed, passing it values for all parameters defined in section 3.5.6.1 Fields Passed In, p. 31, equal to the loan's values for those fields except that if the loan doesn't have a branch, the Branch passed in is the one selected by the user in the Selecting A Branch section above.
3 Pricing Parameters Screen
Overview
The Pricing Parameters screen is displayed in the context of a user attempting to Price a loan by clicking any of the Price My Loan icons in LoanTracker except in the context of Product Finder when the User entered search criteria to find a product.
It allows the User to provide any parameters required to lock the loan and some parameters that aren't strictly required but that are used in pricing loans.
Entry Point
The Entry Point for this screen is any Price Loan icon (except in the context of a Product Finder Search performed by entering search criteria) and the Secondary Main screen's Request Lock button.
Figure 3.5-1: Example Picture - Pricing Parameters Screen
[pic]
([pic] 1218 Figure 3.5-1: Example Picture - Pricing Parameters Screen, p. 16 − removed the [Temporary Subsidy] Buydown and MI Pmt Type fields from this image, from the details for this screen, and from all lists of pricing parameters in this FD.)
([pic] 1219 Figure 3.5-1: Example Picture - Pricing Parameters Screen, p. 16. Added the Temporary Subsidy Dropdown back in the Type of Mortgage section.)
Table 3.5-1: Pricing Parameters Screen -- Field And Control Details
|Pricing Parameters Screen − Field And Control Details |
|Note that this screen is displayed as above always, even in the context of a loan. This means that the left navigation bar and the icons |
|that normally appear in the context of a loan are not displayed. |
| |
|The [Last Name], [Loan Number]−[BranchID] under the screen title is only displayed if this screen is launched in the context of a loan. |
| |
|The values displayed on this screen are the based on the parameters passed in by the calling screen (i.e., the list of parameters defined in |
|section 3.5.6.1 Fields Passed In, p. 31). In addition, upon loading, the values from section 3.5.6.2 Fields Calculated From Fields Passed In,|
|p. 37, are calculated. |
| |
|Here are hyperlinks to the sections of this screen: |
| |
|Top Section, p. 17 |
|Type of Mortgage Section, p. 17 |
|Terms of Loan Section, p. 18 |
|Purpose of Loan and Property Information Section, p. 20 |
|Property Address Section, p. 21 |
| |
|The tab order on this screen is from left to right and top to bottom, as when reading English text. It is not individually specified for each|
|control. Every enabled control is in the tab order. |
|Top Section |
|Screen Title |The screen title is "Pricing Parameters" |
|Borrower / Loan Number |The Borrower Name, Loan Number at the top of the screen, pictured above as |
|Text | |
| |SMITH, 1055000075-7405 |
| | |
| |is displayed only when the parameters passed into this screen contain a FileID. In that case, the last name, loan |
| |number, and BranchID displayed correspond to the FileID passed in. |
| | |
| |When not displayed, the content below it moves up to fill the empty space. |
|Inside Screen Label |The inside label text is |
| | |
| |Please confirm the information to be used when pricing this loan |
|Guideline Disclaimer |The Guideline Disclaimer is displayed only when the User came in from Product Finder after using "Choose My |
| |Product". |
| | |
| |The disclaimer text is in red font as displayed above. Text = |
| | |
| |Note that all pricing displayed is subject to the loan meeting the Guideline requirements for the selected product.|
| | |
| |When not displayed, the elements below it move up to fill the empty space. |
|Cutoff Time Disclaimer |The Cutoff Time Disclaimer is displayed only if the Cutoff Time Logic on p. 26 of the Lock Requests FD |
| |( Library/Lock Requests.doc ) returns "Online Lock Not Active…" given the logged in user's |
| |attributes, the current date and time, and the product passed into this screen. |
| | |
| |The disclaimer text is: |
| | |
| |Online lock is not active at this time. You may view pricing based on the latest published rate sheet, but the |
| |loan can't be locked at this time. |
| | |
| |When not displayed, the elements below it move up to fill the empty space. |
|Required Fields Reminder |This text is always displayed as in the image above: |
|Text | |
| |* = Required Field |
|Type of Mortgage Section |
|Product Text Box |This is a read only text field displaying the name of the product passed into this screen. |
|Amortization Type Text Box|([pic] 1215 Pricing Parameters Screen − Corrected Amortization Type text box description, see Type of Mortgage |
| |Section, p. Amortization Type Text Box, p. 17.) |
| |This is a ready only text box displaying the Amortization Type of the product passed into this screen. (Display |
| |"FIXED" if amortization type is Fixed Rate, Display "ARM" if amortization type is ARM). |
|Amortization Term Text Box|([pic] 1215 Pricing Parameters Screen − Corrected description of Amortization Term Text Box, p. 18.) |
| |This is a read only text box displaying the Amortization Term of the product passed into this screen. |
|Temporary Subsidy Buydown |([pic] 1219 Pricing Parameters screen − added back details for the Temporary Subsidy Buydown Dropdown, p. 18) |
|Dropdown |This dropdown initially displays the value passed into this screen via the Has Temporary Buydown parameter passed |
| |to this screen. |
| | |
| |The dropdown is modifiable only when the product passed into this screen has its Allow Buydowns? Checkbox checked |
| |or when the initial value for this field as passed into this screen is Yes (so that it can be set to No). |
|Lien Text Box |This is a read only text box that shows the Lien Type passed into this screen. 1 is displayed as "1ST". 2 is |
| |displayed as "2ND". |
|Interest Only Text Box |This is a read only text box that shows Yes or No, as calculated in the table of section 3.5.6.2, p. 37. |
|Terms of Loan Section |
|Base Loan Amount Text Box |This is a modifiable text box that allows any positive integer to be entered up to 10,000,000. It has the same |
| |constraints as Base Loan Amount on the My 1003 screen. |
| | |
| |Its initial value is the Base Loan Amount passed into this screen. |
|Subordinate Financing Text|This is a modifiable text box that allows any positive integer to be entered up to 10,000,000. It has the same |
|Box |constraints as Base Loan Amount on the My 1003 screen. |
| | |
| |Its initial value is the value of the Subordinate Amount parameter passed into this screen. |
|Document Type Dropdown |This is a modifiable dropdown with one entry for each value available in the Doc Type dropdown on Secondary Main. |
| | |
| |The initial value displayed on this screen is the value of the Doc Type field passed into this screen. |
|PMI MIP Funding Fee |([pic] 1215 Pricing Parameters Screen − PMI MIP Funding Fee Financed Text Box, p. 18, Defined the calculation used |
|Financed Text Box |to determine the initial value for this field.) |
| |This is a modifiable text box that lets the user type any dollar amount (dollars and cents allowed) where 0 ≤ |
| |amount ≤ 10,000,000.00. |
| | |
| |The initial value for this field is calculated from the Base Loan Amount and Base Factor passed into this screen. |
| |First, if the Base Loan Amount passed into this screen is null, it is treated as 0 for this calculation. If Base |
| |Factor is passed into this screen as null or negative, it is treated as 0 for this calculation. PMI MIP Funding |
| |Fee Financed = |
| | |
| |Base Factor * Base Loan Amount / 100. |
|Appraised Value |This is a modifiable text box that lets the user type any positive integer from 1 to 10,000,000. It has the same |
| |constraints as Base Loan Amount on the My 1003 screen. |
| | |
| |Its initial value is the Appraised Value passed into this screen. |
|Lowest Middle Fico Text |([pic] 1214 Pricing Parameters screen − Lowest Middle Fico Text Box details, p. 19 − changed the limit on this |
|Box |field from 800 to 900 to match Secondary Main.) |
| |This is a modifiable text box that lets the user type any integer from 0 to 900. |
| | |
| |Its initial value is the Fico At Lock value passed into this screen. |
|Loan Amount Text Box |This is a read only text box that initially displays the Loan Amount calculated in section 3.5.6.2 Fields |
| |Calculated From Fields Passed In, p. 37. |
| | |
| |After initial display, whenever the Base Loan Amount or PMI / MIP Funding Fee Financed fields change on this screen|
| |this loan amount is calculated to be the sum of those fields. |
|Purchase Price Text Box |This is a modifiable text box that can be blank or can contain any integer from 0 to 10,000,000. |
| | |
| |This field is required and has a red asterisk (*) to its left only when the Loan Purpose displayed on this screen |
| |is Purchase or the Document Type is Streamline. The Required Yes / No state and the corresponding presence or |
| |absence of the red asterisk is re-calculated any time the Loan Purpose or the Document Type value is changed on |
| |this screen. |
|Ratio 2 Text Box |This is a modifiable text box that can be blank or can contain a decimal number with 3 decimal places of precision.|
| |The number entered in this field must be such that 0 < number ≤ 100.000. |
| | |
| |The initial value is the value passed into this screen as the Ratio 2 parameter. |
|LTV Text Box |This is a read only text box that displays the value of LTV initially as calculated in section 3.5.6.2 Fields |
| |Calculated From Fields Passed In, p. 37. |
| | |
| |Whenever the Loan Purpose, Base Loan Amount, Appraised Value, or Purchase Amount fields change on this screen, the |
| |value of the LTV field is re-calculated using the formula defined for LTV in the Calculations Doc at |
| | Library/Loan Related Calculations.doc |
|Impounds Dropdown |This is a modifiable checkbox. The initial value is the one passed in the Impounds parameter to this screen (1 = |
| |Checked, 0 = Unchecked). |
|CLTV Text Box |This is a Read Only text box which initially displays the CLTV value calculated from values passed into this |
| |screen, as defined in section 3.5.6.2 Fields Calculated From Fields Passed In, p. 37. |
| | |
| |Whenever the Loan Purpose, Base Loan Amount, Appraised Value, Subordinate Amount, or Purchase Amount fields change |
| |on this screen, the value of the CLTV field is re-calculated using the formula defined for CLTV in the Calculations|
| |Doc at Library/Loan Related Calculations.doc |
|HUD Repo Dropdown |This is a modifiable dropdown containing the values Yes, No. When this screen is displayed, this field's initial |
| |value is the value passed in through the "Has HUD Repo?" parameter. 1 = Yes, 0 = No. |
|MI Plan Optn Dropdown |([pic] 1218 Pricing Parameters Screen − MI Plan Optn Dropdown, p. 19 − completed the details that define when this |
| |field is hidden vs. displayed, modifiable vs. read only, and what values are displayed.) |
| |This is dropdown contains [Blank] plus a subset of the elements in the MIPremiumPlanOption table: |
| | |
| |1. DFRD MONTHLY(ZOMP) |
| |2. SINGLE - CASH |
| |3. SINGLE - FINANCED |
| |4. UP-FRNT - CASH |
| |5. UP-FRNT - FINANCED |
| |6. NO UP-FRNT |
| |7. EXEMPT |
| | |
| |The initial value for this dropdown is the one passed in through the MI Plan Optn parameter to this screen. |
| | |
| |This dropdown is displayed only when the Lien displayed on this screen is 1st. |
| | |
| |This dropdown is always modifiable when displayed. |
| | |
| |[Blank] is always a value in this dropdown. Additional values displayed in this dropdown at any time are |
| |calculated as follows: |
| | |
| |If Loan Type is CONV, show the values 1−3 above. |
| | |
| |Else show the values 4−7 above. |
|Purpose of Loan and Property Information Section |
|Loan Purpose Dropdown |This is a modifiable dropdown containing the values REFINANCE and PURCHASE, in that order. |
| | |
| |The initial value of this dropdown is the one passed to this screen through the Loan Purpose parameter. |
|Refi Purpose Dropdown |This dropdown contains an entry for every value in the RefinancePurpose table when the Loan Purpose is Refinance: |
| | |
| |RATE/TERM |
| |LIMITED-C/O |
| |C/O-HOME IMP |
| |C/O-DEBT CONSOL |
| |C/O-OTHER |
| | |
| |When the Loan Purpose is Purchase, this dropdown contains only one element, which corresponds to Refi Purpose = |
| |null. This dropdown entry has text "N/A". |
| | |
| |This dropdown is modifiable when Loan Purpose = Refinance. It is Read Only when Loan Purpose = Purchase. |
| | |
| |The selected value, available values, and Read Only vs. Modifiable state of this dropdown are re-calculated |
| |whenever the Loan Purpose dropdown value changes. When the change is from Refinance to Purchase, the selected |
| |value changes to the only available value "N/A". When the change is from Purchase to Refinance, the initial value |
| |passed into this screen for Refi Purpose is selected. |
|Property Type Dropdown |This is a modifiable dropdown containing one value for each entry in the PropertyTypes table. Currently: |
| | |
| |SFR |
| |CONDO-LOW |
| |PUD |
| |UNITS-2 |
| |UNITS-3 |
| |UNITS-4 |
| |MANUFACTURED |
| |CONDO-HIGH |
|Cash Out Amount Text Box |If the Loan Purpose displayed on this screen = Refinance and the Refinance Purpose displayed on this screen is one |
| |of C/O-HOME IMP, C/O-DEBT CONSOL, C/O-OTHER: |
| | |
| |Cash Out Amount is a modifiable text box which initially displays the Cash Out Amount passed into this screen, or 0|
| |(zero) if the amount passed in was null. |
| | |
| |Else |
| |Cash Out Amount is a read only amount displaying the text "N/A", which corresponds to a null Cash Out Amount. |
| | |
| |When the Loan Purpose or Refinance Purpose dropdowns change values on this screen, this text box's Modifiable vs. |
| |Read Only state is re-calculated using the logic above and the value displayed in this text box is re-calculated. |
| |If the change is from Modifiable to Read Only, the new text is "N/A". If the change is from Read Only to |
| |Modifiable, the new value is (a) the passed in Cash Out Amount, if it was not null, or (b) 0 (zero) if the amount |
| |passed in was null. |
|Owner Occupied Dropdown |This is a modifiable dropdown containing the values YES, NO, 2ND. The initial value is the one passed in through |
| |the Owner Occupied parameter. (1 = YES, 0 = NO, 2 = 2ND). |
|Property Address Section |
|Property Number Text Box |This is a modifiable text box that allows arbitrary text up to 12 characters long. The initial value is the one |
| |passed into this screen through the Property Number parameter. |
|Property Street Text Box |This is a modifiable text box that allows arbitrary text up to 60 characters long. The initial value is the one |
| |passed into this screen through the Property Street parameter. |
|City Text Box |This is a modifiable text box that allows arbitrary text up to 50 characters long. The initial value is the one |
| |passed into this screen through the Property City parameter. |
|State Dropdown |This is a modifiable dropdown containing one value for every entry in the States table. Each element is |
| |represented by its State column, i.e., AZ, AK, etc. The values are displayed in alphabetical order. |
| | |
| |The initial value for this dropdown is the one passed in through the StateID parameter, which corresponds directly |
| |to the corresponding entry in the States table. |
|Zip Text Box |This is a modifiable standard Zip Code text box. It initially displays the value of Property Zip passed into this |
| |screen. |
|Price Loan Button |Control: Button |
| |([pic] 1215 Pricing Parameters Screen − Price Loan Button details, p. 21 − Functional Description − defined the |
| |fact that Base Factor is calculated from the values on this screen when the User clicks Price Loan successfully.) |
| |Functional Description: |
| |When the User clicks this button, first field and form validation is performed. If the field and form validation |
| |passes, the values in this screen, as modified on this screen, are passed into the Price Loan Screen, p. 22. Note |
| |that these values are not saved to any loan, even if the User enters this screen in the context of a loan. Values |
| |will only be saved to a loan when the User clicks Lock Now on the Price Loan Screen. |
| | |
| |Also, the Base Factor parameter passed to the Price Loan Screen is calculated from the Base Loan Amount and PMI MIP|
| |Funding Fee Financed on this screen as follows. If PMI MIP Funding Fee Financed is blank, it is treated as 0 for |
| |this calculation. Base Factor = |
| | |
| |PMI MIP Funding Fee Financed * 100 / Base Loan Amount |
| | |
| |Field Validation Logic: |
| |If any non-required field holds a value that isn't valid for its data type, a red X is displayed to the right of it|
| |and form submission is aborted. An error is displayed as defined in the UI standards at the top of the screen |
| |indicating that the user needs to fix those fields before continuing to price the loan. |
| | |
| |([pic] 1219 Pricing Parameters screen − Price Loan Button − Form Validation Logic, p. 22 − on saving this screen, |
| |disallow Temporary Subsidy Buydown = Yes if the product doesn't allow it.) |
| |Form Validation Logic: |
| |If any required field has no value or has a value that isn't valid for its data type, An error is displayed as |
| |defined in the UI standards at the top of the screen indicating that the user needs to provide a value for those |
| |fields before continuing to price the loan. Note specifically that Base Loan Amount must be at least 1. Also, |
| |when required, Appraised Value and Purchase Price must be at least 1. |
| | |
| |If the Temporary Subsidy Buydown being saved is set to Yes and the product passed into this screen has its Allow |
| |Buydown? Checkbox set to No (unchecked),form validation fails with the following error text in addition to any |
| |other errors detected: |
| | |
| |Product [Name] does not allow Temporary Subsidy Buydowns. |
| | |
| |where [Name] is the ProgramName of the product passed into this screen. |
|Cancel Button |When the User clicks this button, any changes made on this screen are discarded and the screen the User was on |
| |before coming to this screen is re-displayed, in the state it was in before this screen was displayed. |
4 Price Loan Screen
Overview
The Price Loan screen is an existing screen which, before the Price My Loan project, is always entitled "Request Lock".
Some changes are made on this screen to indicate that is used to Price a loan in addition to locking a loan, but the more complicated change is that it needs to change so that it is not called in the context of a loan. Instead, this screen is now called with a value for every loan field needed to price a loan (such as Note Loan Amount) or otherwise needed to display this screen.
These fields are then used to determine what margin to build into the pricing grid, and what pricing adjustments will be calculated for the loan using LoanTracker's pricing engine.
Entry Point
Before the Price My Loan project, the entry point was all locations that display a Request Lock icon (see section 6.1, p. 56, for a list), the Secondary Main screen's Request Lock button, and the Confirm Lock Information screen's View Online Pricing button.
After the Price My Loan project, the User still uses those entry points, but only the Confirm Lock Information screen's View Online Pricing button continues to launch this screen directly. The remaining locations lead to the Pricing Parameters Screen, p. 15, which is now generally the direct entry point to this screen.
Security
This document does not change the security of this screen.
Figure 3.5-2: Price Loan Screen - Top Half -- Existing Appearance
[pic]
Figure 3.5-3: Price Loan Screen Bottom Half - Existing Appearance
[pic]
Table 3.5-2: Price Loan Screen - Field And Control Details
|Price Loan Screen − Field And Control Details |
|Load Behavior |When this screen is displayed any location of LoanTracker that loads the screen must communicate to the screen the |
| |values of all loan data required to automatically price a loan and for this screen to function. The parameters passed |
| |in are the set of fields in section 3.5.6.1 Fields Passed In, p. 31. |
|The numbers preceding many of the rows below correspond to the numbers used to label various sections of the screen above. |
|1. Screen Title |The screen title changes from "Lock Request" to "Price Loan" |
|2. Under-title text |The text directly under the title is no longer displayed. |
|3. Inside Screen |This label is changed from "Online Lock" to "Price Loan" |
|Label | |
|4. Loan Number |If this screen is loaded with a FileID, |
| | |
| |this field displays: |
| | |
| |[LoanNumber]-[BranchID] |
| | |
| |where [LoanNumber] is the loan number of the loan with that FileID, [BranchID] is the ID of the branch passed into this |
| |loan. Note that this branch ID may or may not be equal to the loan's assigned branch. |
| | |
| |If this screen is loaded without a FileID, |
| | |
| |this field displays the text "N/A" |
|5. Property Address |If this screen is loaded with a FileID, |
| | |
| |this field displays the Property Number of the loan with that FileID. |
| | |
| |Otherwise |
| | |
| |this field displays "N/A" |
|6. Borrower Name |If this screen is loaded with a FileID, |
| | |
| |this field displays [FirstName] [LastName] |
| | |
| |where these are the first name and last name, respectively of the primary borrower associated with the loan. |
| | |
| |Otherwise |
| | |
| |this field displays "N/A" |
|7. Borrower SSN |If this screen is loaded with a FileID, |
| | |
| |this field displays [SSN] |
| | |
| |where [SSN] is SSN of the primary borrower associated with the loan. |
| | |
| |Otherwise |
| | |
| |this field displays "N/A" |
|8. Section header |This text changes from "Please select pricing to lock this loan" to "Please select pricing." |
|9. Hyperlink |This hyperlink text changes from "View Lock Parameters" to "View Pricing Parameters" |
|10. Product Name |The product name displayed here is the name of the product passed in to this screen. |
|11. Base Pricing |Before the Price My Loan project, this section displays the assigned product's Pima pricing grid, with each cell |
|Grid |incremented by a certain amount based on the loan's assigned branch, assigned product, and property state. |
| | |
| |After the Price My Loan project, the same occurs, except that the Branch, Product, and Property State used in the |
| |calculation are the ones passed into this screen. |
|12. Pricing |Before the Price My Loan project, this section has the following fields (not all sections are displayed every time the |
|Adjustments |screen is displayed): |
| | |
| |[pic] |
| | |
| |Base Price continues to be the number in the cell selected in the Base Pricing Grid. |
| | |
| |Branch Bonus: |
| | |
| |Before Price My Loan, this field displays the value of the Secondary Main screen's Bonus field (if that field has a |
| |non-zero value) for the loan in context. |
| | |
| |After Price My Loan, this field displays the value of the Branch Bonus field passed into this screen, if it is non-zero.|
| |Otherwise this field isn't displayed. |
| | |
| |Max Price label: |
| | |
| |Before Price My Loan, this field displays a number such as 100.250 in the image directly above, which is equal to the |
| |following sum: |
| | |
| |Max Rebate – Branch Margin − Online Lock Bonus − Secondary Main Bonus, |
| | |
| |where Max Rebate is as displayed on the product’s Loan Product Detail screen, Branch Margin is the margin assigned to |
| |the loan’s assigned Branch with respect to the loan’s assigned product, as of the publication date in effect on this |
| |screen, Online Lock Bonus is equal to the assigned branch’s Online Lock Bonus if it has one and the User is a Broker |
| |user, or zero in all other cases, and Secondary Main Bonus is the value displayed as Bonus in the Lock Terms section of |
| |the Secondary Main screen. |
| | |
| |After Price My Loan, |
| | |
| |Max Rebate is as displayed for the product passed in as a parameter to this screen. |
| | |
| |Branch Margin is the margin for the branch passed into this screen with regard to the product passed into this screen, |
| |as of the publication date in effect on this screen. |
| | |
| |Online Lock Bonus is equal to the Online Lock Bonus of the branch passed into this screen if it has one and the User is |
| |a Broker user, or zero in all other cases. |
| | |
| |Secondary Main Bonus is equal to the Branch Bonus passed into this screen. |
| | |
| |In short, all of the data that was previously loan-specific is now based on the data passed into the screen. |
| | |
| |Similarly, the formula used to calculate whether a Max Rebate adjustment should be added to the pricing adjustments, and|
| |what value it should have, is changed |
| | |
| |([pic] 1218 Price Loan Screen − Pricing Adjustments Section − Max Rebate Before And After, p. 27 − specified what's |
| |changing in the logic that determines whether a Max Rebate adjustment is displayed in the pricing adjustments grid, and |
| |when it is displayed what its value should be. The calculation is the same but two values are now retrieved from |
| |parameters passed into the screen.) |
| |Max Rebate Before And After |
| |Before the Price My Loan project, the logic is as follows: |
| | |
| |The Max Rebate adjustment row is displayed if and only if the assigned product has a non-blank Max Rebate field in Loan |
| |Product Details and Subtotal < Minimum Price, where Minimum Price = 100.0 − (Max Rebate − Branch Margin − Online Lock |
| |Bonus − Secondary Main Bonus). |
| | |
| |If the Max Rebate adjustment row is displayed, its value is the amount X that must be added to Subtotal such that |
| |Subtotal + X = Minimum Price. |
| | |
| |After the Price My Loan project, the logic is similar (differences are in bold): |
| | |
| |The Max Rebate adjustment row is displayed if and only if the product passed in the parameters to this screen has a |
| |non-blank Max Rebate field in Loan Product Details and Subtotal < Minimum Price, where Minimum Price = 100.0 − (Max |
| |Rebate − Branch Margin − Online Lock Bonus − the Branch Bonus parameter passed into this screen). |
| | |
| |If the Max Rebate adjustment row is displayed, its value is the amount X that must be added to Subtotal such that |
| |Subtotal + X = Minimum Price. |
|13. Rate / Margin |This grid is changed so that all adjustments are based on the parameters passed into this screen. |
|Adjustment | |
|Standalone Adjustment|(not pictured above) |
|Checkbox | |
| |[pic] |
| | |
| | |
| |This checkbox is displayed if and only if the list of Rate / Margin adjustments contains a Standalone adjustment and the|
| |Linked Loan Status passed into this screen indicates a loan with [blank] or Unknown status. |
| Buy Ups / Buy Downs |(not pictured above) |
|section | |
| |[pic] |
| |The Buy Ups and Buy Downs section of the screen changes so that instead of getting its information from the product |
| |"assigned to the loan" it gets its information from the product passed into this screen. |
|Lock Now Button |When the User clicks the Lock Now button, the following currently happens, as described in more detail on p. 82 of the |
| |Maximizing Online Lock FD at |
| | |
| | Online lock/Functional Designs/Maximize Online Lock - Phase 1.doc |
| | |
| |Existing Lock Now Behavior. |
| |On screen validation is performed. Also occurs in step 1 in the new process below. |
| |Notepad entry is created if user is trying to lock a loan that doesn't meet stage requirements for the loan's assigned |
| |product This is performed in step 7 in the updated process below. |
| |Express Lock event data validations are triggered. This is performed in step 9 of the updated process below. |
| |Loan is checked to see if it conforms to guidelines programmed for the product. This is performed in step 13 of the |
| |updated process below. |
| |Loan is sent to the lock request queue if the loan doesn't meet guidelines or if the product passed in is not an Express|
| |lockable product. Performed in steps 11 and 13 of the updated process below. |
| |Loan is express locked (if meets guidelines and has an Express Lockable product assigned). This is performed in step 15 |
| |of the updated process below. |
| | |
| |This process is changed to the following (this process is followed by a flow chart that shows more graphically the logic|
| |flow): |
| | |
| |([pic] 0111a Price Loan Screen − Lock Now Button − New Submit Process For Price Loan Screen, p. 28: Modified steps 4, |
| |5, and 6, to prevent duplicating a loan save process if the loan was saved through the Register Loan screen, and to |
| |instead only save the loan data based on the passed-in parameters if the Register Loan screen was not displayed.) |
| |New Submit Process For Price Loan Screen |
| | |
| |Perform On Screen Data Validation. |
| |If the validation failed, display the appropriate error as in the FD linked above and end this process. Otherwise |
| |continue to the next step. |
| |Was this screen launched in the context of a loan? (i.e., was a FileID passed in from the calling context?) If not, |
| |proceed to step 4 where the User can register the loan. If in the context of a loan, proceed to step 5 where the |
| |process continues in the context of an already-created loan. |
| |The Register Loan Screen, p. 37, is displayed with all property address variables set to the values passed into this |
| |screen. That screen allows the user to enter the minimum amount of information required to register a loan. When |
| |control returns from that screen, this screen is re-displayed in the state it was in before the User navigated away. If|
| |the screen indicates that the User created a loan, it returned a FileID which this screen can now use as a reference to |
| |the loan which the User is attempting to lock. This process continues at step 7. If the screen indicates that the User|
| |cancelled out of it, then this process is ended. |
| |([pic] PML-47 Price Loan Screen − Lock Now Button logic, step 5, p. 29 − in the context of a loan direct the User to the|
| |Register / Lock Loan screen if Rep is missing on loan) At this point in the logic we know we're in the context of a |
| |specific loan L. If at least one of the Rep, Property Number, Property Street, Property City, or Property Zip fields |
| |for the loan is not known at this time, or if either the Property Number or Property Street is likely to be a TBD |
| |address as defined in the Form Validation Logic of the Register Loan screen, p. 43, the Register Loan Screen, p. 37 is |
| |displayed in the context of loan L with all of the address values populated as passed into this screen. If the User |
| |cancelled out of that screen, this process is terminated and this screen is re-displayed. If the user provided address|
| |information on that screen this process continues at step 7. |
| |If the Register Loan screen was not displayed above, all of the data passed into this screen when it was displayed is |
| |saved to the loan, also triggering any dependent fields to be re-calculated. This is required for the data validation |
| |that follows to give correct results. |
| |The existing notepad entry related to a lock attempt on a loan that doesn't meet stage requirements is logged. |
| |The prepay data for the loan is calculated and saved to the loan data as defined in |
| |. |
| |The Express Lock data validation event is triggered in the context of this loan. |
| |If the data validation fails with at least one error (i.e. one non-warning), or if the data validation fails with only |
| |warnings, but the User chooses not to ignore those warnings, this screen is re-displayed and the process of locking a |
| |loan ends. If the validation passes or fails with only warnings which the User ignores, this process continues. |
| |Check for Cutoff Time: Does the Cutoff Time logic as specified on p. 26 of the Lock Requests FD indicate that the lock |
| |process can continue? If yes, continue to step 15. If not, display the error text defined in that FD (should already |
| |be implemented this way), log the lock attempt as described in section 3.5 p. 20 of the same document, and terminate |
| |this process (this loan is not sent to the lock request queue for further processing). |
| |Check For Express Lockable: Consider the product passed into this screen. If that product is not express lockable, |
| |this process continues at step 14. If the product is express lockable, continue at the next step. |
| |Check For Guidelines: Does the set of loan parameters passed into this screen indicate that a loan with those values |
| |would be within our outside of product guidelines programmed in LoanTracker? If outside of guidelines, continue with |
| |step 14. If within guidelines, continue with step 15. |
| |Send To Lock Request Queue: If this logic is being performed, the loan either doesn't meet guidelines, or the product |
| |is not express lockable, or both. All of the information passed into this screen is saved into the data of the loan in |
| |context. The User sees the existing lock confirmation seen when the loan was sent to the lock request queue (not the |
| |one that indicates the loan was express locked). This process ends. The lock will need to be completed by a pricing |
| |analyst using Resources > Administration > Secondary > Lock Requests, where this loan can be found with all attributes |
| |as displayed on this screen. |
| |Complete Online Lock: If this logic is being performed, the lock is ready to be completed. The logic to complete the |
| |lock is as described after the text "Assuming the loan conforms to product guidelines and the current time is within the|
| |cutoff time, this loan’s data is modified as follows…" in the Maximizing Online Lock functional design and the |
| |confirmation / disclaimer screen, in the context of the existing loan, or newly created loan if the loan registration |
| |was performed as part of the lock. |
| | |
| |[pic] |
| | |
| |[pic] |
5 Lock Request Details Screen
The Lock Request Details screen does not need to be changed based on this functional design. However, it is important to make while testing this functionality that when a loan is sent to the Lock Request Queue it displays all of the data as seen by the User on the Pricing Parameters Screen, p. 15, and the Price Loan Screen, p. 22, before the User clicked Lock Now.
6 Fields Used By The Lock Process
This section describes all of the fields used by the lock process. It defines their allowed values and where the values come from in the context of a loan.
1 Fields Passed In
|Field Name |Allowed Values |More Field Details |
|FileID |Any number allowed as a value in the General.FileID|General.FileID uniquely identifies a loan. This field is not |
| |field. |visible in any UI. |
| | | |
| |May be null to request pricing, must be non-null at|This is needed in the lock process to indicate whether it is being |
| |the time of lock, after the User registers the |loaded in the context of a loan. Non-null FileID implies the |
| |loan. |context equals loan. Null FileID means the context is not a loan. |
|BranchID |Any number allowed as a value for the |General.BranchID uniquely identifies which branch a loan is |
| |General.BranchID field. |associated with. This field is represented by the name of the |
| | |corresponding branch, displayed to the right of the Branch button on|
| |Must not be null during the pricing process. |the General Information section of Secondary Main, among other |
| | |screens. |
| | | |
| | |This is needed in the lock process among other things which branch |
| | |to use when determining what margin to apply in the Base Price grid |
| | |on the Price Loan screen. |
|ProgramID |Any number allowed as a value for |General.ProgramID uniquely identifies which product a loan is |
| |General.ProgramID. |associated with. |
| | | |
| |Must not be null during the pricing process. |This field is represented by the name of a product, displayed to the|
| | |right of the Product button on Secondary Main, among other |
| | |locations. |
| | | |
| | |This is needed in the lock process because the ProgramID (also |
| | |referred to as the Product) is used to determine which set of |
| | |pricing adjustment rules will apply to a loan. |
|Lien Position |1 or 2 |General.Lien contains the Lien position associated with any loan. |
| | | |
| |This field is usually implied by the product, but |Used to determine pricing adjustments. |
| |it is not always implied by the product, so it is | |
| |passed in explicitly as a parameter rather than | |
| |calculated based on the ProgramID. | |
| | | |
| |Must be present during the pricing process. | |
|Base Loan Amount |Any positive integer that is a valid value for |General.BaseLoanAmount contains the base loan amount for any loan. |
| |General.BaseLoanAmount | |
| | |This field is required by the lock process because it is needed to |
| |May be passed in null to the Pricing Parameters |calculate the Note Loan Amount which is used to price loans. |
| |screen, must be non-null when passed to the Price | |
| |Loan screen. | |
|Base Factor |A positive floating point number with three digits |General.BaseFactor contains the Base Factor for any loan. |
| |after the decimal point. | |
| | |This field is required by the lock process because it is needed to |
| |May be null during the pricing process. |calculate the Note Loan Amount which is used to price loans. |
|MI Plan Optn |Any integer ID that can represent an item in the |Underwriting . MIPremiumPlanOptionID contains this field for any |
| |MIPremiumPlanOption table. Currently: |loan. |
| | | |
| |1 DFRD MONTHLY(ZOMP) |This field is required to calculate the Financed VAFF / MIP / PMI |
| |2 SINGLE - CASH |field, which is in turn used to calculated Note Loan Amount which is|
| |3 SINGLE - FINANCED |used to price loans. |
| |4 UP-FRNT - CASH | |
| |5 UP-FRNT - FINANCED | |
| |6 NO UP-FRNT | |
| |7 EXEMPT | |
| | | |
| |May be null during the pricing process. | |
|Fico At Lock |Any non-negative integer up to 900. |Secondary . BorrowerFicoAtLock |
| | |Displayed on Secondary Main's Lock Info section as "Fico At Lock". |
| |May be null during the pricing process. | |
| | |Used to calculate pricing |
|Loan Purpose |Any value that has a LoanPurposeID in the Purpose |General . Purpose. |
| |table. Currently: |Displayed on Secondary Main General Information section's Purpose |
| | |dropdown. |
| |1 (Purchase), or 2 (Refinance) | |
| | |Used to calculate pricing. |
| |Must be present during the pricing process. | |
|Refi Purpose |Any value that has a RefinancePurposeID in the |General . RefinancePurposeID |
| |RefinancePurpose table. | |
| | |Displayed on Secondary Main General Information section's Refi |
| |Currently: |Purpose dropdown, which is only displayed if the Purpose dropdown |
| |1 (Rate / Term) |above it is set to Refinance. |
| |2 (Limited-C/O) | |
| |3 (C/O-Home IMP) |Used to calculate pricing. |
| |4. (C/O-Debt Consol) | |
| |5 (C/O-Other) | |
| | | |
| |Must be present during the pricing process. | |
|Cash Out Amount |Any non-negative integer. |Underwriting . CashOutAmount |
| | | |
| |May be null during the pricing process. |Displayed on Secondary Main General Information section's C/O Amount|
| | |field, under the Refi Purpose when the Refi Purpose is C/O- (Home |
| | |IMP, Debt Consol, or Other). |
| | | |
| | |Used to calculate pricing |
|Purchase Amount |Any positive integer allowed in the General . |General . PurchaseAmount |
| |PurchaseAmount field. | |
| | |Displayed on Secondary Main General Information section's Purchase |
| |May be null during the pricing process. |Amount field. Applies only if Purpose = Purchase. |
| | | |
| | |Used to calculate pricing. |
|Appraised Value |Any positive integer allowed in the General . |General . AppraisedValueForLTV |
| |AppraisedValueForLTV field. | |
| | |Displayed on Secondary Main General Information section's Appraised |
| |May be null during the pricing process. |Value field. |
| | | |
| | |Used to calculate pricing. |
|Doc Type |Any DocTypeID available in the DocTypes table. |General . DocumentType |
| | | |
| |Must be present during the pricing process. |Displayed on Secondary Main General Information section's Doc Type |
| | |dropdown. |
| | | |
| | |Used to calculate pricing. |
|Property Type |Any PropertyTypeID available in the PropertyTypes |General . PropertyType |
| |table. Current values are 1 through 9: | |
| | |Displayed on Secondary Main General Information section's "Type" |
| |SFR, CONDO-LOW, PUD, UNITS-2, UNITS-3, UNITS-4, |dropdown under Rate / Lien. |
| |MANUFACTURED, CONDO-HIGH | |
| | |Used to calculate pricing. |
| |Must be present during the pricing process. | |
|Owner Occupied |Any OwnerOccupancyID available in the |General . OwnerOccupied |
| |OwnerOccupancy table. Current values are 0 through| |
| |2: |Displayed on Secondary Main General Information section's O/O? |
| | |dropdown to the right of the property address Zip field. |
| |NO, YES, 2ND | |
| | | |
| |Must be present during the pricing process. | |
|Ratio 2 |A positive floating point number 0 < n ≤ 100, with |Underwriting . Ratio2 |
| |three digits to the right of the decimal place. | |
| |(0.001 to 100.000 is allowed). |Displayed on Secondary Main General Information section's Ratio 2 |
| | |text box. |
| |May be null during the pricing process. | |
| | |Used to calculate pricing. |
|Impounds |Allows a 1 or a 0 value, corresponding to checked |General . Impounds |
| |and unchecked, respectively. | |
| | |Displayed on Secondary Main General Information section's |
| |Must be present during the pricing process. |"Impounds?" checkbox. |
| | | |
| | |Used to calculate pricing. |
|Subordinate Amount |Allow any floating point value with two decimal |Underwriting . SubordinateAmount |
| |places. | |
| | |Displayed on Secondary Main General Information section's |
| |May be null during the pricing process. |Subordinate Amt text box. |
| | | |
| | |Used to calculate CLTV which is required to calculate pricing. |
| | | |
| | |Also used to determine whether or not the loan has a subordinate |
| | |amount which is also required to calculate pricing. i.e., non-null |
| | |implies "Has Subordinate Amount". |
|Has Temporary |([pic] 1219 Added back the Has Temporary Buydown |General . Buydown |
|Buydown? |field in the list of fields passed in when pricing | |
| |a loan. See Has Temporary Buydown?, p. 34.) |Displayed on Secondary Main General Information section's "Buydown?"|
| |1 / 0 for checked / unchecked, respectively. |checkbox. |
| | | |
| | |Used to calculate pricing. |
|Has HUD Repo? |1 / 0 for checked / unchecked, respectively. |General . Repo |
| | | |
| | |Displayed on Secondary Main General Information section's "HUD |
| | |Repo?" checkbox. |
| | | |
| | |Used to calculate pricing. |
|Linked Loan Status |May be null or any LoanLinkedToID from the |This field is always null when the pricing / lock logic is called |
| |LoanLinkedTo table. |outside the context of a loan. |
| | | |
| | |When inside the context of a loan, this field is considered null if |
| | |the "Linked Loan?" dropdown has [blank] selected, or LoanLinkedToID |
| | |= 1 if FMFC is selected, 2 if Non-FMFC is selected, 3 if Unknown is|
| | |selected. |
| | | |
| | |Note To Developer: Linked Loan information for any loan L1 is |
| | |sometimes stored in a loan L2 linked to L1. Please discuss with the|
| | |Maximizing Online Lock team to ensure that the values of linked loan|
| | |fields are determined correctly in the context of a loan. |
|Linked Loan FileID |null or any FileID |Outside the context of a loan |
| | | |
| | |this is always passed in as null. |
| | | |
| | |In the context of a loan, |
| | | |
| | |If the "Linked Loan?" dropdown displays blank, or any value other |
| | |than FMFC, this is passed in as null. |
| | | |
| | |If the "Linked Loan?" dropdown displays FMFC and the FMFC Loan field|
| | |displays (none), this means no loan is linked yet so Linked Loan |
| | |File ID is passed in as null. |
| | | |
| | |If the "Linked Loan?" dropdown displays FMFC and the FMFC Loan field|
| | |displays a hyperlink to a loan, Linked Loan FileID is the FileID of |
| | |the loan displayed in the hyperlink. |
|Product assigned to |Any valid value for Programs . ProgramID. May be |If the Linked Loan FileID passed in is null, this field is always |
|linked loan |null. |null. |
| | | |
| | |If the Linked Loan FileID is not null and there's a product assigned|
| | |to the loan with that FileID, this field contains the ProgramID of |
| | |that product. If there's no product assigned to that loan, this |
| | |field is null. |
| | | |
| | |This field is used to price a loan. |
| | | |
| | |Note to developer: It could be thought of as an optimization to |
| | |pass in just the linked loan file ID and calculate the assigned |
| | |product within the Price Loan logic. However, this can lead to |
| | |problems such as a loan being locked based on one set of parameters |
| | |and then the linked loan's product being changed while the loan is |
| | |being locked, which will imply pricing is based on the wrong |
| | |information. Instead, pricing will be based on the linked loan's |
| | |information at the time the User attempted to price the loan. Then |
| | |when the loan is locked, it is updated to reflect the data used to |
| | |price the loan. |
|Linked Loan Lock |null, or a datetime value. |If the Linked Loan FileID passed in is null, this value is always |
|Date | |null. |
| | | |
| | |If the Linked Loan FileID is not null, this is passed in as the |
| | |corresponding General . LockDate value, which may be null or a |
| | |datetime value. |
| | | |
| | |This is used to price a loan. |
|Linked Loan Funded |null, or a datetime value |If the Linked Loan FileID passed in is null, this value is always |
|Date | |null. |
| | | |
| | |If the Linked Loan FileID is not null, this is passed in as the |
| | |corresponding Funding . Funded value, which may be null or a |
| | |datetime value. |
|Non-FMFC Loan Info |Any ID from the NonFMFCLoanInfo table, or null. |Outside the context of a loan, this is always passed in as null. |
| | | |
| | |In the context of a loan, this is passed in with the value in |
| | |General . NonFMFCLoanInfoID. |
| | | |
| | |This is used to price a loan. |
|Branch Bonus |null, or any value allowed in the Secondary . |Outside the context of a loan, this is always passed in as null. |
| |BuyBonus field | |
| | |In the context of a loan, this is passed in with the value in the |
| | |Secondary . BuyBonus field. |
|Property Number |null or up to 12 characters of arbitrary text. |General . PropertyNumber |
| | | |
| | |Secondary Main / General Info Section |
| | | |
| | |Not used to price a loan, but used to make sure that the property |
| | |associated with the loan is a real property and not changed after |
| | |the loan is locked. |
|Property Street |null or up to 60 characters of arbitrary text. |General . PropertyCity |
| | | |
| | |Secondary Main / General Info Section |
| | | |
| | |Not used to price a loan, but used to make sure that the property |
| | |associated with the loan is a real property and not changed after |
| | |the loan is locked. |
|Property City |null or up to 50 characters of arbitrary text. |General . PropertyCity |
| | | |
| | |Secondary Main / General Info Section |
| | | |
| | |Not used to price a loan, but used to make sure that the property |
| | |associated with the loan is a real property and not changed after |
| | |the loan is locked. |
|Property State |null or any StateID from the States table. |General . PropertyState contains a two-character value that maps to |
| | |a StateID. |
| | | |
| | |Secondary Main / General Info Section. |
| | | |
| | |Used to price loans. |
|Property Zip |null or text representing any Zip code |General . PropertyZip |
| | | |
| | |Secondary Main / General Information Section. |
| | | |
| | |Not used to price a loan, but used to make sure that the property |
| | |associated with the loan is a real property and not changed after |
| | |the loan is locked. |
2 Fields Calculated From Fields Passed In
|Field Name |Why Needed |Calculation |
|Online Lock Bonus |Used by the Price Loan screen to determine |If the logged in user is a Broker user and the user's branch's Branch |
| |whether the Max Rebate adjustment applies and, |Admin screen displays a non-zero Online Lock Bonus, that value is used |
| |if so, what its amount is. |for Online Lock Bonus. |
| | | |
| | |Any broker user's branch is the branch associated with the broker |
| | |company that employs that broker user. |
|Has Subordinate Amount|Used to price loan. |If the Subordinate Amount is passed in as non-null, this calculates to |
| | |Yes. Else it calculates to No. |
| | | |
| | |The reason this is called out explicitly in this document is that there|
| | |are pricing adjustments that, at least in the UI, are triggered based |
| | |on Subordinate = Yes / No. |
|Has Self Insured MI |Used to price loan |This value used in pricing a loan is calculated from the product being |
| | |used to price the loan. |
|Interest Only |Used to price loan |Can be calculated from the product passed in (use the value of the |
| | |Interest Only checkbox near the top right of the product details |
| | |screen). If checked, Interest Only = Yes. Else Interest Only = No. |
|Note Loan Amount |Used to price loan |Use the calculation currently used in LoanTracker when, for example, |
| | |the Base Loan Amount is changed. |
|LTV |Used to price loan |Use the calculation currently used in LoanTracker when, for example, |
| | |the Purchase Amount is changed. |
|CLTV |Used to price loan |Use the calculation currently used in LoanTracker when, for example, |
| | |the Appraised Value is changed. |
6 Register Loan Screen
Overview
The Register Loan / Enter Address Information Screen is a new screen created for this FD that allows the User to enter the minimum information needed to lock a loan that is in addition to the minimum information needed to price a loan.
In the case of a non-registered loan, it must be registered and its address information must be provided.
In the case of an already-registered loan, its address information must be provided.
Entry Point
This screen is launched from the Price Loan Screen, p. 22, when the user tries to lock a loan outside the context of a loan, and whenever the User tries to lock a loan inside or outside the context of a loan, without all address information provided.
Security
There is no specific security on this screen
Figure 3.6-1: Example Screen Shot - Register Loan Screen
[pic]
([pic] 1214 Register Loan Screen, p. 37, removed duplicate loan section from this screen, and all functionality related to detecting and displaying duplicate loans.)
Table 3.6-1: Register Loan Screen − Field And Control Details
|Register Loan Screen − Field And Control Details |
|Screen Title and |([pic] PML-47 Register / Lock Loan Screen − Screen Title and Purpose, p. 38 − change title to reflect that in the |
|Purpose |context of a loan, not just Address information may be requested. Generalized name to be "Additional Information".) |
| |If the context of this screen is an unregistered loan, the screen title is "Register Loan" and its purpose is to |
| |register the loan. If the context is a registered loan, the title is "Additional Information" and its purpose is to |
| |provide additional information for the loan. |
|General Information |This section allows the User to view what branch is being used to price the loan and view / set which Rep will be |
|Section |associated to the new loan about to be registered when viewed outside the context of a loan, or which rep will be |
| |assigned to the loan when it is locked. |
|Branch Label |([pic] PML-47 Register / Lock Loan Screen − Branch Label, p. 39 − new field added to give users more information |
| |while selecting a Rep for the loan about to be locked.) |
| |This static text is always displayed on this screen. It displays the branch being used to price the loan, in the |
| |format [BranchID] − [Branch Short Name]. |
|Rep Dropdown |([pic] PML-47 Register / Lock Loan Screen − Rep Dropdown, p. 39 − new dropdown lets users select a Rep when |
| |applicable while attempting to lock a loan.) |
| |Tab Order: 1 |
| | |
| |Control: Dropdown |
| | |
| |Functional Description |
| |This dropdown is always displayed on this screen. |
| | |
| |If this screen is displayed in the context of a loan with a Rep, the dropdown contains just that Rep and is disabled.|
| | |
| |If outside of a loan, or inside a loan without a Rep: |
| | |
| |If the User is a Broker employee |
| | |
| |The dropdown contains exactly one value, the primary Rep associated with the logged-in User, and it is disabled. |
| | |
| |If the User is an FMFC Employee |
| | |
| |The dropdown contains one entry for every non-Excluded Rep in LoanTracker where all of the following are true: |
| | |
| |The logged-in User has access to the Rep. |
| |The Rep has access to the Branch being used to price the loan. |
| |The Rep is a Rep for the business channel this loan belongs to: |
| |If the Branch being used to price this loan is a Wholesale or Correspondent branch, the Rep must be specified as a |
| |Wholesale Rep in Employee Admin. |
| |If the Branch used to price this loan is a Retail or Joint Venture branch, the Rep must be specified as a Retail Rep |
| |in Employee Admin. |
| |(only checked if this screen is launched in the context of a loan) The Rep is consistent with the Loan data: |
| |If the loan has an assigned Contact, the Rep must be one of the Reps associated with that Contact. |
| |If the loan doesn't have an assigned Contact but does have an assigned Broker, the Rep must be one of the Reps |
| |associated with the Broker. |
| | |
| |Case 1: Pricing Analyst |
| |If the User has privilege ID 190, this dropdown is modifiable and contains the value "- - - Select - - -" followed by|
| |one entry for every Rep returned by the logic above, followed by one entry labeled "(not known)". |
| | |
| |Case 2: Non-Pricing Analyst − No Reps Returned |
| |If the User doesn't have privilege ID 190 and no Reps are returned by the logic above, this dropdown is blank. This |
| |means the User will not be able to lock the loan since a rep is required. |
| | |
| |Case 3: Non-Pricing Analyst − One Rep Returned |
| |If the User doesn't have privilege ID 190 and exactly one Rep is returned by the logic above, the dropdown contains |
| |just that rep and is not modifiable. |
| | |
| |Case 4: Non-Pricing Analyst − Multiple Reps Returned |
| |If the User doesn't have privilege ID 190 and more than one Rep is returned by the logic above, the dropdown contains|
| |"- - - Select - - -" followed by one entry for every returned rep. |
| | |
| |In all cases above, the Rep or Reps displayed in this dropdown are displayed in the format [First Name] [Last Name]. |
| |The reps are displayed in alphabetical order. |
|Borrower Information |The section header for this section and its fields are only displayed if the title of this screen is Register Loan. |
|Section | |
|Borrower Last Name |Tab Order: 2 |
| | |
| |Control: Text Box |
| | |
| |Data Type: Allows up to 50 characters of text. |
| | |
| |Default Value: blank |
| | |
| |Functional Description: Standard text box behavior. Displayed only if screen title is Register Loan. |
| | |
| |Field Validation Logic: Any text is allowed |
| | |
| |Form Validation Logic: Must be present on submit, or an error occurs. |
|Borrower First Name |Tab Order: 3 |
| | |
| |Control: Text Box |
| | |
| |Data Type: Allows up to 35 characters of text. |
| | |
| |Default Value: blank |
| | |
| |Functional Description: Standard text box behavior. Displayed only if screen title is Register Loan. |
| | |
| |Field Validation Logic: Any text is allowed |
| | |
| |Form Validation Logic: Must be present, or an error occurs. |
|Borrower SSN |Tab Order: 4 |
| | |
| |Control: Text Box |
| | |
| |Data Type: SSN |
| | |
| |Default Value: blank |
| | |
| |Functional Description: Standard FMFC SSN field. Displayed only if screen title is Register Loan. |
| | |
| |Field Validation Logic: Standard SSN field validation |
| | |
| |Form Validation Logic: Must be present on submit, or error is displayed. |
|Property Address |This section and its fields are always displayed when this screen is displayed. |
|Information Section | |
|Property Number |Tab Order: 5 |
| | |
| |Control: Text Box |
| | |
| |Data Type: Allows up to 12 characters of text |
| | |
| |Default Value: as passed into this screen |
| | |
| |Functional Description: standard Text Box. Required Field. |
| | |
| |Field Validation Logic: Any text is allowed. |
| | |
| |Form Validation Logic: Must be present on submit or error is displayed. |
|Property Street |([pic] 1214 Register Loan screen − added details for the Property Street, City, State, and Zip fields. See details |
| |starting with Property Street, p. 41.) |
| |Tab Order: 6 |
| | |
| |Control: Text Box |
| | |
| |Data Type: Allows up to 60 characters of text |
| | |
| |Default Value: as passed into this screen |
| | |
| |Functional Description: standard Text Box. Required Field. |
| | |
| |Field Validation Logic: Any text is allowed. |
| | |
| |Form Validation Logic: Must be present on submit or error is displayed. |
|Property City |Tab Order: 7 |
| | |
| |Control: Text Box |
| | |
| |Data Type: Allows up to 50 characters of text |
| | |
| |Default Value: as passed into this screen |
| | |
| |Functional Description: standard Text Box. Required Field. |
| | |
| |Field Validation Logic: Any text is allowed. |
| | |
| |Form Validation Logic: Must be present on submit or error is displayed. |
|Property State |Tab Order: 8 |
| | |
| |Control: Dropdown |
| | |
| |Read Only |
| | |
| |List Values: only the value passed into this screen is displayed. The state can't be changed on the loan because |
| |that would require re-pricing the loan. |
| | |
| |Default Value: as passed into this screen |
| | |
| |Functional Description: Standard dropdown. |
| | |
| |Form Validation Logic: Must be non-empty on submit or error is displayed. |
|Property Zip |Tab Order: 9 |
| | |
| |Control: Text Box |
| | |
| |Data Type: Standard FMFC Zip Code text box. |
| | |
| |Default Value: as passed into this screen |
| | |
| |Functional Description: Has the behavior of standard FMFC Zip Code text boxes. |
| | |
| |Form Validation Logic: Must be present on submit or error is displayed. |
|Register | Lock Now |([pic] PML-47 Register / Lock Loan Screen − Register | Lock Now Button, p. 42 − additional Field Validation logic to |
|Button |make sure Rep is selected when appropriate − additional Functional Description logic to assign Rep added.) |
| |Tab Order: 10 |
| | |
| |Control: Button |
| | |
| |Functional Description: |
| |The caption of this button is Register and Lock Now if the title of this screen is Register Loan. Otherwise the text|
| |is Lock Now. |
| | |
| |When the User clicks this button, first Field validation and Form validation occurs as defined below. If it fails, |
| |the process of registering the loan is aborted and the User is left at this screen in the state it was in before |
| |clicking Register and Lock Now. If field and form validation passes, the process continues. |
| | |
| |If the screen purpose (as defined at the top of this table) is to Register the loan |
| | |
| |LoanTracker creates the loan with all of the data passed into the Price Loan screen before this screen was displayed.|
| |This includes all of the normal side effects of (a) creating a loan with just SSN / Last Name First Name, (b) |
| |assigning a branch, (c) assigning a product, and (d) setting all of the fields on the loan as passed in through |
| |parameters with the addition of the field values provided on this screen, (e) assigning a Rep, if a Rep is selected. |
| |Control is returned to the Price Loan letting it know the FileID of the newly-created loan and the fact that the User|
| |provided all required address information. |
| | |
| |If the screen purpose is to provide additional information for the loan: |
| | |
| |The address and Rep information displayed on this screen and all field passed into the Price Loan process as |
| |parameters are saved to the loan. Control is returned to the Price Loan screen letting it know that the User |
| |provided the appropriate address information. Note if Rep is assigned through this screen, the same logic is used as|
| |when assigning a Rep through the General Information section of a loan. |
| | |
| |Security: |
| | |
| |Field Validation Logic: If the data in any field displayed above doesn't match the format required by that field, a |
| |red X is placed to its right. Errors are displayed at the top of the screen as defined in the UI standards for |
| |fields formatted incorrectly by a User. If the Rep dropdown is blank or contains the "- - - Select - - -" value, a |
| |red X is placed to its right and error text is displayed per UI Guidelines for a required field that is missing. |
| | |
| |Form Validation Logic: If any displayed required field on this screen is not present, a red X is placed to its |
| |right. Errors are displayed at the top of the screen as defined in the UI standards for required fields that the |
| |User did not enter. |
| | |
| |Also, consider the lowercase, version of Property Number and Property Street entered on this screen, stripped of all |
| |whitespace. If they indicate a likely "TBD" address, then form validation fails with this error text in the standard|
| |font and location for error messages: "TBD addresses are not allowed." |
| | |
| |The loan is defined as likely to be a TBD address if any of the following is true |
| | |
| |Property Number = tbd |
| |Property Number = tobedetermined |
| |Property Number = to |
| |Property Street = tbd |
| |Property Street = tobedetermined |
| |Property Street = bedetermined |
|Cancel Button |Tab Order: 11 |
| | |
| |Control: Button |
| | |
| |Functional Description: When the User clicks this button, control is returned to the calling screen letting it know |
| |that the User cancelled. |
7 Product Finder Changes In Loan Context
1 Product Finder Search / Search Results Screen − Inside a Loan
Overview
This screen is changed to use the new Price Loan icon.
Also, when the User clicks this icon, the current process of showing the user a warning screen is removed and instead the Price Loan screen is directly displayed with the parameters entered in Product Finder combined with the parameters already in the loan in context. If any fields are missing and required to lock the loan, no error is displayed but instead
Entry Point
This screen can be entered by starting from a loan's Secondary Main screen, clicking the Product button.
1. If a the loan is already assigned a product, the resulting screen displays it at the top with a price loan icon (existing functionality).
2. The user can then enter search criteria or choose a product manually. In either case the search results screen is displayed with the results. Each resulting loan also has a Price Loan icon.
Security
This FD doesn't define new security for this screen.
Figure 3.7-1: Existing Screen Shot - Product Finder Search / Search Results - In Loan Context
[pic]
Table 3.7-1: Product Finder Search / Search Results Screen - Field And Control Details
|Product Finder Search / Search Results Screen − Field And Control Details |
|Price Loan |([pic] 1214 Product Finder Search Results − In Loan Context − defined when the user is returned to this screen vs. moved directly|
|Icon |to the price loan / pricing parameters screen after selecting a branch. See Price Loan Icon details, p. 44.) |
| |The Price Loan column displays already on this screen before the Price My Loan project both at the top of the search screen, and |
| |at the top and results of the search results screen. |
| | |
| |In this column, the Price Loan icon is replaced with the new icon defined in section 3.2, p. 7. |
| | |
| |When the User clicks this icon: |
| | |
| |If the loan does not have a branch assigned, the Select Branch Screen, p. 10 is displayed. If the user cancels out of that |
| |screen focus is returned to this screen and the Price Loan command is ignored. |
| | |
| |If the User selected a branch on that screen, and that branch has a margin for the selected product in the latest published rate |
| |sheet, this screen is not re-displayed. Instead, the logic labeled Start Pricing Process on p. 45 below is used to either |
| |display the Pricing Parameters screen or Price Loan screen directly. |
| | |
| |If the User selected a branch on that screen doesn't have a margin for the selected product in the last published rate sheet, the|
| |Pricing Error Screen, p. 53 is displayed showing the Missing Margin error. |
| | |
| |If the branch to be used to price the loan has a margin for the selected product in the last published rate sheet: |
| | |
| |Start Pricing Process |
| |If the Choose My Product radio button is selected on this screen, or the User is in search results after selecting Choose My |
| |Product, the Pricing Parameters Screen, p. 15, is loaded with values for all parameters defined in section 3.5.6.1 Fields Passed |
| |In, p. 31 coming from the loan in context (except possibly the branch which comes from the branch selected above if the loan |
| |doesn't have a branch already). |
| | |
| |If the Find My Product radio button is selected on this screen, or the User is in search results after selecting Find My Product,|
| |the Price Loan Screen p. 22, is loaded with values for all parameters defined in section 3.5.6.1 Fields Passed In, p. 31. The |
| |values are all as selected in the search criteria, using values from the loan in context if the value is not one specified in |
| |search criteria. |
| | |
| |([pic] 1214 Product Finder Search Results − Inside Loan Context − defined pricing parameter values to be used when a 2nd lien's |
| |Price Loan icon is clicked in the context of a simultaneous 1st / 2nd lien search. See Price Loan Icon details, p. 44.) |
| | |
| |Exception: If this is a 2nd lien product found only as a result of a simultaneous search, the values are passed in as defined in|
| |section 3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder, p. 50. |
| | |
| |The branch is as selected above, if the loan doesn't already have a branch assigned. For remaining parameters that aren’t |
| |displayed or implied by the search criteria screen, the loan data is used. |
2 Product Finder Compare Price Screen − Inside a Loan
Overview
This screen is changed to add a Price Loan column.
When the User clicks this icon, we pass values for all parameters as entered in the search criteria. Any parameters that aren't part of the search criteria are retrieved from the loan in context. This screen can't be reached by selecting Choose My Product so LT doesn't have to decide what parameters to send in that case.
Figure 3.7-2: Screen Shot From Product Finder Phase 2 - Compare Price Screen - In Loan Context
[pic]
Table 3.7-2: Compare Price Screen - Field and Control Details
|Compare Price Screen − Field And Control Details |
|Price Loan |The Price Loan column displays already on this screen before the Price My Loan project both at the top of the search screen, and|
|Icon |at the top and results of the search results screen. |
| | |
| |In this column, the Price Loan icon is replaced with the new icon defined in section 3.2, p. 7. |
| | |
| |When the User clicks this icon: |
| | |
| |If the branch assigned to the loan doesn't have a margin for the selected product in the last published rate sheet, the Pricing |
| |Error Screen, p. 53, is displayed with the Missing Margin error. |
| | |
| |If the branch to be used to price the loan has a margin for the selected product in the last published rate sheet: |
| | |
| | |
| |The Price Loan Screen p. 22, is loaded with values for all parameters defined in section 3.5.6.1 Fields Passed In, p. 31. The |
| |values are all as selected in the search criteria before arriving at this screen. For parameters that aren’t displayed or |
| |implied by the search criteria screen, the loan data is used. |
| | |
| |([pic] 1214 Product Finder Compare Price − Inside Loan Context − Search Criteria Entered − defined pricing parameter values to |
| |be used when a 2nd lien's Price Loan icon is clicked in the context of a simultaneous 1st / 2nd lien search. See Price Loan Icon|
| |details, p. 46 for details.) |
| | |
| |Exception: If this is a 2nd lien product found only as a result of a simultaneous search, the values are passed in as defined |
| |in section 3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder, p. 50. |
8 Loans Available For Online Lock Screen
Overview
This screen is changed to use the new icon and to use the new price loan logic, as detailed below
Figure 3.8-1: Existing Screen Shot - Loans Available For Online Lock
[pic]
The new Price Loan icon is displayed wherever the old Request Lock icon displays.
When the User clicks the Price Loan icon, the logic defined in section 3.5 New Online Lock / Express Lock Logic − In Loan Context, p. 13, is triggered.
9 Pipeline Report − Loan Level Results Screen
Overview
This screen is changed to use the new icon and to use the new price loan logic, as detailed below
Figure 3.9-1: Existing Screen Shot - Branch Pipeline Report - Loan Level Results
[pic]
The new Price Loan icon is displayed wherever the old Request Lock icon displays.
When the User clicks the Price Loan icon, the logic defined in section 3.5 New Online Lock / Express Lock Logic − In Loan Context, p. 13, is triggered.
10 Loan Level Changes
1 Secondary Main Screen
Overview
The Request Lock button is changed to use the new "parametrized" Price Loan screen, but error checking remains on this screen, except for error checking related to lock cutoff times.
Figure 3.10-1: Existing Screen Shot - Secondary Main - Lock Information Section
[pic]
Unlike most other entry points to price / lock a loan online, the Request Lock button keeps its current error-checking logic to make sure the required fields are present. This error checking logic is documented at the top of section 3.5 New Online Lock / Express Lock Logic − In Loan Context, p. 13.
However, the lock cutoff time error checking is not performed on this screen. Users are now allowed to see pricing on a loan after hours, although they can't lock it after hours (except for the existing exceptions for Hawaii branches and Pricing Analysts).
If that error checking logic passes, the Price Loan Screen, p. 22, is loaded with values for all parameters defined in section 3.5.6.1 Fields Passed In, p. 31. The values passed in are all based on the data from the loan in context.
2 Info Screens
Overview
All X Info screens (Loan Status Info, Pricing Info, Docs / Funding Info, Docs / Closing Info) are changed to use the new icon and to use the new price loan logic, as detailed below. One example screen is given here:
Figure 3.10-2: Existing Screen Shot - Loan Status Info Screen
[pic]
The new Price Loan icon is displayed wherever the old Request Lock icon displays.
When the User clicks the Price Loan icon, the logic defined in section 3.5 New Online Lock / Express Lock Logic − In Loan Context, p. 13, is triggered.
3 Confirm Lock Information Screen
Overview
This screen changes so that the View Online Pricing button passes loan parameters appropriately to the Request Lock screen which is now no longer called directly in the context of a loan.
Figure 3.10-3: Existing Screen Shot - Confirm Lock Information Screen - Pricing Reference Info Section
[pic]
The current behavior of this button is as follows (image taken from the Prepayment Automation FD at Designs/Prepayment Automation.doc)
Figure 3.10-4: Excerpt From Prepayment Automation FD
[pic]
This behavior is modified as follows:
When launching the "View Online Pricing Screen", this is really equivalent to launching the Price Loan screen. That still occurs, but since that screen now requires parameters to be passed into it, this screen passes all of the parameters defined in section 3.5.6.1 Fields Passed In, p. 31. The values are all taken from this screen, except for values that aren't displayed on this screen, which are taken from the existing loan data. If one or more fields is missing which is in the list of fields passed into the pricing engine, an error is displayed in the standard font and location for error messages.
11 General
([pic] 1215 Removed the Duplicate Loans For SSN section which is no longer used. No section of this FD checks for duplicate loans.)
1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder
([pic] 1214 Added section 3.11.1 Pricing Parameters For 2nd Liens In Simultaneous Search Within Product Finder, p. 50, with subsections Outside The Context Of A Loan, p. 51, and Inside The Context Of A Loan, p. 51.)
Outside The Context Of A Loan, p. 51
Inside The Context Of A Loan, p. 51
1 Outside The Context Of A Loan
When users click the Price Loan icon for a 2nd lien product after doing a simultaneous 1st and 2nd lien search in Product Finder outside the context of a loan, these are the values to be used when pricing the 2nd lien:
• FileID: null
• BranchID: branch automatically detected or manually selected by user in product finder.
• ProgramID: program represented in this row
• Lien Position: lien position of program represented in the price loan row the user clicked.
• Base Loan Amount: Subordinate Amt entered in 1st lien search
• Base Factor: null
• MI Plan Optn: Default MI Plan Optn value that would be saved to a loan by default when ProgramID above is assigned to a loan.
• Fico At Lock: Lowest Middle Fico entered in 1st lien search.
• Loan Purpose: Loan Purpose entered in 1st lien search.
• Refi Purpose: Refi Purpose entered in 1st lien search.
• Cash Out Amount: Cash Out Amount entered in first lien search.
• Purchase Amount: Purchase Price entered in first lien search.
• Appraised Value: Appraised Value entered in first lien search
• Doc Type: Doc Type entered in first lien search
• Property Type: Property Type entered in first lien search
• Owner Occupied: Value of "Owner Occupied" entered in first lien search.
• Ratio 2: Top value of the DTI range entered in the 2nd Lien Info of first lien search.
• Impounds: 0 (unchecked)
• Subordinate Amount: The Loan Amount entered in first lien search.
• ([pic] 1219 2nd lien product parameters passed in outside the context of a loan, section 3.11.1.1, p. 51 − added back the Has Temporary Buydown field.) Has Temporary Buydown? 1 if the selected product has Allow Buydown? Checked in Loan Product Details, else 0.
• Has HUD Repo? 0 (unchecked)
• Linked Loan Status: null
• Linked Loan FileID: null
• Product assigned to linked loan: null
• Linked Loan Lock Date: null
• Linked Loan Funded Date: null
• Non-FMFC Loan Info: null
• Branch Bonus: null
• Property Number: null
• Property Street: null
• Property City: null
• Property State: null
• Property Zip: null
2 Inside The Context Of A Loan
When users click the Price Loan icon for a 2nd lien product after doing a simultaneous 1st and 2nd lien search in Product Finder inside the context of a loan, these are the values to be used when pricing the 2nd lien:
• ([pic] 0118 Inside The Context Of A Loan, p. 51 − don't pass in the first lien's FileID. Instead, pass in null, which will cause a new loan to be created if the User prices and locks the second lien in this situation.)FileID: null
• BranchID: branch assigned to loan
• ProgramID: program represented in the Price Loan row the User clicked.
• Lien Position: lien position of program represented in the same row
• Base Loan Amount: Subordinate Amt entered in 1st lien search
• Base Factor: null
• MI Plan Optn: Default MI Plan Optn value that would be saved to a loan by default when ProgramID above is assigned to a loan.
• Fico At Lock: Lowest Middle Fico entered in 1st lien search.
• Loan Purpose: Loan Purpose entered in 1st lien search.
• Refi Purpose: Refi Purpose entered in 1st lien search.
• Cash Out Amount: Cash Out Amount entered in first lien search.
• Purchase Amount: Purchase Price entered in first lien search.
• Appraised Value: Appraised Value entered in first lien search
• Doc Type: Doc Type entered in first lien search
• Property Type: Property Type entered in first lien search
• Owner Occupied: Value of "Owner Occupied" entered in first lien search.
• Ratio 2: Top value of the DTI range entered in the 2nd Lien Info of first lien search.
• Impounds: 1 if loan's Impounds checkbox is checked, else 0.
• Subordinate Amount: The Loan Amount entered in first lien search.
• ([pic] 1219 2nd lien product parameters passed in, in the context of a loan, section 3.11.1.2, p. 51 − added back the Has Temporary Buydown field.) Has Temporary Buydown? Pass in 1 if the Buydown? Checkbox is checked, 0 if the Buydown? Checkbox is unchecked in the General Information section on Secondary Main for the loan in context.
• Has HUD Repo? 1 if HUD Repo checkbox checked on the loan, 0 otherwise.
• Linked Loan Status: equal to value selected for Linked Loan? for the loan in context.
• Linked Loan FileID: equal to the loan linked to the loan in context, if any. Else null.
• Product assigned to linked loan: equal to ProgramID of loan linked to loan in context, if any. Else null
• Linked Loan Lock Date: Lock date of loan linked to loan in context, if any. Else null.
• Linked Loan Funded Date: Funded date of loan linked to loan in context, if any. Else null.
• Non-FMFC Loan Info: value in Non-FMFC Loan Info dropdown of loan in context.
• Branch Bonus: value of Bonus field in the Secondary Main screen's Lock Information section of loan in context.
• Property Number: property number of loan in context
• Property Street: property street of loan in context
• Property City: property city of loan in context
• Property State: property state of loan in context
• Property Zip: property zip of loan in context.
2 General Screen Flow / Pricing Loan
([pic] 1215 Added section 3.11.2 General Screen Flow / Pricing Loan, p. 52 to show an overview of which entry points go to the Pricing Parameters screen vs. directly to the Price Loan screen.)
This section shows all the known entry points to pricing a loan. Its purpose is to show which ones go through the Price Loan screen vs. the Pricing Parameters screen based on the entry point and other context information:
Figure 3.11-1: Price Loan Entry Points
[pic]
3 Pricing Error Screen
([pic] 1221 Pricing Error Screen, p. 53 – defined a shared Pricing Error Screen to allow a shared code to be used when errors are detected when attempting to price a loan instead of maintaining code in multiple places. The User experience is not hurt by this functionality, while it saves on development time and maintenance costs.)
Overview
This screen is displayed inside or outside a loan when an error is detected while the user is trying to price a loan.
Entry Point
The entry points are all locations where the user can click a Price Loan icon.
Security
This screen doesn't have any security associated with it.
Figure 3.11-2: Example Picture - Price Loan Error Screen
[pic]
Table 3.11-1: Pricing Error Screen – Field And Control Details
|Pricing Error Screen − Field And Control Details |
|Screen Title |This screen's title is "Price Loan" |
|Top Of Screen Error |At the top of this screen, the following text is displayed in the standard font for errors: |
| | |
| |The loan can't be priced at this time. |
|Missing Product Error |If this screen was called in the context of a missing product, the following is displayed inside the screen: |
| | |
| |The loan does not have a product assigned. You can navigate to Product Finder to select a product and price a loan. |
| | |
| |When the User clicks the Product Finder hyperlink, the user is navigated to Product Finder in the context of this loan,|
| |as if the User had clicked the Product button on the Secondary Main screen or on the Pricing Info screen. The only |
| |difference is that if the loan in context does not have a branch assigned the branch selected in section 3.5.1 |
| |Selecting A Branch is passed into Product Finder so that the User doesn't have to re-specify the branch if they choose |
| |to Price Loan in that context. |
|Product Not Available |([pic] Pricing Error Screen − Product Not Available Online Error, p. 54, change "call or e-mail" to "contact".) |
|Online Error |If this screen was called with an error for product not available online, the following is displayed inside the screen:|
| | |
| |The selected program is not available to lock online. For pricing information please contact the Pricing Department. |
| |To lock this loan, please submit your request via fax to the Pricing Department. |
|Missing Margin Error |If this screen was called with an error for a missing margin, the same error text is displayed as in the "Product Not |
| |Available Online" case above. |
|Lock Request Pending |([pic] 0103 Lock Request Pending Error, p. 54, and Loan Is Locked Error directly below − added these two errors to the |
|Error |errors that can be displayed when a User tries to get pricing in the context of a loan.) |
| |If this screen was called with an error because the loan is lock request pending, the following is displayed inside the|
| |screen: |
| | |
| |A lock request for this loan is still pending. |
|Loan Is Locked Error |If this screen was called with an error because the loan is already locked, the following is displayed inside the |
| |screen: |
| | |
| |This loan is locked and can't be priced again. |
|OK Button |When the User clicks OK, the screen the User was on, which triggered the Price Loan process, is displayed again. |
12 Data Validations
([pic] 1219 New Data Validation for inconsistent loan vs. product buydown information. Section 3.12.1, p. 55.)
1 New Data Validation Rule: Inconsistent Buydown Information
Name (as displayed in the dropdown of rules in Data Validation Admin):
Temporary Buydown on Loan Inconsistent With Product
Logic:
If the loan's assigned product has its Allow Buydown? checkbox checked and the loan's Buydown checkbox as displayed in the General Information Section of Secondary Main is unchecked, fail with this error text: "This loan has a buydown product but the buydown is not applied on the loan. Are you sure you want to continue?"
If the loan's assigned product has Allow Buydown? unchecked and the loan's Buydown checkbox is checked, fail with this error text: "This loan has a product that doesn't allow Temporary Subsidy Buydowns but a buydown is applied on the loan. Are you sure you want to continue?".
For testing purposes, this event should be associated to the Express Lock event as a warning. That is the expected disposition for this data validation rule after we deploy, but this event / rule association will be performed manually when we deploy this project.
13 Scripts
No scripts are required by this functional design.
PRIVILEGES
1 Deleted Privileges
No privileges are deleted in this FD.
2 New / Existing Privileges
No privileges are created or used for new purposes on this screen.
OTHER CONSIDERATIONS / RED FLAGS
No known red flags.
APPENDIX
1 Existing Request Lock Icon Locations
The following LoanTracker locations display the existing Request Lock icon ([pic]):
1. The Product Finder screen displays a request lock icon to the right of the already-assigned product, when the User enters this screen from the context of a loan.
2. Product Finder search results in the context of a loan displays a request lock icon for each online lockable product in the results, whether the User searched by entering criteria or choosing their product from a list.
3. Product Finder screen seen in the context of a loan when the User clicks the Rate Sheet icon.
4. Compare Price screen in the context of a loan.
5. Loan Status Info
6. My 1003
7. Pricing Info
8. Docs / Funding Info
9. Docs / Closing Info[pic]
-----------------------
Clicking locç$è$ý$‘%?xo $[pic]If[pic]gdhë $[pic]If[pic]gdk~¯}kdÿc%$[pic]$[pic]If[pic][?]–lÖ[pic][pic][pic][pic][pic][pic]Ö0[?]”ÿ?ü$[?][?]tà[pic]ö[pic]6[pic]ööÖÿÿÖÿÿÖÿÿÖÿÿ4Ö[pic]4Ök now on an unregistered loan takes the User to the Register Loan Screen, p. 37.
New Price Loan column is displayed on this screen.
New column added to search results as rightmost column.
................
................
In order to avoid copyright disputes, this page is only a partial summary.
To fulfill the demand for quickly locating and searching documents.
It is intelligent file search solution for home and business.