Essential Knowledge
401 Items
Account Settings
This contains the list of Settings used in the context of ACCOUNT.
Platform Limit Definitions (v1.1)
This document sets out the definitions for the terminology used in the Platform Limits document some of which is also used in your contractual agreement documents (e.g. Form) with Fluent Commerce.
For definitions of other essential terminology, visit the Glossary of Key Terms and Product Taxonomy pages.
Connector Deployment Cloudformation
Attached to this page is the “connectors.yaml” template which is used to create Cloudformation Stack for the Connectors API. The resulting stack deploys ECS Fargate containers that run the API and produce a public endpoint. This public endpoint is secured with an SSL certificate which is applied to the Application Load Balancer.
Create Comment
The `createComment`
Mutation allows the creation of a Comment against a known .
Prerequisites
Specific Permissions are required for creating Comments:
`COMMENT_CREATE`
`COMMENT_VIEW`
Exception Management in writing Rules
The Framework Engine ensures that all Exceptions thrown out of Rules are recorded within the Audit Events, accessible via the Event API. This is important for providing detailed information about what went wrong.
Feeds Dashboards
The Feeds Dashboard contains general information about feeds for an for the selected periods (default periods are: last 30 minutes, last 1 hour, last 8 hours, last 24 hours). You can read more about how to configure periods in this guide.
The Feeds Dashboard contains Overview and Feeds sections.
Get Comment by Id
The `commentById`
Query retrieves a Comment based on a provided Id.
Prerequisites
`COMMENT_VIEW`
Permission is required for retrieving a Comment
Getting Started with Metrics API
This guide is intended to provide implementers with information about the Metrics API within the Fluent Big Inventory product, describing its functionalities and utilization principles within the Fluent Platform.
Pre-requisites:
- You should have knowledge of How Metrics works.
- You should have knowledge of Metrics usage for Platform Observability.
- You should have knowledge of GraphQL.
- You should configure your User role with
`METRICS_VIEW`
permission for Metrics data access.
GraphQL API
The Fluent GraphQL API provides powerful access to data, integration, and orchestration-driven business logic. It provides an opportunity to streamline and optimize requests to the Fluent Management platform in a way that is more flexible than the REST-based API.
GraphQL Reference
These docs were generated by graphql-docs. Just starting out with ? Check out 's official documentation!
How Metrics works
This document is intended to describe to implementers Metrics technical details within the Fluent Big Inventory product.
Pre-requisites:
- You should have knowledge of Metrics
- You should have knowledge of OMX Workflow Framework.
- You should have knowledge of Events.
- You should have knowledge of GraphQL.
How to Interpret the Batch Pre-Processing (BPP) Dashboard
This document explains how to interpret the Batch Pre-Processing (BPP) dashboard, focusing on the Change Rate Efficiency metric. It provides methods for analyzing batch trends and optimizing data submissions. Implementation partners can use these insights to enhance batch performance and deduplication, while customers gain better visibility into changed vs. unchanged records. The dashboard supports a date range of up to 31 days, with historical data limited to the last five months.
How to transform v1.0 manifest into the manifest v2.0
This explains how to transform manifests v1.0 into the new manifests v2.0. From this guide, you will learn how to configure with necessary menu items, add filters and configure them, and add custom components. The examples below demonstrate the following Fluent OMS menu items:
- Orders
- Roles & Permissions
- Settings
Learn more about App-Level and Route-Level configuration here.
Differences between and Fluent OMS manifests are summarised in the following tables
Using the anyMatch Template
The configures icons, cards, and templates. Templates can be structured in various ways; for further details, please consult the UX Configuration Common Concepts . This , however, will specifically concentrate on the any Match template.
This template functions as a filter for a stream (such as a list of items), capable of matching none, some, or all records where a specific condition is met by a field path. This feature is particularly valuable for filtering purposes.
Webhooks Frequently Asked Questions
Fluent Commerce doesn't support static IP whitelisting due to AWS Cloud's dynamic nature. Instead, robust authentication measures are in place for security, including cryptographic signing and signature verification. While static IPs aren't recommended, securing endpoints is achievable by configuring unique URLs and firewall rules. Additionally, setting up custom authorizers or message queue validation enhances security. Each establishes a single connection, with inbound and outbound calls dependent on events. For detailed guidance, refer to Fluent's 'Webhook overview' documentation.
Accounts
This section describes the different types, prerequisites, and processes for requesting an .
A Fluent is the representation of a of the Fluent platform. An is isolated and secure and provides access to the Fluent Management Platform on either a sandbox or production environment. For information about the Fluent environments, see environments. Access to an is via the account-specific URL, in the format `https://<ACCOUNTID>.sandbox.console.fluentretail.com`
. This is a unique Console URL in a sandbox environment.
Fluent Store Dispatch Template
The Template is a preconfigured UX Template used within the Fluent Store Web App.
Languages and Localisation
As a part of Internationalisation, the Fluent platform supports multiple languages. This support allows users of web apps such as OMS Webapp and Fluent Store to configure and view the modules and interfaces of the Fluent platform in their preferred language.
As of the Fluent v4.45 release, the Fluent platform provides pre-configured support for the following languages.
Fluent Management uses a default language of Australian English `en-AU`
.
- Australian English
`en-AU`
- Default - American English -
`en-US`
- French -
`fr-FR`
- Mexican Spanish -
`es-MX`
- Italian -
`it-IT`
Order Workflow Templates Overview
We provide three reference workflows (HD), Click and Collect (CC) and Mixed Baskets. Suppose our reference workflows do not accommodate your business case. In that case, you can create a new to support additional Types that require different processing and timing, with such as marketplace orders and back orders
Learn more about supported reference workflows here.
Warehouses
Warehouses configuration contains:
- Warehouses page
- Warehouse Details page
Admin Console Overview
The Fluent is a web browser-based portal, for retail business users, that provides the interface to manage orders, product availability, and . The is used by businesses and administrators to access a large range of functionality provided by the following Fluent Commerce apps:
- Distributed Order Management
- Global Inventory
- Product Availability
Each app provides out-of-the-box capabilities that are accessed by the Fluent .
By default, the displays content in English. However, v4.44 release onwards, the Fluent platform provides support for multiple languages. For more information on languages and localization and configuring other languages, click here. The console should be used on tablets and computers that have an active internet connection and a supported web browser.
Webapps OMS Dashboard
The OMS Dashboard is an exception management tool that displays information on entities (orders, fulfilments, etc.). The Console Dashboard is entirely configurable and is powered and configured by the Mystique manifest. The Dashboard component is configured to display data coming from a GraphQL query, and the number shows the total number of records returned by the configured GraphQL query.
Inventory Batch
Batch enables bulk uploading of updates to the Fluent Commerce platform, handling high data volumes from thousands to million updates per operation. Leveraging Fluent 's Batch API and Inventory Batch Pre-Processing, it ensures faster processing and accurate availability in the Fluent Management System.
This scalable solution keeps data synchronized across channels, empowering businesses to manage stock efficiently and meet customer expectations with accurate, up-to-date stock information.
Inventory Ingestion
Ingestion in Fluent Commerce ensures that stock levels across all sales channels remain accurate and up-to-date, enabling effective management. It allows businesses to send updates to the platform using two distinct methods: Inventory Batch and Inventory Delta. Each method is tailored to different scenarios, depending on data volume, frequency, and operational needs.
Inventory Module Getting Started Guide
The Inventory Reference Module is the foundation for inventory-related implementations. It provides reference Workflows for ingestion and processing. Extensible by design, use this Module as a base to build a solution to your customers' needs.
Client Scenario: Building a Product Availability Map
This lesson introduces a practical client scenario: visualizing product availability on a map. Building upon the foundation laid in the UX Framework course, we'll enhance the Fluent Store app's Product Availability screen by adding a map that displays nearby store locations and stock information for a selected product variant. This hands-on lab will guide you through configuring the product lookup and detail availability pages, setting the stage for creating custom components in subsequent lessons.
Metrics usage for Platform Observability
This document is intended to describe to implementers which Metrics are available within the Fluent Big Inventory product and what kind of data they provide to achieve Platform Observability.
Pre-requisites:
- You should have knowledge of How Metrics works.
- You should have knowledge of Events.
- You should have knowledge of Fluent APIs.
Metrics Overview
This document is intended to introduce the Metrics and describe their place within the Fluent Big Inventory product.
Pre-requisites:
- You should have knowledge of the Inventory.
- You should have knowledge of OMX Workflow Framework.
- You should have knowledge of Events.
- You should have knowledge of GraphQL.
Orchestration & Audit Events
This describes the details of the different events in the Fluent platform and provides the required base knowledge for troubleshooting. This expects that you have a good understanding of the Fluent Event Execution process and how Events are matched before the corresponding business logic is executed.
REST API
The Fluent Platform provides and number of REST APIs for interacting with the platform.
These differ from the primary GraphQL APIs which primarily cover domain entities. This section provides access to the REST based Platform APIs reference documentation.
Payment Settings
The below settings control the allowed values in the transaction create method in the REST API (POST /api/v4.1//{orderId}/transaction). The createFinancialTransaction mutation can use custom-defined paymentProvider, paymentMethod and currency fields. We recommend that the below settings be used as the way to look up current configured values dynamically without hardcoding values for these fields.
These settings can be modified and retrieved via the settings API.
Platform Limit Definitions (v1.0)
This document sets out the definitions for the terminology used in the Platform Limits document some of which is also used in your contractual agreement documents (e.g. Form) with Fluent Commerce.
For definitions of other essential terminology, visit the Glossary of Key Terms and Product Taxonomy pages.
Products
The Product module is a collection of products and any attributes and details associated with each product in the category.
The Products module of the Fluent app provides comprehensive capabilities:
- Product Catalogue management
- Standard and Variant Product management
- Category management
The module contains the following configurations:
- Categories
- Product Catalogues
Query Comments
The `comments`
Query retrieves Comments based on various filter criteria.
Prerequisites
`COMMENT_VIEW`
Permission is required for retrieving Comments
Connect SDK - Frequently Asked Questions
Frequently Asked Questions on Connect SDK
Rule Development Guidelines & Recommended Practices
This page provides an overview of the guidelines and best practices for custom development.
It is highly recommended that you first read Designing Rules and Writing Custom Rules if you have not done so already.
Self-Service IPU/IPC visibility Overview
This document will detail how customers can view their Inventory Position Update(IPU) and Inventory Position Change(IPC) usage from within the Web App. Using this, customers can easily compare their usage to contracted rates.
Pre-requisites
- To view the reports, a user must have:
- Access to the Fluent Big Inventory Web application
- Access to the Admin module of the Fluent Big Inventory Web application
- Assigned
`ACCOUNTUSAGE_VIEW`
permission
- The UI is configured to display admin reports
Rulesets
Rulesets are fundamental components in implementing business flows. They are reusable collections of rules that contain logic. These functions can be applied across various workflows and use cases, providing flexibility and efficiency. The Order, Inventory, and Fulfilment reference modules contain a set of pre-defined rulesets, each with its corresponding rules.
Mixed Baskets User Interface
The Fluent OMS module is pre-configured with certain standard functions. Mixed Baskets functionality is not a part of the default pre-configuration. The reference manifest fragment represents the new UI for Mixed Baskets functionality. Detailed information on configuring UI for Mixed Baskets is available in the guide.
Workflow Configuration - Getting Started
Clients and Partners will need to have their Fluent Account set up prior to being able to work with .
You should have received an " Ready" email with your Fluent Details, including user login credentials.
If you do not have access to a Sandbox , please contact your Fluent Manager.
Update Comment
The `updateComment`
Mutation allows for the updating of an existing Comment object.
Prerequisites
Specific Permissions are required for updating Comments:
`COMMENT_UPDATE`
`COMMENT_VIEW`
What is a Reference Module?
A is a Module provided by Fluent Commerce that is designed to provide reference artifacts that you can use to create your own solutions. While an Extension contains an entire solution within itself, Reference Modules provide Domain Artifacts that can be used to speed up building your solutions. Structurally, Reference Modules are identical to Modules, as are Extensions.