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 eBay Guaranteed Delivery by providing guidance for handling and delivery timing when fulfilling a line item. It also provides such information for non-guaranteed delivery. For details, see the documentation for the LineItemFulfillmentInstructions type.

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). With the handling-period-only option, eBay will determine and guarantee the actual delivery date on behalf of the seller, and will take responsibility for that guarantee.

The Fulfillment API now provides the lineItemFulfillmentInstructions container, with fields that assist sellers to determine the handling and shipping time requirements and the status of purchased Guaranteed Delivery line items.

Note: eBay Guaranteed Delivery is being rolled out in phases.

In phase one, the new lineItemFulfillmentInstructions container is now available so you can plan your application development to incorporate it. Until phase three, the boolean guaranteedDelivery field will return a value of false.

In phase two (planned for August 2nd), sellers will be able to opt in to the eBay Guaranteed Delivery program and use new shipping rate tables to define which items they plan to offer with Guaranteed Delivery. They will also be able to define their work week, and the handling cutoff time for each day of the work week.

In phase three (planned for September 20th), you will be able to use the Account API to retrieve the new rate tables and define fulfillment policies that incorporate Guaranteed Delivery into listings specified by your sellers. Buyers will then see and be able to take advantage of the Guaranteed Delivery option for those listings.

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.