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
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
- Open Manage -> Branches / Outlet.
- Click New.
- Enter Name exactly as staff and reports should show the outlet.
- Enter Phone with the selected country code.
- Enter Email for branch contact or receipts.
- Enter Address. This should match the location staff recognize.
- Choose Country and State. These affect tax and locale expectations.
- In Add Register, enter a register name when the outlet will use Cash Register.
- Click the green plus if the outlet has more than one physical till.
- Review shared-data choices and product-copy choice before saving.
- Click Save and wait for the success message or new-branch link.
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
- Return to Manage -> Branches / Outlet.
- Find the branch row. Use Filter if the account already has many outlets.
- Open the row and review the detail pane.
- Switch to the branch only when you want the next actions to belong to it.
- Open Edit Branch and finish receipt address, currency, time zone, GSTIN and logo if they were not finished during creation.
- Open Manage -> Cash Register and confirm register rows exist before cashier training.
If Save Fails
| Problem | Likely cause | Action |
|---|---|---|
| Duplicate warning | Branch name and phone already match another branch in the license. | Use the existing branch or correct the phone/name. |
| Plan or cloud limit | The license allows no more branches. | Upgrade or remove an unused branch after owner approval. |
| Register not visible later | Register field was blank or the branch was not saved. | Edit the branch and add a named register. |
| Products missing in new branch | No product copy was selected or copied products have zero stock. | Import/create products and receive or count stock for that branch. |
| Wrong branch after save | Current Branch/Outlet was not switched. | Switch branch before sales or receiving entries. |
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| Unit will not save | Name or Value is blank or too long. | Use a short label and short value. |
| Duplicate warning appears | Another unit already uses the same Value. | Open the existing unit or choose a different value. |
| Item picker does not show the new unit | The item form loaded before the unit was saved. | Reload Add Item or reopen the item form. |
| Old products show an old unit | Existing item records still carry the previous value/name. | Edit affected items after unit cleanup. |
| Cashiers misunderstand quantity | The unit name is too generic for the product. | Use a clearer unit and test the sale screen text. |