Trading API Release Notes
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.
|
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
These release notes go back four quarters. For older release notes, see the Release Notes archive.
Version 1285
Documentation Changes and Errata - 1285
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1285
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.
New Calls
No new calls in this release.
Changed Calls
- AddFixedPriceItem
- AddItem
- AddItems
- GetBidderList
- GetItem
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
Schema Changes - 1285
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.
No schema changes in this release.
Announcements - 1285
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1285
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 - 1285.
None for this release.
Changed Functionality - 1285
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.
Updated Picture Limit
This release of the Trading API updates the picture limit. With the exception of motor vehicle listings on the US and Canada marketplaces, sellers can now include up to 24 pictures in a listing free of charge in all categories on all marketplaces. The number of included pictures in motor vehicle listings depend on the selected vehicle package (see Fees for selling vehicles on eBay Motors).
Documentation Changes and Errata - 1285
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1285 and Changed Functionality - 1285.
None for this release.
Version 1281
Documentation Changes and Errata - 1281
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1281
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.
New Calls
No new calls in this release.
Changed Calls
Schema Changes - 1281
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 |
|---|---|---|
AccountDetailEntryCodeType.FedExReturnLabelFee |
Enum | New |
AccountDetailEntryCodeType.FedExReturnLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.AUPostReturnLabelFee |
Enum | New |
AccountDetailEntryCodeType.AUPostReturnLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.UpsCaLabelFee |
Enum | New |
AccountDetailEntryCodeType.UpsCaLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.FedExCaLabelFee |
Enum | New |
AccountDetailEntryCodeType.FedExCaLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.HubbedReturnLabelFee |
Enum | New |
AccountDetailEntryCodeType.HubbedReturnLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.RoyalMailReturnLabelFee |
Enum | New |
AccountDetailEntryCodeType.RoyalMailReturnLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.ParcelForcePostReturnLabelFee |
Enum | New |
AccountDetailEntryCodeType.ParcelForcePostReturnLabelFeeCredit |
Enum | New |
AccountDetailEntryCodeType.OffsiteAdsFee |
Enum | New |
AccountDetailEntryCodeType.OffsiteAdsFeeCredit |
Enum | New |
CancelReasonCodeType.AddressIssues |
Enum | New |
CancelReasonCodeType.BuyerCancelOrAddressIssue |
Enum | Deprecated |
Item.IsItemEMSEligible |
Field | New |
Announcements - 1281
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
EU and UK Payments regulations update: Digital Signatures
Due to EU and UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers, including GetAccount. Refer to Digital Signatures for APIs for information about creating signatures to be included in the HTTP payload.
New Features - 1281
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 - 1281.
New item eligibility flag for shipping managed by eBay
The new boolean field IsItemEMSEligible was added to the GetItem call (in ItemType). If true, the item is eligible for shipping managed by eBay; false, the item is not eligible for shipping managed by eBay.
Changed Functionality - 1281
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.
Updates to GetAccount Call
Sixteen new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for new account fees/credits. The enumeration values include:
FedExReturnLabelFeeFedExReturnLabelFeeCreditAUPostReturnLabelFeeAUPostReturnLabelFeeCreditUpsCaLabelFeeUpsCaLabelFeeCreditFedExCaLabelFeeFedExCaLabelFeeCreditHubbedReturnLabelFeeHubbedReturnLabelFeeCreditRoyalMailReturnLabelFeeRoyalMailReturnLabelFeeCreditParcelForcePostReturnLabelFeeParcelForcePostReturnLabelFeeCreditOffsiteAdsFeeOffsiteAdsFeeCredit
See these new values in AccountDetailEntryCodeType for more information.
Updates to CancelReasonCodeType type
A new enumerated value AddressIssues was added and the enumerated value BuyerCancelOrAddressIssue was Deprecated.
See the new value in CancelReasonCodeType for more information.
Shipping service override changes to business policies
When revising or relisting an item that is using business policies and has one or more shipping service cost overrides set up, the Item.SellerProfiles.SellerShippingProfile container and the Item.ShippingServiceCostOverrideList.ShippingServiceCostOverride container(s) must be included even if no changes are being made.
Australia sellers offering freight shipping changes
Sellers offering freight shipping on the Australia (AU) marketplace must now use the AU_Freight enumeration value for ShippingServiceCodeType. For these sellers, the Freight value will no longer be accepted and may lead to a blocking error.
Documentation Changes and Errata - 1281
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1281 and Changed Functionality - 1281.
None for this release.
Version 1279
Documentation Changes and Errata - 1279
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1279
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.
New Calls
No new calls in this release.
Changed Calls
Schema Changes - 1279
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 |
|---|---|---|
ShippingDetails.eBayEstimatedLabelCost |
Field | New |
Announcements - 1279
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1279
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 - 1279.
Added support for eBay shipping
The return of the eBayEstimatedLabelCost field with a value of 0.0 indicates that a free shipping label by eBay is downloadable by the seller via the eBay website. See more details about Authenticity Guarantee and how eBay shipping applies to eligible sneaker listings.
Changed Functionality - 1279
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.
New Error Codes for 1279
Below is the list of the new error messages that rolled out with the 1279 release. All of these messages are related to using eBay Shipping. The long version of each message is used below.
- (Warning)
21920343:replaceable_value. // Mapped to authenticity guarantee notification message - (Warning)
21920344:replaceable_value. // Mapped to eBay shipping notification message - (Warning)
21920345:This listing is not eligible for eBay shipping. Option ignored. - (Error)
21920346:This listing qualifies for eBay shipping. Local pickup only is not a valid shipping option. - (Error)
21920347:This listing qualifies for eBay shipping. Handling time must not exceed 3 days. - (Warning)
21920348:replaceable_value has been dropped as no domestic shipping service was provided.
These error and warning messages can be viewed in the Errors By Number page.
Documentation Changes and Errata - 1279
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1279 and Changed Functionality - 1279.
None for this release.
Version 1275
Documentation Changes and Errata - 1275
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1275
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.
New Calls
No new calls in this release.
Changed Calls
No changed calls in this release.
Schema Changes - 1275
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.
No schema changes in this release.
Announcements - 1275
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1275
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 - 1275.
A new intermediated international shipping program has been added
A new intermediated international shipping program called eBay International Shipping is available. On the US marketplace, the Global Shipping Program is scheduled to be replaced by this new intermediated shipping program (eBay International Shipping). US Sellers opted in to the Global Shipping Program will automatically get opted into eBay International Shipping once it becomes available to them. All US sellers will be migrated by March 31, 2023. As long as the US seller's account is opted in to eBay International Shipping, this shipping option will be automatically enabled for all listings where international shipping is available.
Support for eBay International Shipping has been added to GetOrders, GetSellerTransactions, GetItemTransactions, and GetOrderTransactions calls. The eBay International Shipping partner's address is shown in the MultiLegShippingDetails.SellerShipmentToLogisticsProvider.ShipToAddress container. Additionally, similar to the ReferenceID field provided for the Global Shipping Program, the eBay Virtual Tracking number (eVTN) that is used for the domestic leg of the shipment is appended to the Street2 field (not in the ReferenceID field).
Changed Functionality - 1275
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.
None for this release.
Documentation Changes and Errata - 1275
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1275 and Changed Functionality - 1275.
None for this release.
Version 1267
Documentation Changes and Errata - 1267
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1267
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.
New Calls
No new calls in this release.
Changed Calls
No changed calls in this release.
Schema Changes - 1267
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.
No schema changes in this release.
Announcements - 1267
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
Four Store Calls Scheduled for Decommission on September 30
The new Stores platform no longer supports custom store pages and other customization functionality, so the following four store calls are deprecated and scheduled for decommission on September 30, 2022:
Although these four calls still work and will continue to work up until the decommission date, it is recommended that they are no longer used since none of the customization features in these calls can be applied to stores in the Production environment
Additionally, the following containers and fields related to store customization in the GetStore call are also deprecated and scheduled for decommission on September 30, 2022:
- CustomHeader (string)
- CustomHeaderLayout (enum)
- CustomListingHeader (whole container)
- ExportListings (boolean)
- HeaderStyle (enum)
- HomePage (long)
- ItemListLayout (enum)
- ItemListSortOrder (enum)
- Logo.LogoID (int)
- Logo.Name (string)
- Theme (whole container)
- TitleWithCompatibility (boolean)
New Features - 1267
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 - 1267.
None for this release.
Changed Functionality - 1267
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.
None for this release.
Documentation Changes and Errata - 1267
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1267 and Changed Functionality - 1267.
None for this release.
Version 1257
Documentation Changes and Errata - 1257
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1257
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.
New Calls
No new calls in this release.
Changed Calls
No changed calls in this release.
Schema Changes - 1257
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 |
|---|---|---|
HitCounterCodeType |
Type | Removed |
Item.HitCounter |
Field | Removed |
Announcements - 1257
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1257
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 - 1257.
None for this release.
Changed Functionality - 1257
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.
HitCounter field removed from WSDL
The HitCounter field has been removed from the WSDL. It can no longer be used in Add/Revise calls, nor will it be returned in GetItem, GetBidderList, GetSellerEvents, or GetSellerList.
HitCount field updates
The HitCount field will no longer be returned in GetItem or GetBidderList, but it will continue to be returned in GetSellerEvents and GetSellerList, but with a logic change. Instead of the HitCount value representing the lifetime hit count for listings, the value will be the total number of page hits within the latest 30-day period.
Quantity and StartPrice no longer returned in ReviseInventoryStatus
The Quantity and StartPrice fields will no longer be returned in the ReviseInventoryStatus response. However, these fields will function the same as before in ReviseInventoryStatus request. If users would like to verify if their price and/or quanity changes were successfully pushed out to the listing (or variation within a listing), they can use the GetItem call to verify the changes.
Documentation Changes and Errata - 1257
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1257 and Changed Functionality - 1257.
None for this release.
Version 1255
Documentation Changes and Errata - 1255
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
.Index of Changed Calls - 1255
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.
New Calls
No new calls in this release.
Changed Calls
No changed calls in this release.
Schema Changes - 1255
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 |
|---|---|---|
GetCategorySpecificsRequest |
Type | Removed |
GetCategorySpecificsResponse |
Type | Removed |
AspectUsageCodeType |
Type | Removed |
CategoryItemSpecificsType |
Type | Removed |
NameRecommendationType |
Type | Removed |
NameValueRelationshipType |
Type | Removed |
ProductRequiredCodeType |
Type | Removed |
RecommendationsType |
Type | Removed |
RecommendationValidationRulesType |
Type | Removed |
RelevanceIndicatorType |
Type | Removed |
SelectionModeCodeType |
Type | Removed |
UsageConstraintCodeType |
Type | Removed |
ValueFormatCodeType |
Type | Removed |
ValueRecommendationType |
Type | Removed |
VariationPictureRuleCodeType |
Type | Removed |
VariationSpecificsRuleCodeType |
Type | Removed |
Announcements - 1255
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
GetCategorySpecifics Call Decommisioned
The GetCategorySpecifics call has been decommisioned, and the call reference documentation has been removed. Additionally, all types exclusively used by GetCategorySpecifics have been removed from the Trading WSDL. You can see the full list of removed types in the Schema Changes section.
The alternative solution to GetCategorySpecifics is the getItemAspectsForCategory method of the Taxonomy API. For more information about migrating to the Taxonomy API and using the Taxonomy SDK, see the Taxonomy API migration guide.
New Features - 1255
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 - 1255.
None for this release.
Changed Functionality - 1255
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.
None for this release.
Documentation Changes and Errata - 1255
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1255 and Changed Functionality - 1255.
None for this release.
Version 1249
Documentation Changes and Errata - 1249
For a current list of known issues, see the API Status page, or visit the Support page for account support, technical support, and other support resources.
Index of Changed Calls - 1249
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.
New Calls
No new calls in this release.
Changed Calls
Schema Changes - 1249
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.
No schema changes in this release.
Announcements - 1249
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1249
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 - 1249.
None for this release.
Changed Functionality - 1249
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.
Extended producer responsibility related information returned
Sellers can now return their listing's extended producer responsibility related information using the GetItem call.
Documentation Changes and Errata - 1249
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1249 and Changed Functionality - 1249.
None for this release.
Version 1247
Documentation Changes and Errata - 1247
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1247
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.
New Calls
No new calls in this release.
Changed Calls
- AddFixedPriceItem
- AddItem
- AddItems
- GetBidderList
- GetItem
- GetSellerEvents
- GetSellerList
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
Schema Changes - 1247
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.
No schema changes in this release.
Announcements - 1247
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
Winter 2022 Seller Updates Available
The Winter 2022 Seller Updates have been released. Below is a high-level summary of the updates:
- More robust sales data available under Performance tab in Seller Hub
- Updates and expansion for all Promoted Listings products (Standard, Express, and Advanced)
- More sellers will get the option of requiring all buyers to provide payment details before making a Best Offer on a listing, reducing the risk of Unpaid Items for Best Offer transactions
- More sellers will get the option of requiring all buyers to provide payment details before making a Best Offer on a listing, reducing the risk of Unpaid Items for Best Offer transactions
- Upcoming updates to order fees and credits
- Sellers will now be refunded the $0.30 per-order fee for orders that are cancelled at the buyer's request
- The additional final value fee charged to Below Standard sellers will increase from 5% to 6% (of sales price)
- Final value fees will have a slight increase for most categories (0.3% for Store sellers and 0.35% for non-Store sellers). See the Selling Fees Updates table for the full list of fee increases.
- Listing Subtitle fee increases by $0.50 for both fixed-price and auction listings
- Starting in May 2022, sellers will get partial final value fee credits for partial refunds
- Starting in June 2022, the Promoted Listings Standard fee will be calculated based on the total order cost (including applicable taxes and shipping), and not just the sales price
New Features - 1247
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 - 1247.
None for this release.
Changed Functionality - 1247
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.
None for this release.
HitCounter and HitCount Fields Deprecated
Hit counters are no longer displayed in View Item pages, so the HitCounter and HitCount fields are no longer applicable and are scheduled for decommission. For developers/sellers who are interested in seeing page views and listing performance, the getTrafficReport method of the Sell Analytics API can be used.
Currently, if the HitCounter field is used in the request payload of an add/revise/relist/verify call, the field will be ignored and a warning message will be returned.
Until both fields are decommissioned, the HitCounter and HitCount fields will still be returned in GetItem, GetBidderList, GetSellerEvents, and GetSellerList. For HitCounter, the default value for the marketplace will be returned, such as NoHitCounter or HiddenStyle.
Documentation Changes and Errata - 1247
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1247 and Changed Functionality - 1247.
None for this release.