inventory APIv1.5.0

Inventory API release notes

Just getting started with the Inventory API? See the following documents for details on using this API:

The API release history

The following table lists the releases for the Inventory API:

Release Version

Release Date

Description of Release

Version 1.5.0

2017-09-15 Minor release

Version 1.4.0

2017-08-21 Minor release

Version 1.3.0

2017-07-21 Minor release

Version 1.2.0

2017-06-15 Minor release

Version 1.1.0

2017-01-26 Minor release

Version 1.0.0

2016-10-19 Initial API release

Version 1.5.0

The following sections detail the updates that have been made for this release.

New Call

The publishOfferByInventoryItemGroup call was added in Version 1.5.0. This call allows the seller to publish all offers associated with an inventory item group with one API call. Previously, the user had to use a publishOffer call for each variation in the multiple-variation listing, with the first publishOffer call creating the listing with that first variation, and each subsequent publishOffer call would revise that existing listing with the next variation in the group. For the publishOfferByInventoryItemGroup call to be successful, all offers associated with the inventory items in the group must be valid. If one of those offers is not valid, the publishOfferByInventoryItemGroup call will fail.

Schema Changes

The PublishByInventoryItemGroupRequest type was added in 1.5.0 to support the new publishOfferByInventoryItemGroup call.

Version 1.4.0

The following sections detail the updates that have been made for this release.

Schema Changes

The groupIds array was added to the InventoryItem type. This array will be returned by the getInventoryItem and getInventoryItems calls for inventory items that are members of an inventory item group.

The epid field was added to the Product type. However, this field is for future use, and will be ignored if used. Once this field does become available, the seller will be able to pass in an eBay Product Identifier (EPID) value, and if this identifier is matched to a product in the eBay catalog, listing details will be automatically picked up for the inventory item record.

Version 1.3.0

The following sections detail the updates that have been made for this release.

New Calls

The withdrawOffer call was added in Version 1.3.0. This call allows the seller to end an eBay listing that is associated with the specified offer. This call is used in place of the deleteOffer call if the seller only wants to end the listing associated with the offer but does not want to delete the offer object. With this call, the offer object remains, but it goes into the unpublished state, and will require a publishOffer call to relist the offer.

Schema Changes

The WithdrawResponse type was added in 1.3.0 to support the new withdrawOffer call.

New Features

Real-time Inventory Check functionality added to the Inventory API. With this functionality, the merchant enables and provides an API endpoint to eBay, and eBay will make a call to this endpoint at checkout to verify that adequate quantity exists to fulfill the order for an inventory item. In the request payload of this call to the merchant, eBay sends the inventory location, the SKU value, the fulfillment type, and the requested quantity, and then the response from the merchant will include a boolean to indicate if adequate quantity exists, a timestamp for the inventory check, and the total available quantity for the inventory item.

Version 1.2.0

The following sections detail the updates that have been made for this release.

New Calls

The bulkMigrateListings call was added in Version 1.2.0. This call allows the seller to convert active eBay listings into the corresponding Inventory API objects. A successful migration will allow the seller to manage their inventory and offers within the Inventory API.

Schema Changes

All schema changes for 1.2.0 involve the new bulkMigrateListings call. The new types include:

  • BulkMigrateListing
  • MigrateListing
  • BulkMigrateListingResponse
  • MigrateListingResponse
  • InventoryItemListing

Version 1.1.0

The following sections detail the updates that have been made for this release. Note that Version 1.1.0 changes are isolated to the inventory location calls.

Schema Changes

Although there were no interface name changes, a new type named LocationDetails was added. The location field in the Create Inventory Location call request now uses the LocationDetails type instead of the Location type. However, the Location type is still used by the responses of the Get Inventory Location and Get Inventory Locations calls.

Documentation Changes and Errata

Although the locationId field was already be returned in the responses of the Get Inventory Location and Get Inventory Locations calls, this field was missing from the Inventory API Call Reference documentation. With this release, the field has been added to the documentation.

Error Code Changes

The following table shows the error code changes that have been made for each inventory location API call:

Call

Error Code Changes(s)

createInventoryLocation

Error code 25803 was added

Error code 25800 replaces error code 25400

Error code 25801 replaces error code 25401

deleteInventoryLocation

Error code 25805 replaces error code 25404

disableInventoryLocation

Error code 25805 replaces error code 25404

enableInventoryLocation

Error code 25805 replaces error code 25404

getInventoryLocation

Error code 25805 replaces error code 25404

getInventoryLocations

No error code changes

updateInventoryLocation

Error code 25800 replaces error code 25400

Error code 25801 replaces error code 25401

Error code 25805 replaces error code 25404

Version 1.0.0

This is the initial release of the Inventory API, Version 1.0.0

For a list of the new calls, see the Inventory API Call Reference.