eBay Shopping APIVersion 1119

DiscountPriceInfoType

Contains the discount pricing details for an item, including the original retail price and the display treatment to be used for the item. The pricing treatment displayed for a discounted item depends on the values specified in this container when the item is listed. Discount pricing treatments (Strikethrough Pricing and Minimum Advertised Price) apply to only fixed-price listings. Sellers can apply Discount Pricing to both MSKU and Non-MSKU items.

The Strikethrough Pricing feature is only available on the US (including Motors), Canada (including Motors, and both English and French versions of site), UK, Germany, France, Italy, and Spain sites. The Minimum Advertised Price feature is only available on the US site.

Types that use DiscountPriceInfoType:

Calls that use DiscountPriceInfoType:

Fields



MinimumAdvertisedPrice ( AmountType (double) ) [0..1]
A value equal to the agreed upon minimum advertised price.

The minimum advertised price is an agreed upon price that is set by the suppliers/OEMs and the retailers/sellers. The minimum advertised price is the lowest price for which an item can be advertised. Large volume sellers can negotiate with the suppliers/OEMs to offer certain items below the set minimum advertised price. eBay does not maintain or validate the agreed upon minimum advertised price; the seller is responsible for setting this value in accordance with their agreement with the supplier/OEMs. MAP pricing treatments apply to only fixed-price, listings on the eBay US site.
See the Field Index to learn which calls use MinimumAdvertisedPrice.

MinimumAdvertisedPriceExposure ( MinimumAdvertisedPriceExposureCodeType ) [0..1]
This field is only returned for US-based listings eligible for, and using the MAP feature. The enumeration value returned in this field indicates how/when the Minimum Advertised Price will be displayed to the buyer. See the descriptions for each enumeration value for more information.
See the Field Index to learn which calls use MinimumAdvertisedPriceExposure.

OriginalRetailPrice ( AmountType (double) ) [0..1]
This field specifies the price to which the discounted-price display treatment will be applied (for example, a strikethrough price). The discounted price of an item is shown in the CurrentPrice field, and is always less than the value in this field.
See the Field Index to learn which calls use OriginalRetailPrice.

PricingTreatment ( PricingTreatmentCodeType ) [0..1]
This field denotes whether or not an item qualifies for a discount pricing treatment display, such as STP or MAP. If this field is set to MAP, you must abide by the rules for displaying MAP items, as described in the MinimumAdvertisedPriceExposure field.

Important: For listings that return PricingTreatment set to MAP, you are legally required to follow the rules for displaying the price of the item to potential buyers. You are bound by the terms of the API License Agreement to follow these rules. Refer to the API License Agreement for consequences of non-compliance.
See the Field Index to learn which calls use PricingTreatment.

SoldOffeBay ( boolean ) [0..1]
Used by the eBay UK and eBay Germany (DE) sites, this field indicates that the discount price (shown in CurrentPrice field) is the price for which the seller offered the same item for sale on a web site or offline store other than eBay in the previous 30 days. The discount price is always in reference to the seller's own price for the item.

In the event both SoldOffeBay and SoldOneBay fields are set, SoldOneBay takes precedence.
See the Field Index to learn which calls use SoldOffeBay.

SoldOneBay ( boolean ) [0..1]
Used by the eBay UK and eBay Germany (DE) sites, this field indicates that the discount price (shown in CurrentPrice field) is the price for which the seller offered the same (or similar) item for sale on eBay within the previous 30 days. The discount price is always in reference to the seller's own price for the item.

In the event both SoldOffeBay and SoldOneBay fields are set, SoldOneBay takes precedence.
See the Field Index to learn which calls use SoldOneBay.