# Inventory Adjustment

<p class="doc-lead">An Inventory Adjustment manually corrects stock on hand to match physical reality — covering gains (more stock than recorded) and losses (damage, theft, shrinkage, counting errors). When approved, an adjustment updates stock at the chosen center and posts the value to your inventory and an offset account.</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/inventory-adjustment?id=overview">Overview &amp; List View</a>
<a href="#/inventory/inventory-adjustment?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/inventory-adjustment?id=header-fields">Header Fields</a>
<a href="#/inventory/inventory-adjustment?id=item-lines">Item Lines</a>
<a href="#/inventory/inventory-adjustment?id=item-pick">Selecting items from center stock</a>
<a href="#/inventory/inventory-adjustment?id=types">Gain &amp; Loss</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/inventory/inventory-adjustment?id=actions-status">Actions &amp; Status</a>
<a href="#/inventory/inventory-adjustment?id=posting">Stock &amp; Account Posting</a>
<a href="#/inventory/inventory-adjustment?id=reasons">Adjustment Reasons</a>
<a href="#/inventory/inventory-adjustment?id=master-update">Master Update</a>
<a href="#/inventory/inventory-adjustment?id=view-tabs">View Tabs &amp; Widgets</a>
<a href="#/inventory/inventory-adjustment?id=best-practices">Best Practices</a>
<a href="#/inventory/inventory-adjustment?id=faq">FAQ</a>
<a href="#/inventory/inventory-adjustment?id=related">Related &amp; Videos</a>
</div>
</div>
</div>

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

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

The Inventory Adjustments list shows every adjustment with its id, date, type, on account, center, employee, reason, and status. Use the quick filter tabs to switch views and Advanced Filters to narrow the list. From the list you can create a new adjustment, open an existing one, edit a draft, or delete a draft.

<img src="inventory/images/inv-adj.webp" alt="Inventory Adjustments list" loading="lazy">

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | Adjustment reference number. |
| Date | Adjustment date and time. |
| Type | Inventory Gain or Inventory Loss. |
| On Account | Account the value is posted against. |
| Center | Center where stock is adjusted. |
| Employee | Employee in charge of the adjustment. |
| Reason | Adjustment reason. |
| Status | Current status of the adjustment. |

<b>Quick filter tabs</b>

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

<b>Advanced Filters</b>

Id, Employee, Center, Type, Reason, Notes, Project, Status, Date, and Created 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 an Inventory Adjustment</h2>

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

<h3>2. Create new adjustment</h3>
Click <b>New</b> to open the adjustment entry screen.

<img src="inventory/images/inv-adj-new.webp" alt="New Inventory Adjustment" loading="lazy">

<h3>3. Fill in details</h3>
<ul>
<li>Set the <b>Date</b> and choose the <b>Adjustment Type *</b> — Inventory Gain or Inventory Loss.</li>
<li>Confirm the <b>On Account *</b> (auto-filled from the type) and choose the <b>Center *</b>.</li>
<li>Optionally set <b>Employee</b>, <b>Brand</b>, <b>Reason</b>, and <b>Project</b>.</li>
<li>Add item lines. Use the item zoom to pick from center stock — see <a href="#/inventory/inventory-adjustment?id=item-pick">Selecting items from center stock</a>.</li>
<li>For a gain, enter <b>More Quantity</b> and <b>Value per unit</b>; for a loss, enter <b>Less Quantity</b>.</li>
</ul>

<h3>4. Save</h3>
<ul>
<li><b>Save</b> — keeps the adjustment as a <b>Draft</b>.</li>
<li><b>Save And Approve</b> — approves the adjustment in one step and posts stock and value.</li>
<li><b>Reset</b> / <b>Cancel</b> — clears or closes the form without saving.</li>
</ul>

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

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

| **Field** | **Description** |
|-----------|-----------------|
| Date * | Date and time of the adjustment. |
| Employee | Employee in charge of the adjustment. |
| Adjustment Type * | Inventory Gain (stock increase) or Inventory Loss (stock decrease). |
| On Account * | Account the adjustment value is posted against. Auto-fills from the type — an income account for a gain, an expense account for a loss — and can be changed to another valid account. |
| Center * | Center where stock is adjusted. Locked to the receipt center when the loss is created from a delivery-note receipt. |
| Receipt Note | Delivery-note receipt this loss was created from. Shown only when the loss is linked to a receipt. |
| Brand | Brand for brand-wise tracking. Shown when brands are enabled. |
| Reason | Reason for the adjustment, chosen from the configured list. A new reason can be added inline. |
| Project | Optional project link. |
| Project Task | Task within the selected project. Enabled after a project is selected. |
| Notes | Remarks about the adjustment. |

