Classify
Ocrolus utilizes Classify capabilities to intelligently sort and index mortgage application documents in the Encompass eFolder. Once your Ocrolus API user is configured, you can enable Classify by configuring your eFolders as follows:
Standard document containers
We use a handful of predefined containers that represent specific stages in our document processing pipeline. To use Classify, ensure that your Encompass instance has the following document containers:
The above screenshot shows a list of document containers in an Encompass instance, with several utilized by Ocrolus. The containers labeled Duplicate Attachments, Ocrolus Processing Complete, Ocrolus Processing, Processing Required, and UNKNOWN are emphasized with red arrows to highlight their significance.
The containers are used as follows:
Document Name | Usage |
---|---|
Processing Required | We monitor this container for new documents to process. |
Processing | Documents are moved here from Processing Required once we retrieve and start processing them. |
Processing Completed | Documents are moved here once we process them successfully. |
UNKNOWN | Individual pages of documents from Processing are moved here if they're not of a supported form type. |
Duplicate Attachment | We move duplicate copies of files within Processing Required into this container to prevent data duplication. |
When setting up the document containers, make sure that the Webcenter, TPO Portal, and EDM Lenders boxes are checked for each of the above containers, as shown below:
Need different names?
The aforementioned container names represent the most common use cases. However, if you need them to be named differently then contact customer support and we can work with you to find a solution.
You can access the file that was originally uploaded at any time, regardless of its location.
The Processing Required
document container
Processing Required
document containerEnsure that your Encompass instance defines an eFolder named "Processing Required," as shown below:
We automatically retrieve and process any attachments that are added to the "Processing Required" eFolder.
eFolder process
Ocrolus listens for changes in the eFolder. When a change occurs in the “Processing Required” document container, and the change meets the webhook criteria, the following workflow occurs:
- Ocrolus receives a webhook notification for the new attachment in the "Processing Required" document container.
- Ocrolus fetches the attachment and ingests it into the Ocrolus system for processing. If the loan is unlocked, the attachment moves to the "Processing" document container.
- When Ocrolus results are ready, the original attachment moves into the "Processing Complete" document container. The attachment segments are put into the document container appropriate to their classification.
When are attachments uploaded?
The workflow is asynchronous. There is no limit to the number of attachments that can be in the Processing Required document container. The attachments can upload to the container at any time.
Self-service taxonomy mapping tool: eFolder Mapping
The self-service taxonomy mapping tool within the Ocrolus Dashboard allows mortgage lenders to manage document mapping for the Encompass integration independently using the Classify feature, making the process more efficient and flexible.
You can use this tool during the implementation phase to set up your organization's initial document routing to the desired eFolder locations. As new form types are introduced, you can easily assign them to your preferred eFolder location without needing to contact an Ocrolus team member.
If a new form type is added to a category with parent-level mapping, it will automatically follow the parent’s mapping. Otherwise, it will be marked as Unmapped.
Notes
- An Encompass Admin will need to request a login from their Account Manager to access the Dashboard and configure the taxonomy mapping.
- We are committed to continually improving our products and services. If you have any questions or feedback, please contact our support team at [email protected].
To access the self-service taxonomy mapping tool for Encompass, perform the following steps:
-
Log in to the Ocrolus Dashboard.
-
Go to the new Encompass Mapping option on the Account settings menu.
-
A list of form categories organized for your convenience will appear. Under each category, you’ll find the available forms for that bundle.
-
You can either group all documents within a specific form category into a single eFolder location or take a more detailed approach by mapping each form type within the category to its own designated eFolder location.
-
To update the mapping for an entire category, select Click to add mapping on the parent header row.
Note
Keep in mind that changing the form category will override any granular mapping within that category.
-
To map on an individual document level, click on the ellipses menu to the right of the row and click Edit.
-
If you want the document-level mapping to be updated to the parent-level mapping, select the Reset to default option. A confirmation pop-up will appear. Click RESET.
Accessing Ocrolus Dashboard through Encompass Smartclient
After receiving notification from Ocrolus that your documents have completed processing, it is time to examine the results in the Ocrolus dashboard.
Additional services
From the Encompass loan application, navigate to the Services tab and then click on Order Additional Services.
Now, from the list of My Providers, select Ocrolus and click Submit.
Accessing Ocrolus product from the Encompass web application
To get to the Ocrolus Product from the Encompass Web Application, perform the following steps:
-
Select a loan that has been prepared for Ocrolus Processing, indicated by an Ocrolus Processing Required eFolder container.
-
Go to Services and select All Services from the left-side panel.
-
If you have not yet ordered a service from Ocrolus, click Order Service in the top right portion of the page.
-
If you have configured the product properly, you will see the Ocrolus product available under the Additional Services. Select Ocrolus and click Next to get started.
Alternatively, if you have already initiated an order to Ocrolus, you will find an order that you can reopen by clicking the new window button located on the right side of the order listing.
Navigating the Ocrolus Dashboard
Reviewing classification results
Once you are logged into the Ocrolus Dashboard, you can review the classification results of all forms.
Document status
The following are the statuses for a document in the classification summary:
Status | Description |
---|---|
Processing | Documents labeled as Processing are still undergoing classification by Ocrolus and have not been classified yet. They will be displayed with a loading animation to indicate that the process is still ongoing. You can preview the original forms even though they are still in the processing phase by clicking on the form. |
Rejected | Documents labeled as Rejected were not processed successfully by Ocrolus. This might be due to unsupported document file formats or sizes, illegible content, or other related issues. |
Classified | Documents labeled as Unknown are unable to be classified by Ocrolus because the document (or certain pages in the documents) is not a supported form type. |
Unknown | All other forms that have not been rejected or are no longer in the processing stage will have a form-type classification and are available for review. |
Document detail
When you expand on the document type dropdown, each row will include specific details pertaining to the individual form.
Document name
The individual document name will mirror the PDF's attachment name. We utilize a combination of uniqueness values and form-type descriptions to label the document. This name will also be reflected as the attachment in the eFolder once the document is processed.
Document Uniqueness Values (UVs)
Some documents will contain Uniqueness Values, which are utilized to distinguish the form from other forms of the same type in the Book. These values are distinct from the form in the preview.
For example, the Bank Statement UVs will have the following values:
- Account Holder
- Bank Name
- Account Number
- Account Type
- Period Start Date
- Period End Date
Sync status
The Sync Status indicates whether the document has been synchronized back to the Encompass eFolder. Documents currently being imported into the eFolder will be denoted by an animation and a Syncing status.
Sorting and grouping
There are multiple ways to sort and group the classified documents in the Dashboard. These features are to better assist with file management and review.
Option | Description |
---|---|
Group By Type | Group documents based on their document type distinction (i.e. Bank Statement, W2, Paystub). |
Group By Upload Date | Group documents by the date and time they were uploaded to Ocrolus. |
Group By Sync Status | Group documents based on the sync status with Encompass. |
Sort Alphabetically | Sort documents in ascending or descending alphabetical order. |
Search
The search function grants customers the ability to search for documents containing keywords. Keywords could be present in the document name, the document type, or the uniqueness values that were extracted.
Pushing documents into eFolder
Once the results are available in the Ocrolus Dashboard, the Ocrolus API will automatically push the documents back into the eFolder.
Push to Encompass
The Ocrolus API user - configured during the Organization setup steps mentioned above in this guide - will obtain a unique lock on the loan to push documents back into the eFolder. This means that there can be no other active user in the loan file as Ocrolus attempts to place the files back into the Encompass loan, in their designated documents.
If a User is in the loan file at the time of import, Ocrolus will attempt to retry 5 minutes later and will continue this retry process in increasing increments until it is successful.
When loan locks occur
Ocrolus only applies a loan lock on a loan when:
- Uploading attachments to the Ocrolus system.
- When the classification results are pushed back to the Encompass system.
If Ocrolus encounters a loan lock when uploading attachments or pushing results, the system will attempt to upload/push data back at a regular cadence until the loan is unlocked.
The document names are configurable. If you need to customize a document container, contact Ocrolus customer support.
Email notification (optional)
There is an optional email that notifies the current milestone users that Classification is completed by Ocrolus and results are available to review in the eFolder and via the dashboard.
Email trigger
The email will be triggered by the book.classified
event, which is when all of the pages within the book have been successfully classified.
Email recipients
The email will be sent to the current milestone users of Encompass. These users can be identified by navigating to the milestone in the Encompass Log and noting the associated personas.
Email content
Each email notification will appear identical and come from the same email address i.e., [email protected]
. The email subject line and body will contain the Encompass loan application number for easy reference. This email will notify the relevant milestone associates that documents have been classified and are available for review via the Ocrolus dashboard.
Retry policies
Ocrolus APIs interaction with Encompass adheres to an exponential retry policy. After the sixth retry, an Ocrolus Customer Success team member will reach out to your company's point of contact to raise the issue.
Attachment ingestion
When a loan is locked by a user in Encompass, Ocrolus will be unable to ingest any attachments that do not meet the criteria for upload. When this occurs Ocrolus will attempt to enter the loan again as per the below retry policy.
Retry Attempt | Duration |
---|---|
First | 10 minutes after the first attempt |
Second | 20 minutes after the first attempt |
Third | 40 minutes after the first attempt |
Fourth | 80 minutes after the first attempt |
Fifth | 160 minutes after the first attempt |
Sixth | 320 minutes after the first attempt |
Attachment reindexing and Capture
In the event that Ocrolus has completed classifying and capturing data from an attachment or a set of attachments and cannot access the loan because it is locked, Ocrolus will attempt to reenter the loan again as per the below retry policy.
Retry Attempt | Duration |
---|---|
First | 1 hour after the first attempt |
Second | 2 hours after the first attempt |
Third | 4 hours after the first attempt |
Fourth | 8 hours after the first attempt |
Fifth | 16 hours after the first attempt |
Sixth | 32 hours after the first attempt |
Updated 1 day ago