Skip to content

Receipts and Printing

Hyvä POS is on the App Store

The free app is out for iPhone, iPad and Mac: install it from the App Store, connect your Magento store and sell. PRO, the Magento module with a license per terminal, follows shortly. News and pricing are at hyva.io/pos.

Every completed sale writes a receipt to the device, prints it on a receipt printer or any AirPrint printer, and can email it to the customer. All of this works on the free tier; the receipt never depends on a server round-trip.

What a Receipt Stores on the Device

The receipt is the register's own record of the sale, written the moment the sale completes and immutable afterwards; see local receipts. Each receipt stores:

  • the date and time at the register (not the sync time),
  • every line: product, quantity, unit price, per-line discount, tax rate and amount,
  • the VAT breakdown per rate, and any cash rounding,
  • the tenders used, including split payments; card payments keep the brand, masked number and terminal reference, never a full card number,
  • the customer's name and email when one was attached to the sale,
  • the receipt comment and any line comments, as they were printed,
  • the cashier who made the sale (also when the receipt syncs later under another sign-in), the terminal, and the Magento order number,
  • refund or exchange references and the sequential receipt number.

The receipt number and the sale reference. The receipt number is the register's own document number, and it is not the Magento order number: S-T2-000431 is the 431st sale on terminal 2, with R for a refund and L for a payment on an earlier order: a layaway payment, or a Credit Due collection, which prints as its own receipt kind showing the order and what it still owes. Each series is counted per terminal without gaps, so a missing number means a missing transaction. The sale reference is the first 8 characters of the register's internal sale id, for example 9F3C2A1B, and ties the paper to the device's sale record and to the Magento order behind it, which is what support needs when a customer brings a receipt in. Both are always recorded and synced; whether each one prints is a per-location setting on PRO, and the sale reference is off by default.

Receipts are stored in per-month files on the device, encrypted at rest, with no automatic purge. On the free tier they exist on that device only; PRO receipt sync mirrors every receipt to Magento, so the archive survives a lost or reset device. See data and security.

Printing Paths

The app connects to printers over three different paths, chosen automatically per printer: you configure the printer once under Settings → Printers and the right path is used:

  • ESC/POS: the native command language of Epson, Star and generic network or Bluetooth receipt printers. Fast text output with bold, alignment and paper cut.
  • Rendered image: Brother mobile printers and other models without a usable text mode receive the receipt as a print-ready image, rendered for crisp output on thermal paper.
  • TSPL: newer Brother mobile models (RJ-2035B, RJ-2055WB, RJ-3035B, RJ-3055WB) print via their native label language, which is faster over Bluetooth than sending an image.

The layout is identical on every path: the same columns, the same VAT summary, the same header and footer. Which printers are supported, how each connects and which paper widths they take is covered in the hardware section.

AirPrint

Without a receipt printer, any AirPrint-capable office printer prints receipts through the system print dialog. Long receipts split across pages, and each saved AirPrint printer has its own color mode, print quality, scale and margin settings. AirPrint cannot kick a cash drawer.

The Cash Drawer

A cash drawer plugs into the receipt printer's drawer port, and the printer kicks it open on command:

  • Automatic: turn on the auto-open toggle under Settings → Payments and the drawer opens whenever a sale takes cash. Default is off.
  • Manual: the Cash Drawer tile on the register opens it on demand (a no-sale opening).

The kick works on Epson, Star and generic ESC/POS printers with a drawer port. AirPrint and label printers have no drawer port. Details and tested drawers are in the hardware section.

What the Cashier Sees

After checkout the success screen shows a print tile per document: the sales receipt, and for card payments the customer terminal slip and the merchant terminal slip (the signature copy). Each prints automatically or on demand depending on the auto-print toggles, and a long-press on any tile picks a different printer for that one print. Reprinting later works from the sales list: open any past sale and print or re-send it. The reprint reproduces the original receipt, because everything is stored with the sale.

Comments on the Receipt

A Receipt Comment entered on the payment screen prints under the totals; a Line Comment added to a product line prints under that line. Both appear on every format the register produces: the paper receipt, the label printer's layout, the receipt image, the emailed receipt and, on PRO, the receipt page the QR code opens. Long comments wrap to the paper width; the register keeps them with its own receipt record, and PRO receipt sync with module 1.4.1 keeps them with the synced receipt and shows them on the admin receipt page. See Comments and Notes for where the cashier enters them and what Magento records.

Email Receipts

  • Free tier: the app asks Magento to send the order and invoice emails for the sale, so the customer gets the totals through your store's normal transactional mail.
  • PRO: the app sends a dedicated receipt email through the PRO module, with the rendered receipt attached as an image, so the customer gets the same document that came out of the printer.

The cashier can email from the checkout success screen, from the hand-over screen below, or later from any sale's detail view. The email address is prefilled when a customer is attached to the sale.

On PRO, the email entry also offers a newsletter opt-in. The cashier's email dialog carries a Subscribe to the newsletter checkbox with an ask-the-customer-first hint; the hand-over screen and the customer display show the same opt-in to the customer directly, ticked by the customer. In every case the subscription happens only after the receipt email was sent, uses the same validation your webshop applies (including the guest-subscription setting for emails that don't belong to an account), and a known customer's email links the subscription to their account.

Hand the Device to the Customer

After the sale completes, tap Hand over and pass (or turn) the device to the buyer. The screen switches to a customer-facing mode, "How would you like your receipt?", with the store's name and logo, and everything cashier-side hidden: no totals, no buttons into the register.

The customer picks one of two:

  • Email it to me: a large email field, prefilled when a customer is attached to the sale, that sends the receipt through the normal email flow.
  • Scan the QR: opens their personal receipt page in their own browser. The QR appears when the store runs PRO receipt sync and the receipt has synced; without it the customer sees the email option only.

The "Return to cashier" control needs a long-press rather than a tap.

Customer-Facing Display

Two-line customer displays show the running total while you scan, on the free tier. They attach to the printer, not the register device: the Star SCD222U plugs into a Star printer's peripheral port, the Epson DM-D30 into an Epson TM-series printer, and the display commands ride the printer's existing connection. See customer displays for how each connects, and for the PRO paired-iPad display.

Where It Is Configured

What On the device In Magento (PRO) Which wins
Printers, paper, quality Settings → Printers Always the device: hardware is per-terminal
Receipt content and layout Settings → Receipt Layout Hyvä POS → Store Setup → Locations, defaults under Stores → Configuration → Hyvä POS Magento's values apply on PRO; locked fields are read-only on the device
Auto-print toggles Settings → Receipt Layout Location's Checkout Auto-Print fields Magento on PRO
Drawer auto-open Settings → Payments The device

On the free tier every setting is per-device. The full layout detail (logo, store-info template, cashier line, QR, and how Magento's values and locks work) is on the receipt layout page.

PRO

PRO receipt sync adds the central receipt archive in Magento, a public QR page per receipt, receipt emails with the rendered receipt attached, and per-location receipt branding pushed from Magento. The paired-iPad customer display, where a second iPad mirrors the cart and lets the customer type their own email, is PRO as well.