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 文档

ReportType 枚举

可通过亚马逊MWS 请求的报告类型的枚举。

描述

报告 API 部分中的操作会通过 ReportType 枚举,来指明特定报告。例如,RequestReport 操作通过 ReportType 值,来指明所请求报告的类型。

支持以下报告分类:

根据报告分类枚举 ReportType

下表列出了报告标题、枚举值以及报告描述。请注意,为了便于阅读,枚举值可能显示为两行,但是当该值用作字符串时,中间不能有空格

请注意,在报告描述中,卖家平台针对的是过去几年内在亚马逊注册销售商品的卖家;而商城针对的是更早以前在亚马逊注册销售商品的卖家。某些报告可能仅适用于商城或卖家平台卖家。

商品报告

报告 描述
可售商品报告 (“库存报告”)

枚举值:_GET_FLAT_FILE_OPEN_LISTINGS_DATA_

API 操作:RequestReport

制表符分隔的、文本文件格式的可售商品报告,包含 SKU、ASIN、价格和数量输入项。针对商城和卖家平台卖家。
可售商品报告

枚举值:_GET_MERCHANT_LISTINGS_DATA_BACK_COMPAT_

API 操作:RequestReport

制表符分隔的、文本文件格式的可售商品报告。
卖家商品报告 (“在售商品报告”)

枚举值:_GET_MERCHANT_LISTINGS_DATA_

API 操作:RequestReport

制表符分隔的、文本文件格式的详细在售商品报告。针对商城和卖家平台卖家。
卖家商品报告(精简版) (“可售商品报告精简版”)

枚举值:_GET_MERCHANT_LISTINGS_DATA_LITE_

API 操作:RequestReport

制表符分隔的、文本文件格式的可售商品报告,仅包含数量大于零的商品的 SKU、ASIN、价格和数量输入项。针对商城和卖家平台卖家。
卖家商品报告(精简升级版) (“可售商品报告精简升级版”)

枚举值:_GET_MERCHANT_LISTINGS_DATA_LITER_

API 操作:RequestReport

制表符分隔的、文本文件格式的可售商品报告,仅包含数量大于零的商品的 SKU 和数量输入项。针对商城和卖家平台卖家。
已售商品报告

枚举值:_GET_CONVERGED_FLAT_FILE_SOLD_LISTINGS_DATA_

API 操作:RequestReport

制表符分隔的、文本文件格式的已售商品报告,包含商品在亚马逊平台销售情况。针对商城和卖家平台卖家。
已取消的商品报告

枚举值:_GET_MERCHANT_CANCELLED_LISTINGS_DATA_

API 操作:RequestReport

制表符分隔的、文本文件格式的已取消商品报告。针对商城和卖家平台卖家。
商品信息质量报告 (“商品信息质量和阻止上传的商品信息报告”)

枚举值:_GET_MERCHANT_LISTINGS_DEFECT_DATA_

API 操作:RequestReport

制表符分隔的、文本文件格式的商品信息质量报告,包含以下输入项:SKU、商品名称、ASIN、输入项名称、警告类型、当前价格、上次更新日期、警告名称以及状态。针对商城和卖家平台卖家。

订单报告

请注意,您在请求下载订单报告时指定的日期范围是订单可以进行配送(订单状态不是“等待中”)的时间,不是创建订单的时间。

报告 描述
待处理订单报告

枚举值:_GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_

API 操作:RequestReport

API 操作:ManageReportSchedule

制表符分隔的、文本文件格式的报告,仅包含尚未确认发货或尚未确认发票的订单。可以进行请求或计划。针对商城和卖家平台卖家。
该报告接受以下 ReportOptions 值:
  • ShowSalesChannel – 布尔值,指明是否在报告中额外显示一列销售渠道信息。默认值:false。URL 编码示例:ReportOptions=ShowSalesChannel%3Dtrue
XML 文件格式的、计划的订单报告

枚举值:_GET_ORDERS_DATA_

API 操作:ManageReportSchedule

XML 文件格式的、计划的订单报告。仅针对卖家平台卖家。

每次只能计划一个 _GET_ORDERS_DATA_ 或 _GET_FLAT_FILE_ORDERS_DATA_ 报告。如果您已经计划了其中某一报告,但又计划了新报告,则现有报告将被取消。

请求或计划的、文本文件格式的订单报告

枚举值:_GET_FLAT_FILE_ORDERS_DATA_

API 操作:RequestReport

