# Sales job information and assessment

## Overview

A sales job is the shared record that carries the commercial information for work that can
move from inquiry through offer, order, and delivery.

The stage bar shows the sales-job flow from **Inquiry** to **Offer**, **Order**, and
**Delivered**. The shared information stays with the record while the focused work changes by
stage.

![The stage bar and shared information area on a new Inquiry](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png)

| If you need to… | Go to |
| --- | --- |
| Create the first sales job and complete its inquiry data | Create a sales job |
| Maintain the shared fields and assessment on this record | The procedures below |
| Understand the complete sales-job workspace and its related parts | Sales job record |
| Maintain item rows, pricing, and item-specific locks | Sales job items |
| Move the job between lifecycle stages or handle a lifecycle exit | Sales jobs lifecycle |
| Maintain comments and follow-up tasks | Sales job comments and tasks |
| Maintain related activities and files | Sales job activities and files |
| Maintain contacts, guarantees, and history | Sales job contacts, guarantees, and history |

## Before you start

The information area appears when the relevant subscription is included and the page is not
missing. Editing also depends on whether the record is new or saved, whether you have edit
permission, and which stage the record is in. A new record and a saved record therefore do not
offer exactly the same controls.

| Check before you begin | What it affects |
| --- | --- |
| The sales information subscription is included | The main information area is available. |
| You have a new record or a saved record with edit permission | You can maintain the values that the current record allows. |
| You know the current stage | **Estimated Value**, **Expected Order Date**, potential assessment, and **Order chance** are stage-dependent. |
| You have the values for the fixed mandatory fields | **Salesperson Responsible**, **Product Type**, and **Job Title** are fixed mandatory fields. |
| You know your company’s configured mandatory rules | **End User**, **Team**, **Estimated Value**, and **File Number** can be mandatory only when configuration says so. |
| You have the customer, vendor, and inquiry information when creating an inquiry | Inquiry data has its own fixed and configuration-conditional mandatory rules. |

Use the values shown on your screen and follow the mandatory markers beside the current fields.

## Find and open a sales job

An **Inquiry** is the entry view for a new sales-job record. You can open it for inspection
without saving it, or open an existing sales job from the inquiry list before maintaining its
shared information.

**Prerequisites**

- You are signed in and can access the sales-job workspace.
- You know whether you are inspecting a new inquiry or opening an existing sales job.

**Steps**

1. From the application dashboard, select **Add new**.
2. Follow **Add new** > **Sales Jobs** > **Inquiry** to open a new inquiry screen without saving the record.
3. Open the **Inquiry** list from the **Sales Jobs** navigation.
4. Select the sales job you need to maintain from the inquiry list.

**Result:** The new or existing sales-job information screen is open. The inquiry list shows
**Inquiry date**, **Inquiry type**, and **Inquiry stage**, with **Refresh**, **Table Layout**,
and **Settings** available.

## Understand the information and assessment screen

The information and assessment screen combines the record’s workflow position, shared identity
information, commercial readouts, assessment choices, and save controls. Use the stage bar to
orient yourself; use the field labels to find the values you need to review or change.

| Screen area | What to find there |
| --- | --- |
| Stage bar | **Inquiry**, **Offer**, **Order**, and **Delivered**. |
| Shared information | **Branch**, **Salesperson Responsible**, **Product Type**, **Job Title**, **End User**, **Team**, **Estimated Value**, **File Number**, and **Expected Order Date**. |
| Calculated readouts | **Time Frame**, `In Branch Currency (Rate:1)`, and **Calculated Rating**. |
| Assessment | **Status**, **Contact to Decision Makers**, **Budget Availability**, **Chance in Competition**, and **Order chance**, subject to the current stage. |
| Save controls | **Save** and **Save and Close**. |

The stage bar orients you within the record’s lifecycle. Use Sales jobs lifecycle to move the
job between stages.

![The field groups, calculated readouts, assessment controls, and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png)

