# Offer status

Use this page to review the **Offer Status** list and maintain the names that
support job-process and offer data in Sales configuration.

## Overview

Offer Status is Sales configuration data that supplies the visible names used with
job-process and offer data. An administrator maintains these labels when the
business needs an additional offer-status name before staff begin working with
offers.

The page follows the shared configuration-list pattern: open the list, choose the
available maintenance action, work with the visible **Name** value, and use the
shared form action to finish or cancel the change.

| If you need to… | Go to |
|---|---|
| Reach the Offer Status list | [Find the Offer Status list](#find-the-offer-status-list) |
| Check the visible value and stored fields | [Understand the list and form](#understand-the-list-and-form) |
| Read the field rules | [Fields](#fields) |
| Add or change a label | [Add or change an entry](#add-or-change-an-entry) |
| Leave a form without saving | [Close the form without saving](#close-the-form-without-saving) |
| Remove a label | [Remove an entry](#remove-an-entry) |
| Use list tools | [Use list tools and handle access variations](#use-list-tools-and-handle-access-variations) |
| Continue to related Sales work | [Continue with related configuration](#continue-with-related-configuration) |

## Before you start

Maintain Offer Status labels before the corresponding names are needed in offer
work.

Before changing an entry, know the following conditions:

| Check | What to expect |
|---|---|
| Route | Reach **Offer Status** from the Sales configuration area. |
| New access | **New** appears when the subscription is included and the new action is not hidden. |
| Edit access | The edit action appears when editing is allowed for the account. |
| Delete access | The delete menu appears when deleting is allowed for the account. |
| Form state | The entry form appears after you open a new entry or select an existing row. |

## Find the Offer Status list

The Offer Status list is the Sales configuration surface for reviewing and
maintaining offer-status names.

**Prerequisites**

- You have access to the Sales configuration area.

**Steps**

1. Open the Sales configuration area.
2. Open **Offer Status**.
3. Confirm that the page heading reads **Offer Status**.
4. Use the available list action for the task you want to perform.

   | If you want to… | Use… |
   |---|---|
   | Open a new-item form | **New** |
   | Edit an existing entry | Select a row, then use the edit action when editing is allowed. |
   | Open deletion controls | Open the delete menu when deleting is allowed. |

![The Offer Status heading, Name column, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d27b751a3d92ec6d46f66c4e44060a59.png)

**Result:** The Offer Status list is open, with **New**, **Refresh**, and
**Settings** visible. Selecting **New** opens the new-item form; the available
edit action opens the selected row, and the available delete menu opens deletion
controls.

## Understand the list and form

The list presents the visible **Name** value, while the form lets you maintain
that value through the shared popup. Use the field rules below before changing
an entry.

The list displays **Name**. The columns shown can depend on the account's
configuration, and the action area has no displayed caption.

The form appears after an entry is selected or a new entry is opened. **Name**
appears only when the account's form configuration includes it. The new-item form
shows **Name** and **OK**.

![The new-item form with Name and OK](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1d86eed3ada9d5c761607527ab02754c.png)

### Fields

| Field | What you can do | Requiredness and visibility |
|---|---|---|
| **Name** | Enter or change the offer-status label. | Text field; visible in the list and editable in the form. Required when configured. |
The **Name** required marker depends on the account's form configuration. The
validation messages are:

- `Name is required`.
- `This Field Is Required`.
- `Just '_' '-' And '.' Characters Accepted`.

> **Note:** The account's form configuration determines whether **Name** is required.

### List behaviour

The Offer Status list is a compact reference list. It displays the **Name**
column, alternates row shading, hides column headers, and has paging disabled.
The visible columns come from the account's configuration.

Inline editing, inline adding, and inline deleting are disabled. Use the list
actions and shared popup instead of editing a row directly.

## Maintain Offer Status entries

Maintaining Offer Status means choosing whether to add a name, change an existing
name, or remove a name from the list. The available controls are **New**, the edit
action, the delete menu, **Save**, **Cancel**, and **Delete**.

Use **New** for a new label, the edit action for an existing row when editing is
allowed, and the delete menu for a selected row when deleting is allowed.

### Add or change an entry

Add a new offer-status name or correct an existing one from the shared popup.

**Prerequisites**

- The Offer Status list is open.
- You know the label to enter or change.
- For a change, an existing row is selected and editing is allowed.

**Steps**

| If you want to… | Start with… |
|---|---|
| Add a label | **New** |
| Change a label | Select a row, then use the edit action. |

1. Follow the appropriate path in the table: select **New**, or select a row and use the edit action.
2. In the shared popup, enter or change the value in **Name**.
3. Choose the action that matches your outcome.

   | If you want to… | Select… |
   |---|---|
   | Commit the new or edited item | **Save** |
   | Leave the entry uncommitted | **Cancel** |

After a new item is saved, the message is `Data saved Successfully`. After an
existing item is updated, the message is `Data updated Successfully`.

![The Name field and shared popup action area before saving](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1d86eed3ada9d5c761607527ab02754c.png)

**Result:** The shared popup closes after **Save** or **Cancel**. A successful new
item uses `Data saved Successfully`, and a successful update uses `Data updated
Successfully`.

### Close the form without saving

Close the new-item form without committing its entry.

**Prerequisites**

- The new-item form is open.

**Steps**

1. Select **Cancel** in the save form.
2. If a leave-without-saving choice appears, select **Don't Save**.

![The screen after leaving the new-item form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7908c98f08e107b18cb6966ae064403a.png)

**Result:** The form closes without committing the entry.

### Remove an entry

Remove an existing Offer Status name when deleting is allowed for your account.

**Prerequisites**

- The Offer Status list is open.
- The row to remove is selected.
- The delete menu is available.

**Steps**

1. Open the delete menu for the selected row.
2. Select **Delete**.
3. Choose the action that matches your outcome.

   | If you want to… | Select… |
   |---|---|
   | Confirm deletion | Confirm the message `Are you sure you want to delete this item?`. |
   | Close the delete menu without deleting | **Cancel** |

The outcomes are `Data Deleted Successfully`, `Related to Saved data, Can't be deleted`,
`Failed to Delete`, and `Must have at least one item`.

**Result:** The selected row is deleted only after the delete action is confirmed.

## Use list tools and handle access variations

The list shows **Refresh** and **Settings**. **Export** opens the export action.
Availability of **New**, edit, delete, export, and upload depends on account
access, subscription, or the current form state.

| Situation | What to use or expect |
|---|---|
| Reload the list | **Refresh** is available on the list. |
| Adjust the list surface | **Settings** is available on the list. |
| Move list data out | **Export** opens the export action. |
| Add a list entry | **New** depends on subscription availability and account access. |
| Change or remove an entry | Edit and delete depend on account access and the current selection. |
| Import list data | **Upload** is available in the import form when importing is enabled. |

**Prerequisites**

- The Offer Status list is open.

**Steps**

   1. Select the available list tool that matches your task.

   | If you need to… | Select… |
   |---|---|
   | Reload the list | **Refresh** |
   | Adjust the list surface | **Settings** |
   | Move list data out | **Export** |
   | Add a list entry | **New**, when subscription and account access permit it |
   | Change an entry | The edit action, when account access permits it and a row is selected |
   | Remove an entry | The delete action, when account access permits it and a row is selected |
   | Import list data | **Upload**, when importing is enabled |

**Result:** The selected list tool opens or performs its available action. Use the
filtering procedure next when you need to narrow the entries.

### Refresh and filter the list

Use **Refresh** to reload the list, then identify an entry by its displayed
**Name** value. Filtering is subject to the message `Forbidden characters detected.
Please remove them and try again.`

**Prerequisites**

- The Offer Status list is open.

**Steps**

1. Select **Refresh** to reload the list.
2. Use the list's available filtering surface to narrow entries by the displayed **Name** value.
3. Remove forbidden characters if the message `Forbidden characters detected. Please remove them and try again.` appears.

**Result:** The list is refreshed or filtered using the controls available to your
account.

### Export or import list data

Use **Export** when the action is available. The import form provides **Upload**
when importing is enabled.

**Prerequisites**

- The Offer Status list is open.
- The relevant export or import action is available for your account.

**Steps**

1. Select **Export** to open the export action.
2. For an enabled import form, select **Upload** to begin the available upload action.

**Result:** **Export** opens the export action. **Upload** is available in the
import form when importing is enabled.

## When an Offer Status operation goes wrong

Use the message on screen to classify the problem before changing the entry or
trying another list action.

| What you see | What it means | What to do |
|---|---|---|
| `Name is required` | **Name** needs a value. | Enter a name in **Name** and save again. |
| `This Field Is Required` | A required field is empty. | Enter the required value and save again. |
| `Just '_' '-' And '.' Characters Accepted` | The entered **Name** fails the character rule. | Correct **Name** using the accepted characters. |
| `Forbidden characters detected. Please remove them and try again.` | The filter contains forbidden characters. | Remove the forbidden characters and filter again. |
| `Related to Saved data, Can't be deleted` | The selected entry is related to saved data. | Keep the entry or resolve the related saved data before deleting. |
| `Failed to Delete` | The delete operation failed. | Check whether the delete action is available and try again only when appropriate. |
| `Must have at least one item` | The list cannot lose its last item. | Keep at least one Offer Status entry. |

## Continue with related configuration

Offer Status is used with job-process and offer data. Its list surface is shared
with related reference lists.

Continue with:

- [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) to reach related configuration areas.
- [Order chance](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-chance) for a sibling Sales configuration list.
- [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) for another sibling Sales configuration list.
- [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) for another sibling Sales configuration list.
- [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) for the sales-work context that uses Offer Status data.
- [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) for the wider sales-flow context.
