Printing the Receipt
Print a receipt automatically or on prompt at the end of a sale, and reprint receipts from the order detail page.
The In-Store App can print a receipt immediately after an order is created. Whether it prints automatically or asks first depends on the Auto Print setting in the printer configuration. Receipts can also be reprinted at any time from the order detail page.
This page covers printing at checkout, previewing the receipt before a sale is finalised, and reprinting from a completed order.
Prerequisites
- A receipt printer must be configured in Settings → Printer. If no printer is set up, receipt printing is skipped silently after checkout.
- At least one Sale Receipt template must exist (the app uses a built-in default if none are saved).
Printing after checkout
When you create an order by tapping Order, the app checks the printer configuration and behaves in one of three ways:
Auto Print is on
If Auto Print is enabled in Settings, the receipt is sent to the printer immediately after the order is created — no prompt appears. The order confirmation snackbar shows at the same time.
If the print job fails, a warning snackbar appears: Order created but printing failed: [reason]. The order has been created successfully regardless of the print failure.
Auto Print is off (prompt)
If Auto Print is off but a printer is configured, a dialog appears after the order is created:
- Title: Print Receipt?
- Message: Would you like to print a receipt for this order?
- Skip — dismisses the dialog without printing.
- Print — sends the receipt to the printer.
If you tap Print and the job fails, a warning snackbar shows: Printing failed: [reason].
The order has already been created when this dialog appears. Tapping Skip does not cancel the order — it only skips the receipt print.
No printer configured
If no printer is configured, neither the auto-print nor the prompt is triggered. Receipt printing is not available until a printer is set up in Settings.
Enabling Auto Print
- Open Settings (tap the gear icon in the sidebar).
- Scroll to the Printer section.
- Toggle the Auto Print switch on.
When enabled, the switch subtitle reads Automatically print receipts after order creation.
Previewing the receipt before checkout
To preview the receipt for the current cart without creating an order:
- Tap the overflow menu (⋮) in the cart header.
- Tap Preview receipt.
What happens next depends on the printer connection type configured in Settings → Printer:
| Connection type | Behaviour |
|---|---|
| Preview | An in-app preview dialog opens showing the rendered receipt as it will look when printed. Simulation buttons (OK, drawer failure, paper empty, etc.) let you test different outcomes without touching the physical hardware. |
| ESCPOS / OPOS | The receipt is sent directly to the physical printer with test markers. A printer must be connected and configured. |
Reprinting from an order
You can reprint a receipt for any existing order from the order detail page.
- Open the order (from Orders in the sidebar, or tap View Order on the post-sale snackbar).
- Tap the Print icon in the top bar.
What happens next depends on how many templates and shipments the order has.
Single template, single shipment
The receipt is sent to the printer immediately. A snackbar confirms Printed: [shipment name] on success, or shows an error message on failure.
Multiple templates
If more than one receipt template is configured, the Select Print Template dialog opens. Each template is listed by name with an eye icon to preview it on screen before committing. Tap a template name to proceed with that template.
Multiple shipments
If the order has more than one shipment, the Select Shipment to Print dialog opens. You can choose to print a single shipment or all of them:
| Option | What happens |
|---|---|
| All Shipments (shown at the top, with the count) | All shipments are printed in sequence. A loading indicator is shown during printing. |
| Individual shipment row (name, item count, status) | Only that shipment is printed. |
Tap the eye icon on a shipment row to preview the receipt on screen before printing.
On success, a snackbar confirms:
- Printed all N shipments — when all were successful
- Printed N shipments, N failed — when some failed
On failure: Print failed: [reason].
Printing a KOPI (copy receipt)
A KOPI is a certified copy of the original receipt, required by kassaloven. It is printed from the same snapshot that was captured at the time of the original sale, so it reproduces the receipt faithfully even on a different device or printer.
To print a KOPI:
- Open the order detail page.
- Tap the Print icon in the top bar.
- Choose Print KOPI from the print options.
The app fetches the persisted receipt snapshot from the transaction and renders it with a KOPI header. If a copy has already been printed for this transaction, the confirmation dialog will indicate this before you proceed.
If no receipt snapshot exists for the transaction (for example, orders created before snapshot persistence was introduced), the KOPI option is not available. Print a regular reprint instead.
Printing a PDF document instead
If PDF document templates are configured for the cart or order area, a Print PDF option appears alongside the receipt print option:
- In the cart overflow menu (⋮): Print PDF (only visible when PDF templates exist for the cart area)
- In the order detail AppBar: a dropdown menu showing Print receipt and Print PDF when both types are available
Selecting Print PDF generates the document and opens the system print or share dialogue.
See Selecting a Document Template for details on how template selection works when multiple options are available.
Error states
| Message | Cause | What to do |
|---|---|---|
| Order created but printing failed: [reason] | Auto print triggered but the job failed. | Check printer connectivity. Reprint from the order detail page. |
| Printing failed: [reason] | Print job failed after tapping Print in the prompt. | Check printer connectivity and try again from the order. |
| Print failed: [reason] | Error during reprint from the order. | Verify the printer is on and connected, then retry. |
| No shipments with items to print | The order has no shipments that contain line items. | Check the order structure in Omnium. |
| No shipment available to preview | Attempting to preview but no valid shipments exist. | Check the order has at least one shipment with items. |