Update fulfillment status (Amazon v2)

Update Fulfillment Status

This endpoint allows you to update the status of a specific order fulfillment via API.

Purpose

Use this endpoint when the shipment status is not being correctly updated automatically by Amazon.

Request Parameters

• orderId (path parameter): The unique identifier of the order whose fulfillment status needs to be updated.

• id (path parameter): For this specific request, the provided ID can be any value (e.g. "123").

  • This is required only to maintain our standard API structure.

  • Amazon does not identify fulfillment IDs nor does it react to package.id references when updating the status of a fulfillment tied to an order.

Body Parameters

Body Parameters

• status.status: Valid values supported by Amazon for fulfillment status updates:

  • ReadyForPickup

  • PickedUp

  • RefusedPickup

• items (optional): An array of objects representing the products to be updated.

  • Not required.

  • Use this parameter only if you want to update the status of specific products.

Rate Limit

The request body should be structured as follows:

{
    "fulfillment": {
        "status": {
            "status": "ReadyForPickup"
        },
        "items": [
            {
                "id": "string", //The unique identifier for the item being fulfilled
                "quantity": "integer" // The quantity of the item being fulfilled
            }
        ]
    }
}