Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Overview

This node interacts with the Amazon Selling Partner API to update the status of shipments for orders on Amazon marketplaces. It is useful for sellers who need to programmatically update shipment statuses such as 'Ready For Pickup', 'Picked Up', 'At Destination', or 'Delivered' for their orders across various Amazon marketplaces. For example, a seller can automate the process of marking an order as 'Delivered' once the shipment reaches the customer, improving order tracking and customer communication.

Use Case Examples

  1. Update the shipment status of an order to 'Picked Up' when the carrier collects the package.
  2. Set the shipment status to 'Delivered' after confirming the delivery to the customer.
  3. Mark a shipment as 'Ready For Pickup' when the package is prepared and ready for carrier pickup.

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 Amazon marketplace where the order was placed, used to route the shipment status update to the correct regional marketplace.
Status The new status to set for the shipment, indicating its current stage such as 'Ready For Pickup', 'Picked Up', 'At Destination', or 'Delivered'.

Output

JSON

  • orderId - The identifier of the order whose shipment status was updated.
  • marketplaceId - The marketplace where the shipment status update was applied.
  • status - The updated status of the shipment.
  • updateTimestamp - Timestamp indicating when the shipment status was updated.

Dependencies

  • Amazon Selling Partner API
  • API authentication credentials (e.g., API key or token)

Troubleshooting

  • Ensure the provided Order ID is in the correct 3-7-7 format as required by Amazon.
  • Verify that the Marketplace ID matches the marketplace where the order was placed.
  • Check that the API credentials are valid and have the necessary permissions to update shipment statuses.
  • Common error messages may include authorization errors if credentials are invalid, or validation errors if required parameters are missing or incorrectly formatted.

Links

Discussion