Shopping API
This archive document contains information about releases that go back longer than four quarters ago. For more recent releases, see the current Release Notes.
Are you just getting started with the API? The following describe how to join the eBay Developers Program, how to create test users, and other steps toward getting your application certified to interact with the eBay production API servers:
|
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
These releases go back longer than four quarters ago. For more recent releases, see the current Release Notes.
Documentation Changes and Errata - 1099
For a current list of known issues, see Site Status Updates and the Knowledge Base.
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.
No new calls in this release.
No changed calls in this release.
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.
None for this release.
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.
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 - 1099.
None for this release.
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.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1099 and Changed Functionality - 1099.
Documentation Changes and Errata - 1085
For a current list of known issues, see Site Status Updates and the Knowledge Base.
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.
No new calls in this release.
None for this release.
See the Site Status Updates for bug fixes related to this release.
For sellers enrolled in the new eBay Managed Payments program, a specified payment method is not necessary. If a payment method is specified in the API call itself, or through an associated Payment Business Policy, it will be dropped from the listing.
Sellers in the new eBay Managed Payments program can also enable the immediate payment feature. Previously, the immediate payment feature was only available if PayPal was the only available payment method.
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 - 1085.
None for this release.
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.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1085 and Changed Functionality - 1085.
The AvailableItemsOnly and HideDuplicateItems filters are no longer applicable because the FindProducts call no longer retrieves any active listings associated with the retrieved catalog products.
Numerous Shopping API type definitions were cleaned up.
Documentation Changes and Errata - 1063
For a current list of known issues, see Site Status Updates and the Knowledge Base.
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.
No new calls in this release.
| Name | Part of Schema | Type of Change |
|---|---|---|
ReturnPolicy.InternationalReturnsAccepted |
Field | New |
ReturnPolicy.InternationalReturnsWithin |
Field | New |
ReturnPolicy.InternationalShippingCostPaidBy |
Field | New |
ReturnPolicy.InternationalRefund |
Field | New |
None for this release.
See the Site Status Updates for bug fixes related to this release.
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 - 1063.
Several International fields were added to the ReturnPolicy container. These fields let sellers specify international return policies that differ from their domestic return policies (international returns are those that are shipped using an international shipping service).
Before this release, the single set of return policy fields represented the seller's return policies for both domestic and international returns. The preexisting return policy fields now define a seller's domestic return policy and the new international fields enable sellers to also define specific international return policies. (If a seller does not define specific international return policies, then any international returns will inherit the seller's domestic return policies).
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.
This release launches a reorganization to eBay's return policies. To streamline the number of return variations, several fields were deprecated and others were added to make return policies simple to create and easy to maintain. For details on this roll out, see the Spring 2018 Seller Announcement, Simplified Returns.
Starting with this release, sellers can no longer specify warranty information, restocking fees, or hours for extended holiday returns with their return policies. With this, the following ReturnPolicy fields are deprecated with this release; any values supplied to these fields will neither be read nor returned:
ReturnPolicy.RestockingFeeValueReturnPolicy.RestockingFeeValueOptionReturnPolicy.WarrantyDurationReturnPolicy.WarrantyOfferedReturnPolicy.WarrantyTypeSimplified returns changes the following functionality within the ReturnPolicy container in this release:
MoneyBack for all eBay marketplaces except for the US marketplace (on EBAY_US, you can also set this to MoneyBackOrReplacement). The value MoneyBackOrExchange is retired. While currently accepted for existing policies, this value is now mapped to MoneyBackOrReplacement for domestic return policies, and the value is ignored in international return policies.Call GetCategoryFeatures with DetailName set to ReturnPolicyDetails to review which categories allow a 14-day return period. (GetCategoryFeatures will be updated in July 2018 with the return period values supported by each category, including the categories that support a 14-day return period.)
ReturnsAccepted in either the domestic or international return policy. Valid values for this field are Buyer and Seller.This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1063 and Changed Functionality - 1063.
None for this release.
Documentation Changes and Errata - 1057
For a current list of known issues, see Site Status Updates and the Knowledge Base.
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.
No new calls in this release.
| Name | Part of Schema | Type of Change |
|---|---|---|
VariationType.ProductID |
Field | New |
See the Site Status Updates for bug fixes related to this release.
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 - 1057.
If an eBay Catalog product is associated with a variation within a multiple-variation listing, the unique identifier of the eBay Catalog product (also known as an ePID) will be returned in the new Variation.ProductID field of the GetSingleItem and GetMultipleItems calls.
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.
This section lists additional documentation changes and corrections that were made with this release and that are not already mentioned in New Features - 1057 and Changed Functionality - 1057.
None for this release.
Copyright © 2007–2020 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.