# Delivery terms

Delivery terms are named choices and codes that administrators maintain for use in sales work.
Use them to keep the choices and labels used in sales work consistent.

## Before you start

You need a signed-in user, access to the subscribed configuration, and the name and code to enter.

| Before you start | Why it matters |
|---|---|
| Sign in to the application. | The Delivery terms screen requires a signed-in user. |
| Confirm that your subscription includes this configuration. | The list appears when the subscribed feature includes it; otherwise the screen shows the subscription-upgrade surface. |
| Confirm that you can create, edit, or delete entries as needed. | **New**, the edit control in a row, and the delete menu each depend on the corresponding permission. **New** also depends on the list data being loaded. |
| Prepare the term name and code. | **Name** and **Code** are required fields. |

Open the list first. Then choose whether to review its fields, add or edit an entry, or delete one.

## Find the Delivery terms list

Open the Delivery terms entry from the application's configuration navigation.

**Prerequisites**

- You are signed in and have access to the subscribed configuration.

**Steps**

1. Open the Delivery terms entry in the configuration navigation.
2. Review the rows in the Delivery terms list.
3. Select an existing row when you need to work with it.

![Review the Delivery terms rows and the New, Refresh, and Settings actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/70f044cd8201c4feb243c86c26abb180.png)

**Result:** The Delivery terms list is on screen, and an existing row is selected when you need to
edit or delete it. Review the fields and shared actions before maintaining an entry.

## Understand the list and form

The Delivery terms screen has a list for choosing an entry and a form for maintaining its name and
code. The list displays these two columns:

| Visible column | Rule |
|---|---|
| Name | Required text box |
| Code | Required text box |

Other reference-list tabs belong to separate lists, not to Delivery terms.

The toolbar also includes **Export**, which opens export options, and **Add more**, which opens
another reference-list area.

> **Note:** The list displayed **Name** and **Code**. Use the headers visible on your screen.

![Identify the Name and Code columns and the shared list actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/211a61f02f2c0b3f6ffc13c4008a9767.png)

When you know which row and fields to use, add a new entry or edit the selected entry.

## Add or edit an entry

Both fields are required. Choose the task that matches the row you need to maintain.

| If you need to… | Use |
|---|---|
| Create a term | [Add a new entry](#add-a-new-entry) |
| Change a term | [Edit an existing entry](#edit-an-existing-entry) |

### Add a new entry

**Prerequisites**

- The Delivery terms list is open.
- You have permission to create entries.
- You have the term name and code.

**Steps**

1. Select **New**.
2. In the new-entry form, enter the term name in **Name**.
3. Enter the term code in **Code**.
4. Select **Save**.

If a required value is missing, the form can show these messages:

- `Name is required`.
- `Code is required`.

If a value contains a forbidden character, the form can show:

- `Forbidden characters detected. Please remove them and try again.`.
- `Just '_' '-' And '.' Characters Accepted`.

![Enter the required Name and Code values in the New Delivery Term form.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d3c5c48a16555134b199d59ce8a846a2.png)

**Result:** The form is open with the term name and code entered, or it displays the matching
validation message.

### Edit an existing entry

**Prerequisites**

- The Delivery terms list is open.
- You have permission to edit entries.
- The entry you want to change is visible in the list.

**Steps**

1. Select the edit control in the row.
2. Change the value in **Name** or **Code**.
3. Select **Save**.

The edit control copies the row into the selected item and opens the edit form. A successful save
uses the message `Data saved Successfully`; a successful update uses `Data updated Successfully`.

**Result:** The edit form opens with the selected row copied into the selected item. If a validation
message appears, correct the value before checking the deletion and access options.

### Leave the form

If you leave a form after changing a value, the leave-form prompt uses these messages:

- `Leaving Page`
- `Do you want to save your changes?`

**Prerequisites**

- The form contains a changed value.
- The leave-form prompt is open.

**Steps**

1. Choose how to leave the form:

   | If you need to… | Select |
   |---|---|
   | Keep the changes | **Save** |
   | Leave without saving the changes | **Don't Save** |

**Result:** The changes are kept or left unsaved according to your choice.

## Handle delete and access branches

Access and subscription settings determine which maintenance controls appear. Check what is available
before attempting a deletion.

| What you see | What it means |
|---|---|
| The **New** action is available | Creating entries is allowed and the list columns and data are loaded. |
| The edit control is available in the row | Editing entries is allowed. |
| The delete menu is available | Deleting entries is allowed. |
| The subscription-upgrade surface appears | The subscribed feature does not include this configuration. |

### Delete a selected entry

**Prerequisites**

- The Delivery terms list is open.
- You have permission to delete entries.
- More than one item exists when you select **Delete**.

**Steps**

1. Select the delete control in the row.
2. Select **Delete** in the delete menu.

The product can report `Data Deleted Successfully`, `Related to Saved data, Can't be deleted`,
`Failed to Delete`, or `Must have at least one item`, depending on the deletion result and the
number of items remaining.

**Result:** The selected row is submitted for deletion, or the applicable deletion message appears.
Use that message to correct a maintenance problem.

## When maintenance goes wrong

Use the message on screen to choose the correction that matches the problem.

| What you see | What to do |
|---|---|
| `Name is required` | Enter a value in **Name**. |
| `Code is required` | Enter a value in **Code**. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value. |
| `Just '_' '-' And '.' Characters Accepted` | Use only the accepted characters indicated by the message. |
| `Related to Saved data, Can't be deleted` | Keep the related entry or remove the saved data that prevents deletion. |
| `Failed to Delete` | The deletion did not complete; retry from the selected row or contact your administrator. |
| `Must have at least one item` | Keep at least one Delivery terms item. |

**Prerequisites**

- A maintenance message is displayed.

**Steps**

1. Read the maintenance message in the table.
2. If the message identifies a required or forbidden value, correct that value in **Name** or **Code**.
3. Select **Save** after correcting the value.
4. If the message concerns deletion, select the delete control in the selected row.
5. Select **Delete** to retry the deletion.

**Result:** The corrected value is submitted again, or the deletion is retried from the selected row.

## After maintaining Delivery terms

Sales work uses the maintained values in its own screens. Sibling tabs lead to other reference lists.

| If you need to… | Open |
|---|---|
| Maintain item units | [Item units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units) |
| Maintain payment methods | [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) |
| Maintain guarantee types | [Requested guarantee](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee) |
| Work with a sales job | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) |
| Continue to offers | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) |
| Continue to orders | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) |
