updateScheduledPackages

patch https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/package

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.

See the Update Package column in the Marketplace Support Table to see which marketplaces this operation is supported in.

Usage Plan:

Rate (requests per second)	Burst
1	5

The 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.

200

Success

Response body

object

packages

array of objects

required

length between 1 and 500

A list of packages.

packages*

object

scheduledPackageId

object

required

Identifies the scheduled package to be updated.

packageDimensions

object

required

The dimensions of the scheduled package.

packageWeight

object

required

The weight of the scheduled package

packageItems

array of objects

length ≤ 500

A list of items contained in the package.

packageItems

object

orderItemId

string

length ≤ 255

The Amazon-defined order item identifier.

orderItemSerialNumbers

array of strings

length ≤ 100

A list of serial numbers for the items associated with the OrderItemId value.

orderItemSerialNumbers

packageTimeSlot

object

required

A time window to hand over an Easy Ship package to Amazon Logistics.

packageIdentifier

string

Optional seller-created identifier that is printed on the shipping label to help the seller identify the package.

invoice

object

Invoice number and date.

packageStatus

string

The status of the package.

ReadyForPickup PickedUp AtOriginFC AtDestinationFC Delivered Rejected Undeliverable ReturnedToSeller LostInTransit LabelCanceled DamagedInTransit OutForDelivery

Show Details

ReadyForPickup	The package is ready for pickup.
PickedUp	The package has been picked up.
AtOriginFC	The package is at its origin fulfillment center.
AtDestinationFC	The package is at its destination fulfillment center.
Delivered	The package has been delivered.
Rejected	The package has been rejected.
Undeliverable	The package is not deliverable.
ReturnedToSeller	The package has been returned to the seller.
LostInTransit	The package has been lost in transit.
LabelCanceled	The package's label has been canceled.
DamagedInTransit	The package has been damaged in transit.
OutForDelivery	The package is out for delivery.

trackingDetails

object

Representation of tracking metadata.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

400

Request has missing or invalid parameters and cannot be parsed.

401

The request's Authorization header is not formatted correctly or does not contain a valid token.

403

Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404

The resource specified does not exist.

413

The request size exceeded the maximum accepted size.

415

The request payload is in an unsupported format.

429

The frequency of requests was greater than allowed.

500

An unexpected condition occurred that prevented the server from fulfilling the request.

503

Temporary overloading or maintenance of the server.

xxxxxxxxxx
curl --request PATCH \
     --url https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/package \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "updatePackageDetailsList": [
    {
      "packageTimeSlot": {
        "handoverMethod": "Pickup"
      }
    }
  ]
}
'

xxxxxxxxxx
}
{
  "packages": [
    {
      "scheduledPackageId": {
        "amazonOrderId": "string",
        "packageId": "string"
      },
      "packageDimensions": {
        "length": 0,
        "width": 0,
        "height": 0,
        "unit": "Cm",
        "identifier": "string"
      },
      "packageWeight": {
        "value": 0,
        "unit": "Grams"
      },
      "packageItems": [
        {
          "orderItemId": "string",
          "orderItemSerialNumbers": [
            "string"
          ]
        }

200Success

400Request has missing or invalid parameters and cannot be parsed.

401The request's Authorization header is not formatted correctly or does not contain a valid token.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.