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