Fluent Commerce Logo
Docs

UpdateStandardProduct

Rule

Changed on:

12 Aug 2025

Overview

Update a standard product using the information provided in the event
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

Update a standard product using the information provided in the event

Accepts

  • PRODUCT

Actions

  • This rule produces a MutationAction that will update the standard product with provided values

Rule parameters

This rule has no Input Parameters.

Event attributes

This rule uses all the event attributes to update a standard product. Note that some attributes represent complex types and their definitions follow the main event attribute definition.
Main Event Attributes
ParameterDescriptionData TypeRequired?
refThe ref of the productStringRequired
typeThe type of the productStringRequired
nameThe name of the productStringRequired
gtinThe gtin of the productStringRequired
categoryRefsA list of string category references[String]Optional
summaryA brief summary of the productStringOptional
pricesA list of prices. See the below table for its attributes[Price]Optional
taxTypeTax type of this product. See the below table for its attributesTaxOptional
attributesExtra attributes that may be used as part of this product. See the table below for the definition[Attribute]Optional
Price sub-attribute
ParameterDescriptionData TypeRequired?
typeThe type of the priceStringRequired
currencyThe currency of the priceStringRequired E.g. EUR, AUD
valueThe value of the priceFloating PointRequired
Tax type sub-attribute
ParameterDescriptionData TypeRequired?
countryThe country of this tax typeStringRequired
groupThe tax groupStringRequired
tariffThe tariff of this tax typeStringRequired
Attribute type sub-attribute
ParameterDescriptionData TypeRequired?
nameThe name of the attributeStringRequired
typeThe type of the attributeStringRequired E.g. STRING, INTEGER, BOOLEAN, OBJECT
valueThe value of the attributeJSON or scalarRequired

Exceptions

If the event attribute `{ref}` is null or empty, an EventAttributeNotFoundException will be thrown

Configuration example

1{
2  "name": "FLUENTRETAIL.globalinventory.UpdateStandardProduct"
3}

Detailed Technical Description

All the event attributes of the incoming event are parsed/deserialized into a "Product" object which has the following structure
1public class Product {
2
3    @NonNull
4    private String ref;
5
6    private String type;
7
8    private String status;
9
10    private String gtin;
11
12    private String name;
13
14    private String summary;
15
16    private List<String> categoryRefs;
17
18    private List<Price> prices;
19
20    private TaxType taxType;
21
22    private List<Attribute> attributes;
23}
An example JSON payload that represents the event attributes of an incoming event
1{
2  "ref": "STD_1_88",
3  "type": "STANDARD",
4  "status": "ACTIVE",
5  "gtin": "STD_1-87",
6  "name": "Blue Jeans",
7  "summary": "summary",
8  "categoryRefs": [],
9  "prices": [{"type": "RRT", "currency": "EUR", "value": 34.56}],
10  "taxType": {"country": "AU", "tariff": "GST", "group": "GSTG1"},
11  "attributes": [{"name": "isDangerous", "value": false, "type": "BOOLEAN"}]
12}
This rule parses/deserializes all the event attributes into a Product object outlined above. It then creates an "update product mutation" request using all the event attribute values. It uses the `{ref}` attribute of the incoming event as the reference of the standard product and `{rootEntityRef}` value of the incoming event attribute as the product catalogue reference of the standard product being updated.

Version History

2023-08-03

v2.0.0

refers to plugin