> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.claruswms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pre-Allocate Stock to a Sales Order

> Reserve specific available stock against a sales order before picking, then edit or release it when plans change. Pre-allocated stock is reserved for that order and is picked from exactly.

Pre-allocation lets you select available stock and pre-allocate it to a sales order before the order is sent to pick. Pre-allocated stock moves to a **Pre-Allocated** status, so no other order can allocate or pick it, and when you process picks the order is picked from exactly the stock you reserved.

Use it when you need to guarantee stock for an order that will be picked later, for example a key customer's delivery, while other orders keep flowing through the warehouse.

> [!NOTE]
>
> Pre-allocation is being rolled out gradually. If you can't see the **Pre-Allocate** button on your sales order lines, contact Clarus support.

## Before you start

* You need the **Pre-Allocations** ability with **Manage** access to pre-allocate, edit or release stock. With **Read** access only, you can see pre-allocations but the buttons are disabled. See [Permissions](#permissions).
* The sales order must be saved and have a status of **Pending**, **Pre-Allocated** or **Part Pre-Allocated**.

## Pre-allocate stock to an order line

You pre-allocate stock one order line at a time, from that line's **Pre-Allocate** button.

**1. Open the sales order**

Open the sales order from the **Sales Orders** data grid. If it's a new order, save it first — the **Pre-Allocate** button is disabled until the order is saved.

**2. Add the pre-allocation columns to the order lines**

The **Order Lines** grid doesn't show the pre-allocation columns by default. Use the Column Manager to add:

* **Pre-Allocate** — a button on each order line that opens the stock selection for that line.
* **Pre-Allocated** — how much of each line is pre-allocated, against its ordered quantity.

Save the view so the columns stay in place next time. See [Adding and removing data grid columns](https://documentation.claruswms.com/knowledgebase/reporting/data-grid-columns.md).

**3. Click Pre-Allocate on the order line**

Find the order line you want to pre-allocate stock to and click its **Pre-Allocate** button. The **Pre-Allocate Stock** window opens for that line's product, with a summary such as *0 of 10 pre-allocated, 10 remaining*.

**4. Select the stock to pre-allocate**

The **Available Stock** grid lists the stock records you can pre-allocate. For each one you want to use, type the quantity into its **Quantity To Pre-Allocate** field.

> [!WARNING]
>
> Don't confuse **Quantity To Pre-Allocate** with the **Quantity** column next to it. **Quantity** is how much the stock record holds, and is read-only. Only the quantities you enter in **Quantity To Pre-Allocate** are pre-allocated to the order line.

You can:

* Spread the line across several stock records.
* Take part of a stock record — the rest stays available. For example, if a pallet holds 20 and the line needs 5, pre-allocate 5 and the other 15 remain available to other orders.
* Enter decimal quantities.
* Pre-allocate less than the ordered quantity. The rest of the line is allocated as normal when you process picks.

The summary updates as you type to show how much you've selected against what remains on the line.

**5. Confirm**

Click **Confirm Pre-Allocation**. The selected stock is pre-allocated to the order line, the line's **Pre-Allocated** column updates and the order's status changes.

Repeat for each order line you want to pre-allocate stock to.

### Which stock you can choose

* Only stock with a status of **Available** in the order's warehouse is shown.
* Stock in a pickface location can't be pre-allocated.
* Batch, sell-by date and storage unit rules are **not** applied — you're choosing the stock manually, so you can pick any available stock record for the product.
* If the order's account is set up to order from linked accounts, stock from those linked accounts is also shown. When you pre-allocate linked-account stock, it's transferred into the order's account with a **LINKED ACCOUNT TRANSFER** reason code.
* The total pre-allocated on a line can't exceed the line's ordered quantity.

## What happens when stock is pre-allocated

| Where | What you'll see |
| - | - |
| Sales order status | **Pre-Allocated** when every line is fully covered, **Part Pre-Allocated** when only some of the order is. |
| Sales order page | The line's **Pre-Allocated** column updates, and a **Pre-Allocated Stock** section appears lower down the page listing each pre-allocated stock record, its quantity and location. |
| Sales Orders data grid | A **Pre-Allocated** column (add it with the Column Manager) showing the total pre-allocated against the total ordered across all lines, for example 5/10. |
| Stocks data grid | The pre-allocated stock shows a status of **Pre-Allocated**. Add the **Pre-Allocated Sales Order Line** column to see which order it's pre-allocated to. |
| [Stock Balance](https://documentation.claruswms.com/knowledgebase/products-and-stock/stock-balance.md) | The quantity moves from **Available** into its own **Pre-Allocated** balance, separate from **Allocated**. The ordered balance reduces by the same amount. |
| Transactions | A **Pre-Allocated** transaction is recorded for each stock record pre-allocated. |
| Audit log | The order's status change is logged with who made it and when. |

If you pre-allocate only part of a stock record, it's split in two: a **Pre-Allocated** record for the quantity you pre-allocated and an **Available** record for the remainder. Reducing a pre-allocated quantity later works the same way in reverse.

## Edit or release pre-allocated stock

You change a pre-allocation from the **Pre-Allocated Stock** section of the sales order page, not from the order lines. This section sits lower down the page and only appears once stock has been pre-allocated. It has one row per pre-allocated stock record, not one per order line, so a line spread across three stock records has three rows.

You can make changes while the order is **Pre-Allocated** or **Part Pre-Allocated**.

> [tab] Reduce the quantity
>
> **1. Find the stock record**
>
> In the **Pre-Allocated Stock** section, find the row for the stock record you want to reduce. Use the **Location Code** and **Storage Unit Reference** columns to identify it.
>
> **2. Enter the new quantity**
>
> On that row, type the quantity you want to keep pre-allocated into the **Quantity** input box. Hover over its column heading to see it labelled **Pre-Allocated Quantity**. The new quantity must be greater than zero and less than the quantity currently pre-allocated.
>
> > [!WARNING]
> >
> > Don't change the **Quantity** on the order line in the **Order Lines** grid. That's the ordered quantity, and it can't be reduced below what's pre-allocated. Reduce the pre-allocation here first.
>
> **3. Save**
>
> Click **Save** on the same row. The difference is released back to **Available** straight away.

> [tab] Release a stock record
>
> **1. Click Release**
>
> In the **Pre-Allocated Stock** section, click **Release** on the row for the stock record you no longer need. This releases the whole quantity on that row.
>
> **2. Confirm**
>
> Confirm the release. The stock is no longer pre-allocated to this order and becomes available to other orders immediately.

> [tab] Add more stock
>
> If a line is only partly pre-allocated, click that order line's **Pre-Allocate** button again and select more stock, as described in [Pre-allocate stock to an order line](#pre-allocate-stock-to-an-order-line). You can add up to the quantity still remaining on the line.

Each change updates the order's status and balances, and records an **Un-Pre-Allocated** transaction for the released quantity:

* Some stock still pre-allocated → **Part Pre-Allocated**
* Every line still fully covered → stays **Pre-Allocated**
* All pre-allocated stock released → back to **Pending**

> [!NOTE]
>
> Once the order has been processed for picking, the **Pre-Allocated Stock** grid becomes read-only and its pre-allocation can no longer be changed.

## Changing order lines with pre-allocated stock

To protect the stock you've pre-allocated, some line changes are blocked until you release the pre-allocation first:

* You can't reduce a line's order quantity below its pre-allocated quantity. Reduce or release the pre-allocation, then change the line.
* You can't change the product on a line that has pre-allocated stock.
* You can't delete a line that has pre-allocated stock.

## Processing picks on a pre-allocated order

When you [process picks](https://documentation.claruswms.com/knowledgebase/outbound/create-and-process-a-pick-list.md) on a **Pre-Allocated** or **Part Pre-Allocated** order:

* Pick tasks are created from exactly the stock you pre-allocated — the system doesn't look for different stock.
* Any quantity on a line that wasn't pre-allocated is matched from available stock using your normal pick rules.
* The quantity moves out of the **Pre-Allocated** balance as the stock is allocated to the pick.

## Cancelling orders, pick lists and pick tasks

Cancelling releases pre-allocated stock automatically, returning it to **Available**:

* **Cancelling a sales order** that is **Pre-Allocated** or **Part Pre-Allocated** releases all of its pre-allocated stock.
* **Cancelling a pick list**, or an individual pick task, for a pre-allocated order returns that stock to **Available**. It's no longer pre-allocated to the order, so pre-allocate again if you still need to reserve it. See [Cancel or amend a pick list](https://documentation.claruswms.com/knowledgebase/outbound/cancel-or-amend-a-pick-list.md).

## Stock control on pre-allocated stock

While stock is **Pre-Allocated**, the following operations are blocked:

* Positive and negative adjustments
* Account transfers
* Warehouse transfers
* Hold and release from hold
* Moves

If you try one of these, you're told the stock is pre-allocated to a sales order. Release the pre-allocation from the sales order first, then carry out the operation.

## Permissions

Pre-allocation has its own **Pre-Allocations** ability, set on the user's role. See [Creating and implementing user roles](https://documentation.claruswms.com/knowledgebase/users-and-roles/user-roles-guide.md).

| Access | What the user can do |
| - | - |
| **Read** | See the **Pre-Allocated** count on the Sales Orders data grid and the **Pre-Allocated Stock** grid on the sales order page. The **Pre-Allocate**, **Save** and **Release** buttons are shown but disabled. |
| **Manage** | Pre-allocate, edit and release stock. Manage also requires Read. |

The Admin role has both **Read** and **Manage** by default. Other roles need the ability added.

This ability only controls pre-allocation on sales orders. Users still see the **Pre-Allocated** stock status and balance through their existing Stocks and Stock Balance access.

## Frequently asked questions

> [accordion] Why is the Pre-Allocate button disabled?
>
> Check that the order is saved and has a status of **Pending**, **Pre-Allocated** or **Part Pre-Allocated**, that the line isn't already fully pre-allocated, and that your role has **Manage** access to **Pre-Allocations**. Hover over the button to see the reason.

> [accordion] Why can't I see some of my stock in the Pre-Allocate Stock window?
>
> Only **Available** stock in the order's warehouse is listed. Stock that's on hold, allocated, already pre-allocated, or in a pickface location isn't shown.

> [accordion] Can I pre-allocate serial-numbered, kitted or cross-dock orders?
>
> No. Pre-allocation doesn't support serial number selection, kitted products or cross-dock flows.

> [accordion] Do automations still run when I pre-allocate?
>
> Yes. Pre-allocating, editing and releasing stock trigger the existing sales order updated and stock balances updated automations.
