# Lost reasons

Maintain the names that explain why a sales job reached **Lost**, then use a maintained name when
the sales record is recorded as lost.

## Lost reasons at a glance

A lost reason is Sales configuration data that names why a sales job reached **Lost**. The
**Lost Reasons** page is a Sales configuration list with one visible, required **Name** field.
The list is limited to the **Lost** sales-job status, and a lost record carries the selected name.

Maintain these names by opening the list, adding or editing a name, selecting the edit or delete
control in the selected row, or selecting **Export** for list output.

For example, an administrator can add a competitor-won reason before an offer is marked lost.
The later lost record then has a name for that outcome.

| If you need to | Go to |
|---|---|
| Find the subject list | [Find the Lost reasons list](#find-the-lost-reasons-list) |
| Understand the field and list layout | [Understand the list and entry form](#understand-the-list-and-entry-form) |
| Add or change a name | [Add or update a reason](#add-or-update-a-reason) |
| Remove a name | [Remove a reason](#remove-a-reason) |
| Export the list | [Export the list](#export-the-list) |
| Compare related Sales reference lists | [Handle access and list variations](#handle-access-and-list-variations) |
| Use a maintained reason on a sales job | [Continue after maintaining lost reasons](#continue-after-maintaining-lost-reasons) |

The page title is **Lost Reasons**, its parent area is **Sales**, and the entry-form title is
**Lost Reason**.

## Before you start

The Lost reasons list is reference data for naming a sales job's loss, so decide the names your
team needs before maintaining the list. Sign in before opening the visible **Sales** configuration
area.

The list uses shared configuration rules. The available columns can vary, and the availability of
**New**, the edit control in the selected row, the delete control in the selected row, **Export**,
and **Import** is permission-controlled.

## Find the Lost reasons list

### Prerequisites

- You are signed in.

### Steps

1. Open the visible Sales configuration area.
2. Select **Sales**.
3. Select **Lost Reasons**.
4. Confirm that the page title is **Lost Reasons**.
5. Confirm that the list has a configured **Name** column.
6. Confirm that configured rows appear in the list.
7. Use the list action you need:

   | If you need to | Select | Purpose |
   |---|---|---|
   | Add a reason | **New** | Open a new-item form. |
   | Reload the list | **Refresh** | Reload the configured rows. |
   | Work with list settings | **Settings** | Open the list settings. |

![The Lost Reasons list with the Name column, configured rows, New, Refresh, and Settings visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/870e41f7a14bf471775a7209768ac299.png)

**Result:**

The **Lost Reasons** list is on screen with its configured **Name** column, rows, and available list actions.
That completes this procedure.

## Understand the list and entry form

The entry form records the displayed name. The list repeats that name so you can recognise the reason
before opening it.

| Surface | What to expect |
|---|---|
| **Name** in the list | The configured **Name** column is visible. |
| **Name** in the form | **Name** is a text box and is required. |
| Form title | A new or edited item opens the shared form; a new item uses `New Lost Reason`. |
| Configured columns | A column appears in the form only when it is marked for forms. |
| Required marker | A field is required only when its configuration marks it required. |
| Available columns | The list columns can vary with configuration. |

For this list, **Name** is the only visible configured field.
Other stored details, including Display order, Company identifier, Status, and Reason type, are
not shown in this list or form.

![The required Name text box in the Lost Reason form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0cf2858808609a05b925d3ae19728555.png)

## Add, update, remove, or export a reason

Choose the maintenance action that matches the change you need:

| If you need to | Use |
|---|---|
| Add a new reason | **New** opens a new-item form. |
| Change an existing reason | The edit control in the selected row opens that row in edit mode when editing is allowed. |
| Submit an addition or change | **Save** submits the new or edited item through the shared popup. |
| Export list data | **Export** opens export options and starts export from its footer. |
| Import list data | **Import** opens the import flow when import permission is enabled. |

Use the procedures below for the conditions and messages attached to each action.

### Add or update a reason

Add a new loss-reason name or correct an existing one from the shared Lost Reason form.

### Prerequisites

- You are on the **Lost Reasons** list.
- **New** is available for an addition, or editing is allowed for the selected row.

### Steps

1. Choose the operation:

   | If you need to | Select |
   |---|---|
   | Add a reason | **New**, which opens a form titled `New Lost Reason`. |
   | Edit a reason | The edit control in the selected row, when editing is allowed. |

2. In the **Name** text box, enter the name.
3. Confirm that the **Name** field shows a required marker.
4. Complete the form action for the outcome:

   | If | Select or enter |
   |---|---|
   | You are submitting a valid addition or update | **OK**, then **Save**. |
   | The form reports `Name is required` | Enter a value in **Name**, then select **OK** and **Save**. |
   | The form reports `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **OK** and **Save**. |
   | You are leaving without submitting | **Cancel**. |

For the worked example, enter a name that identifies the competitor-won outcome before the offer
is marked lost.

![The Lost Reason form with Save in the popup footer](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0cf2858808609a05b925d3ae19728555.png)

**Result:**

After a successful addition, the page reports `Data saved Successfully`; after an update, it reports
`Data updated Successfully`.

### Remove a reason

Remove a configured reason when it is no longer needed. The delete action runs only when more than
one item exists.

### Prerequisites

- You are on the **Lost Reasons** list.
- More than one item exists.
- Delete permission is available.
- The row to remove is selected.

### Steps

1. In the selected row, select **Delete**.
2. Read the confirmation message: `Are you sure you want to delete this item?`.
3. Select **Delete** to remove the selected item after confirmation.
4. To keep the selected reason, select **Cancel**.

If the selected reason is related to saved data, the deletion reports
`Related to Saved data, Can't be deleted`. If deletion fails for another reported failure, it
reports `Failed to Delete`. If only one item exists, the list reports `Must have at least one
item` instead of allowing the last item to be removed.

**Result:** Select **Delete** to remove the selected reason; select **Cancel** to leave it unchanged.

### Export the list

### Prerequisites

- You are on the **Lost Reasons** list.
- Export permission is available.

### Steps

1. Select **Export**.
2. In the export dialog, choose the required export options.
3. Start the export from the export dialog footer.

**Result:**

The export is started from the export dialog footer. That completes this procedure.

## Handle access and list variations

The shared configuration list adapts to company configuration and permissions, so the controls
and fields available to you can differ from another account.

| Variation | What controls it |
|---|---|
| Available list columns | The configured columns. |
| Fields in the form | A field appears only when it is configured as visible in the form. |
| Required marker | The field configuration marks the field required. |
| **New** | Permission for creating items. |
| Edit control in the selected row | Permission for editing items. |
| Delete control in the selected row | Delete permission and the requirement that more than one item exists. |
| **Export** | Export permission. |
| **Import** | Import permission. |

The Sales configuration navigation can also show these sibling labels:

| Related loss or cancellation lists | Other Sales configuration lists |
|---|---|
| **Lost Reasons** | **Units** |
| **Regret Reasons** | **Delivery Terms** |
| **Cancellation Reasons** | **Payment Methods** |
| **Order Cancellation Reasons** | **Guarantee Types** |
|  | **Account Types** |
|  | **Offer Status** |
|  | **Order Status** |
|  | **Inquiry Status** |
|  | **Activity purpose** |
|  | **Order activation conditions** |
|  | **Additional costs** |
|  | **Mark up Items** |

For related maintenance, see [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), and [Order Cancellation
Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons).

## Out of scope

The import flow is outside the procedures on this page. When the import completes, the page
reports `Data Importing completed`.

## When maintenance does not work

Match the message or screen symptom to the action that produced it.

| What you see | What it means | What to do |
|---|---|---|
| `Name is required` | The required **Name** field has no value. | Enter a value in **Name** and submit the form. |
| `Data saved Successfully` | A new reason has a save-success response. | Return to the list and use the configured rows. |
| `Data updated Successfully` | An edited reason has an update-success response. | Return to the list and use the configured row. |
| `Data Deleted Successfully` | The selected reason has a delete-success response. | Continue with the remaining configured rows. |
| `Related to Saved data, Can't be deleted` | Saved data is related to the selected reason. | Keep the reason available for that saved data. |
| `Failed to Delete` | The delete operation failed. | Keep the reason and investigate the failed deletion before retrying. |
| `Must have at least one item` | The list contains only one item. | Keep at least one reason in the list. |
| The page remains in a loading view while the list is unavailable. | The list has not become available. | Wait for the list to become available before maintaining a reason. |

## Continue after maintaining lost reasons

A lost record carries a selected lost-reason name. The wider sales-job lifecycle owns the
operational use of **Lost**; this page maintains the reference names.

After maintaining a name, continue in [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment)
when you need to work with the sales job that uses the reason. Use [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle)
when you need the wider flow around **Lost**. The shared configuration list also exposes sibling
reference lists, including [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), and [Order Cancellation Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons).
