eBay Trading APIVersion 1145

PromotionalSaleType

Note: While the Trading API continues to support item promotions for an eBay store owner, the Trading API will no longer be enhanced with any new item promotion capabilities as they are developed by eBay. In addition, Promoted Listings are also not supported by the Trading API. For these two reasons, it is recommended that sellers/developers make plans to migrate to the Marketing API, which provides all Promotions Manager and Promoted Listings capabilities, and this API will continue to be improved and enhanced as more marketing features become available to sellers. Details for a single promotional sale.

Types that use PromotionalSaleType:

Calls that use PromotionalSaleType:

Fields



DiscountType ( DiscountCodeType ) [0..1]
Type of a promotional sale discount for items (for example, percentage). Applies to price discount sales only.
See the Field Index to learn which calls use DiscountType.

DiscountValue ( double ) [0..1]
Value of a promotional sale discount for items, a percentage discount or a fixed amount reduction. Percentage discounts must be at least 5% and cannot exceed 75% of the original listing price. Fixed amount discounts will be in the currency of the original listing. Applies to price discount sales only.
See the Field Index to learn which calls use DiscountValue.

PromotionalSaleEndTime ( dateTime ) [0..1]
End date of a promotional sale discount for items. Maximum listing durations vary by site from 14 days to 45 days. The minimum promotional sale duration is 1 day for most sites, but 3 days on some sites.
See the Field Index to learn which calls use PromotionalSaleEndTime.

PromotionalSaleID ( long ) [0..1]
Unique ID of a promotional sale (discount and/or free shipping) for items. This field is an input field only for the SetPromotionalSale call and only if you are not adding a new promotional sale.
See the Field Index to learn which calls use PromotionalSaleID.

PromotionalSaleItemIDArray ( ItemIDArrayType ) [0..1]
Items covered by a promotional sale.
See the Field Index to learn which calls use PromotionalSaleItemIDArray.

PromotionalSaleName ( string ) [0..1]
Name of a promotional sale for items.
See the Field Index to learn which calls use PromotionalSaleName.

PromotionalSaleStartTime ( dateTime ) [0..1]
Start date of a promotional sale for items. Promotional sales can start immediately or be scheduled to start at a later date. Some sites require items to have been listed for a specific duration before they can be added to a promotional sale (for example, on the US site, items must have been listed for a day before they can be added to a promotional sale).
See the Field Index to learn which calls use PromotionalSaleStartTime.

PromotionalSaleType ( PromotionalSaleTypeCodeType ) [0..1]
Type of promotional sale: price discount, free shipping, or both.
See the Field Index to learn which calls use PromotionalSaleType.

Status of a promotional sale for items.
See the Field Index to learn which calls use Status.