Encompass Integration - Analyze

Once integrated for Classify and Capture a client will be able to work with Ocrolus to generate gross monthly income data off all captured forms for traditionally employed borrower and co-borrowers

Classification and Capture as a Prerequisite

The Calculate Encompass integration requires a Classify and Capture workflow to be in existence prior to a Calculate integration. Ocrolus Income calculations leverage Capture data as inputs and re-index a pdf of each income calculation generated for each traditional place of employment for the borrower and coborrower on the loan.

Standard Income Calculator

Ocrolus leverages the industry standard Income Calculations to obtain chosen income options for an underwriter to leverage. Ocrolus currently supports only traditional employment income calculations. For information on self-employed borrower, co-borrower income support or alternative income calculations, please reach out to Ocrolus customer support.

Ocrolus Income Calculator Custom Form

Ocrolus provides a custom form to clients to view, interact and select income data for the current place of employment for a borrower or co-borrower. When an income is selected, it can be written to Section 1b of the 1003 URLA 2020. The data fields in the Ocrolus Income Calculator are read only.

Information on how to install the custom form can be found [here].

Custom Form Section 1- Header Information

An underwriter can select from the header of the custom form whose current income calculation to view. The custom form supports a display for the borrower and co-borrower of a loan

SectionField NameField TypeDecription
Header InformationBorrower/Co-Borrower nameStringName of the entities applying for the loan
Header InformationEmployerStringName of the employer from which pay data was captured and calculated from
Header InformationLoan IDStringCurrent Loan ID
Header InformationDateDateDate on which calculate data was pushed or refreshed
Header InformationIncome To QualityMoneyAmount required for entities to qualify for the loan.

Custom Form Section 2 - Hourly Income

If the borrower selected is determined to be paid hourly at his/her current place of employment this section will be populated with data. A list of fields available can be found below:

Field NameField TypeInteractionDescription
$ per hourMoneyRead Only
# hours worked per weekTextRead Only
Monthly Income (from per hour income)MoneyRead Only
YTD EarningsMoneyRead Only
# of MonthsTextRead Only
Monthly Income (from YTD avg.)MoneyRead Only
W2 EarningsMoneyRead Only
Tax YearTextRead Only
Monthy Income (From first W2 income)MoneyRead Only
W2 EarningsMoneyRead Only
Tax YearTextRead Only
Monthly Income (From second W2 income)MoneyRead Only
Per Hour IncomeMoneySelectableChosen if user prefers to use this calculation as chosen income
YTD avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 1 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 2 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
Do Not Use IncomeMoneySelectableChosen if no selectable options will be used for income
Chosen IncomeMoneyCopyableDisplays the selected income that will be written to the 1003

Custom Form Section 3 - Salary Income

If the entity selected is determined to be paid a salary at his/her the current place of employment this section will be populated with data.

Field NameField TypeInteractionDescription
Monthly IncomeMoneySelectable
Monthly EarningsMoneyRead Only
Monthly Income (2)MoneySelectable
Bi Weekly EarningsMoneyRead Only
Monthly Income (3)MoneySelectableChosen if user prefers to use this calculation as chosen income
Semi Monthly IncomeMoneyRead Only
Monthly Income (4)MoneySelectable
Weekly EarningsMoneyRead Only
Monthly Income (5)MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD Salary (paystub)MoneyRead Only
# of monthsStringRead Only
Monthly Income (6)MoneySelectableChosen if user prefers to use this calculation as chosen income
W2 EarningsMoneyRead Only
Tax YearStringRead Only
Monthly Income (7)MoneySelectableChosen if user prefers to use this calculation as chosen income
W2 Earnings (2)MoneyRead Only
Tax Year (2)StringRead Only
Do not use incomeMoneySelectableChosen if user prefers to use this calculation as chosen income
Chosen IncomeMoneyCopyableDisplays the selected income that will be written to the 1003

Custom Form Section 4 - Overtime Income

If Ocrolus Capture data has identified overtime income on a borrower or co-borrower's available paystubs this section will contain data from the Income Calculator

Field NameField TypeInteractionDescription
YTD earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Past Year earningsMoneyRead Only
# of monthsStringRead Only
Monthly IncomeMoneyRead Only
YTD avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 1 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 2 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
Do not use incomeMoneySelectableChosen if user prefers to use this calculation as chosen income
Chosen incomeMoneyCopyableDisplays the selected income that will be written to the 1003

Custom Form Section 5 - Bonus Income

If Ocrolus Capture data has identified bonus income on a borrower or co-borrower's available paystubs this section will contain data from the Income Calculator

Field NameField TypeInteractionDescription
YTD earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Past Year earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Additional year earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
YTD avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 1 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 2 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
Do not use incomeMoneySelectableChosen if user prefers to use this calculation as chosen income
Chosen incomeMoneyCopyableDisplays the selected income that will be written to the 1003

Custom Form Section 6 - Commission Income

If Ocrolus Capture data has identified commission income on a borrower or co-borrower's available paystubs this section will contain data from the Income Calculator

Field NameField TypeInteractionDescription
YTD earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Past Year earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Additional year earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
YTD avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 1 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 2 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
Do not use incomeMoneySelectableChosen if user prefers to use this calculation as chosen income
Chosen incomeMoneyCopyableDisplays the selected income that will be written to the 1003

