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.
Creates, updates, or deletes a report request schedule for a specified report type.
The ManageReportSchedule operation creates, updates, or deletes a report request schedule for a particular report type. Only Order Reports can be scheduled.
By using a combination of the ReportType and Schedule values, Amazon MWS determines which action you want to perform. If no combination of ReportType and Schedule exists, then a new report request schedule is created. If the ReportType is already scheduled but with a different Schedule value, then the report request schedule is updated to use the new Schedule value. If you pass in a ReportType and set the Schedule value to _NEVER_ in the request, the report request schedule for that ReportType is deleted.
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 |
---|---|---|---|
ReportType | A value of the ReportType that indicates the type of report to request. | Yes | A ReportType value
Type: xs:string |
Schedule | A value of the Schedule that indicates how often a report request should be created. | Yes | A valid Schedule value
Default: None Type: xs:string |
ScheduleDate | The date when the next report request is scheduled to be submitted. | No | Default: Now Value can be no more than 366 days in the future. In ISO 8601 date time format. Type: xs:dateTime |
Name | Description |
---|---|
Count | A non-negative integer that represents the total number of report
requests.
Type: xs:nonNegativeInteger |
ReportSchedule | Detailed information about a report schedule. Type: ReportSchedule |
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=06Example02 &Action=ManageReportSchedule &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &Marketplace=ATVPDKIKX0DER &ReportType=_GET_ORDERS_DATA_ &Schedule=_30_DAYS_ &SellerId=A3Example4D &SignatureMethod=HmacSHA256 &SignatureVersion=2 &Timestamp=2009-01-14T20%3A50%3A30.218Z &Version=2009-01-01 &Signature=RuExample0%3D
For information about standard response formatting, see Response format.
<?xml version="1.0"?> <ManageReportScheduleResponse xmlns="http://mws.amazonservices.com/doc/2009-01-01/"> <ManageReportScheduleResult> <Count>1</Count> <ReportSchedule> <ReportType>_GET_ORDERS_DATA_</ReportType> <Schedule>_30_DAYS_</Schedule> <ScheduledDate>2009-02-20T02:10:42+00:00</ScheduledDate> </ReportSchedule> </ManageReportScheduleResult> <ResponseMetadata> <RequestId>7ee1bc50-5a13-4db1-afd7-1386e481984e</RequestId> </ResponseMetadata> </ManageReportScheduleResponse>