# Potentials

A Potential is an early sales opportunity recorded before it becomes an Inquiry. You either receive
the Inquiry when the opportunity continues or record the opportunity as Missed when it does not.

## Potentials

Potentials is the opening stage in the Sales jobs flow. Inquiries follow Potentials, and Offers,
Orders, and Delivered follow Inquiries.

```mermaid
stateDiagram-v2
    Potentials --> Inquiries: Receive inquiry
    Potentials --> Missed: Missed opportunity
```

The Potential panel is available while the sales-job surface is at the opening stage or at the
Missed outcome. Select **Receive inquiry** when the opportunity continues as an Inquiry. Select
**Missed opportunity** when it does not continue.

| If you need to… | Go to |
| --- | --- |
| Start a new Potential or open an existing one | [Find and open a Potential](#find-and-open-a-potential) |
| Complete the Potential fields and save it | [Create and qualify a Potential](#create-and-qualify-a-potential) |
| Add or correct the item row | [Add an item to a Potential](#add-an-item-to-a-potential) |
| Record that the opportunity did not continue | [Mark a Potential missed](#mark-a-potential-missed) |
| Convert a saved Potential to an Inquiry | [Maintain the Potential panel and receive an inquiry](#maintain-the-potential-panel-and-receive-an-inquiry) |
| Understand the complete sales-job flow | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) |
| Configure company-specific fields | [Configuration custom fields](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-custom-fields) |

![Potentials list and the Potential entry surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2ff8afbddbb899a2b83a5e81a95d15c2.png)

## Before you start

Collect the client, vendor, and at least one item before you enter the Potential details. You need
permission to edit the sales job before you save it or use its action menu. The Potential must be a
saved record before **Receive inquiry** or **Missed opportunity** can appear.

| Have this ready | Why it matters |
| --- | --- |
| The client | The Potential requires a client before it can be saved. |
| The vendor | The Potential requires a vendor before it can be saved. |
| At least one item | The save validation checks that `SalesItems` exists and is not empty. |
| Edit permission | The action menu and its changes are available only when editing is allowed. |
| A saved Potential with no unsaved changes | **Receive inquiry** and **Missed opportunity** are actions on an existing, saved Potential. |

For an existing Potential, finish or discard changes before using the action menu. Unsaved changes
hide the guarded actions until the record is ready. Then use [Find and open a Potential](#find-and-open-a-potential)
to enter the workspace.

## Find and open a Potential

Use the Sales jobs list to start a new Potential or to return to a saved Potential.

**Prerequisites**

- You are signed in and can edit sales jobs when you plan to create or change a record.

**Steps**

1. Open the Sales jobs list.
2. Choose one entry path.

   | If you need to… | Select |
   | --- | --- |
   | Start a new Potential | **Add new**, then **Potentials** |
   | Open an existing Potential | **Potentials**, then the record in the list |

3. If you opened an existing record, open it in the edit view.

**Result:** The Potential workspace is open with either a new Potential or the selected saved
record.

## Understand the Potential screen

The Potential screen is the sales-job workspace for the opening stage. It combines a collapsible
Potential panel, its summary, identity and configured fields, the item grid, and actions for the
next outcome.

On a new record, the summary identifies the job as `Job No. : New`. On a saved record, the summary
shows the saved job instead, and the Potential panel can offer **Receive inquiry**, **Missed
opportunity**, or **Reactivate opportunity** according to the record state and edit conditions.

The **Potentials** panel opens when the Potential data is available. On a saved record, select
**Potentials** to collapse or reopen it. The panel body is open when its expansion state is open.

The panel contains **Client** and **Vendor**, configured Potential fields, and an item grid with
**Item Description**, **Unit**, and **Qty**. The saved record also provides these follow-up areas:

| Tab | Use |
| --- | --- |
| **Comments** | Shared saved-record follow-up |
| **Tasks** | Shared saved-record follow-up |
| **Activities** | Shared saved-record follow-up |
| **Attachment** | Saved-record files |
| **Contacts** | Saved-record contacts |
| **LGs** | Saved-record guarantees |
| **Last Modifications** | Saved-record history |

At the Potential stage, the item grid shows **Item Description**, **Unit**, and **Qty**. **Category**
does not appear in this grid. The stage labels **Potentials**, **Inquiry**, **Offer**, **Order**,
and **Delivered** may appear on the entry surface, but Potential work remains in the Potential
panel.

![The expanded Potential panel with its summary, fields, and item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2ff8afbddbb899a2b83a5e81a95d15c2.png)

## Create and qualify a Potential

Create a Potential when you have an early sales opportunity to qualify before handing it to Inquiry.

**Prerequisites**

- The Potential workspace is open.
- You know the client, vendor, and item information.
- You can edit the sales job.

**Steps**

1. In **Client**, select the client for the opportunity.
2. In **Vendor**, select the vendor involved in the opportunity.
3. Complete the available configured Potential fields.

   | Field group | What to complete |
   | --- | --- |
   | Identity | **Client** and **Vendor** |
   | Sales-job context | **Salesperson Responsible**, **Product Type**, **Job Title**, and **File Number** when shown as required |
   | Qualification | Select **Contact to Decision Makers** (`High`, `Medium`, `Low`); **Budget Availability** (`Available`, `In Progress`, `Not Available Yet`); **Chance in Competition** (`High`, `Medium`, `Low`); and **Order chance** (`90 %`, `70 %`, `50 %`, `30 %`, `10 %`) when those fields are available. |
   | Other configured fields | Any company-configured fields shown on your Potential form |

4. Add or complete an item row as described in [Add an item to a Potential](#add-an-item-to-a-potential).
5. Select **Save**.
6. Confirm that the new-record summary is no longer `Job No. : New`.

The form validates the client and vendor relationship before saving. A client selection that is the
same as the principal is rejected with the client-principal validation message.

**Result:** The Potential is saved, and its summary shows the selected client and vendor on the
saved record.

> **Note:** Required markers for configured fields depend on your company settings. Complete every
> field that your Potential form marks as required.

### Add an item to a Potential

An item row records what the early opportunity concerns. A new Potential starts with an item row;
use the row-add control when you need another row.

**Prerequisites**

- The Potential panel is open.
- You have the item description, unit, and quantity.

**Steps**

1. In the item grid, select the row-add control to create another item row when the existing row is not enough.
2. In **Item Description**, select or enter the product for the row.
3. In **Unit**, select the unit when the field is available.
4. In **Qty**, enter a quantity greater than `0` and no greater than `999,999.00`.
5. Select **Save**.

The item list contains these Potential columns:

| Column | Rule |
| --- | --- |
| **Item Description** | Required. |
| **Unit** | Disabled for package items or when a product is selected. |
| **Qty** | Greater than `0` and no greater than `999,999.00`; disabled for package items. |

The item checks also reject a negative unit price and a negative item total price. Those price
checks belong to the item validation even when the Potential grid does not display price columns.

**Result:** The Potential contains an item row with a description, a usable unit where required,
and a valid quantity.

### Mark a Potential missed

Mark a saved Potential as Missed when the opportunity is not continuing as an Inquiry.

**Prerequisites**

- The Potential is saved and in the new Potential stage.
- You can edit the record.
- The job is not already a missed Potential and has no unsaved Potential changes.

**Steps**

1. Open the Potential action menu.
2. Select **Missed opportunity**.
3. Review the missed-opportunity confirmation dialog.
4. Confirm that the saved result reports `Job missed successfully`.

**Result:** The sales job leaves Potentials and is recorded as Missed.

## Reactivate a missed Potential

A missed Potential can show **Reactivate opportunity**. For reactivation guidance, use [Missed,
regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs).

## Maintain the Potential panel and receive an inquiry

Maintain a saved Potential in its panel until the opportunity is ready to become an Inquiry. The
conversion copies active Potential items into the Inquiry and hands the work to the Inquiries page.

**Prerequisites**

- The Potential is saved with an ID.
- The Potential is in the new stage.
- The job is not deleted or missed.
- You can edit the record.
- The Potential has no unsaved changes.

**Steps**

1. Open the saved Potential record.
2. Select **Potentials** to open the panel if it is collapsed.
3. Update the Potential fields or item rows as needed.
4. If the Potential has unsaved changes, select **Save**.
5. Confirm that no unsaved Potential changes remain.
6. Open the Potential action menu.
7. Select **Receive inquiry**.
8. Confirm that the result reports `Converted to inquiry successfully`.
9. Continue the converted record on the Inquiries page.

Receiving an inquiry changes the sales job to Inquiry and copies its active Potential items. The
Potential panel remains available after the saved-record conversion; the next stage's work belongs
to the Inquiry surface.

**Result:** The sales job is an Inquiry with its active Potential items copied, ready for Inquiry
work.

## Go to offer

**Go to offer** belongs to Inquiry work after the Potential becomes an Inquiry. It is not a
Potential action. Continue on the Inquiries page before working toward an Offer.

## When a Potential does not behave as expected

Use the message you see to correct the condition before saving or repeating an action.

| What you see | What to do |
| --- | --- |
| `Check mandatory field(s)` | Complete the required sales-job fields, including **Client**, **Vendor**, and any required configured fields, then select **Save** again. |
| `Product type is required` | Select **Product Type** before saving. |
| `Job title must not contain special characters` | Correct **Job Title** so it passes the title rule, then save again. |
| `Client is required` | Select a value in **Client**. |
| `Vendor is required` | Select a value in **Vendor**. |
| `Item Description is required` | Complete **Item Description** for the affected row. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a **Qty** greater than `0` and no greater than `999,999.00`. |
| `One or more items has ZERO quantity` | Replace every zero quantity in **Qty** with a value greater than `0`. |
| `One or more items has no unit` | Select a unit in **Unit** where the item requires one. |
| `Invalid input. Please enter a non-negative value` | Correct the affected price so it is not negative. |
| `An error occurred while processing your request` | Review the Potential values and action conditions, then retry the action on the saved record. |
| `Error saving custom fields` | Review the configured fields and save them again. |
| `Job updated successfully` | The saved Potential update completed. |
| `Custom fields saved successfully` | The configured-field update completed. |
| `Please save opened inquiry first` | Save the opened Inquiry before using the related Inquiry action. |
| `All inquiries must be in draft stage to revert to potential` | Use the Inquiry page to return only an Inquiry that is still in draft stage. |
| `Job missed successfully` does not appear after **Missed opportunity** | Check that the record is saved, in the new Potential stage, editable, and not already missed. |
| `Job reactivated successfully` does not appear after **Reactivate opportunity** | Use [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) for reactivation guidance. |
| The **Potentials** panel does not collapse | A saved Potential with unsaved changes raises the collapse warning. Save the changes or choose the dialog's save/discard path before leaving the panel. |
| The client equals the principal | Select a client different from the principal; the Potential cannot use the same selection for both roles. |

## Messages from later sales-job and related workflows

The messages below are not Potential-entry instructions. They help you recognize results and
validation messages that belong to later sales-job stages, delivery, or related record maintenance.

| Workflow context | Message |
| --- | --- |
| Later sales-job exit: deletion | `Job deleted successfully` |
| Later sales-job exit: regret | `Job regretted successfully` |
| Later sales-job exit: cancellation | `Job cancelled successfully` |
| Inquiry progression to Offer | `Converted to offer successfully` |
| Later sales-job conversion to Regretted | `Converted To Regretted` |
| Later sales-job conversion to Cancelled | `Converted to cancelled` |
| Later sales-job conversion to Lost | `Converted to lost` |
| Delivery reversal blocked by an invoice | `Cannot be un-delivered — a due invoice already exists` |
| Reverting an Inquiry when its Offers are not all draft | `All offers must be in draft status to revert to inquiry` |
| Related account maintenance: duplicate name | `An account with this name already exists` |
| Related project maintenance: duplicate name | `A project with this name already exists` |

## Out of scope

This page covers Potential-specific work. Use the owning pages for shared sales-job header fields and
the top **Save**, saved-record follow-up areas, Inquiry fields and vendor routing, later stages, wider item and
pricing administration, comments and tasks, offers, orders, delivery, purchasing, invoices,
payments, costing, and configuration.

The Potential panel does not provide **Technical Notes**, **Commercial Notes**, or **Bid Bond** as
active Potential work. **Enable Editing** is not an active Potential-menu action. Potential stage
chips are not part of the active panel work.

## What happens next

After **Receive inquiry**, the saved job is an Inquiry and its active Potential items are copied into
that Inquiry. Continue on the Inquiries page for the next sales-job work. After **Missed opportunity**,
the job leaves Potentials and is found with the missed or archived sales-job outcomes.

For saved-record comments, tasks, and related follow-up, use [Sales job contacts, guarantees, and
history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history). For the complete stage sequence, use [Sales
jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). For broader missed, regretted, and cancelled outcomes,
use [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs).
