Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Actions26

Shipment → Update Shipment Status

AI-generated

Overview

This node operation updates the status of a shipment in the Amazon Selling Partner API. It is useful for sellers who need to keep their shipment status current, such as marking shipments as ready for pickup, picked up, at destination, or delivered. For example, a seller can update the shipment status to 'Delivered' once the package reaches the customer, ensuring accurate tracking and order management.

Use Case Examples

  1. Updating shipment status to 'Picked Up' when the carrier collects the package.
  2. Marking a shipment as 'Delivered' after successful delivery to the customer.

Properties

Name Meaning
Order ID The Amazon-defined order identifier in 3-7-7 format, used to specify which order's shipment status to update.
Marketplace ID The marketplace where the shipment operation is performed, such as Amazon.com (US) or Amazon.co.uk (UK).
Status The current status of the shipment to update, such as Ready For Pickup, Picked Up, At Destination, or Delivered.

Output

JSON

  • orderId - The Amazon-defined order identifier for the shipment.
  • marketplaceId - The marketplace identifier where the shipment status was updated.
  • status - The updated status of the shipment.
  • updateTimestamp - Timestamp indicating when the shipment status was updated.

Dependencies

  • Amazon Selling Partner API credentials

Troubleshooting

  • Ensure the Order ID is in the correct 3-7-7 format to avoid validation errors.
  • Verify that the Marketplace ID matches the marketplace of the order to prevent mismatched data errors.
  • Check that the status value is one of the allowed options; invalid status values will cause the operation to fail.
  • Handle API rate limits and network errors gracefully, as these can cause temporary failures.

Links

Discussion