Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

Working with order reports

Describes how to schedule and manage order reports.

When requesting order reports, note that order reports are generated only if there are orders to report. In the case of scheduled order reports, if there were no orders placed between the time the last order report was created and the current request, no report is created. When you manually request an order report using the RequestReport operation, if there were no orders placed in the time frame specified in your request, the operation returns _DONE_NO_DATA_ to indicate there are no order reports to return.

Scheduling order reports

A good practice for working with order reports is to schedule them as follows:
  1. Schedule order report requests to be periodically submitted using the ManageReportSchedule operation.
  2. Schedule the GetReportList operation to be submitted in an interval that is similar to the schedule that you configured in Step 1. Ensure that the Acknowledged parameter is set to false. This step determines whether any new order reports have been created.
  3. Capture any ReportId values that are returned by the GetReportList operation. No ReportId values will be returned if no new order reports have been created since the last scheduled GetReportList request.
  4. For each ReportId value that is returned, submit the GetReport operation, specifying the ReportId value. Amazon MWS returns the report.
  5. Acknowledge the receipt of the report using the UpdateReportAcknowledgements operation. Do this after downloading your report to ensure that the report is not downloaded the next time you submit a GetReportList request (see Step 2).
Note:
  • In rare cases, the same order might be returned more than once when using this procedure. For more information, see Duplicate orders.
  • This procedure is for self-fulfilled orders only. For more information about tracking Fulfillment by Amazon orders, see Monitoring and tracking FBA orders in the Amazon MWS for FBA Sellers guide.

Duplicate orders

The procedure for scheduling order reports described in the previous section helps to ensure that each generated order report (as identified by its ReportId) is returned only once. In most cases this means that individual orders (as identified by OrderId) will be returned only once. However, in rare cases, an order might be returned more than once when using this procedure. In addition, you should expect duplicate orders when you manually request order reports using the RequestReport operation. For these reasons you should design your automated systems to handle duplicate orders in ways that make sense for your situation.