---
title: "Collateral Investigate Integration with Appraisal Scope® per UAD 3.6 Updates"
slug: "collateral-investigate-integegration"
tags: ["Appraisal Scope"]
updated: 2026-09-21T19:44:17Z
published: 2026-09-21T19:44:17Z
canonical: "docs.cotality.com/collateral-investigate-integegration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotality.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Collateral Investigate Integration with Appraisal Scope® per UAD 3.6 Updates

## Overview

You can integrate Collateral Investigate with Appraisal Scope® to streamline your quality control (QC) review ecosystem for UAD 3.6 appraisal files. This integration automates the validation, review, and revision request workflows. By setting up this connection, you can automatically or manually submit appraisal reports for modern, data-centric validation. This helps you identify compliance errors early and accelerate the revision loop with appraisers.

---

## Collateral Investigate Integration Introduction

The **Collateral Investigate Review Service Integration** enables Appraisal Scope® platforms to seamlessly connect to the QC review ecosystem. This integration provides automated and manual appraisal reviews for modern UAD 3.6 appraisal files, establishing a streamlined loop between file validation, portal submission, automated review, revision requests, and final report delivery.

The Collateral Investigate platform and its integration were architected specifically for UAD 3.6 orders, separating legacy quality control (QC) tools from modern, data-centric validation and review services.

## Accessing the Collateral Investigate Application

Appraisal Scope® Staff and Reviewer users can access the Investigate platform by logging into their dedicated Collateral Investigate platform. Investigate can be launched via an external URL and users may need to sign in with separate credentials from their Appraisal Scope® credentials. This will be dependent on how your Collateral Investigate user profile was created.

> [!NOTE]
> **Important Note: Administrative Configuration (Cotality Activation Required)**
> 
> Before AMC staff users can leverage **Collateral Investigate**, specific platform-level administrative toggles must be enabled by a **Cotality employee**. Contact [**Customer Support**](/ext/docs/clone-support-2#contact-center1) if you need assistance. Once enabled, follow the instructions and guidance provided in this user guide.

## Platform & Client Company Settings

Once the integration is enabled, AMC Staff can configure the global defaults and client-specific behaviors.

#### Platform-Level Settings: Enable Investigate for UAD 3.6 Orders

1. Select **Settings** in the main navigation menu to access your platform configuration.
2. Select **Options** to display the available system parameters.
3. Select **Integrations** to view your connected external services.
4. Scroll down to **Collateral Investigate**, and select **Enabled** from the **Use Collateral Investigate for UAD 3.6** **Orders** dropdown menu.

> [!NOTE]
> **Tip**: The system sets this setting to **Disabled** by default. When you enable this setting, you can configure the Collateral Investigate review service to automatically or manually submit UAD 3.6 orders on a client-by-client basis.

When you enable this setting, the following sub-settings become active:

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-TS2WNES0.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)

| Sub-setting name | Default Value | Purpose/System Action |
| --- | --- | --- |
| Automatically send Investigate revision request to Appraiser | Disabled | Enabled: Automatically forwards revision requests received from Collateral Investigate to the assigned appraiser using the revision template. Disabled: Places the revision request in a pending state, requiring AMC staff to review and transmit manually. |
| Automatically generate PDF document with Investigate findings | Disabled | Enabled: Automatically converts findings from a revision request into a PDF format and saves it to the order's "Additional Documents" (labeled as "Review Findings" document type) |
| Customize Revision Request template (Investigate) | — | Clicking the "Configure" hyperlink allows administrators to customize the text layout, tags, and variables of the automated appraiser email notification. |

---

#### Client Company Settings: Enable Investigate Per Client

This section is only visible if the global platform setting **Use Collateral Investigate for UAD 3.6 Orders** is active.

1. Open the **Client Company Profile** to manage your client-specific configurations.
2. Select **Company Settings** to open the client settings menu.
3. Scroll down to **Integrations**, and select **Enabled** (Default is **Disabled**) from the **Collateral Investigate** dropdown menu.

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-GNHLSJH5.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-TGJYDZHR.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)
  1. Select **Enabled** in the **Automatically submit report** field to set up automatic submissions.
  2. Select **Select JobTypes**, and then select the checkbox for each **UAD 3.6 JobType** you want to submit to Investigate.

