Overview 
Namespace 
WSDL 
Schema 
 Component 
Index 
PREV C-TYPE   NEXT C-TYPE
FRAMES   NO FRAMES NS-Bindings
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API
complexType "ns:ReviseItemRequestType"
Namespace:
urn:ebay:apis:eBLBaseComponents
Content:
complex, 13 elements, elem. wildcard
Defined:
globally in Schema in ebaySvc.wsdl; see XML source
Includes:
definitions of 3 elements
Used:
at 1 location
Component Diagram
XML Representation Summary
<...>
   
Content: 
ns:DetailLevel*, ns:ErrorLanguage?, ns:MessageID?, ns:Version?, ns:EndUserIP?, ns:ErrorHandling?, ns:InvocationID?, ns:OutputSelector*, ns:WarningLevel?, ns:BotBlock?, {any}*, ns:Item?, ns:DeletedField*, ns:VerifyOnly?
</...>
All Direct / Indirect Based Elements (1):
ns:ReviseItemRequest
Known Usage Locations
Annotation
Enables a seller to revise a listing on a specified eBay site. To revise an active listing, the seller specifies the ItemID value for the listing. The seller makes one or multiple changes to the listing through the Item container, and the seller can also use one or more DeletedField tags to remove an optional field/setting from the listing.

After a multiple-quantity, fixed-price listing has one or more sales, or less than 12 hours remain before the listing is scheduled to end, you can not edit the values in the Listing Title, Primary Category, Secondary Category, Listing Duration, and Listing Type fields for that listing. The same applies to an auction listing that has at least one bid.

To revise a multiple-variation, fixed-price listing, the ReviseFixedPriceItem call should be used instead, as the ReviseItem call does not support variation-level edits.
Type Definition Detail
Type Derivation Tree
ns:AbstractRequestType (extension)
  ns:ReviseItemRequestType
XML Source (w/o annotations (4); see within schema source)
<xs:complexType name="ReviseItemRequestType">
<xs:complexContent>
<xs:extension base="ns:AbstractRequestType">
<xs:sequence>
<xs:element minOccurs="0" name="Item" type="ns:ItemType"/>
<xs:element maxOccurs="unbounded" minOccurs="0" name="DeletedField" type="xs:string"/>
<xs:element minOccurs="0" name="VerifyOnly" type="xs:boolean"/>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Content Element Detail (all declarations defined in this component; 3/14)
ns:DeletedField
Type:
xs:string, predefined, simple content
Specifies the name of a field to delete from a listing. The request can contain zero, one, or many instances of DeletedField (one for each field to be deleted). See the relevant field descriptions to determine when to use DeletedField (and potential consequences).

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 if the item has bids and/or ends within 12 hours. Some optional fields cannot be deleted if other fields depend on them.

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].
XML Representation Summary
<ns:DeletedField>
   
Content: 
{ xs:string }
</ns:DeletedField>
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" name="DeletedField" type="xs:string"/>
ns:Item
Type:
ns:ItemType, complex content
The Item container is used to make changes to the active listing. The seller must pass in the ItemID value for the listing that is being revised. For anything else that the seller wishes to change, such as quantity or price, the seller should include this field in the call request and give it a new value.

If the seller wants to delete one or more optional settings in the listing, the seller should use the DeletedField tag.
Component Diagram
XML Representation Summary
<ns:Item>
   
