UpdateFulfillmentOrderRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-seller-central/main/json-schema/amazon-seller-central-update-fulfillment-order-request-schema.json",
  "title": "UpdateFulfillmentOrderRequest",
  "description": "The request body schema for the `updateFulfillmentOrder` operation.",
  "x-generated": "2026-09-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-seller-central-fbaoutbound-api-openapi.yml#/components/schemas/UpdateFulfillmentOrderRequest",
  "type": "object",
  "properties": {
    "marketplaceId": {
      "type": "string",
      "description": "The marketplace the fulfillment order is placed against."
    },
    "displayableOrderId": {
      "type": "string",
      "description": "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.",
      "maxLength": 40
    },
    "displayableOrderDate": {
      "description": "The date and time of the fulfillment order. Displays as the order date in recipient-facing materials such as the outbound shipment packing slip.",
      "$ref": "#/$defs/Timestamp"
    },
    "displayableOrderComment": {
      "type": "string",
      "description": "Order-specific text that appears in recipient-facing materials such as the outbound shipment packing slip.",
      "maxLength": 750
    },
    "shippingSpeedCategory": {
      "$ref": "#/$defs/ShippingSpeedCategory"
    },
    "destinationAddress": {
      "description": "The destination address for the fulfillment order.",
      "$ref": "#/$defs/Address"
    },
    "fulfillmentAction": {
      "$ref": "#/$defs/FulfillmentAction"
    },
    "fulfillmentPolicy": {
      "$ref": "#/$defs/FulfillmentPolicy"
    },
    "shipFromCountryCode": {
      "type": "string",
      "description": "The two-character country code for the country from which the fulfillment order ships. Must be in ISO 3166-1 alpha-2 format."
    },
    "notificationEmails": {
      "$ref": "#/$defs/NotificationEmailList"
    },
    "featureConstraints": {
      "type": "array",
      "description": "A list of features and their fulfillment policies to apply to the order.",
      "items": {
        "$ref": "#/$defs/FeatureSettings"
      }
    },
    "items": {
      "description": "A list of items to include in the fulfillment order preview, including quantity.",
      "$ref": "#/$defs/UpdateFulfillmentOrderItemList"
    }
  },
  "$defs": {
    "Address": {
      "type": "object",
      "required": [
        "addressLine1",
        "countryCode",
        "name",
        "postalCode"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The name of the person, business or institution at the address."
        },
        "addressLine1": {
          "type": "string",
          "description": "The first line of the address."
        },
        "addressLine2": {
          "type": "string",
          "description": "Additional address information, if required."
        },
        "addressLine3": {
          "type": "string",
          "description": "Additional address information, if required."
        },
        "city": {
          "type": "string",
          "description": "The city where the person, business, or institution is located. This property is required in all countries except Japan. It should not be used in Japan."
        },
        "districtOrCounty": {
          "type": "string",
          "description": "The district or county where the person, business, or institution is located."
        },
        "stateOrRegion": {
          "type": "string",
          "description": "The state or region where the person, business or institution is located."
        },
        "postalCode": {
          "type": "string",
          "description": "The postal code of the address."
        },
        "countryCode": {
          "type": "string",
          "description": "The two digit country code. In ISO 3166-1 alpha-2 format."
        },
        "phone": {
          "type": "string",
          "description": "The phone number of the person, business, or institution located at the address."
        }
      },
      "description": "A physical address."
    },
    "Decimal": {
      "type": "string",
      "description": "A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation."
    },
    "FeatureSettings": {
      "type": "object",
      "properties": {
        "featureName": {
          "type": "string",
          "description": "The name of the feature. Valid feature names are:\n\n- `BLOCK_AMZL`: Blocks orders from being shipped using Amazon Logistics (AMZL).\n  - 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.\n- `BLANK_BOX`: Ships orders in non-Amazon branded packaging (blank boxes).\n- `OVERBOX`: Requires items to be shipped in an overbox rather than in their original product packaging.\n- `PACKING_SLIP`: Requires a packing slip to be included with the order.\n- `SIGNATURE_CONFIRMATION`: Requires a signature from the recipient upon delivery. \n  - Note: Using signature confirmation features will incur additional fees on MCF orders and are currently supported only in the US marketplace."
        },
        "featureFulfillmentPolicy": {
          "type": "string",
          "description": "Specifies the policy to use when fulfilling an order.",
          "enum": [
            "Required",
            "NotRequired"
          ],
          "x-docgen-enum-table-extension": [
            {
              "value": "Required",
              "description": "If the offer can't be shipped with the selected feature, reject the order."
            },
            {
              "value": "NotRequired",
              "description": "The feature is not required for shipping."
            }
          ]
        }
      },
      "description": "Feature settings allows you to apply fulfillment features to an order. To block an order from being shipped using Amazon Logistics (AMZL) and an AMZL tracking number, set `featureName` to `BLOCK_AMZL` and `featureFulfillmentPolicy` to `Required`. Blocking AMZL will incur an additional fee surcharge on your MCF orders and increase the risk of some of your orders being unfulfilled or delivered late if there are no alternative carriers available. Using `BLOCK_AMZL` in an order request will take precedence over your Seller Central account setting. To ship in non-Amazon branded packaging (blank boxes), set `featureName` to `BLANK_BOX`. To require items to be shipped in an overbox rather than in their original product packaging, set `featureName` to `OVERBOX`. To require a packing slip to be included with the order, set `featureName` to `PACKING_SLIP`. To require a signature from the recipient upon delivery, set `featureName` to `SIGNATURE_CONFIRMATION`. Note that using signature confirmation features will incur additional fees on MCF orders and are currently supported only in the US marketplace. To ensure all items in an order are delivered together, set `featureName` to `DELIVER_TOGETHER`."
    },
    "FulfillmentAction": {
      "type": "string",
      "description": "Specifies whether the fulfillment order should ship now or have an order hold put on it.",
      "enum": [
        "Ship",
        "Hold"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "Ship",
          "description": "The fulfillment order ships now."
        },
        {
          "value": "Hold",
          "description": "An order hold is put on the fulfillment order."
        }
      ]
    },
    "FulfillmentPolicy": {
      "type": "string",
      "description": "The `FulfillmentPolicy` value specified when you called the `createFulfillmentOrder` operation.",
      "enum": [
        "FillOrKill",
        "FillAll",
        "FillAllAvailable"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "FillOrKill",
          "description": "If an item in a fulfillment order is determined to be unfulfillable before any shipment in the order has acquired the status of Pending (the process of picking units from inventory has begun), then the entire order is considered unfulfillable. However, if an item in a fulfillment order is determined to be unfulfillable after a shipment in the order has acquired the status of Pending, Amazon cancels as much of the fulfillment order as possible. Refer to the `FulfillmentShipment` object for shipment status definitions."
        },
        {
          "value": "FillAll",
          "description": "All fulfillable items in the fulfillment order are shipped. The fulfillment order remains in a processing state until all items are either shipped by Amazon or cancelled by the seller. **Note:** The `Hold` state overrides the `FillAll` fulfillment policy. `Hold` orders are automatically canceled after 14 days. If you use the `FillAll` policy with the `Ship` state, and there are unshipped items, then the order becomes `Unfulfillable` or `CompletePartialled` after 24 hours."
        },
        {
          "value": "FillAllAvailable",
          "description": "All fulfillable items in the fulfillment order are shipped. All unfulfillable items in the order are cancelled."
        }
      ]
    },
    "Money": {
      "type": "object",
      "required": [
        "currencyCode",
        "value"
      ],
      "properties": {
        "currencyCode": {
          "type": "string",
          "description": "Three digit currency code in ISO 4217 format."
        },
        "value": {
          "$ref": "#/$defs/Decimal"
        }
      },
      "description": "An amount of money, including units in the form of currency."
    },
    "NotificationEmailList": {
      "type": "array",
      "description": "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.",
      "items": {
        "type": "string",
        "maxLength": 64
      }
    },
    "Quantity": {
      "type": "integer",
      "format": "int32",
      "description": "The item quantity."
    },
    "ShippingSpeedCategory": {
      "type": "string",
      "description": "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`.\nNote: 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.",
      "enum": [
        "Standard",
        "Expedited",
        "Priority",
        "ScheduledDelivery"
      ],
      "x-docgen-enum-table-extension": [
        {
          "value": "Standard",
          "description": "Standard shipping method."
        },
        {
          "value": "Expedited",
          "description": "Expedited shipping method."
        },
        {
          "value": "Priority",
          "description": "Priority shipping method."
        },
        {
          "value": "ScheduledDelivery",
          "description": "Scheduled Delivery shipping method. This is only available in the JP marketplace."
        }
      ]
    },
    "Timestamp": {
      "description": "Date timestamp",
      "type": "string",
      "format": "date-time"
    },
    "UpdateFulfillmentOrderItem": {
      "type": "object",
      "required": [
        "quantity",
        "sellerFulfillmentOrderItemId"
      ],
      "properties": {
        "sellerSku": {
          "type": "string",
          "description": "The seller SKU of the item."
        },
        "sellerFulfillmentOrderItemId": {
          "type": "string",
          "description": "Identifies the fulfillment order item to update. Created with a previous call to the `createFulfillmentOrder` operation.",
          "maxLength": 50
        },
        "quantity": {
          "$ref": "#/$defs/Quantity"
        },
        "giftMessage": {
          "type": "string",
          "description": "A message to the gift recipient, if applicable.",
          "maxLength": 512
        },
        "displayableComment": {
          "type": "string",
          "description": "Item-specific text that displays in recipient-facing materials such as the outbound shipment packing slip.",
          "maxLength": 250
        },
        "fulfillmentNetworkSku": {
          "type": "string",
          "description": "Amazon's fulfillment network SKU of the item."
        },
        "orderItemDisposition": {
          "type": "string",
          "description": "Indicates whether the item is sellable or unsellable."
        },
        "perUnitDeclaredValue": {
          "description": "The monetary value assigned by the seller to this item. This is a required field for India MCF orders.",
          "$ref": "#/$defs/Money"
        },
        "perUnitPrice": {
          "description": "The amount to be collected from the recipient for this item in a COD (Cash On Delivery) order.",
          "$ref": "#/$defs/Money"
        },
        "perUnitTax": {
          "description": "The tax on the amount to be collected from the recipient for this item in a COD (Cash On Delivery) order.",
          "$ref": "#/$defs/Money"
        }
      },
      "description": "Item information for updating a fulfillment order."
    },
    "UpdateFulfillmentOrderItemList": {
      "type": "array",
      "description": "An array of fulfillment order item information for updating a fulfillment order.",
      "items": {
        "$ref": "#/$defs/UpdateFulfillmentOrderItem"
      }
    }
  }
}