| Client Sub-setting | Default Value | Purpose / System Action |
| --- | --- | --- |
| Automatically submit report | Disabled | Enabled: Automatically triggers a review submission to Collateral Investigate when a report is uploaded and passes UAD 3.6 validation. Disabled: Restricts submissions to manual clicks from AMC Staff within the order record. |
| Select JobTypes | None selected | Active only when automatic submission is enabled. Opens a modal checklist of modern (UAD 3.6) Jobtypes configured on the platform. Only orders matching the checked jobtypes will trigger automatic submissions. |

## Document & Artifact Management

Appraisal Scope® uses two distinct, system-locked document types to keep review findings and final reports separate “**Investigate Review**” and “**Review Findings**”.

1. Navigate to the **Settings** menu on your dashboard.
2. Select **Document Upload** from the settings toolbar.
3. Locate the **Additional Document Type** table to view your system-locked document types.
  1. Review the specifications for each document type in the table below:

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-VQE919BH.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)

> [!NOTE]
> **Note**: These system-locked document types cannot be edited, renamed, or deleted.

| Document Type | Primary Purpose | Default Security & Visibility Settings |
| --- | --- | --- |
| "Investigate Review" | Used for the final review summary PDF returned by the Collateral Investigate system. | **Display to Admin** = Selected **Display to Client** = Unselected **Display to Appraiser** = Unselected |
| "Review Findings" | Used for the generated PDF containing active itemized rules or errors for the appraiser to correct. | Follows visibility mappings configured under Settings → Options → Documents → Set Additional Document Visibility. |

## User Interface (UI) Changes: The Review Tab

The appraisal review interface adapts dynamically to the order's dataset standard (Legacy vs. Modern).

#### Legacy (UAD 2.6) Orders

1. Navigate to the **Review** tab within your order to view your checklist options.
2. Select one of the sub-tabs based on your review requirements:

> [!NOTE]
> **Note**: The functionality and behavior of the Automated review process remains unchanged.
  1. Select the **Manual** tab to complete the standard legacy checklist.
  2. Select the **Automated** tab to use the legacy automated reviewer & third-party automated valuation models (AVMs).

---

#### Modern (UAD 3.6) Orders

The Review tab displays two sub-tabs **Collateral Investigate** and **Manual**:

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-91O9TCUL.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)

- The legacy "**Third Party AVM** and **Review Products**" section is removed from modern order creation/edit forms.
- The **Manual** sub-tab displays only the manual checklist or "**No Record Found**."
- The **Collateral Investigate** sub-tab status displays based on configuration:

| System Status Configuration | Sub-tab Interface Displayed |
| --- | --- |
| Platform Setting is Disabled | "Collateral Investigate has not been enabled for this Platform" |
| Platform Enabled, Client Company is Disabled | "Collateral Investigate has not been enabled for this Client" |
| Platform Enabled, Client Company is Enabled | Active Submission UI: Displays the "Submit Review" button and the active Review Progress Table. |

## Review Submission Workflows

#### Core Business Rules

- An appraisal report can be successfully submitted to Collateral Investigate **before or without** a UCDP submission.
- The report **must** successfully pass initial XML file validation and UAD validation checks before the review can be initiated.
- To prevent system sync errors, the platform restricts submissions: **a subsequent report cannot be sent until a final revision callback or completion response is received** for the active review.

---

#### Manual Submission Workflow (Auto-Submit Disabled)

1. Confirm that the active record is a modern order type, with Collateral Investigate active for the client and automatic submission disabled.
2. The appraiser or AMC staff uploads the standardized appraisal ZIP package.
3. Once the package extracts and passes validation, the "Submit Review" button becomes active.
4. Navigate to the **Review** menu and select **Collateral Investigate**.
5. Select **Submit Review**. The button shifts to "**Cancel Review**" (do not click this unless you want to cancel the review submission) and a new entry is populated in the **Review Progress Table** displaying:

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-FBLEYUHA.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)
  - Document Name
  - SSRs Included (Yes/No)
  - Review Status (Submitted)
  - Status Date and Time
  - Submission Method (Manual)
  - Submitted By (Staff User Name)
6. The platform logs an entry in the Notification Log, “**%File name% has been sent to Cotality Investigate for review.**”.

---

#### Automatic Submission Workflow (Auto-Submit Active)

