Trading_InventoryStatusType Class Reference
Inherits from | NSObject |
Conforms to | PicoBindable |
Declared in | Trading_InventoryStatusType.h Trading_InventoryStatusType.m |
Overview
Lightweight type for updating basic inventory status details.
Primarily intended for bulk use cases.
@ingroup EBayAPIInterface
Tasks
-
sku
The unique SKU of the item being revised.
property
A SKU (stock keeping unit) is an identifier defined by a seller.
SKU can only be used to revise an item if you listed the item by
using AddFixedPriceItem or RelistFixedPriceItem, and:
1) You set Item.InventoryTrackingMethod to SKU at
the time the item was listed; or
2) You are modifying a multi-variation listing, and the SKU
identifies one of the variations. (In this case, if InventoryTrackingMethod was set to ItemID, then you also need to specify ItemID in the request.)
(These criteria are necessary to
uniquely identify the listing or variation by a SKU.)
In the ReviseInventoryStatus request, if the listing has
InventoryTrackingMethod set to SKU, then either ItemID or SKU is
required. If both are passed in and they don’t refer to the
same listing, eBay ignores SKU and considers only the ItemID.
If the listing has variations and InventoryTrackingMethod is set
to ItemID, then ItemID and SKU are both required.
In the response, SKU may be returned as an empty element if
it was not defined on the listing. -
itemID
The ItemID of a listing being changed.
property
In the ReviseInventoryStatus request, either ItemID or SKU is
required. If both are passed in and the SKU does not match,
eBay ignores SKU and considers only the ItemID.
Please note that the same ItemID can be returned
multiple times in the same response if you revise several
variations from the same multi-variation listing. -
startPrice
Specifies the revised fixed price of the listing (or of a
property
variation within a multi-variation listing).
If you raise the price of a listing, the recent sales score of
the listing is reset. (Best Match search ranking is based on
buyer activity, and one of the factors affecting search ranking
for fixed-price listings is the recent sales score.)
Raising a listing’s price may also affect the insertion fee
(and therefore the overall listing fee).
ReviseInventoryStatus requires either StartPrice or Quantity (or both) for each InventoryStatus node in the request. -
quantity
Specifies the latest quantity of the listing (or of a variation
property
within a multi-variation listing).
For the ReviseInventoryStatus request:
Specify the entire quantity that is currently available for sale.
(Typically, you only pass this in when you need to update
the quantity.)
ReviseInventoryStatus requires either StartPrice or Quantity
(or you can specify both) for each InventoryStatus node in
the request.
For the ReviseInventoryStatus response:
This returns a total of the quantity available for sale
plus the quantity already sold. For example, suppose the
listing originally had Quantity=10, and then 8 sold. Now you
restock your inventory, and you pass Quantity=10 in the
ReviseInventoryStatus request. In this case,
ReviseInventoryStatus returns Quantity=18
(10 available + 8 sold).
To determine the quantity available, use GetItem or GetSellerList,
and subtract SellingStatus.QuantitySold from Quantity.
Or see QuantityAvailable in GetMyeBaySelling.
It is a good idea to maintain an adequate quantity available for
fixed-price GTC listings to prevent the search rankings from
dropping. Best Match search ranking is based on buyer activity,
and one of the factors affecting search ranking for fixed-price
listings is the recent sales score. Fixed-price items that are
selling the fastest are given a relative lift in search results.
Recent Sales history is tracked with a moving window to ensure it
reflects the most recent activity. Due to he moving window, it is
advantageous to maintain item availability (Quantity-QuantitySold)
for a GTC listing. -
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
Trading_InventoryStatusType.h
itemID
The ItemID of a listing being changed.
In the ReviseInventoryStatus request, either ItemID or SKU is
required. If both are passed in and the SKU does not match,
eBay ignores SKU and considers only the ItemID.
Please note that the same ItemID can be returned
multiple times in the same response if you revise several
variations from the same multi-variation listing.
@property (nonatomic, retain) NSString *itemID
Discussion
The ItemID of a listing being changed.
In the ReviseInventoryStatus request, either ItemID or SKU is
required. If both are passed in and the SKU does not match,
eBay ignores SKU and considers only the ItemID.
Please note that the same ItemID can be returned
multiple times in the same response if you revise several
variations from the same multi-variation listing.
type : NSString, wrapper for primitive string
Declared In
Trading_InventoryStatusType.h
quantity
Specifies the latest quantity of the listing (or of a variation
within a multi-variation listing).
For the ReviseInventoryStatus request:
Specify the entire quantity that is currently available for sale.
(Typically, you only pass this in when you need to update
the quantity.)
ReviseInventoryStatus requires either StartPrice or Quantity
(or you can specify both) for each InventoryStatus node in
the request.
For the ReviseInventoryStatus response:
This returns a total of the quantity available for sale
plus the quantity already sold. For example, suppose the
listing originally had Quantity=10, and then 8 sold. Now you
restock your inventory, and you pass Quantity=10 in the
ReviseInventoryStatus request. In this case,
ReviseInventoryStatus returns Quantity=18
(10 available + 8 sold).
To determine the quantity available, use GetItem or GetSellerList,
and subtract SellingStatus.QuantitySold from Quantity.
Or see QuantityAvailable in GetMyeBaySelling.
It is a good idea to maintain an adequate quantity available for
fixed-price GTC listings to prevent the search rankings from
dropping. Best Match search ranking is based on buyer activity,
and one of the factors affecting search ranking for fixed-price
listings is the recent sales score. Fixed-price items that are
selling the fastest are given a relative lift in search results.
Recent Sales history is tracked with a moving window to ensure it
reflects the most recent activity. Due to he moving window, it is
advantageous to maintain item availability (Quantity-QuantitySold)
for a GTC listing.
@property (nonatomic, retain) NSNumber *quantity
Discussion
Specifies the latest quantity of the listing (or of a variation
within a multi-variation listing).
For the ReviseInventoryStatus request:
Specify the entire quantity that is currently available for sale.
(Typically, you only pass this in when you need to update
the quantity.)
ReviseInventoryStatus requires either StartPrice or Quantity
(or you can specify both) for each InventoryStatus node in
the request.
For the ReviseInventoryStatus response:
This returns a total of the quantity available for sale
plus the quantity already sold. For example, suppose the
listing originally had Quantity=10, and then 8 sold. Now you
restock your inventory, and you pass Quantity=10 in the
ReviseInventoryStatus request. In this case,
ReviseInventoryStatus returns Quantity=18
(10 available + 8 sold).
To determine the quantity available, use GetItem or GetSellerList,
and subtract SellingStatus.QuantitySold from Quantity.
Or see QuantityAvailable in GetMyeBaySelling.
It is a good idea to maintain an adequate quantity available for
fixed-price GTC listings to prevent the search rankings from
dropping. Best Match search ranking is based on buyer activity,
and one of the factors affecting search ranking for fixed-price
listings is the recent sales score. Fixed-price items that are
selling the fastest are given a relative lift in search results.
Recent Sales history is tracked with a moving window to ensure it
reflects the most recent activity. Due to he moving window, it is
advantageous to maintain item availability (Quantity-QuantitySold)
for a GTC listing.
type : NSNumber, wrapper for primitive int
Declared In
Trading_InventoryStatusType.h
sku
The unique SKU of the item being revised.
A SKU (stock keeping unit) is an identifier defined by a seller.
SKU can only be used to revise an item if you listed the item by
using AddFixedPriceItem or RelistFixedPriceItem, and:
1) You set Item.InventoryTrackingMethod to SKU at
the time the item was listed; or
2) You are modifying a multi-variation listing, and the SKU
identifies one of the variations. (In this case, if InventoryTrackingMethod was set to ItemID, then you also need to specify ItemID in the request.)
(These criteria are necessary to
uniquely identify the listing or variation by a SKU.)
In the ReviseInventoryStatus request, if the listing has
InventoryTrackingMethod set to SKU, then either ItemID or SKU is
required. If both are passed in and they don’t refer to the
same listing, eBay ignores SKU and considers only the ItemID.
If the listing has variations and InventoryTrackingMethod is set
to ItemID, then ItemID and SKU are both required.
In the response, SKU may be returned as an empty element if
it was not defined on the listing.
@property (nonatomic, retain) NSString *sku
Discussion
The unique SKU of the item being revised.
A SKU (stock keeping unit) is an identifier defined by a seller.
SKU can only be used to revise an item if you listed the item by
using AddFixedPriceItem or RelistFixedPriceItem, and:
1) You set Item.InventoryTrackingMethod to SKU at
the time the item was listed; or
2) You are modifying a multi-variation listing, and the SKU
identifies one of the variations. (In this case, if InventoryTrackingMethod was set to ItemID, then you also need to specify ItemID in the request.)
(These criteria are necessary to
uniquely identify the listing or variation by a SKU.)
In the ReviseInventoryStatus request, if the listing has
InventoryTrackingMethod set to SKU, then either ItemID or SKU is
required. If both are passed in and they don’t refer to the
same listing, eBay ignores SKU and considers only the ItemID.
If the listing has variations and InventoryTrackingMethod is set
to ItemID, then ItemID and SKU are both required.
In the response, SKU may be returned as an empty element if
it was not defined on the listing.
type : NSString, wrapper for primitive string
Declared In
Trading_InventoryStatusType.h
startPrice
Specifies the revised fixed price of the listing (or of a
variation within a multi-variation listing).
If you raise the price of a listing, the recent sales score of
the listing is reset. (Best Match search ranking is based on
buyer activity, and one of the factors affecting search ranking
for fixed-price listings is the recent sales score.)
Raising a listing’s price may also affect the insertion fee
(and therefore the overall listing fee).
ReviseInventoryStatus requires either StartPrice or Quantity (or both) for each InventoryStatus node in the request.
@property (nonatomic, retain) Trading_AmountType *startPrice
Discussion
Specifies the revised fixed price of the listing (or of a
variation within a multi-variation listing).
If you raise the price of a listing, the recent sales score of
the listing is reset. (Best Match search ranking is based on
buyer activity, and one of the factors affecting search ranking
for fixed-price listings is the recent sales score.)
Raising a listing’s price may also affect the insertion fee
(and therefore the overall listing fee).
ReviseInventoryStatus requires either StartPrice or Quantity (or both) for each InventoryStatus node in the request.
type : class Trading_AmountType
Declared In
Trading_InventoryStatusType.h