Read **Time Frame**, `In
Branch Currency (Rate:1)`, and **Calculated Rating** as readouts after you make selections;
they are not entry fields.

## Maintain shared sales-job information

Shared sales-job information identifies the branch, responsible person, commercial subject, end
user, team, value, file, and expected order timing. Enter these values before reviewing the
commercial assessment.

| Field | What you maintain | Mandatory rule or stage condition |
| --- | --- | --- |
| **Branch** | The branch associated with the sales job. | Not mandatory in the template. |
| **Salesperson Responsible** | The salesperson responsible for the record. | Fixed mandatory; shown for a new record or when the saved record has no salesperson name. |
| **Product Type** | The product type for the job. | Fixed mandatory. |
| **Job Title** | The title used to identify the job. | Fixed mandatory. |
| **End User** | The end user associated with the job. | Mandatory only when your configuration says so. |
| **Team** | The team associated with the job when the control is available. | Mandatory only when your configuration says so. |
| **Estimated Value** | The estimated commercial value. | Mandatory only when your configuration says so; available at or before `Potential`. |
| **File Number** | The file number for the sales job. | Mandatory only when your configuration says so. |
| **Expected Order Date** | The expected date for the order. | Not mandatory in the template; available before **Order**, except when the stage is `Unknown` or `-1`. |

**Prerequisites**

- You have the shared information for the record.
- You know the current stage and the values your configuration makes mandatory.

**Steps**

1. In the shared information area, select the appropriate value in **Branch** when a branch applies.
2. Select the responsible person in **Salesperson Responsible**.
3. Select the product category in **Product Type**.
4. Enter the identifying title in **Job Title**.
5. Select the end user in **End User** when the field is available.
6. Select the team in **Team** when the field is available.
7. Enter the commercial estimate in **Estimated Value** when the field is available.
8. Enter the file identifier in **File Number** when the field is available.
9. Enter the expected date in **Expected Order Date** when the field is available.

**Result:** The shared information fields show the values you entered or selected, and the
mandatory markers identify the values the current screen requires.

## Review the commercial assessment

Commercial assessment records how well the inquiry is positioned and, at later stages, the
chance that it becomes an order. The current stage controls which assessment choices you see.

| Assessment control | Choices or display | When it applies |
| --- | --- | --- |
| **Status** | Select the status shown for the current stage. | The screen requests status values for Potential, Offer, or Order. |
| **Contact to Decision Makers** | `High`, `Medium`, or `Low`. | Potential assessment, before **Order** and at or before `Potential`. |
| **Budget Availability** | `Available`, `In Progress`, or `Not Available Yet`. | Potential assessment, before **Order** and at or before `Potential`. |
| **Chance in Competition** | `High`, `Medium`, or `Low`. | Potential assessment, before **Order** and at or before `Potential`. |
| **Order chance** | `90 %`, `70 %`, `50 %`, `30 %`, or `10 %`. | Offer assessment, from **Offer** until before **Order**. |
| **Calculated Rating** | A calculated percentage readout. | The screen displays it as a readout rather than as an assessment choice. |

**Prerequisites**

- You have reviewed the shared information for the current record.
- You know the stage shown on the stage bar.

**Steps**

1. Confirm the current stage on the stage bar.
2. Use the table to select the assessment values available at that stage.

   | Current stage | Action |
   | --- | --- |
   | Potential | Select a value in **Contact to Decision Makers**, **Budget Availability**, and **Chance in Competition**. |
   | Offer until before **Order** | Select a value in **Order chance**. |
   | Any stage with a calculated result | Read **Calculated Rating** after making the available selections. |

**Result:** The assessment controls that apply to the current stage show your selections, and
**Calculated Rating** shows the calculated readout provided by the screen.

## Edit or restore archived information

**Reset** restores the saved salesperson selection on an existing record when the record has an
identifier and a salesperson name. It is not a new-record control. Archived status, edit
permission, and stage-based conditions can also hide or disable editing controls.

