> For the complete documentation index, see [llms.txt](https://docs.himaxwell.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.himaxwell.com/platform-overview/lender-hub/quickpricer/lender-concessions.md).

# Lender Concessions

### Lender Concessions Overview 

Maxwell’s Lender Concessions feature is available for Optimal Blue and Encompass lenders who want Loan Officers to request and share lender concessions directly within the Point of Sale.

With this feature, Loan Officers can:

* Calculate lender concessions within the POS
* Share concession discounts with borrowers in early stage pricing scenarios to highlight added value
* Submit concession requests from the POS to Optimal Blue for approval

#### **How to Enable**

If your organization would like to enable Lender Concessions, a POS admin should contact <help@himaxwell.com>.

Our Customer Success team will guide you through setup and confirm that your concession limits and approval settings are configured correctly in the POS.

{% hint style="info" %}
**Prerequisites for Lender Concessions:**&#x20;

* Encompass LOS connection with Rate Lock Enabled&#x20;
* Optimal Blue P\&PE integration with concession limits and approvals settings managed in OB.&#x20;
* QuickPricer feature enabled&#x20;
* A Credit Reporting integration enabled&#x20;
  {% endhint %}

### How it works&#x20;

#### Add a Concession&#x20;

To add a lender concession an LO will go through the following steps.&#x20;

1. From the **Lender Hub**, select the **QuickPricer** tab. This opens the **Search Products** page.
2. On the **Search Products** page, enter or update the required loan details and filters, then run the product search.

<figure><img src="/files/aTCUYIuGTKZKOdDP2Idt" alt=""><figcaption></figcaption></figure>

3. Review the product results. **Use the expand arrow to the left of product name** to view additional point and rate options, then select the points you want to present to the borrower.

<figure><img src="/files/f30LAWTffXKKFdmBUu9V" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/lLv3AcKpauoaD7DunlPa" alt=""><figcaption></figcaption></figure>

4. **Select up to three loan products** to compare and share with the borrower.
5. Click **Go to Loan Scenario** to view product details.
6. Scroll to the **Points** row and select **Add Concession**.

<figure><img src="/files/j1l7qFKg16DrdhJf0OAu" alt=""><figcaption></figcaption></figure>

6. In the *Add Concession* pop-up, enter either **concession points, a dollar amount, or the desired points**. Entering a value in any field automatically calculates the other fields.
7. Review any warnings related to auto-approval limits or maximum concession limits.
8. Save the concession.
9. Update any additional pricing details as needed, such as Housing Expenses, MI, or Fees.
10. To share pricing, click **Send to Borrower** in the upper right corner. This sends a notification prompting the borrower to review pricing. You can edit the message and preview it before sending, as shown in the video below.

<figure><img src="/files/1X6UFL8S7NIkk4oBAizV" alt=""><figcaption></figcaption></figure>

#### Request Rate Lock Approval w/ Concession&#x20;

<figure><img src="/files/nqw7gBOjlIPS47IA0VeN" alt=""><figcaption></figcaption></figure>

12. From the **Manage** dropdown, click **Select** on the desired product.
13. After selecting the product, the **Rate Lock** option becomes available in the **Manage** dropdown. Click **Rate Lock**.
14. In the *Request Rate Lock* pop-up, review the product and concession details. Enter the **Price Concession Reason** and any required comments.
15. Select **Request Lock w/ Concession**.

This action sends the product pricing details to Encompass and then to Optimal Blue. It initiates both the rate lock and lender concession request in Optimal Blue. Once the data is successfully transmitted, the **Loan Scenarios** screen updates to display **Lock Pending** and **Concession Pending** statuses.

Your organization will then follow its standard Optimal Blue approval process.

* For automatic approvals, the request proceeds based on your configured settings.
* For manual approvals, designated approvers are notified in Optimal Blue to review the rate lock and concession request.

16. After approvals are completed in OB we Maxwell will receive the approval decisions and display them to the LO on the file. There are three statuses we will return&#x20;

    1. **Lock & Concession Pending -** This means its sent to OB but has not completed the approval process
    2. **Rate Locked, Concession Approved -** This means it has completed all approvals in OB and the loan is locked.&#x20;
    3. **Lock Rejected, Concession Rejected or Pending -** This means the approver has rejected the lock or concession.&#x20;
    4. **Lock Cancelled -** This means the lock request was cancelled in OB.&#x20;

{% hint style="warning" %}

#### **IMPORTANT NOTE:**

Once a rate lock request has been submitted to Optimal Blue for approval, pricing can no longer be edited in the Point of Sale.

At that stage, pricing is controlled by Encompass and Optimal Blue. The POS cannot update or modify pricing data in either system.

* If a product is **Rate Locked**, the selected product becomes frozen and read-only in the POS.
* If a rate lock request is **Rejected** or **Cancelled**, the selected product also becomes frozen and read-only in the POS.

#### Revising a Locked Loan

To revise pricing after a rate lock request, lenders have two options:

1. Update pricing directly in Encompass or Optimal Blue for the connected loan file.
2. Duplicate the loan application in the POS and repeat the pricing and rate lock process. This creates a new Encompass Loan ID.
   {% endhint %}

### Integration Details&#x20;

Maxwell’s Lender Concessions feature uses each Loan Officer’s Optimal Blue credentials and settings.

Loan Officers will see the same product options, concession limits, and approval rules in the Maxwell POS that they have in Optimal Blue.&#x20;

#### Product Search and Points Settings&#x20;

When a Loan Officer searches for products, the results reflect the products they are authorized to access in Optimal Blue, including the point limit settings configured by your organization.

<figure><img src="/files/FP0v975lRZej25w4OZwO" alt=""><figcaption></figcaption></figure>

#### Lender Concessions Limits

Maxwell honors the auto-approval and manager approval concession limits configured in Optimal Blue.

If a concession exceeds the Loan Officer’s individual limit, the POS displays a notification indicating that manager review is required.

When the Loan Officer submits a **Request Lock w/ Concession**, the request follows the existing manager approval workflow configured in Optimal Blue.

<figure><img src="/files/nYl3PMJL2WgUX5pqv1YG" alt=""><figcaption></figcaption></figure>

**Auto-Approval Limits**&#x20;

If the concession is within the Loan Officer’s automatic approval limit, no warning is displayed.

The Loan Officer must still enter a concession reason to submit the concession request as that is a required field in OB.&#x20;

<figure><img src="/files/bNeadhHfymlSeWBI3DJV" alt=""><figcaption></figcaption></figure>

**Manager Approval Limits**&#x20;

If a Loan Officer enters a concession that exceeds their automatic approval limit, the POS displays a manager approval warning.

The Loan Officer can still proceed, but must provide an approval request reason and supporting details when submitting the rate lock request.

<figure><img src="/files/ixQ8282o9S0vu434rdOd" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/zFOJdzO3jn2BXn9GHLHg" alt=""><figcaption></figcaption></figure>

**Exceeding Request Limits**&#x20;

If a Loan Officer enters a concession amount that exceeds the manager or organizational approval limit, the POS displays an error notification that it exceeds the Max concession amount.&#x20;

The Loan Officer cannot save the concession until the amount is adjusted to fall within the allowed limit.

<figure><img src="/files/idhPF0ggZ7bpUXM746DE" alt=""><figcaption></figcaption></figure>

### &#x20;Questions&#x20;

If you have any other questions please reach out to <help@himaxwell.com> or your customer success manager.&#x20;