The latest version of the Trading API has rolled out to all the API machines and is now available! Be sure to check out all the new features and known issues.
If you are getting started with the API, the following locations have information about joining the eBay Developers Program, creating test users, and other steps to getting your application certified to go live against the eBay production servers:
| Q3 2008 | Q2 2008 | Q1 2008 | Q4 2007 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Version | Release Date | Version | Release Date | Version | Release Date | Version | Release Date | ||||
| 583 | 2007-9-17 | 571 | 2008-6-25 | 557 | 2008-3-19 | 545 | Not Released | ||||
| 581 | 2007-9-3 | 569 | 2008-6-11 | 555 | 2008-3-5 | 543 | 2007-12-18 | ||||
| 579 | 2007-8-20 | 567 | 2008-5-28 | 553 | 2008-2-20 | 541 | Not Released | ||||
| 577 | 2007-8-6 | 565 | 2008-5-14 | 551 | 2008-2-6 | 539 | 2007-11-14 | ||||
| 575 | 2007-7-23 | 563 | 2008-4-30 | 549 | 2008-1-23 | 537 | 2007-10-31 | ||||
| 573 | 2007-7-9 | 561 | 2008-4-16 | 547 | 2008-1-9 | 535 | 2007-10-17 | ||||
| 559 | 2008-4-2 | 533 | 2007-10-3 | ||||||||
These release notes go back four quarters. For older release notes, see the Release Notes archive.
Documentation Changes and Errata - 573
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
CategoryFeatureType.DigitalDeliveryEnabled |
Entity | Removed |
DigitalDeliveryDetailsType |
Entity | Removed |
DigitalDeliveryEnabledCodeType |
Entity | Removed |
DigitalDeliveryEnabledDefinitionType |
Entity | Removed |
DigitalDeliveryMethodCodeType |
Entity | Removed |
ExpressItemRequirementsType.NoDigitalDelivery |
Entity | Removed |
FeatureDefinitionsType.DigitalDeliveryEnabled |
Entity | Removed |
GetSearchResultsRequestType.DigitalDelivery |
Entity | Removed |
ItemType.DigitalDeliveryDetails |
Entity | Removed |
SiteDefaultsType.DigitalDeliveryEnabled |
Entity | Removed |
AnnouncementMessageType |
Complex type | New |
MyMessagesExternalMessageIDArrayType |
Complex type | New |
AnnouncementMessageCodeType |
Enumerated type | New |
GetMyMessagesRequestType.ExternalMessageIDs |
Element | New |
GetMyeBayBuyingRequestType.DeletedFromLostList |
Element | New |
GetMyeBayBuyingRequestType.DeletedFromWonList |
Element | New |
GetMyeBayBuyingResponseType.DeletedFromLostList |
Element | New |
GetMyeBayBuyingResponseType.DeletedFromWonList |
Element | New |
GetMyeBaySellingRequestType.BidList |
Element | New |
GetMyeBaySellingRequestType.DeletedFromSoldList |
Element | New |
GetMyeBaySellingRequestType.DeletedFromUnsoldList |
Element | New |
GetMyeBaySellingResponseType.BidList |
Element | New |
GetMyeBaySellingResponseType.DeletedFromSoldList |
Element | New |
GetMyeBaySellingResponseType.DeletedFromUnsoldList |
Element | New |
MyMessagesMessageType.Content |
Element | New |
MyMessagesMessageType.ListingStatus |
Element | New |
MyMessagesMessageType.MessageType |
Element | New |
MyMessagesMessageType.QuestionType |
Element | New |
ShippingServiceDetailsType.DeprecationDetails |
Element | New |
ShippingServiceDetailsType.MappedToShippingServiceID |
Element | New |
ShippingServiceCodeType.BEFR_LaPosteCertifiedShipping |
Enum | New |
ShippingServiceCodeType.BEFR_LaPosteStandardShipping |
Enum | New |
ShippingServiceCodeType.BEFR_LaPosteTaxipost24h |
Enum | New |
ShippingServiceCodeType.BEFR_LaPosteTaxipostLLS |
Enum | New |
ShippingServiceCodeType.BEFR_LaPosteTaxipostSecur |
Enum | New |
ShippingServiceCodeType.BEFR_PostInternationalRegistered |
Enum | New |
ShippingServiceCodeType.BEFR_PostInternationalStandard |
Enum | New |
ShippingServiceCodeType.BEFR_TNTInternational |
Enum | New |
ShippingServiceCodeType.BENL_DePostCertifiedShipping |
Enum | New |
ShippingServiceCodeType.BENL_DePostStandardShipping |
Enum | New |
ShippingServiceCodeType.BENL_DePostTaxipost24h |
Enum | New |
ShippingServiceCodeType.BENL_DePostTaxipostLLS |
Enum | New |
ShippingServiceCodeType.BENL_DePostTaxipostSecur |
Enum | New |
ShippingServiceCodeType.BENL_OtherShippingMethods |
Enum | New |
ShippingServiceCodeType.BENL_PostInternationalRegistered |
Enum | New |
ShippingServiceCodeType.BENL_PostInternationalStandard |
Enum | New |
ShippingServiceCodeType.BENL_TNTInternational |
Enum | New |
ShippingServiceCodeType.DE_DHLPaket |
Enum | New |
ShippingServiceCodeType.DE_DHLPaketInternational |
Enum | New |
ShippingServiceCodeType.DE_DPBriefInternational |
Enum | New |
ShippingServiceCodeType.DE_DPBuecherWarensendung |
Enum | New |
ShippingServiceCodeType.DE_DPD |
Enum | New |
ShippingServiceCodeType.DE_DPDInternational |
Enum | New |
ShippingServiceCodeType.DE_Einschreiben |
Enum | New |
ShippingServiceCodeType.DE_Express |
Enum | New |
ShippingServiceCodeType.DE_ExpressInternational |
Enum | New |
ShippingServiceCodeType.DE_GLS |
Enum | New |
ShippingServiceCodeType.DE_GLSInternational |
Enum | New |
ShippingServiceCodeType.DE_HermesPaket |
Enum | New |
ShippingServiceCodeType.DE_HermesPaketInternational |
Enum | New |
ShippingServiceCodeType.DE_IloxxTransport |
Enum | New |
ShippingServiceCodeType.DE_IloxxTransportInternational |
Enum | New |
ShippingServiceCodeType.DE_Nachname |
Enum | New |
ShippingServiceCodeType.DE_Paket |
Enum | New |
ShippingServiceCodeType.DE_PaketInternational |
Enum | New |
ShippingServiceCodeType.DE_SonstigeDomestic |
Enum | New |
ShippingServiceCodeType.DE_SonstigeInternational |
Enum | New |
ShippingServiceCodeType.DE_SpecialDelivery |
Enum | New |
ShippingServiceCodeType.DE_UPS |
Enum | New |
ShippingServiceCodeType.DE_UPSInternational |
Enum | New |
As previously announced, sellers on the Germany (DE) and Spain (ES) sites must specify at least one domestic shipping service. In August, US sellers will likewise be required to specify at least one domestic shipping service (exception: freight shipping). For those who intend to not ship an item (that is, local pickup only), a special "shipping service" has been created for the purpose of local pickup only. For more information, see Specifying Shipping Costs.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 573.
If a particular shipping service will be or has been deprecated, the ShippingServiceDetails container (something that can be returned by GeteBayDetails) includes a DeprecationDetails container and a MappedToShippingServiceID.
How you use this deprecation information in your application is up to you. For example, you may choose to display a to-be- deprecated shipping service for the seller to select, or you may choose to only offer the service identified in MappedToShippingServiceID.
Response to a user selecting a deprecated service is different in the API version of the Sell/Revise/Relist Your Item flows than it is in the eBay Web site version.
For details, see Deprecated Shipping Services in the Shipping documentation.
Starting late August 2008, sellers and bidders will not be able to retrieve each other's email addresses unless they are in a transactional relationship. If a listing is active, sellers will not be able to view the bidder's email address when using the following calls: GetHighBidders, GetBidderList,GetAllBidders. This change is applicable to the Sandbox environment starting Mid-July 2008.
A seller can still view the email address of the winning bidder after the listing ends.
BidArray.Offer.User.Email will contain invalid request if an item is active and for users who are neither the winning bidder nor the seller of that item.
MemberMessage.HideSendersEmailAddress will be deprecated in sandbox environment starting mid-July 2008 and in production in late August 2008.
The GetMyMessages call returns more information. It returns the status of a listing (Messages.Message.ListingStatus) when the member-to-member email question is formed. It also returns the type of message retrieved using Messages.Message.MessageType, and the context of the question sent in the email that corresponds to the subject of the message (Messages.Message.QuestionType).
The GetMyMessages call also returns the External message ID (in the Messages.Message.ExternalMessageID), which uniquely identifies a message.
Additionally, a new Content tag is returned (Messages.Message.Content). It contains the message body in plain text format.
Starting in mid July 2008, you can use GetMyeBaySelling.BidList to obtain a seller's BidList from My eBay. The BidList includes all listings with at least one bid from a seller's Active Selling view or Items I'm Selling list in My eBay.
Also, BidLists returned using GetMyeBayBuying and GetMyeBaySelling will now include FeedbackScore and FeedbackRatingStar in BidList.ItemArray.Item.Seller and BidList.ItemArray.Item.SellingStatus.HighBidder.
GetMyeBayBuying can now return a buyer's DeletedFromWonList and DeletedFromLostList which contain items won or lost and deleted from the buyer's My eBay. Furthermore, GetMyeBaySelling can now return a seller's DeletedFromSoldList and DeletedFromUnsoldList. These lists contain items that sold and items that did not sell (or were ended by the seller) which the seller has deleted from My eBay. You can use DurationInDays to return items that have been deleted up to 90 days before the present date.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
See Schema Changes for a list of new shipping services.
As of March 2008, all digital listings (downloadable goods) selling on eBay US are required to be listed in a Classified Ad format within the Everything Else > Information Product category. The previous digital delivery feature is disabled as of March 28, 2008. AddItem and related calls using the DigitalDeliveryDetails fields will fail. Most of the digital delivery fields, such as ItemType.DigitalDeliveryDetails, have been removed from the schema. All remaining digital delivery related fields will be removed in the subsequent release.
For a complete list of deprecated objects (and which objects to use instead), see Deprecated Objects.
Sellers who wish to continue to use the Trading API to offer digital goods can do so by setting the value of Item.ListingType to LeadGeneration and Item.ListingSubtype2 to ClassifiedAd instead (and list in the Everything Else > Information Product category). Using the Classified Ads format, sellers receive a 30-day ad at a fixed price. This solution enables sellers to continue to market their digital goods on eBay; however, because Classified Ad listings are a lead generation tool and do not result in transactions that go through eBay, Feedback cannot be exchanged between buyer and seller.
See Selling Digital Items in the eBay site help for more information and requirements for listing digitally delivered items.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 573 and Changed Functionality - 573.
None for this release.
Documentation Changes and Errata - 571
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
INEscrowWorkflowTimelineDefinitionType |
Complex type | New |
INEscrowWorkflowTimelineCodeType |
Enumerated type | New |
AddressType.Phone2 |
Element | New |
CategoryFeatureType.INEscrowWorkflowTimeline |
Element | New |
FeatureDefinitionsType.INEscrowWorkflowTimeline |
Element | New |
SiteDefaultsType.INEscrowWorkflowTimeline |
Element | New |
FeatureIDCodeType.INEscrowWorkflowTimeline |
Enum | New |
ShippingServiceCodeType.Courier |
Enum | New |
ShippingServiceCodeType.Freight |
Enum | New |
We have updated the version 569 WSDL, because the following types had mis-spellings in the names:
This has been corrected in version 571. If you have already downloaded version 569, please replace it with 571 or download it again.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 571.
Beginning in late June, 2008, the PaisaPay escrow workflow, which is available on selected categories on the India site (site ID 203) that offer the PaisaPayEscrow payment method, will be upgraded to define two additional escrow workflows. The request for GetCategoryFeatures now provides FeatureIDCodeType.INEscrowWorkflowTimeline to determine the escrow workflow that is active on an eligible category. It returns Default (the existing escrow workflow), WorkflowA or WorkflowB in CategoryFeatureType.INEscrowWorkflowTimeline in the GetCategoryFeatures response. For complete details, see Payment Method Differences in the Trading Webhelp.
Starting in early July 2008, sellers using the eBay UK Web site can select "Courier" for shipping (the UK equivalent of the US's "Freight") when listing items. A handful of API changes have been made to support this. See Specifying Freight Shipping in the Shipping chapter for details.
Affected calls: the AddItem family of calls, GetItem, GetItemTransactions, and GetItemShipping.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
FreightOtherShipping (an enumeration in ShippingServiceCodeType) had been used to represent US items shipped with a freight shipping service other than FreightQuote.com. The new enumeration for this concept is named Freight, and FreightOtherShipping has been deprecated.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 571 and Changed Functionality - 571.
See the revised section Specifying Freight Shipping in the Shipping chapter for a reworked presentation of steps for implementing freight shipping.
The table in "Restrictions on Changing Item Properties During a Revision" in the section Revising Items was missing details about a Version 563 improvement: shipping details can be revised for multi-quantity items.
Documentation Changes and Errata - 569
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
ClassifiedAdCompanyNameEnabledDefinitionType |
Complex type | New |
ClassifiedAdContactByAddressEnabledDefinitionType |
Complex type | New |
ClassifiedAdPhoneCountDefinitionType |
Complex type | New |
ClassifiedAdStreetCountDefinitionType |
Complex type | New |
GetClientAlertsAuthTokenRequestType |
Complex type | New |
GetClientAlertsAuthTokenResponseType |
Complex type | New |
LocalMarketAdFormatEnabledDefinitionType |
Complex type | New |
LocalMarketAutoAcceptEnabledDefinitionType |
Complex type | New |
LocalMarketAutoDeclineEnabledDefinitionType |
Complex type | New |
LocalMarketBestOfferEnabledDefinitionType |
Complex type | New |
LocalMarketCompanyNameEnabledDefinitionType |
Complex type | New |
LocalMarketContactByAddressEnabledDefinitionType |
Complex type | New |
LocalMarketContactByEmailEnabledDefinitionType |
Complex type | New |
LocalMarketContactByPhoneEnabledDefinitionType |
Complex type | New |
LocalMarketCounterOfferEnabledDefinitionType |
Complex type | New |
LocalMarketPaymentMethodCheckOutEnabledDefinitionType |
Complex type | New |
LocalMarketPhoneCountDefinitionType |
Complex type | New |
LocalMarketSellerContactDetailsEnabledDefinitionType |
Complex type | New |
LocalMarketShippingMethodEnabledDefinitionType |
Complex type | New |
LocalMarketStreetCountDefinitionType |
Complex type | New |
NonSubscriptionDefinitionType |
Complex type | New |
PremiumSubscriptionDefinitionType |
Complex type | New |
RegularSubscriptionDefinitionType |
Complex type | New |
SpecialitySubscriptionDefinitionType |
Complex type | New |
eBayMotorsProAdFormatEnabledDefinitionType |
Complex type | New |
eBayMotorsProAutoAcceptEnabledDefinitionType |
Complex type | New |
eBayMotorsProAutoDeclineEnabledDefinitionType |
Complex type | New |
eBayMotorsProBestOfferEnabledDefinitionType |
Complex type | New |
eBayMotorsProCompanyNameEnabledDefinitionType |
Complex type | New |
eBayMotorsProContactByAddressEnabledDefinitionType |
Complex type | New |
eBayMotorsProContactByEmailEnabledDefinitionType |
Complex type | New |
eBayMotorsProContactByPhoneEnabledDefinitionType |
Complex type | New |
eBayMotorsProCounterOfferEnabledDefinitionType |
Complex type | New |
eBayMotorsProPaymentMethodCheckOutEnabledDefinitionType |
Complex type | New |
eBayMotorsProPhoneCountDefinitionType |
Complex type | New |
eBayMotorsProSellerContactDetailsEnabledDefinitionType |
Complex type | New |
eBayMotorsProShippingMethodEnabledDefinitionType |
Complex type | New |
eBayMotorsProStreetCountDefinitionType |
Complex type | New |
GeographicExposureCodeType |
Enumerated type | New |
CategoryFeatureType.ClassifiedAdCompanyNameEnabled |
Element | New |
CategoryFeatureType.ClassifiedAdContactByAddressEnabled |
Element | New |
CategoryFeatureType.ClassifiedAdPhoneCount |
Element | New |
CategoryFeatureType.ClassifiedAdStreetCount |
Element | New |
CategoryFeatureType.LocalMarketAdFormatEnabled |
Element | New |
CategoryFeatureType.LocalMarketAutoAcceptEnabled |
Element | New |
CategoryFeatureType.LocalMarketAutoDeclineEnabled |
Element | New |
CategoryFeatureType.LocalMarketBestOfferEnabled |
Element | New |
CategoryFeatureType.LocalMarketCompanyNameEnabled |
Element | New |
CategoryFeatureType.LocalMarketContactByAddressEnabled |
Element | New |
CategoryFeatureType.LocalMarketContactByEmailEnabled |
Element | New |
CategoryFeatureType.LocalMarketContactByPhoneEnabled |
Element | New |
CategoryFeatureType.LocalMarketCounterOfferEnabled |
Element | New |
CategoryFeatureType.LocalMarketPaymentMethodCheckOutEnabled |
Element | New |
CategoryFeatureType.LocalMarketPhoneCount |
Element | New |
CategoryFeatureType.LocalMarketSellerContactDetailsEnabled |
Element | New |
CategoryFeatureType.LocalMarketShippingMethodEnabled |
Element | New |
CategoryFeatureType.LocalMarketStreetCount |
Element | New |
CategoryFeatureType.NonSubscription |
Element | New |
CategoryFeatureType.PremiumSubscription |
Element | New |
CategoryFeatureType.RegularSubscription |
Element | New |
CategoryFeatureType.SpecialitySubscription |
Element | New |
CategoryFeatureType.eBayMotorsProAdFormatEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProAutoAcceptEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProAutoDeclineEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProBestOfferEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProCompanyNameEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProContactByAddressEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProContactByEmailEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProContactByPhoneEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProCounterOfferEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProPaymentMethodCheckOutEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProPhoneCount |
Element | New |
CategoryFeatureType.eBayMotorsProSellerContactDetailsEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProShippingMethodEnabled |
Element | New |
CategoryFeatureType.eBayMotorsProStreetCount |
Element | New |
FeatureDefinitionsType.ClassifiedAdCompanyNameEnabled |
Element | New |
FeatureDefinitionsType.ClassifiedAdContactByAddressEnabled |
Element | New |
FeatureDefinitionsType.ClassifiedAdPhoneCount |
Element | New |
FeatureDefinitionsType.ClassifiedAdStreetCount |
Element | New |
FeatureDefinitionsType.LocalMarketAdFormatEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketAutoAcceptEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketAutoDeclineEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketBestOfferEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketCompanyNameEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketContactByAddressEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketContactByEmailEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketContactByPhoneEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketCounterOfferEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketPaymentMethodCheckOutEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketPhoneCount |
Element | New |
FeatureDefinitionsType.LocalMarketSellerContactDetailsEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketShippingMethodEnabled |
Element | New |
FeatureDefinitionsType.LocalMarketStreetCount |
Element | New |
FeatureDefinitionsType.NonSubscription |
Element | New |
FeatureDefinitionsType.PremiumSubscription |
Element | New |
FeatureDefinitionsType.RegularSubscription |
Element | New |
FeatureDefinitionsType.SpecialitySubscription |
Element | New |
FeatureDefinitionsType.eBayMotorsProAdFormatEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProAutoAcceptEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProAutoDeclineEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProBestOfferEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProCompanyNameEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProContactByAddressEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProContactByEmailEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProContactByPhoneEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProCounterOfferEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProPaymentMethodCheckOutEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProPhoneCount |
Element | New |
FeatureDefinitionsType.eBayMotorsProSellerContactDetailsEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProShippingMethodEnabled |
Element | New |
FeatureDefinitionsType.eBayMotorsProStreetCount |
Element | New |
SiteDefaultsType.ClassifiedAdCompanyNameEnabled |
Element | New |
SiteDefaultsType.ClassifiedAdContactByAddressEnabled |
Element | New |
SiteDefaultsType.ClassifiedAdPhoneCount |
Element | New |
SiteDefaultsType.ClassifiedAdStreetCount |
Element | New |
SiteDefaultsType.LocalMarketAdFormatEnabled |
Element | New |
SiteDefaultsType.LocalMarketAutoAcceptEnabled |
Element | New |
SiteDefaultsType.LocalMarketAutoDeclineEnabled |
Element | New |
SiteDefaultsType.LocalMarketBestOfferEnabled |
Element | New |
SiteDefaultsType.LocalMarketCompanyNameEnabled |
Element | New |
SiteDefaultsType.LocalMarketContactByAddressEnabled |
Element | New |
SiteDefaultsType.LocalMarketContactByEmailEnabled |
Element | New |
SiteDefaultsType.LocalMarketContactByPhoneEnabled |
Element | New |
SiteDefaultsType.LocalMarketCounterOfferEnabled |
Element | New |
SiteDefaultsType.LocalMarketPaymentMethodCheckOutEnabled |
Element | New |
SiteDefaultsType.LocalMarketPhoneCount |
Element | New |
SiteDefaultsType.LocalMarketSellerContactDetailsEnabled |
Element | New |
SiteDefaultsType.LocalMarketShippingMethodEnabled |
Element | New |
SiteDefaultsType.LocalMarketStreetCount |
Element | New |
SiteDefaultsType.NonSubscription |
Element | New |
SiteDefaultsType.PremiumSubscription |
Element | New |
SiteDefaultsType.RegularSubscription |
Element | New |
SiteDefaultsType.SpecialitySubscription |
Element | New |
SiteDefaultsType.eBayMotorsProAdFormatEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProAutoAcceptEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProAutoDeclineEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProBestOfferEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProCompanyNameEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProContactByAddressEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProContactByEmailEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProContactByPhoneEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProCounterOfferEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProPaymentMethodCheckOutEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProPhoneCount |
Element | New |
SiteDefaultsType.eBayMotorsProSellerContactDetailsEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProShippingMethodEnabled |
Element | New |
SiteDefaultsType.eBayMotorsProStreetCount |
Element | New |
DeviceTypeCodeType.ClientAlerts |
Enum | New |
FeatureIDCodeType.ClassifiedAdCompanyNameEnabled |
Enum | New |
FeatureIDCodeType.ClassifiedAdContactByAddressEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketAdFormatEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketAutoAcceptEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketAutoDeclineEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketBestOfferEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketCompanyNameEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketContactByAddressEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketContactByEmailEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketContactByPhoneEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketCounterOfferEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketPaymentMethodCheckOutEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketSellerContactDetailsEnabled |
Enum | New |
FeatureIDCodeType.LocalMarketShippingMethodEnabled |
Enum | New |
FeatureIDCodeType.NonSubscription |
Enum | New |
FeatureIDCodeType.PremiumSubscription |
Enum | New |
FeatureIDCodeType.RegularSubscription |
Enum | New |
FeatureIDCodeType.SpecialitySubscription |
Enum | New |
FeatureIDCodeType.eBayMotorsProAdFormatEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProAutoAcceptEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProAutoDeclineEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProBestOfferEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProCompanyNameEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProContactByAddressEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProContactByEmailEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProContactByPhoneEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProCounterOfferEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProPaymentMethodCheckOutEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProSellerContactDetailsEnabled |
Enum | New |
FeatureIDCodeType.eBayMotorsProShippingMethodEnabled |
Enum | New |
We have updated the WSDL, because the following types had mis-spellings in the names:
This has been corrected in version 571. If you have already downloaded version 569, please replace it with 571 or download it again.
In late May, 2008, several changes to listing policies were announced on the eBay site. The changes are described on the blog of the eBay Developers Program. Please review the changes at Developer Impact of May 2008 Listing Policy Changes.
Available near the end of June, the Best Offer Only option will no longer be required for Classified Ads on the eBay Motors site. Instead, you will be able to list a Classified Ad with or without a Best Offer option. In addition, you will have more options for contact settings. For instance, you may be able to add two phone numbers or addresses in the contact information, instead of only one.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 569.
You can use the GetClientAlertsAuthToken call to retrieve a token for the Client Alerts API.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
You may notice additional category definition types and elements associated with eBayMotors, ClassifedAd, and Local Market contact information. These elements have been added in preparation for more flexible contact options and Ad Format changes for the Motors site that are coming at the end of June. These new fields will allow you to retrieve more response data with the GetCategoryFeatures call.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 569 and Changed Functionality - 569.
The documentation has been updated to state that GetItemTransactions can return incorrect sales tax if the name of a state is not abbreviated (e.g. if the value is "Illinois" rather than "IL") in TransactionArray.Transaction.Buyer.BuyerInfo.ShippingAddress.StateOrProvince. If the name of a state is not abbreviated, sales tax should be obtained using GetOrderTransactions.
Documentation Changes and Errata - 567
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
DeliveryURLDetailType |
Complex type | New |
PayPalRequiredDefinitionType |
Complex type | New |
ApplicationDeliveryPreferencesType.DeliveryURLDetails |
Element | New |
CategoryFeatureType.PayPalRequired |
Element | New |
FeatureDefinitionsType.PayPalRequired |
Element | New |
GetFeedbackRequestType.CommentType |
Element | New |
GetFeedbackRequestType.ItemID |
Element | New |
GetFeedbackRequestType.TransactionID |
Element | New |
GetFeedbackResponseType.EntriesPerPage |
Element | New |
GetFeedbackResponseType.PageNumber |
Element | New |
GetFeedbackResponseType.PaginationResult |
Element | New |
GetNotificationPreferencesResponseType.DeliveryURLName |
Element | New |
GetOrderTransactionsRequestType.IncludeFinalValueFees |
Element | New |
GetSellerListRequestType.CategoryID |
Element | New |
NotificationDetailsType.DeliveryURLName |
Element | New |
SetNotificationPreferencesRequestType.DeliveryURLName |
Element | New |
SiteDefaultsType.PayPalRequired |
Element | New |
FeatureIDCodeType.PayPalRequired |
Enum | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 567.
When you retrieve a seller's items using GetSellerList, you can specify a category ID to restrict the results to items in a category.
When you retrieve orders using GetOrderTransactions, you can specify IncludeFinalValueFees if you want final value fees in the response. Formerly, a second call using GetItemTransactions was needed for final value fees.
The GetMyeBayBuying and GetMyeBaySelling calls return more transaction data. They return the created date, paid time, and shipped time for the item.
You can specify multiple notification URLs for an application. For more information, see Working with Platform Notifications.
GetFeedback now allows you to request feedback records by Transaction ID or Item ID, in addition to the original User ID option. You can also request just one type of feedback, such as Positive, Negative, or Neutral, using the CommentType element. You can use two CommentType elements in the same request to exclude the third type from the response.
If you're requesting feedback with the User ID and ReturnAll options, you can specify whether you want to return 25, 50, 100, or 200 items per page with the EntriesPerPage element. You can also designate which page of the results you would like to receive by including a PageNumber value in your request.
Your Seller Dashboard provides a brief summary of your status as an eBay seller. This status information can help you monitor your selling performance and keep your account in good standing.
A new API call, GetSellerDashboard, is now available in production. It gives you a quick view of the following information:
Unlike the Seller Dashboard that is shown on the eBay Web site, GetSellerDashboard does not provide information about your Detailed Seller Ratings. Instead, you can use GetFeedback to retrieve average ratings and other feedback information.
Please note that GetSellerDashboard cannot return the correct data in the Sandbox. You can test this call in production to get more useful results.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
As previously announced, starting on June 17, 2008, listings on the Australia site must be paid for with one of the following: PayPal, pay on pick up (i.e., paid for when picking up the item), or Visa/MasterCard (with transactions processed by PayPal). This affects AddItem and related calls.
After June 17, 2008, when you call GeteBayDetails, and specify that you want
the payment methods for the Australia site (site ID 15), the call response will contain the two valid payment methods
for the site: PayPal and CashOnPickup.
You can use GetCategoryFeatures to determine if listings on a site must include PayPal as a payment method.
Be sure to call GeteBayDetails periodically to obtain the latest set of valid payment methods for the sites on which listings will appear.
Starting on June 16, 2008, when you retrieve a seller's items using GetSellerList, the maximum time range allowed in a request is a value under 120 days.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 567 and Changed Functionality - 567.
A note in the Trading Web Services Guide that incorrectly stated that SetNotificationPreferences works only in Production has been removed.
The Trading Web Services Guide has been updated as follows: the table that showed site-specific payment options has been replaced by information about the API calls used for retrieving the site-specific payment options.
A note in the Call Reference that incorrectly stated that FetchToken requests using the call SecretID require a password has been removed. FetchToken requests require either the SecretID or the SessionID; SessionID is recommended.
Documentation Changes and Errata - 565
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
BuyerRequirementsType |
Entity | Removed |
ItemType.BuyerRequirements |
Entity | Removed |
BuyerRequirementDetailsType |
Complex type | New |
CombinedFixedPriceTreatmentEnabledDefinitionType |
Complex type | New |
ListingEnhancementDurationDefinitionType |
Complex type | New |
ListingEnhancementDurationReferenceType |
Complex type | New |
MaximumBuyerPolicyViolationsType |
Complex type | New |
MaximumUnpaidItemStrikesInfoType |
Complex type | New |
ListingEnhancementDurationCodeType |
Enumerated type | New |
PeriodCodeType |
Enumerated type | New |
ProductStateCodeType |
Enumerated type | New |
CatalogProductType.ProductState |
Element | New |
CategoryFeatureType.CombinedFixedPriceTreatmentEnabled |
Element | New |
CategoryFeatureType.GalleryFeaturedDurations |
Element | New |
ExpressProductType.ProductState |
Element | New |
FeatureDefinitionsType.CombinedFixedPriceTreatmentEnabled |
Element | New |
FeatureDefinitionsType.GalleryFeaturedDurations |
Element | New |
GetUserPreferencesRequestType.ShowEmailShipmentTrackingNumberPreference |
Element | New |
GetUserPreferencesResponseType.EmailShipmentTrackingNumberPreference |
Element | New |
ItemType.BuyerRequirementDetails |
Element | New |
PictureDetailsType.GalleryDuration |
Element | New |
ProductInfoType.ProductState |
Element | New |
SetUserPreferencesRequestType.EmailShipmentTrackingNumberPreference |
Element | New |
SiteDefaultsType.CombinedFixedPriceTreatmentEnabled |
Element | New |
SiteDefaultsType.GalleryFeaturedDurations |
Element | New |
FeatureIDCodeType.CombinedFixedPriceTreatment |
Enum | New |
FeatureIDCodeType.GalleryFeaturedDurations |
Enum | New |
ShippingServiceCodeType.CanadaPostExpeditedFlatRateBox |
Enum | New |
ShippingServiceCodeType.CanadaPostExpeditedFlatRateBoxUSA |
Enum | New |
As previously announced, starting on May 21, 2008, listings on the Australia site (site ID 15) must offer PayPal as a payment method.
Starting on June 17, 2008, listings on the Australia site must be paid for with one of the following: PayPal, Pay on pick up (i.e., paid for when picking up the item), or Visa/MasterCard (with transactions processed by PayPal). For information about the reasons for the changes, please see PayPal To Be A Required Payment Option for AU Sellers.
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 565.
Starting in early June 2008, on the Italy site, Store Inventory Format (StoresFixedPrice)
items will be treated as basic fixed price (FixedPriceItem) items.
Please see the following location for more information: http://pages.ebay.it/ebaysirinnova/.
You can use GetCategoryFeatures to determine when this change has occurred and the categories to which it applies. Please also see Listing Types (Formats) and the documentation for ListingTypeCodeType.
Store subscribers and non-store subscribers can list
basic fixed price (FixedPriceItem) items with two new durations: 30 days and "Good Til Cancelled" (GTC),
in addition to the already existing durations of 3, 5, 7, and 10 days.
If a seller lists an item in the Store inventory format (StoresFixedPrice), and
then uses GetItem to retrieve the item data, the item will be returned as a Store inventory format (StoresFixedPrice) item.
Sellers can continue to list in the Store inventory format (StoresFixedPrice),
and if their existing Store inventory format listing is a "Good Til Cancelled" item,
it will be renewed as a Store inventory format item after the duration has expired.
If a seller relists or revises a Store inventory format item, it will be relisted or
revised as a Store inventory format (StoresFixedPrice) item.
Starting in early June 2008, on the Italy site, sellers can specify the duration for Gallery Featured items.
Use of this duration functionality is applicable only to
Gallery Featured items. When using AddItem, RelistItem, ReviseItem, or VerifyAddItem, specify the
duration of the Gallery Featured item in Item.PictureDetails.GalleryDuration. If the seller does not
specify the duration, a value of Lifetime is assumed.
An error is returned if a seller tries to downgrade from Lifetime to a limited duration.
However, a seller can change from a limited duration to Lifetime at any time.
After a limited duration of an item has expired, the item no longer is returned as Gallery Featured
in a GetItem call.
Use GetCategoryFeatures to determine if GalleryDuration is supported for the site and category you want to use. As of June 2, 2008, GalleryDuration will be available for all categories on the Italy site (site ID 101). Beginning in mid-September, 2008, the functionality will be available for sites such as US (site ID 0), DE (site ID 77), and UK (site ID 3).
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
You can now specify whether you will accept buyers with more than two unpaid items or buyer policy violations within a specified time range, when you add, revise, relist, or verify a listing.
In order to make this change, the BuyerRequirements and MaximumUnpaidItemstrikes types have been deprecated and the following new types have been added: BuyerRequirementDetailsType, MaximumBuyerPolicyViolationsType, and MaximumUpaidItemStrikesInfoType.
You can still specify any of the other Buyer Requirements, such as LinkedPayPalAccount or VerifiedUser, by including them within the BuyerRequirementsDetails tags for a call, just as you included them previously within the BuyerRequirements tags.
This information comes back as part of the Item data for GetItem, GetItemRecommendations, GetBidderList, and GetSellerList.
The following code snippets show an example of BuyerRequrementDetails within an AddItem call.
Old (now deprecated):
<BuyerRequirements>
<MaximumUnpaidItemStrikes>true</MaximumUnpaidItemStrikes>
</BuyerRequirements>
New:
<BuyerRequirementDetails>
<MaximumUnpaidItemStrikesInfo>
<Count>2</Count>
<Period>Days_360</Period>
</MaximumUnpaidItemStrikesInfo>
<MaximumBuyerPolicyViolations>
<Count>2</Count>
<Period>Days_30</Period>
</MaximumBuyerPolicyViolations>
</BuyerRequirementDetails>
On the Australia site (site ID 15), by early June 2008, search results will include PayPal Buyer Protection. For information about PayPal Buyer Protection on the Australia site, see the following location: https://www.paypal.com/au/cgi-bin/webscr?cmd=p/gen/ua/policy_buyer_complaint-outside. For information about the API changes, see the Change History for GetSearchResults.
Starting in mid-2008, the eBay Germany, Austria, and Switzerland sites, the eBay US site, and Half.com will start migrating some catalogs to a new data provider. Initially, you may see changes in Media and Consumer Electronics catalogs. As part of this process, some products will undergo changes to their product details and pre-filled Item Specifics, some will be mapped to different products with similar information, and some will be deleted.
GetSearchResults, GetProducts, and GetSearchResultsExpress may return warnings if you pass in a product that has been modified or deleted.
During the migration period (typically 90 days), GetProducts and GetSearchResultsExpress will return a new ProductState field that specifies how a product changed or will change (if applicable).
The sell-side catalog search calls (the GetProductSearchResults family of calls) will continue to return the latest product information available, as they do today.
If you pass in an old product ID in the AddItem family of calls, eBay will attempt to map it to the latest product information available (with the latest pre-filled Item Specifics), and to return a warning that informs you of the change. If the product has been deleted and there is no replacement, the call will return an error.
Optionally, if you want to check the current status of an older product ID without searching for products, pass your item in GetItemRecommendations and check to see if the product includes a new ProductState field.
If you submit a scheduled listing before eBay changes a product in the catalog, your scheduled listing will not be affected. It will use the original product information you specified.
With ReviseItem, if you modify the listing but you don't pass in a new product ID, the listing will continue to use the original product information.
With RelistItem, if you don't pass in a new product ID, eBay will treat the request like any other new listing. That is, eBay will attempt to map the product to the latest product information available, drop pre-filled Item Specifics that are no longer applicable, and return a warning that informs you of the change. If the product has been deleted and there is no replacement, the call will return an error.
Good Till Canceled (GTC) listings are handled using the same logic as RelistItem when they relist.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 565 and Changed Functionality - 565.
The fields WatchCount and QuestionCount are returned if greater than 0. And SKU is returned if set. These facts were not previously mentioned in the documentation.
As noted in the Documentation Changes and Errata section for Version 561, one of the API Docs team's tasks is to improve samples for the Trading API and move them from the WebHelp to the Input/Output Reference. In Version 565 documentation, these were added: AddOrder Samples, GetSellerTransactions Samples, GetItemTransactions Samples.
Documentation Changes and Errata - 563
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
FeedbackSummaryType.SellerAverageRatingDetailArray |
Entity | Removed |
AverageRatingSummaryType |
Complex type | New |
BuyerGuaranteeEnabledDefinitionType |
Complex type | New |
BuyerRoleMetricsType |
Complex type | New |
BuyerSatisfactionDashboardType |
Complex type | New |
GetSellerDashboardRequestType |
Complex type | New |
GetSellerDashboardResponseType |
Complex type | New |
PayPalBuyerProtectionEnabledDefinitionType |
Complex type | New |
PolicyComplianceDashboardType |
Complex type | New |
PowerSellerDashboardType |
Complex type | New |
SearchStandingDashboardType |
Complex type | New |
SellerAccountDashboardType |
Complex type | New |
SellerDashboardAlertType |
Complex type | New |
SellerFeeDiscountDashboardType |
Complex type | New |
SellerRatingSummaryArrayType |
Complex type | New |
SellerRoleMetricsType |
Complex type | New |
BuyerSatisfactionStatusCodeType |
Enumerated type | New |
FeedbackSummaryPeriodCodeType |
Enumerated type | New |
ItemTypeCodeType |
Enumerated type | New |
PolicyComplianceStatusCodeType |
Enumerated type | New |
PreferredLocationCodeType |
Enumerated type | New |
SearchFlagCodeType |
Enumerated type | New |
SearchStandingStatusCodeType |
Enumerated type | New |
SellerAccountStatusCodeType |
Enumerated type | New |
SellerDashboardAlertSeverityCodeType |
Enumerated type | New |
SimpleItemSortCodeType |
Enumerated type | New |
CategoryFeatureType.BuyerGuaranteeEnabled |
Element | New |
CategoryFeatureType.PayPalBuyerProtectionEnabled |
Element | New |
FeatureDefinitionsType.BuyerGuaranteeEnabled |
Element | New |
FeatureDefinitionsType.PayPalBuyerProtectionEnabled |
Element | New |
FeedbackSummaryType.BuyerRoleMetrics |
Element | New |
FeedbackSummaryType.SellerRatingSummaryArray |
Element | New |
FeedbackSummaryType.SellerRoleMetrics |
Element | New |
GetAdFormatLeadsRequestType.EndCreationTime |
Element | New |
GetAdFormatLeadsRequestType.StartCreationTime |
Element | New |
ItemType.BuyerGuaranteePrice |
Element | New |
MyeBayFavoriteSearchType.BidCountMax |
Element | New |
MyeBayFavoriteSearchType.BidCountMin |
Element | New |
MyeBayFavoriteSearchType.CategoryID |
Element | New |
MyeBayFavoriteSearchType.Condition |
Element | New |
MyeBayFavoriteSearchType.Currency |
Element | New |
MyeBayFavoriteSearchType.EndTimeFrom |
Element | New |
MyeBayFavoriteSearchType.EndTimeTo |
Element | New |
MyeBayFavoriteSearchType.ItemSort |
Element | New |
MyeBayFavoriteSearchType.ItemType |
Element | New |
MyeBayFavoriteSearchType.ItemsAvailableTo |
Element | New |
MyeBayFavoriteSearchType.ItemsLocatedIn |
Element | New |
MyeBayFavoriteSearchType.MaxDistance |
Element | New |
MyeBayFavoriteSearchType.PaymentMethod |
Element | New |
MyeBayFavoriteSearchType.PostalCode |
Element | New |
MyeBayFavoriteSearchType.PreferredLocation |
Element | New |
MyeBayFavoriteSearchType.PriceMax |
Element | New |
MyeBayFavoriteSearchType.PriceMin |
Element | New |
MyeBayFavoriteSearchType.Quantity |
Element | New |
MyeBayFavoriteSearchType.QuantityOperator |
Element | New |
MyeBayFavoriteSearchType.QueryKeywords |
Element | New |
MyeBayFavoriteSearchType.SearchFlag |
Element | New |
MyeBayFavoriteSearchType.SellerBusinessType |
Element | New |
MyeBayFavoriteSearchType.SellerID |
Element | New |
MyeBayFavoriteSearchType.SellerIDExclude |
Element | New |
MyeBayFavoriteSearchType.SortOrder |
Element | New |
SellerType.TransactionPercent |
Element | New |
SiteDefaultsType.BuyerGuaranteeEnabled |
Element | New |
SiteDefaultsType.PayPalBuyerProtectionEnabled |
Element | New |
TransactionType.BuyerGuaranteePrice |
Element | New |
BuyerProtectionCodeType.NoCoverage |
Enum | New |
FeatureIDCodeType.BuyerGuaranteeEnabled |
Enum | New |
FeatureIDCodeType.PayPalBuyerProtectionEnabled |
Enum | New |
ShippingServiceCodeType.AU_RegisteredParcelPost |
Enum | New |
ShippingServiceCodeType.AU_RegisteredParcelPostPrepaidSatchel3kg |
Enum | New |
ShippingServiceCodeType.AU_RegisteredParcelPostPrepaidSatchel500g |
Enum | New |
ShippingServiceCodeType.AU_RegisteredSmallParcel |
Enum | New |
ShippingServiceCodeType.FreightOtherShipping |
Enum | New |
ShippingTypeCodeType.FreightFlat |
Enum | New |
See the System Announcements for bug fixes related to this release. For documentation-related issues, see the Documentation System Announcements.
This section describes new features that have been added as of this release. New features can involve new calls, new capabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, see Changed Functionality - 563.
Store owners can create promotional sales to offer free shipping. Previously, promotional sales could only be created for price discount sales. Store owners can use the new PromotionalSaleType in SetPromotionalSale to create a price discount only sale, a free shipping only sale, or a price discount and free shipping sale.
Auction and auction/Buy It Now listings can be added to free shipping only sales. Free shipping sales for auction and auction/Buy It Now listings are supported for US and international sites, with the following exceptions: DE (77), AU (15), CH (193), AT (16), UK (3), and IE (205).
For more information, see Putting Store Items On Sale.
On the Australia site (site ID 15), by early June 2008, enhancements to PayPal Buyer Protection will be available. For information about PayPal Buyer Protection on the Australia site, see the following location: https://www.paypal.com/au/cgi-bin/webscr?cmd=p/gen/ua/policy_buyer_complaint-outside. For information about the API changes, see the change histories for the following affected calls: GetBidderList, GetCategoryFeatures, GetItem, GetItemTransactions, GetOrderTransactions, GetSellerList, and GetSellerTransactions.
Your Seller Dashboard provides a brief summary of your status as an eBay seller. This status information can help you monitor your selling performance and keep your account in good standing.
A new API call, GetSellerDashboard, will be available in production in late May 2008. It will give you a quick view of the following information:
We are providing the schema and documentation for GetSellerDashboard early to help you plan how to modify your applications. Additional details may be provided when this functionality becomes available in production.
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
As announced back in February, beginning in May 2008, the eBay Feedback system will evolve to improve the accuracy and accountability of feedback given to our buyers and sellers. A few API calls have been updated to account for these changes.
The GetUser call now returns a new element called SellerInfo.TransactionPercent. This value is calculated by taking the ratio of the number of times a seller has sold successfully and the number of times a seller has bought an item throughout the past 365 days. This field is used to gather the seller's activity percentage.
The GetFeedback call now returns these three elements:
Each of these elements is added to support the changes to the way members can leave feedback for one another. This introduces a few new types to the API, used to capture the metrics of buyer and seller feedback:
For more information about the new types and elements, see the GetFeedback and GetUser I/O Call Reference.
The LeaveFeedback call will no longer let a seller leave a Neutral or Negative feedback for a buyer. Also, if a member attempts to leave feedback after 60 days from the end of the transaction, an error is returned. The existing error for leaving feedback after 90 days will remain the same. For buyers, they will not be able to leave Neutral or Negative feedback within 7 days from the end of the transaction, for active PowerSellers who have been on eBay for 12 months.
Note that in New Features - 549, buyers and sellers can earn repeat feedback from other members. As for 563 release, the logic behind unique and repeat feedback is changed to include repeat feedback only and all other feedback will be retroactively recalculated for each member. Further details can be found in the Upcoming Changes to Feedback announcement under the Repeat Feedback Credit section.
As of the first week of June, you can use two new fields in GetAdFormatLeads (StartCreationTime and EndCreationTime) to retrieve only those leads for a user that fall within a specified time window.
The eBay US seller who uses a freight service other than FreightQuote.com can either select "other freight" on the eBay Web site or can set ShippingType to FreightFlat (a new value in ShippingTypeCodeType) when listing the item. Listings using a non-FreightQuote.com service will return a ShippingService value of FreightOtherShipping (a new value in ShippingServiceCodeType). The seller who specifies FreightFlat cannot set ShippingServiceCost and cannot set ShippingService.
For a broader discussion of freight, see the "Shipping Types" discussion in Shipping.
Affected calls: AddItem family of calls, GetItem, GetItemTransactions, GetItemShipping.
GetMyeBayBuying now returns each search element within a user's Favorite Searches. The search name, search query, and search elements, such as QueryKeywords, SortOrder, and Condition are returned for each Favorite Search. The search elements that are returned by this call can be used as input for the Shopping API FindItemsAdvanced request. Using the Shopping API to find the search elements can result in faster search times.
You can also paste the Search Query response, that comes back as a URL, into a browser to re-play the Favorite Search using the Trading API.
The following types (that were previously only in the Shopping API) have been added to the Trading API to support this feature: SimpleItemSortCodeType, ItemTypeCodeType, SearchFlagCodeType, and PreferredLocationCodeType.
The MyeBayFavoriteSearchType has been modified to include elements that match the input values for the FindItemsAdvanced call.
By the beginning of May 2008, the response for Search related calls will not return an item with a listed price that is less than the Minimum Listing Amount (MLA) threshold on the eBay site where the item was originally listed.
The following calls are affected by this change:
The MLA varies by site ID (e.g. $0.99 on the US site and 1 euro on the UK site) and is an additional transparent filter that will not affect any existing functionality of the affected calls. The MLA filtering will automatically be applied to the following listing formats for items returned in the response of the calls:
However, MLA filtering will not apply to Chinese Auction and Chinese Auction + BIN Format for listings lasting 6 days or more.
Whenever the response of these calls returns items listed on another (international) eBay site, the price of those items is first converted to the local country currency and is then compared to the local MLA threshold.
The MLA will be applied across all eBay sites, including eBay Express and Motors (does not include Half.com).
(Prior announcements had set this as end of April.) Starting in mid May 2008, for multi-quantity Store Inventory Format listings and for multi-quantity Fixed Price listings, a seller can revise all shipping details of the listing (except for sales tax and for shipping type of Freight) for all unsold items. This applies to both domestic and international shipping. Checkout is not affected for those who bought items prior to the seller's shipping changes--the shipping details that were in effect at the time of purchase are used for that buyer at the time of checkout.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 563 and Changed Functionality - 563.
The eBay Web site has no way of specifying or changing the "ThirdPartyCheckout" field. Further, consequences related to ThirdPartyCheckout are different on the site for relisting and revising an item: site:
As noted in the Documentation Changes and Errata section for Version 561, one of the API Docs team's tasks is to improve samples for the Trading API and move them from the WebHelp to the Input/Output Reference. In Version 563 documentation, these were added: AddItem Samples, RelistItem Samples.
Documentation Changes and Errata - 561
For a current list of known issues, see System Announcements and the Knowledge Base.
These calls were added, modified, deprecated, or affected by documentation changes in this release. The changes are described below as well as in each call's Change History.
No new calls in this release.
Schema changes in pink (for example, SomeType.Somedata) are for future use. Monitor upcoming release notes for descriptions of their purpose and use.
Enumeration note: You need to use this release version or higher to retrieve new code list values that were added in this release. See Code Lists.
| Name | Part of Schema | Type of Change |
|---|---|---|
CharitySellerStatusCodeType.Migrated |
Entity | Removed |
CharitySellerStatusCodeType.MigratedWithGiftAid |
Entity | Removed |
CharityAffiliationDetailType |
Complex type | New |
CharityAffiliationDetailsType |
Complex type | New |
AdFormatLeadType.Answer1 |
Element | New |
AdFormatLeadType.Answer2 |
Element | New |
AdFormatLeadType.ExternalEmail |
Element | New |
AdFormatLeadType.FinancingAnswer |
Element | New |
AdFormatLeadType.PurchaseTimeFrame |
Element | New |
AdFormatLeadType.TradeInMake |
Element | New |
AdFormatLeadType.TradeInModel |
Element | New |
AdFormatLeadType.TradeInYear |
Element | New |
SellerType.CharityAffiliationDetails |
Element | New |
Starting at the end of April 2008, UK and Germany eBay Express will be shutdown. The sites will no longer be accessible to all users and visitors. Those who try to access the sites will be redirected to a holding page to explain the shutdown. All users previously registered on UK or Germany eBay Express will have their registered status revoked and become ineligible for UK or Germany eBay Express.
For revoked seller's items, any active Express only items will be ended and moved to the unsold items folder and the full insertion fee credit will be issued to the seller. Any scheduled Express only items are also moved to the unsold items folder but not credited since the items were never charged. All other listings in any other format owned by revoked UK or Germany Express sellers will remain on the site as they were.
Beginning in May 2008, existing charity sellers will no longer be considered registered charity sellers until they agree to the new Terms