Fluent Commerce Logo
Docs
Sign In

Enhanced Order Lookup and Tagging Capabilities

Release

Authors:

Kirill Gaiduk, Yulia Andreyanova

Changed on:

20 Mar 2025

Target release date:2025-03-18
Release status:Released

Description

We are excited to announce several important updates to the Fluent platform that enhance the ability to search and organize orders more effectively. These improvements provide greater flexibility for users, particularly when managing and searching for orders based on tags or additional external references.

Enhanced Searchability with Additional Order Reference Field:

The order->ref field has always been the primary field for searching orders based on external information. With this release, we introduce the ability to store an additional external reference to cater for scenarios where multiple unique references are required, in cases such as:

  • Marketplace Order Reference
  • ERP Order Reference

New Tags and Grouping Options:

We've added 3 new tag fields, enabling users to group orders based on key criteria, improving tracking and organization. For example, you can now group orders by:

  • Brands
  • Regions
  • Sales channels
  • Payment methods
  • Purchase Order Reference

The new fields supported on the Order List Page improve searchability and usability, making order filtering easier. The filter support replacing text input with a predefined selection, ensuring consistency and reducing errors. 

Changelog

The Order Entity has been extended with new fields:

  • `ref2`
    : This field extends the flexibility of storing Order External References. Similar to the existing Order
    `ref`
    , the field:
    • stores a single unique External Reference value
    • stores a maximum of 255 characters
    • can be
      `null`
    • supports:
      • "Exact Match" search
      • "Pattern" search using wildcards
  • `tag1`
    ,
    `tag2`
    ,
    `tag3`
    : These fields have been designed to store single non-unique Order tag values.
  • store a maximum of 50 characters
  • can be
    `null`
  • supports:
    • "Exact Match" search only

All the existing Order operations (Mutations and Queries) have been updated to support the newly added Order fields.

The new fields are supported on the Order List Page improving the ability to filter and search orders. The Predefined values mechanism allows for structured selection of the new fields, making order filtering more efficient.

Screenshot

No alt text provided

Limitations

  • "Pattern" Search using wildcards is not supported for the new Tag fields.
Released capability depth:New capability
Release bundle / Capability type:Platform, Web apps, Fluent OMS
Kirill Gaiduk

Kirill Gaiduk

Contributors:
Yulia Andreyanova