Skip to main content
Every finished Remira sale becomes an Omneo Transaction. This page lists what each Transaction, line item, and payment field is built from, so you can reconcile a receipt in Remira against the Transaction Omneo recorded.

Which sales are recorded

Omneo reads the state of the sale before anything else. Two further rules apply:
  • A sale with no lines is ignored.
  • Transactions are immutable. Reposting a sale that Omneo has already recorded does not create a second Transaction, and does not change the first. Orders are mutable, so a reposted Order is updated in place.

Identifiers

Omneo composes two identifiers rather than copying one from Remira. external_id is the unique key. receipt_ref is the human-readable value to quote when reconciling against a printed receipt. The leading digits of external_id identify the region that recorded the sale.

Transaction fields

order_number is not populated from Remira.

Line items

Each Remira SKU line becomes one Transaction item. Line-level discounts map to the item’s discounts array, one entry per Remira discount line, carrying the discount reason description and the discount amount.

Payments

Each Remira payment line becomes one Transaction payment. payment_code carries the description Remira sends, such as Visa or Cash, not a numeric code.

How a Profile is matched

Omneo tries each step in order and stops at the first match.
1

By Identity

The Remira customerEntityId is looked up as an Omneo Identity, using the handle configured for your tenant, remira by default.
2

By Omneo Profile ID

If Remira holds the Omneo Profile ID against the customer, Omneo reads the Profile directly.
3

By email

Omneo matches on the customer’s email address. When the POS was offline at the time of sale, the address on the printed receipt is used instead.
4

By creating a Profile

Only when Profile creation is enabled for your tenant. A sale that reaches this step with creation disabled is recorded as a Transaction with no Profile attached.
When a Profile is created, Omneo takes the name, email, mobile number, and default billing address from the sale, sets the joined and preferred locations from the customer’s creating and home branches, and applies the region configured for your tenant. A customer with no email address is given a placeholder so the Profile can still be created.

Custom field mapping

The mapping above is the default. Your tenant can map additional values out of the Remira sale onto the Transaction without an Omneo release, by adding entries that name a path in the sale and the Omneo field to write. Each entry can read a value directly, select an item from a list by matching one of its properties, apply a default when the sale has no value, and convert the result to a string, a number, or a list. Custom entries are applied last, so a custom entry that targets one of the fields above overrides the default behaviour. Contact your Omneo account manager to configure them.