---
title: "updateFulfillmentOrder"
method: PUT
path: "/fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}"
tags: ["Fulfillment Outbound v2020-07-01"]
---

# updateFulfillmentOrder

`PUT /fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}`

Updates and/or requests shipment for a fulfillment order with an order hold on it.

**Usage Plan:**

| Rate (requests per second) | Burst |
| ---- | ---- |
| 2 | 30 |

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 have higher rate and burst values than those shown here. For more information, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).

## Path parameters

- `sellerFulfillmentOrderId` string, required

## Request body

- UpdateFulfillmentOrderRequest — The request body schema for the `updateFulfillmentOrder` operation.
  - `marketplaceId` string — The marketplace the fulfillment order is placed against.
  - `displayableOrderId` string — A fulfillment order identifier that the seller creates. This value displays as the order identifier in recipient-facing materials such as the outbound shipment packing slip. The value of `DisplayableOrderId` should match the order identifier that the seller provides to the recipient. The seller can use the `SellerFulfillmentOrderId` for this value or they can specify an alternate value if they want the recipient to reference an alternate order identifier.
  - `displayableOrderDate` string, date-time — Date-time formatted timestamp.
  - `displayableOrderComment` string — Order-specific text that appears in recipient-facing materials such as the outbound shipment packing slip.
  - `shippingSpeedCategory` 'Standard' | 'Expedited' | 'Priority' | 'ScheduledDelivery' — The shipping method used for the fulfillment order. When this value is `ScheduledDelivery`, choose `Ship` for the `fulfillmentAction`. `Hold` is not a valid `fulfillmentAction` value when the `shippingSpeedCategory` value is `ScheduledDelivery`. Note: Shipping method service level agreements vary by marketplace. Sellers should refer to the [Seller Central](https://developer-docs.amazon.com/sp-api/docs/seller-central-urls) website in their marketplace for shipping method service level agreements and fulfillment fees.
  - `destinationAddress` Address — Address of the party.
    - `name` string, required — The name of the person, business or institution at that address.
    - `addressLine1` string, required — First line of the address.
    - `addressLine2` string — Additional street address information, if required.
    - `addressLine3` string — Additional street address information, if required.
    - `city` string — The city where the person, business or institution is located.
    - `county` string — The county where person, business or institution is located.
    - `district` string — The district where person, business or institution is located.
    - `stateOrRegion` string — The state or region where person, business or institution is located.
    - `postalCode` string — The postal code of that address. It contains a series of letters or digits or both, sometimes including spaces or punctuation.
    - `countryCode` string, required — The two digit country code in ISO 3166-1 alpha-2 format.
    - `phone` string — The phone number of the person, business or institution located at that address.
  - `fulfillmentAction` 'Ship' | 'Hold' — Specifies whether the fulfillment order should ship now or have an order hold put on it.
  - `fulfillmentPolicy` 'FillOrKill' | 'FillAll' | 'FillAllAvailable' — The `FulfillmentPolicy` value specified when you called the `createFulfillmentOrder` operation.
  - `shipFromCountryCode` string — The two-character country code for the country from which the fulfillment order ships. Must be in ISO 3166-1 alpha-2 format.
  - `notificationEmails` string[] — A list of email addresses that the seller provides that are used by Amazon to send ship-complete notifications to recipients on behalf of the seller.
  - `featureConstraints` FeatureSettings[] — A list of features and their fulfillment policies to apply to the order.
    - `featureName` string — The name of the feature. Valid feature names are: - `BLOCK_AMZL`: Blocks orders from being shipped using Amazon Logistics (AMZL). - Note: Using this feature will incur additional fee surcharges on MCF orders and may increase the risk of unfulfilled or delayed deliveries if alternative carriers are unavailable. Using `BLOCK_AMZL` in an order request will take precedence over your Seller Central account setting. - `BLANK_BOX`: Ships orders in non-Amazon branded packaging (blank boxes). - `OVERBOX`: Requires items to be shipped in an overbox rather than in their original product packaging. - `PACKING_SLIP`: Requires a packing slip to be included with the order. - `SIGNATURE_CONFIRMATION`: Requires a signature from the recipient upon delivery. - Note: Using signature confirmation features will incur additional fees on MCF orders and are currently supported only in the US marketplace.
    - `featureFulfillmentPolicy` 'Required' | 'NotRequired' — Specifies the policy to use when fulfilling an order.
  - `items` UpdateFulfillmentOrderItem[] — An array of fulfillment order item information for updating a fulfillment order.
    - `sellerSku` string — The seller SKU of the item.
    - `sellerFulfillmentOrderItemId` string, required — Identifies the fulfillment order item to update. Created with a previous call to the `createFulfillmentOrder` operation.
    - `quantity` integer, required — The item quantity.
    - `giftMessage` string — A message to the gift recipient, if applicable.
    - `displayableComment` string — Item-specific text that displays in recipient-facing materials such as the outbound shipment packing slip.
    - `fulfillmentNetworkSku` string — Amazon's fulfillment network SKU of the item.
    - `orderItemDisposition` string — Indicates whether the item is sellable or unsellable.
    - `perUnitDeclaredValue` Money — An amount of money, including units in the form of currency.
      - `currencyCode` string, required — Three digit currency code in ISO 4217 format.
      - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
    - `perUnitPrice` Money — An amount of money, including units in the form of currency.
      - `currencyCode` string, required — Three digit currency code in ISO 4217 format.
      - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.
    - `perUnitTax` Money — An amount of money, including units in the form of currency.
      - `currencyCode` string, required — Three digit currency code in ISO 4217 format.
      - `amount` string, required — A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. <br>**Pattern** : `^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$`.

## Response `200`

Success.

- UpdateFulfillmentOrderResponse — The response schema for the `updateFulfillmentOrder` operation.
  - `errors` Error[] — A list of error responses returned when a request is unsuccessful.
    - `code` string, required — An error code that identifies the type of error that occurred.
    - `message` string, required — A message that describes the error condition.
    - `details` string — Additional details that can help the caller understand or fix the issue.

## Other responses

- `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 specified resource does not exist.
- `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.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)