<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 adjusted. Stock and consumable items only. Use the zoom to pick from center stock — see <a href="#/inventory/inventory-adjustment?id=item-pick">Selecting items from center stock</a>. |
| Variant | Item variant, where the item has variants. |
| Unit | Unit of measure. Defaults from the item. |
| Value per unit | Cost value per unit. Required for a gain so the added stock is valued correctly. |
| Less Quantity | Quantity to remove. Enabled for an Inventory Loss. Prefills from selected stock quantity when picking from the inventory list. |
| More Quantity | Quantity to add. Enabled for an Inventory Gain. Entered on the form (not prefilled from current stock). |
| Batch | Batch being adjusted. For a loss, lists batches in the selected center; for a gain, you can select or add a new batch. Shown for batch-tracked items. |
| Serial Numbers | Serial numbers being adjusted. For a loss you select existing serials; for a gain you add new serials. Shown for serial-tracked items. |
| Inv Bin | Bin within the center. Shown when bin tracking is enabled. |

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

<h2 id="item-pick">Selecting items from center stock</h2>

When you open the item zoom on an Inventory Adjustment, the list is filtered by the selected <b>Center</b>. Use the <b>Show</b> toggle at the top of the list:

| **Show** | **What it lists** | **Typical use** |
|----------|-------------------|-----------------|
| <b>With Stock</b> | Items with quantity greater than zero at the center (Inventory Summary). | Inventory Loss — pick stock that exists to reduce. |
| <b>All Items</b> | All stockable items for the center, including zero stock (title shows as <b>Item List</b>). | Inventory Gain — add stock for items that currently show zero at that center. |

<ul>
<li><b>Inventory Gain</b> defaults to <b>All Items</b> so you can select items that are not currently in stock at the center.</li>
<li><b>Inventory Loss</b> defaults to <b>With Stock</b>.</li>
<li>Use quick search to find an item by name or item code.</li>
<li>On Gain, selected lines do not copy quantity into <b>More Quantity</b> — enter the gain quantity on the form.</li>
<li>On Loss, selected stock quantity maps to <b>Less Quantity</b>.</li>
</ul>

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

<h2 id="types">Gain &amp; Loss</h2>

| **Type** | **Use when** | **Quantity field** |
|----------|--------------|--------------------|
| Inventory Gain | Physical stock is more than the system shows. | Enter <b>More Quantity</b> and <b>Value per unit</b>. |
| Inventory Loss | Physical stock is less than the system shows — damage, theft, shrinkage, or counting errors. | Enter <b>Less Quantity</b>. |

The <b>On Account</b> default follows the type: a gain credits an inventory gain (income) account, and a loss debits an inventory loss (expense) account. You can change it to any other valid account before saving.

<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 | Approves the adjustment and posts stock and value. Hidden when multi-level approval applies. | Draft |
| Edit | Opens the adjustment for editing. | Draft |
| Delete | Permanently removes the adjustment. | Draft |
| Clone | Creates a copy of the adjustment. | All (if permitted) |

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

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Cancel | Cancels the adjustment and reverses its stock and account postings. | Approved |
| Update Serial Numbers | Updates serial number properties for the adjusted items. | Approved, Closed |
| Add/Update Note | Adds or edits a note on the adjustment. | All |
| Master Update | Updates selected header fields without reopening the full form. See <a href="#/inventory/inventory-adjustment?id=master-update">Master Update</a>. | Approved, Closed |
| Print Labels | Opens label printing for the adjusted items. | All |
| Print | Prints the adjustment. | All |

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Draft | Saved but not yet approved. Can be edited or deleted. No stock or value has posted. |
| Approved | Finalized. Stock and value have been posted. |
| Cancelled | Adjustment has been cancelled and its postings reversed. |

> When multi-level approval is configured, the <b>Approve</b> button is replaced by the approval workflow and the adjustment moves through its approval stages before it posts.

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

<h2 id="posting">Stock &amp; Account Posting</h2>

When you approve an adjustment:

<ul>
<li><b>Inventory Gain</b> — stock is <b>increased</b> at the center using the entered <b>Value per unit</b>. The accounting entry debits the inventory account and credits the chosen <b>On Account</b> (an income/gain account).</li>
<li><b>Inventory Loss</b> — stock is <b>decreased</b> at the center at its current cost. The accounting entry credits the inventory account and debits the chosen <b>On Account</b> (an expense account).</li>
<li><b>Loss from a delivery-note receipt</b> — created with <b>Create Inventory Loss</b> on that <a href="#/inventory/goods-receipt-note">Goods Receipt Note</a>. Stock is decreased at the receipt cost, not the warehouse average, and only up to the quantity that receipt still has. The sale invoice is not changed.</li>
</ul>

