Pairing a New Branch (Setup Walkthrough)

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.