1. Verify the client's integration settings: "Automatically submit report" is **Enabled**, and the order's JobType matches one of the checked modern jobtypes.
2. When the appraiser uploads the appraisal report, file validation executes immediately:
  1. **Valid (File & UAD validation are both green)**: If no review is currently open, the integration auto-posts a review request payload to Collateral Investigate.
  2. **Invalid (At least one validation check fails)**: The review request is suppressed. A notification log is written highlighting the specific validation failure.
3. On successful submission, the progress table lists: **SSRs Sent = No**, **Review Status = Submitted**, **Submission Method = Auto**, **Submitted By = System**, and displays the **Cancel Review** button.
4. The system logs an entry in the Notification Log: “**%File name% has been automatically sent to Cotality Investigate for review.**”

---

#### Sending SSRs (UCDP Portal Updates)

- **Manual Transmission**: Once SSRs are delivered from UCDP, a "**Send SSRs**" hyperlink appears in the *Review → Investigate* view. Clicking this link triggers a "Sending Documents" toast message.

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-47E8RHWR.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)
- Upon receipt confirmation from Investigate, the table updates to **SSRs Sent = Yes** and the link disappears.
- **Automatic Transmission**: If the platform "Automatically submit report" setting is still active, incoming SSRs are immediately pushed to Collateral Investigate in the background, updating the status column to **SSRs Sent = Yes**.

---

#### Field-Level Pre-Validation

Before executing the outbound API call to Collateral Investigate, Appraisal Scope® validates that all mandatory schema fields are completed.

- **Manual Submissions**: If a required field is missing, a pop-up warning halts the request: "**%field name% is required by Cotality Investigate for review request. Please complete this field and try again.**" No table entry is made.
- **Automatic Submissions**: If a required field is missing, the submission is bypassed and logged: "**This order was not automatically submitted to Cotality Investigate because %field_name% is required. Please complete this field and then manually submit the order again.**"

## Tracking Review Status

Collateral Investigate communicates status updates to Appraisal Scope® via real-time API callbacks. These callbacks update the Order Review Progress Table and write a log entry (Sender: "**Cotality Investigate**").

#### Status Code Registry

| Callback Status | Detailed Meaning | Appraisal Scope® Behavior |
| --- | --- | --- |
| UNASSIGNED | The review record is created but has not been claimed by a reviewer. | Process Status: Ready for Review |
| ASSIGNED | The review has been assigned or reassigned to a specific reviewer. | Process Status: Ready for Review |
| INREVIEW | The assigned reviewer has opened the file and started the audit. | Process Status: Ready for Review |
| ESCALATED | The review requires higher-level compliance oversight and is transferred. | Process Status: Ready for Review |
| REVISIONNEEDED | The reviewer has flagged validation findings and requires report corrections. | Triggers the Revision Flow |
| COMPLETED | The review is finalized (Approved, Approved with Conditions, or Declined). | Triggers Completion |
| CANCELED | The review has been cancelled by the platform. | Disables action controls. |

---

#### Review Completion

Upon receiving a COMPLETED callback, the integration executes the following sequence:

- Saves the finalized status; the "**Submit Review**" action button is hidden (resubmissions of identical files are blocked).

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-NSRD0R6Z.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)
- Ingests the final review artifact PDF and saves it to **Documents → Additional Documents** with the document type "**Investigate Review**".

![Document list showing appraisal and investigation review with corresponding dates and file types.](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/additional docs collateral investigate.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)
- Writes a success log to the Notification Log: "**Review Status: Completed. Document %name% has been uploaded to additional documents.**"

## Revision and Resubmission Flow

When a **REVISIONNEEDED** callback is received, the behavior is determined by the platform-level automatic routing setting.

#### Automatic Revision Routing Enabled

- The platform automatically extracts the revision details and drafts an email using the configured revision template.
- The email containing the findings is instantly dispatched to the assigned appraiser.
- The Review Progress view updates to display "**Revision Sent to Appraiser**".
- Buttons for "**View Findings**" and "**Cancel Review**" are exposed.
- The order process status transitions to **Revision Sent**, and the request is cataloged under the Revision Request tab.
- System logs note that a revision-needed status was received and automatically forwarded.

---

#### Manual Revision Routing (Auto-Routing Disabled)

- The platform receives the *Revision Needed* details but does not send the notification.
- The progress view displays "**Revision Needed**".
- Buttons for "**View Findings**", "**Send Revision Request**", and "**Cancel Review**" are exposed. The overall order process status remains unchanged.
- AMC Staff must open the "**View Findings**" modal, review the template draft and itemized rules list, make any required edits, and then click **Send Revision Request**.

