Creating a Return Order

Create a return order from an existing order to refund or take back items, with optional exchange items and payment terminal integration.

A return order is created when a customer brings back delivered items. The app opens a dedicated return cart where you select which lines to return, set quantities, optionally add exchange items, and choose how the refund is processed. Returns can be started from the standalone Return section on the home screen, or directly from an order's detail page.

Returns can only be created for lines that have been delivered. Lines that have not been delivered, or have already been fully returned, are not available.

Starting a return from the Returns section

The Return section on the home screen is the primary way to process in-store returns. It shows a list of recent delivered orders and lets you search for any order.

  1. Tap Return on the home screen.
  2. The return search screen opens, showing the 10 most recent delivered orders.
  3. To find a specific order, type an order number or scan a receipt barcode in the search field (Enter order number or scan receipt). Results update as you type.
  4. Tap the order in the list. The return cart opens for that order.

By default, POS return orders (orders that are already returns) are hidden from the list. Tap Show POS returns in the top right to include them.

Starting a return from the order detail page

You can also open the return cart from within an order:

  • Tap the return icon (↩) in the top-right toolbar of the order detail page. This opens the return cart for the full order with no lines pre-selected.
  • To pre-select specific lines, tap the first line you want to return and choose Select order line from the context menu. Select additional lines by tapping them. Then tap the edit icon (pencil) in the selection action bar and choose Return order lines. The return cart opens with those lines already ticked.

Selecting items to return

The return cart has two panels. On larger screens they appear side by side; on smaller screens they are split into Select Items and Cart tabs.

The left panel (or Select Items tab) lists all lines that have returnable quantity:

  1. Tap a line to select it. A tick appears and the line is highlighted. The quantity defaults to the full available return quantity.
  2. Use the and + buttons next to the quantity to adjust how many units to return. The maximum is the delivered quantity minus any previously returned units.
  3. Tap a ticked line again to deselect it.

[Screenshot: The return cart with three order lines. One line is ticked and highlighted in orange, showing a quantity stepper with −/1/+ controls. The other lines show "max 2" in grey. The barcode scanner icon is visible in the top-right corner.]

Scanning barcodes to select items

Tap the barcode scanner icon in the header to activate the camera scanner. A viewfinder appears above the order lines list. Scan the barcode on the product:

  • If the barcode matches a line in the order, the return quantity for that line is incremented by one.
  • Scanning the same code repeatedly increments the quantity each time (with a short cooldown to prevent duplicate reads).
  • If the barcode is not found in the order, a warning appears.

Tap the scanner icon again to close the scanner.

The return cart

The right panel (or Cart tab) shows the items you have selected, grouped into two sections:

  • Returns — lines being returned (amounts shown as negatives in red). If the original line had a discount applied, the original and discounted amounts are both shown, with the original struck through.
  • New items — exchange items you have added (amounts shown as positives in green).

Return type, reason, and comment

Once at least one return line is selected, three fields appear below the line cards:

FieldDescription
Return TypeDropdown — only shown when return types are configured for your tenant. Required before the confirm button activates.
Return Reason (Optional)Free-text note explaining why the item is being returned.
Return Comment (Optional)A general comment attached to the whole return order.

Refund method

By default, the refund goes back to the original payment method. If your tenant has a gift card provider configured, a refund method selector appears below the return fields:

OptionDescription
Refund to original paymentRefund the amount to the card or cash used for the original purchase (default).
Issue credit note (Tilgodelapp)Issue a store credit note instead. No terminal or cash movement takes place.

