Migrate from Amazon MWS Report API to Amazon Pay Reports API

Naga Sri Hari Gonaboyina

Updated November 14, 2024 17:57

Amazon is deprecating the MWS Reports API, which the Amazon Pay Reports API has now replaced. To ensure a seamless transition for your integrations, you must create an Amazon Pay connection.

This article explains how to replace your existing flow with a new Amazon Pay connector, and a sample export, including details of endpoints and parameters.

Additional references:

Replace your existing flow

To use the Amazon Pay Reports API, you’ll need to replace your existing resources with new ones. Hence, identify your existing flow built on Amazon Seller Central connection and clone the flow. Once you clone the flow, follow the below-mentioned steps to replace the existing resources:

Sign in to your Celigo integrator.io account.
Navigate to Home and click the integration tile that contains the cloned flow you want to replace.
Click the cloned flow.
From Sources, hover over Export and click Remove resource from flow.
Click Remove. The existing resource will be removed.
Click Add source. The Create source side panel opens.
From Application, select Amazon Pay.
Click Create flow step. The Create export page opens.
In the General section, enter a Name for your export.
Click Create connection. For information, see Set up a new connection to Amazon Pay.
In the What would you like to export section, select the Resource and API endpoint as explained in the Configuring a new export (sample) section.
Click Preview to make sure the output is as required.
Click Save and close.
Click Run now and close the flow.

Note: You can now Off or Delete the existing flow (built on Amazon Seller Central connection).

Set up a new connection to Amazon Pay

To set up a new connection to Amazon Pay:

Sign in to your Celigo integrator.io account.
Navigate to Resources > Connections.
Search and configure Amazon Pay connector. For detailed information, see Set up a connection to Amazon Pay.

List of Amazon Pay endpoints

The following table lists the new endpoints:

Resource	API endpoints
Reports	Get reports
	Get report by ID
	Get report schedules
	Get report schedules by ID
	Get disbursements
	Create report
	Create report schedule
	Cancel report schedule

Configuring a new sample export

From the Tools menu, select Flow builder and click Add source, or from the Resources menu, select Exports. Then, click + Create export.
Enter a Name and Description for your export.
Select the configured Amazon Pay connection.
Navigate to the What would you like to export section.
1. From Resource, select Reports.
2. From the API endpoint, select Get reports.
3. From Query parameters, select the required parameter listed in the table below. For example, choose reportTypes and then enter a value. For detailed information on how to choose your query parameters, see Parameters.
Click Save and close.

Existing and new parameters

When configuring the new export/import, refer to the following table to identify the previous Amazon MWS parameters with the latest Amazon Pay parameters.

Parameter	Amazon MWS	Amazon Pay
Method	GET	GET
Relative URL (Get report list)	Action=GetReportList Action=GetReportListByNextToken	/:version/reports
Relative URL (Get report document):	Action=GetReport&ReportId={{{ReportId}}}	/:version/report-documents/:reportDocumentId
Query parameters	ReportTypeList AvailableFromDate AvailableToDate NextToken	reportTypes processingStatuses createdSince createdUntil pageSize nextToken