If your marketplace is set up to do so, you can schedule price promotions for products, including start and end dates, etc. This is particularly useful if sellers have products on sale for a limited time only.
When enabling price scheduling, the following fields will be added to both products and variants:
- Sale price start date
- Sale price start time
- Sale price end date
- Sale price end time
If you have sellers that also provide RRP and Wholesale pricing, the following fields will also be added:
- Wholesale price promo
- Wholesale price promo start date
- Wholesale price promo start time
- Wholesale price promo price end date
- Wholesale price promo price end time
To effectively implement sale price scheduling, the marketplace operator would need to create the smarts in their e-commerce engine to determine when to display the sale price promotions based on their timezone.
No logic is implemented as part of the fields, so connecting the dates to the price will need to be done within your e-commerce engine.
Access scheduled promotions as an operator
Marketplace operators will be able to access the new price scheduling fields via the GraphQL API. They are detailed below for both Advert and Variant. In the seller interface, the date and time are shown separately, but they're combined into one field in the API.
For sale price:
salePriceStartAt: ISO8601DateTime
salePriceEndAt: ISO8601DateTime
For wholesale prices:
wholesalePromoPrice: Decimal
wholesalePromoPriceEndAt: ISO8601DateTime
wholesalePromoPriceStartAt: ISO8601DateTime
For more information see the API documentation for:
Related articles