Cancelling an approved adjustment reverses both the stock movement and the accounting entry.

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

<h2 id="reasons">Adjustment Reasons</h2>

Adjustment reasons are a master list you maintain under <b>Inventory → Inventory Adjustment Reasons</b>. Each reason has a <b>Title *</b> and an optional <b>Description</b>, and can be set Active or Suspended. Selecting a reason on each adjustment makes loss and gain reporting consistent (for example "Damaged", "Expired", "Stock count correction"). You can also add a new reason inline from the adjustment form.

<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 adjustment without editing the full document or item lines. Open the three-dot menu on the adjustment and select <b>Master Update</b>.

| **Field** | **Can be updated?** | **Notes** |
|-----------|---------------------|-----------|
| Date * | Yes | Cannot be set before the accounts closing date. The stock and journal dates are updated to match. |
| Employee In charge | Yes | |
| Project | Yes | |
| Type, On Account, Center, item lines, quantities | No | Cancel the adjustment 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 an adjustment in full view, the right side shows tabbed panels.

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

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

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

<ul>
<li>Always select a <b>Reason</b> so loss and gain reports stay meaningful.</li>
<li>For gains, enter an accurate <b>Value per unit</b> — it sets the cost of the stock you are adding.</li>
<li>Use <b>Batch</b> and <b>Serial Numbers</b> for tracked items so the right units are added or removed.</li>
<li>Adjust at the correct <b>Center</b> — postings apply only to that center's stock.</li>
<li>Prefer an Inventory Counting where you are reconciling a full physical count, and use adjustments for targeted corrections.</li>
</ul>

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

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

<b>Why can't I find an item with zero stock when creating a Gain?</b><br>
Switch the item list <b>Show</b> toggle to <b>All Items</b> (default for Gain). <b>With Stock</b> only lists items that currently have quantity at the center.

<b>What is the difference between an Inventory Gain and an Inventory Loss?</b><br>
A gain adds stock (physical count is higher than recorded); a loss removes stock (damage, theft, or count shortfall). The type also decides whether the value posts to an income or expense account.

<b>Why is Value per unit required for a gain but not a loss?</b><br>
A gain adds new stock, so the system needs its cost value. A loss removes existing stock at its current cost, so no value entry is needed.

<b>Does saving a draft adjustment change stock?</b><br>
No. Stock and value post only when the adjustment is approved.

<b>Can I edit an approved adjustment?</b><br>
No. Use <b>Master Update</b> for the allowed header fields, or <b>Cancel</b> the adjustment and create a new one.

<b>Why can't I see the Approve button?</b><br>
When multi-level approval is configured, approval follows the approval workflow instead of the direct Approve button.

<b>How do I add a new adjustment reason?</b><br>
Maintain reasons under <b>Inventory Adjustment Reasons</b>, or add one inline from the adjustment form's <b>Reason</b> field.

<b>Why won't my adjustment approve for insufficient stock?</b><br>
Loss adjustments require enough on-hand quantity at the center. The system does not allow negative stock.

<b>What is the difference between adjustment and revaluation?</b><br>
Adjustment changes quantity (gain or loss). <a href="#/inventory/inventory-revaluation">Inventory Revaluation</a> changes unit cost without changing quantity.

<b>What is the difference between adjustment and inventory counting?</b><br>
<a href="#/inventory/inventory-counting">Inventory Counting</a> records variances during a physical count. Adjustments post the actual stock correction — often after resolving a count line.

<b>Can I mix gain and loss lines in one adjustment from counting?</b><br>
When creating an adjustment from counting resolution, choose either surplus or shortage lines — not both in one adjustment.

<b>Do serial-tracked items have special rules?</b><br>
Yes. For a loss, select existing serials; for a gain, enter new ones. See <a href="#/inventory/serial-numbers">Serial Numbers</a>.

<b>Which header fields can I change with Master Update?</b><br>
Date, Employee In charge, Branch, Brand, and Project. Item lines, quantities, and adjustment type cannot be changed through Master Update.

<h2 id="related">Related Topics &amp; Videos</h2>

<b>Related documentation</b>
<ul>
<li><a href="#/inventory/inventory-counting">Inventory Counting</a> — reconcile a full physical count.</li>
<li><a href="#/inventory/inventory-revaluation">Inventory Revaluation</a> — change stock value without changing quantity.</li>
<li><a href="#/inventory/inventory-transfer">Inventory Transfer</a> — move stock between centers.</li>
<li><a href="#/inventory/opening-inventory">Opening Inventory</a> — set initial stock balances.</li>
</ul>

