> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/retail-lending/implementation-guide.md).

# Implementation Guide

Plan and run a Retail LOS implementation in order, from foundation to go-live and beyond.

Use this guide to take Retail LOS from lending strategy to day-to-day governance. It follows the order an FI usually works in. Each phase names who owns it, what done looks like, and where to read and what to do.

{% hint style="info" %}
[Start Here](https://docs.uptiq.ai/retail-lending/start-here.md) helps you find a page. [User Journeys](https://docs.uptiq.ai/retail-lending/user-journeys.md) show what each audience experiences. This guide shows what to do, and in what order, to launch and run Retail LOS.
{% endhint %}

### The phases at a glance

| Phase                              | Owner                                        | Start with                                                              |
| ---------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------- |
| 1. Set the lending foundation      | FI Administrator, with credit and compliance | [Overview](https://docs.uptiq.ai/retail-lending/retail-los-overview.md) |
| 2. Design the product portfolio    | FI Administrator, with credit                | [Create a Product](broken://pages/opN1TXIhdJnuYiD71MWP)                 |
| 3. Originate applications          | FI Administrator                             | [Build an Application Flow](broken://pages/n1SdyLUnQZgbkOYajm7c)        |
| 4. Assess risk and make offers     | FI Administrator, with credit                | [Publish the Decision Matrix](broken://pages/n5eU7xEVylTz025Fvnzy)      |
| 5. Fulfil and manage applications  | In Branch Experience and FI Administrator    | [Work an Application](broken://pages/lvXMbbnbRDUhZZqPPeJE)              |
| 6. Govern and integrate Retail LOS | FI Administrator and System Admins           | [System Admins](broken://pages/tPhp4RnFQSBtay14oill)                    |
| 7. Test, go live and improve       | FI Administrator, with credit and compliance | [Test Before Go-Live](broken://pages/SaOPfYcafTO6mGboNYJl)              |

### 1. Set the lending foundation

Establish shared context for your Retail LOS implementation. Confirm the Retail LOS model, available products and common terminology before configuration starts.

**Done when** your team shares one view of what Retail LOS is, which sample products exist and the terms it uses.

* [Overview](https://docs.uptiq.ai/retail-lending/retail-los-overview.md): what Retail LOS is and who uses it.
* [Sample Products](https://docs.uptiq.ai/retail-lending/sample-products.md): the example products that show how a configuration fits together.
* [Foundation: Key Concepts](broken://pages/VvAIBGMkKvOEbqSLjdvS): the layers and terms every configuration step uses.
* [Glossary](https://docs.uptiq.ai/retail-lending/glossary.md): definitions, when a term needs clarifying.

### 2. Design the product portfolio

Turn lending policy and commercial requirements into configurable products. Select the right product model, complete the configuration and validate it before launch.

**Done when** each product has its type, category and core terms, and stays **Inactive** until it is ready.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-4f6eb33a86f7961a8c3428f99b6fd257866a2f25%2Fuptiq-retail-los__product-configuration__products-list.png?alt=media" alt="Products tab in Product Configuration"><figcaption></figcaption></figure>

#### Configure it yourself

1. Open **Product Configuration** and select **New Product**.
2. Enter the **Product Name** and **Product Code**, and select the **Product Type** and **Category**.
3. Set **Status** to **Inactive** so applicants cannot see the product while you build it.
4. Enter the terms that apply, then select **Create**.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-ffac9986b8be768c15c4dc4adcdf113a95c628ca%2Fuptiq-retail-los__product-configuration__new-product.png?alt=media" alt="New Product dialog"><figcaption></figcaption></figure>

See [Create a Product](broken://pages/opN1TXIhdJnuYiD71MWP) for the other ways to create a product.

* [Product Configuration](broken://pages/h1BRHsVc3cwuzs0gW1IM): what the module covers and how its parts connect.
* [Product Settings](broken://pages/Kw4nVkT343872n04UwP2): the settings and tabs on a product.
* [Decide the Product Type](broken://pages/pUWg5cwsueJfptR9K75P) and [Ways to Create a Product](broken://pages/lyRRUoyPEbh52PzRRGZq).
* **Guides:** [Create a Product](broken://pages/opN1TXIhdJnuYiD71MWP) and [Edit a Product's Details](broken://pages/PTjokj0RtdZloVebVwWv).
* **If you're stuck:** [Product Configuration troubleshooting](https://docs.uptiq.ai/retail-lending/help-center/troubleshooting/product-configuration.md).

### 3. Originate applications

Create a clear path from product selection to a submitted application. Design the applicant journey, then build, test and publish the supporting experience.

**Done when** an applicant can complete the flow for each **Active** product and submit.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-eea618a76d51a95682d63c8211fbae95fa594ce8%2Fuptiq-retail-los__product-configuration__flow-designer-flows.png?alt=media" alt="Flow Designer Flows tab"><figcaption></figcaption></figure>

#### Configure it yourself

1. Open **Product Configuration** and select **Flow Designer**.
2. Select **Add step** and set the **Step Name**, **Description**, **Icon** and **Step Type**. Select **Save Changes**.
3. Select **Add Sub Step** to add a page within the step, then add the sections the page needs.
4. Publish the flow. Applicants cannot load the application form without a published flow.

See [Build an Application Flow](broken://pages/n1SdyLUnQZgbkOYajm7c) for each step in detail.

* [User Journeys](https://docs.uptiq.ai/retail-lending/user-journeys.md) and the [Applicant Journey](https://docs.uptiq.ai/retail-lending/user-journeys/applicant-journey.md): what the applicant goes through.
* [Building Applications](broken://pages/AHrYhOpoy0ldcUiuUa0S): the flow, its steps and its screens.
* [Starting an Application](broken://pages/802GfCWuEgm8kc5qwK7F): how an application begins.
* **Guides:** [Build an Application Flow](broken://pages/n1SdyLUnQZgbkOYajm7c) and [Set Up Documents and Eligibility](broken://pages/R3cqZGDPblK7WmHQ88Fl).

### 4. Assess risk and make offers

Apply lending policy consistently at scale. Configure decision logic, pricing, offers and routing so each application receives the appropriate outcome.

**Done when** the decision matrix or scorecard is published, approval authority is set, and the workflow is published and tested.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-b4772015c860c4b572eddd120ae0685fdeb3a3db%2Fuptiq-retail-los__product-configuration__credit-decision-matrix.png?alt=media" alt="Credit Decision Matrix"><figcaption></figcaption></figure>

#### Configure it yourself

1. Open the product and select its **Credit Decision Matrix**. Make your changes in the draft.
2. In the **Matrix Flight Simulator**, enter applicant values and select **Run Simulation** to check the outcome. It does not write data.
3. Select **Save Draft**, then open **Diff** and check every changed parameter.
4. Select **Publish**.
5. In **Official Policy Release**, record the business reason in the justification note. It must contain at least five characters.

See [Publish the Decision Matrix](broken://pages/n5eU7xEVylTz025Fvnzy).

* [Decisions, Pricing, Offers](broken://pages/jo3OJEsRNxMSgOW8D09V): the decision engines, pricing, offers and overrides.
* [Workflows](broken://pages/HtrMw5Rb28SNfizcpoDI): the steps an application follows and where each outcome leads.
* **Guides:** [Publish the Decision Matrix](broken://pages/n5eU7xEVylTz025Fvnzy), [Set Up a Scorecard](broken://pages/CdVet89Uo7n7MdHKWFnS), [Set Up Approval Authority](broken://pages/BOlHIgJWrxip1AUUfkNh) and [Build and Publish a Workflow](broken://pages/YpBznnpGXgIgnhL2fSdK).
* **If you're stuck:** [Product Configuration FAQs](https://docs.uptiq.ai/retail-lending/help-center/faqs/product-configuration.md).

### 5. Fulfil and manage applications

Take approved applications through fulfilment with the right controls. Manage documentation, queues, exceptions and lifecycle progress through completion.

**Done when** queues cover every status your teams work, lifecycle names fit your process, and staff can work and decide applications.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-967834ac02ee3d41b6a9ea1c4bbcb65f7b38aaba%2Fuptiq-retail-los__configurations-manage-queues__queue-list.png?alt=media" alt="Manage queues page"><figcaption></figcaption></figure>

#### Configure it yourself

1. Open **Configurations** → **Manage Queues** and select **Add queue**.
2. Enter a name under **New work queue**.
3. Under **Statuses that put a file in this queue**, select the statuses.
4. Under **Roles that may work this queue** or **People who may work this queue**, select **Add** next to at least one role or person.
5. Under **Products**, add products to limit the queue, or leave it empty to cover every product.
6. Save the queue and drag it into position.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-b2b0f2aa6b6dcb57f7a863b6158837fdadcccd60%2Fuptiq-retail-los__applications__record.png?alt=media" alt="Application record in Underwriting"><figcaption></figcaption></figure>

* [Documents](broken://pages/adDmjh1mCNrm4jqVOIY6): the registry, requirements and checklists. See [Supported Documents](broken://pages/f1ofpr40Qp4aQu6j5DZN) for the types and formats.
* [Lifecycle and Queues](broken://pages/R7nNPhUkV7PFpoQXu97h): stages, statuses and work queues.
* [Application Record](broken://pages/JFF4ngUInPlRk5SpVF7A) and [Workflow Timeline](broken://pages/oH9buEhKL7c4OSqdWm2x).
* **Guides:** [Work an Application](broken://pages/lvXMbbnbRDUhZZqPPeJE), [Claim, Assign and Transfer an Application](broken://pages/2vitIUvb87Dnf1kf0Og8), [Manage Work Queues](broken://pages/AcHGnKC5TVYfuZEeVRA0) and [Change a Product's Lifecycle](broken://pages/tFjYXGI3mCW7chYnbJih).
* **If you're stuck:** [Applications troubleshooting](https://docs.uptiq.ai/retail-lending/help-center/troubleshooting/applications.md).

### 6. Govern and integrate Retail LOS

Maintain a controlled and connected lending solution. Configure external services, enforce appropriate access and review the audit trail.

**Done when** your vendors are connected, API keys and agents are set up, and roles and module access match your policy.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-30817abd2b99fbc1502e099f182f4fd97e3c3959%2Fuptiq-retail-los__settings__integrations-list.png?alt=media" alt="Third Party Integrations page"><figcaption></figcaption></figure>

#### Configure it yourself

1. Open **Settings** → **Integrations** → **Third Party Integrations**.
2. Find the provider, for example **CRS** for credit pulls, and confirm it carries the tags you need.
3. If it is not connected, select **Connect**.
4. To set up failover, connect two integrations in the same family and set **Routing priority** to `1` on the main integration and `2` on the backup.
5. Open **User Management**, create the user with the role that matches the job, and add a second role with **Assign Role** if the person needs more access.

See [Connect Third-Party Integrations](broken://pages/bbbLMXrSOSk5LLhPCVdC) and [Assign Roles and Access](broken://pages/RiRqM3F5kuH60sctM6xH).

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-2cd8353253d6dafac72be049e2dba86da76cde28%2Fuptiq-retail-los__user-management__roles-list.png?alt=media" alt="Roles tab"><figcaption></figcaption></figure>

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-296a9d2157d24e06934c32d7bbbd8321d21b937f%2Fuptiq-retail-los__logs__change-history.png?alt=media" alt="Change History log"><figcaption></figcaption></figure>

Use **Logs** to review who changed what.

* [Integrations](broken://pages/HDQLTIGTmB72aE21K90r): which vendor handles which task.
* [Roles](broken://pages/lwftzPHlwUChlhZeEB6T) and [Module Access](broken://pages/EebOasKPKQhWq9ggrFQL): what each role can do and open.
* [Logs](broken://pages/EApi4HoQOVLOa74TzOwK): the audit trail, emails, API calls and errors.
* **Guides:** [Connect Third-Party Integrations](broken://pages/bbbLMXrSOSk5LLhPCVdC), [Manage Users](broken://pages/f7gdPumh7eDJyAOWCy9G) and [Assign Roles and Access](broken://pages/RiRqM3F5kuH60sctM6xH).
* **If you're stuck:** [Settings](https://docs.uptiq.ai/retail-lending/help-center/troubleshooting/settings.md), [User Management](https://docs.uptiq.ai/retail-lending/help-center/troubleshooting/user-management.md) and [Logs](https://docs.uptiq.ai/retail-lending/help-center/troubleshooting/logs.md) troubleshooting.

### 7. Test, go live and improve

Prove the configuration end to end, activate it, and keep it healthy as policy changes.

**Done when** each product has passed an end-to-end test, is set to **Active**, and changes are reviewed in **Version History**.

<figure><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-3cc983c6130b61577e8c37efb3baa67182c6996c%2Fuptiq-retail-los__product-configuration__product-page.png?alt=media" alt="Product page"><figcaption></figcaption></figure>

Open each product's page to check its tabs before you set **Status** to **Active**.

* [Test Before Go-Live](broken://pages/SaOPfYcafTO6mGboNYJl) and [Common Mistakes](broken://pages/cFDwjWwjywK0MbNttGp4).
* [The 14-Step Checklist](broken://pages/ZHcqhJqAfVimIkhsRuOr): every step, where it happens and how to know it is done.
* [In Branch Experience](https://docs.uptiq.ai/retail-lending/user-journeys/in-branch-experience.md), whose **Set up Retail LOS** tab walks the same path with guides.
* **If you're stuck:** [FAQs](https://docs.uptiq.ai/retail-lending/help-center/faqs.md) and [Troubleshooting](https://docs.uptiq.ai/retail-lending/help-center/troubleshooting.md).

***

{% columns %}
{% column width="83.33333333333334%" %}

<p align="right"><em>Maintained by</em> <mark style="color:green;">Abhishek Paul</mark><br><code>AI-assisted, human-approved</code></p>
{% endcolumn %}

{% column width="16.666666666666664%" %}

<div align="left"><img src="https://2966508920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff06WQMAu97E0STor0yyS%2Fuploads%2Fgit-blob-d034645b4f8f8ee661985f5306b60ded3289653c%2Fmaintainer-abhishek-paul.png?alt=media" alt="" width="60"></div>
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.uptiq.ai/retail-lending/implementation-guide.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