Content: 
ns:ApplicationData?, ns:AttributeSetArray?, ns:AttributeArray?, ns:LookupAttributeArray?, ns:AutoPay?, ns:BiddingDetails?, ns:BuyerProtection?, ns:BuyItNowPrice?, ns:CategoryMappingAllowed?, ns:Charity?, ns:Country?, ns:CrossPromotion?, ns:Currency?, ns:Description?, ns:DescriptionReviseMode?, ns:Distance?, ns:HitCounter?, ns:ItemID?, ns:ListingDetails?, ns:ListingDuration?, ns:ListingEnhancement*, ns:ListingType?, ns:Location?, ns:LotSize?, ns:PartnerCode?, ns:PartnerName?, ns:PaymentDetails?, ns:PaymentMethods*, ns:PayPalEmailAddress?, ns:PrimaryCategory?, ns:PrivateListing?, ns:ProductListingDetails?, ns:Quantity?, ns:PrivateNotes?, ns:RegionID?, ns:RelistLink?, ns:ReservePrice?, ns:ReviseStatus?, ns:ScheduleTime?, ns:SecondaryCategory?, ns:FreeAddedCategory?, ns:Seller?, ns:SellingStatus?, ns:ShippingDetails?, ns:ShipToLocations*, ns:Site?, ns:StartPrice?, ns:Storefront?, ns:SubTitle?, ns:TimeLeft?, ns:Title?, ns:UUID?, ns:VATDetails?, ns:SellerVacationNote?, ns:WatchCount?, ns:HitCount?, ns:DisableBuyerRequirements?, ns:BestOfferDetails?, ns:LocationDefaulted?, ns:UseTaxTable?, ns:GetItFast?, ns:BuyerResponsibleForShipping?, ns:LimitedWarrantyEligible?, ns:eBayNotes?, ns:QuestionCount?, ns:Relisted?, ns:QuantityAvailable?, ns:SKU?, ns:SearchDetails?, ns:PostalCode?, ns:PictureDetails?, ns:VideoDetails?, ns:DispatchTimeMax?, ns:BestOfferEnabled?, ns:LocalListing?, ns:SellerContactDetails?, ns:TotalQuestionCount?, ns:ProxyItem?, ns:ExtendedSellerContactDetails?, ns:LeadCount?, ns:NewLeadCount?, ns:ItemSpecifics?, ns:GroupCategoryID?, ns:ClassifiedAdPayPerLeadFee?, ns:BidGroupItem?, ns:ApplyBuyerProtection?, ns:ListingSubtype2?, ns:MechanicalCheckAccepted?, ns:UpdateSellerInfo?, ns:UpdateReturnPolicy?, ns:ItemPolicyViolation?, ns:CrossBorderTrade*, ns:BusinessSellerDetails?, ns:BuyerGuaranteePrice?, ns:BuyerRequirementDetails?, ns:ReturnPolicy?, ns:PaymentAllowedSite*, ns:InventoryTrackingMethod?, ns:IntegratedMerchantCreditCardEnabled?, ns:Variations?, ns:ItemCompatibilityList?, ns:ItemCompatibilityCount?, ns:ConditionID?, ns:ConditionDescription?, ns:ConditionDisplayName?, ns:TaxCategory?, ns:QuantityAvailableHint?, ns:QuantityThreshold?, ns:DiscountPriceInfo?, ns:SellerProvidedTitle?, ns:VIN?, ns:VINLink?, ns:VRM?, ns:VRMLink?, ns:QuantityInfo?, ns:SellerProfiles?, ns:ShippingServiceCostOverrideList?, ns:ShippingOverride?, ns:ShippingPackageDetails?, ns:TopRatedListing?, ns:QuantityRestrictionPerBuyer?, ns:FloorPrice?, ns:CeilingPrice?, ns:IsIntermediatedShippingEligible?, ns:UnitInfo?, ns:RelistParentID?, ns:ConditionDefinition?, ns:HideFromSearch?, ns:ReasonHideFromSearch?, ns:PickupInStoreDetails?, ns:SiteId?, ns:IgnoreQuantity?, ns:AvailableForPickupDropOff?, ns:EligibleForPickupDropOff?, ns:LiveAuction?, ns:DigitalGoodInfo?, ns:eBayPlus?, ns:eBayPlusEligible?, ns:eMailDeliveryAvailable?, ns:IsSecureDescription?, {any}*
</ns:Item>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="Item" type="ns:ItemType"/>
ns:VerifyOnly
Type:
xs:boolean, predefined, simple content
When the VerifyOnly is included and set as true, the active listing is not actually revised, but the same response is returned and the seller gets to see the expected fees based on the changes made, and can also view any listing recommendations if the Item.IncludeRecommedations boolean field is included and set to true.
XML Representation Summary
<ns:VerifyOnly>
   
Content: 
{ xs:boolean }
</ns:VerifyOnly>
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" name="VerifyOnly" type="xs:boolean"/>
Overview 
Namespace 
WSDL 
Schema 
 Component 
Index 
PREV C-TYPE   NEXT C-TYPE
FRAMES   NO FRAMES NS-Bindings
SUMMARY: XML REP | DERIVED | USE
DETAIL: DESC | XML SRC | TYPE | ATTR | CHILD
eBay Trading API
WSDL documentation generated with FlexDoc/XML 1.13 using FlexDoc/XML WSDLDoc 1.2.5 template set. All XSD diagrams generated by FlexDoc/XML DiagramKit.