Trading API

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.

If you are getting started with the API, the following locations have information about joining the eBay Developers Program, creating test users, and other steps to getting your application certified to go live against the eBay production servers:

Q2 2020
Version Release Date
1159 2020-Jun-19
1157 2020-Jun-05
1155 No Schema or Doc Updates
1153 No Schema or Doc Updates
1151 No Schema or Doc Updates
1149 2020-Apr-10
Q1 2020
Version Release Date
1147 No Schema or Doc Updates
1145 2020-Mar-13
1143 No Schema or Doc Updates
1141 No Schema or Doc Updates
1139 2020-Jan-31
1137 No Schema or Doc Updates
1135 Skipped
Q4 2019
Version Release Date
1133 Not Released
1131 2019-Oct-25
1129 2019-Oct-11
Q3 2019
Version Release Date
1127 Not Released
1125 2019-Sep-13
1123 Not Released
1121 Not Released
1119 2019-Aug-02
1117 Not Released
1115 Not Released

These release notes go back four quarters. For older release notes, see the Release Notes archive.

The lowest supported version is 941.
To learn how versioning works in the Trading API, see eBay's Schema Versioning Strategy.

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.

Name Part of Schema Type of Change
DiscountDetailType Type New
DiscountType Type New
FeenettingStatusCodeType Type New
NettedTransactionSummaryType Type New
GetAccountRequest.IncludeNettedEntries Field New
GetAccountResponse.FeeNettingStatus Field New
AccountEntryType.DiscountDetail Field New
AccountEntryType.Netted Field New
AccountSummaryType.NettedTransactionSummary Field New
AccountDetailEntryCodeType.FinalValueFee Enum New
AccountDetailEntryCodeType.FinalValueFeeCredit Enum New
AccountDetailEntryCodeType.FinalValueFeeBelowStandard Enum New
AccountDetailEntryCodeType.FinalValueFeeBelowStandardCredit Enum New
AccountDetailEntryCodeType.FinalValueFeeFixedFeePerOrder Enum New
AccountDetailEntryCodeType.FinalValueFeeFixedFeePerOrderCredit Enum New
AccountDetailEntryCodeType.InternationalFee Enum New
AccountDetailEntryCodeType.InternationalFeeCredit Enum New

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. This change affects the following calls:

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.

ReviseCheckoutStatus Call to be Decommissioned in July 2021

The ReviseCheckoutStatus call is staged for deprecation and this endpoint will be decommissioned on July 1, 2021. We recommend that you use the CompleteSale call instead of ReviseCheckoutStatus to update the status and/or details of your order. If your use case is to provide shipment tracking information for one or more line items of a paid order, you can use the createShippingFulfillment method of the Fulfillment API to do this task.

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.

GetAccount Enhanced for Managed Payments Changes

Numerous updates were made to the GetAccount call in preparation for the new features and changes rolling out this summer for eBay managed payments. For sellers enabled for managed payments, some fees will start getting deducted from seller payouts instead of eBay adding those fees to the seller's monthly invoice. These fees include final value fees, a fixed payment processing fee, and an international fee if an order is being shipped internationally.

Because some fees will be charged to a seller right away through a deduction from a seller payout, and other fees will still be billed to the seller's monthly invoice, new capabilities were added to the GetAccount call so a seller can distinguish between which fees have already been paid, and which fees are still due and payable through a monthly invoice.

A quick summary of the changes are below:

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.

Version 1149

Index of Changed Calls - 1149

Schema Changes - 1149

Announcements - 1149

New Features - 1149

Changed Functionality - 1149

Documentation Changes and Errata - 1149

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

Index of Changed Calls - 1149

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

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

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.

Spring 2020 Seller Update is Now Available

Visit the Spring 2020 Seller Update page for an overview of new and upcoming features and changes that affect sellers.

New Features - 1149

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

None for this release.

Changed Functionality - 1149

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

Below is a list of the new and updated error messages that rolled out with the 1149 release:

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

Documentation Changes and Errata - 1149

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

Doc Maintenance and Minor Updates

Some minor doc updates were made to various type files.

Version 1145

Index of Changed Calls - 1145

Schema Changes - 1145

Announcements - 1145

New Features - 1145

Changed Functionality - 1145

Documentation Changes and Errata - 1145

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

Index of Changed Calls - 1145

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

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

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.

Only New Order ID Format will be Returned for Paid Orders Beginning in April

