Please note the following important information:
SDKInstallDir\lib\externalLib\optional\jaxp-1.4.2 into the application's classpath. Please post
issues with IBM JDK 1.5 in the
Java SDK Forum.Important: Changes to the Trading API affect the SDK. For example, in schema version 499, deprecated objects in the schema were deleted, creating backward incompatibility. See the Trading API Release Notes for ongoing updates to the schema (including occasional removals of schema elements). Please also see Versioning Strategy and Deprecated Objects.
This release is compatible with eBay's 747 Trading WSDL, and supports the following new features.
The LocalPickup flag indicates whether the buyer has selected local pickup as the shipping option or the seller has made local pickup available as a shipping option.
New SoldAsBin flag in GetItem call indicates when an auction listing has ended before the stated auction end time due to a buyer using the Buy It Now option to purchase the item.
New AutoOptDonationRefund flag in SetUserPreferences call allows a seller to request that eBay automatically request eBay Giving Works donation refunds after Unpaid Item cases are opened and closed through the Unpaid Item Assistant mechanism without payment. This preference is only applicable to charity listings.
eBay has added three new fields (SellerProvidedTitle, DepositAmount, and DepositType) to AddItem and related calls. These fields will soon replace the US and Canada eBay Motors Subtitle attribute (10246), and the US eBay Motors deposit amount and type attributes (10733 and 10734). The attributes will continue to work for a period of time to give developers time to migrate to the new fields. Keep an eye on these release notes for information about when the new fields will be functional.
ClassifiedsContactSeller and ClassifiedsBestOffer added as new message types. ClassifiedsContactSeller indicates that an inquiry has been sent to the seller regarding the corresponding classified ad listing. ClassifiedsBestOffer indicates that a best offer has been made on the seller's corresponding classified ad listing.
A new value of "Paid" can now be returned in GetOrders (and other order retrieval calls) when checkout is complete and order has been paid for by the buyer. This value is returned in the CheckoutStatus.eBayPaymentStatus field. This value may also be returned in the MyeBaySelling and MyeBayBuying calls.
A new dispute explanation was added and available to use through the AddDispute call. The value is "SellerRanOutOfStock", and this value can be used by the seller when cancelling an order due to an item being out of stock.
Information on one or more item or shipping discounts can now be retrieved using GetOrders and other order retrieval calls.
Call GetCategoryFeatures to see if a site or category supports the ability to pass in Brand/MPN, EAN, ISBN, or UPC values in an Add/Revise/Relist call.
Please refer to the Trading API Release Notes for a detailed list of the new calls and elements since the previous Java SDK release
This release is compatible with eBay's 735 Trading WSDL, and supports the following new features.
Sellers can specify discount pricing values for an item to give the item either a Strike-Through Pricing (STP) or Minimum Advertised Price (MAP) display treatment. This feature is available to qualified sellers (and their associated developers) who participate in the Discount Pricing program. Once qualified, sellers can apply Discount Pricing to both MSKU and Non-MSKU items. STP is available on the US, UK, and DE sites while MAP is available only on the US site.
Please refer to the Trading API Release Notes for a detailed list of the new calls and elements since the previous Java SDK release
This release is compatible with eBay's 715 Trading WSDL, and has the following features.
The search calls GetSearchResults and GetCategoryListings are now deprecated in the Trading API (see Trading API Release Notes for details).
This point release replaces the deprecated functionality by supplying a Finding Kit that shows how to use equivalent calls in the Finding API. The Finding Kit includes a Finding API proxy, samples, and tutorials. You can download the Finding Kit here: https://developer.ebay.com/DevZone/codebase/javasdk-jaxb/FindingKitJava_1.0.zip.
This release is compatible with eBay's 705 Trading WSDL. There are no new features.
This release is compatible with eBay's 687 Trading WSDL, and supports the following new features.
Commons logging is replaced with SLF4J (Simple Logging Facade for Java) for better logging support. A description of logging in the SDK can be found in Getting Started
The JavaSDK package is re-organized so that its files and folders are in more readily expected locations, as follows.
A source jar is now provided in the lib/srcjar folder, for source debugging.
The consoleAddItem sample has been enhanced. It now demonstrates how to set item specifics.
A consoleAddFixedPriceItem sample is added. It demonstrates how to set item variations.
This release is compatible with eBay's 673 Trading WSDL, and contains support for the following new features.
This SDK now supports the ConditionID setting on AddItem and related calls. See the Trading Call Reference to learn about Item.ConditionID.
Two new Java console samples, suitable for getting started using the SDK, are added to the SDK with this release. They are called helloWorld and consoleAddItem, and they are accompanied by tutorials.
A Maven pom.xml file is provided in the helloWorld and consoleAddItem samples; refer to readme_maven.txt in the sample folder for instructions for building and running these samples with Maven. Also included: a pom.xml file for building ebaysdkcore.jar with Maven. Refer to {SDK Root}/build/maven_build/readme.txt for build instructions.
This release is compatible with eBay's 661 Trading WSDL, and contains support for the following new features.
The VerifyRelistItem and ExtendSiteHostedPictures calls, as well as a new VerifyOnly field for the ReviseItem call have been introduced in this release. Please refer to the Trading API Release Notes for a detailed list of the new calls and elements.
A new UploadPictures sample has been added in the apiCallsDemo. This sample shows how to use the eBay Picture Service (EPS) to upload pictures.
Per your request, we removed the Apache log4j dependency and used Apache commons logging instead in the JavaSDK core library. However, you can still see how to configure Apache log4j in the SDK samples.
The readme for the attributesDemo sample has been updated to reflect the latest changes to the sample.
This release is compatible with eBay's 639 Trading WSDL, and contains support for the following new features.
The Java attributesDemo sample has been simplified. This sample simulates a simple sell your item(SYI) flow, it shows how to use eBay API/SDK to:
For detailed architecture and call flow of the sample, please refer to the readme in the sample folder.
The eclipse project files for JavaSDK have been updated, all absolute references (library, source, jdk) have been changed to relative references, now all projects can be imported into eclipse environment without additional reference updates.
For instructions about how to setup JavaSDK in Eclipse, please refer to the DevEnvReadme in SDK root folder.
This release is compatible with eBay's 631 Trading WSDL, and contains support for the following new features.
A new class, SdkProxySelector.java, is included in this release for those who access the eBay API using a proxy server and want to configure the proxy settings programmatically. For examples of usage, please refer to the apiCallsDemo sample.
The new DetailsDownloader.java, helper class shows you how to cache eBay details locally.
With the exception of, GetTokenStatus, RevokeToken, GetSessionID, and FetchToken, all Java SDK API calls can now be made with an eBay API developer token (instead of full eBay API developer credentials.)
This release is compatible with eBay's 623 Trading WSDL, and there are no new features.
This release is compatible with eBay's 615 Trading WSDL, and contains support for the following new features.
Four new classes, AddFixedPriceItem.java, ReviseFixedPriceItem.java, RelistFixedPriceItem.java and AddFixedPriceItem.java, have been added in this release. These classes can be used as single calls within a Java method, or they can be used within data files in the Large Merchant Services solution.
This release is compatible with eBay's 603 Trading WSDL, and contains support for the following new features.
Two new helper classes, CategoriesDownloader.java and FeaturesDownloader.java, have been added in this release. The CategoriesDownloader.java class caches eBay Category information to a local disk. The FeaturesDownloader.java class caches the eBay Category Feature information to a local disk. Using these classes, you can access category information without repeatedly making GetCategory and GetCategoryFeatures requests.
The AttributesDemo sample has been updated to take advantage of the new helper classes, so that you can see how to cache the eBay categories and features in a local repository.
The eBayAccount class was removed as part of a code clean-up in Release 595. It has been added back into the code for this release. It is also available as a downloadable patch for Release 595.
This release is compatible with eBay's 595 Trading WSDL, and contains support for the following new features.
In this release, the eBay SDK for Java has been migrated from Axis 1.1 to JAX-WS for use with production code. We recommend that you upgrade your production applications from the Axis version of the eBay SDK for Java to the JAX-WS version. For more information, please see Migrating to the JAX-WS eBay SDK for Java.
Since the classes in the eBay Picture Service (EPS) have been replaced by the UploadSiteHostedPictures Trading API (XML) call, the Java SDK now supports the UploadSiteHostedPictures call. Because this is a Trading API call, you will need to provide an eBay developer authorization token (that you obtain with your application keys) when making this call.
The UploadSiteHostedPictures call is the only call in the Trading API that doesn't support SOAP. Therefore, you need to use the following (XML) endpoints (Gateway URLs):
In addition, it is important that you use these endpoints for both the production and sandbox environments. The addresses for both environments must be consistent because you will need to update the authorization token in your ApiContext class before switching from one platform to the other (Trading API (XML) and SDK servers use different authorization keys.)
You can still use the EPS libraries with this release, but they will eventually be discontinued, so we recommend that you migrate to the newer call as soon as you can. The UploadSiteHostedPictures call enables you to upload files in image formats such as JPG by including a binary attachment after the XML input, as part of the request. The call returns SiteHostedPictureDetails.FullURL, which must be stored by your application (for associating the picture using the Item.PictureDetails.PictureURL field of AddItem, ReviseItem, or RelistItem).
For more information, please see the following:
This release also includes support for the ProPay payment method. ProPay is a third party application that allows small businesses to accept credit cards. For more information about ProPay, see www.ProPay.com. For more information about accepted eBay payment methods, see BuyerPaymentMethodCodeType in the Trading Call Reference.
An updated JSP attributeDemo sample includes return policy information that is integrated with the rest of the Item details, instead of being posted on a separate page. It also includes a dynamic lookup feature for Shipping Service, Payment Methods, Listing Type, and Listing Duration. This sample demonstrates the usage of eBay Custom Item Specifics with the Trading API GetCategoryFeatures and GetCategorySpecifics calls.
Some SDK samples have been updated based on recent API features. Please note
that for Return Policy and for the requirement to specify shipping,
some samples contain hard-coded fields. Therefore, if you want to change the
target site used in the sample, you must integrate GetCategoryFeaturesCall
and GeteBayDetailsCall into the sample. For important information, see the
Trading API Release Notes and the eBay Feature Guide.
For important information about the latest API features, including new requirements for listings, please see the Trading API Release Notes and the eBay Feature Guide.
As of this release, all legacy XML classes and calls have been removed. The new UploadSiteHostedPictures call is the only remaining XML call.
In this second Beta release, the eBay SDK for Java has been migrated from Axis 1.1 to JAX-WS. For more information, please see Migrating to the JAX-WS eBay SDK for Java (Beta Release).
For important information about the latest API features, including new requirements for listings, please see the Trading API Release Notes and the eBay Feature Guide.
The eBay SDK for Java contains updated wrapper classes, updated test cases, and other updates that facilitate your use of recent API features. Changes include updates to user token retrieval and deprecation of eBay Express.
Some SDK samples are updated based on recent API features. Please note
that for Return Policy and for the requirement to specify shipping,
some samples contain hard-coded fields. Therefore, if you want to change the
target site used in the sample, you must integrate GetCategoryFeaturesCall
and GeteBayDetailsCall into the sample. For important information, see the
Trading API Release Notes and the eBay Feature Guide.
In this release, the eBay SDK for Java has been migrated from Axis 1.1 to JAX-WS. This migration includes changes to the SDK core classes, wrapper classes, samples, and test cases. Stubs and datatypes are now generated with the wsimport tool under the JAX-WS standard, and this process is automated as before by using Ant (the name of the buildfile is build.xml). For more information, please see Migrating to the JAX-WS eBay SDK for Java.
SDK version 561, and earlier SDK versions, were based on Axis 1-1.
A new StubModifier tool is used to handle unrecognized enum values received in a SOAP response. The tool post-processes the stubs generated by Apache Axis WSDL2Java. The tool contains the StubModifier class, located in ...\source\Tools\StubModifier\src\tools\webservices\wsdl\stubutil\StubModifier.java.
The eBay SDK for Java includes the user-authentication improvements released with Trading API version 557. For information about these improvements, see the Release Notes for version 557 of the Trading API and see Getting Tokens in the eBay Trading API guide.
The SDK changes include 3 new wrapper classes (GetSessionIDCall, GetTokenStatusCall, and RevokeTokenCall) and new FetchTokenCall functionality. Please use the new FetchTokenCall functionality in your application. The apiCallsDemo and signinRedirect samples are updated with the new FetchTokenCall functionality. Additionally, the apiCallsDemo is updated to show uses of GetTokenStatusCall and RevokeTokenCall.
For information about the latest API features, please see the Trading API Release Notes and the eBay Trading Web Services section of the Developer Documentation Center.
For information about previous versions, see the Axis 1.1 Java SDK Readme.
© 2009–2011 eBay Inc. All rights reserved.
eBay and the eBay logo are registered trademarks of eBay Inc.
All other brands are the property of their respective owners.