# Sales job lifecycle

Use this page to identify a sales job's current position, choose the work list for
the next action, and follow the job to its next stage or outcome.

## Sales job lifecycle at a glance

A sales job is work that progresses from **Potentials** through **Inquiries**,
**Offers**, **Orders**, and **Delivered**. **Potentials** is the opening stage in the
sales-job route.

```mermaid
stateDiagram-v2
    [*] --> Potentials
    Potentials --> Inquiries: convert potential
    Inquiries --> Offers: convert inquiry
    Offers --> Orders: convert offer
    Orders --> Delivered: deliver all active orders
    Inquiries --> CancelledInquiries: cancel inquiry
    Offers --> RegrettedToOffer: regret to offer
    Offers --> CancelledOffers: cancel offer
    Orders --> CancelledOrders: cancel order
    Orders --> RejectedOrders: reject order
    Potentials --> Missed: mark missed
    Inquiries --> Lost: mark lost
    Inquiries --> DeletedInquiries: delete inquiry
```

The active route is **Potentials** → **Inquiries** → **Offers** → **Orders** →
**Delivered**. The outcome branches are separate destinations: **Missed**,
**Regretted to Offer**, **Cancelled Inquiries**, **Cancelled Orders**, **Rejected
Orders**, **Lost**, and **Deleted Inquiries**.

