Fluent Commerce Docs

Home
Essential Knowledge
By Type
Building Blocks
APIs
Releases

Content in this track:

Getting Started Configuring Fluent OMS (webapps)

Configuring the Unified View of Inventory: A Step-by-Step Guide

Configure UI for Mixed Baskets

Configuring Profiles and Sourcing Strategies: A Step-by-Step Guide

How to enable Returns in Fluent OMS and Fluent Store

End Of Track

Content in this track: Configuring the Unified View of Inventory: A Step-by-Step Guide

How-to Guide

Author:

Yulia Andreyanova

Changed on:

13 Feb 2025

Key Points

The Unified View of Inventory (UVOI) is a powerful feature available out of the box. It offers comprehensive insights and real-time updates across inventory locations and sales channels.
To configure its full functionality, you need to create several settings that define default filter values and ensure filters are populated with appropriate statuses from workflows.
This guide will walk you through the configuration steps using examples from a reference solution. Note that the statuses and catalog names of these examples may differ from your specific implementation requirements.

Prerequisites

Settings Creation and Editing Mutations

Add colours to statuses to highlight important information

Steps

Note

The Unified View of Inventory screens are included in the reference solution and are accessible through the main navigation. As with all features, the screens can be customized by configuring the manifest. The steps outlined below are required to make the reference solution functional, but they may vary depending on your specific implementation.

If you have modified the base manifests for the Fluent web apps (e.g., `fc.mystique.manifest.oms` or `fc.mystique.manifest.inventory`), you can include the Unified View of Inventory fragment by using the setting name `fc.mystique.manifest.oms.fragment.inventory.unifiedview` (Fluent OMS)or `fc.mystique.manifest.inventory.fragment.unifiedview` (Fluent Inventory).

Set Default Values for Catalogs

The Filter Panel Component retrieves data for the Inventory Search page using the default product and inventory catalog settings. These settings are essential for initializing the appropriate filters and ensuring that only relevant data is retrieved and displayed.

The fc.oms.inventory.search.product.catalogue.default setting determines the default Product Catalog applied to the Product Catalogue filter. This setting is configured as a string and ensures that the filter is pre-applied with a specific catalog.

The fc.oms.inventory.search.inventory.catalogue.default setting defines the default Inventory Catalog used for the Inventory Catalogue filter. Unlike the product catalog setting, this can be configured as either a string or a list of Strings (JSON array). This flexibility enables the inclusion of multiple inventory catalogs by specifying their references.

Both settings can be referenced in the Manifest through an alias (e.g., `"defaultValue": "{{settings.default_ic}}"`).

Note

This alias is applicable only when configuring the default value for the filter panel component. It cannot be used under other conditions.

Virtual Catalog Support and Configuration

The Filter Panel supports only Virtual Catalogs of type `BASE`. Virtual Catalogs of type `AGGREGATE` are not supported because search results do not return data due to a mismatch between `locationRef` and `groupRef`.

Additionally, for Virtual Catalogs to appear in the filter dropdown, each catalog must have the corresponding `retailerRef` configured. Without this reference, the Virtual Catalog will not appear as an available option.

Populate Status Filters with Workflow Statuses

Use the settings fc.oms.mystique.inventory.search.inventory.position.stock.statuses and fc.oms.mystique.inventory.search.virtual.position.stock.statuses to associate filter options with statuses used within the Inventory Catalog and Virtual Catalog workflows.

Configure Colored Dot Statuses

Set up settings to map statuses to specific colors:

Inventory Position statuses: Use the `fc.oms.inventory.search.inventory.position.stock.status.column` setting.

Virtual Position statuses: Configure via the `fc.oms.inventory.search.virtual.position.stock.status.column` setting.

Inventory Quantity statuses: Set up the Inventory Type History drawer using the `fc.oms.inventory.search.inventory.quantity.history.status.column` setting.

Product statuses: Apply the `fc.oms.inventory.search.product.status.column` setting for the Unified View of Inventory by Product page.

Configuring Colored Statuses Correctly

Before creating the settings, refer to the Colorful Dots Statuses Configuration Guide and the Status Color Palette to ensure proper alignment.

Additionally, the statuses used in the settings must match the statuses defined in the relevant workflows to maintain consistency and functionality across the system.