![](https://cdn.document360.io/d7730790-9b0e-4a1e-800e-a32628b13559/Images/Documentation/image-9494ENWU.png?sv=2026-02-06&spr=https&st=2026-11-01T03%3A28%3A49Z&se=2026-11-01T04%3A28%3A49Z&sr=c&sp=r&sig=Tr85V7pD2Bv4gbqeqrQbSbNipUxJxoy4mBPajMJ8%2FGg%3D)
- Then, the platform dispatches the email to the appraiser, records the request under the Revision Request tab, updates the progress table to "**Revision Sent to Appraiser**", and changes the process status to **Revision Sent**.

---

#### In-Platform Findings Review

- Staff can click the "**View Findings**" button at any point during a pending revision state.
- This opens a modal listing all raw compliance rules flagged by the Collateral Investigate reviewer.
- If the revision has not been sent, a "**Send Revision Request**" action button is available directly within the modal.

---

#### Review Findings PDF Archival

- If the global setting, “Automatically generate PDF document with Collateral Investigate findings when sending revision request to Appraiser” is enabled, the platform receives an official PDF report of the active compliance errors and files it in **Additional Documents** (categorized as "**Review Findings**") when the revision is sent (either automatically or manually).

---

#### Revised Report Submission

Once the appraiser uploads an updated appraisal report:

- The Collateral Investigate tab hides the manual "Send Revision Request" options.
- The interface displays the status "**Revised Report Received**" and activates the "**Send Revised Report**" button.
- Clicking "**Send Revised Report**" packages and transmits the new XML payload to Collateral Investigate.
- This adds a new row to the progress table and resets the review cycle back to the initial submission stage.

## Cancelling an Active Review

#### How to halt a review:

1. Navigate to the **Collateral Investigate** tab under **Review**, and select **Cancel Review**.

> [!NOTE]
> **Warning:** Cancelling a review is an irreversible action.
2. Enter an optional cancellation reason in the text box when the confirmation pop-up prompts you.
3. Upon confirmation, the platform posts a **DELETEORDER** payload to Collateral Investigate.
4. The progress table status changes to **Cancelled**.
5. All submission and review controls are disabled. **Re-submitting the same file or uploading a new file under the cancelled review thread is blocked by the system**.
6. The system logs an entry in the Notification Log: "**Review Status: Cancelled. Reason: %Cancellation Reason%.**"

## Technical Reference: Create-Order Field Mapping

The following database fields are compiled into the JSON payload during a review request. Missing mandatory fields will halt the request.

| Payload Field | Required? | Source Appraisal Scope® Field |
| --- | --- | --- |
| loanNumber | Yes | Loan Number |
| mortgageType | Yes | Loan Type |
| orderProductType | Yes | Product Type |
| orderProductFileId | Yes | Order Product File ID (FileVault) |
| valuationType | Yes | Property Valuation Method |
| loanPurposeType | Yes | Loan Purpose |
| propertyAddress | Yes | Property Street Address |
| city | Yes | Property City |
| state | Yes | State |
| zip | Yes | ZIP / Postal Code |
| county | Yes | County |
| latitude | Yes | Property Latitude |
| longitude | Yes | Property Longitude |
| orderCreatedDtUtc | Yes | Order Creation Date (UTC) |
| orderProductFileName | No | Uploaded File Name |
| clipId | No | System Identifier |
| borrowerName | No | Borrower First + Last Name |
| appraisedValue | No | Appraised Value |
| salesPrice | No | Sales Price |
| loanAmount | No | Loan Amount |
| orderDueDtUtc | No | Order Due Date (UTC) |
| propertyType | No | Property Type |
| cuRiskScore | No | Collateral Underwriter Risk Score |
| lcaRisk | No | Loan Collateral Advisor Risk |
| serviceProvider.* | No | AMC / Service Provider Details (Name, ID, Provider Details) |

---

## Outcome

After completing these steps, you will have configured Collateral Investigate on your Appraisal Scope® platform. You can now automatically or manually submit UAD 3.6 appraisal reports for validation and track real-time review statuses directly from the Review tab. You can also automatically route revision requests to appraisers when compliance issues are flagged, which improves your workflow efficiency and ensures report quality.