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.
Updates the acknowledged status of one or more reports.
The UpdateReportAcknowledgements operation is an optional request that updates the acknowledged status of one or more reports. Use this operation if you want Amazon MWS to remember the acknowledged status of your reports. To keep track of which reports you have already received, it is a good practice to acknowledge reports after you have received and stored them successfully. Then, when you submit a GetReportList request, you can specify to receive only reports that have not yet been acknowledged.
To retrieve reports that have been lost, set the Acknowledged to false and then submit a GetReportList request. This action returns a list of all reports within the previous 90 days that match the query parameters.
This operation is available in all marketplaces.
Maximum request quota | Restore rate | Hourly request quota |
---|---|---|
10 requests | One request every 45 seconds | 80 requests per hour |
For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.
Name | Description | Required | Values |
---|---|---|---|
ReportIdList | A structured list of Report Ids. The maximum number of reports that can be specified is 100. | Yes | Default: none Type: xs:string |
Acknowledged | A Boolean value that indicates that you have received and stored a report. Specify true to set the acknowledged status of a report to true. Specify false to set the acknowledged status of a report to false. | No | Default: All Type: xs:boolean |
Name | Description |
---|---|
Count | A non-negative integer that represents the total number of report
requests.
Type: xs:nonNegativeInteger |
ReportInfo | Detailed information about a report. Type: ReportInfo |
For information about standard request requirements, see Required request parameters.
POST /Reports/2009-01-01 HTTP/1.1 Content-Type: x-www-form-urlencoded Host: mws.amazonservices.com User-Agent: <Your User Agent Header> AWSAccessKeyId=0PB842EXAMPLE7N4ZTR2 &Acknowledged=true &Action=UpdateReportAcknowledgements &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &Marketplace=ATVPDKIKX0DER &ReportIdList.Id.1=841997483 &ReportIdList.id.2=843337483 &SellerId=A1XEXAMPLE5E6 &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2009-02-04T18%3A12%3A20.718Z &Version=2009-01-01 &Signature=cE8%2FUgE8BspmM%2B26UTy7oVEdBk4%3D
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <UpdateReportAcknowledgementsResponse xmlns="http://mws.amazonservices.com/doc/2009-01-01/"> <UpdateReportAcknowledgementsResult> <Count>1</Count> <ReportInfo> <ReportId>841997483</ReportId> <ReportType>_GET_MERCHANT_LISTINGS_DATA_</ReportType> <ReportRequestId>2234038326</ReportRequestId> <AvailableDate>2009-01-06T03:48:36+00:00</AvailableDate> <Acknowledged>true</Acknowledged> <AcknowledgedDate>2009-02-20T02:10:41+00:00</AcknowledgedDate> </ReportInfo> </UpdateReportAcknowledgementsResult> <ResponseMetadata> <RequestId>42a578a7-ed92-486b-ac67-5de7464fcdfa</RequestId> </ResponseMetadata> </UpdateReportAcknowledgementsResponse>