Trading API Release Notes Archive
This archive document contains information about releases that go back longer than four quarters ago. For more recent releases, see the current Release Notes.
|
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
These releases go back longer than four quarters ago. For more recent releases, see the current Release Notes.
Version 1211
Documentation Changes and Errata - 1211
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1211
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 - 1211
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 - 1211
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1211
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 - 1211.
None for this release.
Changed Functionality - 1211
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 Marketplaces Supported for Adding Videos to Listings
The capability to add videos to eBay listings is now supported on the UK and eBay Motors sites. For more information, please visit the Managing videos page on the developer portal.
Documentation Changes and Errata - 1211
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1211 and Changed Functionality - 1211.
None for this release.
Version 1209
Documentation Changes and Errata - 1209
For a current list of known issues, see the API Status page 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
- AddFixedPriceItem
- AddItem
- AddItems
- GetAccount
- GetItemTransactions
- GetOrders
- GetOrderTransactions
- GetSellerTransactions
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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 |
AccountDetailEntryCodeType.DepositProcessingVariableFee |
Enum | New |
AccountDetailEntryCodeType.DepositProcessingVariableFeeCredit |
Enum | New |
AccountDetailEntryCodeType.DepositProcessingFixedFee |
Enum | New |
AccountDetailEntryCodeType.DepositProcessingFixedFeeCredit |
Enum | New |
Announcements - 1209
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 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 Order Management Calls
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:
- Transaction.eBayCollectAndRemitTaxes.eBayReference: this field will show the VAT ID for eBay, and this value may vary based on the region or country. The eBayReference field's name attribute will show the type of VAT ID, such as
IOSS,OSS, orABN. The eBayTaxReferenceValue type was added to support this new field and associated attribute. - Order.BuyerTaxIdentifier.ID: this field will show the VATIN for the buyer, and the corresponding Order.BuyerTaxIdentifier.Type field should return the new
VATINvalue, which was added to the existing ValueTypeCodeType.
|
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.
Update to GetAccount Call for New Deposit Processing Fees/Credits
Four new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for new deposit processing fees/credits. The enumeration values include:
DepositProcessingVariableFeeDepositProcessingVariableFeeCreditDepositProcessingFixedFeeDepositProcessingFixedFeeCredit
See these new values in AccountDetailEntryCodeType for more information.
All Remaining Selling Manager Calls Now Decomissioned
All of the remaining Selling Manager calls have been decommissioned and removed from the Trading WSDL and docs.
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
Documentation Changes and Errata - 1207
For a current list of known issues, see the API Status page 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
- AddFixedPriceItem
- AddItem
- AddItems
- GetBidderList
- GetItem
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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.
No schema changes in this release.
Announcements - 1207
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 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
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.
Some Minor Doc Cleanup to AccountDetailEntryCodeType Enums
Made some minor documentation updates to some of the enum values in AccountDetailEntryCodeType.
Version 1203
Documentation Changes and Errata - 1203
For a current list of known issues, see the API Status page 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
- AddFixedPriceItem
- AddItem
- AddItems
- GetItem
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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 Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 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.
The GetItem call will return the VideoDetails container if the listing contains a video, and the seller of the item is the one making the call.
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
Documentation Changes and Errata - 1201
For a current list of known issues, see the API Status page 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
- GetAccount
- GetItemTransactions
- GetMyeBaySelling
- GetOrders
- GetOrderTransactions
- GetSellerTransactions
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.
| Name | Part of Schema | Type of Change |
|---|---|---|
AccountDetailEntryCodeType.AdFeeExpress |
Enum | New |
AccountDetailEntryCodeType.AdFeeExpressCredit |
Enum | New |
Announcements - 1201
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 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.
Update to GetAccount Call for New Promoted Listing Fee/Credit
Two new enumeration values were added for GetAccount (in AccountDetailEntryCodeType) to account for the new Promoted Listing Express feature. The enumeration values include:
AdFeeExpressAdFeeExpressCredit
See these new values in AccountDetailEntryCodeType for more information.
New Error Code Added for 1201
The following new error messages that rolled out with the 1201 release:
- (Warning)
21920297:Store Fixed Price format is no longer supported. The listing format has changed from Store Fixed Price to Basic Fixed Price.
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 response of the following calls for multiple-variation listings:
- GetItemTransactions
- GetMyeBaySelling
- GetOrders
- GetOrderTransactions
- GetSellerTransactions
Version 1199
Documentation Changes and Errata - 1199
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1199
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 - 1199
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 - 1199
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 1199
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 - 1199.
None for this release.
Changed Functionality - 1199
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.
The Max Length of Feedback Comment Fields Increased to 500 Characters.
The maximum length of a Feedback comment has been increased to 500 characters. The table below summarizes the Trading API calls and fields to which this change applies:
| Call | Field | Input/Output? |
|---|---|---|
| GetFeedback | CommentText | Output |
| FeedbackResponse | Output | |
| Followup | Output | |
| LeaveFeedback | CommentText | Input |
| RespondToFeedback | ResponseText | Input |
Documentation Changes and Errata - 1199
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1199 and Changed Functionality - 1199.
None for this release.
Version 1197
Documentation Changes and Errata - 1197
For a current list of known issues, see the API Status page 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
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.
| Name | Part of Schema | Type of Change |
|---|---|---|
Category.SpecialFeatures |
Field | New |
SiteDefaults.SpecialFeatures |
Field | New |
Announcements - 1197
None for this release.
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 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.
New SpecialFeatures Container Added to GetCategoryFeatures
A new SpecialFeatures container was added to GetCategoryFeatures. This container will be returned if the user is searching for item condition values (by including and setting a FeatureID field to ConditionValues and the corresponding category supports special item conditions such as Certified Refurbished (Condition ID 2000). This item condition value will no longer be returned under the ConditionValues container.
A seller must be pre-qualified by eBay to list items with the Certified Refurbished condition.
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:
- (Warning)
21920269:Ignored duplicate Video Id(s). - (Error)
21920271:A listing can have maximum replaceable_value video(s). - (Error)
21920275:replaceable_value cannot be revised if the item has a bid or a best offer or is ending within 12 hours. - (Error)
21920276:replaceable_value cannot be revised if the item has a bid or a best Offer and is ending within 12 hours. - (Error)
21920298:VideoID(s) must contain only alphanumeric characters of length replaceable_value. - (Error)
21920299:VideoID(s) are not owned by the seller account. - (Error)
21920300:No Offline Payments selected for the site you are listing on or for the category selected. - (Error)
21920301:Offline payment must be selected for items that are priced at or higher than replaceable_value. - (Error)
21920304:You cannot publish this listing since your charity information is still being verified. This may take around 2-3 business days. - (Error)
21920305:Seller is not eligible to use Certified Refurbished condition either for this site or for the category selected. - (Warning)
21920306:Certified Refurbished condition has been dropped from the item.
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
Documentation Changes and Errata - 1193
For a current list of known issues, see the API Status page 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
- AddFixedPriceItem
- AddItem
- AddItems
- GetItem
- GetItemTransactions
- GetOrders
- GetOrderTransactions
- GetSellerList
- GetSellerTransactions
- GetSellingManagerTemplates
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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
Change Requests
See the API Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
New Features - 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 Order Management Calls
A new Fulfillment container will be returned in GetOrders, GetOrderTransactions, GetItemTransactions (to seller only), and GetSellerTransactions 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
Documentation Changes and Errata - 1189
For a current list of known issues, see the API Status page 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
- AddFixedPriceItem
- AddItem
- AddItemFromSellingManagerTemplate
- AddItems
- AddSellingManagerInventoryFolder
- AddSellingManagerProduct
- AddSellingManagerTemplate
- DeleteSellingManagerInventoryFolder
- DeleteSellingManagerItemAutomationRule
- DeleteSellingManagerProduct
- DeleteSellingManagerTemplate
- DeleteSellingManagerTemplateAutomationRule
- GetSellingManagerAlerts
- GetSellingManagerEmailLog
- GetSellingManagerInventory
- GetSellingManagerInventoryFolder
- GetSellingManagerItemAutomationRule
- GetSellingManagerSaleRecord
- GetSellingManagerSoldListings
- GetSellingManagerTemplateAutomationRule
- GetSellingManagerTemplates
- MoveSellingManagerInventoryFolder
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- ReviseSellingManagerInventoryFolder
- ReviseSellingManagerProduct
- ReviseSellingManagerTemplate
- SaveItemToSellingManagerTemplate
- SetSellingManagerFeedbackOptions
- SetSellingManagerItemAutomationRule
- SetSellingManagerTemplateAutomationRule
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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 Status page for announcements regarding recently resolved or current system wide issues. Visit the Support page for account support, technical support, and other support resources.
All Selling Manager Pro Calls to be Decommissioned
All Selling Manager Pro calls are being deprecated. Selling Manager Pro calls will start being decommissioned beginning on June 1, 2021.
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:
21920296: PayPal email address, PayPal payment method and Item.PaymentDetails container have been removed from this Classified listing.
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
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
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.
Some Trading API Calls are Scheduled for Deprecation
The GetPromotionalSaleDetails, SetPromotionalSaleListings, and SetPromotionalSale calls are being deprecated, and they will no longer be supported after March 31, 2021. eBay recommends that sellers use the Marketing API, which provides all Promotions Manager capabilities. The Marketing API will continue to be improved and enhanced as more marketing features become available to sellers.
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
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:
- (Error)
10122:Picture URL cannot contain semicolon. - (Warning)
21920282:New Payment Terms of Use will soon be in effect. Please go to replaceable_value to accept the agreement. - (Error)
21920283:You need to accept the new Payment Terms of Use before you can create or revise listings. Please go to replaceable_value to accept the agreement.
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
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
- AddFixedPriceItem
- AddItem
- AddItemFromSellingManagerTemplate
- AddItems
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- ReviseSellingManagerTemplate
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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:
- Category changes for US, CA, and CA-FR sites
- Item Specifics updates, including new Item Specifics and new tools
- UPS shipping services added as an option for eBay shipping labels
- Signature confirmation will start being required for shipments valued at $750 or more
- Updates to eBay managed payments, including simplified fees, more international sales capabilities, and automated return and refund options. You can also see our Managed payments landing page for API-specific updates.
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:
- AddItem
- AddFixedPriceItem
- AddItemFromSellingManagerTemplate
- AddItems
- ReviseItem
- ReviseFixedPriceItem
- ReviseSellingManagerTemplate
- RelistItem
- RelistFixedPriceItem
- VerifyAddItem
- VerifyAddFixedPriceItem
- VerifyRelist
New Error Messages
Below is the list of the new error messages that rolled out with the 1173 release:
- (Error)
21920292:You cannot remove a SKU when Item InventoryTrackingMethod is set to SKU. - (Error)
21920293:This application is not permitted to update the eBay fulfillment flag. - (Warning)
21920294:Picture URL cannot be a stock photo. replaceable_value picture URL(s) have been dropped. - (Error)
21920295:Picture URL cannot contain html or javascript content like ".cookie", ".location", "ebviewitem.", "showhelp", "showmodaldialog", "navigateandfind", "createpopup", "standardwrite", "writepersonalizedheader", "blockactivecontent".
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
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:
- Modified Error message:
80:This site does not support Private Dutch Auction, Private Buy It Now Auction or Private Fixed Price listings. - Added Error message:
21920285:Quantity cannot be updated for items that are fulfilled by eBay. - Added Error message:
21920286:Items that are fulfilled by eBay do not allow these operations - Edit item SKU, Edit variation SKU, Add/Delete variations, Add/Delete variation specifics and Add/Delete variation pictures. - Added Error message:
21920287:SKU is required in every variation for items that are fulfilled by eBay. - Added Error message:
21920288:If your item sells for $10,000 or more, you agree to accept payment via Escrow.com and to allow eBay to amend your return policy to offer 7-day returns. Learn more at https://pages.ebay.com/escrow. - Added Error message:
21920290:eBay fulfillment cannot be applied to an item when there is a pending offer. - Added Error message:
21920291:Additional shipping cost was dropped from the listing either because it is not applicable or the quantity was set to <=1.
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
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
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 - 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.
ReviseSellingManagerSaleRecord Scheduled for Deprecation
The ReviseSellingManagerSaleRecord call is being deprecated. No new features and/or fields will be added to ReviseSellingManagerSaleRecord, and it will no longer be supported after March 30, 2021. eBay recommends that sellers use the CompleteSale Trading API call to mark orders as paid, mark orders as shipped, and provide shipment tracking details.
GetCategorySpecifics Scheduled for Deprecation
The GetCategorySpecifics call is being deprecated. No new features and/or fields will be added to GetCategorySpecifics, and it will no longer be supported after January 31, 2022. eBay recommends that large sellers and developers make plans to migrate to the Taxonomy API RESTful methods.
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.
New and Updated Error Messages
Error message (21920283) and Warning (21920282) were added as part of the User Agreement Service v2 integration to inform seller about Payments Terms of Use (PTOU). Other messages were also updated. Below is the list of the new and updated error messages that rolled out with the 1165 release:
- Modified Error message:
715:Invalid value provided for Weight Minor. Enter a value between replaceable_value and replaceable_value replaceable_value. - Added Error message:
21916962:The postage cost will be calculated based on dimensional weight, not the actual weight of your package. Please check the weight and dimensions of your package. - Added Error message:
21916963:The dimensional weight of your package exceeds the weight limit for the shipping service you selected. Please check the dimensions of your package. - Added Warning message:
21920282:A new User Agreement will soon be in effect. Please go to replaceable_value to accept the agreement. - Added Error message:
21920283:A new User Agreement is in effect and needs to be signed before you can create or revise listings. Please go to replaceable_value to accept the agreement.
These error and warning messages can be viewed in the Errors By Number page.
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
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
- AddFixedPriceItem
- AddItem
- AddItems
- AddSellingManagerTemplate
- GetBidderList
- GetCategorySpecifics
- GetItem
- GetItemTransactions
- GetNotificationPreferences
- GetOrders
- GetOrderTransactions
- GetSellerList
- GetSellerTransactions
- GetSellingManagerTemplates
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- SetNotificationPreferences
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
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.
| Name | Part of Schema | Type of Change |
|---|---|---|
RelevanceIndicatorType |
Type | New |
NameRecommendation.RelevanceIndicator |
Field | New |
Item.ListingDesigner |
Field | Removed |
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.
New Buyer Demand Data Available in GetCategorySpecifics
A new RelevanceIndicator container is returned in GetCategorySpecifics for item specifics if eBay has data on how many searches have been performed for listings in a specific category using that item specific.
'Buyer Demand Data' is restricted to applications that have been granted permission to access this feature. You must submit an App Check ticket to request this access. In the App Check form, add a note to the Application Title/Summary and/or Application Details fields that you want access to 'Buyer Demand Data' in GetCategorySpecifics.
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.
Platform Notifications Will No Longer be Delivered to 'http' URLs
Platform Notifications will no longer be delivered to non-secure servers/URLs that use the 'http' protocol. Any specified URL must use the 'https' protocol. This means that any URLs specified in the ApplicationDeliveryPreferences.ApplicationURL and DeliveryURLDetails.DeliveryURL fields of the SetNotificationPreferences call must use the 'https' protocol.
The GetNotificationPreferences call may be used to view the current URLs to check if they are using the 'https' protocol.
Changes to Final Value Fees for Managed Payments Sellers
The calculation of the Final Value Fee is changing for managed payments sellers, so the value returned in the FinalValueFee fields for each order line item in order management call responses 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.