# Stock Reservation

<p class="doc-lead">A Stock Reservation holds quantity of an item at a center for a specific sale order so it is not available to other transactions. When the reservation is approved, the system checks that the stock is available and flags the reserved quantity. The physical stock stays in the center — a reservation does not move stock or post to your accounts.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/inventory/stock-reservation?id=overview">Overview &amp; List View</a>
<a href="#/inventory/stock-reservation?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/inventory/stock-reservation?id=header-fields">Header Fields</a>
<a href="#/inventory/stock-reservation?id=item-lines">Item Lines</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/inventory/stock-reservation?id=actions-status">Actions &amp; Status</a>
<a href="#/inventory/stock-reservation?id=posting">Posting Behavior</a>
<a href="#/inventory/stock-reservation?id=master-update">Master Update</a>
<a href="#/inventory/stock-reservation?id=view-tabs">View Tabs &amp; Widgets</a>
<a href="#/inventory/stock-reservation?id=best-practices">Best Practices</a>
<a href="#/inventory/stock-reservation?id=faq">FAQ</a>
<a href="#/inventory/stock-reservation?id=related">Related Topics</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

The Stock Reservations list shows every reservation with its id, date, center, employee, customer, the linked sale order, and status. Use the quick filter tabs to switch between views, and Advanced Filters to narrow the list. From the list you can create a new reservation, open an existing one, edit a draft, or delete a draft.

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | Reservation reference number. |
| Date | Reservation date and time. |
| Center | Center the stock is reserved at. |
| Employee | Employee who created the reservation. |
| Customer | Customer from the linked sale order. |
| Order [Id] | Linked sale order. |
| Status | Current status of the reservation. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Default | All reservations except cancelled ones. |
| Approved | Reservations that have been approved. |
| Draft | Reservations saved but not yet approved. |
| Cancelled | Reservations that have been cancelled. |

<b>Advanced Filters</b>

For Center, Employee, Sale Order No, Customer, Item, Status, and Date.

<b>List row actions</b>

| **Action** | **Available when status is** |
|------------|------------------------------|
| Edit | Draft |
| Delete | Draft |
| View | All statuses |

<hr class="doc-section-divider">

<h2 id="quick-start">Quick Start — Create a Stock Reservation</h2>

<h3>1. Navigate</h3>
Go to <b>Inventory → Stock Reservations</b> from the left menu.

<h3>2. Create new reservation</h3>
Click <b>New</b> to open the reservation entry screen. A reservation can also be created from an approved Sale Order.

<h3>3. Fill in details</h3>
<ul>
<li>Set the <b>Date *</b> and choose the <b>Center *</b> to reserve stock at.</li>
<li>Pick the <b>Sale Order Id</b> the reservation is for and set the <b>Employee</b>.</li>
<li>Add item lines with <b>Item</b>, <b>Quantity</b>, and <b>Unit</b>.</li>
</ul>

<h3>4. Save</h3>
<ul>
<li><b>Save</b> — keeps the reservation as a <b>Draft</b>.</li>
<li><b>Save And Approve</b> — checks availability and reserves the stock in one step.</li>
<li><b>Reset</b> / <b>Cancel</b> — clears or closes the form without saving.</li>
</ul>

<h3>5. Approve and issue</h3>
Approve to reserve the stock. When the goods are dispatched, use <b>Mark as Issued</b> to close the reservation.

<hr class="doc-section-divider">

<h2 id="header-fields">Header Fields Reference</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Date * | Date and time of the reservation. |
| Sale Order Id | Approved sale order the stock is reserved for. Picked from the sale order list. |
| Center * | Center the stock is reserved at. Required. |
| Employee | Employee who created the reservation. |
| Due Date | Date by which the reserved stock is expected to be issued. |
| Notes | Remarks about the reservation. |

<hr class="doc-section-divider">

<h2 id="item-lines">Item Lines — ITEMS</h2>

| **Column** | **Description** |
|------------|-----------------|
| Sl Num | Line serial number. Auto-numbered. |
| Item | Item being reserved. |
| Quantity | Quantity to reserve. |
| Unit | Unit of measure. Defaults from the item. |
| Reserved Qty | Quantity held by the reservation. |
| Issued Qty | Quantity already issued against the reservation. |
| Balance Qty | Reserved quantity not yet issued. |

<hr class="doc-section-divider">

<h2 id="actions-status">Actions &amp; Status</h2>

