Inherits from Trading_AbstractRequestType : NSObject
Declared in Trading_ReviseItemRequestType.h
Trading_ReviseItemRequestType.m

Overview

Enables a seller to change the properties of a currently active listing. Also for Half.com.




After one item in a multi-quantity fixed-price listing has been sold, you can not
the values in the Title, Primary Category, Secondary Category, Listing Duration,
and Listing Type fields for that listing. However, all other fields in the
multi-quantity, fixed-price listing are editable.




Inputs are the Item ID of the listing you are revising, and the field or fields
that you are updating.

@ingroup EBayAPIInterface

Tasks

  •   item

    Child elements hold the values for properties that are changing. The
    Item.ItemID property must always be set to the ID of the item listing being
    changed. Set values in the Item object only for those properties that are
    changing. Use DeletedField to remove a property.



    Applicable to Half.com.

         property
  •   deletedField

    Specifies the name of a field to delete from a listing. See the eBay
    Trading API guide for rules on deleting values when revising 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).



    You cannot delete required fields from a listing.



    Some fields are optional when you first list an item (e.g.,
    SecondaryCategory), but once they are set they cannot be deleted when you
    revise an item. Some optional fields cannot be deleted from auction
    listings if the item has bids and/or ends within 12 hours. Some optional
    fields cannot be deleted if other fields depend on them.



    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. See the eBay Web Services guide for rules on removing values
    when revising items. Also see the relevant field descriptions for details
    on when to use DeletedField (and potential consequences).



    DeletedField accepts the following path names, which delete the
    corresponding nodes:



    Item.ApplicationData

    Item.AttributeSetArray

    Item.BuyItNowPrice

    Item.ConditionID

    Item.ExtendedSellerContactDetails

    Item.ClassifiedAdContactByEmailEnabled

    Item.ItemSpecifics

    Item.ListingCheckoutRedirectPreference.ProStoresStoreName

    Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername

    Item.ListingDesigner.LayoutID

    Item.ListingDesigner.ThemeID

    Item.ListingDetails.MinimumBestOfferMessage

    Item.ListingDetails.MinimumBestOfferPrice

    Item.ListingEnhancement[Value]

    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)

    Item.SubTitle



    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.



    To delete a listing enhancement like BoldTitle, specify the value you are
    deleting in square brackets (“[ ]”); for example,
    Item.ListingEnhancement[BoldTitle].

         property
  •   verifyOnly

    When the VerifyOnly boolean tag value is supplied as ‘true’, the response will include the calculated
    listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB.
    This call is similar to VerifyAddItem in revise mode.

         property

Properties

deletedField

Specifies the name of a field to delete from a listing. See the eBay
Trading API guide for rules on deleting values when revising 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).



You cannot delete required fields from a listing.



Some fields are optional when you first list an item (e.g.,
SecondaryCategory), but once they are set they cannot be deleted when you
revise an item. Some optional fields cannot be deleted from auction
listings if the item has bids and/or ends within 12 hours. Some optional
fields cannot be deleted if other fields depend on them.



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. See the eBay Web Services guide for rules on removing values
when revising items. Also see the relevant field descriptions for details
on when to use DeletedField (and potential consequences).



DeletedField accepts the following path names, which delete the
corresponding nodes:



Item.ApplicationData

Item.AttributeSetArray

Item.BuyItNowPrice

Item.ConditionID

Item.ExtendedSellerContactDetails

Item.ClassifiedAdContactByEmailEnabled

Item.ItemSpecifics

Item.ListingCheckoutRedirectPreference.ProStoresStoreName

Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername

Item.ListingDesigner.LayoutID

Item.ListingDesigner.ThemeID

Item.ListingDetails.MinimumBestOfferMessage

Item.ListingDetails.MinimumBestOfferPrice

Item.ListingEnhancement[Value]

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)

Item.SubTitle



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.



To delete a listing enhancement like BoldTitle, specify the value you are
deleting in square brackets (“[ ]”); for example,
Item.ListingEnhancement[BoldTitle].

@property (nonatomic, retain) NSMutableArray *deletedField

Discussion

Specifies the name of a field to delete from a listing. See the eBay
Trading API guide for rules on deleting values when revising 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).



You cannot delete required fields from a listing.



Some fields are optional when you first list an item (e.g.,
SecondaryCategory), but once they are set they cannot be deleted when you
revise an item. Some optional fields cannot be deleted from auction
listings if the item has bids and/or ends within 12 hours. Some optional
fields cannot be deleted if other fields depend on them.



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. See the eBay Web Services guide for rules on removing values
when revising items. Also see the relevant field descriptions for details
on when to use DeletedField (and potential consequences).



DeletedField accepts the following path names, which delete the
corresponding nodes:



Item.ApplicationData

Item.AttributeSetArray

Item.BuyItNowPrice

Item.ConditionID

Item.ExtendedSellerContactDetails

Item.ClassifiedAdContactByEmailEnabled

Item.ItemSpecifics

Item.ListingCheckoutRedirectPreference.ProStoresStoreName

Item.ListingCheckoutRedirectPreference.SellerThirdPartyUsername

Item.ListingDesigner.LayoutID

Item.ListingDesigner.ThemeID

Item.ListingDetails.MinimumBestOfferMessage

Item.ListingDetails.MinimumBestOfferPrice

Item.ListingEnhancement[Value]

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)

Item.SubTitle



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.



To delete a listing enhancement like BoldTitle, specify the value you are
deleting in square brackets (“[ ]”); for example,
Item.ListingEnhancement[BoldTitle].

entry type : NSString, wrapper for primitive string

Declared In

Trading_ReviseItemRequestType.h

item

Child elements hold the values for properties that are changing. The
Item.ItemID property must always be set to the ID of the item listing being
changed. Set values in the Item object only for those properties that are
changing. Use DeletedField to remove a property.



Applicable to Half.com.

@property (nonatomic, retain) Trading_ItemType *item

Discussion

Child elements hold the values for properties that are changing. The
Item.ItemID property must always be set to the ID of the item listing being
changed. Set values in the Item object only for those properties that are
changing. Use DeletedField to remove a property.



Applicable to Half.com.

type : class Trading_ItemType

Declared In

Trading_ReviseItemRequestType.h

verifyOnly

When the VerifyOnly boolean tag value is supplied as ‘true’, the response will include the calculated
listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB.
This call is similar to VerifyAddItem in revise mode.

@property (nonatomic, retain) NSNumber *verifyOnly

Discussion

When the VerifyOnly boolean tag value is supplied as ‘true’, the response will include the calculated
listing price change if there is an increase in the BIN/Start price, but does not persist the values in DB.
This call is similar to VerifyAddItem in revise mode.

type : NSNumber, wrapper for primitive bool

Declared In

Trading_ReviseItemRequestType.h