Settings

Create a Branch or Outlet With Registers and Shared Data

Use New Branch when opening another shop, counter, warehouse outlet or branch that needs its own receipt identity and register setup.

Menu path
Manage -> Branches / Outlet -> New
Verified from
Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence

frontend/modals/branch.html branch_add_form, frontend/static/script/js/modules/js/branches.js showAdd branch sharingChoice fillCopyFrom, api/src/controllers/branches.controller.js add, api/src/models/branch.model.js createBranch, api/src/services/catalogueCopy

Add Branch required fieldsName, phone, email, address, country and state are required before the new branch can be saved.
Shared data and product copyCustomers and suppliers start checked; product list copy is a separate one-time decision and stock counts start at zero.
Return to Branches listAfter save, open the branch list and confirm the outlet exists before training staff.

When to Create a Branch

Create a branch only when the new location needs its own operating context. Do not create a branch just to separate one cashier or one temporary sale.

  • Use a branch for a physical shop, outlet, warehouse counter or location with its own receipt address.
  • Use registers inside one branch when several tills belong to the same shop.
  • Use customer categories, item categories or reports when you only need grouping inside the same outlet.
  • Confirm the plan allows another branch before promising a multi-outlet rollout.
  • Create the branch before importing location-specific stock counts.

Fill the Add Branch Drawer

  1. Open Manage -> Branches / Outlet.
  2. Click New.
  3. Enter Name exactly as staff and reports should show the outlet.
  4. Enter Phone with the selected country code.
  5. Enter Email for branch contact or receipts.
  6. Enter Address. This should match the location staff recognize.
  7. Choose Country and State. These affect tax and locale expectations.
  8. In Add Register, enter a register name when the outlet will use Cash Register.
  9. Click the green plus if the outlet has more than one physical till.
  10. Review shared-data choices and product-copy choice before saving.
  11. Click Save and wait for the success message or new-branch link.

Shared Data Choices

The Add Branch drawer separates shared account-level records from product-list copying. That distinction matters when opening a second shop.

ChoiceDefaultUse whenImportant warning
CustomersCheckedOne customer account, balance and loyalty record should be visible across shops.Turn off only when branches manage totally separate customers.
SuppliersCheckedThe same supplier contacts are used across shops.Supplier sharing does not mean purchase quantities are shared.
Start with the same products asNothing - I will add products myselfThe new branch sells the same catalog, prices, tax and categories.Stock counts start at zero; physical stock must be counted in that branch.
Empty product listSelectable by leaving copy blankThe outlet has a different catalog or should import stock later.Cashiers cannot sell items until the branch has sellable products.

Register Names During Creation

Register names are not payment methods. They are physical till or drawer names for Cash Register sessions.

  • Use names staff can say out loud, such as Main Counter, Front Till or Pharmacy Desk.
  • Register names need at least 3 characters and up to 20 characters in the source validation.
  • Create one register per physical cash drawer or controlled counter station.
  • Do not create one register per cashier; cashiers log into a register session.
  • If Cash Register is off, sales can continue without opening a register, but the names should still be ready before enabling drawer control.

After Save

  1. Return to Manage -> Branches / Outlet.
  2. Find the branch row. Use Filter if the account already has many outlets.
  3. Open the row and review the detail pane.
  4. Switch to the branch only when you want the next actions to belong to it.
  5. Open Edit Branch and finish receipt address, currency, time zone, GSTIN and logo if they were not finished during creation.
  6. Open Manage -> Cash Register and confirm register rows exist before cashier training.

If Save Fails

ProblemLikely causeAction
Duplicate warningBranch name and phone already match another branch in the license.Use the existing branch or correct the phone/name.
Plan or cloud limitThe license allows no more branches.Upgrade or remove an unused branch after owner approval.
Register not visible laterRegister field was blank or the branch was not saved.Edit the branch and add a named register.
Products missing in new branchNo product copy was selected or copied products have zero stock.Import/create products and receive or count stock for that branch.
Wrong branch after saveCurrent Branch/Outlet was not switched.Switch branch before sales or receiving entries.

Troubleshooting

ProblemLikely causeFix
Unit will not saveName or Value is blank or too long.Use a short label and short value.
Duplicate warning appearsAnother unit already uses the same Value.Open the existing unit or choose a different value.
Item picker does not show the new unitThe item form loaded before the unit was saved.Reload Add Item or reopen the item form.
Old products show an old unitExisting item records still carry the previous value/name.Edit affected items after unit cleanup.
Cashiers misunderstand quantityThe unit name is too generic for the product.Use a clearer unit and test the sale screen text.