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

GetLowestOfferListingsForSKU

根据 SellerSKU,返回价格最低的在售商品的价格信息。

描述

GetLowestOfferListingsForSKU 操作会根据商品状况返回一个指定商品的最低报价。具有指定商品信息和 ItemCondition 的商品位于商品组中,每个组都包含以下六个不同的限定条件:

  • ItemConditionNewUsedCollectibleRefurbishedClub
  • ItemSubconditionNewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen BoxOther)
  • FulfillmentChannelAmazonMerchant
  • ShipsDomesticallyTrueFalseUnknown) – 表明请求中指定的商城与商品的起运地是否属于同一国家/地区。
  • ShippingTime0-2 天3-7 天8-13 天 或者 14 天或以上) – 表明下订单后商品配送可能需要的最多天数。
  • SellerPositiveFeedbackRating98-100%95-97%90-94%80-89%70-79%低于 70%新卖家)– 表明在过去 12 个月内正面反馈的百分比。

具有指定商品信息和 ItemCondition 的某些(并不一定是所有)在售商品(最初按最低到岸价格排列)被放入其相应的商品组,且将返回各组中具有最低到岸价格的商品。如果有多个卖家的在售商品具有组中的最低到岸价格,则将返回具有最高反馈计数的卖家的商品。不会返回无任何商品的组。

此操作会返回 AllOfferListingsConsidered 响应元素,该元素表明对于具有指定商品信息和 ItemCondition 的在售商品,在将此类商品放入相应商品组时,是否会考虑所有此类商品。请注意,即使并未考虑全部商品,您仍然能够获得以下结果。

  • 返回的最低到岸价格是各自商品组中的最低到岸价格。
  • 返回的最低到岸价格低于未被纳入考虑范围的任何商品的到岸价格。
注: 当您提交 GetLowestOfferListingsForSKU 操作时,响应中会包含您自己的商品,除非您将 ExcludeMe 请求参数的值设置为 True

请求参数

名称 描述 必填项
MarketplaceId

商城编码。指定返回价格的商城。

类型:xs:string

SellerSKUList

一个 SellerSKU 值的结构化列表。用于标识指定商城中的商品。SellerSKU 由您的 SellerId 限定,您提交的每个亚马逊商城网络服务(亚马逊 MWS)操作都需要包含您的 SellerId。

最大值:20 个 SellerSKU

ItemCondition

根据商品状况筛选将被纳入考虑范围的商品。

有效值:AnyNewUsedCollectibleRefurbishedClub

可选

默认值:Any

ExcludeMe

从返回的商品中排除您自己的商品。

有效值:
  • True – 返回的报价中不包含您自己的商品。
  • False – 返回的报价中包含您自己的商品。

可选

默认值:False

响应元素

GetLowestOfferListingsForSKU 操作会返回 Product 响应元素,该元素由以下公用 XSD 描述:ProductsAPI_Response.xsddefault.xsdGetLowestOfferListingsForSKU 操作会返回 Products 响应元素的以下两个子元素:IdentifiersLowestOfferListings

名称 描述
AllOfferListingsConsidered 表明对于具有指定商品信息和 ItemCondition 的商品,在将此类商品放入相应商品组时,是否会考虑所有此类商品。如果有很多卖家正在销售具有指定商品信息和 ItemCondition 的商品,只会考虑其中一部分卖家的商品。被纳入考虑范围的商品的到岸价格总是低于未被纳入考虑范围的商品的到岸价格。
Product 包含 ProductsAPI_Response.xsd 中 Product 元素的两个子元素。这两个子元素是:IdentifiersLowestOfferListings
Identifiers 包含以下能够唯一标识商品的编码:
  • MarketplaceASINMarketplaceIdASIN 组合。
  • SKUIdentifierMarketplaceIdSellerSKUSellerId 组合。
LowestOfferListings

包含各个商品组中最低商品价格信息。

以下是一些关键的子元素:
  • Qualifiers。包含六个限定条件:ItemConditionItemSubconditionFulfillmentChannelShipsDomesticallyShippingTimeSellerPositiveFeedbackRating。这些限定条件表明最低商品价格来自哪个商品组。
  • NumberOfOfferListingsConsidered。这个数字表明有多少纳入考虑范围的商品来自于此商品组。请注意,如果 AllOfferListingsConsidered 的返回值为 TrueNumberOfOfferListingsConsidered 的值则为符合商品组六个限定条件的在售商品的实际数量。然而,如果 AllOfferListingsConsidered 的返回值为 False,则实际数量可能更高。
  • SellerFeedbackCount。提交给组中商品价格最低的卖家的反馈评级数量。
  • Price。组中最低商品价格信息。包括商品价格,并且可选择是否包含运费和到岸价格(商品价格+运费)。请注意,如果未返回到岸价格,则商品价格对应的是具有最低到岸价格的商品。
  • MultipleOfferListingsAtLowestPrice。表明组中是否有多件最低价格商品。

    有效值:

    • True – 组中有多件最低价格商品。
    • False – 组中只有一件最低价格商品。
    • Unknown – 服务无法确定组中是否有多件最低价格商品。如果对商品分组时没有考虑所有在售商品 (AllOfferListingsConsidered = False),则会出现此情况。

