Prices

Price synchronization between Omnium and Sitoo including promotion prices, price lists, and tax.

Prices

Price synchronization between Omnium and Sitoo operates in both directions. Product prices are exported from Omnium to Sitoo, while order prices are imported from Sitoo into Omnium when POS transactions are received.

Price Export

Product Prices

When products are exported to Sitoo, three prices are sent for each product:

PriceDescription
Selling priceThe current price the product is sold for
Original priceThe original or suggested retail price (SRP)
Cost priceThe purchase/cost price (always excluding VAT)

The integration determines the best valid price for each product in a given market. If a variant does not have its own price, it inherits prices from its parent product.

Filtering Prices During Export

Two settings control which prices are included when exporting products:

SettingDescription
IgnorePromotionPricesInProductSyncExcludes promotion-based prices from the export. Use this when Sitoo handles its own promotions and should not receive pre-calculated promotion prices from Omnium.
IgnorePriceListPricesInProductSyncExcludes price list prices from the export. Use this when price lists are managed separately in Sitoo.

When these settings are enabled, only the base product price is exported rather than a promotional or price-list-specific price.

Price Lists

Omnium price lists can be exported to Sitoo. Each price list is scoped to a single currency and can be tagged for specific stores.

Scheduled Price Sync

A scheduled task keeps prices in sync by identifying products with recently modified prices and exporting the current best price per market. It supports two categories:

  • Standard prices: Exported to Sitoo's default price list.
  • Customer club prices: Exported to a separate price list, allowing loyalty members to receive different pricing at the POS.

Configuration -> Settings -> Advanced -> Scheduled Tasks

{
    "schedule": "*/45 * * * *",
    "implementationType": "SitooPriceScheduledTask",
    "isDisabled": false
}

Purchase Prices (Cost Prices)

Purchase prices are exported separately from selling prices on their own schedule. Each product's best cost price is sent to a designated purchase price list in Sitoo.

Configuration -> Settings -> Advanced -> Scheduled Tasks

{
    "schedule": "0 3 * * *",
    "implementationType": "SitooCostPriceScheduledTask",
    "isDisabled": false
}

Price Import

Order Prices

When a POS order is imported from Sitoo, the integration reconstructs pricing from Sitoo's order data.

Order Line Prices

For each order line, the unit price is reconstructed by combining the line total (net + VAT) with any discount that was applied, then dividing by the quantity. This gives the original per-unit price before discounts.

The tax rate from Sitoo is preserved on each order line.

Order Totals

The order total is derived from Sitoo's final net and VAT amounts. Sitoo may apply a small rounding adjustment to make the gross total align with exact currency units — this adjustment is stored separately on the order for reconciliation purposes.

If the order includes bonus point redemptions, those are treated as order-level monetary adjustments rather than line-level discounts.

Discount Handling

Discounts from Sitoo orders are imported into Omnium through several paths depending on how the discount was applied:

  • Separate discount lines: When Sitoo represents a discount as its own order line, the discount value is extracted and attached to the relevant product line in Omnium.
  • Inline product discounts: When a discount is applied directly to a product line in Sitoo, it is imported as a discount on that line. If the SitooManualDiscountsAlwaysApply setting is enabled, manual POS discounts are marked so they are preserved during any order recalculation in Omnium.
  • Price overrides: When a product's selling price differs from its original price, the difference is captured as a discount.

Discount Combinability

The SitooDiscountsCombinable setting controls whether all imported discounts are marked as combinable with other promotions. This should in most cases be enabled.

Multiple Lines with the Same SKU

When an order contains multiple lines for the same product and those lines have discounts, the discount is applied directly to the line amount rather than as a separate discount object. This avoids ambiguity about which line a discount belongs to.

Order Export Prices

When Omnium exports orders to Sitoo (e.g., for endless aisle fulfillment), the price mapping depends on the order type:

For orders already paid at the POS, the full price and discount breakdown is sent to Sitoo, including the per-line price, discount amount, and tax rate.

Booking Orders

For unpaid booking orders, the behavior depends on the IgnorePromotionPricesInProductSync setting:

  • When promotions are NOT ignored: The discounted price and discount amount are included, since Sitoo already has the base price and will not recalculate.
  • When promotions ARE ignored: Only the base price is sent without discounts, because Sitoo will apply its own promotions when the order is finalized at the POS.

Promotion Prices

Omnium promotions can be exported to Sitoo as vouchers. Different promotion types are mapped accordingly — fixed-amount discounts are sent as monetary values, while percentage-based discounts are sent as percentage values.

See the Promotions page for full details on promotion synchronization.

Tax

Tax rates are carried along with order and product data in both directions. When orders are imported from Sitoo, the VAT percentage on each line item is preserved. When orders are exported to Sitoo, the tax rate from Omnium is included.

For product-level tax configuration and VAT group setup, see the VAT Groups page.

Currency

Currency is handled at the order and price list level:

  • Orders: The currency from the Sitoo order is stored on the Omnium order.
  • Price lists: Each price list is tied to a specific currency (ISO 4217). All items in the price list use that currency.

Configuration Reference

SettingDescriptionDefault
IgnorePromotionPricesInProductSyncSkip promotion prices when exporting productsfalse
IgnorePriceListPricesInProductSyncSkip price list prices when exporting productsfalse
SitooDiscountsCombinableMark all imported discounts as combinablefalse
SitooManualDiscountsAlwaysApplyManual discounts from Sitoo are always appliedfalse
CustomerClubPricelistIdSitoo price list ID for loyalty member pricesNot set
PurchasePriceListIdSitoo purchase price list ID for cost pricesNot set
PriceListIdMappingMapping between Omnium and Sitoo price list IDsNot set