Price lists

The price list object and the allowed CRUD operations on the related resource endpoint

Price lists determine the SKU prices and their currency within a market. By default, taxes are included in the prices associated with a price list. If you want to override this setup, set the tax_included attribute to false.

A price list can be associated with different price list schedulers. When one of those price list schedulers is associated with a market, its price list temporarily overrides the market's original one, letting you change a subset of prices within a specific time window (e.g. seasonal sales).

You can define a custom alphanumeric (case-sensitive) code for your price lists, provided that it's unique across the environment (it can contain underscore and hyphens, spaces are not allowed, the maximum length is 25 characters).

Price rules

By filling up the rules object of a price list, you can set up a price rule thanks to our Rules Engine integration with Commerce Layer Core API. Adding one or more price rules to a price list will result in applying the discounts due to the rule actions to all the price list's prices that satisfy the related rule conditions.

How-to

Please refer to the Rules Engine documentation to learn more about how to set up promotional rules, define conditions and actions, browse the most common use cases, and more.

Price rules, together with the Rules Engine integration, are still in beta and available only to our enterprise customers. If you're one of them and want to test and leverage its functionalities reach out to us and request to be part of the beta program.

Data model

Check the related ER diagram and explore the flowchart that illustrates how the price list resource relates to the other API entities.