This value indicates the quantity of the specific variation that are
available for purchase. If you set
Variation.Quantity to
0 when
you create, revise, or relist an item listing, the variation is dropped from
the listing. To prevent this, you can set
SetUserPreferences.OutOfStockControlPreference to
true.
For
GetItem (and other related calls that retrieve the Item
object), the
Variation.Quantity value indicates the total quantity associated with the variation, including the quantity available and the
quantity sold. To calculate the quantity available for sale, subtract
SellingStatus.QuantitySold from this value.
For RelistFixedPriceItem:
- For an item variation that had an available quantity greater than
0 when the listing ended, the Quantity value of the item variation for the newly relisted item is set to the actual quantity available. For item variations, there is actually no QuantityAvailable field, but this value may be derived if you look at the corresponding item variation in a GetMyeBaySelling) response and subtract the Variation.QuantitySold value from the Variation.Quantity value, which represents the original Variation.Quantity value at creation time of the previous listing.
- For item variations with an available quantity of
0 when the listing ended, the relisted item will retain the Variaton.Quantity value that was passed in at creation time of the previous listing.
So, if you are relisting an item that had one or more item variations with an available quantity of
0 when the listing ended, we strongly recommend that you pass in the correct available quantity through the corresponding
Variation.Quantity field of a relist call. Alternatively, you can update the correct quantity available by using a
ReviseInventoryStatus call and passing in a
Quantity value, while also making sure to pass in the correct
SKU value(s) to identify the correct item variation. A
ReviseInventoryStatus call can be used to revise the quantity of up to four single item listings and/or item variations (from the same or different listings).
For ReviseFixedPriceItem:
You can revise a variation's quantity at any time, even if
it has purchases. However, unless you set the
OutOfStockControlPreference boolean field of the
SetUserPreferences call to
true, at least one variation must remain
with a non-zero quantity in order for the listing to remain active. If you set the
OutOfStockControlPreference field to
true, a multiple-variation listing will remain active but hidden from search even if the quantity of all variations in the listing is set to
0.
When you modify a variation during revise or
relist, you need to include both its
StartPrice and
Quantity.
If you revise the
Quantity value for a variation after items have
already sold, specify the quantity available for sale.
(eBay will automatically add the
quantity sold to the value you specify.) If you set the quantity to
0 and the variation has no purchases, the variation may be
dropped from the listing.
For GetSellerTransactions: See
Item.Quantity instead.
See the
eBay Features Guide
for more details about setting and modifying a variation's quantity.
Note:
The number in the Variation.Quantity field represents the current quantity of the item variation that is available using the "Ship to home" fulfillment method. This number does not take into account any quantity of the item variation that is available through "local" fulfillment methods such as In-Store Pickup or Click and Collect. This is due to the fact that there is no current implementation (or API field) where the seller informs eBay about the quantity of item variations available through each local fulfillment method. In the case where a listing is only offering the item variations through a local fulfillment method, this value should default to 0, and the Item.IgnoreQuantity will also be returned as True.
