Price list schedulers

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

Price list schedulers are market-specific and associated with a price list. You can associate different price list schedulers with the same price list. Price list schedulers set a time frame (from starts_at to expires_at) within which their price list overrides the associated market's one. Multiple price list schedulers can be associated with a market as long as the price list associated with the price list scheduler and the one originally associated with the market share the same currency_code and tax_included attributes.

Price list scheduler status

Newly created price list schedulers are enabled by default. You can disable them by passing the _disable trigger attribute and eventually re-enable them by passing the _enable trigger attribute. To be considered active, a price list scheduler must be enabled and not expired. If more than one of the price list schedulers associated with a market are active at the same time, the one that starts earlier will be considered to define the market's prices. If more than one of the active price list schedulers start at the same time, the one that ends earlier (i.e. that is scheduled to be active for a shorter time window) will be considered to define the market's prices. Price list schedulers with a starts_at attribute in the future are marked as pending.

For performance reasons, we recommend avoiding too many direct edits on enabled price list schedulers. As a best practice, we suggest disabling the price list scheduler first, making the necessary changes, then re-enabling it.

Data model

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

Last updated