Skip to main content

Find the answer to your question

Advanced Search
Published: March 18 2014, 9:22:00 AMUpdated: November 28 2020, 11:21:03 PM
Product

Summary


Sellers now have the ability to keep their GTC (Good 'Til Cancelled) items alive, even when the quantity goes down to zero. This enables sellers to replenish stock for the same ItemID, without the need to relist when the item is back in stock.


Benefits

Easier inventory management due to 1:1 mapping between SKU and ItemID
Long lived ItemIDs facilitate SEO and merchandizing
Items retain sales history
Variations management becomes easy since
Variation with zero quantity that have no sale are kept alive All variations with zero quantity is now possible
All variations with zero quantity is now possible

Feature availability

  • This is currently available only via the API. Developers who use the Trading API and LMS can make use of this feature

Feature Details

  • The feature can be added to a listing by using the boolean element OutOfStockControl in the Add, Revise, Relist API calls
  • Once you add the feature to an item, you cannot remove it.  To remove it, you will need to end the item and relist with OutOfStockControl set to false
  • This feature allows you to set quantity to zero and keeps the item alive when the last quantity is sold
  • When the item is out of stock (quantity equals zero), Search will not surface the item in the search results till it is back in stock (quantity greater than zero)
  • GTC (Good 'Til Cancelled)
  • Item will renew every 30 days and applicable listing fees will be charged, regardless of whether the item is in or out of stock
  • Item will continue to live whether it is in or out of stock, till the seller ends the item

API details

  • Add out of stock control feature

 

Feature

Sample snippet

Add feature using AddItem, AddFixedPriceItem, ReviseItem, ReviseFixedPriceItem, RelistItem, RelistFixedPriceItem

<AddItemRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<Item>

<ListingType>FixedPriceItem</ListingType>

<ListingDuration>GTC</ListingDuration>

<OutOfStockControl>true</OutOfStockControl>

…

</Item>

</AddItemRequest>

Revise Quantity using ReviseInventoryStatus, ReviseItem, ReviseFixedPriceItem

<ReviseInventoryStatusRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<InventoryStatus>

<ItemID>190004054177</ItemID>

<Quantity>0</Quantity>

</InventoryStatus>

</ReviseInventoryStatusRequest>

Revise everything else using ReviseItem, ReviseFixedPriceItem

Revision is subject to the revise restrictions:
http://pages.ebay.com/help/sell/revising_restrictions.html

<ReviseItemRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<Item>

<ItemID>190004054177</ItemID>

<Description>new description</Description>

</Item>

</ReviseItemRequest>


  • API for variations:

 

Feature

Sample snippet

Setting Quantity to zero

You can now set the quantity to zero, even for the last variation, which will put the entire item out of search

<ReviseInventoryStatusRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<InventoryStatus>

<SKU>RLauren_Wom_TShirt_Pnk_S1231</SKU>

<Quantity>0</Quantity>

</InventoryStatus>

<InventoryStatus>

<SKU>RLauren_Wom_TShirt_Pnk_M1232</SKU>

<Quantity>0</Quantity>

</InventoryStatus>

</ReviseInventoryStatusRequest>

Deleting a variation

Setting the quantity to zero will not delete variations with no sale. You have to use the Delete field.

<ReviseFixedPriceItemRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<Item>

<SKU>RL123453</SKU>

<Variations>

<Variation>

<SKU>RLauren_Wom_TShirt_Pnk_S1231</SKU>

<Delete>true</Delete>

</Variation>

</Variations>

</Item>

</ReviseFixedPriceItemRequest>


  • Checking item status and setting it back in stock:

 

Feature

Sample snippet

Checking status using GetItem, GetSellerList

*ActiveInventoryReport will also return the item

<GetItemResponse xmlns='urn:ebay:apis:eBLBaseComponents'>

…

<Item>
….

<ItemID>190004054177</ItemID>

<ListingDuration>GTC</ListingDuration>

<ListingType>FixedPriceItem</ListingType>

<Quantity>0</Quantity>

<SellingStatus>

<ListingStatus>Active</ListingStatus>

</SellingStatus>

<HideFromSearch>true</HideFromSearch>

<ReasonHideFromSearch>OutOfStock</ReasonHideFromSearch>

<OutOfStockControl>true</OutOfStockControl>

</Item>

</GetItemResponse>

Putting the item back in stock using ReviseInventoryStatus, ReviseItem, ReviseFixedPriceItem

<ReviseInventoryStatusRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<InventoryStatus>

<ItemID>190004054177</ItemID>

<Quantity>5</Quantity>

</InventoryStatus>

</ReviseInventoryStatusRequest>

End the item using EndItem, EndFixedPriceItem

*Seller will incur the listing fees every 30 days till the item is alive

<EndItemRequest xmlns='urn:ebay:apis:eBLBaseComponents'>

<ItemID>190004054177</ItemID>

<EndingReason>NotAvailable</EndingReason>

</EndItemRequest>

·


Additional Resources

API Doc:  OutOfStockControl Flag

How well did this answer your question?
Answers others found helpful

Print

Email this page