Stores

Overview

Store data flows one-way from Omnium to Flow. When stores are exported from Omnium, the integration automatically creates the associated organizations, warehouses, and optionally store-specific price lists in Flow.

Export eligibility

Only stores marked as primary stores in Omnium are exported as Flow stores. Non-primary stores function as warehouses beneath their parent primary store.

Sync process

1. Omnium identifies stores to export (filtered by market or market group)

2. For each store:

   • The organization is created or looked up

   • The store is created or updated in Flow

   • Associated warehouses are created or updated

   • If StorePriceListsInFlow is enabled, a store-specific price list is created

Store field mapping

Flow field	Omnium source	Notes
storeUid	Id	UID-sanitized
name	Name	—
address	StreetName + StreetNumber	Combined
city	Address.City	—
postalCode	Address.Zipcode	—
countryCode	Address.CountryCode	—
email	Email	—
phone	PhoneNumber	—
latitude	Latitude	Parsed from string
longitude	Longitude	Parsed from string
isActive	!IsInactive	Inverted logic

Create vs. update behavior

Some fields are only set during creation and excluded from updates:

Field	Set on create	Set on update
purchaseNumberSeriesUid	Yes	No
salesPriceUid	Yes	No
voucherNumberSeriesUid	Yes	No
defaultWarehouseUid	Yes	Set to first available
defaultReturnWarehouseUid	Yes	Set to first available

Organizations

Each store in Flow requires an organization. The organization UID is derived from the store's OrganizationalNumber in Omnium. If the store has no organizational number, the fallback OrganizationUid from the connector configuration is used.

Warehouses

Warehouses are created from two sources during every store export:

1. The store itself — if IsWarehouse = true, the store is also registered as a warehouse

2. Linked warehouses — warehouses from the store's AvailableWarehouses list in Omnium

Warehouses are created or updated on every export cycle.

Store-specific price lists

When StorePriceListsInFlow is enabled:

• A dedicated price list is created for each store

• The price list UID is derived from the store UID

• Store-specific selling prices are pushed to this price list instead of the global one

Configuration reference

Setting	Description	Default
OrganizationUid	Fallback organization UID	Required
MainPricesListUid	Default price list UID	Required
PurchaseNumberSeriesUid	PO number series for new stores	Conditional
VoucherNumberSeriesUid	Voucher number series for new stores	Conditional
StorePriceListsInFlow	Generate per-store price lists	false
UseMarketGroupFlowTenants	Group stores by market group	false

Error handling

Errors during store export are tracked with market-specific keys (e.g., FlowRetail{marketId} storeExport). Errors are automatically cleared on the next successful export.