Enable Fluent Store on your Existing Account

Get Started
Functionality
Learning
Extension
Dev Tooling
APIs
Releases

How-to Guide

Author:

Fluent Commerce

Changed on:

5 Sept 2025

Key Points

Verify Compatibility: Ensure your existing account meets all prerequisites for enabling Fluent Store.
Follow Step-by-Step Guide: Adhere to the provided instructions to enable Fluent Store on your account seamlessly.
Utilize Support Resources: Refer to the official documentation and support channels for any issues or queries.

Steps

📺 Watch this quick demonstration on how you can enable Fluent Store.

Enabling Fluent Store

Watch this quick demonstration on how you can enable Fluent Store.

Assumptions

An existing FluentCommerce Account with atleast one Retailer will be setup
Global Inventory will be enabled on the account
Atleast one valid Location and Location user will be set up
The location user will have one of the following roles assigned on the RETAILER and AGENT context, with the following permissions `ROLE NAME: STORE/ STORE_ASSISTANT`

Step-by-step guide

Update location user with the correct permissions

Update the role assigned to your location user with the following permissions:

LOCATION_VIEW
PRICE_VIEW
RETAILER_VIEW
SETTING_VIEW
CARRIER_VIEW

To update the Role, you can run the following mutation in an API client that supports GRAPHQL queries and mutations, like the POSTMAN or a GRAPHQL client (GRAPHiQL).

1mutation{updateRole(input:
2{name:"STORE"
3permissions:
4 [
5   {name:"LOCATION_VIEW"},
6   {name:"RETAILER_VIEW"},
7   {name:"PRICE_VIEW"},
8   {name:"SETTING_VIEW"}
9   {name:"CARRIER_VIEW"}
10 ]})
11 {id
12 name
13 permissions{name}}}

You may need technical assistance for this setup.

Update Location Workflow with the user actions

Fluent Store adapts the user actions in the workflow. In this step we will configure the user actions in the Location workflow. These user actions are required by a store user to complete the pick and pack process required to fulfil online orders.In the previous store UI, these user actions were coded into the UI and was not read from the workflow. Whereas, in the new store web app Fluent Store, these user actions will be read from the Location workflow.In the reference solution, Fluent Commerce provides the following user actions to complete the pick and pack process:1.CREATE WAVE

Ruleset Name: WaveCreate
Subtype: `"subtype": "STORE",`
User Action Value:

1    "userActions": [
2        {
3            "context": [
4                {
5                    "label": "Create Wave", 
6                    "type": "PRIMARY",
7                    "modules": [
8                        "servicepoint"                             
9                    ],
10                    "confirm": false
11                }
12            ],
13            "attributes": [
14                {
15                    "name": "maxCount", 
16                    "label": "fc.sf.ui.waves.index.create.numberOfFulfilments.label", 
17                    "type": "INTEGER",
18                    "defaultValue": 1,
19                    "mandatory": true
20                },
21                {
22                    "name": "userName",
23                    "label": "Wave Owner",
24                    "type": "STRING",
25                    "source": "loggedInUsername",
26                    "defaultValue": "",
27                    "mandatory": false
28                }
29            ]
30        }
31    ]

2. CONFIRM PICK

Ruleset Name: PickConfirm
Subtype: `"subtype": "STORE",`
User Action Value:

1    "userActions": [
2        {
3            "context": [
4                {
5                    "label": "CONFIRM PICK",
6                    "type": "PRIMARY",
7                    "modules": [
8                        "servicepoint"                               
9                    ],
10                    "confirm": true
11                }
12            ],
13            "attributes": [
14                {
15                    "name": "pickedItems",
16                    "label": "PICK",
17                    "type": "PICKED_ITEMS",
18                    "mandatory": true
19                }
20            ]
21        }
22    ]

`
`

3. CONFIRM PACK

Ruleset Name: WaveDispatch
Subtype: `"subtype": "STORE",`
User Action Value:

1    "userActions": [
2        {
3            "context": [
4                {
5                    "label": "CONFIRM PACK",
6                    "type": "PRIMARY",
7                    "modules": [
8                        "servicepoint"                          
9                    ],
10                    "confirm": true
11                }
12            ],
13            "attributes": []
14        }
15    ]

`
`

4. COMPLETE WAVE

Ruleset Name: WaveComplete
Subtype: `"subtype": "STORE",`
User Action Value:

1    "userActions": [
2        {
3            "context": [
4                {
5                    "label": "Wave Complete",
6                    "type": "PRIMARY",
7                    "modules": [
8                        "servicepoint"
9                    ],
10                    "confirm": false
11                }
12            ],
13            "attributes": []
14        }
15    ]

`
`

Add the “subtype” to the following rulesets in the Home Delivery order workflow

Ruleset Name	Ruleset Description	Subtype Value
ARTICLE_COLLECTED	Ruleset responsible for marking the articles as Courier Collected	"subtype": "DEFAULT"

Add the “subtype” to the following rulesets in the Click & Collect order workflow

Ruleset Name	Ruleset Description	Subtype Value
ARTICLE_COLLECTED	Ruleset responsible for marking the articles as Customer Collected	"subtype": "DEFAULT"
ARTICLE_ARRIVED	Ruleset responsible for marking the articles as Arrived in store (for the use case of inter store transfers only)	"subtype": "DEFAULT"
ArticleCancellation	Ruleset responsible for cancelling the Uncollected articles	"subtype": "DEFAULT"

Log in to Fluent Store

Log in to the URL, `<ACCOUNT_ID>.apps.fluentcommerce.com/store` with the location user credentialsYou are now ready to use the Fluent Store App.

All of the data available in ServicePoint will be available in the Fluent Store.

All of the data available in ServicePoint will be available in the Fluent Store.
You can also customize the UI according to your business requirements using the OMX UX framework.

Enable Fluent Store on your Existing Account

Key Points

Steps

📺 Watch this quick demonstration on how you can enable Fluent Store.

Enabling Fluent Store

Assumptions

Step-by-step guide

Update location user with the correct permissions

Update Location Workflow with the user actions

Add the “subtype” to the following rulesets in the Home Delivery order workflow

Add the “subtype” to the following rulesets in the Click & Collect order workflow

Log in to Fluent Store

Related content

Fluent Store Web App Overview

Configuration of the Fluent Store Web App

Getting Started Configuring Fluent Store

Fluent Commerce

Knowledge Tracks Related To This Topic

Building Blocks

By Type

Helpful Resources

Quick Links

Enabling Fluent Store