API 操作:ManageReportSchedule

制表符分隔的、文本文件格式的订单报告,可请求生成或计划生成。报告显示过去 60 天内的订单。针对商城和卖家平台卖家。

卖家平台卖家每次只能计划一个 _GET_ORDERS_DATA_ 或 _GET_FLAT_FILE_ORDERS_DATA_ 报告。如果您已经计划了其中某一报告,但又计划了新报告,则现有报告将被取消。

商城卖家每次只能计划一个 _GET_FLAT_FILE_ORDERS_DATA_ 或 _GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_ 报告。如果您已经计划了其中某一报告,但又计划了新报告,则现有报告将被取消。

注: 根据您要计划还是请求该报告,其格式将稍有不同。
该报告接受以下 ReportOptions 值:
  • ShowSalesChannel – 布尔值,指明是否在报告中额外显示一列销售渠道信息。默认值:false。URL 编码示例:ReportOptions=ShowSalesChannel%3Dtrue
文本文件格式的订单报告

枚举值:_GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_

API 操作:RequestReport

API 操作:ManageReportSchedule

制表符分隔的、文本文件格式的订单报告,可请求生成或计划生成。仅针对商城卖家。

您每次只能计划一个 _GET_FLAT_FILE_ORDERS_DATA_ 或 _GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_ 报告。如果您已经计划了其中某一报告,但又计划了新报告,则现有报告将被取消。

注: 根据您要计划还是请求该报告,其格式将稍有不同。例如,日期格式将有所不同,而且当请求报告时,将仅返回配送方式一列。
该报告接受以下 ReportOptions 值:
  • ShowSalesChannel – 布尔值,指明是否在报告中额外显示一列销售渠道信息。默认值:false。URL 编码示例:ReportOptions=ShowSalesChannel%3Dtrue

订单追踪报告

这些订单追踪报告在北美 (NA) 和欧洲 (EU) 提供,但所有亚马逊卖家均可使用。这些报告将返回所有订单,无论配送渠道或货件状态如何。这些报告保用订单追踪目的,并不会对您的配送进程起到促进作用,因为报告不包含买家身份信息,且不支持计划生成。此外,对于卖家自行配送订单,如果其订单状态为“等待中”,则不会显示商品价格。

报告 描述
文本文件格式的、按最后更新日期排列的订单报告

枚举值:_GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API 操作:RequestReport

制表符分隔的、文本文件格式的报告,可返回指定日期范围内更新的所有订单。不支持计划生成。针对所有卖家。
文本文件格式的、按订单日期排列的订单报告

枚举值:_GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_

API 操作:RequestReport

制表符分隔的、文本文件格式的报告,可返回指定日期范围内下达的所有订单。不支持计划生成。针对所有卖家。
XML 格式的、按最后更新日期排列的订单报告

枚举值:_GET_XML_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API 操作:RequestReport

XML 格式的报告,可返回指定日期范围内更新的所有订单。不支持计划生成。针对所有卖家。
XML 格式的、按订单日期排列的订单报告

枚举值:_GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_

API 操作:RequestReport

XML 格式的报告,可返回指定日期范围内更新的所有订单。不支持计划生成。针对所有卖家。

等待中订单报告

这些等待中订单报告提供了日语和中文版本。而且,可以计划这些报告的下载时间或直接下载。

报告 描述
文本文件格式的等待中订单报告

枚举值:_GET_FLAT_FILE_PENDING_ORDERS_DATA_

API 操作:ManageReportSchedule

API 操作:RequestReport

制表符分隔的、文本文件格式的报告,包含所有等待中订单,可以直接下载或计划下载。针对所有卖家。
XML 格式的、等待中订单报告

枚举值:_GET_PENDING_ORDERS_DATA_

API 操作:ManageReportSchedule

API 操作:RequestReport

XML 格式的、包含所有等待中订单的报告,可以直接下载或计划下载。只能通过亚马逊 MWS 计划下载。
文本文件格式的综合等待中订单报告

枚举值:_GET_CONVERGED_FLAT_FILE_PENDING_ORDERS_DATA_

API 操作:ManageReportSchedule

API 操作:RequestReport

文本文件格式的、包含所有等待中订单的报告,可以直接下载或计划下载。针对商城卖家。

业绩报告

报告 描述
文本文件格式的反馈报告

枚举值:_GET_SELLER_FEEDBACK_DATA_

API 操作:RequestReport