| Condition | What you see |
| --- | --- |
| New record | **Reset** is absent. |
| Existing record with a salesperson name | **Reset** can be available. |
| Archived record or no edit permission | Editing controls can be hidden or disabled. |
| A stage that does not allow a field | The stage-dependent field is not available for editing. |

**Prerequisites**

- You have an existing saved record if you need **Reset**.
- You have permission to edit the record.

**Steps**

1. Open the saved sales job you need to restore or edit.
2. Check whether **Reset** is visible beside the salesperson information.
3. Select **Reset** to remove the saved salesperson selection when the control is available.
4. If an editing control is disabled or absent, continue with the fields that the current stage and permission allow.

**Result:** The salesperson selection is cleared when **Reset** is available and selected; on a
new record, no **Reset** control is shown.

## Save the information

**Save** commits the information and assessment values on the screen. **Save and Close** commits
the values and leaves the screen.

**Prerequisites**

- You have entered the intended shared information and assessment values.
- All mandatory markers visible on the current screen are satisfied.

**Steps**

1. Use the table to choose **Save** or **Save and Close**.

   | If you want to… | Select |
   | --- | --- |
   | Submit the values and remain on the screen | **Save** |
   | Submit the values and leave the screen | **Save and Close** |

2. Check the message shown after the save action.

**Result:** The screen reports `Job updated successfully` when the successful update message is
shown. Custom-field processing reports `Custom fields saved successfully` when that message is
shown.

## Fix validation and save errors

Use the message on screen to identify whether a value is missing, outside the allowed numeric
range, blocked by a mandatory-field check, or rejected while saving.

| Message | Corrective action |
| --- | --- |
| `Job updated successfully` | Treat the save action as successful on the screen. |

| Other message | Reader action |
| --- | --- |
| `Job deleted successfully` | Continue from the sales-job list. |
| `Job regretted successfully` | Continue from the sales-job list. |
| `Job cancelled successfully` | Continue from the sales-job list. |
| `Job missed successfully` | Continue from the sales-job list. |
| `Job reactivated successfully` | Continue working with the reactivated job. |
| `Converted to offer successfully` | Continue with the offer work for the job. |
| `Converted to inquiry successfully` | Continue with the inquiry work for the job. |
| `Converted To Regretted` | Continue from the regretted-job work. |
| `Converted to cancelled` | Continue from the cancelled-job work. |
| `Converted to lost` | Continue from the lost-job work. |
| `Cannot be un-delivered — a due invoice already exists` | Resolve the due invoice before reversing delivery. |

**Prerequisites**

- A save attempt has displayed a validation or save message.

**Steps**

1. Read the exact message displayed after the save attempt and follow its corrective action.

   | Message | Corrective action |
   | --- | --- |
   | `This field is required ` | Complete the field that shows the required marker. |
   | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a number greater than `0` and no more than `999,999.00`. |
   | `Check mandatory field(s)` | Review every visible mandatory marker. |
   | `An error occurred while processing your request` | Review the entered values and select **Save** again. |
   | `Error saving custom fields` | Review the custom-field values and select **Save** again. |

2. Check for `Job updated successfully` after the corrective save.

**Result:** The validation message identifies the correction to make, or the screen shows
`Job updated successfully` after the corrected save.

## Know what happens next

The stage bar shows the lifecycle orientation. After saving the shared information and assessment,
continue with the focused task for the record.

| After maintaining this page… | Continue with |
| --- | --- |
| You need to understand or move through lifecycle stages | Sales jobs lifecycle |
| You need to maintain item rows or pricing | Sales job items |
| You need to manage comments or tasks | Sales job comments and tasks |
| You need to manage activities or files | Sales job activities and files |
| You need to manage contacts, guarantees, or history | Sales job contacts, guarantees, and history |
| You need the overall record workspace | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) |

Save the shared values before continuing with work that depends on the saved record. Use the
stage bar for orientation, then open the page that owns the next task.
