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

UpdateReportAcknowledgements

Updates the acknowledged status of one or more reports.

Description

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.

Note: When submitting the GetReportList or GetReportListByNextToken operations, be sure that HasNext returns false before submitting the UpdateReportAcknowledgements operation. This helps to ensure that all of the reports that match your query parameters are returned.

Availability

This operation is available in all marketplaces.

Throttling

Maximum request quota Restore rate Hourly request quota
10 requests One request every 45 seconds 80 requests per hour
For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

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

Response elements

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

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

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

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?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>

↑ Top