文档中心 > API文档

aliexpress.offer.ds.product.simplequery (Dropshipper查询单个商品的简易信息)

提供给Dropshipper的通过商品ID查找商品简易信息(包括SKU-价格/库存、产品状态等)的接口,只有特定买家可以使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 可选 1307422965 商品ID
local_country String 可选 RU 国家
local_language String 可选 ru 语言

响应参数

名称 类型 示例值 描述
item_offer_site_sale_price String 5.5 网站折扣后价格
total_available_stock Number 12 库存
aeop_ae_product_s_k_us AeopAeProductSku [] n/a 商品的SKU信息
  • aeop_s_k_u_property_list
  • AeopSkuProperty []
  • n/a
  • SKU属性对象列表
  • └ sku_property_id
  • Number
  • 14
  • SKU属性ID
  • └ sku_image
  • String
  • http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg
  • SKU图片地址
  • └ property_value_id
  • Number
  • 366
  • SKU属性值ID
  • └ property_value_definition_name
  • String
  • pink
  • 属性值自定义名称
  • └ s_k_u_available_stock
  • Number
  • 10
  • sku库存
  • └ sku_stock
  • Boolean
  • true
  • Sku库存,数据格式有货true,无货false;至少有一条sku记录是有货的。
  • └ sku_price
  • String
  • 200.07
  • Sku价格。取值范围:0.01-100000;单位:美元。 如:200.07,表示:200美元7分。需要在正确的价格区间内。
  • └ ipm_sku_stock
  • Number
  • 1234
  • SKU实际可售库存属性ipmSkuStock,该属性值的合理取值范围为0~999999,如该商品有SKU时,请确保至少有一个SKU是有货状态,也就是ipmSkuStock取值是1~999999,在整个商品纬度库存值的取值范围是1~999999。 如果同时设置了skuStock属性,那么系统以ipmSkuStock属性为优先;如果没有设置ipmSkuStock属性,那么系统会根据skuStock属性进行设置库存,true表示999,false表示0。
  • └ id
  • String
  • 200000182:193;200007763:201336100
  • SKU ID
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • └ offer_sale_price
  • String
  • 3.3
  • sku折扣价格
  • └ offer_bulk_sale_price
  • String
  • 3.2
  • sku批量折扣价
  • └ sku_bulk_order
  • Number
  • 10
  • 最少起批的数量
product_status_type String onSelling 产品的状态

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressOfferDsProductSimplequeryRequest req = new AliexpressOfferDsProductSimplequeryRequest();
req.setProductId(1307422965L);
req.setLocalCountry("RU");
req.setLocalLanguage("ru");
AliexpressOfferDsProductSimplequeryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_offer_ds_product_simplequery_response>
    <item_offer_site_sale_price>5.5</item_offer_site_sale_price>
    <total_available_stock>12</total_available_stock>
    <aeop_ae_product_s_k_us>
        <aeop_ae_product_sku>
            <aeop_s_k_u_property_list>
                <aeop_sku_property>
                    <sku_property_id>14</sku_property_id>
                    <sku_image>http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg</sku_image>
                    <property_value_id>366</property_value_id>
                    <property_value_definition_name>pink</property_value_definition_name>
                </aeop_sku_property>
            </aeop_s_k_u_property_list>
            <s_k_u_available_stock>10</s_k_u_available_stock>
            <sku_stock>true</sku_stock>
            <sku_price>200.07</sku_price>
            <ipm_sku_stock>1234</ipm_sku_stock>
            <id>200000182:193;200007763:201336100</id>
            <currency_code>USD</currency_code>
            <offer_sale_price>3.3</offer_sale_price>
            <offer_bulk_sale_price>3.2</offer_bulk_sale_price>
            <sku_bulk_order>10</sku_bulk_order>
        </aeop_ae_product_sku>
    </aeop_ae_product_s_k_us>
    <product_status_type>onSelling</product_status_type>
</aliexpress_offer_ds_product_simplequery_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部