Amazon MWS API获取非活跃商品与库存报告指南

理解获取非活跃商品的挑战

许多亚马逊卖家面临一个共同的问题：如何通过MWS API全面获取其账户中的所有非活跃商品，尤其是那些因“潜在高价”警告而被抑制的商品。常见的报告类型，如GET_MERCHANT_LISTINGS_INACTIVE_DATA、GET_MERCHANT_CANCELLED_LISTINGS_DATA或GET_MERCHANT_LISTINGS_DEFECT_DATA，往往无法提供所有所需的信息，或者无法涵盖所有类型的非活跃状态。例如，在卖家中心“价格健康”页面中可见的那些因价格问题而受影响的商品，通常难以通过这些标准报告直接获取。为了克服这一局限，我们需要利用MWS中更广泛的商品列表和库存报告。

推荐的MWS报告类型

以下四种MWS报告类型被认为是获取包括非活跃商品在内的全面商品数据的有效途径。它们各自侧重于不同的数据维度，但结合使用或选择最适合的报告，可以帮助您捕获那些难以通过常规“非活跃”报告获取的商品信息。

1. GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA (FBA我的未抑制库存数据)

   • 描述： 此报告提供您的FBA库存中所有未被亚马逊抑制（Unsuppressed）的商品数据。即使商品当前库存为零或处于不可售状态，只要它未被完全抑制，就可能包含在此报告中。
   • 适用性： 对于FBA卖家，此报告是获取FBA商品详细状态的关键。它可能包含那些因“潜在高价”而导致不可售但尚未被完全抑制的商品。通过分析报告中的商品状态和库存数量，可以识别出非活跃的FBA商品。

2. GET_MERCHANT_LISTINGS_DATA_LITE (商家商品列表数据精简版)

   • 描述： 这是一份精简的商家所有商品列表报告，通常包含SKU、ASIN、商品名称、价格、库存数量和商品状态等基本信息。
   • 适用性： 尽管是“精简版”，但它旨在提供您所有在售（或曾售）商品的概览。非活跃商品，尤其是那些库存为零或被设置为非在售状态的商品，很可能出现在此报告中。通过筛选库存数量为零或状态标记为非在售的商品，可以识别出大部分非活跃商品。

3. GET_FBA_FULFILLMENT_MONTHLY_INVENTORY_DATA (FBA月度库存数据)

   • 描述： 此报告提供FBA库存的月度快照，详细记录了在特定月份内，商品在亚马逊运营中心的库存情况，包括可售、不可售、在途等状态。
   • 适用性： 虽然是历史数据，但对于分析FBA商品的长期活跃度或识别在某个时间段内持续非活跃的商品非常有用。通过比较不同月份的数据，可以追踪商品的活跃趋势，并识别那些长期没有销售或库存异常的商品。

4. GET_MERCHANT_LISTINGS_ALL_DATA (商家所有商品列表数据)

   • 描述： 这是最全面的商家商品列表报告，包含了您所有商品（包括FBA和FBM）的详细信息，如SKU、ASIN、商品名称、价格、库存、商品状况、卖家ID、商品状态（Active/Inactive）等。
   • 适用性： 这是获取所有商品（包括所有类型的非活跃商品）最推荐的报告。它通常会明确标示商品的活跃状态。对于因“潜在高价”等原因被抑制的商品，即使它们在卖家中心显示为非活跃，也极有可能包含在此报告中，并且报告中的价格信息可以帮助您进一步分析其非活跃的原因。

MWS报告获取流程概述

获取MWS报告通常涉及以下步骤：

1. 请求报告 (RequestReport)： 使用RequestReport操作，指定您希望获取的报告类型（例如，_GET_MERCHANT_LISTINGS_ALL_DATA_）。
2. 检查报告请求状态 (GetReportRequestList)： MWS报告是异步生成的。您需要定期调用GetReportRequestList来检查您的报告请求状态，直到报告状态变为_DONE_。
3. 获取报告 (GetReport)： 当报告生成完成后，使用GetReport操作和报告ID来下载报告内容。

示例（伪代码，仅为说明报告类型参数）：

  
    ATVPDKIKX0DER 
  
  _GET_MERCHANT_LISTINGS_ALL_DATA_ 
  ShowSalesChannel=true 
  amzn.mws.xxxx
  A1EXAMPLE

注意事项与最佳实践

• 数据后处理： MWS报告通常以制表符分隔的文本文件（TSV）形式提供。下载报告后，您需要编写程序或使用数据处理工具对其进行解析和筛选。例如，对于GET_MERCHANT_LISTINGS_ALL_DATA，您可以根据报告中的“quantity”（库存数量）字段或“status”（状态）字段来识别非活跃商品。对于“潜在高价”问题，您可以结合报告中的价格数据进行分析。
• 报告频率与数据量： 某些报告可能包含大量数据，尤其对于拥有众多SKU的卖家。请注意MWS的请求配额和处理时间。
• MWS的未来： 请注意，亚马逊MWS API已逐渐被销售伙伴API (SP-API) 取代。虽然MWS仍可用于现有集成，但亚马逊鼓励开发者迁移到SP-API。SP-API提供了更现代的架构和更丰富的功能，未来获取类似数据可能需要通过SP-API的“列表项目”或“库存”相关操作。如果可能，建议考虑向SP-API迁移。
• 理解“非活跃”的定义： 在MWS报告中，“非活跃”可能以多种形式体现，如库存为零、商品状态被标记为“Inactive”、或者通过其他字段（如价格、销售权限）间接反映。您需要根据报告内容和您的业务需求来定义和筛选。

总结

通过利用GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA、GET_MERCHANT_LISTINGS_DATA_LITE、GET_FBA_FULFILLMENT_MONTHLY_INVENTORY_DATA和GET_MERCHANT_LISTINGS_ALL_DATA这些MWS报告，卖家能够更全面地获取包括各类非活跃商品在内的所有商品数据。尤其是GET_MERCHANT_LISTINGS_ALL_DATA，它通常能提供最完整的信息。获取报告后，进行适当的数据解析和筛选是识别特定非活跃商品（如因“潜在高价”受影响的商品）的关键步骤。同时，请关注亚马逊SP-API的最新发展，为未来的API集成做好准备。