# Items and Parts

When the plant starts making something new, Kanoa needs to know the item and how fast each machine makes it. This lesson
shows you how to add an item, link it to an asset with a rate, and add a part to the parts catalog.

Adding and editing items needs the **Configure Items** security function. Kanoa calls materials *items*.

## Add an Item

1. Open **Configuration → Ops → Materials**.
2. Click the add button.
3. Choose the **Item Class**, which works like a folder, and enter a unique **Item Name**.
4. Add a **Description** if you want one, and leave **Enabled** ticked.
5. Save.

![The item editor](https://docs.kanoa.ai/img/item-config/item-config.png)

For example, CoreForge could add a finished-good item named `SC-2024-STD-100` in the class `CoreForge\FG`.

:::warning
A disabled item can't be selected. An item used in past production runs can't be deleted. Kanoa disables it instead.
:::

::embed-section{src="../../configuration/materials.md#configuring-items" collapsed="true" summary="Reference Materials: Configuring Items - The fields on the item editor."}

## Link the Item to an Asset and Set Its Rate

An item can only be run on an asset once you link them. The rate tells Kanoa how fast the asset should run it.

1. On the **Materials** screen, open the **Production Rates** tab.
2. Click the link button to open the **Item Asset Link Editor**.
3. Select the asset, such as **Manual Pack 1**, and the item. Check the **output** option, because the item is a product
   the asset makes.
4. Select the new rate in the table and click the edit button.
5. Enter the **Standard Rate**, **Scheduled Rate**, **Period** and **Units**, and save.

![Production Rates](https://docs.kanoa.ai/img/item-config/configMaterials.png)

- **Standard Rate** is the speed the asset should reach. It drives the OEE performance figure.
- **Scheduled Rate** is the speed you expect in practice. Kanoa uses it to estimate how long an order takes.
- **Package Count** is how many infeed units make one outfeed unit.

For CoreForge, **Manual Pack 1** might run `SC-2024-STD-100` at a standard rate of 60 and a scheduled rate of 50 per
**Minute**, with a package count of 100.

:::tip
If you select several rates, you can change one field, such as **Standard Rate**, for all of them at once.
:::

{/*
TODO: confirm on a gateway the exact label of the link and edit buttons on the Production Rates tab. The Developer
Training lesson calls the edit button "Edit Asset Item Rate Info".
*/}

::embed-section{src="../../kanoa-ops/items/item-rates.md" collapsed="true" summary="Reference Materials: Production Rates - Link items to assets and set their rates."}

## Add a Part to the Parts Catalog

This section needs **Kanoa Inventory**, which is licensed separately, and applies only if **Enable Kanoa Inventory** is
on (see the [track overview](./index.md)). Without a license, Kanoa Inventory only runs in trial mode.

1. Open **Inventory → Parts**.
2. Click **Add** (or the **+** button) to open the **Part Editor**.
3. Enter the **Part #**, **Category**, **Description**, **Manufacturer** and **Default UOM**.
4. Tick the flags that apply, such as **Is Critical** or **Is Consumable**.
5. Click **Save**.

If the manufacturer or unit of measure isn't in the lists, add it first in **Configuration → Inventory**. To retire a
part without deleting it, untick **Enabled**.

{/*
TODO: confirm on a gateway which security function the Inventory screens need. The inventory docs don't name one.
*/}

::embed-section{src="../../kanoa-inventory/inventory-config.md#adding-a-part" collapsed="true" summary="Reference Materials: Adding a Part - The fields on the Part Editor."}

## Check Your Understanding

1. Which function do you need to add an item?
2. You've added an item. What else must you do before an asset can run it?
3. What does the **Standard Rate** drive?

<details>
<summary>Answers</summary>

1. **Configure Items**.
2. Link the item to the asset on the **Production Rates** tab and set its rate.
3. The OEE performance calculation.

</details>
