Skip to content
JCC Inventory — Point of Sale

Documentation

Getting set up, and what to expect

A shop with a clean product list is usually selling on the same day. Here is the order to do things in, the hardware to buy, and how offline mode behaves once you are running.

Getting started

Six steps from empty to selling

Do them in this order — stock levels and receipts both depend on the stores existing first.

1

Create your stores

Add each branch with its code, name, address and contact details. Store codes appear on receipts and reports, so pick something your staff will recognise.

2

Import your catalogue

Upload your existing product list as CSV, XLSX or XLS. Confirm the column mapping we suggest, optionally set a SKU prefix and default cost and selling prices, then review what was created and rejected.

3

Set stock and reorder points

Record opening stock per branch with a stock-in movement, and set each branch's minimum level per part so low-stock alerts mean something.

4

Create staff accounts

Add store admins, operators and cashiers from the store screen. Each gets a generated username and a one-time password shown once — copy it before you close the dialog.

5

Set up receipts

Edit the receipt template for each store, preview it with sample data, and turn on auto-print with the printer name if you want a receipt after every sale without pressing anything.

6

Install it on the terminal

Open the app in Chrome on the till machine and install it to the desktop or home screen. Sign in once while online so the catalogue downloads to the device — after that it can sell offline.

Hardware

What to buy for the counter

Nothing proprietary and nothing expensive. Standard retail hardware works.

  • Computer or tablet — any reasonably current machine running Chrome. A tablet is fine; the POS screen has a dedicated mobile layout.
  • Barcode scanner — any USB or Bluetooth scanner that types what it reads, which is nearly all of them. No driver or configuration needed: the scan lands in the search box and Enter adds the item.
  • Receipt printer — a standard 80 mm thermal printer. Receipts are sized for it.
  • Label printing — shelf labels come out as PDFs, so an ordinary A4 printer works. Sheets are laid out as 50 × 30 mm labels; dedicated 2 × 1 in and 3 × 2 in label sizes are also available.
  • No cash drawer integration — worth knowing up front. There is no drawer trigger or shift/Z-report management.

One-touch receipt printing

By default the browser shows a print dialog for each receipt. To skip it entirely on a dedicated till machine, launch Chrome with kiosk printing enabled:

chrome.exe --kiosk-printing

Set that on the shortcut the staff use, turn on auto-print for the store, and a receipt comes out on its own after every sale.

Installing on the terminal

Open the app in Chrome and use Install app, or Add to Home Screen on a tablet. It then launches in its own window with no browser chrome. Sign in once while online so the store's catalogue downloads to the device — that first sync is what makes offline selling possible.

Offline mode

What to tell your staff

Three rules cover almost every situation they will meet.

Keep selling

If the connection drops, carry on. Search, scanning, the cart and the receipt all work from the device. The dot next to your name turns grey — that is expected, not an error.

Do not reinstall or clear data

Unsold work lives on the device until it uploads. Signing out is fine and keeps the queue, but clearing browser data or reinstalling before the dot turns green will lose whatever has not synced.

Green dot means done

When the connection returns the queue drains on its own. If the dot turns red, something needs a human: open the sync screen, read the reason, and retry or discard.

A note on stock going negative. If two terminals both sell the last of a part while offline, both sales are kept and the stock figure goes negative. That is deliberate — losing a real sale is worse than a temporarily wrong count. The affected sales are marked for review with the reason attached, so you can correct the count with a stock adjustment once you know what is actually on the shelf.

FAQ

Questions shops ask before they commit

Including the ones with answers you may not want to hear.

What actually happens if the internet goes down mid-sale?

Nothing visible. The terminal keeps the catalogue, prices and stock levels on the device, so search and scanning keep working, the sale completes, and the receipt prints from the device. The sale goes into a queue and uploads itself when the connection returns. You can watch the queue drain on the sync screen.

Can two terminals in the same branch sell at the same time offline?

Yes. Each records its own sales locally and uploads them independently. Every sale carries a unique id so a retried upload cannot be counted twice, and the terminals coordinate so only one uploads at a time. If both sold the last of a part, both sales are kept and the stock discrepancy is flagged for review rather than one sale being thrown away.

Does it work on a phone or tablet?

Yes. It installs as an app on Windows, macOS, Android and iOS, and the POS screen has a dedicated mobile layout with a sticky checkout bar and a full-screen payment sheet.

What hardware do I need?

Any reasonably current computer or tablet with Chrome, a USB or Bluetooth barcode scanner, and an 80 mm thermal receipt printer. Scanners work with no configuration. For one-touch receipt printing, launch Chrome with the kiosk-printing flag as described in the docs.

Can I import my existing product list?

Yes. Upload a CSV, XLSX or XLS file of any column layout. The importer guesses which of your columns is the SKU, name, price and so on, shows you a sample row so you can correct the mapping, and then reports exactly what was created, updated and rejected. You can also import from a shared master parts catalogue and set your own prices on the way in.

How many stores can I run?

As many as you need. Stock, staff, sales and expenses are all tracked per store, each store sets its own reorder points and receipt settings, and the dashboard can either combine every branch or plot them as separate lines for comparison.

Can a cashier see my cost prices or my margins?

No. Cashiers sign in straight to the POS terminal and have no route to cost prices, expenses, reports or settings. Permissions are enforced on the server for every request, so the restriction does not depend on a menu item being hidden.

Can I get my data out?

Yes. Every report exports to CSV or PDF, and sales, products and stock can be exported in bulk as CSV, Excel or PDF. If you self-host, you also hold the database directly.

Does it calculate VAT or handle refunds?

Not today. There is no automatic tax calculation, and returns are handled by editing the sale and recording a stock movement with a return reason rather than through a dedicated refund screen. We would rather tell you that up front than have you discover it in week two.

Which payment methods can it record?

Sales can be recorded as cash, card, bank transfer, cheque or credit, with cash tendering and change calculation built in. Expenses additionally cover GCash, Maya and credit card. Note that these are recorded payment methods — the system does not process card or e-wallet payments itself, so you keep using your existing terminal for that.

Still have a question?

Email us. If the answer is no, we will say so.