Fannie Mae income calculator integration
The Fannie Mae Income Calculator integration enables rep-and-warranty-backed income calculations for self-employed and rental borrowers directly from Ocrolus. The integration automates the process from document ingestion to Encompass export, minimizing manual work and reducing repurchase risk for lenders.
With this integration, Ocrolus delivers GSE-backed accuracy that enhances trust in income results, automates workflows to reduce manual entry and rework, and supports scalable, compliant underwriting for enterprise lenders.
Info
This integration is currently applicable only for self-employed income types. Support for the rental income type will be introduced in future updates.
Key capabilities
-
Automated data submission: Required fields for self-employed and rental income borrowers are automatically submitted to the Fannie Mae Calculator after field extraction. The system validates the completeness of all required fields before submission.
-
Recommended income display: The calculated income appears as a dedicated section in Analyze with a Fannie Mae Recommended label. Inline alerts from Fannie Mae are displayed for transparency and review.
-
Intelligent input collection: Missing non-documented fields are flagged, guiding users to complete them through the dashboard or Encompass prefill. Submissions are blocked until all required data is present.
-
Income override warning: When users manually override Fannie Mae-calculated income, a warning modal clearly states the rep-and-warranty forfeiture before confirming changes.
-
Re-run income calculations: Users can easily resubmit income to Fannie Mae when supporting documents are updated. The system maintains the same Case File ID, tracks submission history, and supports versioning for compliance.
-
Export to Encompass: Fannie Mae income can be exported directly to borrower income fields, and the Case File ID is pushed to the Fannie Mae screen in Encompass for downstream auditability.
Supported business structures
The integration supports the following business structures:
Self-employed
- Sole Proprietor
- Partnership
- S-Corp
- C-Corp
The Sole Proprietor screen is unique, while other business structures share the same layout except for the left-hand panel, where forms and schedules differ based on the business type.

Note
We are currently working on displaying the alerts and adding additional requirements for each business structure (as provided by Fannie Mae on July 2025) in line with the new design.
Fannie Mae required fields
When you click Configuration, a pop-up is displayed that allows you to view and edit the required fields based on your needs.


Downloading the Fannie Mae income ZIP
You can download the Fannie Mae income in ZIP format from the same location where the income PDF is usually downloaded. To download the ZIP, click the Export dropdown menu and select the ZIP beside Income data. A ZIP file will be downloaded to your local.

Updated 1 day ago