Beginning in April 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. From June 2019 up until now, users could control whether the new or old order ID format was returned in response payloads. This change affects the following calls:

Note that unique identifiers of orders change as they transition from 'commit to buy'/unpaid to paid orders. So, users will still be able to pass in the IDs for unpaid orders to get the status of those orders, but once orders are paid for, sellers should only use/reference the new order ID format (for paid orders), as these are the identifiers that will also be known to the buyers.

CharityNumber Field Scheduled to be Deprecated

Currently, in Add/Revise/Relist calls, sellers have an option to identify a nonprofit organization with the eBay unique identifier through the Charity.CharityID field, or they can identify the same nonprofit organization using the PayPal Giving Fund unique identifier through the Charity.CharityNumber field. The CharityNumber field has been scheduled for deprecation, so sellers using the CharityNumber field should make plans to migrate to the CharityID field instead.

The eBay unique identifier for nonprofit organizations is shown in the id attribute of each Charity container returned in the response of the GetCharities call.

ReviseCheckoutStatus Call has been Scheduled for Deprecation

The ReviseCheckoutStatus call has been staged for deprecation, and this endpoint will no longer be available toward the latter half of 2021. More specific details on exact timing will be announced at a later date. We recommend that you use the CompleteSale call instead of ReviseCheckoutStatus to update the status and/or details of your order. If your use case is to provide shipment tracking information for one or more line items of a paid order, you can use the createShippingFulfillment method of the Fulfillment API to do this task.

New Features - 1145

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

None for this release.

Changed Functionality - 1145

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 Behavior for PaymentStatus Field in Order Management Calls

Previously, the Succeeded enumeration value would automatically get returned in the Payment.PaymentStatus field for order payment transactions that were occurring off of eBay's platform. As of March 2020, the Pending value will get returned instead for order payment transactions occurring off of eBay's platform, and the seller can use the CompleteSale call to mark the order as paid. Once the seller does this, the payment status will change from Pending to Succeeded.

This change affects the GetOrders, GetOrderTransactions, GetItemTransactions, and GetSellerTransactions calls.

Documentation Changes and Errata - 1145

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

Made Some Updates to Charity-related Documentation

There were several areas in the Call Reference documentation where it wasn't clear if a field was designed for the eBay unique identifier of a nonprofit organization or the PayPal Giving Fund unique identifier of a nonprofit organization. Below is a list of the fields in Trading that identify nonprofit organizations, and whether the values of those fields are for eBay or PayPal Giving Fund charity IDs:

Version 1139

Index of Changed Calls - 1139

Schema Changes - 1139

Announcements - 1139

New Features - 1139

Changed Functionality - 1139

Documentation Changes and Errata - 1139

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

Index of Changed Calls - 1139

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

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

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

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

None for this release.

Changed Functionality - 1139

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.

PostalCode to Start Being Masked in GetItem

Postal code values returned in the Item.PostalCode field of GetItem will be masked to all users except for the seller of the item. Different countries will mask postal/zip codes in slightly different ways, but an example would be 951**.

Updates to Feedback Entry Fields Returned in GetFeedback Call

The behavior of the fields returned in the FeedbackDetail container of the GetFeedback response has changed in the following ways:

Documentation Changes and Errata - 1139

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

Added a Note in Promotional Sale Calls Recommending Marketing API

Added a note to the SetPromotionalSale, SetPromotionalSaleListings, and GetPromotionalSaleDetails calls recommending that sellers/developers make plans to migrate to the Marketing API, which provides all Promotions Manager and Promoted Listings capabilities. The Trading API does not support Promoted Listings, and there are no plans for the Trading API to support Promoted Listing or additional Promotions Manager functionality going forward.

Added a Note About ePIDs Not Being Supported at Variation Level

Added a note to the VariationProductListingDetails.ProductReferenceID field about it not being supported for any categories. Currently, sellers cannot associate an eBay catalog product with single variations within a multiple-variation listing. If the seller attempts to supply an eBay Product Identifier (ePID) at the variation level, a warning will get returned and the ePID value will just be dropped.

Added Note and Link About View Item Description Summary Feature

Included a note and a link in the Item.Description field about the View Item Description Summary Feature. This feature allows sellers to customize the description of an item as it appears on a mobile device.

Added Site-Specific Max Length Values for Address Fields

