Fluent Commerce Logo
Docs

SendEventToProcessUnfulfilableFulfilment

Rule

Changed on:

5 Dec 2025

Overview

Sends an event to act on fulfillments that have been assigned to a system-rejected location

This rule checks if the fulfillment's source matches the configured system-rejected location reference and triggers the specified event if they match.

Plugin NameOrder Reference Module
Namespace[[account.id]].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

Send event {eventName} for the related Fulfillment on verifying if its {fromAddress} is {systemRejectedLocationRef} and is in status PROCESSING.

Accepts

  • FULFILMENT

Actions

Rule parameters

Name

Type

Description

`eventName`

`String`

The name of the event to be triggered

`systemRejectedLocationRef`

`String`

The location reference for system-rejected fulfillments

Event attributes

This Rule does not expect any Event attributes.

Exceptions

  • This Rule throws a `PropertyNotFoundException` when the Rule parameter(s) is not provided.
  • This Rule throws a `RubixException` if the Store Address `ref` cannot be found for the `systemRejectedLocationRef` parameter, or if an error occurs while retrieving the Store Address for the specified Location.

Configuration example

1{
2  "name": "[[account.id]].order.SendEventToProcessUnfulfilableFulfilment",
3  "props": {
4    "eventName": "ProcessEscalatedFulfilment",
5    "systemRejectedLocationRef": "[[system.rejected.location.ref]]"
6  }
7}

Detailed Technical Description

This Rule executes the following steps:

  • Validate the Rule parameters:
    • `eventName`
    • `systemRejectedLocationRef`
  • Load the Fulfillment and extract its `fromAddress` reference
  • Load the Primary Address for the specified `systemRejectedLocationRef` and extract its reference
  • Compare the two references for equality
  • Produce a `SendEventAction` with the event `{eventName}`  if the references are equal

Version History

2025-12-11

v25.12.11

Initial release