# Prices

### Overview

Price data flows **one-way from Omnium to Flow**. Omnium maintains the master price lists, and prices are distributed to Flow stores through scheduled tasks. All monetary values are converted to **cents (integers)** before transmission to Flow (e.g., 199.50 NOK becomes `19950`).

### Price types

The integration supports three distinct price types, each handled by a separate scheduled task:

| Price type         | Scheduled task               | Description                                       |
| ------------------ | ---------------------------- | ------------------------------------------------- |
| **Selling prices** | `FlowPriceScheduledTask`     | Regular unit prices and recommended retail prices |
| **Cost prices**    | `FlowCostPriceScheduledTask` | Purchase/cost pricing for margin calculations     |
| **SOA prices**     | `FlowSoaScheduledTask`       | Stock on Account amounts per store                |

### Price list handling

* Omnium maintains **external price lists** that map to Flow price lists
* Each tenant has a `MainPricesListUid` that serves as the default price list
* Store-specific price lists can be created when `StorePriceListsInFlow` is enabled (see Stores)
* Prices are resolved per market or market group

### Selling prices

Selling prices are the customer-facing prices displayed at the POS. They are synced from Omnium's external price indices and include:

* **Unit price** — The base selling price
* **Recommended retail price** — The suggested retail price (RRP)

Selling price sync runs on a configurable schedule (typically every 30 minutes to a few hours).

### Cost prices

Cost prices represent the purchase cost of products and are used for margin and profitability calculations in Flow. They can be synced:

* As part of the product export (via the `Cost` field on the product)
* Through the dedicated `FlowCostPriceScheduledTask`
* Optionally included in inventory updates (when `UseCostPriceListInInventoryExport` is enabled)

### Currency conversion

All prices undergo the following transformation during sync:

* **Omnium format:** Decimal float (e.g., `199.50`)
* **Flow format:** Integer in cents (e.g., `19950`)

The conversion is: `Flow value = Omnium value × 100`

### Configuration reference

| Setting                             | Description                           | Default  |
| ----------------------------------- | ------------------------------------- | -------- |
| `MainPricesListUid`                 | Primary price list UID in Flow        | Required |
| `DefaultVatCodeUid`                 | Default VAT code for products         | Required |
| `StorePriceListsInFlow`             | Generate per-store price lists        | `false`  |
| `UseCostPriceListInInventoryExport` | Include cost prices in inventory sync | `false`  |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flowretail.com/docs/integrations/order-management/omnium-oms-integration/prices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
