# Products

Use this page to find a product, record its reusable item information, and review a saved
product's details.

## Products at a glance

A product is a reusable item record that you select when other PAMS work asks for a
product. The **Products** list is where you find item records, and the product record is
where you enter or review one item.

| If you need to… | Go to |
|---|---|
| Find an existing item or open a new record | [Find a product](#find-a-product) |
| Understand the columns and controls in the item list | [Read the Products list](#read-the-products-list) |
| Enter or change the item information | [Create or update a product](#create-or-update-a-product) |
| Review comments, suppliers, stock, variants, files, or history | [Manage product details](#manage-product-details) |
| Add components to an assembled item | [Add components to an assembled product](#add-components-to-an-assembled-product) |
| Resolve a product message | [When a product action fails](#when-a-product-action-fails) |
| Maintain product types, files, or stock-related work | [What to do next](#what-to-do-next) |

Record each product with the name, units, description, withdrawal choice, and valuation
that belong to that item.

![The Products list with its product rows and visible columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/52ef1d61b718866aec3c5d900b9d3ca1.png)

## Before you start

Before you look for or record a product, confirm the following conditions.

| Have or know | Why it matters |
|---|---|
| Access to the Products area | The list opens only when the application grants access to the list. |
| A subscription that includes product creation | **New** is available only when the subscription is included, the list is open, and its data is loaded. |
| The saved product you want to review | **Comments**, **Sub-suppliers**, **Stock Details**, and **Last Modifications** belong to an existing product record. |
| The item's identifying and commercial information | The record asks for a name, category, group, sales unit, purchase unit, description, withdrawal option, and valuation. |
| The product type options you need | Product Type options are maintained on [Warehouse products types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-purchasing-product-types), not on this page. |

The available option values for **Product Type**, **Group**, units, **Product Withdrawal**,
and **Product Valuation** depend on the lists available to the form. Select from the values
shown in your product record rather than assuming that another product's options are
available.

## Find a product

The Products list is the starting point for opening an existing item record or the form
for a new one.

**Prerequisites**

- You have access to the Products area.
- The product list can load its data.

**Steps**

1. Open **Products**.

   ![The Products list after it opens, with product rows visible.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1e9057ba06e362efb3df8794d04de228.png)

2. Choose the route that matches your task.

   | If you need to… | Select |
   |---|---|
   | Open an existing item | Select the product row you need. |
   | Start a product record | Select **New**. |

3. If the list requires fresh data, select **Reload data**.

4. If you opened a new record, continue with [Create or update a product](#create-or-update-a-product).

**Result:** The Products list is open with product rows, an existing product record is
open, or the new-product surface is open.

The new-product surface shows the product fields and save controls.

## Read the Products list

The Products list is a row-based view of reusable item records. Read the headers that are
actually visible in your list because the list layout determines which columns it draws.

The Products list shows these seven columns in this order:

| Order | Column |
|---:|---|
| 1 | **Product** |
| 2 | **Description** |
| 3 | **Category** |
| 4 | **Group** |
| 5 | **Withdrawal** |
| 6 | **Valuation** |
| 7 | **Internal product no.** |

The list also shows three titled icon buttons.

| Visible control | Use |
|---|---|
| **Refresh** | Refresh the list view. |
| **Table Layout** | Work with the list layout. |
| **Settings** | Open the list settings surface. |

**Steps**

1. Choose the list action that matches your task.

   | If you need to… | Select or use |
   |---|---|
   | Change the layout | **Table Layout**, then **Columns Chooser** or **Expand column width**. |
   | Show or hide list grouping or filters | **Filter Row** or **Group Panel**. |
   | Export the list | **Export**. |

**Result:** The list uses the selected layout or filter settings, or the selected export
option is open.

### Export the list

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

**Result:** The selected list format export starts.

Your list can instead use **Internal Product No.**, **Product Type**, **Group**, **Sales
Unit**, **Purchase Unit Of Measure**, **Weight (kg)**, **Volume (m3)**, **Barecode**,
**External product id**, **Description**, **Product Withdrawal**, and **Product Valuation**.
Use the headers on your screen when identifying a row. The selected layout determines the
columns shown.

## Create or update a product

The product record holds the reusable item's identifying, unit, description, withdrawal,
and valuation information. Use the new-product form to create a record or the same surface
to change an existing item where editing is allowed.

**Prerequisites**

- You are on the new-product surface or an editable product record.
- You have the item's name, category, group, sales unit, purchase unit, description,
  withdrawal choice, and valuation information.

**Steps**

1. Enter the item name in **Name**.
2. Select the item's category in **Category**.
3. Select the item's group in **Group**.
4. Select the sales unit in **Sales Unit**.
5. Select the purchasing unit in **Purchase Unit Of Measure**.
6. Enter the item description in **Description**.
7. Select the withdrawal option in **Product Withdrawal**.
8. Complete **Product Valuation** when it is available on your form.
9. Enter **Internal Product No.**, **Weight (kg)**, **Volume (m3)**, **Barecode**, or
   **External product id** when those details apply to the item.
10. Choose the save route.

    | If you need to… | Select |
    |---|---|
    | Save the product and remain on the record | **Save** |
    | Save the product and leave the record | **Save and Close** |

**Result:** The product surface contains the entered fields and the selected save controls.

![The new-product form with its required fields and save controls.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c82be608bc78cab07042e7514c0fa3aa.png)

## Manage product details

A saved product record groups related information in tabs and detail surfaces. Use the
surface that matches the information you need to review.

| Detail you need | Select or use |
|---|---|
| Product comments | **Comments** |
| Products from other accounts | **Sub-suppliers**; the sub-supplier selection comes from account records. See [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts). |
| Warehouse quantities and stock thresholds | **Stock Details**; see [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). |
| Changes made to the record | **Last Modifications** |
| Product variants | **Variants** when that saved-record surface is available. |
| Product files and attachments | Use the shared file surface; see [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files). |

**Comments**, **Sub-suppliers**, **Stock Details**, and **Last Modifications** require an
existing product record. **Stock Details** covers quantities by warehouse, including stock,
committed quantities, quantities on the way, and minimum quantities. The detail form also
contains fields for variant, stock-detail, and sub-supplier surfaces, including **Name**,
**Description**, **Inventory**, **Branch**, **Min. Stock Qty.**, **Min. Requisition Qty.**,
**Sub-supplier**, **Country**, **Identification No.**, **Weight (kg)**, **Short Description**,
and **Material Description** where their respective surface is available.

The shared file surface carries **Library name**, **File Name**, **Links**, and **Comment**.
Use [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for file upload, download, linking, renaming, and tag
management.

## Add components to an assembled product

A bill of material is the list of component products that make up an assembled product.
Selecting the assembled group exposes the **Bill of Material** surface on the product
record.

**Prerequisites**

- You are recording or editing a product.
- The product group includes the assembled choice.
- You know the component product and its quantity.

**Steps**

1. Select the assembled option in **Group**.
2. Open **Bill of Material**.
3. Select **Product** to add a component.
4. Enter the component quantity in `BOM Qty`.

**Result:** The assembled product has a bill-of-material component entry with its product
and quantity. A BOM quantity cannot be less than `1`.

## When a product action fails

Match the message on screen to the correction in this table.

| Message | What to do |
|---|---|
| `An error occurred while processing your request` | Check the product information and repeat the action. Escalate the message with the product and action details if it continues. |
| `An error occurred while connecting to your CRM system.` | Check the CRM connection path used by your organisation and escalate if the connection remains unavailable. |
| `Please select one product` | Select one product before continuing. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value and repeat the action. |
| `This product is already included in BOM` | Do not add the same product again to that bill of material. |

If a required field is incomplete, correct the fields marked required on the form before
trying the action again. Use the message shown by your form as the immediate correction
signal.

### Out of scope

When the **Variants** surface is active, `The first variant cannot be deleted` means keep the
first variant and work with the other variant records.

## What to do next

Continue with the page that owns the next piece of work instead of maintaining it from the
Products form.

| If you need to… | Go to |
|---|---|
| Maintain the values offered as Product Type options | [Warehouse products types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-purchasing-product-types) |
| Upload, link, or otherwise manage product files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) |
| Maintain a sub-supplier account record | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) |
| Follow stock quantities through warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Return to the reusable item records | [Products at a glance](#products-at-a-glance) |

Other PAMS work selects products when it needs a reusable item.
