You are here: Sell APIs > Fulfillment API > Release Notes

Fulfillment API release notes

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

The API release history

The following table lists the releases for the Fulfillment API:

Version

Release Date

Summary of Release

Version 1.2.0

2017-06-12

New fields to support line item delivery timing

Version 1.1.0

2017-01-25

Minor update

Version 1.0.0

2016-10-19 Initial release of Version 1.0.0

Version 1.2.0

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

API updates

This API release contains the following updates and changes:

Changed Calls

Schema changes

New fields to support line item delivery timing

The getOrders and getOrder calls now return the lineItemFulfillmentInstructions container, which supports handling and delivery timing when fulfilling a line item.

Announcements

Coming soon: eBay Guaranteed Delivery

Later in Summer 2017, eBay will introduce the eBay Guaranteed Delivery program. Sellers who opt in will be able to guarantee the delivery date of an item based on the following criteria:

  • The item is of a type, size, weight, and location defined by the seller as available for eBay Guaranteed Delivery in a shipping rate table.
  • The seller is offering the item with eBay Guaranteed Delivery.
  • The buyer is located in a destination region that can be shipped to within the delivery window of at least one shipping service category (e.g. One-day, Expedited, Standard, or Economy) for which eBay Guaranteed Delivery is offered by the seller for the item.

Sellers will be able to choose to support the entire handling and delivery timing door-to-door, or just the handling period (same-day or one-day). In the latter case, eBay will determine and guarantee the actual delivery date on behalf of the seller, and will take responsibility for that guarantee.

The Fulfillment API will provide fields that assist sellers in determining the handling and shipping requirements and status of purchased Guaranteed Delivery line items.

Version 1.1.0

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

API updates

This API release contains the following updates and changes:

Changed Call

Schema changes

Additional enforcement for order search date range

Two of the available criteria for the getOrders call's filter parameter are date ranges: creationdate and lastmodifieddate. The call can return several error codes for dates that don't comply with the permitted date ranges for these criteria. A new error code has been added:

Code

Domain

Category

Nature

Meaning

30850

API_FULFILLMENT

REQUEST

ERROR

Start and end dates can't be in the future

Documentation changes and errata

Orders requiring upfront payment must be paid to be fulfilled

This documentation previously stated that the Fulfillment API covers transactions that have completed the checkout process. The documentation has been updated to clarify that this includes all paid purchases and purchases that do not require upfront payment (e.g., COD), but does not include pending payment purchases that require upfront payment before shipment.

Version 1.0.0

This is the initial release of the Fulfillment API, Version 1.0.0. For a list of the new calls, see the Fulfillment API Reference.

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

Documentation changes and errata

Creating a shipping fulfillment can occasionally fail

The createShippingFulfillment call can occasionally return an HTTP 500 error due to an internal server issue. However, in some cases this call may succeed if you issue it once more after receiving this error.

getOrders call does not return cancellation requests

Currently, for the getOrders call, the cancelStatus.cancelRequests array is returned but is always empty. To retrieve any active cancellation requests for an order, you must use the getOrder call.