Skip to main content
Catalog & Folders

Warehouses & Stock

Track physical stock across one or more warehouses. Enable stock management on individual articles, record units with serial numbers, and monitor inventory levels directly from each article's page.

BlueRockTEL includes a lightweight warehouse and stock-tracking module. You can define one or more physical locations, assign stock units to them, and monitor inventory levels per article — all from the admin panel.


Managing Warehouses

Navigate to Configuration → Catalog → Warehouses to view, create, and edit your warehouses.

Each warehouse has three fields:

Field Required Description
Name Yes Internal name of the location (e.g. "Main warehouse", "Paris depot")
Location No Free-text address or description of the physical location
Default Mark one warehouse as the default. When a unit is created without an explicit warehouse assignment, it is placed here. Only one warehouse can be the default at a time; setting a new one clears the previous flag automatically.

The warehouse list shows each location's name, optional address, default status, and the current number of tracked units. Click the edit icon to update a warehouse's details at any time.

Tip: For most businesses a single warehouse is sufficient. Create additional warehouses only if you physically separate stock across multiple locations and need to track them independently.


Enabling Stock Management on an Article

Stock tracking is opt-in per article. Open the article's edit page and enable the Manage stock checkbox. Once enabled, individual units of that article can be registered in a warehouse.

The article page (Configuration → Catalog → Items → [article name]) shows a Stock summary card with:

  • Current quantity — total number of units currently in stock across all warehouses
  • Replenishment lead time — how many days it typically takes to reorder this article
  • Supplier stock — optional field to record the quantity currently held by your supplier

Item Units

Each individual physical unit of a stock-tracked article is recorded as a unit in the system. Units are the granular building blocks of your inventory. A unit holds:

Field Description
Article Which catalog article this unit belongs to
Warehouse Where the unit is physically located
Status Current state — in_stock by default
Serial number Optional identifier for individually serialised equipment (routers, phones, etc.)
Supplier price Links the unit to a specific supplier price entry on the article — useful to track which batch a unit came from and at what cost
Buying price override Overrides the supplier price for this specific unit if it was purchased at a different rate
Notes Free-text field for internal notes

When a unit is assigned to a customer folder (as a one-time charge line), it is automatically linked to that folder's billing record, giving you full traceability from warehouse to invoice.


Typical Workflow

  1. Create your warehouses at Configuration → Catalog → Warehouses.
  2. Enable stock management on the articles you want to track (article edit page → Manage stock checkbox).
  3. Register incoming units — add a unit record for each physical item received, assigning it to a warehouse and optionally a serial number and supplier price.
  4. Assign units to customer folders — when adding a one-time charge line in a folder, select the specific unit to consume it from stock.
  5. Monitor levels — the article's detail page always shows the current quantity in stock.

Next Steps

See Bundles to group articles into reusable templates, or Folders & Configuration to learn how billing lines are structured in customer folders.