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.
您可以通过亚马逊商城网络服务 (亚马逊 MWS) API 的报告 API 部分,来请求关于“我要开店”业务的各种报告。可以使用 ReportTypes 枚举,来指定报告类型。
报告流程以创建报告请求开始。然后,您便可以获得报告请求列表,该列表显示每个被请求报告的报告请求编码和状态。最后,您可以通过该商品的报告请求编码,获得实际的报告。流程步骤如下:
下面的流程图展示了提交并接收一次性报告的流程:
此外,您可以对订单报告请求进行计划,以便通过 ManageReportSchedule 操作使之定期提交。Schedule 枚举用于指定提交报告请求的时间期限。您还可以通过 GetReportScheduleList 操作获取已计划订单报告请求列表。
下面的流程图展示了提交并接收一个计划的报告的流程:
报告 API 部分包含以下操作:
操作 | 简短说明 |
---|---|
RequestReport | 创建报告请求,并将请求提交至亚马逊MWS。 |
GetReportRequestList | 返回可用于获取报告的 ReportRequestId 的报告请求列表。 |
GetReportRequestListByNextToken | 可通过之前请求提供给 GetReportRequestListByNextToken 或 GetReportRequestList 的 NextToken 值,返回报告请求列表,其中前一请求中的 HasNext 值为 true。 |
GetReportRequestCount | 返回已提交至亚马逊MWS 进行处理的报告请求计数。 |
CancelReportRequests | 取消一个或多个报告请求。 |
GetReportList | 返回在过去 90 天内所创建的报告列表。 |
GetReportListByNextToken | 可通过之前请求提供给 GetReportListByNextToken 或 GetReportList 的 NextToken 值,返回报告列表,其中前一调用中的 HasNext 值为 true。 |
GetReportCount | 返回在过去 90 天内创建、状态为 _DONE_ 且可供下载的报告计数。 |
GetReport | 返回报告内容及所返回报告正文的 Content-MD5 标头。 |
ManageReportSchedule | 创建、更新或删除特定报告类型的报告请求计划。 |
GetReportScheduleList | 返回计划提交至亚马逊MWS 进行处理的订单报告请求列表。 |
GetReportScheduleListByNextToken | 当前无法调用该操作,原因是 GetReportScheduleList 操作无法返回 100 个以上的结果。包含该操作以实现以后的兼容性。 |
GetReportScheduleCount | 返回计划提交至亚马逊MWS 的订单报告请求计数。 |
UpdateReportAcknowledgements | 更新一个或多个报告的确认状态。 |