Trading API

Merchant Data API Release Notes Archive

You can find links to the Merchant Data API documentation in the top navigation bar.

This archive document contains information about releases that go back longer than four quarters ago. For more recent releases, see the current Release Notes.

Are you new to this solution?

If so, see the LMS Feed API Guide.

Are you just getting started with the eBay Developer's Program?

The following links provide useful information for beginners:

Q2 2021
Version Release Date
1211 No Schema or Doc Updates
1209 2021-Jun-04
1207 2021-May-21
1205 No Schema or Doc Updates
1203 2021-Apr-23
1201 2021-Apr-09
Q1 2021
Version Release Date
1199 No Schema or Doc Updates
1197 2021-Mar-12
1195 2021-Feb-26
1193 2021-Feb-12
1191 Not Released
1189 2021-Jan-15
1187 Not Released
Q4 2020
Version Release Date
1185 No Schema or Doc Updates
1183 No Schema or Doc Updates
1181 No Schema or Doc Updates
1179 2020-Nov-06
1177 2020-Oct-23
1175 No Schema or Doc Updates
Q3 2020
Version Release Date
1173 2020-Sep-25
1171 No Schema or Doc Updates
1169 2020-Aug-28
1167 No Schema or Doc Updates
1165 2020-Jul-31
1163 No Schema or Doc Updates
1161 2020-Jul-06

These releases go back longer than four quarters ago. For more recent releases, see the current Release Notes.

Version 1209

Index of Changed Calls - 1209

Schema Changes - 1209

Announcements - 1209

New Features - 1209

Changed Functionality - 1209

Documentation Changes and Errata - 1209

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1209

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 - 1209

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
eBayTaxReferenceValue Type New
TaxesType.eBayReference Field New
ValueTypeCodeType.VATIN Enum New

Announcements - 1209

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1209

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 - 1209.

New Schema Added to Support the Return of VAT Identifier Numbers in OrderReport

When VAT is applicable to an order, a buyer's VAT Identifier Number (VATIN) will be returned at the order level, and eBay's VAT tax ID will be returned at the line item level for all order management calls. This VAT information will be returned in the following locations:

Note: The eBay VAT ID and buyer VATIN fields will not start getting returned until June 30, 2021.

Going forward after June 30, developers will need to use a Trading WSDL with a version number of 1211 (or newer) for the VAT ID/VATIN values to be returned in the new fields. Otherwise, the VAT information will be returned in the Order.ShippingAddress.Street2 field. Developers will also have the option of using an older version than 1211, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1211 or higher.

On January 31, 2022, the Order.ShippingAddress.Street2 will stop being used to return VAT information regardless of WSDL version or compatibility level.

Changed Functionality - 1209

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.

Listing Recommendations in Responses of Add/Revise/Relist/Verify Calls No Longer Supported

Sellers no longer have the option of choosing to have applicable Listing Recommendations returned in the responses of Add/Revise/Relist/Verify calls. The IncludeRecommendations boolean field has been removed from ItemType, and all ListingRecommendations containers have been removed from the response types of the Add/Revise/Relist/Verify calls.

Documentation Changes and Errata - 1209

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1209 and Changed Functionality - 1209.

None for this release.

Version 1207

Index of Changed Calls - 1207

Schema Changes - 1207

Announcements - 1207

New Features - 1207

Changed Functionality - 1207

Documentation Changes and Errata - 1207

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1207

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 - 1207

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
OrderArray.Errors Field New

Announcements - 1207

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1207

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 - 1207.

None for this release.

Changed Functionality - 1207

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.

Behavior Changes for the VATPercent Value

The float value input for the VATDetails.VATPercent field in an Add/Revise/Relist call can only have one digit beyond the decimal point (e.g. 12.3). Previously, three digits after the decimal point were allowed.

The maximum VAT percentage allowed has also been reduced from 30 percent to 27 percent. To account for this change, the existing 21916387 Error Code has been revised to say: The VAT rate needs to be between 0% and 27% with at most one decimal digit. (instead of 0% and 30%).

Documentation Changes and Errata - 1207

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1207 and Changed Functionality - 1207.

Errors Container Added to OrderArrayType for OrderReport

Although an Errors container has always been returned for OrderReport if errors and/or warnings are triggered at the order level (as opposed to call level), this container was previously missing from the merchantdataservice.xsd file and OrderReport reference docs. It was added in the 1207 version.

Version 1203

Index of Changed Calls - 1203

Schema Changes - 1203

Announcements - 1203

New Features - 1203

Changed Functionality - 1203

Documentation Changes and Errata - 1203

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1203

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 - 1203

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
VideoDetailsType Type New
Item.VideoDetails Field New

Announcements - 1203

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1203

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 - 1203.

Videos Now Supported in Listings

