# Product types

## Product types

A product type is a company reference entry that identifies a type used when
managing product records. The **Product Types** page is in **Configuration** under
**Company**.

Use this page to find, add, change, delete, or export product types.

| If you need to… | Go to |
| --- | --- |
| Find the list or identify an entry | [Find a product type](#find-a-product-type) |
| Read the list and its actions | [Understand the product-type list](#understand-the-product-type-list) |
| Add, change, or remove an entry | Maintain product types |
| Save the list in another format | [Export the product-type list](#export-the-product-type-list) |
| Review the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) |
| Maintain neighbouring company reference data | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) |

## Before you start

You need access to the product-type configuration area. Your administrator assigns
separate permissions for creating, changing, deleting, and exporting entries.

| Before you start | Why it matters |
| --- | --- |
| Permission to create entries | **New** appears only when your account can create entries. |
| Permission to change entries | The **Edit** icon appears only when your account can change entries. |
| Permission to delete entries | The **Delete** icon appears only when your account can delete entries. |
| Permission and subscription for exports | **Export** appears only when your account has export access and the company subscription includes list exports. |
| The product-type name to enter or change | **Save** accepts a non-empty value in **Type**. |

The form must finish an earlier save before it accepts another one. Keep the entry
information ready before selecting **Save**.

> **Note:** The list uses the visible **Name** value to identify an entry. Separate
> icons change or delete the entry.

## Find a product type

Find the list before choosing a product-type action.

**Prerequisites**

- You are signed in and can open the company configuration area.
- You know enough of the product type to recognise its **Name** value.

**Steps**

1. Open **Company** in the configuration area.
2. Open **Configuration**.
3. Select **Product Types**.
4. Check that the heading reads **Product Types**.
5. Use the **Name** column to identify the entry you need.
6. If the list needs reloading, select **Refresh**.
7. If you need list settings, select **Settings**.

The list contains six rows. The **New** button is visible when your current
permission configuration allows it.

![Find the Product Types heading, the six entries under Name, and the New, Refresh, and Settings controls.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/21f36e67c98ccaadd85c62b86b44c3fd.png)

**Result:** The Product Types list is open. Continue to [understand the list](#understand-the-product-type-list),
or select **New** to add an entry.

## Understand the product-type list

The product-type list is reference data. **Name** is the only visible data column,
and the icons beside an entry provide its available actions.

| List part | What you use it for |
| --- | --- |
| **Keyword to Search...** | Enter a keyword to search the list. |
| **Name** | Read the product-type value. |
| Entry action icons | Change or delete an entry. |
| List editing | Use the page actions to add, change, or delete entries. |

![Search by keyword, read the Name column, and locate the icons beside each entry.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9d5a76f87473267ed874894aa87c843f.png)

**Result:** You can select the action that matches your task in Maintain product types.

## Add, change, delete, and export product types

Choose the task that matches the entry you need to maintain.

| If you need to… | Select | What opens | Access condition |
| --- | --- | --- | --- |
| Create an entry | **New** | A new product-type form | Create permission |
| Change a saved entry | **Edit** icon | The selected entry in the form | Change permission |
| Remove a saved entry | **Delete** icon, then **Delete** | The deletion confirmation | Delete permission |
| Save a copy of the list | **Export** | The export list dialog | Export access and the company subscription for list exports |

The form uses **Type** for the product-type value.

### Add a product type

Add a product type when a product record needs a type that is not already in the list.

**Prerequisites**

- You are on the Product Types list.
- **New** is available to you.
- You have a non-empty product-type name ready to enter.

**Steps**

1. Select **New**.
2. In the active product-type form, enter the value in **Type**.
3. In the save popup, choose one action:

   | If you need to… | Select |
   | --- | --- |
   | Save the entry | **Save** |
   | Leave without creating the entry | **Cancel** |
   | Correct an empty value | Enter a value in **Type**, then select **Save** after `Can't save empty items` appears |

4. After saving, look for `Data saved Successfully`.

The save action proceeds only when **Type** contains a value and the previous save
has finished.

![Select New from the Product Types list to open the entry form.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/21f36e67c98ccaadd85c62b86b44c3fd.png)

**Result:** A saved entry is reported with `Data saved Successfully`, or the save
popup closes without saving when you select **Cancel**.

### Change a product type

Change a product type when its **Name** value needs correction or updating.

**Prerequisites**

- You are on the Product Types list.
- You have identified the entry to change.
- **Edit** is available to you.

**Steps**

1. Beside the entry you identified, select the **Edit** icon.
2. In the product-type form, change the value in **Type**.
3. Choose one action:

   | If you need to… | Select |
   | --- | --- |
   | Keep the change | **Save** |
   | Discard the change | **Cancel** |

4. After saving, look for `Data saved Successfully`.

**Result:** The selected product type is saved with the changed **Type** value, or
the popup closes without saving when you select **Cancel**.

### Delete a product type

Delete a product type when the selected entry is no longer needed.

**Prerequisites**

- You are on the Product Types list.
- You have identified the entry to remove.
- **Delete** is available to you.

**Steps**

1. Beside the entry you identified, select the **Delete** icon.
2. In the delete menu, select **Delete**.
3. Read `Are you sure you want to delete this item?`.
4. Select **Delete** to confirm the deletion.
5. After the deletion completes, look for `Data Deleted Successfully`.

**Result:** The selected product type is deleted and `Data Deleted Successfully`
appears.

### Export the product-type list

Export the product-type list when you need a file version of its entries.

**Prerequisites**

- You are on the Product Types list.
- **Export** is available through export access and the company subscription for list exports.

**Steps**

1. Select **Export**.
2. In the `Exporting List:` dialog, choose one format:

   | If you need… | Choose |
   | --- | --- |
   | An Excel file | **Export to Excel** |
   | A PDF file | **Export to PDF** |

3. In the export dialog, choose one action:

   | If you need to… | Select |
   | --- | --- |
   | Start the export | **Export** |
   | Leave without exporting | **Cancel** |

**Result:** The export dialog closes after you select an export choice and **Export**,
or closes without exporting when you select **Cancel**.

## When an action is unavailable

Actions appear according to your permissions, company display settings, and
subscription access.

| What you do not see | Condition that controls it | What to check |
| --- | --- | --- |
| **New** | Your account cannot create entries | Ask an administrator to grant create access. |
| **Edit** icon | Your account cannot change entries | Ask an administrator to grant change access. |
| **Delete** icon | Your account cannot delete entries | Ask an administrator to grant delete access. |
| Row-filter controls | Row filtering is not enabled in the list settings | Check the list display settings. |
| **Export** | Export access or the company subscription for list exports is unavailable | Ask an administrator to check both. |
| Import | This list does not provide an import action | Use the available product-type actions instead. |

## When something goes wrong

Use the message on screen to choose the next action. The form does not show a
separate required-field message beside **Type**.

| What you see | What to do |
| --- | --- |
| `Can't save empty items` | Enter a value in **Type**, then select **Save**. |
| An error appears after saving | Read the error details shown by the alert, then correct the reported problem or ask an administrator to review it. |
| An error appears after deleting | Read the error details shown by the alert, then verify that the selected entry is still available before trying again. |
| No required-field message appears beside **Type** | Use the save result or alert rather than waiting for a separate field message. |

If saving or deleting fails, the alert displays the returned error details rather
than a fixed product-type message. The screen does not provide a separate
validation summary or save-status message for these failures.

## After managing product types

After a successful save, look for `Data saved Successfully`. After a successful
deletion, look for `Data Deleted Successfully`.

Product types are company reference data used while managing products. Continue to
Products when you need to apply a product type to a product record, or use [Product
categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) for the neighbouring
company reference list.