制表符分隔的文本文件,返回买家对您的业绩的负面和中性反馈(1 到 3 星)。针对所有卖家。

结算报告

请注意,您不能请求或计划结算报告,而是由亚马逊自动计划的。

报告 描述
文本文件格式的结算报告

枚举值:_GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_

API 操作:GetReportList

API 操作:GetReport

亚马逊自动计划生成的制表符分隔的、文本文件格式的结算报告;不能通过 RequestReport 请求生成。针对所有卖家。
XML 格式的结算报告

枚举值:_GET_V2_SETTLEMENT_REPORT_DATA_XML_

API 操作:GetReportList

API 操作:GetReport

亚马逊自动计划生成的 XML 文件格式的结算报告;不能通过 RequestReport 请求生成。针对卖家平台卖家。
文本文件格式的 V2 结算报告

枚举值:_GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2_

API 操作:GetReportList

API 操作:GetReport

制表符分隔的、另一种文本文件格式的结算报告。价格列简缩成三个常用列:金额类型、金额描述和金额。该报告为亚马逊物流卖家自动计划生成;不能通过 RequestReport 请求生成。针对卖家平台卖家。

亚马逊物流 (FBA) 报告

亚马逊生成 FBA 报告的频率具有时间限制。根据 FBA 报告是接近实时报告还是每日报告,其限制也有所不同。请参阅下表了解哪些 FBA 报告是接近实时报告,哪些报告是每日报告。

接近实时 FBA 报告每隔大约 30 分钟生成一次。也就是说,在根据您的请求生成接近实时 FBA 报告后,需要再等 30 分钟,亚马逊才能再更新一次该报告。请注意,四个“所有订单”报告不受此限制约束。

每日 FBA 报告每隔大约 4 小时生成一次。也就是说,在根据您的请求生成每日 FBA 报告后,需要再等 4 小时,亚马逊才能再更新一次该报告。

有关更多信息,请参阅《亚马逊物流卖家 MWS 指南》的“不要频繁请求亚马逊物流报告”部分。

报告 描述
亚马逊物流销售报告
亚马逊物流货件报告

枚举值:_GET_AMAZON_FULFILLED_SHIPMENTS_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含详细的订单/货件/商品信息,包括价格、地址和追踪数据。可以请求在一个报告中包含一个月的数据。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
文本文件格式的、按最后更新日期排列的所有库存订单报告

枚举值:_GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API 操作:RequestReport

制表符分隔的文本文件。可返回指定日期范围内更新的所有订单,而不论其配送渠道或货件状态如何。该报告用于对订单进行追,并不会对您的配送进程起到促进作用;报告中不包含买家确认信息,也不支持计划生成。针对所有卖家。
按订单日期排列的所有库存数据文件订单报告

枚举值:_GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_

API 操作:RequestReport

制表符分隔的文本文件。可返回指定日期范围内下达的所有订单,而不论其配送渠道或货件状态如何。该报告用于对订单进行追,并不会对您的配送进程起到促进作用;报告中不包含买家确认信息,也不支持计划生成。针对所有卖家。
XML 文件格式的、按最后更新日期排列的所有订单报告

枚举值:_GET_XML_ALL_ORDERS_DATA_BY_LAST_UPDATE_

API 操作:RequestReport

XML 文件格式的订单报告,可返回指定日期范围内更新的所有订单,而不论其配送渠道或货件状态如。该报告用于对订单进行追,并不会对您的配送进程起到促进作用;报告中不包含买家确认信息,也不支持计划生成。针对所有卖家。
XML 文件格式的、按订单日期排列的所有订单报告

枚举值:_GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_

API 操作:RequestReport

XML 文件格式的订单报告,可返回指定日期范围内下达的所有订单,而不论其配送渠道或货件状态如何。该报告用于对订单进行追,并不会对您的配送进程起到促进作用;报告中不包含买家确认信息,也不支持计划生成。针对所有卖家。
亚马逊物流买家货件销售报告

枚举值:_GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_SALES_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含已发货亚马逊物流买家订单相关的压缩商品水平数据,其中包括价格、数量及送达地址。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流促销报告

枚举值:_GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_PROMOTION_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含适用于通过亚马逊销售亚马逊物流买家订单的相关促销,例如免费配送。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流买家税费

枚举值:_GET_FBA_FULFILLMENT_CUSTOMER_TAXES_DATA_

API 操作:RequestReport

