Introducing our brand new event Stream Hub
Read the docs
Ctrlk
GitHubSign inSign up for free
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Promotions

How to set up promotions with the Rules Engine using order rules

The Rule Engine enables you to set up almost any kind of promotions to boost your sales, from the simplest to the most complex, using the proper order rules.

To make the Rule Engine work in conjunction with promotions, you need to leverage Commerce Layer flex promotions. All you need to do is create a new flex promotion and give it a meaningful name, specifying the activation and expiration dates as the values of the related attributes and the order rules that you want to be implemented in the rules object. The discount defined by the related actions will be automatically applied to the orders that match the given conditions.

Example

The following request creates a flex promotion that applies a 10% discount to the whole order if it contains at least 2 units of a promotional product:

curl -g -X POST \
  'https://yourdomain.commercelayer.io/api/flex_promotions' \
  -H 'Accept: application/vnd.api+json' \
  -H 'Authorization: Bearer your-access-token' \
  -H 'Content-Type: application/vnd.api+json' \
  -d '{
  "data": {
    "type": "flex_promotions",
    "attributes": {
      "name": "Personal promotion",
      "starts_at": "2018-01-01T12:00:00.000Z",
      "expires_at": "2018-01-02T12:00:00.000Z",
      "rules": {
        "rules": [
          {
            "name": "10% Promo T-shirt x2",
            "conditions": [
              {
                "field": "order.line_items.sku.code",
                "matcher": "eq",
                "value": "PROMOTSHIRT",
                "nested": {
                  "conditions": [
                    {
                      "field": "order.line_items.quantity",
                      "matcher": "gteq",
                      "value": 2
                    }
                  ]
                }
              }
            ],
            "actions": [
              {
                "type": "percentage",
                "selector": "order",
                "value": "0.1"
              }
            ]
          }
        ]
      }
    }
  }
}'

Available actions

The following action types are enabled on the flex promotions endpoint:

PercentageFixed priceFixed amountFree giftBuy X pay YEvery X discount Y

Check and validation

Once you've created a flex promotion (and defined one or more order rules) you can validate it against a specific order to check the rules outcomes (e.g. if and how the related discount will be applied in the case in point). You just need the flex promotion and the order IDs so that you can send (using a sales channel or integration access token) a GET request to the endpoint:

Where:

  • {{your_domain}} is the unique subdomain of a Commerce Layer organization for which the Rules Engine is enabled.

  • {{promo_id}} is the ID of the flex promotion whose outcomes you want to check.

  • {{order_id}} is the ID of the order against which you want to validate the flex promotion.

Examples

Matching order

Let's assume you want to check the flex promotion identified by the ID ZOqmZfjPOp against the order identified by the ID NZrQhpRpRZ:

The following flex contains a rule according to which the orders with a total amount greater than 5000 cents will be discounted by 10%:

The following order has an amount greater than 5000 cents, thus matches the rule's conditions:

Let's call the validation endpoint to check the rule's outcomes:

The following request validates the rule identified by the ID ZOqmZfjPOp against the order identified by the ID NZrQhpRpRZ:

The outcomes payload clearly shows that the order matches the rule, listing the order ID conditions.matches array and displaying the action that will be applied on the matching order within the actions.resources array:

Non-matching order

Let's assume you want to check the same flex promotion against the order identified by the ID PgojhLQLQR instead:

The following flex contains a rule according to which the orders with a total amount greater than 5000 cents will be discounted by 10%:

The following order has an amount lower than 5000 cents, thus doesn't match the rule's conditions:

Let's call the validation endpoint to check the rule's outcomes:

The following request validates the rule identified by the ID ZOqmZfjPOp against the order identified by the ID PgojhLQLQR:

The outcomes payload clearly shows that the order doesn't match the rule, resulting in empty conditions.matches array — consequently, the actions array is also empty and the promotions won't be applied:

Use cases

If you need to check more examples of promotions based on the Rule Engine, feel free to explore the related section of this documentation:

Promotions
PreviousVirtual relationshipsNextPrice lists

Last updated