Skip to main content
Published: March 03 2010, 6:21:00 PMUpdated: November 28 2020, 8:15:34 PM

Is there a way to put up my eBay items for Sale?


Yes, if you are a store owner  you can use the promotional sale APIs to create price discount and/or free shipping sales for many listings at a time. The following API calls can be used to create and manage promotional sales (you must be a registered eBay store owner):

    * SetPromotionalSale
    * SetPromotionalSaleListings
    * GetPromotionalSaleDetails

Here is how you would put up some items on Sale

Step 1: Create Sale

The first step in applying a discount across many listings is creating a promotional sale using SetPromotionalSale. This call can be used to add, modify, or remove a promotional sale. If you are adding a sale, the input fields include the action (add), sale name, sale type and time period.

There are three types of promotional sales:

    * Price discount only
    * Free shipping only
    * Price discount and free shipping

Single and multi-quantity Store Inventory format, and regular fixed-price format listings can be added to any of the sale types. Auction and auction/BIN format listings can be added to free shipping sales only.

Think of the Sale as a the definition holder for the discount. Listings need to be added to the sale for the sale to have value.

Here is a SetPromotionalSale sample that will apply a 15$ discount to items that are added to the sale.

 <SetPromotionalSaleRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Action>Add</Action>
<PromotionalSaleDetails>
<PromotionalSaleName>Test Sale</PromotionalSaleName>
<DiscountType>Price</DiscountType>
<DiscountValue>15</DiscountValue>
<PromotionalSaleStartTime>2010-03-04T00:06:56.066Z</PromotionalSaleStartTime>
<PromotionalSaleEndTime>2010-03-07T19:28:56.066Z</PromotionalSaleEndTime>
<PromotionalSaleType>PriceDiscountOnly</PromotionalSaleType>
</PromotionalSaleDetails>
<RequesterCredentials>
   <eBayAuthToken>token</eBayAuthToken>
</RequesterCredentials>
</SetPromotionalSaleRequest>

On successful execution, the call response will return a PromotionalSaleID. See a sample response below -

   <?xml version="1.0" encoding="UTF-8" ?> 
  <SetPromotionalSaleResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2010-03-04T00:06:16.265Z</Timestamp>
  <Ack>Success</Ack>
  <Version>657</Version>
  <Build>E657_CORE_BUNDLED_10708779_R1</Build>
  <Status>Scheduled</Status>
  <PromotionalSaleID>5500305001</PromotionalSaleID>
  </SetPromotionalSaleResponse>


Step 2: Put items on Sale

To put items on sale per the terms of the sale defined earlier, use the SetPromotionalSaleListings call.

An item needs to have been listed for at least 24 hours (US site), before it can be added to a sale. For other rules, review this list. The sample below shows how to put one item (ItemID 110043673980) on the sale defined earlier. Once the items are added to the Sale, the Sale becomes active. More than one item can be added to the sale at a time by specifying the itemIDs under PromotionalSaleItemIDArray.

 <?xml version="1.0" encoding="utf-8"?>
<SetPromotionalSaleListingsRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Action>Add</Action>
  <PromotionalSaleID>5500305001</PromotionalSaleID>
  <AllFixedPriceItems>false</AllFixedPriceItems>
  <AllStoreInventoryItems>false</AllStoreInventoryItems>
  <RequesterCredentials>
    <eBayAuthToken>token</eBayAuthToken>
  </RequesterCredentials>
  <PromotionalSaleItemIDArray>
    <ItemID>190001875304</ItemID>
  </PromotionalSaleItemIDArray>
</SetPromotionalSaleListingsRequest>

Item listings affected by a promotional sale are displayed as items on sale.

Image

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