制表符分隔的文本文件(针对需要交纳税费的美国卖家)。该报告包含自 2013 年 2 月 28 日以后的数据。销售税费报告中将包含所有新的交易数据。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流库存报告
亚马逊物流库存报告

枚举值:_GET_AFN_INVENTORY_DATA_

API 操作:RequestReport

制表符分隔的文本文件。报告内容接近实时更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流每日库存历史报告

枚举值:_GET_FBA_FULFILLMENT_CURRENT_INVENTORY_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含亚马逊运营中心中可用库存的以往每日快照,其中包括数量、位置及库存属性。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流每月库存历史报告

枚举值:_GET_FBA_FULFILLMENT_MONTHLY_INVENTORY_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含亚马逊运营中心中可用库存的以往每月快照,其中包括平均及月末数量、位置及库存属性。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流已收到库存报告

枚举值:_GET_FBA_FULFILLMENT_INVENTORY_RECEIPTS_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含亚马逊运营中心已完成接收的库存。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流库存事件详情报告

枚举值:_GET_FBA_FULFILLMENT_INVENTORY_SUMMARY_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含根据 SKU 和运营中心划分的库存事件(如接收、发货及盘点等)的历史记录。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流库存盘点报告

枚举值:_GET_FBA_FULFILLMENT_INVENTORY_ADJUSTMENTS_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含根据问题(损坏、丢失、接收分歧等)回复而对您库存所做出的更正及更新。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流库存状况报告

枚举值:_GET_FBA_FULFILLMENT_INVENTORY_HEALTH_DATA_

API 操作:RequestReport

制表符分隔的文本文件。该报告中包含库存货龄、状况、销售量、涵盖的时间段以及价格等信息。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流管理库存

枚举值:_GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA_

API 操作:RequestReport

制表符分隔的文本文件。该报告中包含在售(非存档)库存的当前详情,如状况、数量和销售量等。报告内容接近实时更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流管理库存 - 存档

枚举值:_GET_FBA_MYI_ALL_INVENTORY_DATA_

API 操作:RequestReport

制表符分隔的文本文件。该报告中包含所有(含存档)库存的当前详情,如如状况、数量和销售量等。报告内容接近实时更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流入库绩效报告

枚举值:_GET_FBA_FULFILLMENT_INBOUND_NONCOMPLIANCE_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含按商品和货件划分的入库货件问题。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流危险品状态更改报告

枚举值:_GET_FBA_HAZMAT_STATUS_CHANGE_DATA_

API 操作:RequestReport

制表符分隔的文本文件。显示您的库存商品的当前危险品状态,这将决定商品是否能运输至亚马逊配送中心。报告内容会每天更新。仅针对北美的亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流付款报告
亚马逊物流预计费用报告

枚举值:_GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含预计对您的当前亚马逊物流库存商品收取的亚马逊销售和配送费用。报告中的数据可能涵盖 72 小时。报告内容会每天更新。仅针对美国和欧洲的亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流赔偿报告

枚举值:_GET_FBA_REIMBURSEMENTS_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含详细的库存商品赔偿信息,包括赔偿原因。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流买家优惠报告
亚马逊物流退货报告

枚举值:_GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含亚马逊配送中心所收到的买家退货商品,其中包括退货原因和库存属性。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流换货报告

枚举值:_GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_REPLACEMENT_DATA_

API 操作:RequestReport

制表符分隔的文本文件。包含针对已完成订单而向买家所承诺的换货。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流移除报告
亚马逊物流建议移除商品报告

枚举值:_GET_FBA_RECOMMENDED_REMOVAL_DATA_

API 操作:RequestReport

制表符分隔的文本文件。如果在清除事件日期的 6 个星期内生成该报告,则该报告会包含在下一长期存储清除事件时库存时间达到 365 天或更长时间的可售商品。该报告包含可售和不可售商品。报告内容会每天更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流移除订单详情报告

枚举值:_GET_FBA_FULFILLMENT_REMOVAL_ORDER_DETAIL_DATA_

API 操作:RequestReport

制表符分隔的文本文件。该报告包含给定时间段内所有移除订单的信息(包括每个移除订单中的商品)。该报告可帮助核对要从亚马逊配送中心移除的商品总数与实际移除的商品总数,以及移除订单中每件商品的状态。报告内容接近实时更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。
亚马逊物流移除货件详情报告

枚举值:_GET_FBA_FULFILLMENT_REMOVAL_SHIPMENT_DETAIL_DATA_

API 操作:RequestReport

