Settings and Sync

The Settings screen holds the options that belong to this device: language, counter number, offline data, sync and display preferences. Company-wide rules (taxes, buttons, payment methods) are set by the administrator on the server. Those are listed in Settings reference.

Open it from the menu: Settings. You need the menu.settings.main.access permission.

*Settings: Company Info, Language, POS Counter Identity (Counter 11 + device id), Offline Data (1430 products cached), Last Product Sync, Resync Products, Realtime Sync Tester, Offline Mode, Notification Position, Screen Orientation, Developer Mode, Clear Local Storage, Clear Product Cache*

The Settings cards

The cards appear in this order.

Company Information

*Settings > Company Information: signed-in user, company, username, email, role, customer ID, company ID, token type, time zone, base URL and app version*

This page is read-only. It shows Company Name, Logged In Username, Logged In Email, User Role, Customer ID (your user id), Company ID, Token Type, Timezone, Base URL and App Version.

Support staff often ask for the Base URL and App Version. Read them from here. Tap Back to Settings to return.

POS Counter Identity

*POS Counter Identity: counter number 1-999 (unique per store) becomes part of every offline receipt number; last bill today, optional last-bill override after a reinstall, next bill number and device ID*

The card shows:

• Counter number (use 1–999). In the demo: 11.
• Last bill on this device today: …, or No bills on this device today for this counter.
• Last bill sold today (optional) — used after a reinstall.
• Next bill No.: … — the next receipt number this counter will issue.
• Device ID: … — a fixed id for this installation.

To set or change the counter:

1. Enter the counter number.
2. Save. You see "Counter 11 saved. Next bill No.: 2-11-261027-0004" (for the demo store on 27 October 2026).

Rules:

• Every counter in the same store must use a different number. Two tills with the same number would print the same receipt numbers.
• Changing the number does not change receipts already issued.
• The number is saved per store. If you switch store, set it for that store too.
• If you have not chosen a store yet you see Select a store before configuring this counter.

After a reinstall

Clear Local Storage and Reset API Key keep the counter number and today's bill count. Uninstalling the app, or clearing the app's data in the phone or Windows settings, does not. After that the device forgets today's bill count. To avoid duplicate numbers:

1. In the admin panel, find this counter's last bill today. Example: 2-11-261027-0010.
2. Enter the last digits in Last bill sold today (optional). For that example, enter 10.
3. Save. The next bill becomes 0011.

Bill numbers can only move forward. If you enter a lower number than the device has already issued, you see "Bill numbers can only move forward. This device already issued …".

Offline Data

Tap Offline Data to see what is stored on this device for billing and offline use.

*Settings > Offline Data: what is cached on this device for billing and offline use (products, categories, last sync, payment methods, delivery methods, document configs, …) with per-row Sync / Clear, Sync section and Sync All*

The page is grouped into sections. Each row shows a count and has Sync and Clear buttons. Each section has Sync section. The bottom has Sync All.

When to use it:

• A new payment method or delivery method was added in the admin panel → Sync that row.
• Receipt layout changed in the admin panel → Sync on Document configurations.
• A new user role or permission was given → Sync on Roles & permissions.
• Everything looks out of date → Sync All. You see Offline data synced successfully.

Status messages at the top:

• Offline mode is on. Disable it in Settings to sync.
• No internet connection. Sync is unavailable right now.

Clear on a row asks first. Do not clear Confirmed orders unless every order has reached the server. Check Sales → Confirmed Orders first.

Resync Products

Use Resync Products when prices or products look wrong on billing.

1. Make sure the cart is empty and you are online.
2. Tap Resync Products. You see Resyncing....
3. When done: "Products resynced successfully (N items)".

Possible messages:

Offline Mode

Turn on Offline Mode when the internet is unreliable and you want the app to stop trying.

• On: "Offline Mode enabled. Online actions are now blocked." Billing still works from the cached products. Sales are saved on the device.
• Off: "Offline Mode disabled. Online actions are available again."
• Off with no connection: "Offline Mode disabled, but internet is still unavailable."

Remember to turn it off when the connection is back. Then send pending sales from Sales → Confirmed Orders.

Developer Mode

Developer Mode adds a Development Printer that writes print output to a folder instead of paper. It is for testing layouts.

• On: "Developer Mode enabled. Select Development Printer in Printer settings."
• Off: "Developer Mode disabled. Physical printer settings restored."

Keep it off on real tills.

Clear Local Storage

This is the last resort when the app behaves strangely.

1. Make sure Sales → Confirmed Orders says every order has reached the server.
2. Tap Clear Local Storage.
3. Read the warning: "This will clear all local data except login credentials and log you out. Are you sure?"
4. Tap Clear & Logout.
5. Log in again, pick the store and let the sync finish.

What is kept:

• The API key and server, so you do not enter the key again.
• Remember Me login details.
• The counter number, the device ID and today's bill sequence. Receipt numbers carry on without gaps or duplicates.
• Printer choices, paper sizes, receipt themes, language and sidebar layout.

To change the API key, use Reset API Key on the login screen. That also keeps the counter number and bill sequence.

How it works

What is stored on the device

• Products, stock, categories, customers and configuration are cached on the device. This is what makes offline billing possible.
• The session (token, role, company, stores, active store, time zone) is stored on the device.
• Printer choices, paper sizes and receipt themes are stored per device.
• Counter numbers are stored per store. The daily receipt sequence is stored per counter.

What the Offline Data rows download

Realtime sync

While the app is open, it stays connected to the server for live changes.

1. After the store sync, the app opens a secure WebSocket (Laravel Reverb) and joins the private channel private-company.<company id>.sync. The channel is authorised with your session.
2. When something changes on the server (a product, price, stock, customer or sale), the server sends a data.changed event.
3. The app then asks the server for the changes since its last check (GET /api/v1/sync/changes?since=<cursor>&store_id=<id>) and updates only what changed.
4. Product and price changes wait while the cart has items. They are applied once the cart is empty, so a price never changes in the middle of a sale.
5. If the connection drops, the app retries with growing waits (1, 2, 4 … up to 30 seconds), and catches up on reconnect.

See Sync and realtime API.

Pending sales sync

• Confirmed sales are kept on the device until the server accepts them.
• Synced records are removed from the device after 30 days.
• Sales that failed or got an unclear answer appear in Sales → Confirmed Orders (the Sync attention page). There is no automatic retry. See Troubleshooting and FAQ.

Related

• Sync and realtime API
• Settings and master data API
• Products and categories API
• Settings reference
• Getting started
• Printing
• Sales and orders
• Troubleshooting and FAQ