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:
| Price | Description |
|---|---|
| Selling price | The current price the product is sold for |
| Original price | The original or suggested retail price (SRP) |
| Cost price | The 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:
| Setting | Description |
|---|---|
IgnorePromotionPricesInProductSync | Excludes promotion-based prices from the export. Use this when Sitoo handles its own promotions and should not receive pre-calculated promotion prices from Omnium. |
IgnorePriceListPricesInProductSync | Excludes 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
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
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
SitooManualDiscountsAlwaysApplysetting 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:
Paid Orders
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
| Setting | Description | Default |
|---|---|---|
IgnorePromotionPricesInProductSync | Skip promotion prices when exporting products | false |
IgnorePriceListPricesInProductSync | Skip price list prices when exporting products | false |
SitooDiscountsCombinable | Mark all imported discounts as combinable | false |
SitooManualDiscountsAlwaysApply | Manual discounts from Sitoo are always applied | false |
CustomerClubPricelistId | Sitoo price list ID for loyalty member prices | Not set |
PurchasePriceListId | Sitoo purchase price list ID for cost prices | Not set |
PriceListIdMapping | Mapping between Omnium and Sitoo price list IDs | Not set |
