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 1235
Documentation Changes and Errata - 1235
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1235
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
- RelistFixedPriceItem
- RelistItem
- ReviseFixedPriceItem
- ReviseItem
- VerifyAddFixedPriceItem
- VerifyAddItem
- VerifyRelistItem
Schema Changes - 1235
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.
Note: Support for extended producer responsibility regulations and custom policies will become active mid-December 2021. Additional resources such as the custom policies resource (for the Account API), the getExtendedProducerResponsibilityPolicies method (for the Sell Metadata API), and the Custom Policies help page will also become active.
| Name | Part of Schema | Type of Change |
|---|---|---|
ExtendedProducerResponsibilityType |
Type | New |
Item.ExtendedProducerResponsibility |
Field | New |
Item.ExtendedProducerResponsibility.ProducerProductId |
Field | New |
Item.ExtendedProducerResponsibility.ProductPackageId |
Field | New |
Item.ExtendedProducerResponsibility.ShipmentPackageId |
Field | New |
Item.ExtendedProducerResponsibility.ProductDocumentationId |
Field | New |
Item.ExtendedProducerResponsibility.EcoParticipationFee |
Field | New |
CustomPoliciesType |
Type | New |
Item.CustomPolicies |
Field | New |
Item.CustomPolicies.TakeBackPolicyId |
Field | New |
Item.CustomPolicies.ProductCompliancePolicyId |
Field | New |
Item.Variations.Variation.VariationExtendedProducerResponsibility |
Field | New |
VariationExtendedProducerResponsibilityType |
Type | New |
Item.Variations.Variation.VariationExtendedProducerResponsibility.Item.Variations.Variation.EcoParticipationFee |
Field | New |
Announcements - 1235
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 - 1235
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 - 1235.
Note: Support for extended producer responsibility regulations and custom policies will become active mid-December 2021. Additional resources such as the custom policies resource (for the Account API), the getExtendedProducerResponsibilityPolicies method (for the Sell Metadata API), and the Custom Policies help page will also become active.
New Schema added to support custom policies
To support custom policies, policy IDs can be specified in add, revise, relist, or verify calls. This feature is supported by a limited number of sites and specific categories. Refer to the Metadata API to return the enabled sites and categories. To create and manage custom policies, see the Account API.
- CustomPolicies: This container and its child fields are used to specify custom policy IDs.
New Schema added to support extended producer responsibility regulations
To support new extended producer responsibility regulations, information about the producer of a new item can be specified in add, revise, relist, or verify calls. This feature is supported by a limited number of sites and specific categories. Refer to the Metadata API to return the enabled sites and categories.
- ExtendedProducerResponsibility: This container field provides information about the producer of the new item. This includes producer, packaging, shipment packaging, and added documentation IDs, and the EcoParticipationFee.
- VariationExtendedProducerResponsibility: This container field defines variation-specific Extended Producer Responsibility information, specifically the EcoParticipationFee in add, revise, relist, or verify calls.
Changed Functionality - 1235
This section describes logical or functional changes that have been made to existing functionality, including new code list values and/or changes in validation rules.
New Error Codes for 1235
Below is the list of the new error messages that rolled out with the 1235 release. All of these messages are related to using Extended Producer Responsibility. The long version of each message is used below.
- (Warning)
21920322:replaceable_value is not applicable and has been dropped. - (Error)
21920323:replaceable_value is required for this category. - (Warning)
21920324:Eco Participation Fee is not applicable for the condition and has been dropped. - (Error)
21920325:Eco Participation Fee is not valid and needs to be a number between replaceable_value and replaceable_value. - (Error)
21920326:replaceable_value is not valid. - (Error)
21920327:replaceable_value cannot be revised if the item has a bid or is ending within 12 hours.replaceable_value business day(s). - (Warning)
21920328:Same policy ID(ies) replaceable_value cannot be specified multiple times. - (Error)
21920329:Only replaceable_value policies can be specified, But given policies are replaceable_value. - (Error)
21920330:The specified replaceable_value policy(ies) replaceable_value are not found. - (Error)
21920331:The policy(ies) replaceable_value is not of type replaceable_value. - (Warning)
21920332:Item level Eco Participation Fee will be ignored for MSKU items.
These error and warning messages can be viewed in the Errors By Number page.
Documentation Changes and Errata - 1235
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1235 and Changed Functionality - 1235.
None for this release.
Version 1225
Documentation Changes and Errata - 1225
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1225
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 - 1225
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 |
|---|---|---|
ServiceCostType |
Type | New |
AuthenticityVerification.ServiceCost |
Field | New |
TaxTypeCodeType.ImportVAT |
Enum | New |
TaxTypeCodeType.VAT |
Enum | New |
Announcements - 1225
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 - 1225
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 - 1225.
None for this release.
Changed Functionality - 1225
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.
eBay France's VAT ID to be Returned 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. With Version 1225, France VAT IDs will start being returned.
A new value, VAT_ID, will be returned as the name attribute in the Transaction.eBayCollectAndRemitTaxes.eBayReference field, and this value will indicate that the VAT ID is for eBay France. The Order.BuyerTaxIdentifier.ID field will show the VATIN for the buyer.
|
Note: The eBay and buyer VAT IDs for France are scheduled to start getting returned on September 30, 2021. Going forward after September 30, developers will need to use a Trading WSDL with a version number of 1225 (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 1225, but setting the X-EBAY-API-COMPATIBILITY-LEVEL header value to 1225 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. |
Two Enums Added to TaxTypeCodeType for EU VAT Tax
Two new enumeration values were added to TaxTypeCodeType. The values in this type are returned in the TaxDetails.Imposition field in order management calls. Below are the two new values:
- ImportVAT: this value indicates that French VAT tax was charged to the buyer against the order line item.
- VAT: this value indicates that VAT tax was charged to the buyer against the order line item on the UK marketplace, the Norway marketplace, or other EU marketplace (except for France).
Authenticity Guarantee Service Costs Returned in Order Management Calls
A new ServiceCost container will get returned for items going through the Authenticity Guarantee process. The cost shown in this container is the service cost charged to the buyer for an item that will go through the Authenticity Guarantee process.
Authenticity Guarantee service is only applicable to luxury watches, handbags, and sneakers categories.
Documentation Changes and Errata - 1225
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1225 and Changed Functionality - 1225.
The SpecifiedInvoice Option in GetAccount Marked as Deprecated
The SpecifiedInvoice value, defined in AccountHistorySelectionCodeType, can no longer be used in the AccountHistorySelection field of GetAccount. Support for this value was actually stopped in Version 1131, but the documentation was not updated to state this until now. As an alternative to SpecifiedInvoice, the BetweenSpecifiedDates value can be used instead.
Version 1221
Documentation Changes and Errata - 1221
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1221
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 - 1221
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 - 1221
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 - 1221
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 - 1221.
None for this release.
Changed Functionality - 1221
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 Refurbished Item Conditions in Category 9355
Condition ID 2500 ('Seller Refurbished') can no longer be used in the Cell Phones & Smartphones category (category ID 9355) for the following marketplaces: US, Canada, UK, Germany, and Australia. In lieu of the 'Seller Refurbished' item condition in category 9355, sellers will have to get pre-qualified for and start using one of the following refurbished item conditions: condition ID 2010 ('Excellent - Refurbished'), condition ID 2020 ('Very Good - Refurbished'), and condition ID 2030 ('Good - Refurbished'). Any seller who is not eligible to use these new refurbished item conditions in category 9355 will be blocked if they try to create a new listing or revise an existing listing with any of these three new item conditions. Any active listings in category 9355 that had condition ID 2500 ('Seller Refurbished') as the item condition should have been administratively ended by eBay. Sellers will have to relist these items, and unless they are eligible to list with the new refurbished item conditions, they will need to use another item condition supported in category 9355, such as condition ID 3000 ('Used').
GetCategoryFeatures Updated to Return New Refurbished Item Conditions
GetCategoryFeatures was updated to start returning the three new refurbished item condition values, which are condition ID 2010 ('Excellent - Refurbished'), condition ID 2020 ('Very Good - Refurbished'), and condition ID 2030 ('Good - Refurbished'). Similar to condition ID 2000 ('Certified - Refurbished'), the new refurbished item condition values are returned in the SpecialFeatures container (instead of the ConditionValues container) to indicate that sellers must be pre-qualified to use these item conditions.
Currently, these refurbished item conditions are only applicable for the Cell Phones & Smartphones category (category ID 9355) and for the following marketplaces: US, Canada, UK, Germany, and Australia.
New and Updated Error Codes for 1221
The text of the following existing error code was updated. The long version of message is used below.
- (Error)
12320:The deposit amount must be replaceable_value or less.
Below is the list of the new error messages that rolled out with the 1221 release. All of these messages are related to using refurbished item conditions. The long version of each message is used below.
- (Error)
21920311:Seller is not eligible to use Refurbished Item Condition in this Category. - (Error)
21920312:Seller is not eligible to use Refurbished Item Condition for the selected Brand. - (Error)
21920313:When listing an item with Refurbished condition, replaceable_value cannot be used in the Title. - (Error)
21920314:When listing an item with Refurbished condition, replaceable_value cannot be used in the Subtitle. - (Error)
21920315:When listing an item with Refurbished condition, at least replaceable_value image(s) must be provided. - (Error)
21920316:When listing an item with Refurbished condition, maximum handling time must be replaceable_value business day(s). - (Error)
21920317:When listing an item with Refurbished condition, free shipping must be provided. - (Error)
21920318:When listing an item with Refurbished condition, returns must be accepted. - (Error)
21920319:When listing an item with Refurbished condition, refund must be provided as Money Back. - (Error)
21920320:When listing an item with Refurbished condition, the minimum time you'll accept returns must be replaceable_value days. - (Error)
21920321:When listing an item with Refurbished condition, seller must pay the cost for return shipping.
These error and warning messages can be viewed in the Errors By Number page.
Documentation Changes and Errata - 1221
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1221 and Changed Functionality - 1221.
Added Some Clarification for the Reserve Price Fee
Updated the Item.ReservePrice field description (used by Add/Revise/Relist calls) to make it more clear about the fee structure and policy used for the reserve price feature.
Updated Numerous Add/Revise/Relist/Verify Call Samples
Made numerous updates to Add/Revise/Relist/Verify call samples in the reference docs. Two high-level updates included adding the required item specifics for the specified category, and also removing PayPal and payment-related fields that are no longer needed for sellers onboarded for managed payments.
Version 1217
Documentation Changes and Errata - 1217
For a current list of known issues, see the API Status page and the Knowledge Base.
Index of Changed Calls - 1217
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 - 1217
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 - 1217
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.
ReviseCheckoutStatus Call Decommissioned
The ReviseCheckoutStatus call was decommissioned on July 31, as scheduled. This call and all of its exclusively used types and fields have been removed from the schema and reference documentation.
eBay recommends that sellers use the CompleteSale call to update the status and/or details of orders.
Sellers can also use the createShippingFulfillment method of the Fulfillment API to provide shipment tracking information for one or more line items of a paid order.
New Features - 1217
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 - 1217.
None for this release.
Changed Functionality - 1217
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 Revised Error Messages
Below is the list of new error messages that rolled out with the 1217 release:
- (Error)
21920308:Unable to create Business Policies for this listing. The call to underlying service did not succeed. - (Warning)
21920310:Lot Size is not applicable for Multi-SKU listings.
Below is an existing error message whose text was revised with the 1217 release:
- (Warning)
21920306:Seller is not eligible to use replaceable_value condition either for this site or for the category selected
These error and warning messages can be viewed in the Errors By Number page.
Documentation Changes and Errata - 1217
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1217 and Changed Functionality - 1217.
A Clarification Provided on Shipment Tracking Number
A note was added to the ShipmentTrackingDetails.ShipmentTrackingNumber field description informing users that the Trading API only supports alphanumeric characters in shipment tracking numbers.
A Clarification on Managed Payments Sellers Providing Offline Payment Methods
Updated the notes in numerous payment method-related fields to make it clear that offline payment methods will need to be provided by managed payments sellers for listings that require or support offline payment methods. An example of this would be a motor vehicle listing. Generally, the full payment of a motor vehicle happens offline between the buyer and seller, so the seller has to provide the available offline payment methods such as Money Order, Cashier's Check, Loan Check, etc.
Removed Notes on Integrated Merchant Credit Card Account Fields
Sellers have not been allowed to use Integrated Merchant Credit Card (aka iMCC) payment gateway accounts to handle buyer payments since May 2019. Many iMCC fields had notes explaining that these payment gateway accounts were no longer supported, but these notes have been removed and these fields have been marked as no longer applicable.
Update to some Charity-Related Fields
Some Charity-related field descriptions said that PayPal had to be used to purchase items in charitable listings, but this is not correct. Any form of electronic payment available to the buyer can be used to purchase these items, and the charitable donation will still go through.
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.