Home Open POS →
📖   How to Use VesselTill

Everything you need
to start selling today

No training required. No account. Just open the app, load your products, and go. This guide covers every feature from first sale to end-of-day report.

Open VesselTill →
01

🚀 Getting Started

1

Open the app — no login needed

Go to pos.html (or click here). VesselTill runs entirely in your browser. There is no account to create, no email address to verify, and no subscription to pay. Just open and sell.

2

Choose your currency, and light or dark mode

In the top-right of the header, tap the currency button (e.g. ZAR) to open the currency picker. Select the currency you trade in — it will be remembered for your next session. VesselTill supports 45 currencies including ZAR, USD, GBP, EUR, KES, NGN, GHS, INR, AUD and more.

Next to it, the sun/moon icon switches between light and dark mode. It follows your device's system setting by default — tap it any time to override that manually.

3

Upload your product list

Tap ↑ Upload Excel in the Products tab and choose your .xlsx, .xls, or .csv file. Your products appear as tappable cards immediately. See the Products section below for how to format the file.

No spreadsheet ready yet? Tap ⬇ Demo Template right next to the upload button (or on the landing page) for a ready-made file with 100 sample products, barcodes, stock quantities, and staff names — upload it and try the whole app in seconds.

4

You're ready to sell

Tap any product card to add it to the cart. When done, tap Charge, choose how the customer is paying, confirm, and issue a receipt. The whole flow takes under 30 seconds.

💡
No products yet? You can still make a sale right now using the + Custom item button in the cart — type any name and price on the spot.
02

📦 Loading Your Products

1

Prepare your Excel or CSV file

Create a spreadsheet with a sheet named Products (or leave the sheet name as-is). The columns VesselTill reads are:

Column name Required? Example value Notes
Description Required Chicken Mayo Wrap The product name shown on the card
Price Required 49.99 Numbers only — no currency symbols
Barcode Optional 6001234567890 Enables barcode-scanner lookup
Qty Optional 24 Starting stock count — decreases with each sale
Category Optional Beverages Shown as a small label on the product card
2

Add a Staff sheet (optional)

If you want to track which staff member made each sale, add a second sheet in the same file and name it Staff. Put one staff name per row in column A. A staff selector will then appear in the cart header.

3

Upload the file

In the Products tab, tap ↑ Upload Excel and select your file. Products load instantly. The file is stored in your browser — you only need to upload it once per device. Re-upload at any time to update prices or add new products. A ⬇ Demo Template button sits right next to Upload Excel if you want to test with sample data first.

4

Search and filter products

Use the search bar at the top of the Products tab to find products by name, category, or barcode number. Results update as you type.

⚠️
Out-of-stock products are still shown but appear dimmed and cannot be added to the cart. Restock by re-uploading your Excel file with updated quantities, or by restoring a JSON backup that includes updated stock levels.
03

🛒 Making a Sale

1

Select a staff member (if set up)

If you added a Staff sheet to your Excel file, choose the serving staff member from the dropdown in the cart header. This is recorded on every receipt and report for that sale.

2

Add products to the cart

Tap any product card on the left to add one unit to the cart. Tap again to add another. In the cart, use the + and buttons to change quantities, or tap − until the item is removed.

To add something not in your product list, tap + Custom item in the cart, type a name and price, and tap Add to Cart. Recent custom items are shown as quick-tap chips for reuse.

3

Scan a barcode (optional)

Tap the Scan button next to the search bar to open the barcode scanner. Point your camera at a barcode — the matching product is added to the cart automatically. If your device has no camera, switch to the Type Barcode tab inside the scanner and enter the number manually (useful with a USB barcode reader).

4

Apply a discount (optional)

In the cart footer, enter a percentage in the Discount % field. The total updates instantly. Discount is applied across the whole basket — for per-item discounts, adjust the product price in your Excel file before uploading.

5

Set tax (optional)

Enter a percentage in the Tax % field. By default, tax is added on top of the price. If your Excel prices already include tax (e.g. VAT-inclusive), toggle Tax incl. on — VesselTill will extract the tax portion instead of adding it.

6

Enter a customer name (optional)

Type a customer name in the field below the staff selector. It appears on the receipt and in the transaction history, making it easier to find a specific sale later.

7

