POST api/mws/orders/OrderAcknowledgement

The Order Acknowledgment feed allows you to acknowledge your success or failure with downloading an order. The acknowledgment feed also allows you to provide your own order ID and order item IDs, which you can then reference in future feeds for the same order, if desired. Additionally, you can use this feed to cancel the entire order under one of these circumstances: The customer asked you to cancel the order (and you have not yet shipped it) You received a single-item order but you can't ship the item (damaged goods) You are unable to upload an order into your system To cancel the order, use the "Failure" StatusCode. Notes: Do not issue an Order Acknowledgment request with the "Failure" StatusCode after at least one item in the order has been confirmed as shipped (see the next section: OrderFulfillment). This would refund the entire order amount to the buyer. For all CancelReason values except NoInventory, Amazon will increase the item’s stock level by the count of canceled units. Availability - This operation is available in all marketplaces. Throttling Maximum request quota - 15 requests Restore rate - One request every two minutes Hourly request quota - 30 requests per hour

Request Information

URI Parameters

None.

Body Parameters

Order Acknowledgement List Request

SuiteBridge.Models.AmazonMWS.AmzOrderAcknowledgementListRequest

Name	Description	Type	Additional information
OrderAcknowledgementList	Orders Acknowledgement List	Collection of SuiteBridge.Models.AmazonMWS.OrderAcknowledgement	Required

Request Formats

application/json, text/json

Sample:

{
  "OrderAcknowledgementList": [
    {
      "AmazonOrderID": "sample string 1",
      "MerchantOrderID": "sample string 2",
      "StatusCode": "sample string 3",
      "Items": [
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "CancelReason": "sample string 3"
        },
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "CancelReason": "sample string 3"
        }
      ]
    },
    {
      "AmazonOrderID": "sample string 1",
      "MerchantOrderID": "sample string 2",
      "StatusCode": "sample string 3",
      "Items": [
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "CancelReason": "sample string 3"
        },
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "CancelReason": "sample string 3"
        }
      ]
    }
  ]
}

application/xml, text/xml

Sample:

<AmzOrderAcknowledgementListRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <OrderAcknowledgementList>
    <OrderAcknowledgement>
      <AmazonOrderID>sample string 1</AmazonOrderID>
      <MerchantOrderID>sample string 2</MerchantOrderID>
      <StatusCode>sample string 3</StatusCode>
      <Item>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <CancelReason>sample string 3</CancelReason>
      </Item>
      <Item>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <CancelReason>sample string 3</CancelReason>
      </Item>
    </OrderAcknowledgement>
    <OrderAcknowledgement>
      <AmazonOrderID>sample string 1</AmazonOrderID>
      <MerchantOrderID>sample string 2</MerchantOrderID>
      <StatusCode>sample string 3</StatusCode>
      <Item>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <CancelReason>sample string 3</CancelReason>
      </Item>
      <Item>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <CancelReason>sample string 3</CancelReason>
      </Item>
    </OrderAcknowledgement>
  </OrderAcknowledgementList>
</AmzOrderAcknowledgementListRequest>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Submit Feed Response

SuiteBridge.Models.AmzFeedResponse

Name	Description	Type	Additional information
RequestXML	Feed XML Request	string	None.
SubmitFeedResponse	Submit feed response	MarketplaceWebService.Model.SubmitFeedResponse	None.

Response Formats

application/json, text/json

Sample:

{
  "RequestXML": "sample string 1",
  "SubmitFeedResponse": {
    "SubmitFeedResult": {
      "FeedSubmissionInfo": {
        "FeedSubmissionId": "sample string 1",
        "FeedType": "sample string 2",
        "SubmittedDate": "sample string 3",
        "FeedProcessingStatus": "sample string 4",
        "StartedProcessingDate": "2026-01-12T23:56:17.7263152+00:00",
        "CompletedProcessingDate": "2026-01-12T23:56:17.7263152+00:00"
      }
    },
    "ResponseMetadata": {
      "RequestId": "sample string 1"
    },
    "ResponseHeaderMetadata": {
      "RequestId": null,
      "ResponseContext": null,
      "Timestamp": null
    }
  }
}

application/xml, text/xml

Sample:

<AmzFeedResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <RequestXML>sample string 1</RequestXML>
  <SubmitFeedResponse>
    <SubmitFeedResult xmlns="http://mws.amazonaws.com/doc/2009-01-01/">
      <FeedSubmissionInfo>
        <FeedSubmissionId>sample string 1</FeedSubmissionId>
        <FeedType>sample string 2</FeedType>
        <SubmittedDate>sample string 3</SubmittedDate>
        <FeedProcessingStatus>sample string 4</FeedProcessingStatus>
        <StartedProcessingDate>2026-01-12T23:56:17.7263152+00:00</StartedProcessingDate>
        <CompletedProcessingDate>2026-01-12T23:56:17.7263152+00:00</CompletedProcessingDate>
      </FeedSubmissionInfo>
    </SubmitFeedResult>
    <ResponseMetadata xmlns="http://mws.amazonaws.com/doc/2009-01-01/">
      <RequestId>sample string 1</RequestId>
    </ResponseMetadata>
    <ResponseHeaderMetadata xmlns="http://mws.amazonaws.com/doc/2009-01-01/" />
  </SubmitFeedResponse>
</AmzFeedResponse>