taobao.item.sku.get.tmall (taobao.item.sku.get.tmall)

获取sku_id所对应的sku数据 sku_id对应的sku要属于传入的nick对应的卖家

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 sku_id,iid,properties,quantity,price,outer_id,created,modified,status 需返回的字段列表。可选值:Sku结构体中的所有字段;字段之间用“,”分隔。
sku_id Number 必须 81893848 Sku的id。可以通过taobao.item.get得到
num_iid Number 可选 123456 商品的数字IID(num_iid和nick必传一个,推荐用num_iid),传商品的数字id返回的结果里包含cspu(SKu上的产品规格信息)。

响应参数

名称 类型 示例值 描述
sku Sku Sku
  • └ sku_id
  • Number
  • 123
  • sku的id
  • └ iid
  • String
  • asdf12323adfaa
  • sku所属商品id(注意:iid近期即将废弃,请用num_iid参数)
  • └ num_iid
  • Number
  • 12345
  • sku所属商品数字id
  • └ properties
  • String
  • 1243:1215;5626:5125
  • sku的销售属性组合字符串(颜色,大小,等等,可通过类目API获取某类目下的销售属性),格式是p1:v1;p2:v2
  • └ properties_name
  • String
  • 20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1
  • sku所对应的销售属性的中文名字串,格式如:pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……
  • └ quantity
  • Number
  • 3
  • 属于这个sku的商品的数量,
  • └ price
  • String
  • 200.07
  • 属于这个sku的商品的价格 取值范围:0-100000000;精确到2位小数;单位:元。如:200.07,表示:200元7分。
  • └ outer_id
  • String
  • 12345
  • 商家设置的外部id。天猫和集市的卖家,需要登录才能获取到自己的商家编码,不能获取到他人的商家编码。
  • └ created
  • String
  • 2009-11-04 15:24:43
  • sku创建日期 时间格式:yyyy-MM-dd HH:mm:ss
  • └ modified
  • String
  • 2009-11-04 15:24:43
  • sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss
  • └ status
  • String
  • normal
  • sku状态。 normal:正常 ;delete:删除
  • └ sku_spec_id
  • Number
  • specId
  • └ with_hold_quantity
  • Number
  • 100
  • 商品在付款减库存的状态下,该sku上未付款的订单数量
  • └ barcode
  • String
  • 6903244981002
  • 商品级别的条形码
  • └ delivery_time_type
  • String
  • skuDeliveryTimeType
  • └ sku_delivery_time
  • String
  • skuDeliveryTime
  • └ change_prop
  • String
  • changeProp

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemSkuGetTmallRequest req = new ItemSkuGetTmallRequest();
req.setFields("sku_id,iid,properties,quantity,price,outer_id,created,modified,status");
req.setSkuId(81893848L);
req.setNumIid(123456L);
ItemSkuGetTmallResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<item_sku_get_tmall_response>
    <sku>
        <sku_id>123</sku_id>
        <iid>asdf12323adfaa</iid>
        <num_iid>12345</num_iid>
        <properties>1243:1215;5626:5125</properties>
        <properties_name>20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;-1234:-5678:自定义属性1:属性值1</properties_name>
        <quantity>3</quantity>
        <price>200.07</price>
        <outer_id>12345</outer_id>
        <created>2009-11-04 15:24:43</created>
        <modified>2009-11-04 15:24:43</modified>
        <status>normal</status>
        <sku_spec_id></sku_spec_id>
        <with_hold_quantity>100</with_hold_quantity>
        <barcode>6903244981002</barcode>
        <delivery_time_type></delivery_time_type>
        <sku_delivery_time></sku_delivery_time>
        <change_prop></change_prop>
    </sku>
</item_sku_get_tmall_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>

错误码解释

错误码 错误描述 解决方案
isv.missing-parameter:nick-or-numIid 缺少必须参数: nick 或 num_iid nick 或 num_iid至少传入一个
isv.user-not-exist:invalid-nick user 不存在
isv.item-sku-get-service-error 通过skuId获取SKU失败 1,用户传入的nick和sku_id不匹配或者num_iid和sku_id不匹配,可以用taobao.item.get获取nick或num_iid对应的sku_iid,在前端作好判断 2,用户指定的num_iid不存在(已删除、不存在、已经进历史库),出现这个错,本地数据库删除掉对应的数据
错误码:40,子错误码:null 缺少必要的传入参数

API工具

如何获得此API

FAQ

返回
顶部