Tap Charge

When the cart is ready, tap the green Charge button to open the payment screen.

04

💳 Payment Methods

VesselTill supports four payment modes. Select one on the payment screen after tapping Charge.

💵

Cash

Enter the amount tendered — VesselTill calculates the change automatically and shows quick-amount buttons.

💳

Card

Process the payment on your own card machine. VesselTill records it as a card payment for your reports.

📲

Digital

For EFT, e-wallets, or mobile payments (e.g. SnapScan, Zapper). Confirm receipt, then tap Confirm.

🔀

Split

Divide a payment across two methods: Cash + Card, Cash + Digital, or Card + Digital.

Confirm & Receipt

Once the payment details are filled in, tap Confirm & Receipt. The sale is saved to history, stock is decremented, and the receipt screen opens automatically.

05

🧾 Receipts

After confirming a payment, the receipt screen opens with four delivery options.

💬

WhatsApp

Tap WhatsApp to open a number entry screen. Select a country dial code, enter the customer's number, and VesselTill opens WhatsApp with a pre-formatted receipt message ready to send. Recent numbers are saved for quick reuse.

📄

PDF Receipt

Downloads a clean PDF receipt to your device. Share it by email, save to Google Drive, or print later.

🖨

Print

Opens your browser's print dialog. Works with any printer or thermal receipt printer connected to your device.

No receipt

Tap Close to dismiss without sending a receipt. The sale is still saved to history regardless.

ℹ️
You can re-send a receipt for any past sale. Open the History tab, find the transaction, tap it, and choose the delivery method from the receipt screen.
06

Returns & Exchanges

1

Find the original sale

Open the History tab. Use the date filter to narrow down the list if needed. Tap the transaction to open it.

2

Tap "Return / Exchange"

Inside the transaction detail, tap the amber Return / Exchange button to open the returns flow.

3

Select what's being returned

Tick the items the customer is bringing back and set the quantity for each. The refund amount calculates automatically.

4

Refund or Exchange

Choose Refund to return money to the customer, or Exchange to swap for a different product. Exchanged items are added to a new cart for you to complete. Stock levels are updated accordingly.

⚠️
You can also Void a sale from the History tab to cancel it entirely. Voided sales are removed from your totals in the End-of-Day report and stock is restored. Use this for mistakes, not for legitimate returns — use the return flow for those.
07

📊 History & End-of-Day Reports

History tab

The History tab shows every completed sale in reverse-chronological order. Use the date picker at the top to filter by a specific day. Tap any sale to view the full receipt, re-send it, or initiate a return.

End-of-Day report

Open the EOD tab and select a date (today by default). The report shows total revenue, number of transactions, a breakdown by payment method (cash / card / digital / split), and a per-product sales summary. Export it three ways:

  • Download PDF — saves a formatted report to your device
  • Send by Email — opens your email client with the report pre-filled
  • Print — sends to your printer via the browser dialog
08

💾 Backup & Restore

⚠️
VesselTill stores all data in your browser — there is no cloud sync. If your browser data is cleared, you switch devices, or you use a different browser, your sales history and product data will be gone. Back up at least once a day.

Full Backup (recommended daily)

In the Backup tab, tap ⬇ Full Backup (JSON). This downloads a single file containing all your receipts, products, and stock quantities. Save it to Google Drive, WhatsApp yourself, or email it. This is the file used to restore your data.

Export receipts as CSV

Tap ⬇ Receipts Spreadsheet (.csv) to download all receipts as a CSV file you can open in Excel or Google Sheets for further analysis.

Export stock snapshot

Tap ⬇ Download Stock CSV or ⬇ Download Stock JSON to export your current product list including live stock quantities after all sales, returns, and exchanges. Useful for stock-taking.

Restore from backup

In the Backup tab, tap the drop zone (or drag your JSON backup file onto it). VesselTill will ask whether to merge with existing data or replace it. Restoring from the Full Backup JSON brings back all receipts and stock levels.

Backup reminder banner

If more than 24 hours have passed since your last backup, a yellow banner appears at the top of the screen. Tap Back up now to export immediately, or dismiss it for the current session.