<b>Video — Inventory Adjustment overview</b>
<iframe width="560" height="315" src="https://www.youtube.com/embed/Vcpxy58Lp0c?si=xFVur_s0FkltLlsz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

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

## Errors and warnings

Exact messages for Inventory Adjustment 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.

### Serial Number missing

- **Type:** Error
- **Action:** Approve, Save And Approve
- **When:** A serial-tracked item line has no serial numbers when stock posts (gain create or loss select, depending on document).
- **Example message:** *Serial Number missing*
- **Outcome:** Not approved.
- **Solution:** Enter or select one serial per unit for the line quantity. Shared catalog: <a href="#/inventory/serial-numbers">Serial Numbers</a>.

### Duplicate Serial Number found

- **Type:** Error
- **Action:** Save, Approve, Save And Approve
- **When:** The same serial name or id appears more than once on a line, or approve stock posting finds duplicate serial ids.
- **Example message:** *Duplicate Serial Number found <b>SN-001</b> for Item <b>Widget</b> ( ItemId 1160 ) in line 2* or *Duplicate Serial Number found for  Item <b>Widget ( ItemId 1160 ) </b> in line 2*
- **Outcome:** Not saved / not approved.
- **Solution:** Enter each serial only once on the line.

### Serial Number Quantity Mismatch

- **Type:** Error
- **Action:** Approve, Save And Approve
- **When:** The count of serial numbers differs from the line quantity.
- **Example message:** *Serial Number Quantity Mismatch for  Item <b>Widget ( ItemId 1160 ) </b> in line 2* or *Serial Number Quantity Mismatch for  Item <b>Widget ( ItemId 1160 ) </b>*
- **Outcome:** Not approved.
- **Solution:** Enter exactly as many unique serials as the line quantity.

### SerialNumber not found

- **Type:** Error
- **Action:** Save, Save And Approve
- **When:** On a select/issue path, a serial name (or name in a range) is missing or cancelled for that item.
- **Example message:** *SerialNumber <b>SN-999</b> in line 2 not found*
- **Outcome:** Not saved.
- **Solution:** Pick serials that exist in stock for the item, or correct the range.

### SerialNumber already exist

- **Type:** Error
- **Action:** Approve, Save And Approve
- **When:** On an add/create path, approving creates serials and the name already exists for the item.
- **Example message:** *SerialNumber <b>SN-001</b> in line 2 already exist*
- **Outcome:** Not approved. New serials are not created.
- **Solution:** Use a unique serial name for each new unit.

### Inventory not available

- **Type:** Error (blocks the action)
- **Action:** Approve, Cancel
- **When:** On approve of a loss, normal stock is short at the center. On cancel of a gain, the quantity that was added is no longer in that same normal-stock layer.
- **Example message:** *Inventory not available* or *Inventory Not Found for Item … in line N*
- **Outcome:** Not posted.
- **Solution:** A loss checks <b>normal stock</b> (WIP blank) at the adjustment center. Cancelling a gain checks that same normal-stock layer, because cancel takes back the quantity that was added. Open <a href="#/inventory/reports/item-enquiry">Item Enquiry</a> and search the item for a basic view (<b>Item Stock</b>, and <b>In hand</b> versus <b>WIP</b> by center). For the exact layer, open <a href="#/inventory/reports/inventory-summary">Inventory Summary</a>, turn on every <b>Group by</b> button (<b>Item</b>, <b>WIP</b>, <b>Center</b>, <b>Variant</b>, <b>Batch</b>, <b>Inv Bin</b>), search the item, and match the center, batch, inventory bin, and variant on the line. The system does not allow negative stock, so that row must already hold the quantity.

### Value cannot be negative

- **Type:** Error (blocks the action)
- **Action:** Approve
- **When:** On a loss, quantity is available in normal stock, but issuing it would leave a negative stock value on that layer.
- **Example message:** *Insufficient stock value of {amount} for item id {id}*
- **Outcome:** Not posted. Stock value is not changed.
- **Solution:** Approving will result in a negative item value. Increase the item value through <a href="#/inventory/inventory-revaluation">Inventory Revaluation</a> on that same layer, then approve.

### 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.

### More / Less / Value / On Account required

- **Type:** Error
- **Action:** Save, Approve
- **When:** The adjustment type is missing its quantity or value, or On Account has no account.
- **Example message:** *More Quantity is required*; *Less Quantity is required*; *Value is required*; *On Account ID is required*; *Invalid quantity*
- **Outcome:** Not saved / not posted.
- **Solution:** Fill the fields that match the adjustment type.

</section>
