Update fulfillment (Amazon v2)

Fulfillment update for an Order

This endpoint allows you to update the the fulfillment details for a specific order identified by orderId. It posts information about the package, tracking details, items included in the fulfillment, and the location associated with the fulfillment.

Purpose

The purpose of this request is to provide the necessary details for fulfilling an order, including the package information, tracking number, shipping company, and items being shipped.

Request Parameters

• orderId (path parameter): The unique identifier of the order for which fulfillment details are being processed.

Package ID Handling

When creating or updating a fulfillment, it is now possible to include a package.id.

Requirements

• The package.id must be stored in order to perform a future Update Fulfillment request.

• For the update to succeed, the orderId, package.id, orderItem, and quantity must be consistent with the initial POST request.

Important Notes

• Once the fulfillment is posted, the package.id value cannot be retrieved via API, as Amazon does not provide any endpoint to fetch it later.

• We strongly recommend saving this ID immediately after posting a fulfillment.

• Failure to store this value may result in being unable to update shipment information later on.

Rate Limit

Expected Input Structure

The request body should be structured as follows:

{
    "fulfillment": {
        "package": {
            "id": "string" // Required. Use this package identifier to update
        },
        "tracking": {
            "number": "string", // Required. The tracking number for the shipment
            "companyId": "string" //Required.  The identifier codee for the shipping company
        },
        "items": [
            {
                "id": "string", //  Required. The unique identifier for the item being fulfilled
                "quantity": "integer" // Required. The quantity of the item being fulfilled
            }
        ]
    }
}

Valid companyId values for Amazon carriers

Refer to the extensive list of valid companyId values provided in the documentation to ensure that the correct shipping company identifier is used.