If this flag is included and set to
, it enables the Out-of-Stock feature. A seller would use this feature to keep Fixed-Price GTC (Good 'Til Canceled) listings alive even when the "quantity available" value goes to 0 (zero). This is useful when waiting for additional stock and eliminates the need to end the listing and then recreating it when stock arrives.
While the "quantity available" value is 0, the listing would be hidden from eBay search and if that item was specifically searched for with GetItem
(or related call), the element HideFromSearch
would be returned as 'true' and ReasonHideFromSearch
would be returned as 'OutOfStock'.
When stock is available, the seller can use the Revise
calls to update the inventory of the item (through the Item.Quantity
fields) and the listing would appear again.
You can return the value of this flag using the GetUserPreferences
call and setting the ShowOutOfStockControlPreference
field to 'true'. IMPORTANT: When a listing using the Out-of-Stock feature has zero quantity, the seller has 90 days to add inventory without incurring a listing fee. Fees are changed at the end of each the billing cycle but are then refunded if the item is out-of-stock for an entire billing period. See Fees For a Listing With Zero Quantity for details.