| detail_url |
String |
否 |
http://item.taobao.com/item.htm?id=4947813209 |
商品url |
| num_iid |
Number |
否 |
1489161932 |
商品数字id |
| title |
String |
否 |
Google test item |
商品标题,不能超过60字节 |
| nick |
String |
否 |
tbtest561 |
卖家昵称 |
| type |
String |
否 |
fixed |
商品类型(fixed:一口价;auction:拍卖)注：取消团购 |
| desc |
String |
否 |
这是一个好商品 |
商品描述, 字数要大于5个字符，小于25000个字符 |
| skus |
Sku [] |
否 |
|
Sku列表。fields中只设置sku可以返回Sku结构体中所有字段，如果设置为sku.sku_id、sku.properties、sku.quantity等形式就只会返回相应的字段 |
| props_name |
String |
否 |
20000:3275069:品牌:盈讯;1753146:3485013:型号:F908;30606:112030:上市时间:2008年 |
商品属性名称。标识着props内容里面的pid和vid所对应的名称。格式为：pid1:vid1:pid_name1:vid_name1;pid2:vid2:pid_name2:vid_name2……(注：属性名称中的冒号":"被转换为："#cln#"; 分号";"被转换为："#scln#" ) |
| created |
Date |
否 |
2000-01-01 00:00:00 |
Item的发布时间，目前仅供taobao.item.add和taobao.item.get可用 |
| is_lightning_consignment |
Boolean |
否 |
true |
是否24小时闪电发货 |
| is_fenxiao |
Number |
是 |
0 |
非分销商品：0，代销：1，经销：2 |
| auction_point |
Number |
否 |
15 |
天猫订单抽佣比例，为5的倍数，最低0.5%。跟淘客佣金没有关系。 |
| property_alias |
String |
否 |
property |
属性值别名,比如颜色的自定义名称 |
| template_id |
String |
是 |
123456 |
页面模板id |
| after_sale_id |
Number |
否 |
123 |
售后服务ID,该字段仅在taobao.item.get接口中返回 |
| is_xinpin |
Boolean |
否 |
false |
标示商品是否为新品。 值含义：true-是，false-否。 |
| sub_stock |
Number |
是 |
1 |
商品是否支持拍下减库存:1支持;2取消支持(付款减库存);0(默认)不更改 集市卖家默认拍下减库存; 商城卖家默认付款减库存 |
| inner_shop_auction_template_id |
Number |
否 |
2185480 |
用户内店宝贝装修模板id |
| outer_shop_auction_template_id |
Number |
否 |
2185481 |
用户外店装修模板id |
| food_security |
FoodSecurity |
否 |
|
食品安全信息，包括：生产许可证编号、产品标准号、厂名、厂址等 |
| features |
String |
否 |
;tags:3522,7234;source:sell;sp:2; |
宝贝特征值， 只有在Top支持的特征值才能保存到宝贝上 |
| locality_life |
LocalityLife |
否 |
|
本地生活电子交易凭证业务，目前此字段只涉及到的信息为有效期: 如果有效期为起止日期类型，此值为2012-08-06,2012-08-16 如果有效期为【购买成功日 至】类型则格式为2012-08-16 如果有效期为天数类型则格式为3 |
| desc_module_info |
DescModuleInfo |
否 |
|
宝贝描述规范化模块锚点信息 |
| item_weight |
String |
否 |
10 |
商品的重量，用于按重量计费的运费模板。注意：单位为kg |
| item_size |
String |
否 |
bulk:10 |
表示商品的体积，用于按体积计费的运费模板。该值的单位为立方米（m3）。 该值支持两种格式的设置：格式1：bulk:3,单位为立方米(m3),表示直接设置为商品的体积。格式2：weight:10;breadth:10;height:10，单位为米（m） |
| with_hold_quantity |
Number |
否 |
12 |
预扣库存，即付款减库存的商品现在有多少处于未付款状态的订单 |
| paimai_info |
PaimaiInfo |
否 |
|
用于保存拍卖有关的信息 |
| valid_thru |
Number |
否 |
7 |
有效期,7或者14（默认是7天） |
| outer_id |
String |
是 |
34143554352 |
商家外部编码(可与商家外部系统对接)。需要授权才能获取。 |
| auto_fill |
String |
否 |
time_card |
代充商品类型。在代充商品的类目下，不传表示不标记商品类型（交易搜索中就不能通过标记搜到相关的交易了）。可选类型： no_mark(不做类型标记) time_card(点卡软件代充) fee_card(话费软件代充) |
| custom_made_type_id |
String |
否 |
1 |
定制工具Id |
| global_stock_type |
String |
否 |
1 |
全球购商品采购地信息（库存类型），有两种库存类型：现货和代购; 参数值为1时代表现货，值为2时代表代购 |
| global_stock_country |
String |
否 |
美国 |
全球购商品采购地信息（地区/国家），代表全球购商品的产地信息。 |
| cid |
Number |
否 |
132443 |
商品所属的叶子类目 id |
| seller_cids |
String |
否 |
2234445,3344466,446434 |
商品所属的店铺内卖家自定义类目列表 |
| props |
String |
否 |
135255:344454 |
商品属性 格式：pid:vid;pid:vid |
| input_pids |
String |
否 |
2432,5353,656425 |
用户自行输入的类目属性ID串。结构："pid1,pid2,pid3"，如："20000"（表示品牌） 注：通常一个类目下用户可输入的关键属性不超过1个。 |
| input_str |
String |
否 |
耐克;耐克系列;科比系列;科比系列;2K5 |
用户自行输入的子属性名和属性值，结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如：“耐克;耐克系列;科比系列;科比系列;2K5”，input_str需要与input_pids一一对应，注：通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过 3999字节。 |
| pic_url |
String |
否 |
http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg |
商品主图片地址 |
| num |
Number |
否 |
8888 |
商品数量 |
| list_time |
Date |
否 |
2009-10-22 14:22:06 |
上架时间（格式：yyyy-MM-dd HH:mm:ss） |
| delist_time |
Date |
否 |
2000-01-01 00:00:00 |
下架时间（格式：yyyy-MM-dd HH:mm:ss） |
| stuff_status |
String |
否 |
new |
商品新旧程度(全新:new，闲置:unused，二手：second) |
| location |
Location |
否 |
|
商品所在地 |
| price |
Price |
否 |
5.00 |
商品价格，格式：5.00；单位：元；精确到：分 |
| post_fee |
Price |
否 |
5.00 |
平邮费用,格式：5.00；单位：元；精确到：分 |
| express_fee |
Price |
否 |
5.00 |
快递费用,格式：5.00；单位：元；精确到：分 |
| ems_fee |
Price |
否 |
5.00 |
ems费用,格式：5.00；单位：元；精确到：分 |
| has_discount |
Boolean |
否 |
true |
支持会员打折,true/false |
| freight_payer |
String |
否 |
seller |
运费承担方式,seller（卖家承担），buyer(买家承担） |
| has_invoice |
Boolean |
否 |
true |
是否有发票,true/false |
| has_warranty |
Boolean |
否 |
true |
是否有保修,true/false |
| has_showcase |
Boolean |
否 |
true |
橱窗推荐,true/false |
| modified |
Date |
否 |
2000-01-01 00:00:00 |
商品修改时间（格式：yyyy-MM-dd HH:mm:ss） |
| increment |
String |
是 |
0 |
加价幅度。如果为0，代表系统代理幅度。 在竞拍中，为了超越上一个出价，会员需要在当前出价上增加金额，这个金额就是加价幅度。卖家在发布宝贝的时候可以自定义加价幅度，也可以让系统自动代理加价。系统自动代理加价的加价幅度随着当前出价金额的增加而增加，我们建议会员使用系统自动代理加价，并请买家在出价前看清楚加价幅度的具体金额。另外需要注意是，此功能只适用于拍卖的商品。 以下是系统自动代理加价幅度表： 当前价（加价幅度 ） 1-40（ 1 ）、41-100（ 2 ）、101-200（5 ）、201-500 （10）、501-1001（15）、001-2000（25）、2001-5000（50）、5001-10000（100） 10001以上 200 |
| approve_status |
String |
否 |
onsale |
商品上传后的状态。onsale出售中，instock库中 |
| postage_id |
Number |
否 |
32 |
宝贝所属的运费模板ID，如果没有返回则说明没有使用运费模板 |
| product_id |
Number |
是 |
85883030 |
宝贝所属产品的id(可能为空). 该字段可以通过taobao.products.search 得到 |
| item_imgs |
ItemImg [] |
否 |
|
商品图片列表(包括主图)。fields中只设置item_img可以返回ItemImg结构体中所有字段，如果设置为item_img.id、item_img.url、item_img.position等形式就只会返回相应的字段 |
| prop_imgs |
PropImg [] |
否 |
|
商品属性图片列表。fields中只设置prop_img可以返回PropImg结构体中所有字段，如果设置为prop_img.id、prop_img.url、prop_img.properties、prop_img.position等形式就只会返回相应的字段 |
| is_virtual |
Boolean |
否 |
true |
虚拟商品的状态字段 |
| is_taobao |
Boolean |
否 |
true |
是否在淘宝显示 |
| is_ex |
Boolean |
否 |
true |
是否在外部网店显示 |
| is_timing |
Boolean |
否 |
true |
是否定时上架商品 |
| videos |
Video [] |
否 |
|
商品视频列表(目前只支持单个视频关联)。fields中只设置video可以返回Video结构体中所有字段，如果设置为video.id、video.video_id、 video.url等形式就只会返回相应的字段 |
| is_3D |
Boolean |
否 |
true |
是否是3D淘宝的商品 |
| one_station |
Boolean |
否 |
true |
是否淘1站商品 |
| second_kill |
String |
否 |
web_only |
秒杀商品类型。打上秒杀标记的商品，用户只能下架并不能再上架，其他任何编辑或删除操作都不能进行。如果用户想取消秒杀标记，需要联系小二进行操作。如果秒杀结束需要自由编辑请联系活动负责人（小二）去掉秒杀标记。可选类型 web_only(只能通过web网络秒杀) wap_only(只能通过wap网络秒杀) web_and_wap(既能通过web秒杀也能通过wap秒杀) |
| violation |
Boolean |
否 |
true |
商品是否违规，违规：true , 不违规：false |
| wap_desc |
String |
否 |
Wap宝贝详情 |
不带html标签的desc文本信息，该字段只在taobao.item.get接口中返回 |
| wap_detail_url |
String |
否 |
http://auction1.wap.taobao.com/auction/item_detail-0db0-1234567.jhtml |
适合wap应用的商品详情url ，该字段只在taobao.item.get接口中返回 |
| cod_postage_id |
Number |
否 |
53899 |
货到付款运费模板ID |
| sell_promise |
Boolean |
否 |
true |
是否承诺退换货服务! |
