# Production Orders

A production order is work that needs to be done: what item to make, how much, when it's due and what status it's in.
Your plant may call it a work order, job or manufacturing order. In most plants, orders come from the ERP and arrive in
Kanoa. You can also create one by hand.

## Open Production Orders

Open **Ops → Scheduling → Production Orders** from the navigation menu.

![The Production Orders screen](https://docs.kanoa.ai/img/orders/orderManagement.png)

## Review Orders from the ERP

Orders sent from the ERP appear in the same table as orders you create.

1. Filter the list by **due date** and **status** to narrow it down. An order with no due date always shows, whatever date
   range you choose.
2. Select the **Show Actual** checkbox to see how much of each order has been produced, across all its runs and assets. This
   slows the screen, so turn it off when you don't need it.
3. Click the left arrow on an order's row to expand it. You'll see its **Order Info**, its **Schedule Info**, and one tab for
   each extra piece of information attached to the order, such as a bill of materials.

Check that the item, quantity and due date are what you expect, and that the order's status lets it be scheduled.

### Order Statuses

| Status | What it means |
| --- | --- |
| **Released** | The order is released to production. |
| **Scheduled** | The order has been scheduled on an asset. |
| **In Progress** | A run has started on the order, or it's part complete. Kanoa sets this itself. |
| **Closed** | The order is closed. |

Your plant can add its own statuses. Whether a status lets an order appear on the schedule or be started on an asset is set
by your administrator.

## Create an Order

1. Click the **+** button.
2. Enter the **Order #**, a unique identifier.
3. Use the item selector to choose the **Item** to make.
4. Enter the **Qty** and the **Units**. The units should match the units set for that item on that asset.
5. Optionally set a **Due Date**.
6. Set the **Status**, which says whether the order is released to production or held.
7. Add **Notes** for the people running the order, then save.

![The order editor](https://docs.kanoa.ai/img/orders/orderEditor.png)

To change an order, select it in the table and click the **Edit** button. To remove one, select it and click the **Delete**
button.

{/*
TODO: Confirm on a gateway which security function, if any, is needed to create, edit and delete orders. The docs name
Schedule Shifts and Schedule Operations but none for orders. Also confirm the name of the save button in the order editor.
*/}

::embed-section{src="../../kanoa-ops/order-management.md#creating-orders" collapsed="true" summary="Reference Materials: Creating Orders - Every field in the order editor."}

## Check Your Understanding

1. Where do production orders usually come from?
2. An order has no due date. Will it show if you filter by a date range?
3. Which checkbox shows how much of an order has been produced?

<details>
<summary>Answers</summary>

1. The ERP, which sends them to Kanoa.
2. Yes. An order with no due date is included whatever date range you select.
3. **Show Actual**.

</details>
