# Sales job variants

Choose the route that matches the work you are starting, then continue on the page
for that route's stage.

## Overview

A sales job records commercial work as it moves from an early opportunity to delivery.
A Potential is an early opportunity; an **Inquiry** records a request for an offer;
an **Offer** records the commercial proposal; and an **Order** records confirmed order
work. The available starting routes are **Potentials**, **Direct order**, and **Instant
Job**.

An Instant Job is an order-starting route.

```mermaid
flowchart LR
    P[Potentials] --> I[Inquiry]
    I --> O[Offer]
    O --> R[Order]
    R --> D[Delivered]
    DO[Direct order] --> R
    IJ[Instant Job] --> R
```

| If you need to… | Go to |
| --- | --- |
| compare the available starting routes | [Find and choose a starting route](#find-and-choose-a-starting-route) |
| identify the Potential fields before entering data | [Recognize the Potential workspace](#recognize-the-potential-workspace) |
| switch to a different route | [Choose another starting route](#choose-another-starting-route) |
| understand the complete stage map | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) |
| create a sales job from the general entry point | [Create a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-sales-job) |
| start early opportunity work | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) |
| record a customer request | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) |
| work on a proposal | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) |
| work on an order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) |
| move an order through delivery | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) |

The normal route starts at Potential with an inquiry, then follows **Potentials**,
**Inquiry**, **Offer**, **Order**, and **Delivered**. The two order-starting routes,
**Direct order** and the Instant Job route start at **Order**.

## Before you start

> **Note:** The route determines the stage at which the record begins, so choosing an
> order-starting route bypasses the inquiry and offer stages.

The Sales job module provides the route choices and the new-record workspace. You need
signed-in access and permission to create a sales job. Before choosing a route, collect
the information that belongs to that route.

| Collect | Why it matters |
| --- | --- |
| Client and Vendor | The Potential route requires both parties, and the route-specific work uses the selected parties. |
| Items, Item Description, Unit, and Qty | The item grid carries the work into the inquiry, offer, or order. |
| Dates such as Bid Due Date, Order Date, and delivery dates | Each route presents the dates appropriate to its starting stage. |
| Commercial terms such as Delivery Term, Payment Method, and Payment Period | Direct-order and Instant Job order work uses these terms. |
| Salesperson Responsible, Product Type, and Job Title | These fields are required across the new-record variants. |

The Sales job module must be included in your subscription. If it is not included, the
new-record page shows the subscription-upgrade surface instead of the form.

With the route information ready, open the starting route from **Add new**.

## Find and choose a starting route

The route choices open the new sales-job workspace. **Add new** contains **Potentials**,
**Inquiry**, and **Direct order**. The Instant Job route is available where its route
conditions are met.

Prerequisites

- You are signed in.
- The Sales job module is included in your subscription.
- You have permission to create a sales job.

Steps

1. Open **Add new** or the unlabelled plus icon.
2. Select the route that matches the work.

   | If you need to start… | Select |
   | --- | --- |
   | an early opportunity | **Potentials** |
   | a customer request | **Inquiry** |
   | an order without the inquiry and offer stages | **Direct order** |
   | an Instant Job route | the Instant Job route when it is available |

3. If you select **Potentials**, confirm that the new sales-job workspace opens with
   **Job Title** visible.

![The Potentials workspace with its stage sequence and item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/dc006cfee717f5bac53000e47df7c2b3.png)

**Result:** The selected new-record route opens with its route-specific workspace and
controls visible. Use the Potential fields and item grid described next when you choose
**Potentials**.

## Recognize the Potential workspace

The Potential workspace is where you record an early opportunity before the work moves
through the inquiry and offer stages. On the Potential route, **Client**,
**Vendor**, **Salesperson Responsible**, **Product Type**, and **Job Title** are required.

| Area | Fields or columns |
| --- | --- |
| Required party and date fields | **Client**, **Vendor**, **Bid Due Date** |
| Inquiry information | **Client Inquiry Number**, **Inquiry Date**, **Requested Offer Type** |
| Shared required fields | **Salesperson Responsible**, **Product Type**, **Job Title** |
| Item grid | **Item Description**, **Unit**, **Qty** |

The Potential screen showed **File Number** as required as well. The item grid
showed **Item Description**, **Unit**, and **Qty**. **Qty** accepts a value from `0.1` to
`999,999.00`; it is disabled for package items. **Unit** is disabled for package items or
selected products.

 ![The Potential fields and three visible item columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c54a55b6021d9db28a94484fd157341e.png)

Use the route-availability table next to interpret a missing route or a later starting
stage.

## Handle route-availability branches

