Amazon Services China
亚马逊商城网络服务(亚马逊 MWS)文档

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.

亚马逊 MWS 文档

您应了解的“亚马逊 MWS 报告 API”部分的相关内容

您可以通过亚马逊商城网络服务 (亚马逊 MWS) API 的报告 API 部分,来请求关于“我要开店”业务的各种报告。可以使用 ReportTypes 枚举,来指定报告类型。

报告流程以创建报告请求开始。然后,您便可以获得报告请求列表,该列表显示每个被请求报告的报告请求编码和状态。最后,您可以通过该商品的报告请求编码,获得实际的报告。流程步骤如下:

  1. 通过 RequestReport 操作提交报告请求。这个请求提交到亚马逊MWS 来生成指定的报告。请注意,您还可以通过 ManageReportSchedule 操作来规划需定期提交的申请,从而定期生成订单和亚马逊商品广告报告。
  2. 通过 GetReportList 操作提交请求,以获取报告请求列表以及每个报告请求的状态和编号。亚马逊MWS 返回每个所请求报告的 RequestReportId 值。如果亚马逊MWS 将报告请求的状态设置为 _DONE_,该报告即可以进行检索。某些报告将创建 GeneratedReportId,您可以将其传递给 GetReport 操作(参阅步骤 4)。如果需要取消报告请求,请使用 CancelReportRequests 操作。
  3. 如果没有创建 GeneratedReportId,则使用 GetReportList 操作来提交请求,并包含请求报告的 ReportRequestId。操作将返回 ReportId,然后您可以将其传递给 GetReport 操作(参阅步骤 4)。
  4. 使用 GetReport 操作提交请求,以接收特定报告。需要在请求中包含待接收报告的 GeneratedReportIdReportId。然后,处理 Content-MD5 标头,以确认报告在传输过程中未损坏。有关使用 Content-MD5 标头的更多信息,请参阅亚马逊MWS开发者指南

下面的流程图展示了提交并接收一次性报告的流程:

此外,您可以对订单报告请求进行计划,以便通过 ManageReportSchedule 操作使之定期提交。Schedule 枚举用于指定提交报告请求的时间期限。您还可以通过 GetReportScheduleList 操作获取已计划订单报告请求列表。

下面的流程图展示了提交并接收一个计划的报告的流程:

报告 API 部分中的操作

报告 API 部分包含以下操作:

操作 简短说明
RequestReport 创建报告请求,并将请求提交至亚马逊MWS
GetReportRequestList 返回可用于获取报告的 ReportRequestId 的报告请求列表。
GetReportRequestListByNextToken 可通过之前请求提供给 GetReportRequestListByNextTokenGetReportRequestListNextToken 值,返回报告请求列表,其中前一请求中的 HasNext 值为 true
GetReportRequestCount 返回已提交至亚马逊MWS 进行处理的报告请求计数。
CancelReportRequests 取消一个或多个报告请求。
GetReportList 返回在过去 90 天内所创建的报告列表。
GetReportListByNextToken 可通过之前请求提供给 GetReportListByNextTokenGetReportListNextToken 值,返回报告列表,其中前一调用中的 HasNext 值为 true
GetReportCount 返回在过去 90 天内创建、状态为 _DONE_ 且可供下载的报告计数。
GetReport 返回报告内容及所返回报告正文的 Content-MD5 标头。
ManageReportSchedule 创建、更新或删除特定报告类型的报告请求计划。
GetReportScheduleList 返回计划提交至亚马逊MWS 进行处理的订单报告请求列表。
GetReportScheduleListByNextToken 当前无法调用该操作,原因是 GetReportScheduleList 操作无法返回 100 个以上的结果。包含该操作以实现以后的兼容性。
GetReportScheduleCount 返回计划提交至亚马逊MWS 的订单报告请求计数。
UpdateReportAcknowledgements 更新一个或多个报告的确认状态。