eBay has added the capability to add videos to listings. At this time, only one video can be added per listing, and the video must be uploaded to eBay via the Media API.

The VideoDetails container has been added to all Add/Revise/Relist/Verify calls, and passing in the ID for the video will add the video to the listing. eBay will perform a validation check on each specified VideoID value to verify that the video belongs to, and was uploaded by the seller.

At present, videos can be attached to listings on the eBay US marketplace and can be viewed through the native apps (iOS and Android) only. Additional sites and platforms will be supported in the near future.

Changed Functionality - 1203

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 - 1203

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1203 and Changed Functionality - 1203.

None for this release.

Version 1201

Index of Changed Calls - 1201

Schema Changes - 1201

Announcements - 1201

New Features - 1201

Changed Functionality - 1201

Documentation Changes and Errata - 1201

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1201

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 - 1201

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.

None for this release.

Announcements - 1201

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1201

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 - 1201.

None for this release.

Changed Functionality - 1201

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 Code Added for 1201

The following new error messages that rolled out with the 1201 release:

Documentation Changes and Errata - 1201

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1201 and Changed Functionality - 1201.

VariationTitle Field was Missing MaxLength Constraint Value

Althougth the max length constraint value has always existed for the VariationTitle field, it was not documented until now. The maximum character length for this field is 120 characters. This field is returned in the OrderReport response for multiple-variation listings.

Version 1197

Index of Changed Calls - 1197

Schema Changes - 1197

Announcements - 1197

New Features - 1197

Changed Functionality - 1197

Documentation Changes and Errata - 1197

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1197

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 - 1197

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.

None for this release.

Announcements - 1197

None for this release.

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1197

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 - 1197.

None for this release.

Changed Functionality - 1197

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 Added for 1197

Below is the list of the new error messages that rolled out with the 1197 release:

These error and warning messages can be viewed in the Errors By Number page.

Documentation Changes and Errata - 1197

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1197 and Changed Functionality - 1197.

None for this release.

Version 1193

Index of Changed Calls - 1193

Schema Changes - 1193

Announcements - 1193

New Features - 1193

Changed Functionality - 1193

Documentation Changes and Errata - 1193

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1193

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 - 1193

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
FulfillmentType Type New
Program.Fulfillment Field New
ShippingServiceCostOverride.ShippingSurcharge Field Removed

Announcements - 1193

SoldReport Decommissioned

The SoldReport call has been decommissioned. eBay recommends that large sellers and developers migrate to the Sell Feed API order_task methods, or OrderReport of LMS.

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1193

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 - 1193.

New eBay Fulfillment Tags Returned in OrderReport

A new Fulfillment container will be returned in OrderReport for paid orders being fulfilled by eBay or an eBay fulfillment partner.

Changed Functionality - 1193

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.

Certified Refurbshed Program has Rolled Out Globally

In all eBay marketplaces, Condition ID 2000 now maps to an item condition of 'Certified Refurbished', and not 'Manufacturer Refurbished'. To list an item as 'Certified Refurbished', a seller must be pre-qualified by eBay for this feature. Condition ID 2500, 'Seller Refurbished' is the other option for sellers.

Any seller that is interested in eligibility requirements to list with 'Certified Refurbished' should see the Certified refurbished program page in Seller Center.

Multiple Shipping Rate Tables Enabled in UK and DE

The capability for sellers to create and maintain multiple domestic and international shipping rate tables has rolled out to the UK and Germany marketplaces. Prior to this, these sellers only had one 'default' domestic shipping rate table and one 'default' international shipping rate table.

In Add/Revise/Relist calls, a seller specifies the domestic and/or international shipping rate table to use for the listing through the ShippingDetails.RateTableDetails container.

Multiple shipping rate tables are now supported in the following marketplaces: US, Australia, Canada (English and French), Italy, UK, and Germany.

ShippingServiceCostOverride.ShippingSurcharge Field Removed from WSDL

The ShippingServiceCostOverride.ShippingSurcharge has been removed from WSDL. This field was already not usable and was marked as deprecated. Sellers can only apply shipping surcharges to shipping service options through the Shipping rate tables tool in My eBay.

Documentation Changes and Errata - 1193

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1193 and Changed Functionality - 1193.

None for this release.

Version 1189

Index of Changed Calls - 1189

Schema Changes - 1189

Announcements - 1189

New Features - 1189

Changed Functionality - 1189

Documentation Changes and Errata - 1189

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1189

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 - 1189

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 - 1189

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

None for this release.

New Features - 1189

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 - 1189.

None for this release.

Changed Functionality - 1189

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.

Error Message Updates

The following warning message was added:

The existing 21916605 error message was updated to: Only single item quantity is permitted when the listing is in auction-style or under selected categories in FixedPrice format. Before the update, this error message text was not covering the fixed-price use case.

Documentation Changes and Errata - 1189

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1189 and Changed Functionality - 1189.

