Point of Sale

The POS Module

The Point of Sale module provides a tablet-friendly POS interface for retail operations. It works online and offline (cached orders sync when reconnected). Integrates with Inventory (stock deduction), Accounting (sales journal), and CRM (customer tracking).

Core Concepts

Accessing POS

• Go to Point of Sale from the main dashboard.
• Click New Session to open a POS session on a connected tablet/browser.
• Set up shops in Configuration > POS Shops.

POS Reporting

POS Analysis

Go to Point of Sale > Reporting > POS Analysis. Pivot with:

• Dimensions: Product, Category, POS Shop, Customer, Payment Method, Session.
• Measures: Quantity, Price, Total, Profit, Number of Orders.
• Filters: Date Range, Shop, Cashier.

Session Reports

Open a closed session: see total sales by payment method, product breakdown, cash difference. Export session PDF for records.

Key Metrics

• Average Order Value – Total / Order Count.
• Items Per Order – Cross-sell effectiveness.
• Cash Difference – Variance between system and actual cash.
• Peak Hours – When most sales occur.

Multi-Branch Consolidated Reporting

On the central server, POS Analysis naturally covers every branch once their orders have synced, letting you compare shops side by side. Use the Sync Log/Conflicts views alongside this — a branch with unusually low reported sales is sometimes actually a sync delay, not a real sales dip.

Bringing a New Branch Online

On the Central Server

1. Confirm Settings > Point of Sale > Instance Role is set to Server.
2. Create/confirm the POS shop that will represent this branch centrally.

On the Local (Branch) Instance

1. Set Instance Role to Local.
2. Enter the Central Server URL (the full HTTPS address of the central Quickenerp).
3. Leave Verify SSL Certificate enabled — only disable it for a private test network with self-signed certificates, never over the open internet.
4. Register the device — this generates an 8-character pairing code shown on screen.

Approving the Pairing (back on the Server)

1. Go to Point of Sale > Configuration > Devices — the new device appears with a pending pairing request.
2. Open the pairing wizard, select the device, and enter the pairing code exactly as shown on the local device.
3. Approve. The server issues the device its API token (used for all future sync requests) — nothing syncs until this human-verified handshake is complete, which prevents a random or misconfigured device from ever pulling or pushing data.

Finishing Setup

1. On the server, create a Counter Map linking this device's local POS shop to the correct server-side POS shop.
2. Assign the branch's Warehouse on the device record, so local stock movements post against the right location.
3. Adjust Pull/Push Interval and Connection Timeout if the branch's internet is slow or intermittent (satellite/mobile links: 60–120 second timeout is a reasonable starting point).
4. Watch the first few sync cycles in the Sync Log to confirm orders are arriving and no conflicts are raised.

If a Device's Token Is Compromised

Open the device record on the server and regenerate its API token — the old token stops working immediately and the local device must be given the new one before it can sync again.