Route availability depends on the module and on the route conditions. The absence of a
route in one starting variant does not mean that its work is deleted; it means that the
variant starts later in the stage sequence.

| What you see | What it means |
| --- | --- |
| The subscription-upgrade surface instead of the form | The Sales job module is not included. |
| **Order** and **Delivered**, with no **Inquiry** or **Offers**, on a Direct order screen | Direct order starts at Order. |
| **Order** and **Delivered**, with no **Inquiry** or **Offers**, on an Instant Job screen | Instant Job starts at Order. |
| No related-inquiry action on a Direct order or Instant Job | The action is excluded for both order-starting variants. |

When the required route is available, choose it from the route menu described below.
## Choose another starting route

Choose another starting route when you need a different route for the work. The
route-specific form determines which fields and choices you see after the route opens.

Prerequisites

- You are signed in and have creation permission.
- The required route is available in the route menu.
- You have the client, vendor, item, date, and commercial information for the selected route.

Steps

1. Open **Add new** or the unlabelled plus icon.
2. Select one route.

   | Starting work | Select |
   | --- | --- |
   | Potential work | **Potentials** |
   | Inquiry work | **Inquiry** |
   | Order work | **Direct order** |
   | Instant Job order work | the Instant Job route, only where it is available |

3. Use the route-specific controls after the workspace opens.

   | Route | Order fields | Item columns |
   | --- | --- | --- |
   | Direct order | **Client Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Forecasted Delivery Date**, **Delivery Term**, **Payment Method**, **Payment Period**, **External order no.**, **Rate to** | **Item Description**, **Unit**, **Qty**, **Unit Price**, **Discount (%)**, **Item Price**, **Currency** |
    | Instant Job | **Client Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Forecasted Delivery Date**, **Delivery Term**, **Payment Method**, **Payment Period**, **External order no.**, **Rate to** | **Item Description**, **Unit**, **Qty**, **Unit Price**, **Discount (%)**, **Item Price**, **Currency** |

4. Choose the route-specific values from **Product Type**, **Requested Offer Type**,
   **Unit**, **Delivery Term**, and **Payment Method** where those controls appear.

![The Direct order fields and order item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/388ad35e9ee6bb78f64c7e79e62e20ec.png)

![The Instant Job fields and order item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/388ad35e9ee6bb78f64c7e79e62e20ec.png)

**Result:** The alternative new-record workspace opens with the fields and item columns
for that route. Continue with the owning page after choosing the route.

## Continue with the owning page

Each route has an owning page for its route-specific work. After choosing a route, open
its stage page for the route-specific work.

| Selected route | Continue with |
| --- | --- |
| Potential | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) |
| Inquiry | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) |
| Offer | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) |
| Order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) |
| Order through delivery | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) |

Standard creation returns an inquiry record. For the inquiry path, the selected account
becomes a client for that inquiry. Open the linked stage page for the work at that stage.

## Out of scope

This page chooses a starting route. It does not explain saved-record tabs or
post-creation tools; offer, order, delivery, archive, or project-management surfaces;
or milestone, cost-sheet, product/BOM, CRM, account/contact, reference-serial, L/G, and
activity messages. Initial values and runtime-configured fields remain outside this
route-choice page.

### Offer and cost panels

The offer panel is downstream work. `offer-panel-details` is stage-gated from **Offer**
through `LostOffer`. Cost calculation and margin surfaces are inherited embedded
surfaces. Offer and cost validation are outside choosing a starting route.

### Account details and contacts

Use **Client** and **Vendor** to open the corresponding party pickers while choosing a
route. Account-details and contact surfaces are owned by embedded or popup surfaces.
Their maintenance messages are outside this route-choice page.

### Bill of materials and purchasing

The bill-of-materials surface is available only under its stage and permission guard.
The purchasing surface requires a saved job, permission, and subscription. Product/BOM
and purchasing messages belong to those downstream surfaces.

### Other owning pages

Use this hand-off map after route selection:

| Work | Owning page |
| --- | --- |
| Potential work | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) |
| Inquiry work | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) |
| Offer work | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) |
| Order work | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) |
| Order-to-Delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) |
| Saved-record orientation | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) |
| Saved job information and assessment | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) |
| Saved job items | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) |
| Comments and tasks | [Comments and tasks on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) |
| Activities and files | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) |
| Contacts, guarantees, and history | [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) |

### Route and validation messages

If a route or field stops you, use the exact message to identify the correction or the
owning page. The messages declared for this area are listed below; inherited messages
belong to the downstream surface named in the adjacent guidance.