Custom Form Section 7 - Other Income

If Ocrolus Capture data has identified an additional type of income on a borrower or co-borrower's available paystubs this section will contain data from the Income Calculator

Field NameField TypeInteractionDescription
YTD earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Past Year earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
Additional year earningsMoneyRead Only
# of monthsStringRead Only
Monthly incomeMoneyRead Only
YTD avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 1 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
YTD + 2 year W2 avg.MoneySelectableChosen if user prefers to use this calculation as chosen income
Do not use incomeMoneySelectableChosen if user prefers to use this calculation as chosen income
Chosen incomeMoneyCopyableDisplays the selected income that will be written to the 1003

Custom Form Section 8 - Military Entitlements Income

If Ocrolus Capture identifies that the borrower or co-borrower is active duty military then the Military entitlement income will be displayed in an itemized list.

Field NameField TypeInteractionDescription
Military Base PayMoneyRead Only
Military Combat PayMoneyRead Only
Military Flight PayMoneyRead Only
Military Hazard PayMoneyRead Only
Military Overseas PayMoneyRead Only
Military Prop PayMoneyRead Only
Clothing AllowanceMoneyRead Only
Rations AllowanceMoneyRead Only
Variable Housing AllowanceMoneyRead Only
Quarters AllowanceMoneyRead Only
Other AllowanceMoneyRead Only
Other Allowance (Description)StringRead Only
Total Military EntitlementsMoneyCopyableDisplays the selected income that will be written to the 1003

Write to 1003 Mappings - Sections 1 through 7

The below chart displays the location of where each piece of data will be copied to in the 1003 URLA 2020 when the "Write to 1003" button is selected for the first seven sections of the Income Calculator. These entries map to the first entry for Verification of Employment.

Calculator Field Name2020 URLA SectionField Code
Hourly Income Chosen IncomeSection 1b. Current/Self Employment and Income Gross Monthly IncomeBE0199 - for Borrower CE0199 - for Co-Borrower
Salary Income Chosen IncomeSection 1b. Current/Self Employment and Income Gross Monthly IncomeBE0199 - for Borrower CE0199 - for Co-Borrower
Overtime Income Chosen IncomeSection 1b. Current/Self Employment and Income Gross Monthly IncomeBE0120 - for Borrower CE0120 - for Co-Borrower
Bonus Income Chosen IncomeSection 1b. Current/Self Employment and Income Gross Monthly IncomeBE0121 - for Borrower CE0121 - for Co-Borrower
Commission Income Chosen IncomeSection 1b. Current/Self Employment and Income Gross Monthly IncomeBE0122 - for Borrower CE0122 - for Co-Borrower
Other Income Chosen IncomeSection 1b. Current/Self Employment and Income Gross Monthly IncomeBE0123 - for Borrower CE0123 - for Co-Borrower

Write to 1003 - Section 8, Military Entitlement

The below chart displays the location of where each piece of data will be copied to in the 1003 URLA 2020 when the "Write to 1003" button is selected for the Military Entitlement Income. These entries map to the first entry for Verification of Employment.

Field Name2020 URLA Field Code
Military Base PayBE0119 - for Borrower CE0119 - for Co-Borrower
Military Combat PayBE0177 - for Borrower CE0177 - for Co-Borrower
Military Flight PayBE0165 - for Borrower CE0165 - for Co-Borrower
Military Hazard PayBE0166 - for Borrower CE0166 - for Co-Borrower
Military Overseas PayBE0167 - for Borrower CE0167 - for Co-Borrower
Military Prop PayBE0168 - for Borrower CE0168 - for Co-Borrower
Clothing AllowanceBE0169 - for Borrower CE0169 - for Co-Borrower
Rations AllowanceBE0170 - for Borrower CE0170 - for Co-Borrower
Variable Housing AllowanceBE0171 - for Borrower CE0171 - for Co-Borrower
Quarters AllowanceBE0172 - for Borrower CE0172 - for Co-Borrower
Other AllowanceBE0174 - for Borrower CE0174 - for Co-Borrower
Total Military EntitlementsN/A

Income Calculation Indexed to eFolder

In addition to the interactive custom form Ocrolus will also index a PDF of the income calculations generates for all places of employment for a borrower and co-borrower. Below detail the format of the attachment indexing

Document NameUniqueness ValuesSample Attachment Name
Income calculationsBorrower or Co-Borrower Name Employer Time StampIncome Calculation-John Doe-Corporation ABV - 2021-05-12 16:32.pdf

The income calculations indexed to the eFolder will also display a list of the W2 and Paystub attachments that were leveraged in the calculations.

^ Above will be an embedded version of a sample Income Calculation

Updating Income Data

Ocrolus will update the Calculate data for the borrower and coborrower each time new paystubs and W2s are identified and verified by the Classify and Capture processes. Updated data for the current place of employment for the borrower or co-borrower will automatically update the Calculate Custom Form. An updated Income Calculation pdf will also be indexed to the loan eFolder.

Getting a sample .empkg file

Please contact your implementation associate for the relevant .empkg file.


See also

For more information of Ocrolus' Genworth income calculator please view the Genworth Calculation API documentation here.