Shopping API
Information about the schema location is in the Schema Location section of the Making an API Call topic.
Are you just getting started with the Shopping API? The following describes how to join the eBay Developers Program:
|
|
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
These release notes go back four quarters. For older release notes, see the Release Notes archive.
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.
Documentation Changes and Errata - 1027
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.
None for this release.
See the Site Status Updates for bug fixes related to this release.
Beginning on August 31, 2017, API support for Half.com listings is being fully deprecated. Due to this, the FindHalfProducts call, and all of the types and fields (used exclusively with this call), is being deprecated. For a full list of typs and fields affected by this change, see the Documentation Changes and Errata section.
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 - 1027.
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 - 1027 and Changed Functionality - 1027.
Beginning on August 31, 2017, API support for Half.com listings (and the FindHalfProducts call) is being fully deprecated. This section will discuss the full list of types and fields affected by this change.
The following Shopping API types are exclusively for Half.com listings, and these types will no longer be applicable beyond August 31:
The following Shopping API field is exclusively for Half.com listings, and this field will no longer be applicable beyond August 31:
Copyright © 2007–2016 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.