> For the complete documentation index, see [llms.txt](https://support.ordereazi.com/central/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ordereazi.com/central/warehouse-management/management/reason-codes.md).

# Reason Codes

Set up the reasons warehouse staff choose when they adjust stock, reject received stock, or close a client return.

When stock goes missing or a delivery is rejected, you need to know why, not just that the numbers changed. **Reason Codes** is the OrderEazi list of reasons your warehouse team chooses from when they change stock or reject it. Each change is saved with its reason, so your reports can show why stock moved.

### Before you start

You need **View and Use as Administrator** or **View and Use as Manager**, in the **Warehousing** permission group.

### Where reason codes are used

There's one list of reason codes, and every screen that asks for a reason uses it:

* **Stock level adjustments:** "Please select a reason for the adjustment".
* **Creating a stock level:** "Please select a reason for the Creation".
* **Receiving a Purchase Order:** "Please select a reason for the rejection", when stock is rejected.
* **Creating or editing a tripsheet (the list of deliveries for one driver's trip):** "Please select a reason for the adjustment".
* **Closing a client return:** "Please select a reason for closing".

Because the list is shared, write reasons that make sense wherever they appear. Or start each one with where it's used, such as "Adjustment: Damaged in storage".

### How to add a reason code

1. In the warehouse menu, select **Management** > **Reason Codes**.
2. Select **Add Reason**.
3. Enter a short **Reason Title**, up to 64 characters. This is what people choose from.
4. Enter a **Reason Description** that explains when to use it.
5. Select **Create**.

You'll see "ReasonCode \[title] has been added.", with the reason's title in place of \[title].

**Example:** Your stocktake finds 3 units of CHAIR-01 with broken legs in bin A-07. You add a reason with the **Reason Title** "Adjustment: Damaged in storage" and the **Reason Description** "Stock damaged while on the shelf, found during a count or pick". The stock controller adjusts the 3 units out and chooses this reason.

### How to change a reason code

1. In the reason's row, select the gear, then **Edit**.
2. Change the title or description.
3. Select **Save**.

The change also shows on past records that used the reason.

You can't delete a reason code. To retire one, change its title, such as "Do not use: Damaged in storage". Past records that used it show the new title too.

### Related pages

* [Stock Level Adjustments](/central/warehouse-management/stock/stock-level-adjustments.md): adjust stock with a reason
* [Purchase Orders](/central/warehouse-management/inbound/purchase-orders.md): reject stock when receiving