TradeOne logo TRADEONEUSER GUIDE

Branches

What a Branch Is

A branch is one physical site of your business, for example "Baraka Water Point - Kasarani" and "Baraka Water Point - Ruiru". Each branch has its own locations (counter, stores) and its own staff.

If you have just one shop you never need to think about branches. The branch switcher stays hidden. Every business has one default branch and everything lives in it.

The Branches Tab

Open Administration > Admin > Branches (needs branches.view). The tab explains: "Physical sites. Each branch owns its own locations and staff; users switch between the branches they are assigned to."

Each row shows the branch, its status and a Default badge. The row menu offers Edit, Make default, Deactivate or Activate, and Delete. To add, edit or remove branches you need branches.manage.

Adding a Branch

Press New branch. Fill in:

Field Notes
Name Required, up to 100 characters
Code (optional) A short label such as NRB. Must be unique
Address (optional) Up to 255 characters
Phone (optional)
Latitude (optional), Longitude (optional) Fill in both or neither. "Pin the shop so drivers' planned routes end back here."
Active

Press Create. You see "Branch created." Editing shows "Branch updated."

After adding a branch:

  1. Add its locations in Inventory > Locations. Pick the branch on the location form. See Locations.
  2. Assign staff to it on the Staff tab. See Users and Roles.

The Default Branch

One branch is always the default. It cannot be deactivated or deleted.

Choose Make default to change the default branch. You see "Baraka Water Point - Kasarani is now the default branch." The new default is also made active.

Deactivating and Deleting

Action Result
Deactivate the default branch "The default branch cannot be deactivated."
Delete the default branch "The default branch cannot be deleted."
Delete a branch that still has locations "Move this branch's locations elsewhere before deleting it."
Delete an empty branch Asks "Delete this branch?" then "Branch deleted."

Working in a Branch

On the web, a branch switcher shows at the top right when you may use more than one branch. Pick one and the page reloads. From then on:

  • Stock levels, the Stock Levels and Transfers pickers and inventory reports show only that branch's locations.
  • Sales, service sales, purchases and production orders show only that branch's records.
  • The till sells from that branch's default counter.
  • Held sales and saved purchase drafts belong to the branch where you made them.
  • The delivery desk lists only deliveries for sales made in the branch, and only drivers attached to it.

A user with branches.access-all can pick All branches to see everything together.

Branch access follows the staff record. A user can switch only between the branches their staff member is assigned to.

Branches and the Mobile App

The app asks you to choose a branch after you sign in, if you may use more than one. You can change it in Menu > Settings > Branch. See Signing In.