"description":"The Selling Partner API for Easy Ship helps you build applications that help sellers manage and ship Amazon Easy Ship orders.\n\nYour Easy Ship applications can:\n\n* Get available time slots for packages to be scheduled for delivery.\n\n* Schedule, reschedule, and cancel Easy Ship orders.\n\n* Print labels, invoices, and warranties.\n\nSee the [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table) for the differences in Easy Ship operations by marketplace.",
"description":"Returns time slots available for Easy Ship orders to be scheduled based on the package weight and dimensions that the seller specifies.\n\nThis operation is available for scheduled and unscheduled orders based on marketplace support. See **Get Time Slots** in the [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table).\n\nThis operation can return time slots that have either pickup or drop-off handover methods - see **Supported Handover Methods** in the [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table).\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Returns information about a package, including dimensions, weight, time slot information for handover, invoice and item information, and status.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"operationId":"getScheduledPackage",
"parameters":[
{
"name":"amazonOrderId",
"in":"query",
"required":true,
"type":"string",
"minLength":1,
"maxLength":255,
"description":"An Amazon-defined order identifier. Identifies the order that the seller wants to deliver using Amazon Easy Ship."
},
{
"name":"marketplaceId",
"in":"query",
"required":true,
"type":"string",
"minLength":1,
"maxLength":255,
"description":"An identifier for the marketplace in which the seller is selling."
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Schedules an Easy Ship order and returns the scheduled package information.\n\nThis operation does the following:\n\n* Specifies the time slot and handover method for the order to be scheduled for delivery.\n\n* Updates the Easy Ship order status.\n\n* Generates a shipping label and an invoice. Calling `createScheduledPackage` also generates a warranty document if you specify a `SerialNumber` value. To get these documents, see [How to get invoice, shipping label, and warranty documents](doc:easyship-api-v2022-03-23-use-case-guide).\n\n* Shows the status of Easy Ship orders when you call the `getOrders` operation of the Selling Partner API for Orders and examine the `EasyShipShipmentStatus` property in the response body.\n\nSee the **Shipping Label**, **Invoice**, and **Warranty** columns in the [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table) to see which documents are supported in each marketplace.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Updates the time slot for handing over the package indicated by the specified `scheduledPackageId`. You can get the new `slotId` value for the time slot by calling the `listHandoverSlots` operation before making another `patch` call.\n\nSee the **Update Package** column in the [Marketplace Support Table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table) to see which marketplaces this operation is supported in.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"This operation automatically schedules a time slot for all the `amazonOrderId`s given as input, generating the associated shipping labels, along with other compliance documents according to the marketplace (refer to the [marketplace document support table](doc:easyship-api-v2022-03-23-use-case-guide#marketplace-support-table)).\n\nDevelopers calling this operation may optionally assign a `packageDetails` object, allowing them to input a preferred time slot for each order in ther request. In this case, Amazon will try to schedule the respective packages using their optional settings. On the other hand, *i.e.*, if the time slot is not provided, Amazon will then pick the earliest time slot possible. \n\nRegarding the shipping label's file format, external developers are able to choose between PDF or ZPL, and Amazon will create the label accordingly.\n\nThis operation returns an array composed of the scheduled packages, and a short-lived URL pointing to a zip file containing the generated shipping labels and the other documents enabled for your marketplace. If at least an order couldn't be scheduled, then Amazon adds the `rejectedOrders` list into the response, which contains an entry for each order we couldn't process. Each entry is composed of an error message describing the reason of the failure, so that sellers can take action.\n\nThe table below displays the supported request and burst maximum rates:\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 5 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](doc:usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Your rate limit (requests per second) for this operation.",
"type":"string"
},
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"400":{
"description":"Request has missing or invalid parameters and cannot be parsed.",
"x-amzn-api-sandbox":{
"static":[
{
"request":{
"parameters":{
"body":{
"value":{
"marketplaceId":"A2XZLSVIQ0F4JT",
"labelFormat":"ZPL"
}
}
}
},
"response":{
"errors":[
{
"code":"InvalidInput",
"message":"Request has missing or invalid parameters and cannot be parsed."
}
]
}
},
{
"request":{
"parameters":{
"body":{
"value":{
"marketplaceId":"an-invalid-marketplace-id",
"orderScheduleDetailsList":[
{
"amazonOrderId":"903-1713775-3598200"
}
]
}
}
}
},
"response":{
"errors":[
{
"code":"InvalidInput",
"message":"Request has missing or invalid parameters and cannot be parsed."
}
]
}
}
]
},
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"description":"Your rate limit (requests per second) for this operation.",
"type":"string"
},
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"401":{
"description":"The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"description":"Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.",
"type":"string"
},
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"403":{
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"404":{
"description":"The specified resource does not exist.",
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"type":"string",
"description":"Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"429":{
"description":"The frequency of requests was greater than allowed.",
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"description":"Your rate limit (requests per second) for this operation.",
"type":"string"
},
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"415":{
"description":"The request payload is in an unsupported format.",
"description":"Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned..",
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"description":"Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.",
"type":"string"
},
"x-amzn-RequestId":{
"type":"string",
"description":"Unique request reference ID."
}
}
},
"503":{
"description":"Temporary overloading or maintenance of the server.",
"schema":{
"$ref":"#/definitions/ErrorList"
},
"headers":{
"x-amzn-RateLimit-Limit":{
"description":"Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned.",
"description":"An Amazon-defined order identifier. Identifies the order that the seller wants to deliver using Amazon Easy Ship."
},
"Dimension":{
"description":"The numerical value of the specified dimension.",
"type":"number",
"format":"float",
"minimum":0.01
},
"Dimensions":{
"type":"object",
"description":"The dimensions of the scheduled package.",
"properties":{
"length":{
"description":"The length dimension.",
"$ref":"#/definitions/Dimension"
},
"width":{
"description":"The width dimension.",
"$ref":"#/definitions/Dimension"
},
"height":{
"description":"The height dimension.",
"$ref":"#/definitions/Dimension"
},
"unit":{
"$ref":"#/definitions/UnitOfLength"
},
"identifier":{
"description":"Identifier for custom package dimensions.",
"$ref":"#/definitions/String"
}
}
},
"ListHandoverSlotsRequest":{
"description":"The request schema for the `listHandoverSlots` operation.",
"type":"object",
"required":[
"marketplaceId",
"amazonOrderId",
"packageDimensions",
"packageWeight"
],
"properties":{
"marketplaceId":{
"$ref":"#/definitions/String"
},
"amazonOrderId":{
"$ref":"#/definitions/AmazonOrderId"
},
"packageDimensions":{
"$ref":"#/definitions/Dimensions"
},
"packageWeight":{
"$ref":"#/definitions/Weight"
}
}
},
"ListHandoverSlotsResponse":{
"description":"The response schema for the `listHandoverSlots` operation.",
"type":"object",
"required":[
"amazonOrderId",
"timeSlots"
],
"properties":{
"amazonOrderId":{
"$ref":"#/definitions/AmazonOrderId"
},
"timeSlots":{
"$ref":"#/definitions/TimeSlots"
}
}
},
"InvoiceData":{
"type":"object",
"description":"Invoice number and date.",
"required":[
"invoiceNumber"
],
"properties":{
"invoiceNumber":{
"description":"The invoice number.",
"$ref":"#/definitions/String"
},
"invoiceDate":{
"description":"The date that the invoice was generated.",
"$ref":"#/definitions/DateTime"
}
}
},
"Item":{
"description":"Item identifier and serial number information.",
"type":"object",
"properties":{
"orderItemId":{
"$ref":"#/definitions/OrderItemId"
},
"orderItemSerialNumbers":{
"$ref":"#/definitions/OrderItemSerialNumbers"
}
}
},
"Items":{
"description":"A list of items contained in the package.",
"type":"array",
"items":{
"$ref":"#/definitions/Item"
},
"maxItems":500
},
"OrderItemId":{
"type":"string",
"description":"The Amazon-defined order item identifier.",
"maxLength":255
},
"OrderItemSerialNumber":{
"description":"A serial number for an item associated with the `OrderItemId` value.",
"type":"string",
"maxLength":255
},
"OrderItemSerialNumbers":{
"type":"array",
"description":"A list of serial numbers for the items associated with the `OrderItemId` value.",
"items":{
"$ref":"#/definitions/OrderItemSerialNumber"
},
"maxItems":100
},
"Package":{
"description":"A package. This object contains all the details of the scheduled Easy Ship package including the package identifier, physical attributes such as dimensions and weight, selected time slot to handover the package to carrier, status of the package, and tracking/invoice details.",
"type":"object",
"required":[
"packageDimensions",
"packageTimeSlot",
"packageWeight",
"scheduledPackageId"
],
"properties":{
"scheduledPackageId":{
"$ref":"#/definitions/ScheduledPackageId"
},
"packageDimensions":{
"$ref":"#/definitions/Dimensions"
},
"packageWeight":{
"$ref":"#/definitions/Weight"
},
"packageItems":{
"$ref":"#/definitions/Items"
},
"packageTimeSlot":{
"$ref":"#/definitions/TimeSlot"
},
"packageIdentifier":{
"$ref":"#/definitions/PackageIdentifier"
},
"invoice":{
"$ref":"#/definitions/InvoiceData"
},
"packageStatus":{
"$ref":"#/definitions/PackageStatus"
},
"trackingDetails":{
"$ref":"#/definitions/TrackingDetails"
}
}
},
"Packages":{
"description":"A list of packages.",
"type":"object",
"required":[
"packages"
],
"properties":{
"packages":{
"type":"array",
"items":{
"$ref":"#/definitions/Package"
},
"maxItems":500,
"minItems":1
}
}
},
"PackageDetails":{
"description":"Package details. Includes `packageItems`, `packageTimeSlot`, and `packageIdentifier`.",
"description":"The request body for the POST /easyShip/2022-03-23/packages/bulk API.",
"type":"object",
"required":[
"marketplaceId",
"orderScheduleDetailsList",
"labelFormat"
],
"properties":{
"marketplaceId":{
"$ref":"#/definitions/String"
},
"orderScheduleDetailsList":{
"description":"An array allowing users to specify orders to be scheduled.",
"type":"array",
"items":{
"$ref":"#/definitions/OrderScheduleDetails"
},
"minItems":1
},
"labelFormat":{
"$ref":"#/definitions/LabelFormat"
}
}
},
"CreateScheduledPackagesResponse":{
"description":"The response schema for the bulk scheduling API. It returns by the bulk scheduling API containing an array of the scheduled packtages, an optional list of orders we couldn't schedule with the reason, and a pre-signed URL for a ZIP file containing the associated shipping labels plus the documents enabled for your marketplace.",
"type":"object",
"properties":{
"scheduledPackages":{
"description":"A list of packages. Refer to the `Package` object.",
"type":"array",
"items":{
"$ref":"#/definitions/Package"
},
"maxItems":100
},
"rejectedOrders":{
"description":"A list of orders we couldn't scheduled on your behalf. Each element contains the reason and details on the error.",
"type":"array",
"items":{
"$ref":"#/definitions/RejectedOrder"
}
},
"printableDocumentsUrl":{
"$ref":"#/definitions/URL"
}
}
},
"URL":{
"description":"A pre-signed URL for the zip document containing the shipping labels and the documents enabled for your marketplace.",
"type":"string"
},
"LabelFormat":{
"description":"The file format in which the shipping label will be created.",
"description":"The weight of the scheduled package",
"properties":{
"value":{
"$ref":"#/definitions/WeightValue"
},
"unit":{
"$ref":"#/definitions/UnitOfWeight"
}
}
},
"WeightValue":{
"description":"The weight of the package.",
"type":"number",
"format":"float",
"minimum":11.00
},
"ErrorList":{
"type":"object",
"description":"A list of error responses returned when a request is unsuccessful.",
"required":[
"errors"
],
"properties":{
"errors":{
"type":"array",
"items":{
"$ref":"#/definitions/Error"
}
}
}
},
"Error":{
"description":"Error response returned when the request is unsuccessful.",
"properties":{
"code":{
"description":"An error code that identifies the type of error that occurred.",
"type":"string"
},
"message":{
"description":"A message that describes the error condition.",
"type":"string"
},
"details":{
"description":"Additional details that can help the caller understand or fix the issue.",
"type":"string"
}
},
"required":[
"code",
"message"
],
"type":"object"
},
"Code":{
"description":"An error code that identifies the type of error that occurred. The error codes listed below are specific to the Easy Ship section.",
"type":"string",
"enum":[
"InvalidInput",
"InvalidTimeSlotId",
"ScheduledPackageAlreadyExists",
"ScheduleWindowExpired",
"RetryableAfterGettingNewSlots",
"TimeSlotNotAvailable",
"ResourceNotFound",
"InvalidOrderState",
"RegionNotSupported",
"OrderNotEligibleForRescheduling",
"InternalServerError"
],
"x-docgen-enum-table-extension":[
{
"value":"InvalidInput",
"description":"HTTP status code 400. Request has missing or invalid parameters and cannot be processed."
},
{
"value":"InvalidTimeSlotId",
"description":"HTTP status code 400. The specified time slot identifier is not valid."
},
{
"value":"ScheduledPackageAlreadyExists",
"description":"HTTP status code 400. The order has already been scheduled."
},
{
"value":"ScheduleWindowExpired",
"description":"HTTP status code 400. The selected time slot has expired. Try calling `listHandoverSlots` again to get a new time slot."
},
{
"value":"RetryableAfterGettingNewSlots",
"description":"HTTP status code 400. Order scheduling has failed because of an issue with the selected time slot. If you see this error, request a new time slot and try to schedule again."
},
{
"value":"TimeSlotNotAvailable",
"description":"HTTP status code 404. No time slot is available due to various factors such as: invalid weight and dimension parameters, or the available slots are only available after the expected cancellation date."
},
{
"value":"ResourceNotFound",
"description":"HTTP status code 404. The specified resource (for example, `amazonOrderId` or `marketplaceId`) does not exist."
},
{
"value":"InvalidOrderState",
"description":"HTTP status code 404. The request cannot be applied to the order in its current state. For example, you cannot cancel an order which has not yet been scheduled or which has already been canceled."
},
{
"value":"RegionNotSupported",
"description":"HTTP status code 404. Amazon Easy Ship is not supported in the specified marketplace."
},
{
"value":"OrderNotEligibleForRescheduling",
"description":"HTTP status code 405. Order is not eligible for rescheduling."
},
{
"value":"InternalServerError",
"description":"HTTP status code 500. There was an internal service failure."