# Warehouse product types

Use this page to review and maintain the Warehouse product types reference list used for
purchasing product information and related MRQ records.

## Before you start

Warehouse product types are the named types available to purchasing product information and MRQ
records. The page belongs to **Warehouse** and is titled **Warehouse products types**.

| If you need to… | Go to |
|---|---|
| Open the list | [Find the Warehouse product types list](#find-the-warehouse-product-types-list) |
| Identify the visible list and entry fields | [Understand the list and entry fields](#understand-the-list-and-entry-fields) |
| Create, change, delete, or export a type | [Maintain the list](#maintain-the-list) |
| Correct a message or blocked action | [When maintenance does not work](#when-maintenance-does-not-work) |
| Continue to related configuration | [Continue with related configuration](#continue-with-related-configuration) |

You must be signed in to open this page.

| Surface or action | When it is available |
|---|---|
| Main grid | The subscription includes the feature. |
| **New** | The subscription includes the feature and the new-entry button is available. |
| Edit action | Edit permission is available and the subscription includes the feature. |
| Delete action | Delete permission is available. |

The actions visible to you depend on your subscription and permissions. Use the controls that
appear on your page.

## Find the Warehouse product types list

Open the Warehouse product types page and confirm its heading.

**Prerequisites**

- You are signed in.
- Your subscription includes the Warehouse product-type feature.

**Steps**

1. Open the Warehouse product types page.
2. Confirm that the page heading is **Warehouse products types**.

![The Warehouse products types page with its heading, list, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5e8b143edbcbf1ef41f9b81d9b15f0c6.png)

**Result:** The Warehouse product types list is open.

## Understand the list and entry fields

The list shows product-type records under the **Type** column. Its controls are **New**,
**Refresh**, and **Settings**.

| Surface | What you see | What you use it for |
|---|---|---|
| Main list | **Type** | Identify each product-type record. |
| List toolbar | **New** | Open a new-entry popup when it is available. |
| List toolbar | **Refresh** | Refresh the list. |
| List toolbar | **Settings** | Open list settings. |
| New-entry popup | **Type** with a required marker | Enter the product-type name. |
| New-entry popup | **OK** | Submit the visible popup action. |

Selecting **New** opens a popup titled `New Warehouse product type` for a Warehouse product type.

![The Warehouse products types list with the Type column and New, Refresh, and Settings controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/afc91a498ce52ef497d866aab5f60911.png)

The entry form contains the required **Type** field. No other entry fields are presented for you
to complete.

| Field | What you see in the entry form | Reader use |
|---|---|---|
| **Type** | Visible and required | Enter the product-type name. |
| Other record details | Hidden | — |

Use the labels and columns visible in your list. Generic controls for other reference entities
are not part of this list.

> **Note:** Work from the **Type** header and the controls visible in your list. The shared
> configuration surface can present different controls for other reference entities.

![The New Warehouse product type popup with the required Type field and OK action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c1de4a42af8e5b8e6237cbc9643abeb5.png)

## Maintain the list

Choose the path that matches your task. Action availability follows the conditions in [Before
you start](#before-you-start); use a control only when it appears on your list.

| If you need to… | Select or open | Then |
|---|---|---|
| Add a type | **New** | Enter the name in **Type**, then select **OK** or **Save**, as shown. |
| Change a type | The row's edit control | Update **Type**, then select **Save**. |
| Leave a save popup | **Cancel** | Close the popup without submitting. |
| Delete a type | The row's delete control | Read the confirmation, then select **Delete**, or select **Cancel**. |
| Export the list | The list action that provides **Export** | Select **Export**. |

**Prerequisites**

- For a new entry, the subscription includes the feature and **New** is visible.
- For an existing entry, edit access is available and the row exposes its edit control.
- For deletion, delete permission is available and the row exposes its delete control.
- You have the product-type name to enter when adding or changing a type.

**Steps**

1. Select the control or open the list action that matches your task in the table above.
2. Enter or update the value in **Type** when the form is shown.
3. Select the popup action shown for the task.
4. If you are deleting an entry, read `Are you sure you want to delete this item?` before selecting
   **Delete**.
5. If you are leaving a popup or cancelling a deletion, select **Cancel**.

The **Type** field is required. Use the success or validation messages in [When maintenance does
not work](#when-maintenance-does-not-work) when they appear after a maintenance action.

**Result:** The selected add, edit, delete, export, or cancel action is submitted or closed; check
the result after completing a save, update, delete, or export action.

## Add, edit, delete, or export an entry

These actions are separate paths. Their availability follows the conditions in [Before you
start](#before-you-start); use an action only when its control appears on your list.

### Add an entry

**Prerequisites**

- The subscription includes the feature.
- **New** is visible.

**Steps**

1. Select **New**.
2. Enter the product-type name in **Type**.
3. Select the popup action shown for the new entry: **OK** or **Save**.

   **Confirmation:** If **Type** is empty, the form shows `Type is required`.

**Result:** The new-entry popup submission has been requested.

### Edit an entry

**Prerequisites**

- The subscription includes the feature.
- Edit permission is available.
- The row exposes its edit control.

**Steps**

1. Select the row's edit control.
2. Update the value in **Type**.
3. Select **Save**.

**Result:** The selected row's edit-popup submission has been requested.

### Delete an entry

**Prerequisites**

- Delete permission is available.
- The row exposes its delete control.

**Steps**

1. Select the row's delete control.
2. Read `Are you sure you want to delete this item?`.
3. Select **Delete** to confirm the deletion.
4. If you decide not to remove the row, select **Cancel**.

**Result:** The deletion confirmation menu closes after **Delete** or **Cancel**.

### Export the list

**Prerequisites**

- The Warehouse product types list is open.
- The list exposes the export selection.

**Steps**

1. Open the list action that provides **Export**.
2. Select **Export**.

**Result:** The export selection is submitted.

## When maintenance does not work

| Message | What to do |
|---|---|
| `Type is required` (the generic message is formed from the configured caption) | Enter a value in **Type**. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then submit the form again. |
| `Data saved Successfully` | Check the list for the new type. |
| `Data updated Successfully` | Check the selected row for the changed type. |
| `Data Deleted Successfully` | Check the list for the deleted row. |
| `Related to Saved data, Can't be deleted` | Keep the row and review the saved data related to it. |
| `Failed to Delete` | Do not repeat the deletion until you review the row and its deletion conditions. |
| `Must have at least one item` | Keep at least one item in the list. |

Use the exact message shown on screen when one of these conditions occurs.

"Server error text parsed by AppSettings.ParseError". Read the server text shown with the error
and follow the instruction it gives.

## Continue with related configuration

The shared configuration surface serves multiple reference entities; use the page that matches
your next task:

- [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) for product records and product information.
- [Purchase-job work lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) for active purchasing work.
- [Warehouse product stages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-product-stages) for a related Warehouse
  reference list.
