# Create a sales job

Use this page to start a sales job, complete its shared information, save it, and
continue in the saved sales-job workspace.

## Overview

A sales job is the shared record for sales work that continues through the sales stages. A
Potential is an early sales opportunity recorded before a formal customer request exists. An
Inquiry is the formal customer request that carries the client, vendor, requested items, and
bid due date needed to prepare an offer. A normal Inquiry starts at the Potential stage; after
you create it, the saved record opens in the edit workspace where you continue the job.

Creation begins from the sales-job lists. The normal Inquiry route opens the new-job form,
and a saved job continues in the Sales edit workspace. Start with the shared header and
route-specific entry point, then save the record. Detailed Potential and Inquiry panels, their
item grids, and later lifecycle work continue on their focused pages.

| If you need to… | Go to |
|---|---|
| Check which creation route to use | [Find or open a sales job](#find-or-open-a-sales-job) |
| Recognize the shared form and its stage-dependent areas | [Understand the sales-job form](#understand-the-sales-job-form) |
| Fill the common fields | [Enter the main job information](#enter-the-main-job-information) |
| Complete Potential or Inquiry details and items | [Complete the applicable stage details and items](#complete-the-applicable-stage-details-and-items) |
| Correct a blocked save | [Save the sales job and handle validation](#save-the-sales-job-and-handle-validation) |
| Follow the saved job through its stages | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) |
| Locate an existing job in a list | [Find sales job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/find-sales-job-work) |
| Work with Potential-specific details | Potentials |
| Work with Inquiry-specific details | Inquiries |
| Work with item rows | Sales job items |
| Review the saved record | Sales job record |
| Follow up with tasks or activities | Sales job comments and tasks; Sales job activities and files |

For a normal Inquiry, complete the client and vendor, the responsible salesperson, product
type, job title, bid due date, and an item before selecting **Save**. For a Potential, complete
the same shared information and item-entry pattern. ![The blank new sales-job form with the creation route visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png)

When a normal Inquiry is created, its **Estimated Value** is copied to each created sales
potential.

## Prerequisites — what must be in place for this to go smoothly

Before creating a sales job, the Sales Jobs subscription and permission to create a new job
must be available. Have the responsible salesperson, product type, job title, parties, and
any route-specific details ready. The form checks the information before saving, so a
changed record is required before the save controls become available.

| What must be in place | Why it matters |
|---|---|
| Sales Jobs subscription | The sales-job creation surface is available only when the subscription includes it. |
| Permission to create new jobs | Without it, creation is refused. |
| Salesperson, product type, and job title | These shared fields are required before creation. |
| Client, Vendor, due date, and item information for an inquiry | The Inquiry route requires its party and due-date information and uses item rows. |
| A changed form | **Save** and **Save and Close** become available after a change. |

If the subscription or permission is unavailable, creation does not proceed. The access
message is shown as `You don’t have permission to create new jobs`.

**Note:** The required marker for configurable fields follows company configuration. Review
the markers shown beside **Salesperson Responsible**, **Product Type**, **Job Title**, **File
Number**, **Client**, **Vendor**, **Bid Due Date**, and any other visible configurable field.

## Find or open a sales job

The sales-job lists separate work by stage, while **Add new** opens the available starting
points for a new job. Use the stage list when you need an existing record; use a creation
choice when you are starting a new one.

| If you need to… | Select |
|---|---|
| Open all sales jobs | **All** |
| Open early opportunity work | **Potentials** |
| Open inquiry work | **Inquiries** |
| Open offer work | **Offers** |
| Open order work | **Orders** |
| Start a new inquiry | **Inquiry** under **Add new** |
| Start a direct order | **Direct order** under **Add new** |
| Start a standing job when it is available | **Standing job** under **Add new** |

**Prerequisites**

- You can access the Sales Jobs area.
- You know whether you need a new job or an existing record.

**Steps**

1. Open the Sales Jobs list.
2. Select **Add new**.
3. Select the starting point that matches the work.

   | If you need to… | Select |
   |---|---|
   | Begin the normal inquiry route | **Inquiry** |
   | Begin early opportunity work | **Potentials** |
   | Begin an order directly | **Direct order** |
   | Begin a standing job when the option is shown | **Standing job** |

4. For an existing job, select the stage list that contains it.
5. Select the job's data row.

The available stage lists are **All**, **Potentials**, **Inquiries**, **Offers**, and
**Orders**. Selecting **Direct order** under **Add new** opens **Order**.

**Result:** A new-job form or the selected sales-job record is on screen. If you are creating a
job, continue by reviewing the shared form. ![The Add new menu with the available creation choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3d63d3fc3821f3c60f4bb3cd38d51f13.png)

## Understand the sales-job form

The new-job form is the shared workspace for the job header and the stage area selected by
the route. Its fixed header includes the job status and common information; company
configuration can add custom fields and change which fields are required.

| Area | What to look for |
|---|---|
| Header | **Save**, **Save and Close**, and **Reset**. |
| Fixed information | **Status**, **Branch**, **Salesperson Responsible**, **Product Type**, and **Job Title**. |
| Additional shared information | **End User**, **Estimated Value**, **File Number**, and **Expected Order Date**. |
| Company-configured information | Additional fields your company has configured. |
| Stage area | The selected route's panel and item work. |
| Assessment information | **Order chance**, with related assessment fields where shown. |

The visible stage labels include **Inquiry**, **Offer**, **Order**, and **Delivered**. The
form also displays In Branch Currency (Rate:1) and **Calculated Rating** as readouts.
Picker and date controls open without changing the record.

**Prerequisites**

- Open a new sales-job route.
- Do not need to save while inspecting the form.

**Steps**

1. Read the fixed header fields before opening a stage panel.
2. Select **Reset** only when you need to discard the current form changes.
3. Select **New inquiry** to open the inquiry-specific area.
4. Open each picker or date control only when you need to inspect its choices.

**Result:** The shared header and the selected stage area are visible, with company-configured
fields and stage-dependent controls appearing where they apply. ![The shared sales-job header, fixed fields, and stage area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fce4ed65caf1178b3b786ffd780ba17f.png)

## Enter the main job information

The main information identifies who owns the work, what is being sold, and how the job can
be found later. Complete these fields before saving; the form checks the information before
saving.

| Field | What to enter |
|---|---|
| **Salesperson Responsible** | Select the person responsible for the sales job. |
| **Product Type** | Select the product type for the job. |
| **Job Title** | Enter the job title. The title accepts letters, spaces, `_`, `-`, and `.`; special characters are rejected. |
| **End User** | Select the end user when the field is required by your configuration. |
| **Estimated Value** | Enter the estimated value when the field is required by your configuration. |
| **File Number** | Enter the file number when the field is required by your configuration. |
| **Expected Order Date** | Select the expected date when the field is shown for the selected stage. |

**Estimated Value** cannot be less than `0`. For a new job, **Expected Order Date** cannot be
earlier than today.

**Prerequisites**

- You have opened the new-job form.
- You have the responsible salesperson, product type, and job title.
- You have the estimated value, file number, end user, and expected date when your route or company configuration requires them.

**Steps**

1. In **Salesperson Responsible**, select the responsible salesperson.
2. In **Product Type**, select the product type.
3. In **Job Title**, enter the job title.
4. In **End User**, select the end user when the field is required for your job.
5. In **Estimated Value**, enter the estimated value when the field is required for your job.
6. In **File Number**, enter the file number when the field is required for your job.
7. In **Expected Order Date**, select the expected order date when the field is shown for your stage.
8. Review the visible required markers before saving.

If a required value is empty, the form uses `This field is required`. If the job title
contains an unsupported character, it uses `Just '_' '-' And '.' Characters Accepted`.

After you complete the shared fields, continue to the applicable stage details. ![The shared fields before stage-specific details are entered](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5096259ff88c0ac3558eeaa78617055b.png)

**Result:** The visible shared requirements are complete and the form is ready for the
applicable stage details. ![The required markers on the shared and stage-specific fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3d63d3fc3821f3c60f4bb3cd38d51f13.png)

## Complete the applicable stage details and items

Stage details belong to the route you selected. An Inquiry uses its inquiry panel and item
rows; a Potential uses its Potential-specific panel and item rows. The shared header does
not contain the party, inquiry, or item-row fields owned by those panels.

| Route | Continue with |
|---|---|
| Inquiry | **New inquiry**, then **Client**, **Vendor**, **Client Inquiry Number**, **Inquiry Date**, **Bid Due Date**, and **Requested Offer Type**, followed by the inquiry item row. |
| Potential | The Potential-specific panel and its item row. |
| Direct order | The **Order** route and its order-specific details. |
| Standing job | The standing-job route when it is available. |

For an Inquiry, the stage-specific controls include **Client**, **Vendor**, **Client Inquiry
Number**, **Inquiry Date**, **Bid Due Date**, and **Requested Offer Type**. **Inquiry Date**
cannot be later than today, and **Bid Due Date** cannot be earlier than the inquiry date.
The inquiry item grid provides **Item Description**, **Unit**, and **Qty**. These
stage-specific fields and item procedures belong to the focused Potential, Inquiries, and
Sales job items pages.

The shared header does not provide **Client**, **Vendor**, **Bid Due Date**, **Client Inquiry
Number**, **Inquiry Date**, **Requested Offer Type**, **Item Description**, **Unit**, or
**Qty**. **Expected Order Date** also depends on the stage: it is not shown for a Potential,
project-management stage, or Order-or-later stage.

**Prerequisites**

- Complete the shared fields.
- Know whether you are creating an Inquiry, Potential, Direct order, or Standing job.

**Steps**

1. Select the stage panel for the route you opened.
2. For an Inquiry, select **New inquiry**.
3. In **Client**, select the client.
4. In **Vendor**, select the vendor.
5. Complete the other visible inquiry fields that apply to your configuration.
6. In the item grid, complete the visible item row before saving.

For the normal Inquiry route, the focused Inquiry page owns the detailed panel and item
procedure. For Potential work, continue with the focused Potential page. ![The opened Inquiry panel and its stage-specific controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8d99193ef665592589d43250b5bd16a2.png)

**Result:** The route-specific information and applicable item row are complete, and the
sales job is ready to save. Continue with the save procedure. ![The Inquiry fields and item area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fa927336bfbe14055dcc18b2c6987bd5.png)

## Save the sales job and handle validation

The form checks the information before saving. A successful save navigates
to the saved edit workspace; it does not rely on a creation-success confirmation dialog or
create-success toast. **Save and Close** follows the save-and-close path instead of leaving
the new-record form open.

| What you see | What it means | What to do |
|---|---|---|
| `Please Solve the Following Issues :` | Validation found one or more problems. | Read the listed field messages and correct each one. |
| `Sales Responsible is required` | The responsible salesperson is empty. | Complete **Salesperson Responsible**. |
| `Product type is required` | The product type is empty. | Complete **Product Type**. |
| `Job title is required` | The job title is empty. | Complete **Job Title**. |
| `Job title must not contain special characters` | The title contains an unsupported character. | Remove the unsupported character and keep only the accepted title characters. |
| `You don’t have permission to create new jobs` | Your access does not permit creation. | Ask an administrator to grant the required create permission. |
| `An error occurred while processing your request` | The creation request did not complete. | Remain on the form, review the values, and retry when the issue is resolved. |
| `Custom fields saved successfully` | Custom-field changes were saved. | Continue with the next visible form area. |
| `Job updated successfully` | The existing job was updated. | Continue in the saved job. |
| `Converted to inquiry successfully` | The job was converted to an inquiry. | Continue with the Inquiry details. |
| `Check mandatory field(s)` | A required field is empty. | Review the visible required markers and complete those fields. |
| `Please save opened inquiry first` | An opened inquiry needs to be saved before the next action. | Select **Save**, then repeat the action. |
| `One or more items has ZERO quantity` | An item quantity is zero. | Enter a quantity greater than zero in the affected row. |
| `One or more items has no unit` | An item has no unit. | Select a unit in the affected row. |
| `Error saving custom fields` | Custom-field saving did not complete. | Review the custom fields and select **Save** again. |
| `An account with this name already exists` | An account with the entered name already exists. | Use the existing account or enter a different name. |
| `An project with this name already exists` | A project with the entered name already exists. | Use the existing project or enter a different name. |
| `Required Receiving Date` | A receiving date is required. | Enter the receiving date. |
| `This field is required` | A required field is empty. | Complete the field named beside the message. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | The number is outside the allowed range. | Enter a value greater than `0` and no greater than `999,999.00`. |
| `Invalid input. Please enter a non-negative value` | The number is negative. | Enter `0` or a positive value. |
| `Your request was completed successfully` | The requested operation completed. | Continue with the next visible action. |
| `Forbidden characters detected. Please remove them and try again.` | The value contains forbidden characters. | Remove the forbidden characters and retry. |
| `Required Receiving After` | A receiving-after value is required. | Enter the receiving-after value. |
| `Package must have at least one item` | The package has no item. | Add at least one item before saving. |
| `Required Offer Type` | An offer type is required. | Select **Requested Offer Type**. |
| `Required Bid Due Date` | A bid due date is required. | Select **Bid Due Date**. |

**Prerequisites**

- Complete the shared and applicable stage information.
- Change at least one value so **Save** or **Save and Close** is available.
- Have permission to create new jobs.

**Steps**

1. Select **Save**.
2. If `Please Solve the Following Issues :` appears, read each validation message.
3. Select the field named by each message.

   | If the message is… | Correct… |
   |---|---|
   | `Sales Responsible is required` | Select **Salesperson Responsible**, then enter a value. |
   | `Product type is required` | Complete **Product Type**. |
   | `Job title is required` | Complete **Job Title**. |
   | `Job title must not contain special characters` | Select **Job Title** and replace its value with letters, spaces, `_`, `-`, and `.`. |

4. Enter a value in each named field.
5. Select **Save** or **Save and Close**.

After you correct the fields, select **Save** or **Save and Close** again. ![The validation state beside the required fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3d63d3fc3821f3c60f4bb3cd38d51f13.png)

**Result:** A successful **Save** opens the saved sales-job edit workspace. A successful
**Save and Close** follows its save-and-close path. A refused save leaves the form available
for correction; no creation-success dialog or create-success toast is shown. Continue with the
saved sales-job lifecycle.

### Out of scope messages

The following message belongs to delivery-state work, not to creating a sales job:

| Message | Where to continue |
|---|---|
| `Cannot be un-delivered — a due invoice already exists` | Continue with the invoice work before changing delivery. |

## Continue with the sales-job lifecycle

A saved sales job is the record you continue through the sales flow. The saved edit workspace
keeps the shared record with its stage work and related follow-up areas; the visible stage
and related-work areas depend on the job and available subscriptions.

The estimated value is part of the shared information carried into the saved job. After the
save, open the visible stage or related-work area that matches your next task. A saved record
can expose **Tasks**, **Activities**, and **Attachment**.

**Prerequisites**

- The sales job is saved.
- You know whether your next action concerns its stage, a task, an activity, or an attachment.

**Steps**

1. Read the visible stage and **Status** on the saved record.
2. Select the visible stage tab for the next lifecycle action.
3. Select the related-work area that matches your next task.

   | If you need to… | Select |
   |---|---|
   | Follow up on assigned work | **Tasks** |
   | Review recorded work | **Activities** |
   | Review files attached to the job | **Attachment** |

**Result:** The saved sales job is open in its edit workspace, with the visible lifecycle
and follow-up areas ready for the next task. ![The saved sales-job workspace and its shared information](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fce4ed65caf1178b3b786ffd780ba17f.png)