<h3>View toolbar actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Approve | Checks availability and reserves the stock. | Draft |
| Edit | Opens the reservation for editing. | Draft |
| Delete | Permanently removes the reservation. | Draft |
| Clone | Creates a copy of the reservation. | All (if permitted) |

<h3>More menu (⋮) actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Mark as Issued | Closes the reservation once the reserved stock has been issued. | Approved |
| Cancel | Cancels the reservation and releases the held stock. | Approved, Closed |
| Add/Update Note | Adds or edits a note on the reservation. | All |
| Master Update | Updates selected header fields without reopening the full form. See <a href="#/inventory/stock-reservation?id=master-update">Master Update</a>. | Approved, Closed |
| Print | Prints the reservation. | All |

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Draft | Saved but not yet approved. Can be edited or deleted. No stock is reserved. |
| Approved | Stock is reserved and held against the sale order. |
| Closed | Reservation closed — reserved stock has been issued via <b>Mark as Issued</b>. |
| Cancelled | Reservation has been cancelled and the held stock released. |

<hr class="doc-section-divider">

<h2 id="posting">Posting Behavior</h2>

A Stock Reservation places a <b>soft hold</b> on stock — it does not physically move stock and it does not post to your accounts. When you approve a reservation:

<ul>
<li>The system checks that the requested quantity is <b>available</b> at the center. If it is not available, approval is blocked and the shortfall is shown.</li>
<li>The reserved quantity is flagged so it is no longer treated as available stock for other transactions.</li>
</ul>

The physical quantity stays in the center until it is issued through the related dispatch document. Cancelling an approved reservation releases the held quantity back to available stock.

<hr class="doc-section-divider">

<h2 id="master-update">Master Update</h2>

<b>Master Update</b> lets you change selected header fields on an approved reservation without editing the full document or item lines. Open the three-dot menu on the reservation and select <b>Master Update</b>.

| **Field** | **Can be updated?** | **Notes** |
|-----------|---------------------|-----------|
| Date * | Yes | Cannot be set before the accounts closing date. |
| Center, items, quantities | No | Cancel the reservation and create a new one to change these. |

Click <b>Confirm</b> to save changes or <b>Cancel</b> to close without saving.

<hr class="doc-section-divider">

<h2 id="view-tabs">View Tabs &amp; Side Panels</h2>

When you open a reservation in full view, the right side shows tabbed panels. Click the expand icon on a tab to open the same data in a larger modal.

<h3>Top panel</h3>

| **Tab** | **What it shows** |
|---------|-------------------|
| Summary | Documents linked to this reservation, such as the sale order it was created for. |

<h3>Bottom panel</h3>

| **Tab** | **What it shows** |
|---------|-------------------|
| History | Activity log — who created, approved, issued, or cancelled the reservation and when. |
| Attachments | Files uploaded to this reservation. |

<hr class="doc-section-divider">

<h2 id="best-practices">Best Practices</h2>

<ul>
<li>Reserve stock against the sale order as soon as it is confirmed so the quantity is protected from other orders.</li>
<li>Set a <b>Due Date</b> so reservations that are no longer needed can be reviewed and released.</li>
<li>Use <b>Mark as Issued</b> once the reserved goods are dispatched so the held quantity is cleared.</li>
<li>Cancel reservations that fall through so the stock returns to available quantity promptly.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Does a reservation reduce my stock on hand?</b><br>
No. The physical quantity stays in the center. A reservation only reduces the quantity shown as <b>available</b> for other transactions.

<b>What happens if the stock isn't available when I approve?</b><br>
Approval is blocked and the items that are short are listed. Reduce the reserved quantity or replenish stock and try again.

<b>How do I release reserved stock?</b><br>
Use <b>Mark as Issued</b> when the goods are dispatched, or <b>Cancel</b> the reservation to release the hold without issuing.

<b>Does a reservation affect my accounts?</b><br>
No. A reservation never posts to accounts. It only holds stock availability.

<b>How does a delivery note use a reservation?</b><br>
When you deliver against a reserved sale order, the delivery consumes reserved quantity. Available stock for other orders is protected until the reservation is issued or cancelled.

<b>What is the difference between balance and issued quantity?</b><br>
On approve, <b>balance quantity</b> equals the reserved amount and <b>issued quantity</b> starts at zero until you <b>Mark as Issued</b> or deliver the goods.

<b>Can I reserve more than on-hand stock?</b><br>
No. Approve validates available inventory at the center and lists lines that are short.

<h2 id="related">Related Topics</h2>

