Revising a Listing
Sellers often need to change elements of a currently active listing. Typically, the change makes the item more appealing to buyers.
Subtopics
Qualifications to Revise an Item
Using the VerifyOnly Field to Test Your Changes
Item Changes Allowed During Revisions
Revising Multiple-Choice (Unbounded) Fields
Revising eBay for Charity Listings
Revising Fixed-Priced Items After Purchases are Made
Removing/Changing a Field When Revising an Item
Changing Payment Methods When Revising an Item
Revising US eBay Motors Listings
Revising Items with Product Details (Catalogs)
Changing a Listing Start Price
Overview
An item that is still active on the eBay site may be changed by the seller. This is known as revising an item. When an item is revised, the seller can specify a new value for one or multiple elements of the item's definition or remove an element. To revise an listing, use ReviseItem. This call is directly analogous to the Revise Your Item (RYI) page on the eBay site.
Note: eBay does not distinguish between listing in your eBay Store and regular eBay listings. The rules for revising these listings are the same.
There are certain rules that govern what can be changed when a listing has bids or is within 12 hours of the end of the listing. For information regarding the rules for revising a listing see, Restrictions on revising listings.
If you are only changing a listing's price or quantity, consider using ReviseInventoryStatus instead of ReviseItem or ReviseFixedPriceItem.
Revising an item using ReviseItem or ReviseFixedPriceItem entails these basic steps:
- Specify the item to revise (by its item ID) in Item.ItemID.
- Specify the item fields to add or change.
- Not all fields can be revised. See Item Changes Allowed During Revisions.
- If you are deleting a field, see Removing/Changing a Field When Revising an Item.
For addition information, see the following pages.
Rules for Revising Items
https://ebaydts.com/eBayKBDetails?KBid=732
Errors Related To Listing Policies
Best Match With Multi-variation Listings
Listing with multiple variations
Best Match and the Item's Rank in Search Results
Considering Best Match When Revising and Relisting Items
Qualifications to Revise an Item
To revise an item, the following conditions must be met:
- The requester is the seller. Users cannot revise others' items.
- The item listing must still be active. It is not possible to revise an ended item listing. (But it might be eligible to be relisted, with property changes. See Relisting Items.)
Additionally for auctions, there are restrictions on what can be changed based on whether the listing has bids and based on whether the listing will end within twelve hours. For more on this, see Item Changes Allowed During Revisions
Using the VerifyOnly Field to Test Your Changes
You can use the VerifyOnly boolean field with the flag set to 'true' in ReviseItem, if you want the response to include the calculated listing price change (if there is an increase in the BIN/Start price) but you do not want the values to persist in the database.
Including the VerifyOnly field in ReviseItem is similar to using VerifyAddItem or VerifyRelistItem to test calls before you actually add or relist the item.
Item Changes Allowed During Revisions
Making changes to an item's listing using ReviseItem is subject to a few restrictions, depending on whether any bids have been placed on the item, and whether the change is being attempted within twelve hours of the end of the auction. In general, you cannot change the listing format (e.g., auction vs. fixed-price) of any listing. For a complete list of what can be changed for auction, fixed-price, and classified ad listings, see Restrictions on revising listings.
The next few subsections of this chapter provide details that you should understand when revising certain features via the API, such as item specifics, eBay Motors details, payment methods, and more. Additional information may be provided in other sections of this guide, where applicable.
For a list of the fields that can be modified in the API, see ReviseItem and ReviseFixedPriceItemin the eBay Trading API Reference).
Revising Multiple-Choice (Unbounded) Fields
Because ReviseItem replaces only item properties that are included in the input ItemType
object and list of properties changed, be careful when updating properties that are made up of multiple choice options, such as shipping option. In these cases, specify all intended options. For instance, if the listing already has options #1 and #2 and the revision change is to add option #3, include all three in the property of the input ItemType
object.
Revising a Category
If you change the category, please note that the CategoryMappingAllowed flag is transient. If it was specified as true
when the item was originally listed, it will not automatically be set to true when you revise the item. Therefore, it should be specified again as a new property. See Mapping Old Category IDs to Current IDs.
Revising eBay for Charity Listings
You cannot use ReviseItem or ReviseFixedPriceItem to modify eBay for Charity items. See Working with Listings that Benefit Nonprofits for additional information.
Revising Fixed-Priced Items After Purchases are Made
You can revise a multi-quantity fixed-price listing after buyers have purchased items from it. In these cases, GetItem normally returns the latest (revised) details of the listing.
If a buyer purchases items from a multi-quantity fixed-price listing, eBay saves a snapshot of the listing as it was at the time of the purchase. The TransactionID of the order is associated with that snapshot. Sellers and buyers can retrieve the snapshot of the listing by calling GetItem and passing TransactionID in the request. (The snapshot is also available in GetItemTransactions and related calls.)
Sellers of an item are allowed to view any purchase snapshots of the listing (any transaction or order), whereas buyers can only view the purchase snapshots for which they are the successful buyer. Order line items (purchases) can be viewed for up to 90 days from the creation date.
If you are using Notifications, you can set the order line item event to trigger your notifications or use an event related to the entire listing. Be aware that if you're using item purchase snapshot data, fields like ListingStatus may report an Active status (because the listing was Active on the order line item (transaction) date), but the listing may actually have ended.
Removing/Changing a Field When Revising an Item
Just like with the RelistItem, when you use ReviseItem changing fields is subject to the rules described in Item Changes Allowed During Revisions and in the ReviseItem Call Reference.
The way you remove/change a field depends on the field. For example, to remove a boolean field, set the value to 'false'. To remove a string, you use DeletedField. Refer to the RelistItem documentation for information about how to remove/change specific fields.
For an example of a request to change fields, see Sample XML for Modifying and Removing Fields.
Changing Payment Methods When Revising an Item
A listing must have at least one valid payment method, but you can change it when you revise the item.
When revising the payment method for an item, you need to pass in the entire set of payment methods. For example, if you had 4 payments methods for the item and you want to replace one of them, you cannot just delete the old one and pass in a new one. Instead you must specify the entire set of payment methods you want in the ReviseItem call.
Revising US eBay Motors Listings
In addition to the normal rules for revising listings, the following rules apply for US eBay Motors listings:
- Site: Set Item.Site to the
eBayMotors
site code and specify "0" as the site ID in the request URL. - PrimaryCategory and SecondaryCategory: You cannot change the meta-category of a vehicle. For example, you cannot change a truck to a motorcycle.
- ListingDesigner: Listing Designer elements are ignored when revising any listings (vehicular and non-vehicular) on the US eBay Motors site.
- ShippingDetails: You cannot revise shipping, tax, and insurance elements for any listings (vehicular and non-vehicular) on the US eBay Motors site.
- BuyItNowPrice: The rules for revising the Buy It Now Price for eBay Motors listings are the same as for other listings, except for the following. You can use the BuyItNowPrice argument to add or lower the Buy It Now Price of a vehicle listing if all of the following conditions exist:
- The new Buy It Now Price must be at least $1.00 less than the original Buy It Now Price.
- The new Buy It Now Price must be at least $1.00 greater than the current high bid price.
- The Buy It Now Price can be lowered regardless of the amount of time remaining in the listing.
- ReservePrice: The reserve price for US eBay Motors vehicle listings can be lowered or removed regardless of the amount of time remaining in the listing. See Reducing Reserve Price.
- Lowest: $0.00 (to remove the reserve price)
- Highest: ReservePrice - 1 ( $1.00 below the current reserve price)
- Lowest: CurrentPrice + 1 ( $1.00 above the current high bid)
- Highest: ReservePrice - 1 ($1.00 below the current reserve price)
However, you can change a subcategory in which a vehicle is listed, as long as there are no bids on the listing. For example, you can change the primary or secondary category from a motorcycle subcategory to another motorcycle subcategory.
If you relist this item, the ReservePrice value must be equal to or less than the value of the ReservePrice in the original listing.
If the item has no bids, set ReservePrice to any value within this range:
If the item has bids, set ReservePrice to a value within this range:
If the vehicle listing has bids, then users who view the listing will see a message indicating that the next bid will meet the reserve price. See the Fees Overview on the eBay Web site for information about fee credits that may be available when the reserve price is removed.
Fees Overview
https://pages.ebay.com/help/sell/fees.html
When retrieving items from the US eBay Motors site, GetItem returns information about changes to Buy It Now and reserve prices in the ReviseStatus property of the Item object.
Revising Items with Product Details (Catalogs)
Items in certain categories can have details whose values are well known and don't vary from listing to listing. Instead of filling in this standard information for every listing, a seller can create a listing in which this information has already been partially filled out (pre-filled). This data is called product details.
When an auction item has bids or the listing ends in fewer than 12 hours, you cannot change the product ID and you cannot remove the product from the listing. However, you can change the values of the IncludeStockPhotoURL, UseStockPhotoURLAsGallery, and IncludePrefilledItemInformation flags. (This restriction does not apply to fixed-price listings.)
When an auction item has no bids and does not end within 12 hours, you can use ReviseItem to add, modify, or remove product details.
If an item is listed with product details and you change the relevant category, you need to make sure the new category is mapped to the characteristics set associated with the product. The product data must always be consistent with at least one of the listing's categories. If the item already includes product details, but that information is inconsistent with the new category, you must remove the product information or replace it with new product information that is consistent.
These are the common scenarios when revising an item with product details:
- Add product details to the listing—to add product details, set Item.ProductListingDetails to contain all product information that you want to include in the listing. Specify the ID of the product that should be used to pre-fill the listing, and use the optional child elements to specify whether you want the listing to include a stock photo, whether you want to use the stock photo as the item's gallery image, and whether to include a stock summary in addition to your own item description.
- If you choose to include a stock photo in the listing, you can either use the stock photo as the Gallery image by setting UseStockPhotoURLAsGallery to true or use the first image passed in PictureURL as the Gallery image. See Using an eBay Stock Photo as a Gallery Picture.
- Remove all existing product data (including Item Specifics)—to remove all existing product data from the listing, specify
Item.ProductListingDetails
in DeletedField andItem.ItemSpecifics
in DeletedField. - Pre-filled item specifics are removed from the listing.
- Item specifics that are not pre-filled are maintained (unless you remove them or change the category to one that does not support the previously specified item specifics).
- The stock photo (if any) is removed from the listing (and from the Gallery, if applicable).
- The link to additional summary information is removed from the listing.
- Replace previous product data (including pre-filled Item Specifics)—to replace the previous product data with data for a different product, set Item.ProductListingDetails to contain the new product data.
- Add, modify, or change item specifics that were not pre-filled—to add, modify, or change only the item specifics that were not pre-filled, see Revising and Relisting with Custom Item Specifics for rules on revising Item Specifics.
If you remove product data, it has the following effects:
Changes to product data in the system do not affect an existing listing. Therefore, the product ID and any pre-filled data that was present at the time of the AddItem request remains constant at the time of the ReviseItem request.
After executing ReviseItem with product details, you should compare the response to the request to make sure that the data that was actually listed matches the data that you sent. For example, if you changed the value of an item specific but the value is now pre-filled in the catalog, the pre-filled value overrides the value you send in.
Changing a Listing Start Price
When you revise an item, you can change the listing start price. However, if you reduce the start price, the insertion fee is not credited (for the US site and other participating sites). The insertion fee is based on the maximum price the item has had in its life cycle.
Reducing Reserve Price
Sellers can lower Reserve Prices on listings on the US eBay site, eBay UK site, or eBay Motors site, even after bids have been placed, to increase the likeliness of their items selling. To determine whether a site or category supports this capability, call GetCategories and check the ReduceReserveAllowed and ORRA fields. See Determining Whether a Category Supports Reserve Prices. Depending on the site and category, you also may need to call GetCategoryFeatures and check MinimumReservePrice.
When a category supports lowering the reserve, a seller can adjust the reserve price through the Revise Your Item process or by using ReviseItem, as long as no bids have exceeded the original reserve price. For most categories, this is only allowed when 12 or more hours remain for the listing. The reserve price can be reduced downwards to a minimum of one bid increment above the listing's current price. Once the reserve has been lowered, bidders are notified of the change via email, My eBay, and the listing itself.
If the item has no bids, set ReservePrice to any value within this range:
- Lowest: 0.0 (if the category supports removing the reserve)
- Highest: ReservePrice - bid increment
If the item has bids, set ReservePrice to a value within this range:
- Lowest: CurrentPrice + bid increment
- Highest: ReservePrice - bid increment
If the new reserve price is lower than the high bidder's proxy bid, the proxy bid is also reduced to one increment below the new bid price, to prevent bidders from unexpectedly becoming winning bidders when their prior bid had not yet met the Reserve price. For example, imagine a US listing starts at $1 with a reserve of $100, and the first bidder bids $75. The current price stays at $1 since the bid didn't meet the reserve. Then, if the seller then reduces reserve to $50, the bidder's proxy bid is reduced to one bid increment below $50. For a chance at becoming a winning bidder, the bidder would need to place another bid.
No credit is given for Reserve Price Fee if the listing is revised to reduce the Reserve Price.
For additional information on lowering the Reserve Price on Motors, see Revising US eBay Motors Listings.
Using Listing Recommendations
Listing Recommendations are used by eBay sellers to retrieve eBay-generated listing recommendations. These listing recommendations can then be used by the seller to improve or bring listings up to standard. The Listing Recommendation types (classifications) are Category (recommended categories for miscategorized items), Condition Description (for used items missing a Condition Description), eTRS (eBay Top-Rated Seller requirements), GSP (items eligible for the Global Shipping Program), Item Specifics (mandatory and recommended Item Specifics), Picture (picture requirments in listings), and UPC (recommendation to use product codes to create a quality listing).
To retrieve Listing Recommendations in the response of an Add/Revise/Relist/Verify API call, include and set the IncludeRecommendations field to 'true' in the request of the call.
For more information on Listing Recommendations, see the ListingRecommendationType definition.
https://developer.ebay.com/Devzone/XML/docs/Reference/eBay/types/ListingRecommendationType.html