示例

查询请求示例

https://mws.amazonservices.com/Products/2011-10-01
?AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetLowestOfferListingsForSKU
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&SellerId=A1IMEXAMPLEWRC
&SignatureVersion=2
&Timestamp=2012-12-04T21%3A53%3A02Z
&Version=2011-10-01
&Signature=FUcIEXAMPLETUGtTS6sqNDt3OuLH8tbhz5YEXAMPLEw%3D
&SignatureMethod=HmacSHA256
&MarketplaceId=ATVPDKIKX0DER
&ExcludeMe=false
&SellerSKUList.SellerSKU.1=SKU2468

响应示例

<?xml version="1.0"?>
<GetLowestOfferListingsForSKUResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetLowestOfferListingsForSKUResult SellerSKU="SKU2468" status="Success">
  <AllOfferListingsConsidered>false</AllOfferListingsConsidered>
  <Product xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01"
           xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
    <Identifiers>
      <MarketplaceASIN>
        <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
        <ASIN>1933890517</ASIN>
      </MarketplaceASIN>
      <SKUIdentifier>
        <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
        <SellerId>A1IMEXAMPLEWRC</SellerId>
        <SellerSKU>SKU2468</SellerSKU>
      </SKUIdentifier>
    </Identifiers>
    <LowestOfferListings>
      <LowestOfferListing>
        <Qualifiers>
          <ItemCondition>Used</ItemCondition>
          <ItemSubcondition>Acceptable</ItemSubcondition>
          <FulfillmentChannel>Merchant</FulfillmentChannel>
          <ShipsDomestically>True</ShipsDomestically>
          <ShippingTime>
            <Max>0-2 days</Max>
          </ShippingTime>
          <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
        </Qualifiers>
        <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered>
        <SellerFeedbackCount>8900</SellerFeedbackCount>
        <Price>
          <LandedPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>28.68</Amount>
          </LandedPrice>
          <ListingPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>24.69</Amount>
          </ListingPrice>
          <Shipping>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>3.99</Amount>
          </Shipping>
        </Price>
        <MultipleOffersAtLowestPrice>True</MultipleOffersAtLowestPrice>
      </LowestOfferListing>
      <LowestOfferListing>
        <Qualifiers>
          <ItemCondition>Used</ItemCondition>
          <ItemSubcondition>Good</ItemSubcondition>
          <FulfillmentChannel>Amazon</FulfillmentChannel>
          <ShipsDomestically>True</ShipsDomestically>
          <ShippingTime>
            <Max>0-2 days</Max>
          </ShippingTime>
          <SellerPositiveFeedbackRating>90-94%</SellerPositiveFeedbackRating>
        </Qualifiers>
        <NumberOfOfferListingsConsidered>1</NumberOfOfferListingsConsidered>
        <SellerFeedbackCount>1569694</SellerFeedbackCount>
        <Price>
          <LandedPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>30.50</Amount>
          </LandedPrice>
          <ListingPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>30.50</Amount>
          </ListingPrice>
          <Shipping>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>0.00</Amount>
          </Shipping>
        </Price>
        <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
      </LowestOfferListing>
      <LowestOfferListing>
        <Qualifiers>
          <ItemCondition>Used</ItemCondition>
          <ItemSubcondition>Good</ItemSubcondition>
          <FulfillmentChannel>Merchant</FulfillmentChannel>
          <ShipsDomestically>True</ShipsDomestically>
          <ShippingTime>
            <Max>0-2 days</Max>
          </ShippingTime>
          <SellerPositiveFeedbackRating>95-97%</SellerPositiveFeedbackRating>
        </Qualifiers>
        <NumberOfOfferListingsConsidered>3</NumberOfOfferListingsConsidered>
        <SellerFeedbackCount>7732</SellerFeedbackCount>
        <Price>
          <LandedPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>30.99</Amount>
          </LandedPrice>
          <ListingPrice>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>27.00</Amount>
          </ListingPrice>
          <Shipping>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>3.99</Amount>
          </Shipping>
        </Price>
        <MultipleOffersAtLowestPrice>False</MultipleOffersAtLowestPrice>
      </LowestOfferListing>
    </LowestOfferListings>
  </Product>
</GetLowestOfferListingsForSKUResult>
<ResponseMetadata>
  <RequestId>8106ed19-9a90-4820-881e-EXAMPLE0ab97</RequestId>
</ResponseMetadata>
</GetLowestOfferListingsForSKUResponse>