<b>Related documentation</b>
<ul>
<li><a href="#/inventory/goods-delivery-note">Delivery Note</a> — issue the reserved goods to the customer.</li>
<li><a href="#/inventory/inventory-transfer">Inventory Transfer</a> — move stock between centers.</li>
<li><a href="#/inventory/inventory-item">Item</a> — review item stock and availability.</li>
<li><a href="#/inventory/reports/stock-report">Stock Report</a> — check on-hand and available quantities.</li>
</ul>

<section class="ai-index-only">

## Errors and warnings

Exact messages for Stock Reservation from the ERP screen and `fs_api`. Visitors do not see this section; Vertex AI Search uses it to answer questions about on-screen errors.


### Future or back-dated date

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Date is in the future and future-date transactions are off, or the user cannot enter previous dates, or the date is before the allowed cutoff.
- **Example message:** *Future date transactions are not allowed.* or *Previous date transaction entries are not allowed.* or *Transaction date cannot be before YYYY-MM-DD.*
- **Outcome:** The document is not saved.
- **Solution:** Set Date to an allowed date, then save.

### Accounts closed for the date

- **Type:** Error
- **Action:** Approve, Save And Approve, Master Update
- **When:** The document date is in a closed accounting period.
- **Example message:** *Accounts closed for the date*
- **Outcome:** Not posted, or the date is not changed.
- **Solution:** Use a date after the accounts closing date.

### Multi-level approval required

- **Type:** Error / workflow
- **Action:** Approve, Save And Approve
- **When:** An active multi-level approval template matches this document.
- **Example message:** *Multi level approval is required*
- **Outcome:** Direct approve is blocked.
- **Solution:** Use Send Request on the first stage. For Send Request, stage Approve, Reject, Send For Revise, and Cancel Request messages, see <a href="#/features/multiapproval?id=action-errors">Multi Approval — Action error messages</a>.

### Edit or delete not allowed

- **Type:** Error
- **Action:** Edit, Delete
- **When:** Status is not Draft or For Revisal, or auto bill-number is on for delete.
- **Example message:** *Edit not allowed in the current status* or *Invalid status* or *Delete prevented..*
- **Outcome:** Posted documents stay in the ledger.
- **Solution:** Cancel a posted document after unlinking related records. Delete only drafts.

### Cancel date restriction

- **Type:** Error
- **Action:** Cancel
- **When:** User cannot cancel previous-date transactions, or the date is before the cancel cutoff.
- **Example message:** *Cancelling previous date transactions are not allowed* or *Cancelling transactions before YYYY-MM-DD is not allowed.*
- **Outcome:** Not cancelled.
- **Solution:** Cancel only dates the user is allowed to cancel.

### Items missing or invalid

- **Type:** Error (blocks save)
- **Action:** Save, Save And Approve
- **When:** Item lines are empty, a required field is missing, or line totals do not match.
- **Example message:** *items not found* or *Invalid Data in lines {N}* (`fs_api`). ERP: *Items contains invalid data* or *Items required*.
- **Outcome:** Not saved.
- **Solution:** Add valid item lines, then save.

### Inventory not available

- **Type:** Error (blocks the action)
- **Action:** Approve
- **When:** Available quantity for the item at the center, after active reservations, is less than the line quantity.
- **Example message:** *Inventory not available* or *Inventory Not Found for Item … in line N*
- **Outcome:** Not posted.
- **Solution:** On <a href="#/inventory/reports/item-enquiry">Item Enquiry</a>, search the item and compare <b>Item Stock</b>, <b>Reserved Qty</b>, and <b>Current Available</b> for the center. The check is by item and center; it does not split batch, bin, or WIP. Use <a href="#/inventory/reports/inventory-summary">Inventory Summary</a> with every <b>Group by</b> button on (<b>Item</b>, <b>WIP</b>, <b>Center</b>, <b>Variant</b>, <b>Batch</b>, <b>Inv Bin</b>) to see where that quantity sits. Reduce the reserved quantity, or release another reservation at that center.

### Quality inspection pending

- **Type:** Error (blocks approve)
- **Action:** Approve
- **When:** QC is required and still pending (`qcStatus` pending).
- **Example message:** *Quality Inspection is Pending*
- **Outcome:** Approve fails.
- **Solution:** Complete Quality Inspection first, then Approve.

### Sale order already has a reservation

- **Type:** Error
- **Action:** Save, Approve
- **When:** The sale order already has an approved or closed stock reservation.
- **Example message:** *This sale order already has an approved or closed stock reservation*
- **Outcome:** Not saved / not approved.
- **Solution:** Use the existing reservation, or cancel it first.

</section>
