Fluent Commerce Logo
Docs
Sign In

ChangeStateGQL

Rule

Changed on:

16 May 2024

Overview

Changes the state of any type of incoming entity to the status provided in the input parameter using the generic update status mutation in GraphQL. It changes the state of the {event.entityType} to {status} using GraphQL.

The rule SetState is a newer version of

`ChangeStateGQL`
. Moving forward, please use
`setState`
instead of
`ChangeStateGQL`
.


Plugin NameOrder Reference Module
Namespace{{accountId}}.order

The Order Reference Module is the foundation for order-related implementations. It provides reference workflows for click & collect, home delivery and mixed baskets and those needed to build your own. Extensible by design, use this Module as a base to build a solution to your customers' needs.

UI Description

Changes the state of any type of incoming entity to the status provided in the input parameter using the generic update status mutation in GraphQL. It changes the state of the {event.entityType} to {status} using GraphQL.

Accepts

  • ALL

Actions

  • This rule performs an update mutation on any type of incoming entity to update the status.

Rule parameters

Parameter

Description

status

The status to be applied to the entity in the incoming event

Event attributes

This rule does not directly identify any event attributes.

Exceptions

This rule may result in the following exceptions:

IllegalArgumentException: When any required entity details are missing from the incoming event, for example:

  • the 
    `entityId`
     is empty if it's a legacy-orchestrated entity
  • the 
    `entityRef`
     is empty if it's a non-legacyOrchestrated entity
  • the 
    `retailerId`
     is empty if it's a RETURN_ORDER/RETURN_FULFILMENT
  • the 
    `rootEntityRef`
     is empty if it's a RETURN_FULFILMENT

ActionException (with code 422): When an unsupported entity type is provided for update status mutation.

RubixException: When the update mutation operation fails.

Configuration example

1{
2  "name":"<ACCOUNTID>.order.ChangeStateGQL", 
3    "props":{
4      "status":"PENDING_PAYMENT"
5   }
6}

Language: json

Detailed Technical Description

Based on the type of the incoming entity, this rule either calls GQL or REST API to update the status of the entity to the new 

`{status}`
 given in the input parameters.

Version History

2023-08-03

v1.0.0

refers to plugin

Copyright © 2024 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo