> For the complete documentation index, see [llms.txt](https://docs.phocassoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.phocassoftware.com/sales-insights/set-up-and-manage-sales-insights/set-up-and-use-quote-opportunities.md).

# Set up and use quote opportunities

Set up quote data, identify opportunities, and review customer quote history.

{% hint style="info" %}
**Early access:** This feature is available to participating Sales Insights customers. An administrator must complete setup before you can use it.
{% endhint %}

Sales Insights identifies products a customer has been quoted for but hasn't fully converted to orders. Use these opportunities to prioritize follow-up conversations and review the customer's quote history for context.

## Before you start

* Ensure you have access to Sales Insights and the relevant database. See [Manage customer segmentation](https://docs.phocassoftware.com/sales-insights/set-up-and-manage-sales-insights/manage-customer-segmentation.md).
* Ensure an administrator has completed [customer profile setup](https://docs.phocassoftware.com/sales-insights/set-up-and-manage-sales-insights/set-up-a-database.md#customer-profile).
* Confirm your quote data identifies the customer, product, quote number, quoted value, and whether lines have converted to orders.

## Set up quote data

{% hint style="info" %}
User permissions: Administration.
{% endhint %}

Confirm how your source system records conversion. A status indicating that a record is complete might not mean the customer placed an order.

1. On the **Customer profile** page, select the three-dot menu in the top-right corner, then select **Edit configuration**.
2. In **Insights setup**, go to the **Customer profile** step and select the **Quotes** tab. Choose how your data identifies converted quotes: quote statuses or an order reference.
3. Map the quote data using the table below.
4. Configure the conversion method and opportunity rules.
5. Select **Done** to save the configuration.

For processing and status guidance, see [Customer profile setup](https://docs.phocassoftware.com/sales-insights/set-up-and-manage-sales-insights/set-up-a-database.md#customer-profile).

### Map the quote data

| Mapping                                   | What to select                                                                   |
| ----------------------------------------- | -------------------------------------------------------------------------------- |
| **Quote stream**                          | The stream containing quotes.                                                    |
| **Customer dimension**                    | The customer identifier. Its codes must match those in your sales data.          |
| **Product dimension**                     | The product identifier.                                                          |
| **Value measure**                         | The quoted line value.                                                           |
| **Quantity measure**                      | The quoted quantity, where available.                                            |
| **Quote number**                          | The dimension or transaction property containing the quote number.               |
| **Line number**                           | An optional identifier for individual quote lines.                               |
| **Filter dimension** and **Filter value** | A filter that selects quotes when the stream also contains other document types. |

Lines without valid quote numbers are excluded from quote history. Without a line number, separate lines for the same product can be grouped together.

### Identify converted quotes

* For quote statuses, configure **Status dimension**, **Won values**, **Open values**, **Lost values**, and any **Exclude values**.
* For order references, configure **Order reference property**.

Lost lines remain in the quote data. Excluded lines are removed from the analysis.

### Configure opportunity rules

Choose rules that reflect your normal quoting and sales cycle.

| Setting                       | What it controls                                                                                                                                                             |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Value** or **Line count**   | Whether conversion is measured using quoted value or the number of quote lines.                                                                                              |
| Maximum conversion percentage | The maximum conversion rate a product can have and still qualify as an opportunity.                                                                                          |
| **Minimum quote age (days)**  | For status-based conversion, how old an open quote must be before it contributes to opportunity detection. The default is 30 days, measured from the quote transaction date. |

Advanced settings let you adjust the minimum number and value of open lines, how many months of quote history to analyze, the maximum opportunities per customer, and the maximum average value per open line. Opportunities are ranked by open value.

## Review quote opportunities

On the customer profile, use the quote conversion filter under **All products**. Expand an opportunity to review its quoted, ordered, and open activity.

One quote can contain several lines for the same product, so quote and line counts can differ. Open quoted value represents potential business rather than guaranteed revenue.

For general profile navigation and Analytics actions, see [Review a customer profile](https://docs.phocassoftware.com/sales-insights/explore-customer-insights/review-a-customer-profile.md).

## Review quote history

Select **Quotes** to review quote dates, numbers, line counts, and values. Expand a quote for product details. Select a status card to filter the list, then select it again to clear the filter.

| Status            | What it means                                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Open**          | The quote has open lines and no won lines. It can also contain lost lines.                                                 |
| **Partially won** | Some lines are won, and others are open or lost.                                                                           |
| **Won**           | All lines included in the analysis are won.                                                                                |
| **Lost**          | All lines included in the analysis are lost. Older open quotes can also appear here when stale quotes are counted as lost. |
| **Unclassified**  | One or more lines have missing, unmapped, or conflicting status information.                                               |

Cards show each quote's full quoted value. For a partially won quote, this includes its open and lost lines.

### Count stale quotes as lost

The **Count stale quotes as lost** switch is on by default. Older open quotes appear as **Lost** and are included in the conversion calculation.

Turn the switch off to keep those quotes **Open** and exclude them from conversion.

{% hint style="info" %}
This switch doesn't update statuses in your source system.
{% endhint %}

### Interpret conversion rates

The Quotes summary measures conversion across the customer's quote history, excluding quotes that don't meet its calculation rules. Opportunity detection looks at individual products using your configured rules.

A customer with a high overall conversion rate can still have open quotes for a product worth following up. Use the figures and explanation beside each percentage to understand what it includes.


---

# 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.phocassoftware.com/sales-insights/set-up-and-manage-sales-insights/set-up-and-use-quote-opportunities.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.
