---
title: "createFulfillmentOrder"
method: POST
path: "/fba/outbound/2020-07-01/fulfillmentOrders"
tags: ["Fulfillment Outbound v2020-07-01"]
---

# createFulfillmentOrder

`POST /fba/outbound/2020-07-01/fulfillmentOrders`

Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination address.

**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)

## Request body

- CreateFulfillmentOrderRequest — The request body schema for the `createFulfillmentOrder` operation.
  - `marketplaceId` string — The marketplace the fulfillment order is placed against.
  - `sellerFulfillmentOrderId` string, required — A fulfillment order identifier that the seller creates to track their fulfillment order. The `sellerFulfillmentOrderId` must be unique for each fulfillment order that a seller creates. If the seller's system already creates unique order identifiers, then these might be good values for them to use.
  - `displayableOrderId` string, required — 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. The value must be an alpha-numeric or ISO 8859-1 compliant string from one to 40 characters in length. Cannot contain two spaces in a row. Leading and trailing white space is removed.
  - `displayableOrderDate` string, date-time, required — Date-time formatted timestamp.
  - `displayableOrderComment` string, required — Order-specific text that appears in recipient-facing materials such as the outbound shipment packing slip.
  - `shippingSpeedCategory` 'Standard' | 'Expedited' | 'Priority' | 'ScheduledDelivery', required — 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.
  - `deliveryWindow` DeliveryWindow — The time range within which a Scheduled Delivery fulfillment order should be delivered. This is only available in the JP marketplace.
    - `startDate` string, date-time, required — Date-time formatted timestamp.
    - `endDate` string, date-time, required — Date-time formatted timestamp.
  - `destinationAddress` Address, required — 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.
  - `deliveryPreferences` DeliveryPreferences — Contains all of the delivery instructions provided by the customer for the shipping address.
    - `DropOffLocation` string — Drop-off location selected by the customer.
    - `PreferredDeliveryTime` PreferredDeliveryTime — Customer-specified time preferences for when deliveries should be attempted at the destination address.
      - `businessHours` BusinessHour[] — Business hours when the business is open for deliveries.
        - `dayOfWeek` 'SUN' | 'MON' | 'TUE' | 'WED' | 'THU' | 'FRI' | 'SAT' — Specific day of the week for which operating hours are being defined.
        - `timeWindows` TimeWindow[] — Collection of time windows during which the location is available for deliveries on the specified day.
          - `startTime` HourMinute — The time when the business opens or closes.
            - `hour` integer — The hour when the business opens or closes, in 24-hour format (0-23).
            - `minute` integer — The minute when the business opens or closes.
          - `endTime` HourMinute — The time when the business opens or closes.
            - `hour` integer — The hour when the business opens or closes, in 24-hour format (0-23).
            - `minute` integer — The minute when the business opens or closes.
      - `exceptionDates` ExceptionDate[] — Specific dates within the next 30 days when normal business hours do not apply.
        - `exceptionDate` string, date — Specific calendar date when normal operating hours do not apply. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format at day granularity.
        - `exceptionDateType` 'CLOSED' | 'OPEN' — Operational status of the business on the specified exception date.
        - `timeWindows` TimeWindow[] — Alternative operating hours that apply specifically to this exception date.
          - `startTime` HourMinute — The time when the business opens or closes.
            - `hour` integer — The hour when the business opens or closes, in 24-hour format (0-23).
            - `minute` integer — The minute when the business opens or closes.
          - `endTime` HourMinute — The time when the business opens or closes.
            - `hour` integer — The hour when the business opens or closes, in 24-hour format (0-23).
            - `minute` integer — The minute when the business opens or closes.
    - `OtherAttributes` OtherDeliveryAttributes[] — Enumerated list of miscellaneous delivery attributes associated with the shipping address.
    - `AddressInstructions` string — Building instructions, nearby landmark or navigation instructions.
  - `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.
  - `codSettings` CODSettings — The COD (Cash On Delivery) charges that you associate with a COD fulfillment order.
    - `isCodRequired` boolean, required — When true, this fulfillment order requires a COD (Cash On Delivery) payment.
    - `codCharge` 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+)?$`.
    - `codChargeTax` 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+)?$`.
    - `shippingCharge` 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+)?$`.
    - `shippingChargeTax` 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+)?$`.
  - `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` CreateFulfillmentOrderItem[], required — An array of item information for creating a fulfillment order.
    - `sellerSku` string, required — The seller SKU of the item.
    - `sellerFulfillmentOrderItemId` string, required — A fulfillment order item identifier that the seller creates to track fulfillment order items. Used to disambiguate multiple fulfillment items that have the same `sellerSku` value. For example, the seller might assign different `sellerFulfillmentOrderItemId` values to two items in a fulfillment order that share the same `sellerSku` value but have different `giftMessage` values.
    - `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.
    - `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+)?$`.
  - `paymentInformation` PaymentInformation[] — A list of payment transactions.
    - `PaymentMethod` 'CreditCard' | 'DebitCard' | 'Pix' | 'BankSlip' | 'GiftCard' | 'Other' — Payment methods
    - `AcquirerId` string — The government ID of the acquirer.
    - `CardBrand` string — The credit card brand if the payment method is `CreditCard`.
    - `PaymentValue` 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+)?$`.
    - `AuthorizationCode` string — The authorization code of this payment.

## Response `200`

Success.

- CreateFulfillmentOrderResponse — The response schema for the `createFulfillmentOrder` 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)