Fluent Commerce Logo
Docs

LoadVirtualPositionAndVirtualCatalogueDetails

Rule

Changed on:

12 Aug 2025

Overview

Loads the virtual position details and then sends an event {eventName}
Plugin NameInventory Reference Module
Namespace[[account.id]].globalinventory
The Inventory Reference Module is the foundation for inventory related implementations. It provides reference Workflows for inventory ingestion and processing. Extensible by design, use this Module as a base to build a solution to the needs of your customers.The Inventory Module includes the following areas:
  • Product Catalogue workflow
  • Inventory Catalogue workflow
  • Control Group workflow
  • Virtual Catalogue workflow

UI Description

Loads the virtual position details and then sends an event {eventName}

Accepts

  • VIRTUAL_CATALOGUE

Actions

  • This rule produces a SendEventAction that forwards the incoming event as an inline event with the given name {eventName}.

Rule parameters

ParameterDescription
eventNameThe name of event to be triggered
typeThe type of Virtual Position & Virtual Catalogue*
*This needs to be either “BASE” or “AGGREGATE” for the 2 types of Virtual Catalogue.

Event attributes

ParameterDescriptionData TypeRequired?
virtualCatalogueInventoryCatalogueRefThe ref of the inventory catalogue this virtual position goesStringOptional
virtualPositionProductRefThe product ref of the virtual positionStringOptional
virtualPositionGroupRefThe group reference value of the virtual positionStringOptional

Exceptions

No Exceptions are generated from this rule

Configuration example

1{
2  "name": "FLUENTRETAIL.globalinventory.LoadVirtualPositionAndVirtualCatalogueDetails",
3  "props": {
4    "eventName": "CheckVirtualPositionExists",
5    "type": "BASE"
6  }
7}

Detailed Technical Description

The generated event contains the following event attributes:
ParameterDescriptionNotes
virtualCatalogueRefThe ref of the virtual catalogue
virtualCatalogueTypeThe type of the virtual catalogue
virtualCatalogueInventoryCatalogueRefThe inventory catalogue ref this virtual catalogue is made of
virtualCatalogueProductCatalogueRefThe product catalogue ref this virtual catalogue is made of
virtualCatalogueControlGroupRefThe control group ref this virtual catalogue is made of
virtualCatalogueNetworkIdsThe network references this virtual catalogue is made of
virtualPositionRefThe ref of the virtual position
virtualPositionProductRefThe product ref of the virtual position
virtualPositionQuantityThe quantity of the virtual position
virtualPositionGroupRefThe group reference value of the virtual position
virtualPositionTypeThe virtual position type
targetVirtualPositionRefThe ref of the virtual positionsame as the value of virtualPositionRef
locationRefThe ref of the locationContains the same value as the {locationRef} incoming event attribute
productRefThe product ref of the virtual positionSame value as the value of {productRef} incoming event attribute
inventoryPositionRefInventory Position reference. Same value as the value of {inventoryPositionRef} incoming event attribute
  • The rule queries a virtual catalogue using the `{entityRef}` value of the event and adds all the virtual catalogue information to the new event as attributes. See output actions for all the event attribute names. This rule makes another query to fetch virtual position details using the `{entityRef}` of the incoming event (as the virtual catalogue `ref`) and the virtual position `ref`.
  • The virtual position `ref` is constructed in the following way.
    • virtual position ref = `{productRef}:{locationRef}:BASE` if the input parameter `{type}` is BASE
    • virtual position ref = virtual position ref = `{productRef}:{rootEntityRef}:BASE` if the input parameter `{type}` is AGGREGATE
  • The virtual position information is also added to the new event as attributes.
  • If there is no virtual catalogue or virtual position found, the rule won't add virtual catalogue or virtual position details to the generated event, however it will still trigger the new event `{eventName}`.

Version History

2023-08-23

v2.0.0

First release