制表符分隔的文本文件。该报告提供了所有移除订单的追踪信息,并包括每个移除订单中或某个日期范围内,从亚马逊配送中心移除的商品。但是,该报告不包括取消的退还申请或弃置商品,仅包括货件信息。报告内容接近实时更新。仅针对亚马逊物流卖家。针对商城和卖家平台卖家。

亚马逊商品广告 报告

报告 描述
商品广告商品报告

枚举值:_GET_NEMO_MERCHANT_LISTINGS_DATA_

API 操作:RequestReport

制表符分隔的文本文件,详细的在售商品报告。仅针对亚马逊商品广告卖家。
按 SKU 排列的商品广告每日业绩报告,文本文件

枚举值:_GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_DAILY_DATA_TSV_

API 操作:ManageReportSchedule

API 操作:RequestReport

目前仅可在美国使用。制表符分隔的文本文件,包含获得流量的每个 SKU 的印象和点击量。买家看不到的 SKU 将不会显示。如果某天 SKU 未收到流量,则可能生成空白报告。
注: 如果请求多日报告,则仅对 StartDate 参数返回结果。将对该报告忽略 EndDate 参数。

报告次日早上 4 点(太平洋时间)可供使用,过去 90 天内的日期均可请求生成。仅针对亚马逊商品广告卖家。

按 SKU 排列的商品广告每日业绩报告,XML 文件

枚举值:_GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_DAILY_DATA_XML_

API 操作:ManageReportSchedule

API 操作:RequestReport

目前仅可在美国使用。XML 文件,包含获得流量的每个 SKU 的印象和点击量。买家看不到的 SKU 将不会显示。如果某天 SKU 未收到流量,则可能生成空白报告。
注: 如果请求多日报告,则仅对 StartDate 参数返回结果。将对该报告忽略 EndDate 参数。

报告次日早上 4 点(太平洋时间)可供使用,过去 90 天内的日期均可请求生成。仅针对亚马逊商品广告卖家。

按 SKU 排列的商品广告每周业绩报告,文本文件

枚举值:_GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_WEEKLY_DATA_TSV_

API 操作:ManageReportSchedule

API 操作:RequestReport

目前仅可在美国使用。制表符分隔的文本文件,包含获得流量的每个 SKU 的印象和点击量。买家看不到的 SKU 将不会显示。如果某周 SKU 未收到流量,则可能生成空白报告。
注: 每周报告涵盖周日到周六。如果请求多周报告,则仅对指定的第一周返回结果。StartDate 参数必须为周日,否则操作将返回空报告。因此,如果报告设置为非周日请求,则必须设置可选的 StartDate 参数,原因是 StartDate 参数默认为当天日期。

报告下个周一早上 4 点(太平洋时间)可供使用,过去 90 天内的日期均可请求生成。仅针对亚马逊商品广告卖家。

按 SKU 排列的商品广告每周业绩报告,XML 文件

枚举值:_GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_WEEKLY_DATA_XML_

API 操作:ManageReportSchedule

API 操作:RequestReport

目前仅可在美国使用。XML 文件,包含获得流量的每个 SKU 的印象和点击量。买家看不到的 SKU 将不会显示。如果某周 SKU 未收到流量,则可能生成空白报告。
注: 每周报告涵盖周日到周六。如果请求多周报告,则仅对指定的第一周返回结果。StartDate 参数必须为周日,否则操作将返回空报告。因此,如果报告设置为非周日请求,则必须设置可选的 StartDate 参数,原因是 StartDate 参数默认为当天日期。

报告下个周一早上 4 点(太平洋时间)可供使用,过去 90 天内的日期均可请求生成。仅针对亚马逊商品广告卖家。

按 SKU 排列的商品广告每月业绩报告,文本文件

枚举值:_GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_MONTHLY_DATA_TSV_

API 操作:ManageReportSchedule

API 操作:RequestReport

目前仅可在美国使用。制表符分隔的文本文件,包含获得流量的每个 SKU 的印象和点击量。买家看不到的 SKU 将不会显示。如果某月 SKU 未收到流量,则可能生成空白报告。每月报告涵盖每月的 1 号到最后一天。
注: 每月报告涵盖每月的 1 号到最后一天。如果请求多月报告,则仅对指定的第一个月返回结果。StartDate 参数必须为每月的第一天,否则操作将返回空报告。因此,如果报告设置为非每月第一天请求,则必须设置可选的 StartDate 参数,原因是 StartDate 参数默认为当天日期。

