Branch Supply Manual for the Main Warehouse
Last Updated: October 2026
Audience: Main Warehouse administrators using the Admin panel
This manual explains how the Main Warehouse sends stock to bakery branches, and how the Main Warehouse controls local supplier purchases made by branches. Branch staff use a separate guide: the Branch Inventory Manual. Before using this manual, make sure Main Warehouse stock exists (see the Main Warehouse Inventory and Procurement Manual).
How the flow works
Stock from the Main Warehouse
- A branch creates and submits a stock request.
- The Main Warehouse opens the request and creates a delivery (a draft).
- The Main Warehouse checks the quantities and dispatches the delivery. Main Warehouse stock goes down and the branch shows the quantity as in transit.
- The branch confirms what arrived. Branch stock goes up and in transit goes down.
- If the branch received less than was sent and nothing more is coming, the Main Warehouse closes the short delivery. The missing quantity goes back to Main Warehouse stock.
Local purchase by a branch
- The branch records what a local supplier delivered.
- If the item needs approval, the branch submits it and the Main Warehouse approves and posts it. Otherwise the branch posts it itself.
Requests and deliveries only move stock when the Main Warehouse dispatches. A request on its own never changes stock.
Where to find things
In the Admin panel:
| Menu | Use it to |
|---|---|
| Branch supply → Supply rules | Decide how each branch may get each item |
| Branch supply → Stock requests | See and manage branch requests |
| Branch supply → Deliveries | Create, dispatch and close deliveries |
| Branch supply → Branch purchases | See, edit and approve local purchases |
| Ingredients & Packaging Inventory → Settings → Locations | Create branch stock rooms |
| Ingredients & Packaging Inventory → Stock levels | Check the Main Warehouse and branch quantities |
Who can do what
| Role | Access |
|---|---|
| Super admin, Administrator | Everything in Branch supply: create, edit, dispatch, close, approve |
| Executive, HR admin, Payroll master, Office staff | View the lists and records only |
| Branch inventory (branch staff) | Uses the separate Branch panel. No access to the Admin panel. |
Before branches can use the system
1. Create branch stock rooms
Each branch needs one stock room (a location where its stock is held).
- Go to Settings → Locations.
- Select Create missing branch stock rooms and confirm.
- You will see Branch stock rooms ready with the number created.
Run this again whenever you open a new branch. Branches that already have a stock room are skipped.
2. Set up branch staff
For each branch inventory user:
- Give the user the Branch inventory role.
- Make sure their employee record has the correct Default branch.
A branch user only sees records for the branch on their employee record. If it is empty, their lists are empty.
3. Save supply rules
Without a rule, a branch cannot request or buy that item. See below.
Supply rules
Go to Branch supply → Supply rules and select the New button at the top right of the list. There is one rule per branch and item.
| Field | Notes |
|---|---|
| Branch | Required |
| Item | Active items that track inventory |
| Sourcing policy | From Main Warehouse, Local purchase, or Main Warehouse or local |
| Allow local purchase | Must be on for the branch to record local purchases |
| Main Warehouse must approve local purchases | When on, the branch cannot post the purchase itself. The Main Warehouse approves it. |
| Preferred local supplier | Optional note of the usual supplier |
| Minimum stock and Reorder level | Reference numbers only. They do not trigger alerts or orders. |
| Is active | Turn off to stop the rule from applying |
What each combination allows
| Policy | Branch can request from the Main Warehouse | Branch can record local purchase |
|---|---|---|
| From Main Warehouse | Yes | No |
| Local purchase | No | Yes, if Allow local purchase is on |
| Main Warehouse or local | Yes | Yes, if Allow local purchase is on |
An inactive rule or a missing rule blocks both.
Use the table filters for Sourcing policy, Branch and Is active.
Stock requests
Go to Branch supply → Stock requests. Numbers look like BSR-20261013-000001.
Branch staff normally create their own requests. The Main Warehouse can also create one for any branch with the New button on the list: pick the Branch, add notes, and add lines with an Item and Quantity. Item lists only show items the Main Warehouse may supply to that branch. Quantities are always in the item's stock unit (base unit).
Request statuses
| Status | Meaning |
|---|---|
| Draft | Not sent yet. Can be edited or deleted. |
| Submitted | Sent to the Main Warehouse. Waiting for a delivery. |
| Partially fulfilled | Some quantity has been dispatched. |
| Fulfilled | The full quantity has been dispatched. |
| Cancelled | Closed without delivery. |
Actions
| Action | When it shows | Effect |
|---|---|---|
| Submit | Draft | Sends the request to the Main Warehouse. A request needs at least one line. |
| Cancel | Draft or Submitted, and no delivery has been dispatched, partly received or received | Cancels the request |
| Create delivery | Submitted or Partially fulfilled, with quantity still to send | Creates a draft delivery for the remaining quantities. Opens the draft so you can check it. |
Deliveries
Go to Branch supply → Deliveries. Numbers look like TRF-20261013-000001.
Create a delivery
From a request (usual way):
- Open the request and select Create delivery. Confirm.
- The draft delivery opens. Quantity to send is filled with what is still outstanding.
Without a request:
- In Deliveries, select the New button at the top right of the list.
- Choose the Branch. Branch stock room is filled in for you and From location is the Main Warehouse.
- Add lines with Item and Quantity to send. Only items the Main Warehouse may supply to that branch are listed.
You can edit or delete a delivery while it is a Draft. Creating a draft does not move stock.
Dispatch
- Open the draft delivery.
- Select Dispatch and confirm: Send this delivery? Main Warehouse stock will move into transit.
What happens:
- Main Warehouse on-hand goes down by the quantity sent.
- The branch's In transit goes up by the same quantity.
- Stock is taken from the batches that expire first. Batches without an expiry date are used after dated ones. Stock that came from an opening balance has no batch and is taken last.
- A unit cost is saved on each line from the batches used.
- The linked request's fulfilled quantity goes up and its status updates.
- The delivery becomes Dispatched.
Dispatch is blocked if the Main Warehouse does not have enough stock, if the item is not set to be supplied from the Main Warehouse for that branch, or if the quantity is more than the request still needs.
Delivery statuses
| Status | Meaning |
|---|---|
| Draft | Being prepared. No stock moved. |
| Dispatched | Sent. Quantity is in transit to the branch. |
| Partially received | The branch confirmed some of the quantity. |
| Received | The branch confirmed everything. |
| Closed | The Main Warehouse closed the delivery short. |
Branch confirms receipt
The branch confirms what arrived from the Branch panel. Only a user whose employee record belongs to that branch can do it. A Main Warehouse administrator whose employee record is not at that branch will not see the Confirm what arrived button.
Close a short delivery
Use this when the branch received less than was sent and the rest will not arrive.
- Open the delivery (status Dispatched or Partially received).
- Select Close short delivery and confirm: Close this delivery and return anything not received to Main Warehouse stock?
What happens:
- The quantity not received returns to Main Warehouse on-hand.
- Batches are restored, so the stock is available again in the same batches.
- The branch's in-transit quantity for the delivery is cleared.
- The request's fulfilled quantity goes down by the missing amount, so a new delivery can be created for it. A Fulfilled request goes back to Partially fulfilled or Submitted.
- Quantities the branch already accepted stay with the branch.
- The delivery becomes Closed.
Branch purchases and approval
Go to Branch supply → Branch purchases. Numbers look like BPR-20261013-000001.
Statuses
| Status | Meaning |
|---|---|
| Draft | Saved but not posted. Can be edited. |
| Pending approval | Waiting for the Main Warehouse. |
| Posted | Stock has been added to the branch stock room. |
Approve a purchase
- Open a purchase with status Pending approval.
- Review the supplier, items, quantities, costs, batch numbers and expiry dates.
- Select Approve and post and confirm: Approve this purchase and add the stock to the branch?
Posting adds the stock to the branch stock room, creates a batch for each line, and adds each unit price to the item's purchase price history. The purchase shows who approved it and when.
Record a purchase for a branch
The Main Warehouse can also create a purchase with the New button on the list: choose Branch, Supplier, Purchased at, then lines with Item, Purchase unit, Quantity, Unit cost, Additional cost, Batch number and Expiry date. Then:
- Submit for approval shows when any line's rule requires approval.
- Post shows when no line requires approval.
- Items must be allowed for local purchase in that branch's supply rules. Expiry date is required for items that track expiry.
Checking stock
Go to Stock levels and filter by Location:
- Main Warehouse shows Main Warehouse stock. After a dispatch, On hand drops.
- The branch's stock room (named after the branch) shows branch stock. After a dispatch its In transit goes up (turn on the column in the column toggle). After the branch confirms receipt, On hand goes up and In transit goes down.
The Stock ledger shows each step as Transfer out, Transfer in and Branch purchase receipt entries.
Common messages and what to do
| Message | Cause | Fix |
|---|---|---|
| Item SKU is not configured for Main Warehouse supply. | No supply rule, rule inactive, or policy is Local purchase | Save or fix the supply rule |
| Insufficient stock for item SKU at location hq-warehouse. | The Main Warehouse does not have enough on hand | Receive stock first or lower the quantity |
| Delivery quantity cannot exceed the remaining requested quantity. | More than the request still needs | Lower the quantity |
| Only submitted or partially fulfilled requests can create a delivery. | Request is Draft, Fulfilled or Cancelled | Check the request status |
| This request has no remaining quantity to deliver. | Everything is already dispatched | Nothing to send |
| The Main Warehouse location is missing. | Main Warehouse location was removed or renamed | Ask a system administrator |
| Only draft deliveries can be dispatched. | Already dispatched | Nothing to do |
| Item SKU is not configured for local purchase. | Rule missing, inactive, Main Warehouse only, or Allow local purchase is off | Fix the supply rule |
| This branch purchase requires Main Warehouse approval. | Posting directly when approval is required | Use Submit for approval, then Approve and post |
| This branch purchase does not require approval and should be posted directly. | Submitting a purchase that needs no approval | Use Post |
| Expiry date is required for item SKU. | Item tracks expiry | Enter the date |
| Each branch purchase line must have a batch number. | Missing batch number | Enter it |
| Add at least one request line | Submitting an empty request | Add a line |
Frequently asked questions
Does a request reserve Main Warehouse stock? No. Stock moves only when the delivery is dispatched.
Can the Main Warehouse send stock without a request? Yes. Use the New button on the Deliveries list.
Can I change a delivery after dispatch? No. You can only wait for the branch to confirm receipt, or close it short.
A branch says some items never arrived. What do I do? Ask the branch to confirm what arrived. Then use Close short delivery. The missing quantity returns to the Main Warehouse and the request can be delivered again.
Which unit are request and delivery quantities in? The item's stock unit (base unit), for example grams or pieces. Local purchases are entered in a purchase unit and converted.
Can branch staff see other branches? No. They only see their own branch's records.
Recipes and bakes are covered in the Production Recipes Manual for the Main Warehouse. Not covered yet: wastage, damage, stock corrections, supplier returns and sales deductions.