Warehouses

Stock Adjustments

Bringing the system into line with what is physically on the shelf after a count.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/warehouses/stock-adjustment

Requires subscriptionwarehouse.manage5,000 IQD / month

Overview

However carefully stock is managed, the recorded figure and the shelf drift apart — breakage, miscounts, unrecorded samples. An adjustment records what you actually counted and moves the system to match it.

Warehouses — Stock adjustment form
Stock adjustment form
Stock adjustment form — Products with the system quantity beside the counted quantity and the resulting difference.

System versus actual

Each line holds two numbers, and the difference between them is the adjustment:

ParameterTypeRequiredDescription
qty_systemdecimalOptionalWhat the system believes is held in the warehouse you counted. Filled in for you.
qty_actualdecimalRequiredWhat you actually counted. This is what you enter.
unit_costdecimalOptionalCost per unit, used to value the difference.
NoteYou enter the counted figure, not the difference. Entering 8 when the system says 10 removes 2; entering 12 adds 2. There is no need to work out the delta.
NoteA count is of one warehouse. With 10 in Main and 5 in Branch, counting Branch compares against its 5, and finding 3 lowers the product total from 15 to 13 — Main is untouched. Pick the warehouse before adding products; it locks once the first product is added.
  1. 1

    Count the stock

    Do the physical count first, on paper or on a tablet. Counting against a screen that already shows the expected number invites confirmation bias.

  2. 2

    Start an adjustment

    Go to Warehouses and create a new stock adjustment.

  3. 3

    Choose the warehouse

    Say which location was counted. Optional for a single-location business.

  4. 4

    Enter the counted quantities

    Add each product you counted and enter the actual figure. The system quantity and the difference are shown as you go.

    Warehouses — Adjustment lines
    Adjustment lines
    Adjustment lines — Counted quantities with the differences from the system figure highlighted.
  5. 5

    Record the reason

    Say why the count differs — annual stocktake, spot check, suspected loss. This is what makes the adjustment defensible later.

  6. 6

    Save

    Stock is set to the counted figures and a movement is written for each change.

Fields

POST /api/v1/warehouses/adjustments
ParameterTypeRequiredDescription
warehouse_idintegerOptionalLocation counted. Optional for single-location businesses.
reasonstringOptionalWhy the adjustment is being made.
notesstringOptionalAny further detail.
itemsarrayRequiredThe counted lines.
items[].product_idintegerRequiredProduct counted.
items[].qty_actualdecimalRequiredQuantity actually counted.
items[].unit_costdecimalOptionalCost per unit, for valuing the difference.

The adjustment record

ParameterTypeRequiredDescription
adjustment_idintegerOptionalInternal identifier.
adjustment_nostringOptionalReference number.
adjustment_datetimestampOptionalWhen it was made.
warehouse_namestringOptionalResolved location name.

Who can adjust

WarningPosting an adjustment needs Stock adjustmentsin the owner's permission matrix (My Account → Team → Permissions). It is on by default, so untick it for anyone who should not be able to change a count. There is no separate approval step: an adjustment applies as soon as it is saved, and it is written to the activity log with who saved it.

Adjustment or damage?

TipIf you know why stock has gone — broken, expired, spoiled — record it as damage instead. A damage record captures the reason, values the loss and can post it as an expense, so it shows up as a real cost. Use an adjustment when the count is simply wrong and you cannot say why.

Good practice

  • Count when the shop is closed, so nothing moves mid-count.
  • Count high-value and fast-moving lines more often than everything else.
  • Investigate large differences before posting them — a miscount is cheaper to fix than a wrong write-off.
  • Always fill in the reason. In six months it is the only thing that will explain the movement.

Related