Skip to content

Local Receipts

Hyvä POS is in closed beta

Hyvä POS is currently in a closed beta (pilot phase) with a small group of merchants. It is not yet generally available: the App Store release follows the pilot, and features and configuration may still change - possibly in backwards-incompatible ways - before the general release. Want to take part? Sign up at hyva.io/pos.

Every sale you process produces a receipt on the device, and the receipt, not the Magento order, is the record of what happened at the register. Understanding this one concept explains most of how Hyvä POS behaves.

The Receipt Is What the Customer Walked Out With

A receipt is a carbon copy of the in-store sale: the lines, the prices, the tax the customer paid, the tender, the time at the register. It is written to the device the moment the sale completes, it is encrypted at rest, and it is immutable. You cannot change a receipt afterwards, because the customer already walked out of the store with it on paper. That permanence is what makes it fit for tax compliance.

The Order Is the Sync Artifact

When the sale is placed, the app also creates a regular Magento order, so your in-store revenue shows up next to your online orders, flows into your accounting and ERP through the integrations you already have, and behaves like any other order for refunds and reporting.

The two records serve different masters:

Local receipt Magento order
Created at the register, always when the store is reachable
Changes later never follows normal order life cycle
Serves tax compliance, the customer's paper trail accounting, ERP, reporting

Retries That Cannot Create Duplicates

Placing an order over a shop's Wi-Fi will sometimes fail halfway: the request reaches Magento, the response does not reach the iPad. The app retries safely, because every sale carries a unique id (pos_sale_id). If Magento already has an order for that sale, the retry returns the existing order instead of creating a second one. A flaky connection can delay a sale from reaching Magento; it cannot duplicate it.

Free vs PRO

On the free tier, receipts live on the device: you can reprint and re-send them from the sales list, and the order in Magento is your central record. PRO receipt sync mirrors every receipt to Magento as an immutable record with a public QR page, and PRO offline mode extends the same receipt-first design to selling with no connection at all.