Warehouses & Branches

Branches

Branches (/app/branches) is the multi-branch/store structure - each branch is a physical location, with its own POS terminals, users, and item assignment. Items can be bulk-assigned or unassigned to a branch, and each branch has a branch weather endpoint (/api/branches/{id}/weather), used to power a dashboard/ops widget.

Warehouses

Warehouses (/app/warehouses) is the stock-location master. A branch can have more than one warehouse, and warehouses support bin-level detail (items/{id}/default-bins, items/{id}/bin-content) for tracking exactly where within a warehouse an item’s stock sits.

Why this comes first in setup

Almost everything else in the system - users, POS terminals, stock, transfers - attaches to this structure, so it’s the second step in Getting Started, right after business setup.