Inherits from NSObject
Conforms to PicoBindable
Declared in Shopping_DiscountPriceInfoType.h
Shopping_DiscountPriceInfoType.m

Overview

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, BIN items. Sellers can apply Discount Pricing to both MSKU and
Non-MSKU items.

@ingroup ShoppingInterface

Tasks

  •   originalRetailPrice

    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 (specified in the CurrentPrice field) is
    the BIN price and is less than the OriginalRetailPrice of the item.



    See
    Displaying Discount Pricing Information to Buyers
    for
    guidelines on displaying STP and MAP items.

    property
  •   minimumAdvertisedPrice

    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,
    BIN items listed on the eBay US site.

    property
  •   minimumAdvertisedPriceExposure

    If an item listing qualifies it to be listed as a MAP item
    (PricingTreatment returns MAP), the item price cannot be directly
    displayed on the page containing the item. When listing a MAP item,
    the seller stipulates how they want the buyer to view the price of the
    item by setting this field to either PreCheckout or DuringCheckout. If
    this feild is not set for a MAP item, the treatment defaults to PreCheckout.



    If this field is set to PreCheckout, the buyer must click a link (or
    button) to view the item price on a different page (such as in a pop-up
    window). If this field is set to DuringCheckout, the StartPrice must be
    shown only when the buyer in the eBay checkout flow.



    MAP items are supported only on the eBay US site.

    property
  •   pricingTreatment

    This field denotes whether or not an item qualifies for a discount
    pricing treatment display. If a seller lists an item with
    DiscountPriceInfo values, the item response container will include
    a DiscountPriceInfo container with this field set to either
    STP, MAP, or None. If this field is set to MAP, you must abide
    by the rules for displaying MAP items, as described in
    MinimumAdvertisedPriceExposure.



    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.

    property
  •   soldOneBay

    Used by the eBay UK and eBay Germany (DE) sites, this field indicates
    that the discount price (specified as CurrentPrice) 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 areset, soldOneBay
    takes precedence.

    property
  •   soldOffeBay

    Used by the eBay UK and eBay Germany (DE) sites, this field indicates
    that the discount price (specified as currentPrice) 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 areset, soldOneBay
    takes precedence.

    property
  •   any

    (public property)

    property

Properties

any

(public property)

@property (nonatomic, retain) NSMutableArray *any

Discussion

(public property)

entry type : PicoAnyElement, wrapper for primitive anyelement

Declared In

Shopping_DiscountPriceInfoType.h

minimumAdvertisedPrice

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,
BIN items listed on the eBay US site.

@property (nonatomic, retain) Shopping_AmountType *minimumAdvertisedPrice

Discussion

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,
BIN items listed on the eBay US site.

type : class Shopping_AmountType

Declared In

Shopping_DiscountPriceInfoType.h

minimumAdvertisedPriceExposure

If an item listing qualifies it to be listed as a MAP item
(PricingTreatment returns MAP), the item price cannot be directly
displayed on the page containing the item. When listing a MAP item,
the seller stipulates how they want the buyer to view the price of the
item by setting this field to either PreCheckout or DuringCheckout. If
this feild is not set for a MAP item, the treatment defaults to PreCheckout.



If this field is set to PreCheckout, the buyer must click a link (or
button) to view the item price on a different page (such as in a pop-up
window). If this field is set to DuringCheckout, the StartPrice must be
shown only when the buyer in the eBay checkout flow.



MAP items are supported only on the eBay US site.

@property (nonatomic, retain) NSString *minimumAdvertisedPriceExposure

Discussion

If an item listing qualifies it to be listed as a MAP item
(PricingTreatment returns MAP), the item price cannot be directly
displayed on the page containing the item. When listing a MAP item,
the seller stipulates how they want the buyer to view the price of the
item by setting this field to either PreCheckout or DuringCheckout. If
this feild is not set for a MAP item, the treatment defaults to PreCheckout.



If this field is set to PreCheckout, the buyer must click a link (or
button) to view the item price on a different page (such as in a pop-up
window). If this field is set to DuringCheckout, the StartPrice must be
shown only when the buyer in the eBay checkout flow.



MAP items are supported only on the eBay US site.

type: string constant in Shopping_MinimumAdvertisedPriceExposureCodeType.h

Declared In

Shopping_DiscountPriceInfoType.h

originalRetailPrice

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 (specified in the CurrentPrice field) is
the BIN price and is less than the OriginalRetailPrice of the item.



See
Displaying Discount Pricing Information to Buyers
for
guidelines on displaying STP and MAP items.

@property (nonatomic, retain) Shopping_AmountType *originalRetailPrice

Discussion

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 (specified in the CurrentPrice field) is
the BIN price and is less than the OriginalRetailPrice of the item.



See
Displaying Discount Pricing Information to Buyers
for
guidelines on displaying STP and MAP items.

type : class Shopping_AmountType

Declared In

Shopping_DiscountPriceInfoType.h

pricingTreatment

This field denotes whether or not an item qualifies for a discount
pricing treatment display. If a seller lists an item with
DiscountPriceInfo values, the item response container will include
a DiscountPriceInfo container with this field set to either
STP, MAP, or None. If this field is set to MAP, you must abide
by the rules for displaying MAP items, as described in
MinimumAdvertisedPriceExposure.



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.

@property (nonatomic, retain) NSString *pricingTreatment

Discussion

This field denotes whether or not an item qualifies for a discount
pricing treatment display. If a seller lists an item with
DiscountPriceInfo values, the item response container will include
a DiscountPriceInfo container with this field set to either
STP, MAP, or None. If this field is set to MAP, you must abide
by the rules for displaying MAP items, as described in
MinimumAdvertisedPriceExposure.



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.

type: string constant in Shopping_PricingTreatmentCodeType.h

Declared In

Shopping_DiscountPriceInfoType.h

soldOffeBay

Used by the eBay UK and eBay Germany (DE) sites, this field indicates
that the discount price (specified as currentPrice) 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 areset, soldOneBay
takes precedence.

@property (nonatomic, retain) NSNumber *soldOffeBay

Discussion

Used by the eBay UK and eBay Germany (DE) sites, this field indicates
that the discount price (specified as currentPrice) 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 areset, soldOneBay
takes precedence.

type : NSNumber, wrapper for primitive bool

Declared In

Shopping_DiscountPriceInfoType.h

soldOneBay

Used by the eBay UK and eBay Germany (DE) sites, this field indicates
that the discount price (specified as CurrentPrice) 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 areset, soldOneBay
takes precedence.

@property (nonatomic, retain) NSNumber *soldOneBay

Discussion

Used by the eBay UK and eBay Germany (DE) sites, this field indicates
that the discount price (specified as CurrentPrice) 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 areset, soldOneBay
takes precedence.

type : NSNumber, wrapper for primitive bool

Declared In

Shopping_DiscountPriceInfoType.h