ShippingSurcharge Field Marked as Deprecated

The ShippingSurcharge field in ShippingServiceCostOverrideType marked as deprecated. Sellers can no longer directly apply shipping surcharges to listings through Add/Revise calls or through shipping business policies. Shipping surcharges can only be applied to shipping service options through the Shipping rate tables tool in My eBay.

Item.eBayPlus Field not Supported for Australian Sellers

Added a note to Item.eBayPlus field description about the field not being supported for Australian sellers. In Australia, eBay will evaluate/determine whether a listing is eligible for eBay Plus, and the seller has no control over setting the feature for a listing.

Version 1179

Index of Changed Calls - 1179

Schema Changes - 1179

Announcements - 1179

New Features - 1179

Changed Functionality - 1179

Documentation Changes and Errata - 1179

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1179

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 - 1179

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 - 1179

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1179

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 - 1179.

None for this release.

Changed Functionality - 1179

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 - 1179

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1179 and Changed Functionality - 1179.

Documentation Maintenance and Minor Updates

Some minor documentation updates were made to various type files.

Version 1177

Index of Changed Calls - 1177

Schema Changes - 1177

Announcements - 1177

New Features - 1177

Changed Functionality - 1177

Documentation Changes and Errata - 1177

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1177

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 - 1177

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 - 1177

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1177

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 - 1177.

New enumeration values added for authenticity inspection

New enumeration values were added to AuthenticityVerificationType. Values now account for order line items that fail authentication and are not able to be returned to the seller because of legal constraints, and for order line items that are passed with exception.

Changed Functionality - 1177

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 Error Messages

Below is the list of updated error messages that rolled out with the 1177 release:

These error and warning messages can be viewed in the Errors By Number page.

Documentation Changes and Errata - 1177

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1177 and Changed Functionality - 1177.

None for this release.

Version 1173

Index of Changed Calls - 1173

Schema Changes - 1173

Announcements - 1173

New Features - 1173

Changed Functionality - 1173

Documentation Changes and Errata - 1173

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1173

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 - 1173

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 - 1173

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

2020 Fall Seller Update Page Published

The 2020 Fall Seller Update page was published. Below are some of the highlights:

New Features - 1173

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 - 1173.

None for this release.

Changed Functionality - 1173

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.

Listing Site's Currency Used for Listing Fees Returned in Add/Revise/Relist Calls

The currency of the listing fees returned under the Fees container in add/revise/relist calls will reflect the listing site's currency, and not necessarily the seller's default/home currency. Previously, the currency used for these listing fees was the seller's default/home currency even if that seller was listing on a site outside of their home country. This change affects the following calls:

New Error Messages

Below is the list of the new error messages that rolled out with the 1173 release:

These error and warning messages can be viewed in the Errors By Number page.

Documentation Changes and Errata - 1173

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1173 and Changed Functionality - 1173.

None for this release.

Version 1169

Index of Changed Calls - 1169

Schema Changes - 1169

Announcements - 1169

New Features - 1169

Changed Functionality - 1169

Documentation Changes and Errata - 1169

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1169

No calls were added, modified, deprecated, or affected by documentation changes in this release.

Schema Changes - 1169

There are no schema changes in this release.

Announcements - 1169

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

Some InventoryStatusType Response Fields Scheduled for Deprecation

The Quantity and StartPrice response fields in the InventoryStatusType are being deprecated, and they will no longer be supported after April 30, 2022. eBay has found that the values returned for these fields are not reliably accurate and recommends that the responses for these fields be ignored.

The Quantity and StartPrice request fields can still be used, and sellers can leverage the GetItem call to verify that the requested quantity and/or price updates were successful.

This deprecation affects the ReviseInventoryStatus call.

New Features - 1169

There are no new features in this release.

Changed Functionality - 1169

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 and Updated Error Messages

Error messages (21920285, 21920286, 21920287, 21920288, 21920290, and 21920291) were added to this release of the Trading API. Error message (80) was also updated. Below is the list of the new and updated error messages that rolled out with the 1169 release:

These error and warning messages can be viewed in the Errors By Number page.

Documentation Changes and Errata - 1169

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1169 and Changed Functionality - 1169.

None for this release.

Version 1165

Index of Changed Calls - 1165

Schema Changes - 1165

Announcements - 1165

New Features - 1165

Changed Functionality - 1165

Documentation Changes and Errata - 1165

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1165

New Calls

No new calls in this release.

Changed Calls

Schema Changes - 1165

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
AuthenticityVerificationType Type New
TransactionProgramType Type New
Transaction.Program Field New

Announcements - 1165

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

SoldReport Deprecated

The SoldReport call is being deprecated. No new features and/or fields will be added to SoldReport, and it will no longer be supported at all after January 30, 2021. eBay recommends that large sellers and developers migrate to the Sell Feed API order_task methods, or OrderReport of LMS.

