POST api/mws/orders/OrderAdjustment

The Order Adjustment feed allows you to issue a refund (adjustment) for an order. You must provide a reason for the adjustment, such as "Customer Return," and the adjustment amount, broken out by price component (principle, shipping, tax, and so on). Note, however, that the buyer's credit card will only be credited one time for the total amount. Although the adjustment feed allows for charging the buyer additional money (for a restocking fee, for example), the net amount of the adjustment must be a credit to the buyer. Additionally, you can use the Order Adjustment feed to cancel individual items that you are unable to ship, without incurring a refund holdback fee. To use this feature, you must provide an adjustment reason of NoInventory or BuyerCancelled, and the quantity of items being cancelled. Note: To cancel an entire order, use the Order Acknowledgement not the Order Adjustment. 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 Fulfillment List Request

SuiteBridge.Models.AmazonMWS.AmzOrderAdjustmentListRequest

Name	Description	Type	Additional information
OrderAdjustmentList	Orders OrderAdjustment List	Collection of SuiteBridge.Models.AmazonMWS.OrderAdjustment	Required

Request Formats

application/json, text/json

Sample:

{
  "OrderAdjustmentList": [
    {
      "AmazonOrderID": "sample string 1",
      "MerchantOrderID": "sample string 2",
      "AdjustedItems": [
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "MerchantAdjustmentItemID": "sample string 3",
          "AdjustmentReason": "sample string 4",
          "QuantityCancelled": "sample string 5",
          "ItemPriceAdjustments": [
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            },
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            }
          ],
          "PromotionAdjustments": [
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            },
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            }
          ]
        },
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "MerchantAdjustmentItemID": "sample string 3",
          "AdjustmentReason": "sample string 4",
          "QuantityCancelled": "sample string 5",
          "ItemPriceAdjustments": [
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            },
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            }
          ],
          "PromotionAdjustments": [
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            },
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "AmazonOrderID": "sample string 1",
      "MerchantOrderID": "sample string 2",
      "AdjustedItems": [
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "MerchantAdjustmentItemID": "sample string 3",
          "AdjustmentReason": "sample string 4",
          "QuantityCancelled": "sample string 5",
          "ItemPriceAdjustments": [
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            },
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            }
          ],
          "PromotionAdjustments": [
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            },
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            }
          ]
        },
        {
          "AmazonOrderItemCode": "sample string 1",
          "MerchantOrderItemID": "sample string 2",
          "MerchantAdjustmentItemID": "sample string 3",
          "AdjustmentReason": "sample string 4",
          "QuantityCancelled": "sample string 5",
          "ItemPriceAdjustments": [
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            },
            {
              "Type": "sample string 1",
              "Amount": {
                "Currency": "sample string 1",
                "Value": "sample string 2"
              }
            }
          ],
          "PromotionAdjustments": [
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            },
            {
              "PromotionClaimCode": "sample string 1",
              "MerchantPromotionID": "sample string 2",
              "Component": [
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                },
                {
                  "Type": "sample string 1",
                  "Amount": {
                    "Currency": "sample string 1",
                    "Value": "sample string 2"
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

application/xml, text/xml

Sample:

<AmzOrderAdjustmentListRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <OrderAdjustmentList>
    <OrderAdjustment>
      <AmazonOrderID>sample string 1</AmazonOrderID>
      <MerchantOrderID>sample string 2</MerchantOrderID>
      <AdjustedItem>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <MerchantAdjustmentItemID>sample string 3</MerchantAdjustmentItemID>
        <AdjustmentReason>sample string 4</AdjustmentReason>
        <QuantityCancelled>sample string 5</QuantityCancelled>
        <ItemPriceAdjustments>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </ItemPriceAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
      </AdjustedItem>
      <AdjustedItem>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <MerchantAdjustmentItemID>sample string 3</MerchantAdjustmentItemID>
        <AdjustmentReason>sample string 4</AdjustmentReason>
        <QuantityCancelled>sample string 5</QuantityCancelled>
        <ItemPriceAdjustments>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </ItemPriceAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
      </AdjustedItem>
    </OrderAdjustment>
    <OrderAdjustment>
      <AmazonOrderID>sample string 1</AmazonOrderID>
      <MerchantOrderID>sample string 2</MerchantOrderID>
      <AdjustedItem>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <MerchantAdjustmentItemID>sample string 3</MerchantAdjustmentItemID>
        <AdjustmentReason>sample string 4</AdjustmentReason>
        <QuantityCancelled>sample string 5</QuantityCancelled>
        <ItemPriceAdjustments>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </ItemPriceAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
      </AdjustedItem>
      <AdjustedItem>
        <AmazonOrderItemCode>sample string 1</AmazonOrderItemCode>
        <MerchantOrderItemID>sample string 2</MerchantOrderItemID>
        <MerchantAdjustmentItemID>sample string 3</MerchantAdjustmentItemID>
        <AdjustmentReason>sample string 4</AdjustmentReason>
        <QuantityCancelled>sample string 5</QuantityCancelled>
        <ItemPriceAdjustments>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </ItemPriceAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
        <PromotionAdjustments>
          <PromotionClaimCode>sample string 1</PromotionClaimCode>
          <MerchantPromotionID>sample string 2</MerchantPromotionID>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
          <Component>
            <Type>sample string 1</Type>
            <Amount currency="sample string 1">sample string 2</Amount>
          </Component>
        </PromotionAdjustments>
      </AdjustedItem>
    </OrderAdjustment>
  </OrderAdjustmentList>
</AmzOrderAdjustmentListRequest>

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:52:29.5980009+00:00",
        "CompletedProcessingDate": "2026-01-12T23:52:29.5980009+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:52:29.5980009+00:00</StartedProcessingDate>
        <CompletedProcessingDate>2026-01-12T23:52:29.5980009+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>