721 Trading, Shopping, Merchant Data API Docs Now Available
Please remember to use a test environment when updating applications to use a new schema version.
To find out when a version of the API will be available, see the table at the top of the Release Notes for that API.
You can find the latest API documentation at the eBay Developer Documentation Center.
- Sellers Can Specify Additional Shipping Services Beginning June 1
- Seller Payment Hold Information Starts Being Returned in APIs in June
- Third-Party Checkout Sunset Warning Message Returned
- Third-Party to eBay Checkout Migration Occurring in Phases in Sandbox
See the Trading API System Announcements for bug fixes included in this release.
ShoppingShopping Release Notes
See the Shopping API System Announcements for bug fixes included in this release.
Merchant DataMerchant Data Release Notes
- Set Paid and Shipped Status with SetShipmentTrackingInfo
- Sellers Can Specify Additional Shipping Services Beginning June 1
See the Large Merchant Services API System Announcements for bug fixes included in this release.
API Tech Docs
Rate Limit Changes to Shopping, Finding, and Merchandising API
To manage your call limits better, eBay is changing the basis for rate limiting API usage for the Shopping, Finding and Merchandising APIs. Starting March 1, 2011, call usage will be measured by application instead of IP address. The call counts will be aggregated for your application based on the AppID used to make the request, rather than the IP address from which the request is coming.
What does this mean to you?
If your application is making more than 5,000 calls a day, go through the compatible application check to get your call limits increased to prevent any disruption to your application.
We heard your requests! Several API enhancements
The 653 Version of the Trading API with Developer-Requested API Enhancements is now available!
Enhancements in this release include:
- Shipping: Tracking Number and Carrier Used
- New VerifyRelistItem Call
- VerifyOnly Field for ReviseItem
- GetPromotionalSaleDetails Enhancement to Filter by Status
- Sellers Can Subscribe to Notification for SellerClosedDisputes
- Updates to GetMyeBaySelling
Tracking Number and Carrier Used are now returned by GetOrders and GetOrderTransactions for both Trading and Half.com. On Half.com, you can use the GetOrders and GetOrderTransactions calls to retrieve unshipped Half.com orders, such as orders that the seller has received but has not yet processed.
The new VerifyRelistItem request allows you to preview the response and fees for an item you want to relist, before you make the actual RelistItem call. This call requests and returns the same data as RelistItem (same inputs, same outputs, and same usage rules), but without actually listing the item to an eBay site.
Applications can use this call to test the definition of an item before actually listing it to eBay with RelistItem, reducing item listing-related errors.
You can use the VerifyOnly boolean field with the flag set to 'true', if you want the response to include the calculated listing price change (if there is an increase in the BIN/Start price) but you do not want the values to persist in the database. See ReviseItem for more details.
Including the VerifyOnly field in ReviseItem is similar to using VerifyAddItem or VerifyRelistItem.
GetPromotionalSaleDetails Enhancement to Filter by Status
Previously, Buyers have been able to subscribe to get notified when a seller has closed a listing dispute. Now the Seller can also subscribe to the SellerClosedDisputes notification. For more information, see options for platform notification.
In response to your product feedback, these enhancements have been made to GetMyeBaySelling:
- Listings with variations now return Variation.StartPrice.
- A new OrderStatusFilter in the request enables you to filter SoldList based on whether transactions have been marked as Paid and/or Shipped in My eBay.
Make Selling Manager Applications Part of Your New Years ResolutionsIt’s a new year. What will you build in 2010?
We have had a very busy year working on the Selling Manager Applications program. We’ve grown to 34 available applications (with more getting ready to launch!) and enhanced the Selling Applications Directory to better market your applications!
Meeting Sellers' Needs
Selling Manager Applications are all about meeting the Seller’s needs. Helping them do and manage their business easier, faster, stronger. Sellers are regular people,trying to earn a living. Life gets in the way. Many of them do not have a technical background and are looking to Selling Manager Applications to solve problems and make it easier for them to earn money.
Let’s face it. Everyone wants to earn money.
Sellers are looking for the best cost-benefit in your applications. In a recent Seller survey, many Sellers said they don’t have a lot of money and are very price sensitive. Given the economy, this should not be a surprise to any of us. Some Sellers said they are not technical and need applications that are easy to use, configure and manage.
When you build your application, keep in mind the different technical skills of the Sellers; your customers:
- Would a Quick Reference Guide help Sellers configure your application faster or easier?
- Would a 30 second video describing the most compelling features of your Selling Manager Application help increase Seller subscriptions of your application?
Make us part of your New Years resolutions!
Submit your Selling Manager Application Business Readiness Review and Billing information by Jan 10th in order to go live by mid-February 2010. Based on our research, we think email management, customer management, shipping and fulfillment, bulk editing of listings, UPI process management, picture management, profitability analysis, and inventory management are all pretty good bets for new Selling Manager Applications. But that doesn't mean you can’t use your imagination and create other application types. Social networking or providing special filtering are some additional areas. Surprise us! Show us what you’ve got!
Read the eBay's Next Gen Platform Opportunity blog entry for an overview of the program and benefits.
- View Lead Product Manager, Selling Manager Applications project, Madhu Gupta’s presentation deck here,
- Learn more about Selling Manager Applications here.
eBay Developers who have created Selling Manager Applications include:
- MyStoreCredit - helps Sellers provide buyers with a positive experience through follow-up e-mails that include shopping rewards, such as a 10% off coupon on their next purchase.
- Outright – a free Web service that tracks all Seller income and expenses to get taxes done accurately and on time to help you avoid costly fines from the IRS.
- vzaar - allows Sellers to quickly and easily add video to their eBay listings for a more dynamic shopping experience.
- Read their, and other, Success Stories at:http://developer.ebay.com/programs/Success-Stories/home.html
Get started today! Review our documentation and see if this opportunity is a fit for you.
Grow with us in 2010!
Updates to Summer 2009 Release; Part 2 of 2.
Updates to Summer 2009 Release; Part 2 of 2.
On July 29, 2009, Laurel posted an announcement about the July 2009 updates. In this entry, we highlight part 2 of the features that were released since then
For the list of calls changed with each Trading API version, see the Trading API Release Notes.
Because there are many updates, the details have been split into two entries. The first part can be found here. This is the second entry and covers the following topics:
As a reminder, the first entry included: will link to part 1 entry.
If you would like the complete details on the July 2009 Update, please refer to the following links and to the API Release Notes.
- All features are not available to all Sellers, use the Trading call GeteBayDetails to find out which features are available for your site. As part of the seller release, some listing upgrades were removed for some sites, and some will be restricted to eBay Top-Rated Sellers or PowerSellers. The listing features include bold title, border, Featured First, Featured Plus!, gift icon, highlight, Homepage Featured, and ProPack. A new type, ListingFeatureDetails, has been added to the GeteBayDetails response that returns which listing features are available to the seller for the site. Another addition to the GeteBayDetails response, UpdateTime, reports the time of the most recent modification to any Detail.
- A type has been added to the Trading call ListingStartPriceDetailsType.MinBuyItNowPricePercent, which returns the minimum percentage difference between the start price and the Buy It Now price for a listing on the specified site. There is one exception: Use category details to find the percentage requirements for Motor Vehicles (using Site ID 100 - the eBay Motors site.)
- GetSellerEvents now returns variation details in Item.Variations, including StartPrice, Quantity, and QuantitySold, plus SKU and/or VariationSpecifics. Multiple variations are returned together in the same Variations node (similar to GetItem).
- To keep the GetSellerEvents response smaller, the variation specifics are not returned if the variation has a SKU.
- With RelistFixedPriceItem and ReviseFixedPriceItem, you can now use SKU to uniquely identify an existing variation, regardless of whether the listing has inventory tracking set to SKU.
- ReviseInventoryStatus now supports modifying variations when InventoryTrackingMethod is set to ItemID.
- For the site specified in the request, GeteBayDetails now returns variation constraints, such as maximum number of variations, in VariationDetails.
- GetUser now returns QualifiesForVariations (a boolean) to indicate whether the user is eligible to list with variations on the site specified in the request.
- In SetUserNotes, you can now set private notes for variations. These notes will be visible to the user for variations that are displayed in My eBay.
- GetMyeBayBuying and GetMyeBaySelling now return PrivateNotes for applicable variations. Depending on how the notes were set (what was specified in the SetUserNotes request), the variations may be returned within Variations or within Item
-  Shipping Insurance option has been removed from many sites. If shipping insurance is included in AddItem, it will be dropped with a warning, but won't fail. See the Release Notes.
-  Using My eBay, you can create an Exclude Ship-To List of the locations to where you will not ship items. Once set up, all items that you list on eBay will, by default, use the Exclude Ship-To List to exclude the locations you specified in the list. If a buyer's primary ship-to location is a location that you have listed as an excluded ship-to location (or if the buyer does not have a primary ship-to location), they will receive an error message if they attempt to buy or place a bid on your item. Use GetUserPreferences to review the default set of excluded locations that you have set up in My eBay. Use GetUserPreferences to retrieve your global exclusion list. See the Release Notes.
-  Tracking for multiple package shipment for a single item. ShippingCarrierUsed and ShipmentTrackingNumber have been moved to a repeatable ShipmentTrackingDetails container. See the Release Notes.
-  More shipping carriers supported. The type for ShipmentType.ShippingCarrierUsed has been changed from ShippingCarrierCodeType to string. This enables sellers to specify a shipping carrier (via CompleteSale) other than the ones noted in ShippingCarrierCodeType.
- With a request version lower than 627, the value you specify for CompleteSale's ShippingCarrierUsed must be a value found in ShippingCarrierCodeType. If the request version is 627 or higher, you can specify the shipping carrier of your choice, even if it is not in the ShippingCarrierCodeType list, and GetSellingManagerSaleRecord will return that value. See the Release Notes.
-  Local Pickup: Shipping Time DSRs ignored, Shipping and Handling Charges MAY be ignored.
- In the Trading API LeaveFeedback call, DSRs left for Shipping Time will be ignored for all Local Pickup transactions. DSRs left for Shipping and Handling Charges will be ignored for Local Pickup transactions where the seller did not add any special handling fees. See the Release Notes.
- This change affects the following eBay sites: AU, Mn-AT, BE-FR, BE-NL, CA, CA-FR, FR, DE, HK, IN, Mn-IE, IT, MY, Motors, NL, PH, PL, SG, ES, Mn-CH, UK, US
-  Seller Status Now Returned by GetSellerDashboard. See the Release Notes.
- Avoid 1s and 2s
- Only domestic DSRs count
- [629 ] Top-Rated Seller Details Available via GetUser and Other Calls; SellerInfo.SellerLevel to Be Removed
- When Top-Rated Seller details became available in October (see Announcement), GetUser began returning fields that identify the seller as a Top-Rated Seller and gave details about the Top-Rated Seller program. These fields are already present and documented for GetUser and other calls. They include TopRatedSeller and TopRatedSellerDetails.TopRatedProgram, which identifies the Top-Rated-Seller programs for which the seller is qualified. See the Release Notes.
- When the Top-Rated Seller feature became active on the US, DE, and UK sites, SellerInfo.SellerLevel no longer returned results for those sites. Affected calls include GetUser, GetBidderList, GetSellerList, GetItem, and GetItemTransactions.
More categories are becoming catalog-enabled
When Good Till Canceled (GTC) listings are renewed, they will be checked for Return Policy and Handling Time. If these details are not included, the GTC listing renewal will fail. For more info, see this entry in the Forum.
December 17, 2009 in Best Practices, Categories and Item Specifics, Certified Provider, Client Alerts API, Developer Community, Documentation, Finding API, Large Merchant Services, Merchandising API, Product News, Shopping API, Trading API | Permalink