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:
- Schedule order report requests to be periodically submitted using the
- 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.
- 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
- For each ReportId value that is returned, submit
the GetReport operation, specifying the
ReportId value. Amazon MWS returns the report.
- 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).
- In rare cases, the
same order might be returned more than once when using this procedure. For more
- 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.
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.