When Issue credit note is selected:

  • The payment info and online credit options are hidden — they do not apply.
  • The confirmation dialog shows the expected expiry date of the credit note (based on your tenant's gift card validity setting).
  • After the return is processed, a dialog displays the credit note code prominently. Tap the code to copy it to the clipboard and give it to the customer — they can use it on a future purchase.

The credit note is issued via the gift card provider configured for your tenant. It appears in OMS → Orders → Gift Cards with type Credit note.

Original payment

A card labelled Original payment shows how the order was originally paid — the payment method name (e.g. Visa, cash), the masked card number if applicable, and the amount. This section is hidden when Issue credit note is selected as the refund method.

Online order credit options

For orders placed online (not in-store POS orders), an additional Credit section appears:

FieldDescription
Amount to creditCalculated refund total based on selected lines.
Credit PaymentToggle on to send a credit instruction to the payment provider when the return is processed. On by default.
Customer pays return shippingToggle on to deduct a return shipping charge from the refund. When enabled, an amount field appears (pre-filled from your market settings if configured).

Adding exchange items

To process a return and a new sale in a single transaction, tap Add new item in the summary card. A product search screen opens. Tap a product to add it to the New items section.

Tap any exchange item to open a quick-edit menu where you can:

  • Adjust the quantity using the stepper.
  • Apply a discount (by percentage or fixed amount).
  • Open the full line editor.
  • Remove the item.

The summary card shows separate subtotals for Returns, New items, and Return shipping when more than one section is populated, followed by the net Total.

[Screenshot: The return cart with one item in the Returns section (−NOK 299.00 in red) and one in the New items section (+NOK 499.00 in green). The summary card shows both subtotals and a net Total of +NOK 200.00. The "Add new item" and "Complete exchange" buttons are visible at the bottom.]

Completing the return

Tap Complete return (or Complete exchange when exchange items are present) in the summary card footer. The button is disabled until:

  • At least one return line has a quantity greater than zero.
  • A return type is selected (when return types are configured).

How the refund is processed depends on the original payment method:

  • Terminal payment — the app navigates to the terminal payment screen to process the refund (or charge, for a net-positive exchange). The terminal must approve the transaction before the return order is created.
  • Cash payment — the return order is created immediately. Hand the cash refund to the customer directly.
  • Online payment — the return order is created. If Credit Payment is enabled, a credit instruction is sent to the payment provider separately.
  • Zero-sum exchange (return value equals new items value) — no terminal transaction is needed; the return order is created directly.

On success, a confirmation message appears and the return cart closes. The return order is linked to the original order and visible in the order list.

If you tap the back button with items selected or exchange items added, a confirmation dialog asks whether to discard your progress. Tap Discard to leave or Cancel to continue.

Return without receipt

If the customer does not have a receipt or order number, tap Return without receipt at the bottom of the Returns search screen. This opens a separate return cart where you build the return by scanning or searching for products rather than selecting from an existing order.

  1. Tap the barcode scanner icon or the search icon to add items.
    • Scanning a barcode looks up the product automatically. If multiple variants match, a picker appears.
    • Searching opens the product catalogue — tap a product to add it.
  2. Use the and + buttons to adjust quantities. Tap × to remove a line.
  3. In the summary card, select the refund method:
    • Terminal — processes the refund via the payment terminal.
    • Cash — records the return without a terminal transaction.
    • Credit note (Tilgodelapp) — issues a store credit note instead of returning money. This option is only shown when your tenant has a gift card provider configured.
  4. Tap Complete return.

[Screenshot: The return without receipt screen with two scanned items in the list, quantity steppers, and the summary card at the bottom showing the Terminal and Cash payment method chips and the Complete return button.]

If the terminal approves the refund but the return order cannot be saved (e.g. a network error), a red banner appears: Refund approved on terminal but order could not be saved. Tap Retry. Tap Retry to re-submit the return order without processing the terminal again. Do not close the app until the retry succeeds.

Pending returns

If you exit the Returns section after a terminal-approved return failed to save, the app stores the pending return and shows a warning banner at the top of the Returns search screen the next time you open it. Tap the banner to re-submit the pending return.

When a return cannot be completed

SituationWhat happens
No lines have available return quantityThe order lines list is empty; no lines are shown.
Return types are configured but none is selectedComplete return button remains disabled.
All selected quantities are zeroComplete return button remains disabled.
Terminal declines or the transaction is cancelledAn error message appears; the return order is not created.
Backend call fails after terminal approvalRed retry banner appears — tap Retry to complete without re-charging the terminal.