Enables a seller to change the properties of a currently active fixed-price listing (including multi-variation listings). Inputs are the item ID of the item being revised, and any properties that are being changed. If the item was listed with InventoryTrackingMethod set to SKU, the SKU may be used to manage inventory, instead of ItemID.
Sellers can change active multiple-quantity fixed price listings, even after one of the items within the listung has been purchased, if that listing does not end within 12 hours. The transaction ID is associated with a snapshot of the item data at the time of the purchase. Sellers or Buyers can get a snapshot of the listing as it was at the time of a given purchase by invoking GetItem with a Transaction ID in the request. Sellers of an item are allowed to view all transactional snapshots of the listing, whereas buyers can only view the transactional snapshots for which they are the successful buyer. Past transactional views of an item are available for up to 90 days from the date the transaction took place.
For Notifications, you can set the transaction event to trigger your notifications or use an event related to the entire listing. Be aware that if you're using item transaction snapshot data, fields like Listing Status may report an Active status (because the listing was Active on the transaction date), but the listing may actually have ended.
Steps for revising details related to shipping are unique. See
Specifying Shipping Costs when Creating or Revising a Listing.
For Best Match information related to multi-variation listings, see the Best Match information at the following topic:
Multi-quantity Fixed Price listings with variations. If you are considering an item's rank (placement) in search results, see the link below about considering Best Match.
Note: When you use the ReviseFixedPriceItem call within a Merchant Data file, it must be enclosed within BulkDataExchangeRequest tags. After release 637, a namespace is returned in the BulkDataExchangeResponseType (top level) of the response. The BulkDataExchange tags are not shown in the call input/output descriptions, but you can see them in the Change Price and Other Details for Multiple Listings in Bulk (for Large Merchants) sample at the end of this page.
Specifies the name of a field to delete from a listing. See the eBay Trading API guide for rules on deleting values when relisting items. Also see the relevant field descriptions to determine when to use DeletedField (and potential consequences). The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). DeletedField accepts the following path names, which delete the corresponding nodes:
You cannot delete required fields from a listing.
Some data (such as Variation nodes within Variations) can't be deleted by using DeletedFields. See the relevant field descriptions for how to delete such data.
Some fields are optional when you first list an item (e.g., ListingEnhancement), but once they are set they cannot be deleted when you revise an item. Some optional fields cannot be deleted if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them. For example, if GalleryType was already set for the item you are revising, you cannot remove it. Therefore, you still need to include at least one picture URL, a gallery URL, or a catalog stock photo in your revised listing. See the eBay Trading API guide for rules on removing values when revising items.
The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). DeletedField accepts the following path names, which delete the corresponding nodes:
Item.ApplicationData
Item.AttributeSetArray
Item.ItemSpecifics
Item.ListingCheckoutRedirectPreference.ProStoresStoreName
Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername
Item.ListingDesigner.LayoutID
Item.ListingDesigner.ThemeID
Item.PayPalEmailAddress
Item.PictureDetails.GalleryURL
Item.PictureDetails.PictureURL
Item.PostalCode
Item.ProductListingDetails
Item.SellerContactDetails
Item.SellerContactDetails.CompanyName
Item.SellerContactDetails.County
Item.SellerContactDetails.InternationalStreet
Item.SellerContactDetails.Phone2AreaOrCityCode
Item.SellerContactDetails.Phone2CountryCode
Item.SellerContactDetails.Phone2CountryPrefix
Item.SellerContactDetails.Phone2LocalNumber
Item.SellerContactDetails.PhoneAreaOrCityCode
Item.SellerContactDetails.PhoneCountryCode
Item.SellerContactDetails.PhoneCountryPrefix
Item.SellerContactDetails.PhoneLocalNumber
Item.SellerContactDetails.Street
Item.SellerContactDetails.Street2
Item.ShippingDetails.PaymentInstructions
Item.SKU (unless InventoryTrackingMethod is SKU)
These values are case-sensitive. Use values that match the case of the schema element names (Item.PictureDetails.GalleryURL) or make the initial letter of each field name lowercase (item.pictureDetails.galleryURL). However, do not change the case of letters in the middle of a field name. For example, item.picturedetails.galleryUrl is not allowed.
See the
Field Index to learn which calls use DeletedField.
© 2005–2009 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.
