Omnium OMS Integration

What is Omnium?

Omnium is an Order Management System (OMS) designed for unified commerce. It acts as a central hub for managing orders, products, inventory, customers, and pricing across multiple sales channels — including e-commerce, physical stores, and marketplaces.

What does the integration do?

The Flow Retail–Omnium integration connects Flow Retail POS system with Omnium OMS to create a seamless retail operation, and ensures that data stays consistent across both systems, enabling scenarios such as:

• Buy online, pick up in store (Click & Collect) — A customer places an order on the webshop (managed by Omnium), and a store employee fulfills it using Flow POS.

• Centralized product management — Products, prices, and categories are maintained in Omnium and automatically distributed to Flow Retail.

• Unified inventory — Stock levels are kept in sync so that both online and in-store channels have accurate availability.

• Omnichannel order visibility — Orders created at the POS are visible in Omnium, and vice versa, providing a single view of all transactions.

• Centralized customer data — Customer records are shared between systems, enabling loyalty programs and consistent customer experiences.

Data flow overview

The integration supports bidirectional data synchronization. Some data flows exclusively in one direction, while other data flows both ways depending on the business scenario.

Data type	Omnium → Flow	Flow → Omnium
Products	Products, brands, categories, images	—
Prices	Selling prices, cost prices	—
Stores	Store details, opening hours, warehouses	—
Purchase Orders	PO headers and line items	Goods reception confirmations
Inventory	Stock levels (when Omnium is stock master)	Stock levels (when Flow is stock master)
Customers	Customer data (via orders)	Customer create/update
Orders	Click & Collect and Online orders	POS sales, returns, cancellations
Invoices / Receipts	—	Invoice records with PDF receipts

Key concepts

Stock master

Each store in Flow Retail can be configured to use either Omnium or Flow as the stock master — the authoritative source for inventory levels. When Omnium is the stock master, Flow receives stock updates from Omnium. When Flow is the stock master, Flow pushes stock updates to Omnium after goods are received.

Asynchronous sync queue

Order synchronization between the systems is handled through an asynchronous job queue. When an order is created or updated, a sync job is added to the queue and processed in the background. This ensures that API calls are handled reliably without impacting real-time POS operations.

Failed jobs are automatically retried with exponential backoff, starting at 1 minute and increasing up to 2 hours between retries.

Webhook events

Omnium notifies Flow Retail about order changes via webhook events. When an order is created or updated in Omnium, it sends an event to Flow's API, which triggers the sync process.

Documentation structure

Page	Description
Architecture	System architecture, data flow diagrams, and sync mechanisms
Products, Brands & Categories	Product catalog synchronization from Omnium to Flow
Prices	Price synchronization from Omnium to Flow
Inventory	Stock level synchronization (bidirectional)
Customers	Customer data synchronization (bidirectional)
Orders	Order synchronization including Click & Collect and returns
Invoices & Receipts	Invoice and PDF receipt flow from Flow to Omnium
Purchase Orders	Purchase order and goods reception handling
Stores	Store, warehouse, and organization synchronization
Configuration & Setup	Technical setup guide for developers