Skip to main content

This type defines the fields used to describe an item price markdown discount.

Types that use ItemPriceMarkdown

Not used by any types.

Calls that use ItemPriceMarkdown

Fields

Field
Type
Description
applyFreeShipping
If set to true, free shipping is applied to the first shipping service specified for the item. The first domestic shipping option is set to "free shipping," regardless if the shipping optionType for that service is set to FLAT_RATE, CALCULATED, or NOT_SPECIFIED (freight). This flag essentially adds free shipping as a part of the discount.

Default: false
autoSelectFutureInventory
If set to true, eBay will automatically add inventory items to the markdown discount if they meet the selectedInventoryDiscounts criteria specified for the markdown discount.

Default: false
blockPriceIncreaseInItemRevision
If set to true, price increases (including removing the free shipping flag) are blocked and an error message is returned if a seller attempts to adjust the price of an item that's partaking in this markdown discount. If set to false, an item is dropped from the markdown discount if the seller adjusts the price.

Default: false
description
This field is required if you are configuring an MARKDOWN_SALE discount.

This is the seller-defined "tag line" for the offer, such as "Save on designer shoes." A tag line appears under the "offer-type text" that is generated for the discount. The text is displayed on the offer tile that is shown on the seller's All Offers page and on the event page for the discount.

Note: Offer-type text is a teaser that's presented throughout the buyer's journey through the sales flow and is generated by eBay. This text is not editable by the seller—it's derived from the settings in the discountRules and discountSpecification fields—and can be, for example, "20% off".


Maximum length: 50
endDate
The date and time the discount ends, in UTC format (yyyy-MM-ddThh:mm:ssZ). The value supplied for endDate must be at least 24 hours after the value supplied for the startDate of the markdown discount.

For display purposes, convert this time into the local time of the seller.

Max value:
  • 14 days for the AT, CH, DE, ES, FR, IE, IT, and UK, marketplaces.
  • 45 days for all other marketplaces.
marketplaceId
The eBay marketplace ID of the site where the markdown discount is hosted. Markdown discounts are supported on all eBay marketplaces.
name
The seller-defined name or 'title' of the discount that the seller can use to identify a discount. This label is not displayed in end-user flows.

Maximum length: 90
priority
This field is ignored in markdown discounts.
promotionImageUrl
Required for CODED_COUPON, MARKDOWN_SALE, and ORDER_DISCOUNT discounts, populate this field with a URL that points to an image to be used with the discount. This image is displayed on the seller's All Offers page. The URL must point to either JPEG or PNG image and it must be a minimum of 500x500 pixels in dimension and cannot exceed 12Mb in size.
promotionStatus
The current status of the discount. When creating a new discount, you must set this value to either DRAFT or SCHEDULED.

Note that you must set this value to SCHEDULED when you update a RUNNING discount.
selectedInventoryDiscounts
A list that defines the sets of selected items for the markdown discount.
startDate
The date and time the discount starts in UTC format (yyyy-MM-ddThh:mm:ssZ). For display purposes, convert this time into the local time of the seller.

Got thoughts? Click the feedback button – your insights help us improve!