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.
Planned. Defined, not yet operational. No stock.
State 1 of 4
Warehouse holds Item.
Open ItemRack-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
| DocType | Note |
|---|---|
| Warehouse | Tree-structured. `is_group` nodes are for rollup and cannot hold stock — posting to one is a frequent misconfiguration. |
| Bin | The item-warehouse pair holding actual, reserved and ordered quantity. This is where 'available' is really computed. |
| Stock Ledger Entry | Every movement in or out. Immutable; corrections are new entries. |
Last reviewed 2026-08-14
Machine-readable versionWe implement this for a living — that’s where the mistakes above come from. See the service or request a discovery briefing