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. For older release notes, see theRelease Notes Archive.
Release Version | Release Date | Description of Release |
---|---|---|
1415 | 2025-May-29 | EPS URL links are now required to be HTTPS for Revise/Relist calls; New Error Message Added in Version 1415; GetCategoryMappings Call Decommissioned; DescriptionReviseMode field use change |
1399 | 2025-February-5 | Launch of Buyer Protection for private seller purchases on ebay.co.uk; Added error message for 1399; GeteBayOfficialTime Call Decommissioned; ValidateTestUserRegistration Call Decommissioned; Challenge Calls Decommissioned |
1395 | 2025-January-14 | New ContactURL field added to ManufacturerType and ResponsiblePersonType, and two new pre-owned item conditions available for apparel categories. |
1391 | 2024-December-19 | New tax ID values added toValueTypeCodeType. Updated restrictions on P&A tuner category listings. |
1379 | 2024-October-14 | DecommissionedGetClientAlertsAuthToken call |
1375 | 2024-August-26 | Decommissioned DeletedFromUnsoldList and DeletedFromSoldList containers and their associated fields from theGetMyeBaySelling call; decommissioned UserData.SummarySchedule and UserData.SMSSubscription fields for theGetNotificationPreferences andSetNotificationPreferences calls; removedUserIDChanged enumerated value fromNotificationEventTypeCodeType. |
1371 | 2024-July-17 | New schema added to support GPSR information Removed economic operator fields from Add/Revise/Relist and VerifyItem family of calls |
1367 | 2024-July-1 | Decommissioned GetSuggestedCategories call; removed related types |
1363 | 2024-May-29 | New requirement when adding EPA approved products |
1359 | 2024-May-08 | New error codes for 1359 |
1357 | 2024-April-08 | New Fee and Credit enumerated values added toGetAccount. |
1355 | 2024-April-02 | Decommissioned GetSellerDashboard call; removed related types |
1349 | 2024-February-26 | Decommissioned TicketListingDetails and QuantityInfo containers and their associated fields for the Add/Revise/Relist/Verify and GetItem family of calls; Decommissioned UpdateReturnPolicy and UpdateSellerInfo fields in the ReviseItem call; decommissioned OriginatingPostalCode field |
1345 | 2024-February-05 | New schema added to support economic operator information. Decommissioned GetOrderTransactions call; cleaned up decommissioned order-related fields in the GetOrders, GetSellerTransactions, GetItemTransactions, and GetMyeBaySelling calls |
Version 1415
Changed Calls - 1415 | Schema Changes - 1415 | Announcements - 1415 | ||
New Features - 1415 | Changed Functionality - 1415 | Document Changes and Errata - 1415 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1415
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 - 1415
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
CategoryMappingType | Type | Removed |
GetCategoryMappingsRequest | Type | Removed |
GetCategoryMappingsResponse | Type | Removed |
Announcements - 1415
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1415
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1415.
None for this release.
Changed Functionality - 1415
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
New Error Message Added in Version 1415
To support EPS URL links now being required to use HTTPS (HyperText Transfer Protocol Secure) for Revise calls, the following error message has been added in this release. It is returned inReviseFixedPriceItem andReviseItem calls when attempting to add images using HTTP resources, specifically for the EBAY-US site only:
Note:ForReviseItem/ReviseFixedPriceItem calls, error code21920412 is no longer returned and has been replaced by21919490.
- (Error Code:21919490): eBay security policy only allows HTTPS resources in listings, not HTTP. Please update or remove any HTTP resources.
GetCategoryMappings Call Decommissioned
TheGetCategoryMappings call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used bygetCategoryMappings have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1413
DescriptionReviseMode field use change
TheDescriptionReviseMode field, used by theReviseItem andReviseFixedPriceItem calls, should no longer be used since it no longer supports the ability to append or prepend text using theAppend orPrepend values, but only supports theReplace value. If this field is used and set toAppend orPrepend, it will default toReplace, and whatever text is supplied in theItem.Description field will completely overwrite the current description for the active listing. If you wish to update the description for an active listing using a revise call, just provide the full description in theItem.Description field and do not use this field at all. This field will be completely removed from the WSDL within a few months.
Documentation Changes and Errata - 1415
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1415 andChanged Functionality - 1415.
None for this release.
Version 1399
Changed Calls - 1399 | Schema Changes - 1399 | Announcements - 1399 | ||
New Features - 1399 | Changed Functionality - 1399 | Document Changes and Errata - 1399 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1399
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 - 1399
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
OrderType | Type | Modified |
PaymentInformationType | Type | Modified |
TaxDetailsType | Type | Modified |
TaxesType | Type | Modified |
GeteBayOfficialTimeRequestType | Type | Removed |
GeteBayOfficialTimeResponseType | Type | Removed |
ValidateTestUserRegistrationRequestType | Type | Removed |
ValidateTestUserRegistrationResponseType | Type | Removed |
ValidateChallengeInputResponseType | Type | Removed |
ValidateChallengeInputResponseType | Type | Removed |
GetChallengeTokenRequestType | Type | Removed |
GetChallengeTokenResponseType | Type | Removed |
Announcements - 1399
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1399
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1399.
None for this release.
Changed Functionality - 1399
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
Launch of Buyer Protection for private seller purchases on ebay.co.uk
Going forward, buyers on UK marketplace will be charged a buyer protection fee. These fees will be reflected in the calls as noted in the applicable fields. For UK-based private sellers (excluding Vehicles, Classified Ads, and Property), aBuyer Protection fee will be added to their listings. This fee will be paid for by the buyer. SeeChanged Calls - 1399 for calls which have fields affected.
Added error message for 1399
In order to support the new functionality of Buyer Protection, the following error message has been added in this release and is returned inCompleteSale:
- (error)21920438: Invalid request: one of the items cannot be marked as paid.
GeteBayOfficialTime Call Decommissioned
TheGeteBayOfficialTime call has been decommissioned decommissioned as of January 27, 2025, and the call reference documentation has been removed. Additionally, all types exclusively used byGeteBayOfficialTime have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1399
ValidateTestUserRegistration Call Decommissioned
TheValidateTestUserRegistration call has been decommissioned as of January 30, 2025, and the call reference documentation has been removed. Additionally, all types exclusively used byValidateTestUserRegistration have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1399
Challenge Calls Decommissioned
The following challenge calls have been decommissioned as of January 30, 2025, and the call reference documentation has been removed:- GetChallengeToken
- ValidateChallengeInput
Additionally, all types exclusively used by either call have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1399
Documentation Changes and Errata - 1399
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1399 andChanged Functionality - 1399.
None for this release.
Version 1395
Changed Calls - 1395 | Schema Changes - 1395 | Announcements - 1395 | ||
New Features - 1395 | Changed Functionality - 1395 | Document Changes and Errata - 1395 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1395
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
- GetItem
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyRelistItem
Schema Changes - 1395
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
Regulatory.ManufacturerType | Type | Modified |
Regulatory.ManufacturerType.ContactURL | Field | Added |
Regulatory.ResponsiblePersonType | Type | Modified |
Regulatory.ResponsiblePersonType.ContactURL | Field | Added |
Announcements - 1395
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1395
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1395.
New ContactURL field added to ManufacturerType and ResponsiblePersonType
A new field,ContactURL, has been added toManufacturerType andResponsiblePersonType. This field allows users to input a manufacturer's and/or a Responsible Person's contact URL as an electronic contact method when inputting GPSR information for a listing.
The following error message has rolled out with the 1395 release. The long version of the message is used below:
- (error)21920435: The contact URL is incorrectly formatted. Please update the formatting.
Changed Functionality - 1395
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
Two new pre-owned item conditions available for apparel categories in Australia
As of January 22, the following twoPre-owned item conditions are now supported for 222 apparel categories in Australia:
- ConditionID 2990 for Pre-owned - Excellent
- ConditionID 3010 for Pre-owned - Fair
For the affected categories, the condition name for ConditionID 3000 has been changed from Pre-owned to Pre-owned - Good. The item condition names for all active listings with ConditionID 3000 will automatically be updated from Pre-owned to Pre-owned - Good. However, we strongly encourage you to revise your existing listings with Pre-owned Excellent (2990) or Pre-owned Fair (3010) if either of those conditions more accurately describe the condition of your item.
See theQ4 2024 Newsletter for more information on the affected categories, or you can also usegetItemConditionPolicies orGetCategoryFeatures to see which apparel categories support the new item conditions.
These same changes are expected to roll out to all eBay marketplaces in early February, and we will update release notes when that happens.
Updated error messages for 1395
In order to support the newContactURL field, the following error messages have been updated with the 1395 release. The long version of each message is used below:
- (error)21920432: Seller must provide at least one form of contact info for Manufacturer - address, email, contact URL or phone.
- (error)21920433: Seller must provide at least one form of contact info for Responsible Person - address, email, contact URL or phone.
Documentation Changes and Errata - 1395
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1395 andChanged Functionality - 1395.
None for this release.
Version 1391
Changed Calls - 1391 | Schema Changes - 1391 | Announcements - 1391 | ||
New Features - 1391 | Changed Functionality - 1391 | Document Changes and Errata - 1391 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1391
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 - 1391
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
ValueTypeCodeType | Type | Modified |
ValueTypeCodeType.CURP | Enum | Added |
ValueTypeCodeType.RFC | Enum | Added |
ValueTypeCodeType.RUT | Enum | Added |
Announcements - 1391
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1391
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1391.
None for this release.
Changed Functionality - 1391
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
New enumerated values added to ValueTypeCodeType
Three new enumerated values were added toValueTypeCodeType to support Mexican and Chilean Tax IDs. SeeSchema Changes - 1391 for specifics.
Updated restrictions for P&A tuners category listings
When creating a listing in the Auto Performance Tuning Devices & Software category, sellers must use an eBay catalog product. Previously, if a seller added any additional product details, like additional item specifics, the listing would be blocked and an error would occur. With this release, if a seller provides any additional product information, that information will now just be dropped, and a warning will be returned.
To support this, the following error message has been added in the 1391 release. The long version of the message is used:
- (warning)21920437: When listing inreplaceable_value, all product details come from eBay catalog. Any product information provided by the seller will be dropped.
Documentation Changes and Errata - 1391
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1391 andChanged Functionality - 1391.
None for this release.
Version 1379
Changed Calls - 1379 | Schema Changes - 1379 | Announcements - 1379 | ||
New Features - 1379 | Changed Functionality - 1379 | Document Changes and Errata - 1379 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1379
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 - 1379
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
GetClientAlertsAuthTokenRequestType | Type | Removed |
GetClientAlertsAuthTokenResponseType | Type | Removed |
Announcements - 1379
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1379
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1379.
None for this release.
Changed Functionality - 1379
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
GetClientAlertsAuthToken Call Decommissioned
TheGetClientAlertsAuthToken call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used byGetClientAlertsAuthToken have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1379
Documentation Changes and Errata - 1379
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1379 andChanged Functionality - 1379.
None for this release.
Version 1375
Changed Calls - 1375 | Schema Changes - 1375 | Announcements - 1375 | ||
New Features - 1375 | Changed Functionality - 1375 | Document Changes and Errata - 1375 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1375
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 - 1375
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
SMSSubscriptionType | Type | Removed |
SummaryEventScheduleType | Type | Removed |
DeletedFromUnsoldList | Field | Removed |
DeletedFromSoldList | Field | Removed |
NotificationEventTypeCodeType | Type | Modified |
Announcements - 1375
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1375
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1375.
None for this release.
Changed Functionality - 1375
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
DeletedFromUnsoldList and DeletedFromSoldList containers decommissioned
TheDeletedFromUnsoldList andDeletedFromSoldList containers and their associated fields in theGetMyeBaySelling call have been decommissioned and removed from the WSDL.SummarySchedule and SMSSubscription containers decommissioned
TheUserData.SummarySchedule andUserData.SMSSubscription containers and their associated fields in theGetNotificationPreferences andSetNotificationPreferences calls have been decommissioned and removed from the WSDL.Removed non-working UserIDChanged enumerated value from NotificationEventTypeCodeType
The notification platform does not supportUserIDChanged, so it has been removed as an enumerated value from theNotificationEventTypeCodeType and theGetNotificationPreferences,GetNotificationsUsage, andSetNotificationPreferences calls.Documentation Changes and Errata - 1375
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1375 andChanged Functionality - 1375.
None for this release.
Version 1371
Changed Calls - 1371 | Schema Changes - 1371 | Announcements - 1371 | ||
New Features - 1371 | Changed Functionality - 1371 | Document Changes and Errata - 1371 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1371
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
- GetItem
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyRelistItem
Schema Changes - 1371
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
RegulatoryType | Type | Modified |
DocumentsType | Type | Added |
DocumentType | Type | Added |
ManufacturerType | Type | Added |
ProductSafetyType | Type | Added |
ResponsiblePersonsType | Type | Added |
ResponsiblePersonType | Type | Added |
ResponsiblePersonCodeTypes | Type | Added |
ResponsiblePersonCodeType | Type | Added |
Announcements - 1371
Economic Operator is being decommissioned and should no longer be used for the Add/Revise/Relist and VerifyItem family of calls. As it is currently still supported, Economic Operator-related fields will be returned if applicable for the GetItem call.
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1371
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1371.
New schema added to support GPSR information
In preparation for new legal requirements by the European Union taking effect on December 13th 2024, schema changes have been made to support GPSR related fields. TheDocuments,Manufacturer,ProductSafety, andResponsiblePersons containers provide GPSR information for products shipped or sold in the EU and Northern Ireland.
The following new error messages related to using GPSR information were added in the 1371 release. The long version of each message is used below.
- (error)21920418: Regulatory document ID(s)replaceable_value not found. Please use valid ID(s).
- (error)21920419: Duplicate regulatory document ID(s)replaceable_value sent in the request. Duplicate ID(s) have been ignored.
- (error)21920420: Regulatory document structure incorrect. Max allowed number of entries isreplaceable_value.
- (error)21920421: Invalid document state for ID(s)replaceable_value. Documents must be in the SUBMITTED or ACCEPTED state.
- (error)21920422: Product Safety structure incorrect forreplaceable_value. Max allowed number of entries isreplaceable_value.
- (error)21920423: Product Safety information incomplete. Your listing must include product safety pictograms & statements.
- (error)21920424: Manufacturer address information is incomplete. When providing the address, please provide the street, city, postal code and country
- (error)21920425: Manufacturer information is incomplete. Please provide the company name.
- (error)21920426: Responsible Person structure incorrect forreplaceable_value. Max allowed number of entries isreplaceable_value.
- (error)21920427: Responsible Person address information is incomplete. When providing the address, please provide the street, city, postal code and country
- (error)21920428: Responsible Person information is incomplete. Please provide the company name.
- (error)21920429: Either the Manufacturer or at least one of the Responsible Persons must be located in the EU.
- (error)21920430: Please provide a minimum ofreplaceable_value and a maximum ofreplaceable_value types for a Responsible Person.
- (error)21920431: Seller must provide at least one form of contact info for Economic Operator - either phone, email or address.
- (error)21920432: Seller must provide at least one form of contact info for Manufacturer - either phone, email or address.
- (error)21920433: Seller must provide at least one form of contact info for Responsible Person - either phone, email or address.
These error messages can be viewed in theErrors by Number page.
Changed Functionality - 1371
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
None for this release.
Documentation Changes and Errata - 1371
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1371 andChanged Functionality - 1371.
None for this release.
Version 1367
Changed Calls - 1367 | Schema Changes - 1367 | Announcements - 1367 | ||
New Features - 1367 | Changed Functionality - 1367 | Document Changes and Errata - 1367 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1367
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 - 1367
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
SuggestedCategoryArrayType | Type | Removed |
SuggestedCategoryType | Type | Removed |
Announcements - 1367
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1367
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1367.
None for this release.
Changed Functionality - 1367
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
GetSuggestedCategories Call Decommissioned
TheGetSuggestedCategories call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used byGetSuggestedCategories have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1367
Documentation Changes and Errata - 1367
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1367 andChanged Functionality - 1367.
None for this release.
Version 1363
Changed Calls - 1363 | Schema Changes - 1363 | Announcements - 1363 | ||
New Features - 1363 | Changed Functionality - 1363 | Document Changes and Errata - 1363 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1363
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 - 1363
None for this release.
Announcements - 1363
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1363
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1363.
New requirement when adding EPA approved products
A new requirement adding support for EPA approved tuning devices and software products was added to category Id 173651 (Auto Performance Tuning Devices & Software). SeeNew error messages for 1363 for updated errors.Note:When listing incategoryID 173651 (Tuning devices & software), use of catalog products is required. For more information, seeTuning devices and software.
Changed Functionality - 1363
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
New error messages for 1363
Below is a list of new or changed error and warning messages that rolled out with the 1363 release and are related to specific parts and accessory categories. The long version of each message is used below:
- (error)21920416: When listing inreplaceable_value, key information such asreplaceable_value comes from eBay's catalog and should be left blank.
- (error)21920417: When listing inreplaceable_value, sellers are required to adopt eBay's catalog data which will provide all the necessary details for the product.
These error messages can be viewed in theErrors by Number page.
Documentation Changes and Errata - 1363
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1363 andChanged Functionality - 1363.
None for this release.
Version 1359
Changed Calls - 1359 | Schema Changes - 1359 | Announcements - 1359 | ||
New Features - 1359 | Changed Functionality - 1359 | Document Changes and Errata - 1359 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1359
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 - 1359
None for this release.
Announcements - 1359
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1359
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1359.
None for this release.
Changed Functionality - 1359
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
New error messages for 1359
Below is a list of new or changed error and warning messages that rolled out with the 1359 release. The long version of each message is used below:
- (warning)21919456: (changed severity and message text) Seller has opted into business policies. Please use policy IDs rather than legacy fields for Shipping, Payments or Returns or new policies may be automatically created seller's behalf.
- (error)21920409: A minimum ofreplaceable_value photos is required to list in categoryreplaceable_value.
- (warning)21920410: The selected shipping servicereplaceable_value is not supported with the selected shipping package type. The shipping service has been dropped from the listing.
- (warning)21920411: The fieldreplaceable_value is deprecated and will be decommissioned as ofreplaceable_value and will no longer be recognized or accepted.
- (warning)21920412: eBay Picture Service (EPS) URL links are now required to be HTTPS links. HTTP links are converted to HTTPS links right now. Starting August 2024, HTTP EPS links will not be supported.
- (error)21920413: The category chosen is not valid for this auto related item. Please choose another category.
- (error)21920414: Seller is not eligible for Managed Shipping. Please opt out of Managed Shipping.
- (error)21920415: The package dimensions required for calculated shipping are missing. Provide valid numbers for the dimensions.
These error messages can be viewed in theErrors by Number page.
Documentation Changes and Errata - 1359
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1359 andChanged Functionality - 1359.
None for this release.
Version 1357
Changed Calls - 1357 | Schema Changes - 1357 | Announcements - 1357 | ||
New Features - 1357 | Changed Functionality - 1357 | Document Changes and Errata - 1357 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1357
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 - 1357
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
AccountDetailEntryCodeType | Type | Modified |
AccountDetailEntryCodeType.RegulatoryOperatingFee | Enum | Added |
AccountDetailEntryCodeType.RegulatoryOperatingFeeCredit | Enum | Added |
AccountDetailEntryCodeType.DHLPaymentProcessingFee | Enum | Added |
AccountDetailEntryCodeType.DHLPaymentProcessingFeeCredit | Enum | Added |
Announcements - 1357
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1357
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1357.
None for this release.
Changed Functionality - 1357
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
New Fee and Credit enumerated values added to GetAccount
Four enumerated values were added. SeeSchema Changes - 1357 for specifics.
Documentation Changes and Errata - 1357
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1357 andChanged Functionality - 1357.
None for this release.
Version 1355
Changed Calls - 1355 | Schema Changes - 1355 | Announcements - 1355 | ||
New Features - 1355 | Changed Functionality - 1355 | Document Changes and Errata - 1355 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1355
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 - 1355
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
BuyerSatisfactionDashboardType | Type | Removed |
BuyerSatisfactionStatusCodeType | Type | Removed |
PerformanceDashboardType | Type | Removed |
PerformanceStatusCodeType | Type | Removed |
PolicyComplianceDashboardType | Type | Removed |
PolicyComplianceStatusCodeType | Type | Removed |
PowerSellerDashboardType | Type | Removed |
SearchStandingDashboardType | Type | Removed |
SearchStandingStatusCodeType | Type | Removed |
SellerAccountDashboardType | Type | Removed |
SellerAccountStatusCodeType | Type | Removed |
SellerDashboardAlertSeverityCodeType | Type | Removed |
SellerDashboardAlertType | Type | Removed |
SellerFeeDiscountDashboardType | Type | Removed |
Announcements - 1355
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1355
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1355.
None for this release.
Changed Functionality - 1355
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
GetSellerDashboard Call Decommissioned
TheGetSellerDashboard call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used byGetSellerDashboard have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1355. The alternative for this API isSeller Standards Profile methods of theSell Analytics API.
Documentation Changes and Errata - 1355
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1355 andChanged Functionality - 1355.
None for this release.
Version 1349
Changed Calls - 1349 | Schema Changes - 1349 | Announcements - 1349 | ||
New Features - 1349 | Changed Functionality - 1349 | Document Changes and Errata - 1349 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1349
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
- GetItem
- GetItemShipping
- GetItemTransactions
- GetOrders
- GetSellerList
- GetSellerTransactions
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
Schema Changes - 1349
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
TicketListingDetailsType | Type | Removed |
QuantityInfoType | Type | Removed |
UpdateReturnPolicy | Field | Removed |
UpdateSellerInfo | Field | Removed |
OriginatingPostalCode | Field | Removed |
Announcements - 1349
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1349
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1349.
None for this release.
Changed Functionality - 1349
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
TicketListingDetails and QuantityInfo containers decommissioned in Add/Revise/Relist/Verify calls
TheTicketListingDetails andQuantityInfo containers and their associated fields in Add/Revise/Relist/Verify and related calls have been decommissioned and removed from the WSDL.
UpdateReturnPolicy and UpdateSellerInfo decommissioned in ReviseItem call
TheUpdateReturnPolicy andUpdateSellerInfofields fields in the ReviseItem call have been decommissioned and removed from the WSDL.
OriginatingPostalCode field decommissioned
TheOriginatingPostalCode field, used by the Add/Revise/Relist/Verify and GetItem family, has been decommissioned and removed from the WSDL.
Documentation Changes and Errata - 1349
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1349 andChanged Functionality - 1349.
None for this release.
Version 1345
Changed Calls - 1345 | Schema Changes - 1345 | Announcements - 1345 | ||
New Features - 1345 | Changed Functionality - 1345 | Document Changes and Errata - 1345 |
For a current list of known issues, see theAPI Status page, or visit theSupport page for account support, technical support, and other support resources.
Index of Changed Calls - 1345
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
- GetItem
- GetMyeBaySelling
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
- GetOrders *
- GetSellerTransactions *
- GetItemTransactions *
- GetOrderTransactions (decommissioned)
* SeeSchema Changes - 1345 for numerous fields removed from response payloads.
Schema Changes - 1345
Enumeration note: You need to use this release version or higher to retrieve new code list valuesthat were added in this release. SeeCode Lists.
Name | Part of Schema | Type of Change |
---|---|---|
EconomicOperator | Type | Added |
RegulatoryType | Type | Modified |
AddressUsageCodeType | Type | Removed |
ExternalTransactionType | Type | Removed |
GetOrderTransactionsRequestType | Type | Removed |
GetOrderTransactionsResponseType | Type | Removed |
ItemTransactionIDArrayType | Type | Removed |
ItemTransactionIDType | Type | Removed |
PaymentHoldDetailType | Type | Removed |
PaymentHoldReasonCodeType | Type | Removed |
PaymentTransactionStatusCodeType | Type | Removed |
RequiredSellerActionArrayType | Type | Removed |
RequiredSellerActionCodeType | Type | Removed |
SellingManagerProductDetailsType | Type | Removed |
UnpaidItemCaseOpenTypeCodeType | Type | Removed |
UnpaidItemCaseStatusTypeCodeType | Type | Removed |
UnpaidItemType | Type | Removed |
Announcements - 1345
Change Requests
See theAPI Status page for announcements regarding recently resolved or current system wide issues. Visit theSupport page for account support, technical support, and other support resources.
New Features - 1345
This section describes new features that have been added as of this release. New features can involve new calls, newcapabilities, and/or new fields added to existing calls.
For logical or functional changes to existing features and calls, including code list changes, seeChanged Functionality - 1345.
New schema added to support Economic Operator information
To support new legal requirements by the European Union and the UK to provide Economic Operator information, schema changes have been made. TheEconomicOperator container (EconomicOperatorType) provides required Economic Operator information about the manufacturer and/or supplier of the item. TheEconomicOperator field has also been added toRegulatorytype.
The following new error messages related to using Economic Operator information were added in the 1345 release. The long version of each message is used below.
- (Error)21920388: Economic Operator address information is incomplete. When providing the address, please provide the company name, street, city, postal code and country.
- (Error)21920399: Economic Operator information is incomplete. Please provide the company name.
- (Error)21920403: The email address provided is formatted incorrectly.
These error messages can be viewed in theErrors By Number page.
Changed Functionality - 1345
This section describes logical or functional changes that have been made to existing functionality, including newcode list values and/or changes in validation rules.
GetOrderTransactions Call Decommissioned
TheGetOrderTransactions call has been decommissioned, and the call reference documentation has been removed. Additionally, all types exclusively used byGetOrderTransactions have been removed from the Trading WSDL. You can see the full list of removed types in theSchema Changes - 1345
Numerous Order-related Fields Decommissioned
Removed numerous order-related fields in theGetOrders,GetSellerTransactions,GetItemTransactions, andGetMyeBaySelling calls. See theDeprecated Trading Order Management Fields document for a complete list of these fields and reasons.
Documentation Changes and Errata - 1345
This section lists additional documentation changes and corrections that were made with this release and that arenot already mentioned inNew Features - 1345 andChanged Functionality - 1345.
None for this release.