Relisting Items

Relisting an item creates a new listing with all of the properties of the old one, except those the seller explicitly changed.

Overview

Indicating Changed Fields When Relisting an Item

Removing/Changing a Field When Relisting an Item

Changing Reserve Price in a Relisted Item

Changing Payment Methods in a Relisted Item

Relisting Items with Product Details (Catalogs)

Relisting Using Different API Versions

Relisting Eligible Administratively Canceled Items

Using VerifyRelistItem to Test RelistItem

Overview

If a listing ends, it may be eligible for relist. See the Relisting your item eBay online help for specific information on when an item is and is not eligible to be relisted.

Note: If the item was being watched when the listing ended, it will continue to be watched when the item is relisted.

When a seller relists an item, it can be done without any changes to the item by specifying the ItemID of the original listing that ended in the RelistItem request.

You can also relist an item and make changes to the listing. For example, the seller might want to a lower the price for the item, hoping to better entice a user to purchase the item. When relisting an item, not all elements of a listing can be changed and some changes can cause fees to be incurred where the relist would otherwise be free. For instance, if the seller relists an item and specifies a fee-based listing enhancement (where the original item did not use that listing enhancement), then the seller would pay to relist the item.

The application must use the original ItemID for every RelistItem attempt, whether or not there are changes to the item's definition values.

Note: For Best Match information related to multi-variation listings, see the Best Match information at the following topic: Listing with multiple variations. For information about considering an item's rank in search results, see Considering Best Match When Revising and Relisting Items.

Indicating Changed Fields When Relisting an Item

If the seller changes the listing category, data that depends on the category is still required to be consistent with the category the seller has selected. This means the seller may need to change the listing details when they change the category. For example, the seller may need to change the listing's Item Specifics or product details to be consistent with the new category (see Relisting Items with Product Details (Catalogs) for more information about this particular case).

The category requirements for providing payment methods apply to a relisted item in the same way they applied to the original item.

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 relist the item. Therefore, it should be specified again as a new property. See Mapping Old Category IDs to Current IDs.

To change an item property when using RelistItem, the application simply specifies the new value of the property in the Item object used as input. For an example, see Sample XML for Modifying and Removing Fields.

Removing/Changing a Field When Relisting an Item

You can remove/change most fields when you relist an item. The way you do that 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 example, if you wanted to change the start price to 200.00, change the Listing Designer theme to theme number 10, and remove the subtitle, your request would contain the following. You can see in the following code snippet, that for StartPrice and ThemeID new values are specified. To remove the subtitle, you use DeletedField.

Example: Sample XML for Modifying and Removing Fields
...
<Item>
  <ItemID>4046156496</ItemID>
  <StartPrice currencyID="USD">200.0</StartPrice>
  <ListingDesigner>
    <ThemeID>10</ThemeID>
  </ListingDesigner>
</Item>
<DeletedField>Item.SubTitle</DeletedField>
...

If you are deleting a listing enhancement (deleting a value found in ListingEnhancementsCodeType) and you accidentally include both a new listing enhancement and a deletion of the enhancement, the enhancement you added overrides your deletion. In the following example, Highlight is being added and BoldTitle is being removed. The result would be Highlight would be added but BoldTitle would not be removed.

Example: Sample XML for Deleting a Listing Enhancement with a Relist
...
<Item>
  <ItemID>4046156496</ItemID>
  <StartPrice currencyID="USD">200.0</StartPrice>
  <ListingEnhancement>Highlight</ListingEnhancement>
<Item>
<DeletedField>Item.ListingEnhancement[BoldTitle]</DeletedField>
...

Changing Reserve Price in a Relisted Item

When you relist an item that has a ReservePrice, the ReservePrice value must be equal to or less than the value of the ReservePrice in the original listing.

Changing Payment Methods in a Relisted Item

A listing must have at least one valid payment method. To determine the payment methods that each eBay site supports, see PaisaPay on the eBay India Site.

When you revise a listing and you specify a payment method that is invalid for the target site, eBay ignores the invalid payment method, lists the item, and returns a warning to indicate that the invalid payment method was ignored. If multiple payment methods were invalid, the warning indicates that they were all ignored.

If you modify the listing so that it includes no valid payment methods, an error is returned. This situation could occur when the seller removes all valid payment methods or when all the payment methods specified for the item are no longer valid on the target site.

See also Changing Payment Methods When Revising an Item.

Relisting 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.

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 re-listing an item with product details:

After executing RelistItem 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.

Relisting Using Different API Versions

When relisting, you may get an error about certain elements not being specified. It is possible for this to occur when an item is initially listed with an older version and then relisted with a newer version.

There may be little or no mapping from older tags to newer tags and thus the old listing does not contain enough information to be successfully relisted with the newer version (for example, details related to shipping or to item specifics).

One solution would be to relist the item with the older version. However, that requires knowing what version is best, and you might not have been the one who originally listed the item.

Troubleshooting tips:

Relisting Eligible Administratively Canceled Items

You can use RelistItem to quickly relist an item that was administratively can celled due to a violation of an eBay listing policy, for certain violations (see Rules for listings for more information on eBay's listing policies). Using RelistItem in this case is more efficient than using AddItem. In some cases, sellers may even be able to relist partially sold multi-quantity listings which have been prematurely removed from the site depending upon the violation.

You can use either GetItem or GetSellerList to determine if your item has been administratively can celled and can be relisted. Specifically, if the GetItem or GetSellerList response contains Item.SellingStatus.AdminEnded as true, the item can be relisted.

Note that GetItem or GetSellerList response will include Item.ItemPolicyViolation.PolicyID and Item.ItemPolicyViolation.PolicyText, which provide the ID and a brief textual description, respectively, of the violated policy. GetItem and GetSellerList will only return information about administratively can celled listings to the seller of the item.

When using GetSellerList, if you are the seller and specify AdminEndedItemsOnly as true in the request, all other specified filters are ignored and only admin-cancelled listings are contained in the response, if any.

These enhancements apply to all eBay sites (including eBay Motors but not Half.com).

Using VerifyRelistItem to Test RelistItem

An application can also test the listing of an item by using VerifyRelistItem instead of RelistItem. VerifyRelistItem uses the same inputs (and in the same ways) and returns the same values as RelistItem, except that it does not actually relist the item. An application could thus use VerifyRelistItem to test the item definition for validity and to present the seller with a preview of the estimated relisting fees before the item is actually relisted. Once tested, the application could use the same ItemType object that was used with VerifyRelistItem and use it again, unchanged, with RelistItem.

For information on RelistItem, including executing the call and business logic, see the RelistItem Call Reference documentation. For information on VerifyRelistItem, see the VerifyRelistItem Call Reference documentation.

Check for a Message node in the VerifyRelistItem response because it may indicate that a RelistItem attempt will be unsuccessful; see the following Knowledge Base article, based on AddItem and VerifyAddItem:

VerifyAddItem Returns Success with No Errors, but AddItem Returns Failure with Errors

https://ebaydts.com/eBayKBDetails?KBid=912

Copyright © 2005–2016 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.