Sign in

v9

latestOpenAPI 3.0.1Apache License 2.0raw.githubusercontent.com2026-08-01994159.4 KB
fulfillmentOutbound
fulfillmentOrders

Request 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
230

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

post/fulfillment/outbound/2026-07-04/orders

Headers

x-amzn-fulfillment-service-idstring

The identifier of the fulfillment service used for this operation.

Request body

orderIdstring required

A fulfillment order identifier that the seller creates to track their fulfillment order. The orderId 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.

channelstring

The sales channel of the fulfillment order.

Example request

{
  "orderId": "someorderId",
  "channel": "SHOPIFY",
  "fulfillmentConfiguration": {
    "serviceLevel": {
      "serviceTiers": [
        "STANDARD"
      ],
      "deliveryInterval": {
        "startTime": "2025-04-21T12:34:56Z",
        "endTime": "2025-04-22T12:34:56Z"
      }
    },
    "action": "HOLD",
    "policy": "FILL_ALL_AVAILABLE",
    "services": {
      "packaging": {
        "packagingOption": "UNBRANDED",
        "packingSlip": {
          "templateName": "templateName",
          "templateAttributes": {
            "orderId": "MyOrder-123",
            "orderTime": "2026-07-01T10:00:00Z",
            "orderText": "Thank you for your purchase!"
          }
        }
      },
      "additional": {}
    }
  },
  "origin": {
    "countryCode": "US"
  },
  "destination": {
    "deliveryAddress": {
      "name": "Shopper Name",
      "addressLine1": "1000 Winthrop Ave N",
      "city": "Seattle",
      "countryCode": "US",
      "postalCode": "98103",
      "stateOrRegion": "WA",
      "phone": "123-456-7890",
      "email": "shopper@email.com"
    }
  },
  "lineItems": [
    {
      "lineItemId": "someLineItemId",
      "product": {
        "productIdentifier": {
          "amazonSku": "BOOK-123-HC"
        },
        "perUnitDeclaredValue": {
          "currencyCode": "USD",
          "amount": "14.99"
        }
      },
      "amount": {
        "unit": "EACHES",
        "value": "1.0"
      },
      "fulfillmentConfiguration": {
        "services": {
          "packaging": {
            "packingSlip": {
              "templateName": "templateName",
              "templateAttributes": {
                "giftMessage": "Happy Birthday!",
                "lineItemText": "Item 1 of 2"
              }
            }
          },
          "delivery": {
            "paymentOnDelivery": {
              "perUnitServicePrice": {
                "currencyCode": "USD",
                "amount": "14.99"
              }
            }
          }
        }
      }
    }
  ],
  "paymentInformation": {
    "payments": [
      {
        "paymentId": "PAY-12345",
        "paymentMethod": "CREDIT_CARD",
        "paymentTime": "2019-10-13T13:53:49Z"
      }
    ]
  }
}

Response

Success.

Example response

{
  "order": {
    "orderId": "ABC123XYZ",
    "receiveTime": "2025-04-21T10:30:00Z",
    "status": "PROCESSING",
    "statusUpdateTime": "2025-04-21T11:45:00Z",
    "fulfillmentConfiguration": {
      "serviceLevel": {
        "serviceTiers": [
          "STANDARD"
        ]
      },
      "action": "HOLD",
      "policy": "FILL_ALL_AVAILABLE",
      "services": {
        "packaging": {
          "packagingOption": "UNBRANDED",
          "packingSlip": {
            "templateName": "templateName",
            "templateAttributes": {
              "orderId": "MyOrder-123",
              "orderTime": "2026-07-01T10:00:00Z",
              "orderText": "Thank you for your purchase!"
            }
          }
        },
        "additional": {}
      }
    },
    "origin": {
      "countryCode": "US"
    },
    "destination": {
      "deliveryAddress": {
        "name": "Shopper Name",
        "addressLine1": "1000 Winthrop Ave N",
        "city": "Seattle",
        "countryCode": "US",
        "postalCode": "98103",
        "stateOrRegion": "WA",
        "phone": "123-456-7890",
        "email": "shopper@email.com"
      }
    },
    "lineItems": [
      {
        "lineItemId": "someLineItemId",
        "product": {
          "productIdentifier": {
            "amazonSku": "BOOK-123-HC"
          },
          "perUnitDeclaredValue": {
            "currencyCode": "USD",
            "amount": "14.99"
          }
        },
        "amount": {
          "unit": "EACHES",
          "value": "1.0"
        },
        "cancelledAmount": {
          "unit": "EACHES",
          "value": "0.0"
        },
        "unfulfillableAmount": {
          "unit": "EACHES",
          "value": "0.0"
        },
        "fulfillmentConfiguration": {
          "services": {
            "packaging": {
              "packingSlip": {
                "templateName": "templateName",
                "templateAttributes": {
                  "giftMessage": "Happy Birthday!",
                  "lineItemText": "Item 1 of 2"
                }
              }
            },
            "delivery": {
              "paymentOnDelivery": {
                "perUnitServicePrice": {
                  "currencyCode": "USD",
                  "amount": "14.99"
                }
              }
            }
          }
        }
      }
    ],
    "paymentInformation": {
      "payments": [
        {
          "paymentId": "PAY-12345",
          "paymentMethod": "CREDIT_CARD",
          "paymentTime": "2019-10-13T13:53:49Z"
        }
      ]
    }
  }
}