Shopping_DiscountPriceInfoType Class Reference
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
property
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. -
minimumAdvertisedPrice
A value equal to the agreed upon minimum advertised price.
property
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. -
minimumAdvertisedPriceExposure
If an item listing qualifies it to be listed as a MAP item
property
(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. -
pricingTreatment
This field denotes whether or not an item qualifies for a discount
property
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.
-
soldOneBay
Used by the eBay UK and eBay Germany (DE) sites, this field indicates
property
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. -
soldOffeBay
Used by the eBay UK and eBay Germany (DE) sites, this field indicates
property
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. -
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