# Order status

Use this page to find the Sales **Order status** list, maintain its **Name** values,
remove values when permitted, and open the list's export action.

## Before you start

Use **Name** to maintain the values used by your company.

You need a signed-in account, a subscription that includes the feature, and permission
for the action you want to take.

| If you need to… | Go to |
|---|---|
| Check access and subscription conditions | [Find the Order status list](#find-the-order-status-list) |
| Identify the visible value and stored fields | [Understand the list and its fields](#understand-the-list-and-its-fields) |
| Add or change a value | [Add or edit a value](#add-or-edit-a-value) |
| Remove a value | [Remove a value](#remove-a-value) |
| Open the export action | [Export the list](#export-the-list) |
| Resolve a validation, access, or deletion problem | [When maintenance does not work](#when-maintenance-does-not-work) |
| Continue to another configuration area | [Continue with related Sales settings](#continue-with-related-sales-settings) |

## Find the Order status list

The list appears when your subscription includes the feature. Otherwise, an upgrade
surface appears. **New** can be hidden by subscription exclusion or a hidden new-entry
setting. The edit action appears when your account can edit, and the delete menu appears
when your account can delete.

**Steps**

1. Sign in.
2. Open the Sales reference-list destination available to your account.

**Result:** The Order status list is open. Continue with [Understand the list and its
fields](#understand-the-list-and-its-fields).

## Understand the list and its fields

The Order status list is where you review status names before opening a new or existing
entry.

**Steps**

1. Confirm that the list shows the **Name** column.
2. Confirm that **New**, **Refresh**, and **Settings** are available when your account
   permits them.
3. Select **New** to open a new-entry form.
4. Select the edit action for a selected row when editing is available.
5. Open the delete menu for a selected row when deleting is available.

![Inspect the Name column and available list actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c52bfb38c7799d678de032991ff4eb74.png)

![Inspect New, Refresh, Settings, and the Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f40626b7a42b9f932478ad2c72867ea4.png)

| Field or surface | What it does |
|---|---|
| **Name** | Visible list column and form field for the status name. |
| Display position | Hidden value used to control ordering. |
| Record reference | Links each saved value to its stored record. |
| Company value | Hidden stored value. |
| List headers | Disabled for this entry. |
| Row filter | Disabled for this entry. |
| Filtering | No header filtering is available for this entry. |
| Paging | Disabled for this entry. |
| Change a value | Open the edit form from the row's edit action. |
| Remove a value | Use the row's delete action to open the delete menu. |

**Result:** You know which list actions are available and where to start maintenance.
Continue with [Add or edit a value](#add-or-edit-a-value), [Remove a value](#remove-a-value),
or [Export the list](#export-the-list).

## Add, edit, and remove a status value

The list uses **Name** as its visible column and form field. The other stored values
support the list without appearing as customer-entered fields.

### Add or edit a value

Use this procedure to enter a new **Name** or change the name of an existing row.

**Prerequisites**

- The Order status list is open.
- You know the name to enter or change.
- For an edit, the selected row is available and editing is permitted.

| If you need to… | Start with… |
|---|---|
| Add a value | Select **New**. |
| Edit a value | Select the row, then use the edit action. |

If a validation message appears, use this table before selecting **OK** again.

| Message | Action |
|---|---|
| `Field is required` | Enter a value in **Name**. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**. |
| `Parsed server error text` | Correct the value shown in **Name**. |

**Steps**

1. Select **New**, or select a row and use the edit action.
2. In **Name**, enter the new status name or change the existing name.
3. Choose one path:

   | If you want to… | Do this |
   |---|---|
   | Save the value | Select **OK** when the form is valid. |

The new form shows **Name**, **OK**, and the heading `New Order Status`. **Name** has no
required marker on the shown form.

![Inspect the New Order Status form with the Name field and OK action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8ac05d667f2c603ea9596bb025a15c60.png)

After a valid new row is saved, `Data saved Successfully` appears. After a valid edited
row is saved, `Data updated Successfully` appears and the list reloads. If you leave with
unsaved changes, `Do you want to save your changes?` appears.

**Result:** The valid value is committed and the list reloads after **OK**.

### Remove a value

Remove a selected status value when deletion is permitted and the value is not needed by
saved data.

**Prerequisites**

- The Order 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. Review `Are you sure you want to delete this item?`.
4. Choose one path:

   | If you want to… | Do this |
   |---|---|
   | Remove the row | Confirm the deletion through the prompt. |
   | Close the delete menu | Select **Cancel**. |

The product can show `Data Deleted Successfully` after deletion. It can refuse a row
related to saved data with `Related to Saved data, Can't be deleted`, report a failed
operation with `Failed to Delete`, or protect the last remaining value with
`Must have at least one item`.

**Result:** The selected row is removed only after the deletion is confirmed and the
operation succeeds.

## Export the list

Use the shared **Export** action to open the list's export operation.

**Prerequisites**

- The Order status list is open.
- **Export** is available in the shared toolbar.

**Steps**

1. Select **Export**.

**Result:** The export operation opens.

## When maintenance does not work

| What you see | What to do |
|---|---|
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **OK** again. |
| `Field is required` | Enter a value in **Name**, then select **OK** again. |
| `Related to Saved data, Can't be deleted` | Keep the related value or resolve the saved-data relationship before deleting. |
| `Failed to Delete` | Check that the delete menu is available, then review the row before taking another deletion action. |
| `Must have at least one item` | Keep at least one Order status value in the list. |
| **New** is missing | Check that the subscription includes the feature and that new entries are available. |
| Edit is missing | Check that your account can edit. |
| Delete is missing | Check that your account can delete. |
| The list or fields differ | Use the labels and actions currently available on your screen. |
| `Do you want to save your changes?` appears | Review the prompt before leaving the form. |

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

## Continue with related sales settings

Continue with one of these related Sales configuration lists:

- [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home)
- [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status)
- [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status)
- [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons)
- [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons)
- [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons)
