Easy Ship API
Learn how to use the Easy Ship API.
Learn how to use the Selling Partner API for Easy Ship to build applications for sellers to manage and ship packages for Amazon Easy Ship orders.
Key Features
- Get available time slots.
- Schedule and reschedule Easy Ship packages for Easy Ship orders.
- Print shipping labels, invoices, and warranty documents.
Release notes
To learn more about the terms that are used in this guide, refer to Terminology.
Easy Ship workflow
The following diagram shows the steps to ship an Easy Ship order.
Detect new orders with the
ORDER_CHANGE notification or batch process▼
Call
getOrder or getOrderItems to retrieve the unshipped Easy Ship orders▼
▼
▼
▼
Call
createFeed to request an Easy Ship feed document (POST_EASY_SHIP_DOCUMENTS). Specify the warranty document if required▼
▼
Use cases
The following use case examples are available for the Easy Ship API v2022-03-23:
- Schedule an Easy Ship package
- Reschedule an Easy Ship package
- Check the status of an Easy Ship package
- Find order items that require serial numbers
- Get shipping labels, invoice, and warranty documents
Roles
createScheduledPackage
| Attribute | Value |
|---|---|
| Regions | NA, EU, FE |
| Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
createScheduledPackageBulk
| Attribute | Value |
|---|---|
| Regions | NA, EU, FE |
| Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
getScheduledPackage
| Attribute | Value |
|---|---|
| Regions | NA, EU, FE |
| Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
listHandoverSlots
| Attribute | Value |
|---|---|
| Regions | NA, EU, FE |
| Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
updateScheduledPackages
| Attribute | Value |
|---|---|
| Regions | NA, EU, FE |
| Required roles (need at least one) | Direct to Consumer Shipping (Restricted) |
Marketplace support
Easy Ship operations are only available in select marketplaces and support for specific operations varies in each marketplace. Refer to the following table for marketplace supported operations.
| Marketplace | Region | Supported handover methods | Get time slots | Create package | Update package | Get package status | Shipping label | Invoice | Warranty | Bulk Package Scheduling |
|---|---|---|---|---|---|---|---|---|---|---|
| Mexico | NA | Pickup and Dropoff | Unscheduled orders only | Supported | Not supported | Supported | Supported | Not supported | Not supported | Not supported |
| India | EU | Pickup only | Scheduled and unscheduled Orders | Supported | Supported | Supported | Supported | Supported | Supported | Not supported |
| Turkey | EU | Pickup and Dropoff | Unscheduled orders only | Supported | Not supported | Supported | Supported | Not supported | Not supported | Not supported |
| Australia | FE | Pickup only | Unscheduled orders only | Supported | Not supported | Supported | Supported | Not supported | Not supported | Not supported |
| Singapore | FE | Pickup only | Unscheduled orders only | Supported | Not supported | Supported | Supported | Not supported | Not supported | Not supported |
| Japan | FE | Pickup only | Unscheduled orders only | Supported | Not supported | Supported | Supported | Not supported | Not supported | Not supported |
| The Netherlands | EU | Dropoff only | Not supported | Not supported | Not supported | Not supported | Not supported | Not supported | Not supported | Supported |
| Poland | EU | Pickup only | Not supported | Not supported | Not supported | Not supported | Not supported | Not supported | Not Supported | Supported |
Updated about 4 hours ago