Added site-specific max length values for several address-related fields (in AddressType), including Street1, Street2, CityName, StateOrProvince, and PostalCode. For all five of these fields, the max lengths according eBay marketplace are shown:

Added Note About DispatchCutoffTimePreference Not Being Applicable for Some Sellers

For sellers opted in to the feature that supports different same-day handling order cut off times for each business day, the CutoffTime field set in SetUserPreferences and returned in GetUserPreferences is not applicable/usable. This particular field and the DispatchCutoffTimePreference container is designed to only support one order cutoff time.If a seller wishes to view or modify their order cutoff times for same-day handling, that seller must go to Shipping Preferences in My eBay.

Version 1131

Index of Changed Calls - 1131

Schema Changes - 1131

Announcements - 1131

New Features - 1131

Changed Functionality - 1131

Documentation Changes and Errata - 1131

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

Index of Changed Calls - 1131

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

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
GetAccountRequest.OrderID Field New
AccountHistorySelectionCodeType.OrderId Enum New

Announcements - 1131

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.

Category and Item Specific Changes

Category and item specific changes were rolled out as part of the 2019 Fall Seller Release.

To get more information on the category changes, and to see the full list of affected categories, go here. For sellers using the add and revise listing calls of the Trading API to add/revise items, old category IDs will automatically be remapped to new category IDs as long as the CategoryMappingAllowed boolean field is not set to false (it's set to true by default).

Item specific changes went into effect on October 15, 2019. To get more information on the item specifics changes, go here. For sellers using legacy APIs (like Trading API), we suggest that you call GetCategorySpecifics for your category to get the required and recommended item specifics for your category. To see if an item specific is required, recommended, or optional, look at the NameRecommendation.ValidationRules.UsageConstraint field for each item specific returned in the response. Sellers will be blocked from listing/revising an item if required item specifics are not included. As long as they are relevant/applicable to the item, sellers should also make sure to include recommended and optional item specifics as well, and this may make it easier for buyers to find your listings. A REST alternative to the Trading API's GetCategorySpecifics is the Taxonomy API's getItemAspectsForCategory call.

Both category metadata calls mentioned above will return the latest item specific metadata, but newly added item specific names can also be found in table format (organized by category) on this page. All of the item specific names on this page are required, so sellers can search for their listing categories on this page to make sure their listings in these categories have these item specfics.

New Features - 1131

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

GetAccount Updated to Retrieve Account Entries Related to a Specific Order

The GetAccount call was updated to retrieve account entries related to a specific order. To search for account entries related to a specific order, the user includes the AccountHistorySelection field in the request and sets it value to (newly-added) OrderId, and includes the newly-added OrderID field and sets its value to the unique identifier of the order. If one or more account entries are found for the specified order, the corresponding AccountEntry.OrderId will be shown for those account entries.

Changed Functionality - 1131

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 to Cover BIN Prices Exceeding Threshold

A new error code (21920255) was added to cover 'Buy it Now' prices that exceed the maximum thresdhold for a category. If a seller specifies the 'Buy it Now' price at a value above this threshold, this error code is returned and the seller is blocked from listing/revising an item.

Documentation Changes and Errata - 1131

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

None for this release.

Version 1129

Index of Changed Calls - 1129

Schema Changes - 1129

Announcements - 1129

New Features - 1129

Changed Functionality - 1129

Documentation Changes and Errata - 1129

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

Index of Changed Calls - 1129

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

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
CollectionMethodCodeType Type New (reserved for future use)
TaxDetailsType.CollectionMethod Field New (reserved for future use)
AccountEntryType.OrderId Field New
AccountDetailsEntryType.PaymentIntermediationFeeCredit Enum New
AccountDetailsEntryType.EbaySendLabelFee Enum New
AccountDetailsEntryType.EbaySendLabelFeeCredit Enum New
AccountDetailsEntryType.USInternetSalesTax Enum New
AccountDetailsEntryType.USInternetSalesTaxCredit Enum New
AccountDetailsEntryType.NewZealandGST Enum New
AccountDetailsEntryType.NewZealandGSTCredit Enum New
AccountDetailsEntryType.AustraliaGST Enum New
AccountDetailsEntryType.AustraliaGSTCredit Enum New
AccountDetailsEntryType.CoFundingCharge Enum New
AccountDetailsEntryType.CoFundingChargeCredit Enum New

Announcements - 1129

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.

Changes to eBay Collect and Remit Taxes

Beginning in early November, for orders subject to eBay 'Collect and Remit' taxes, PayPal will begin distributing order funds to the seller's account with the sales tax included. However, shortly after the order funds clear in the seller's account, the 'Collect and Remit' tax amount will be pulled by PayPal from the seller's account and then disributed to the appropriate taxing authority. Currently, PayPal is stripping this 'Collect and Remit' tax from the buyer's payment and directly submitting this amount to the appropriate taxing authority, and this tax amount never shows up in the sellers account.

eBay 'Collect and Remit' taxes include US state-mandated sales tax and 'Goods and Services' tax that is applicable to Australian and New Zealand sellers. To accomodate for these changes, the order management calls and the GetAccount call was updated. See the Changed Functionality section for more information about how these API calls are handling this logic change.

This change does not affect sellers that are already opted in to eBay managed payments. For these sellers, the sales tax amount will never be included in a seller payout.

New Features - 1129

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

None for this release.

Changed Functionality - 1129

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.

Update to Order Management Calls for eBay Collect and Remit Taxes

Beginning in early November, for orders subject to eBay 'Collect and Remit' taxes, PayPal will begin distributing order funds to the seller's account with the sales tax included. eBay 'Collect and Remit' taxes include US state-mandated sales tax and 'Goods and Services' tax that is applicable to Australian and New Zealand sellers. Due to this change, the following updates were made to GetOrders (and other order management calls):

This change does not affect sellers that are already opted in to eBay managed payments. For these sellers, the sales tax amount will never be included in a seller payout. For sellers that are opted in to eBay managed payments, the 'Collect and Remit' tax will only be shown in the Transaction.eBayCollectAndRemitTaxes container, and not in the Transaction.Taxes. For sellers not opted in to eBay managed payments, both of these containers will appear in the response showing the 'Collect and Remit' tax details.

Update to GetAccount Call for eBay Collect and Remit Taxes

Six new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for the eBay 'Collect and Remit' tax that is distributed to the seller's account by PayPal, and then pulled from the account by PayPal and sent to the appropriate tax authority. The enumeration values include:

See these new values in AccountDetailEntryCodeType for more information.

A new OrderId field was also added to the AccountEntry container of GetAccount to indicate the order associated with the 'Collect and Remit' tax account entry.

GetCategorySpecifics Updated to Return All Available Item Specific Metadata

The GetCategorySpecifics call has been updated to return all available item specific name-value pairs by default. Before this change, 30 item specific names would be returned by default and 25 corresponding values for each returned item specific name. The maximum amount of item specific names that could be returned was 50, and this limitation was also lifted.

The MaxNames and MaxValuesPerName request filters can still be used if the user wishes to limit the number of item specific names and/or values that are returned in the GetCategorySpecifics response. To account for this change, the Max constraints and the Default values were removed from these request filter field descriptions.

Documentation Changes and Errata - 1129

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

None for this release.

Version 1125

Index of Changed Calls - 1125

Schema Changes - 1125

Announcements - 1125

New Features - 1125

Changed Functionality - 1125

Documentation Changes and Errata - 1125

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

Index of Changed Calls - 1125

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

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
AccountDetailsEntryType.AdFeePremium Enum New
AccountDetailsEntryType.AdFeePremiumCredit Enum New
AccountDetailsEntryType.CanadaPostLabelFee Enum New
AccountDetailsEntryType.CanadaPostLabelFeeCredit Enum New
AccountDetailsEntryType.PerListingPaymentsFee Enum New
AccountDetailsEntryType.PerListingPaymentsFeeCredit Enum New
AccountDetailsEntryType.SendLabelFee Enum New
AccountDetailsEntryType.SendLabelFeeCredit Enum New
AccountDetailsEntryType.UpsLabelFee Enum New
AccountDetailsEntryType.UpsLabelFeeCredit Enum New
AccountDetailsEntryType.VehiclesListingBasicPackageFee Enum New
AccountDetailsEntryType.VehiclesListingBasicPackageCredit Enum New
AccountDetailsEntryType.VehiclesListingPlusPackageFee Enum New
AccountDetailsEntryType.VehiclesListingPlusPackageCredit Enum New
AccountDetailsEntryType.VehiclesListingPremiumPackageFee Enum New
AccountDetailsEntryType.VehiclesListingPremiumPackageCredit Enum New
SubscriptionLevel.Starter Enum New
SubscriptionLevel.Enterprise Enum New

Announcements - 1125

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

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

New eBay Store Subscription Levels

Two new enumeration values, Starter and Enterprise, were added to StoreSubscriptionLevelCodeType to account for the two new eBay Store subscription levels. An eBay user's store subscription level is returned in the GetStore call.

A user must use the 1125 WSDL or set Compatibility Level to '1125' to see these two enumeration values (when applicable) in the GetStore call response.

New Fee/Credit Enum Values Added for GetAccount

16 new enumeration values were added to AccountDetailEntryCodeType to represent the new fees and credits that were added to account for new ad fees, payment fees, vehicle listing fees, and shipping label fees. See the GetAccount Change History section for a full list of the new enum values.

Changed Functionality - 1125

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

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

Added Note to all OrderID Fields to Describe Unpaid/Paid Behavior

A note was added to all OrderID fields to call out how OrderID (and ExtendedOrderID) values change as orders go from unpaid to paid (for sellers integrated with the new order ID format). When using a GetOrders or GetOrderTransactions call (or any other call that uses OrderID in request), either of these order IDs (paid or unpaid status) can be used to identify an order.

Added Note About Updating Payload Version of Platform Notifications

Added a note to the Platform Notifications Landing Page (Notification Payloads section) about the requirement For sellers to upload the Payload Version of their Platform Notifications in order to retrieve the new order ID format for order-related Platform Notifications that are returned in the GetItemTransactions response (when triggered/applicable). A SetNotificationPreferences call should be run to update the payload version of Platform Notifications to '1113' or above.

Added Min/Max Values for WeightMinor Field

Added Min/Max value constraints to the WeightMinor field that is used under ShippingPackageDetails container to express the number of ounces or grams for the weight of a package. The weight of the package is necessary when creating listings that use calculated shipping costs. For ounces, the maximum value is '15', and for grams, the maximum value is '999'.

Version 1119

Index of Changed Calls - 1119

Schema Changes - 1119

Announcements - 1119

New Features - 1119

Changed Functionality - 1119

Documentation Changes and Errata - 1119

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

Index of Changed Calls - 1119

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

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

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

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

None for this release.

Changed Functionality - 1119

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.

Flat or Calculated Shipping Requires at Least One Valid Shipping Service Option

If the seller is using Flat or Calculated shipping, at least one actual shipping service option must be specified through a ShippingDetails.ShippingServiceOptions container when using an Add or Revise Item call. In the past, eBay allowed users to set the shipping cost model to 'Flat' or 'Calculated', and then just pass in one ShippingServiceOptions container with the ShippingServiceOptions.ShipppingServicevalue set to a 'Local Pickup' option. Now, sellers must pass in at least one actual domestic shipping service option in addition to any 'Local Pickup' option, or the listing will be blocked with the following error: 17510 - You must specify at least one domestic shipping service, other than or in addition to Local Pickup.

The Featured Gallery Listing Feature is Scheduled for Deprecation

The Feature Gallery listing feature, currently only available for Top-Rated sellers on the Germany site, has been scheduled for deprecation. Below is the deprecation schedule for the feature:

the GalleryDuration in PictureDetailsType has been removed from the Trading WSDL. In an Add/Revise/Relist call, the value of the GalleryType field in the PictureDetails container should no longer be set to Featured. The ListingEnhancementDurationCodeType, only used to set the duration of the Featured Gallery feature, and the Featured enumeration value of GalleryTypeCodeType have also been marked as no longer applicable due to the impending end of this feature.

ShippingSurcharge Field Removed from Trading WSDL

The ShippingSurcharge field in ShippingServiceOptionsType has been removed from the Trading WSDL. For the next 18 months, this field will still be supported if used in a Add/Revise/Relist call, but it is recommended that sellers configure shipping surcharges in Shipping rate tables instead. Shipping rate tables can be added and modified through the Shipping Preferences in My eBay.

Documentation Changes and Errata - 1119

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

SellerInventoryID Field removed from Trading WSDL

The SellerInventoryID field in ItemType has been removed from the Trading WSDL. This field was no longer applicable as soon as the Half.com site was shut down.

Semicolons cannot be used in PictureURL Fields

Semicolons cannot be used in a PictureURL field. Unlike a blank space, a semicolon cannot be "escaped" with %20. If a semicolon is used in a PictureURL field, that picture will not be allowed.

Copyright © 2005–2020 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.