报告下个月 5 号早上 4 点(太平洋时间)可供使用,过去 90 天内的日期均可请求生成。仅针对亚马逊商品广告卖家。

按 SKU 排列的商品广告每月业绩报告,XML 文件

枚举值:_GET_PADS_PRODUCT_PERFORMANCE_OVER_TIME_MONTHLY_DATA_XML_

API 操作:ManageReportSchedule

API 操作:RequestReport

目前仅可在美国使用。XML 文本文件,包含获得流量的每个 SKU 的印象和点击量。买家看不到的 SKU 将不会显示。如果某月 SKU 未收到流量,则可能生成空白报告。
注: 每月报告涵盖每月的 1 号到最后一天。如果请求多月报告,则仅对指定的第一个月返回结果。StartDate 参数必须为每月的第一天,否则操作将返回空报告。因此,如果报告设置为非每月第一天请求,则必须设置可选的 StartDate 参数,原因是 StartDate 参数默认为当天日期。

报告下个月 5 号早上 4 点(太平洋时间)可供使用,过去 90 天内的日期均可请求生成。仅针对亚马逊商品广告卖家。

销售税费报告

报告 描述
销售税费报告

枚举值:_GET_FLAT_FILE_SALES_TAX_DATA_

API 操作:RequestReport

制表符分隔的文本文件(针对需要交纳税费的美国卖家)。报告内容会每天更新。针对商城和卖家平台卖家。

分类树报告

报告 描述
分类树报告

枚举值:_GET_XML_BROWSE_TREE_DATA_

API 操作:ManageReportSchedule

API 操作:RequestReport

XML 格式的报告,针对任一亚马逊商城网站,提供分类树结构信息以及节点优化信息。

可以进行请求或计划。针对商城和卖家平台卖家。

该报告接受以下 ReportOptions 值:

  • MarketplaceId – 指定要获取其分类树信息的商城。可选。如果 ReportOptions 参数未包含 MarketplaceId,则报告将包含您的默认商城的分类树信息。
    注: 您必须在使用 MarketplaceId 值指定的任一商城中注册卖家。而且,您的请求必须发送至符合您指定的 MarketplaceId 的端点。否则,服务将返回错误。您可以在《亚马逊 MWS 开发者指南》的“亚马逊 MWS 端点和 MarketplaceId 值”部分中查看 MarketplaceId 值和端点。
  • RootNodesOnly - 类型:xs:boolean。可选。如果为 true,则报告仅包含使用 MarketplaceId 指定的商城(或默认商城,如果未指定 MarketplaceId)的根节点。如果为 false,或 ReportOptions 参数未包含 RootNodesOnly,则报告的内容将将因 BrowseNodeId 的值而异。
  • BrowseNodeId – 指定报告中分类树结构的最高节点。可选。如果 ReportOptions 参数未包含 BrowseNodeId,且 RootNodesOnlyfalse 或未包含在 ReportOptions 参数中,则报告将包含使用 MarketplaceId 指定的商城(或默认商城,如果未指定 MarketplaceId)的整个分类树节点结构。请注意,如果在请求中包含了无效的 BrowseNodeId,则服务将返回不包含数据的报告。
注: 如果 ReportOptions 参数同时包含了 RootNodesOnlyBrowseNodeId,则优先使用 RootNodesOnly
注: 亚马逊建议您,在调用 RequestReport 操作来请求分类树报告时,不要包含 MarketplaceIdList 参数。如果 ReportOptions 参数的 MarketplaceIdList 值与 MarketplaceId 值存在冲突,则优先使用 MarketplaceId 值。

要了解更新了哪些分类树节点,亚马逊建议您每次请求报告时,将当前报告与上一次使用 ReportOptions 值请求的报告进行比较。

URL 编码示例:ReportOptions=MarketplaceId=ATVPDKIKX0DER;BrowseNodeId%3D15706661

分类树报告由以下 XSD 描述:https://images-na.ssl-images-amazon.com/images/G/01/mwsportal/doc/en_US/Reports/XSDs/BrowseTreeReport.xsd

注: 如果亚马逊更新了“亚马逊 MWS 报告 API”部分,我们可能会相应更新 BrowseTreeReport.xsd 架构。如果您选择使用此架构进行验证,请谨记这一点。请经常浏览亚马逊 MWS 讨论,了解 BrowseTreeReport.xsd 架构的更新通知。可以使用以下链接查看亚马逊 MWS 论坛: