---
title: "Warehouses & Stock"
section: "Catalog & Folders"
order: 23
excerpt: "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."
alternate_slug: entrepots
---

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](/en/docs/bundles)** to group articles into reusable templates, or **[Folders & Configuration](/en/docs/folders-configuration)** to learn how billing lines are structured in customer folders.