💡
Moving to a new device? Back up on the old device (Full Backup JSON), open VesselTill on the new device, go to the Backup tab, and restore the file. Your entire history transfers in seconds.
☁️
Coming soon: VesselTill Sync. An optional upgrade for businesses running more than one till — it keeps up to 3 devices synchronised automatically and backs up to Google Drive, using your own Google account. There's no separate VesselTill server; your data stays in storage you already own. The free, local-only version you're using now keeps working exactly as it does today whether or not you ever use Sync.
09

📲 Install as an App

VesselTill is a Progressive Web App (PWA). Installing it gives you an icon on your home screen or desktop and lets you use it fully offline — no internet connection required after the first load.

On Android (Chrome)

A banner will appear at the bottom of the screen asking you to install VesselTill, or tap the install button in the app header. Tap Install — an icon is added to your home screen and the app opens in its own window, without the browser bar.

On iPhone / iPad (Safari)

Open pos.html in Safari. Tap the Share button (the box with an arrow), then select Add to Home Screen. Give it a name and tap Add. The VesselTill icon will appear on your home screen.

On Desktop (Chrome or Edge)

Click the install icon in the address bar (looks like a computer screen with a down-arrow), or use the browser menu → Install VesselTill. The app will open in its own dedicated window.

ℹ️
Once installed, VesselTill works completely offline. All your data stays on your device. You only need an internet connection to send WhatsApp receipts or to contact support.
10

⌨️ Keyboard Shortcuts

If you're on a laptop or desktop — or using a USB barcode scanner — VesselTill has a full set of keyboard shortcuts to speed up checkout. They're always available; press ? inside the app, or tap the keyboard icon next to the Settings tab, to see this list without leaving the till.

Focus search / scan barcode — jump into the search bar from anywhere/
Add matched product — in the search bar, adds the single matching resultEnter
Charge / checkout — opens the payment screen for the current cartEnter
Adjust quantity — +1 / −1 on the last item added to the cart+
Remove last item — takes the most recently added item out of the cart
Clear cart — empties the entire cartShiftC
Custom / quick-sale item — opens the add-custom-item dialogN
Open barcode scanner — opens the camera / manual barcode entryS
Switch tab — jumps straight to Products, History, EOD, Backup, Contact, or SettingsAlt16
Close any dialog — closes whichever modal is currently openEsc
Show this list — opens the shortcuts cheat sheet inside the app?
💡
Search + Enter works like a barcode scanner. Type or scan a barcode into the search bar and press Enter — if it's an exact match, the product is added straight to the cart and the search box clears itself, ready for the next scan. Typing a distinctive part of a product name down to a single match works the same way.
⚠️
Shortcuts are automatically switched off while you're typing in any text field — except Esc and /, which always work. This means they'll never interfere with a barcode scanner or manual typing.
11

Tips & Tricks

📞

Save WhatsApp numbers

Tick "Remember this number" when sending a WhatsApp receipt. The number is saved so repeat customers get served faster.

🔢

Quick cash amounts

On the cash payment screen, tap the quick-amount buttons to fill common note denominations in one tap — no typing required.

🔍

Filter history by date

Use the date picker in the History tab to jump to any past trading day instantly. Clear it to see all-time history again.

🧾

Re-send any receipt

Open any past sale from the History tab and issue a fresh WhatsApp message, PDF, or printed receipt for it.

🔄

Update product prices

Edit your Excel file and re-upload it at any time. Existing sales and receipts are not affected — only future sales use the new prices.

📱

Works on any screen

On mobile the cart slides up from the bottom. On tablet and desktop the cart sits alongside your product grid. One app, every screen size.

🌍

Multi-currency support

Change currency at any time from the header. The symbol updates on all prices, receipts, and reports immediately.

🔖

Version history

Tap the version badge next to the VesselTill logo in the header to see the changelog — what's new and what was fixed in each update.

🌓

Light & dark mode

The sun/moon icon in the header follows your device's system setting by default, or tap it to switch manually. Your choice is remembered on that device.

ℹ️

About & Terms, right in the app

Next to the Settings tab, three small icons link to the landing page (About), a plain-language Terms & Privacy summary, and the keyboard shortcuts cheat sheet — no digging through menus.

💬
Got a question or found a bug? Open the Contact tab inside the POS — every message goes directly to the founder. You can also send a compliment if VesselTill is working well for you 🙏