New Features - 1165

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 - 1165.

New Container Returned in Order Management Calls for Authenticity Guarantee Service Orders

A new Program container is returned for orders subject to the Authenticity Guarantee service program. With the Authenticity Guarantee service program, some high-value items in specific categories, like luxury watches or handbags, must be authenticated by a third-party authenticator before being sent to the buyer.

This program is initially only available to a select number of sellers, but this program will eventually become applicable and required for all sellers selling specific items in specific categories.

Changed Functionality - 1165

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 - 1165

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1165 and Changed Functionality - 1165.

None for this release.

Version 1161

Index of Changed Calls - 1161

Schema Changes - 1161

Announcements - 1161

New Features - 1161

Changed Functionality - 1161

Documentation Changes and Errata - 1161

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1161

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 - 1161

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 - 1161

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

New Features - 1161

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 - 1161.

None for this release.

Changed Functionality - 1161

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.

Changes to Final Value Fees for Managed Payments Sellers

The calculation of the Final Value Fee is changing for managed payments sellers, so the values returned in the FinalValueFee field for each order line item in OrderReport should only be considered as estimated values. The getTransactions method of the Finances API can be used to get accurate Final Value Fee values.

See the Selling fees for managed payments sellers help page for more information about how Final Value Fees are changing for managed payments sellers.

Documentation Changes and Errata - 1161

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1161 and Changed Functionality - 1161.

ListingDesigner Field in ItemType Removed from WSDL

The retiring of Listing Designer templates was already announced with Version 1157, but now the ListingDesigner field in ItemType has been removed from the 1161 Version of the WSDL. Existing listings that are already using a Listing Designer template will remain unchanged. If a seller tries to use a Listing Designer template using the ListingDesigner container, it will have no effect on the listing, but the seller will receive a warning message about Listing Designer templates no longer being available.

Version 1157

Index of Changed Calls - 1157

Schema Changes - 1157

Announcements - 1157

New Features - 1157

Changed Functionality - 1157

Documentation Changes and Errata - 1157

For a current list of known issues, see Site Status Updates and the Knowledge Base.

Index of Changed Calls - 1157

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 - 1157

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 - 1157

Change Requests

See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

Old Order ID Format Values No Longer Supported in Responses

Beginning in June 2020, only the new order ID format will be returned in response payloads for paid orders, regardless of the WSDL version number or compatibility level. When the new order ID format was first introduced in June 2019, eBay gave sellers the option of using the old or the new format. To use the old Order ID format, sellers could use a WSDL older than Version 1113, or they could set the Compatibility-Level header to a value predating Version 1113. That capability is no longer available, and only new order ID values are returned for paid orders.

Note that only OrderReport returns new Order ID values. SoldReport was never enabled to return new Order ID values.

New Required Item Specifics Rolled Out to Some Categories

As part of the Spring 2020 Seller Update, it was announced that new required item specifics were rolled out, or were scheduled to roll out to several categories, including Watches, Electronics, Home & Garden, Business & Industrial, Sporting Goods, Toys, and Fashion. For a complete list of specific changes to these categories, see the Item Specifics page on Seller Center.

Sellers can also use the GetCategorySpecifics call or the getItemAspectsForCategory or fetchItemAspects methods of the Taxonomy API to retrieve the latest item specifics metadata for one, multiple, or all (leaf) categories. A new Taxonomy SDK is also available to compare and discover the item specifics metadata that was recently added or changed in any of eBay's leaf categories.

Listing Designer Templates Retired

As of May 31, 2020, sellers are no longer able to use Listing Designer templates when they create or revise listings. Existing listings that are already using a Listing Designer template will remain unchanged.

If a user attempts to use the ListingDesigner container in an Add/Revise/Relist API call, it will have no effect on the listing, but the seller will receive a warning message about Listing Designer templates no longer being available.

The GetDescriptionTemplates call will still retrieve Listing Designer template data, but none of retrieved templates will be usable to create or revise a listing.

New Features - 1157

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 - 1157.

Changed Functionality - 1157

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 - 1157

This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1157 and Changed Functionality - 1157.

Clarification on PrivateListing Field

The PrivateListing field was mistakenly removed from the Trading WSDL and docs back in Version 1045, but was added back in Version 1095. Although this field was removed from WSDL, the logic for this field was never wired off and the field was still honored if provided. The PrivateListing field allows sellers to make bidders on auction listings anonymous to other fellow bidders, and only the seller can see bidders' user IDs.

Clarified the Behavior of Domestic and International Return Policies

Updated return policy-related documentation to make it more clear that if a seller does not add a separate international return policy for an item, the settings in the domestic return policy will be used instead. For more information on setting separate domestic and international return policies, see the International returns policyhelp topic.