TixFinDocs

Scan offline or by hand in the browser

Keep the browser scanner working without a network, sync the scans later, and enter codes by hand

3 min read

The browser scanner can keep checking tickets when the network drops, using a snapshot of the ticket list you download beforehand. For codes that won't scan, type them in.

Where: Events & tickets → Check-in (page Ticket scanner) Who can do this: Scan tickets

Browser scanner offline banner with snapshot and queue
  1. Check-in list
  2. Download snapshot
  3. Expires
  4. Scans waiting to sync
  5. Sync queue
📸 Browser scanner offline banner with snapshot and queue

The phone app prepares and syncs its offline data by itself: see Scan offline in the app.

Download the offline snapshot

While online, open the scanner and choose the event.
Choose a specific Check-in list. A snapshot can't be made for Entire event.
Click Download snapshot. The banner shows how many tickets are in it (… tickets in snapshot), when it was Last downloaded and when it Expires.

A snapshot expires at the latest 12 hours after the download. Download it again shortly before the doors open.

Scan without a network

When the connection drops, the banner switches to Offline mode active. Keep scanning as usual. Each scan is checked against the snapshot and stored on the device: Stored offline – "Scan stored locally and queued for later synchronization." The badge shows how many scans are waiting (… pending).

Keep the browser tab open while offline. Reloading the page without a connection does not bring the scanner back.

Sync the scans

When the connection is back, click Sync queue. The result shows how many scans were synced and how many conflicted, for example "3 synced, 1 conflicted". The queue table shows each scan as Waiting, Synced, Conflict or Failed.

A conflict means the ticket had already been used, or its state changed after the snapshot was made. The scan is kept and flagged for review, not thrown away. Syncing does not happen by itself in the browser.

Clear offline data deletes the snapshot and any scans still waiting. Hold the button to confirm. Sync first, or the waiting scans are lost.

Enter a code by hand

If a QR code won't scan, for example on a cracked screen:

Switch to the Manual tab.
Type the code into QR code. A USB barcode scanner that types into the field works too.
Click Scan entry (or Scan exit in Exit mode).

The field stays focused after each scan, so you can enter the next code straight away.

Manual entry tab of the browser scanner
  1. Entry or Exit
  2. Manual
  3. QR code
  4. Scan entry
📸 Manual entry tab of the browser scanner

Common problems

  • "Select a concrete check-in list for the offline snapshot." Choose a list instead of Entire event.
  • "No offline snapshot". You are offline without a snapshot. Download one for this event as soon as you are online.
  • "Snapshot expired". Download a fresh snapshot while online.
  • "Ticket not in snapshot". The ticket is not in the downloaded list, for example because it was sold after the download or belongs to another list. Check it again once you are online.
  • "The local ticket state does not allow this action." The ticket was already scanned on this device (entry), or is not checked in (exit).
  • "Could not sync offline queue". Check the connection and click Sync queue again. Don't clear the offline data until the sync worked.

On this page