| Message | Guidance |
| --- | --- |
| `Custom fields saved successfully` | Custom-field result; continue on the owning saved-record page. |
| `Job updated successfully` | Saved-record result; continue on the owning saved-record page. |
| `Job deleted successfully` | Saved-record result; deletion is outside route selection. |
| `Job regretted successfully` | Outcome action is outside route selection. |
| `Job cancelled successfully` | Outcome action is outside route selection. |
| `Job missed successfully` | Outcome action is outside route selection. |
| `Job reactivated successfully` | Outcome action is outside route selection. |
| `Converted to offer successfully` | Continue with [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers). |
| `Converted to inquiry successfully` | Continue with [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries). |
| `Converted To Regretted` | Outcome action is outside route selection. |
| `Converted to cancelled` | Outcome action is outside route selection. |
| `Converted to lost` | Outcome action is outside route selection. |
| `An error occurred while processing your request` | Review the route and required information, then use the owning page. |
| `Error saving custom fields` | Custom-field validation is outside route selection. |
| `Cannot be un-delivered — a due invoice already exists` | Delivery correction is outside route selection. |
| `All offers must be in draft status to revert to inquiry` | Offer correction is outside route selection. |
| `Error {{errorMsg}}` | Use the owning page for the affected record. |
| `An account with this name already exists` | Account maintenance is outside route selection. |
| `A project with this name already exists` | Project management is outside route selection. |
| `Check mandatory field(s)` | Complete the required fields on the selected route. |
| `Please save opened inquiry first` | Save the inquiry on its owning page before continuing. |
| `All inquiries must be in draft stage to revert to potential` | Use the inquiry owning page for this correction. |
| `One or more items has ZERO quantity` | Enter a positive **Qty** for each item. |
| `One or more items has no unit` | Choose a **Unit** for each item that requires one. |
| `Required Receiving Date` | Complete the receiving-date field on the owning downstream page. |
| `This field is required` | Complete the field marked as required. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a **Qty** within the allowed range. |
| `Invalid input. Please enter a non-negative value` | Replace the value with a non-negative value. |
| `Please enter action for each milstone` | Complete the milestone action on the owning page. |
| `Please save opened cost sheet first` | Save the cost sheet on its owning page. |
| `Your request was completed successfully` | Continue on the owning page. |
| `Error: Vendor not saved yet` | Save the Vendor on the owning account surface. |
| `Error: Client not saved yet` | Save the Client on the owning account surface. |
| `This Field Is Required` | Complete the field marked as required. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters on the owning form. |
| `You already have a contact with this name` | Use the contact surface to correct the duplicate. |
| `Booked quantity for this job is greater than the required BOM quantity` | Correct the BOM quantity on the owning surface. |
| `You cannot edit or delete the product after the purchase package is created` | Use the purchasing-owned correction path. |
| `Cannot be deleted. Product is in purchasing` | Use the purchasing-owned correction path. |
| `You cannot edit the product after the PO is created` | Use the purchasing-owned correction path. |
| `This product is already included in BOM` | Correct the BOM on its owning surface. |
| `The first variant cannot be deleted` | Use the owning variant surface. |
| `An error occurred while connecting to your CRM system.` | CRM correction is outside route selection. |
| `Please select one product` | Select a product on the owning product surface. |
| `Required Receiving After` | Complete the receiving condition on the owning page. |
| `Package must have at least one item` | Add an item to the package on the owning item surface. |
| `You cannot save without adding at least one product` | Add a product on the owning item surface. |
| `This record is related to saved data and cannot be deleted` | Deletion is outside route selection. |
| `Action not allowed` | Use the owning page for the affected stage. |
| `Please enter at least one email` | Add an email on the owning contact surface. |
| `Inquiry must have at least one item` | Add an item on the inquiry owning page. |
| `Offer must have at least one item` | Add an item on the offer owning page. |
| `Order must have at least one item` | Add an item on the order owning page. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Use the order or delivery owning page. |
| `Please select one or more items to create a RFQ.` | Select items on the purchasing owning page. |
| `Required Offer Type` | Complete **Requested Offer Type** when that validation appears. |
| `Required Bid Due Date` | Complete **Bid Due Date** on the Potential route. |
| `Error loading accounts` | Account loading is outside route selection. |
| `Serial you have entered already exist and belong to same manufacturer` | Serial maintenance is outside route selection. |
| `There is error in serial you have entered` | Serial maintenance is outside route selection. |
| `Minimum: At least one serial` | Serial maintenance is outside route selection. |
| `Please Add Extension to activate the LG` | L/G maintenance is outside route selection. |
| `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | L/G maintenance is outside route selection. |
| `Please choose a date after the current expiry date` | L/G maintenance is outside route selection. |
| `One topic and at least one note is required` | Activity maintenance is outside route selection. |