| If you need to… | Go to |
|---|---|
| Find a job in an active or archived work list | [Find the job and its current work list](#find-the-job-and-its-current-work-list) |
| Choose a list for the work you need to do | [Choose the list for the work you need to do](#choose-the-list-for-the-work-you-need-to-do) |
| Read the stage tabs on a saved record | [Read the job's lifecycle position](#read-the-jobs-lifecycle-position) |
| Understand the normal conversion route | [Follow the happy path](#follow-the-happy-path) |
| Review an alternate outcome | [Handle exits and alternate branches](#handle-exits-and-alternate-branches) |
| Fix a blocked conversion or delivery route | [When the route goes wrong](#when-the-route-goes-wrong) |
| Continue with related work | [Continue the work](#continue-the-work) |

## Before you follow a sales job

A saved sales job is a record that already has a place in the sales route. Before
you interpret its tabs, confirm that you can reach the Sales Jobs area and that the
record you need is available to you.

**Prerequisites**

- Your account has access to the Sales Job subscription.
- A saved sales-job record is available in one of the Sales Jobs lists.
- The record follows the standard sales-job route rather than a Direct Order or
  Instant Job route.

The application shows the sales-job surface only when the Sales Job subscription is
included and the page is available. The visible lists, panels, **Tasks**,
**Activities**, **Attachment**, and actions vary with your access, job type, selected
parties, company configuration, and the job's saved state.

On the standard route, the **Potentials**, **Inquiry**, and **Offer** tabs are
available as the job progresses. Direct Order and Instant Job records use a different
set of tabs. If the Sales Job subscription is not included or the page is unavailable,
the sales-job workspace is not the place to continue.

**Note:** Opening a saved record, a stage tab, or a three-dots menu is read-only.

## Find the job and its current work list

Sales Jobs separates active work from archived outcomes. Use the primary tabs to reach
the part of the route you need, then open the record from its data row.

**Prerequisites**

- You have access to the Sales Jobs subscription.
- You know whether you are looking for active work or an archived outcome.

**Steps**

1. Open the Sales Jobs area.
2. Select the primary tab that matches the job's current work.

   | If you need to… | Select |
   |---|---|
   | Review every available sales job | **All** |
   | Work with early opportunities | **Potentials** |
   | Work with inquiries | **Inquiries** |
   | Work with offers | **Offers** |
   | Work with orders | **Orders** |
   | Review completed or outcome records | **Archived** |

3. If you selected **Archived**, select the outcome filter that matches the record.

   | Outcome | Archived filter |
   |---|---|
   | Delivered work | **Delivered** |
   | A lost opportunity | **Lost** |
   | A job returned to offer work | **Regretted to Offer** |
   | Cancelled inquiries | **Cancelled Inquiries** |
   | Cancelled orders | **Cancelled Orders** |
   | Rejected orders | **Rejected Orders** |
   | Missed opportunities | **Missed** |
   | Deleted inquiries | **Deleted Inquiries** |

4. Select the required data row.

   ![Select a sales-job row from the work list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png)

The selected job opens.

**Result:** The selected sales job is open, or the list shows the active or archived
work list that owns your next action.

### Choose the list for the work you need to do

A work list is the stage-focused list for sales jobs that need the same kind of
attention. Choose it by the work you want to perform, not by a field name in the row.

| If you need to… | Use this list |
|---|---|
| Qualify early opportunity work | **Potentials** |
| Work on an inquiry before an offer exists | **Inquiries** |
| Prepare or review an offer | **Offers** |
| Work on confirmed order activity | **Orders** |
| Review completed work or an outcome | **Archived** |

The Inquiry list uses **Job No.**, **Inquiry date**, **Inquiry type**, and **Inquiry
stage**. Each list can carry its own column set, so read the headers visible in the list
you opened. Use the list's header filters for quick filtering and **Filter Row** for
filtering from the row beneath the headers.

## Read the job's lifecycle position

The saved sales-job record is the focused workspace for one job. Its stage tabs show
which parts of the lifecycle are available, while **Status** and the stage-specific
presentation show the position within the route.

Open the record from a work-list row, then read the visible tabs and fields:

| What you see | What it tells you |
|---|---|
| **Potentials** | The job is at the opening opportunity stage. |
| **Inquiry** | The job is being handled as an inquiry. |
| **Offer** | The job is being handled as an offer. |
| **Order** | The job is being handled as an order. |
| **Project management** | Project-management work is available for the record. |
| **Delivered** | The record has reached the delivered stage. |
| **Order chance** | The offer-stage record carries the order-chance value before Order. |
| **Status** | The saved record's current status is shown on the record. |

The record presents the tabs that its job type and saved state allow. Direct Order and
Instant Job records do not present the **Potentials**, **Inquiry**, or **Offer** stage
tabs. A delivered record presents **Delivered**; a record still before delivery does
not use that tab as its current stage.

![Read the Potentials stage tab and its stage-specific choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9175badc065d26217c2b9f283c0357fb.png)

![Read the Inquiry tab, Status, and saved-record fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png)

## Follow the happy path

The happy path is the normal route for a sales job that continues from an early
opportunity to delivery. Each conversion carries the work forward to the next focused
stage page.

**Prerequisites**

- A saved sales job is open.
- The record is at the stage whose conversion you want to follow.
- The active items and stage information are ready for the next conversion.

**Steps**

1. Follow the conversion that matches the current stage.

   | Current stage | Action | Next stage or result |
   |---|---|---|
   | **Potentials** | Convert the active Potential items. | The items are copied into the Inquiry. |
   | **Inquiries** | Convert the active Inquiry items. | The items move into the Offer and an **On delivery** milestone is created. |
   | **Offers** | Convert the Offer items and payment milestones. | The items and milestones move into the Order. |
   | **Orders** | Complete the delivery work on the detailed delivery page. | The job moves to **Delivered** when delivered orders equal active orders. |

   ![Follow the offer stage before conversion to Order](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png)

2. If the conversion succeeds, confirm the message `Converted to offer successfully`.

   ![Follow the order stage and its delivery hand-off](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png)

**Result:** The sales job follows **Potentials** → **Inquiries** → **Offers** →
**Orders** → **Delivered**, with each stage's detailed work continuing on its focused
page.

## Handle exits and alternate branches

An exit records that the job did not continue through the active route. Read the
outcome list to find the record, then open the stage page that owns any recovery action.

| Outcome | Stage or route context | Where to continue |
|---|---|---|
| **Missed** | The opportunity leaves the active route as missed work. | Missed, regretted, and cancelled jobs |
| **Regretted to Offer** | Offer work returns to the regretted-to-offer outcome. | Missed, regretted, and cancelled jobs |
| **Cancelled Inquiries** | An inquiry leaves the route as cancelled work. | Missed, regretted, and cancelled jobs |
| **Cancelled Orders** | An order leaves the route as cancelled work. | Missed, regretted, and cancelled jobs |
| **Rejected Orders** | An order leaves the route as rejected work. | Missed, regretted, and cancelled jobs |
| **Lost** | The job leaves the active route as lost work. | Missed, regretted, and cancelled jobs |
| **Deleted Inquiries** | An inquiry leaves the route as deleted work. | Missed, regretted, and cancelled jobs |

The corresponding stage names are `CancelledInquiry` at **Inquiries**, `CancelledOffer`
at **Offers**, and `CancelledOrder` at **Orders**. Use the outcome page for the
archived destination and the stage page for any action that belongs to the stage itself.

## When the route goes wrong

The route stops when a stage's required condition is not met. Use the exact message
on screen to distinguish a draft-status restriction from a missing field, invalid item,
or delivery restriction.

| What you see | What it means | What to do |
|---|---|---|
| `All inquiries must be in draft stage to revert to potential` | An inquiry cannot revert until all inquiries are in draft stage. | Review the inquiries and use the inquiry page. |
| `All offers must be in draft status to revert to inquiry` | An offer cannot revert until all offers are in draft status. | Return the offers to draft status, then retry from the offer page. |
| `All orders must be in draft status to revert to offer` | An order cannot revert until all orders are in draft status. | Return the orders to draft status, then retry from the order page. |
| `Cannot be un-delivered — a due invoice already exists` | A due invoice prevents reversing delivery. | Continue with the invoice page before attempting a delivery change. |
| `Check mandatory field(s)` | A required field is empty. | Review the visible required fields on the current stage page. |
| `One or more items has ZERO quantity` | An item quantity is zero. | Correct the item quantity on the current stage page. |
| `One or more items has no unit` | An item has no unit. | Select a unit for every affected item. |
| `An error occurred while processing your request` | The requested operation did not complete. | Remain on the current page and review the stage-specific values. |
| `Error saving custom fields` | Custom-field saving did not complete. | Review the custom fields and save again from the record page. |

The stage-menu blocks that do not appear on the page are not available choices. Use
the controls shown on the current record and continue on the focused stage or outcome
page instead of looking for an inline stage menu.

### Messages you may encounter

The following messages belong to the sales-job record, its stage transitions, or
shared work areas reached from the record. Use the context column to decide where to
continue.

| Context | Message |
|---|---|
| Custom fields | `Custom fields saved successfully` |
| Save | `Job updated successfully` |
| Delete | `Job deleted successfully` |
| Regret | `Job regretted successfully` |
| Cancellation | `Job cancelled successfully` |
| Missed outcome | `Job missed successfully` |
| Reactivation | `Job reactivated successfully` |
| Inquiry conversion | `Converted to offer successfully` |
| Inquiry conversion | `Converted to inquiry successfully` |
| Regret conversion | `Converted To Regretted` |
| Cancellation conversion | `Converted to cancelled` |
| Lost conversion | `Converted to lost` |
| Request processing | `An error occurred while processing your request` |
| Custom fields | `Error saving custom fields` |
| Delivery reversal | `Cannot be un-delivered — a due invoice already exists` |
| Offer reversal | `All offers must be in draft status to revert to inquiry` |
| Variable error | `Error {{errorMsg}}` |
| Account entry | `An account with this name already exists` |
| Project entry | `A project with this name already exists` |
| Required field | `Check mandatory field(s)` |
| Open inquiry | `Please save opened inquiry first` |
| Potential reversal | `All inquiries must be in draft stage to revert to potential` |
| Item quantity | `One or more items has ZERO quantity` |
| Item unit | `One or more items has no unit` |
| Required field | `This field is required  ` |
| Numeric value | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` |
| Numeric value | `Invalid input. Please enter a non-negative value` |
| Receiving date | `Required Receiving Date` |
| Receiving interval | `Required Receiving After` |
| Offer type | `Required Offer Type` |
| Bid due date | `Required Bid Due Date` |
| Request processing | `Your request was completed successfully` |
| Account or contact text | `Forbidden characters detected. Please remove them and try again.` |
| Account loading | `Error loading accounts` |
| Milestones | `Please enter action for each milstone ` |
| Cost sheet | `Please save opened cost sheet first` |
| Discount | `There is a maximum discount that exceeds the negotiation margin.` |
| Gross profit | `The gross profit margin is unacceptable, and the release prices have been stopped.` |
| Vendor | `Error: Vendor not saved yet` |
| Client | `Error: Client not saved yet` |
| Required field | `This Field Is Required` |
| Contact | ` You already have a contact with this name` |
| Contact text | `Just '_'‘-''.' And '&' Characters Accepted` |
| Sales order | `Sales order is archived` |
| Bill of materials | `Booked quantity for this job is greater than the required BOM quantity` |
| Product edit | `You cannot edit or delete the product after the purchase package is created` |
| Product delete | `Cannot be deleted. Product is in purchasing` |
| Purchase order | `You cannot edit the product after the PO is created` |
| Bill of materials | `This product is already included in BOM` |
| Product variant | `The first variant cannot be deleted` |
| CRM connection | `An error occurred while connecting to your CRM system.` |
| Product selection | `Please select one product` |
| Package | ` Package must have at least one item` |
| Product list | `You cannot save without adding at least one product` |
| Product quantity | `One of products has no quantity` |
| Related record | `This record is related to saved data and cannot be deleted` |
| Permission | `Action not allowed` |
| Validation | `Check validation` |
| Item selection | `No remaining items. All items have been selected` |
| Branch access | `This action is only allowed if you belong to that branch` |
| Email | `Please enter at least one email` |
| Inquiry items | `Inquiry must have at least one item` |
| Offer items | `Offer must have at least one item` |
| Order items | `Order must have at least one item` |
| Product deletion | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` |
| Request for quotation | `Please select one or more items to create a RFQ.` |
| Permission | `You don’t have permission` |
| Serial | `Serial you have entered already exist and belong to same manufacturer` |
| Serial | `There is error in serial you have entered` |
| Serial | `Minimum: At least one serial` |
| Letter of guarantee | `Please Add Extension to activate the LG` |
| Letter of guarantee | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` |
| Letter of guarantee | `LG still needs confirmation` |
| Expiry date | `Please choose a date after the current expiry date` |
| Pending increase | ` There is a pending increase you can edit` |
| Activity topic | `One topic and at least one note is required` |
| Activity topic | `There is no topic to print` |

## Continue the work

The saved job workspace keeps the shared record information together with workflow
panels, items and product, and related work. After you identify the lifecycle position,
move to the page that owns the next detailed action.

| If you need to… | Continue with |
|---|---|
| Filter a list, inspect its columns, or open another record | [Find the job and its current work list](#find-the-job-and-its-current-work-list) |
| Create the starting record | Create sales job |
| Work with Potential items | Potentials |
| Work with Inquiry items | Inquiries |
| Prepare an Offer | Offers |
| Confirm an Order | Orders |
| Move from Order into delivery | From Orders to Delivered |
| Review a missed, regretted, cancelled, lost, rejected, or deleted outcome | Missed, regretted and cancelled jobs |
| Review the saved record and its common areas | Sales job record |
| Follow up with **Tasks** | Sales job comments and tasks |
| Review **Activities** | Sales job activities and files |
| Add or review an **Attachment** | Sales job activities and files |
| Continue with warehouse shipping orders | Shipping orders |
| Continue with invoices associated with delivery | Invoice lifecycle |

The **Tasks**, **Activities**, and **Attachment** tabs are feature-gated and appear
when the corresponding subscriptions and record access allow them. Select the tab that
is visible on your record; if it is not present, continue with the work area available
to your account.

**Prerequisites**

- You have opened the saved sales job.
- You know the stage, outcome, or related work you need next.

**Steps**

1. Read the visible stage tab and **Status** on the saved record.
2. Select the visible tab that matches the follow-up work you need.

   | If you need to… | Select |
   |---|---|
   | Follow up on tasks | **Tasks** |
   | Review activities | **Activities** |
   | Add or review files | **Attachment** |

**Result:** The saved record remains available while the selected stage, related work,
delivery, invoice, or warehouse page holds the next task.
