# Storeroom Tasks

These tasks keep the storeroom's numbers honest: what came in, what was found on the shelf, and what's running low. Every
change is a transaction in the part's history, so you can always see who changed what and when.

:::info[Needs Kanoa Inventory]
Parts, stock and storerooms are part of **Kanoa Inventory**, which is licensed separately from Kanoa Maintenance. Your
gateway needs a Kanoa Inventory license, and an administrator must turn it on (**Enable Kanoa Inventory**, under
**Configuration → Application → Settings**). Without a license it only runs in trial mode. If your plant doesn't have it,
skip this lesson.
:::

## Receive a Delivery

When parts arrive from a supplier, record a receipt.

1. In **Inventory → Parts**, expand the part that arrived.
2. Click **Add Part Transaction** (the **+** icon in the Parts Inventory toolbar).
3. In the **Part Inventory Editor**, pick the **Inventory Location** that received the stock, such as the Parts Room.
4. Enter the **Qty** received. It must be more than 0.
5. Set **Transaction Type** to `Receipt to inventory`.
6. Add a **Lot / Batch** number if you have one, and the purchase order number in **Notes**, such as `PO-2026-0101`.
7. Click **Save**.

On Hand updates straight away.

{/*
TODO: Confirm on a gateway what happens when the part has no stock yet at a location, such as the first delivery of a new
part. The Developer Training says to receive stock first, then set the policy. Confirm the Inventory Location list then
offers the storeroom.
*/}

::embed-section{src="../../kanoa-inventory/inventory-guide.md#receiving-stock" collapsed="true" summary="Reference Materials: Receiving Stock - The fields in the Part Inventory Editor."}

## Adjust a Count After a Cycle Count

A cycle count is a physical count of a part on the shelf. If it differs from what Kanoa shows, record the difference.

1. Expand the part and click **Add Part Transaction**.
2. Pick the location, and enter the **Qty** as the difference. If Kanoa shows 12 and you count 2, enter `10`.
3. Set **Transaction Type** to `Negative adjustment` if you found less, or `Positive adjustment` if you found more.
4. In **Notes**, enter `Cycle count`, and click **Save**.

Never try to edit an old transaction. The history can't be changed, so an adjustment is how you correct it. The history
records who made the adjustment and when.

The **Cycle Count** column in the expanded row shows how many days there should be between counts for that part.

::embed-section{src="../../kanoa-inventory/inventory-guide.md#transfers-and-adjustments" collapsed="true" summary="Reference Materials: Transfers and Adjustments - Correct a balance or move stock between locations."}

## Find Parts to Reorder

Each part can have a stocking policy at a storeroom. It sets a **Reorder Point**, a **Reorder Qty** and a **Safety Stock**.
You don't set these. You read them in the expanded part row.

1. Expand the part and compare **On Hand** with **Reorder Point**.
2. If On Hand is at or below the reorder point, the part needs ordering. **Reorder Qty** says how many.
3. Check **On Order**. If an order is already open, you may not need another.
4. If On Hand is below **Safety Stock**, tell your supervisor, because that's an urgent shortage.

For example, CoreForge's coolant filters have a reorder point of 6 and a reorder quantity of 12. After a count leaves 2 on
the shelf, the part is below its reorder point.

To see every part that needs ordering at once, use a dashboard with the **Needs Reordering** widget. It lists each stocked
part below its reorder point. The **Reorder Status Donut** and **Critical Spares Watchlist** widgets give the same picture
at a glance. Ask your Maintenance Manager or administrator to add them to your dashboard if they aren't there.

{/*
TODO: The docs describe no screen for placing a purchase order, so the lesson ends at deciding what to order. Confirm on a
gateway what the Needs Reordering widget shows (columns, whether it filters by storeroom).
*/}

:::note
Parts need a stocking policy and a stocked flag at the storeroom before reorder alerts work. If a part's policy columns are
empty, ask your Maintenance Manager to set one.
:::

::embed-section{src="../../kanoa-inventory/inventory-guide.md#stock-visibility" collapsed="true" summary="Reference Materials: Stock Visibility - On Hand, Reserved, On Order and the policy columns."}

## Check Your Understanding

1. A delivery arrives. Which transaction type do you use?
2. Kanoa shows 12 filters but you count 2. What do you record?
3. How do you tell a part needs reordering?

<details>
<summary>Answers</summary>

1. `Receipt to inventory`.
2. A `Negative adjustment` of 10, with a note such as `Cycle count`.
3. On Hand is at or below its **Reorder Point**. **Reorder Qty** says how many to order.

</details>
