Settings
Create and Test a Kiosk Store ID
The Kiosk Account tab stores one 3-6 character alphanumeric Store ID for the current branch. That identifier is used to resolve the branch for kiosk catalog and order requests.
- Menu path
- Settings -> Sales Channels -> Kiosk -> Account
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
Live demo Settings -> Sales Channels -> Kiosk -> Account audited 2026-09-04, frontend/modules/settings_write.html kioskaccount-line, frontend/static/script/js/modules/js/settings.js kioskAccountSettings and validation, api/src/models/setting.model.js kioskAccountSettingsModel uniqueness and branch entry update, api/src/repositories/item.repository.js accessKiosk and accessQr branch resolution, api/src/models/sale.model.js kioskOrderModel branch resolution
What the Store ID Does
The Store ID is the short branch identifier that kiosk and self-order requests use to find the correct Posnic branch. It is not a cashier login, payment key, password or receipt number.
- The current Account tab contains one Store id field and Save; the old secret-key field is not active in the interface.
- The ID is stored inside the current branch's kiosk settings entry.
- Kiosk catalog and order code resolves a branch by this Store ID, so a mistyped ID can make the customer channel report that the branch was not found.
- The ID must be unique. Posnic rejects an ID already used by another kiosk entry.
- Treat the ID as public routing information, not as an authentication secret. Do not use a password or sensitive business value.
Choose a Stable ID
| Rule | Good examples | Avoid |
|---|---|---|
| Length | 3 to 6 characters | Two characters or more than six |
| Characters | Letters and numbers only | Spaces, hyphens, underscores or punctuation |
| Meaning | A short stable outlet code such as MDU01 | A staff name, phone number or temporary campaign |
| Uniqueness | One approved value per kiosk branch | Reusing another branch's ID |
| Security | Public identifier with no secret meaning | PIN, password, gateway key or tax identity |
Create the Store ID
- Confirm the current Posnic branch in the app header.
- Open Settings and choose Sales Channels or Kiosk, depending on the visible navigation label.
- Open Kiosk Settings -> Account.
- Enter the approved 3-6 character Store ID using letters and numbers only.
- Click Save and wait for Kiosk settings updated successfully.
- Leave the page and reopen Account to confirm the saved value loads for this branch.
- Record the branch name and Store ID in the rollout record before configuring customer devices.
Finish the Channel Before Sharing It
A saved Store ID only establishes branch routing. It does not by itself make a kiosk ready for customers.
- Enable the relevant Sales Channels or Kiosk feature for the branch and plan.
- Mark the intended items for the kiosk or sales channel and verify prices, tax, images, stock behavior and availability.
- Configure Kiosk Images for the correct shop identity.
- Configure Kiosk Payment and verify any required Razorpay gateway first.
- Configure Kiosk Print with printer names that exist on the kiosk device or print bridge.
- Open the customer-facing kiosk using the deployment's approved link containing this Store ID.
- Place one controlled order and verify branch, items, totals, customer details, payment, print and Kiosk Report output.
Changing an Existing ID
- Schedule the change while the kiosk is closed to customers; old links or bookmarks can stop resolving after the identifier changes.
- Update every kiosk device, QR code, customer link, sign and support record that contains the old ID.
- Do not change an ID to fix product, image, payment or printer problems; those settings have their own tabs.
- After a rename, test both the new link and the old link. The new one must reach the intended branch, and the old one must not continue accepting orders unexpectedly.
- Keep the previous ID and change time in the rollout log so support can diagnose stale links.
Troubleshooting
| Message or symptom | Likely cause | Action |
|---|---|---|
| Enter the store ID | Field is blank. | Enter the approved ID and save. |
| Minimum 3 characters | ID is too short. | Use 3-6 characters. |
| Maximum 6 characters | ID is too long. | Shorten the approved outlet code. |
| Only letters and numbers allowed | Spaces or punctuation are present. | Remove every non-alphanumeric character. |
| A kiosk with this Store ID already exists | Another kiosk entry already uses it. | Choose a different approved ID; do not overwrite another branch. |
| Branch not found on kiosk | The customer link has a missing, stale or mistyped ID. | Compare it character for character with Account and reopen the correct link. |
| Catalog opens but items are missing | Item kiosk/channel eligibility or availability is incomplete. | Review item sales-channel settings; changing Store ID will not publish items. |
| Order reaches the wrong outlet | A stale link or wrong branch rollout was used. | Stop ordering, verify branch-to-ID mapping, replace the link and run a fresh controlled order. |
Rollout Evidence
- Branch name and Store ID match the approved mapping.
- Account reloads the saved ID.
- Customer kiosk opens the correct branch.
- Only approved items and prices appear.
- One controlled order completes with the intended payment and printer behavior.
- The order appears in Kiosk Reports and reconciles with the sale and payment records.