Warehouse

A warehouse is a defined location at which stock is held and against which stock movements are recorded.

Also called Location · Store · Godown · Stock location · Site

Why it exists

Because knowing how much stock exists is useless without knowing where it is, and every fulfilment decision is a question about place before it is a question about quantity.

What it means to the business

The warehouse structure decides what the business can promise. Availability, picking, replenishment and stock-take all resolve against it, so the granularity chosen at implementation sets the ceiling on how precisely anyone can answer 'can we ship this today?'. Too fine and the data rots because nobody maintains it; too coarse and the system cannot answer the question at all.

01Lifecycle — walk the states

Planned. Defined, not yet operational. No stock.

State 1 of 4

02Relationships — walk the chain

Warehouse holds Item.

Open Item
03What goes wrong — and why
  • Rack-and-bin-level warehouses mean every stock entry needs a location decision nobody has time to make. Staff post to a default, the detail becomes fiction, and precision is lost that coarser tracking would have kept honest.

Rules that must hold

  • Stock always sits in exactly one warehouse. Quantity without a location is not stock, it is a rumour.
  • A warehouse has a physical address, and in India that address determines which GSTIN governs movements in and out of it.
  • Moving stock between warehouses is a transaction, not an edit — even when both belong to the same company.

What commonly goes wrong

The hierarchy gets designed for a warehouse manager's mental model rather than for the transactions people actually post. It looks right in a workshop and is unusable at the receiving dock, where someone with a trolley has to pick a location in seconds — so they pick the first one, every time, and the structure quietly stops meaning anything.

Edge cases

  • Stock in transit between two of your own warehouses — owned by you, present in neither, and invisible unless modelled.
  • Consignment stock at a customer site, which you own but do not hold.
  • Third-party logistics warehouses, where the location is real but the operator is not you.
  • Warehouses in different states, where an internal transfer becomes a taxable supply requiring an invoice and an e-way bill.

How ERPNext models it

DocTypeNote
WarehouseTree-structured. `is_group` nodes are for rollup and cannot hold stock — posting to one is a frequent misconfiguration.
BinThe item-warehouse pair holding actual, reserved and ordered quantity. This is where 'available' is really computed.
Stock Ledger EntryEvery movement in or out. Immutable; corrections are new entries.

Last reviewed 2026-08-14

Machine-readable version

We implement this for a living — that’s where the mistakes above come from. See the service or request a discovery briefing