Warehouses
Physical or virtual storage locations — every stock movement points to one.
Warehouses#
A warehouse is a place where stock lives in Neriyam. Every stock movement — opening, receipt, delivery, transfer, adjustment — is associated with a warehouse. Warehouses can be physical (a real storage space) or virtual (a bucket used for categorising stock).
Fields#
| Field | Required | Editable after creation? | Notes |
|---|---|---|---|
| Code | Yes | No | Short unique identifier; immutable |
| Name | Yes | No | Descriptive name; immutable |
| Location | Yes | No | Links the warehouse to one of your company locations (from Company Profile) |
| Active | Yes | Yes | Toggle — controls whether the warehouse appears in pickers |
Code, Name, and Location are set at creation and cannot be edited afterwards. If you need to change any of them, deactivate the warehouse and create a new one (transfer any residual stock first).
System-reserved warehouses#
Some warehouses are system warehouses created automatically by Neriyam for internal purposes (e.g., a default scrap warehouse). They:
- Have a read-only System flag on the list
- Show a System Purpose label
- Cannot be edited or deleted
System warehouses behave normally as far as stock movements are concerned — they just cannot be renamed or removed.
Creating a warehouse#
- Navigate to Inventory › Warehouses
- Click + New Warehouse
- Enter Code, Name, and pick a Location
- Click Save
Prefix the code with the location — CHN-MAIN, BLR-DISPATCH, CHN-SCRAP. Consistent codes pay off when you are scanning a long list.
Locations vs. warehouses#
Do not confuse the two:
- Location (from Settings › Company Profile) — a real business site: "Chennai Factory", "Bangalore Branch". Locations carry the address and GSTIN.
- Warehouse — a storage space within a location: "Main Store", "Receiving Bay", "Dispatch Staging", "Quarantine".
A location can have many warehouses. A warehouse lives at exactly one location.
Common warehouse patterns#
For a single-site shop:
CHN-MAIN (primary storage)
CHN-SHOP (shop floor — material being worked on)
CHN-DISPATCH (ready to ship)
CHN-SCRAP (write-offs — often system warehouse)
CHN-QC (awaiting inspection)
For multi-site:
CHN-MAIN BLR-MAIN
CHN-SHOP BLR-SHOP
CHN-DISPATCH BLR-DISPATCH
Activate / deactivate#
Deactivating a warehouse:
- Hides it from pickers (cannot be selected for new stock entries)
- Preserves historical records and the stock ledger
Neriyam blocks deactivation if the warehouse has non-zero stock — move or scrap the stock first.
Deleting#
Deletion is only possible when the warehouse has never been used (no stock ledger entries against it). For a warehouse you have used even once, deactivate instead of delete.
Default warehouses#
Your admin sets three defaults in Settings › Inventory Settings:
- Default Receiving Warehouse — pre-filled when creating a GRN
- Default Dispatch Warehouse — pre-filled when creating an SDN
- Default Scrap Warehouse — pre-filled when creating a Scrap Entry
Setting these up saves a click on every operational form.
List page#
- Search by code or name
- Filters: Show Inactive (checkbox), Show System (checkbox)
- Columns: Code, Name, Location, Active toggle, System flag
- Row actions: Edit (limited to Active toggle), Deactivate / Activate
Permissions#
| Action | Permission |
|---|---|
| View warehouses | INVENTORY.VIEW_WAREHOUSES |
| Create, edit, activate/deactivate | INVENTORY.MANAGE_WAREHOUSES |
Related#
- Items — Stock Policies are set per warehouse on the item
- Stock Ledger — every entry names a warehouse
- Stock Transfer — moves stock between warehouses
- Settings › Company Profile — manage the Locations that warehouses belong to
- Settings › Inventory Settings — where default warehouses are set
Last updated