Skip to main content

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

  1. A branch creates and submits a stock request.
  2. The Main Warehouse opens the request and creates a delivery (a draft).
  3. The Main Warehouse checks the quantities and dispatches the delivery. Main Warehouse stock goes down and the branch shows the quantity as in transit.
  4. The branch confirms what arrived. Branch stock goes up and in transit goes down.
  5. 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

  1. The branch records what a local supplier delivered.
  2. 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:

MenuUse it to
Branch supply → Supply rulesDecide how each branch may get each item
Branch supply → Stock requestsSee and manage branch requests
Branch supply → DeliveriesCreate, dispatch and close deliveries
Branch supply → Branch purchasesSee, edit and approve local purchases
Ingredients & Packaging Inventory → Settings → LocationsCreate branch stock rooms
Ingredients & Packaging Inventory → Stock levelsCheck the Main Warehouse and branch quantities

Who can do what

RoleAccess
Super admin, AdministratorEverything in Branch supply: create, edit, dispatch, close, approve
Executive, HR admin, Payroll master, Office staffView 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).

  1. Go to Settings → Locations.
  2. Select Create missing branch stock rooms and confirm.
  3. 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.

FieldNotes
BranchRequired
ItemActive items that track inventory
Sourcing policyFrom Main Warehouse, Local purchase, or Main Warehouse or local
Allow local purchaseMust be on for the branch to record local purchases
Main Warehouse must approve local purchasesWhen on, the branch cannot post the purchase itself. The Main Warehouse approves it.
Preferred local supplierOptional note of the usual supplier
Minimum stock and Reorder levelReference numbers only. They do not trigger alerts or orders.
Is activeTurn off to stop the rule from applying

What each combination allows​

PolicyBranch can request from the Main WarehouseBranch can record local purchase
From Main WarehouseYesNo
Local purchaseNoYes, if Allow local purchase is on
Main Warehouse or localYesYes, 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​

StatusMeaning
DraftNot sent yet. Can be edited or deleted.
SubmittedSent to the Main Warehouse. Waiting for a delivery.
Partially fulfilledSome quantity has been dispatched.
FulfilledThe full quantity has been dispatched.
CancelledClosed without delivery.

Actions​

ActionWhen it showsEffect
SubmitDraftSends the request to the Main Warehouse. A request needs at least one line.
CancelDraft or Submitted, and no delivery has been dispatched, partly received or receivedCancels the request
Create deliverySubmitted or Partially fulfilled, with quantity still to sendCreates 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):

  1. Open the request and select Create delivery. Confirm.
  2. The draft delivery opens. Quantity to send is filled with what is still outstanding.

Without a request:

  1. In Deliveries, select the New button at the top right of the list.
  2. Choose the Branch. Branch stock room is filled in for you and From location is the Main Warehouse.
  3. 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​

  1. Open the draft delivery.
  2. 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​

StatusMeaning
DraftBeing prepared. No stock moved.
DispatchedSent. Quantity is in transit to the branch.
Partially receivedThe branch confirmed some of the quantity.
ReceivedThe branch confirmed everything.
ClosedThe 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.

  1. Open the delivery (status Dispatched or Partially received).
  2. 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​

StatusMeaning
DraftSaved but not posted. Can be edited.
Pending approvalWaiting for the Main Warehouse.
PostedStock has been added to the branch stock room.

Approve a purchase​

  1. Open a purchase with status Pending approval.
  2. Review the supplier, items, quantities, costs, batch numbers and expiry dates.
  3. 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​

MessageCauseFix
Item SKU is not configured for Main Warehouse supply.No supply rule, rule inactive, or policy is Local purchaseSave or fix the supply rule
Insufficient stock for item SKU at location hq-warehouse.The Main Warehouse does not have enough on handReceive stock first or lower the quantity
Delivery quantity cannot exceed the remaining requested quantity.More than the request still needsLower the quantity
Only submitted or partially fulfilled requests can create a delivery.Request is Draft, Fulfilled or CancelledCheck the request status
This request has no remaining quantity to deliver.Everything is already dispatchedNothing to send
The Main Warehouse location is missing.Main Warehouse location was removed or renamedAsk a system administrator
Only draft deliveries can be dispatched.Already dispatchedNothing to do
Item SKU is not configured for local purchase.Rule missing, inactive, Main Warehouse only, or Allow local purchase is offFix the supply rule
This branch purchase requires Main Warehouse approval.Posting directly when approval is requiredUse 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 approvalUse Post
Expiry date is required for item SKU.Item tracks expiryEnter the date
Each branch purchase line must have a batch number.Missing batch numberEnter it
Add at least one request lineSubmitting an empty requestAdd 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.