方法 : taobao.open.item.generateId()
返回值 ： boolean: success //是否成功
long : itemId //商品ID
String : message //错误提示
方法 ： taobao.open.item.publish(String itemJson)
返回值 ： boolean: success //是否成功
long : itemId //商品ID
String : message //错误提示
推荐发布商品前，先使用taobao.open.item.generateId()预生成一个商品ID，再调用taobao.open.item.publish(String itemJson)方法来发布商品，将预生成的商品ID放进itemJson中。商品发布之后的默认状态为有效。库存默认值为1。
itemJson格式为：
{
"_sys":{
"category": ["服装", "女装"],
"endpoint": "web",
"schemaVersion": 0,
"itemId": 123213,
"title": "qwqwe",
"price": 123.89,
"inventory": 123,
"dataVersion":1,
"outerId":"abc123"
},
"自定义key1":"自定义value1",
"自定义key2":"自定义value2"
}
“_sys”中的内容，是系统要求传入的内容，目前调用publish时必须传入的key有:category，title。Category见最后表(category分类)，其他key选填。各个key的解释见文档最后(json中预留key的说明)的表。
关于去重
如果因为系统或者代码原因，同一个商品短时间(几分钟内)重复调用发布接口进行发布，服务端会根据itemId进行重复的校验，来保证不会重复发布。itemId只能是调用generateId()方法生成的，任意值传入不生效。如果不想用generateId()来生成itemId，ISV可以在json中传入outerId来作为判重的校验。判重优先级为: 先根据itemId判断，如果没有itemId，根据outerId判断，如果没有outerId，不进行判重。
接口文档地址：点击查看
方法 : taobao.open.item.inventory.decr(long itemId , int num)
返回值 ： boolean: success //是否成功
String : message //错误提示
方法 : taobao.open.item.inventory.Incr(long itemId , int num)
返回值 ： boolean: success //是否成功
String : message //错误提示
商品库存有ISV自行控制。
减库存正确用法为：在ISV应用中，创建订单成功之后，再减对应的库存数。服务端交易功能会在订单生成过程中，来校验商品库存是否足够，如果不足够，创建订单会失败。所以如果ISV不想控制库存，那么每次生成订单之后，也可以不调用减库存接口，那么就完全有ISV本地代码控制自己商品的库存。特别说明：商品发布之后，如果没有传入库存字段，默认库存为1。当库存减到0之后，商品状态由有效变为失效。
方法 : taobao.open.item.status.modify(long itemId , int status)
返回值 ： boolean: success //是否成功
String : message //错误提示
修改商品状态。status可以使用的值包括：
有效 |
失效 |
删除 |
1 |
0 |
-1 |
失效后的商品，可以根据商品ID查到，删除的商品，不能查到。只有有效的商品，创建交易订单才能成功。
方法 : taobao.open.item.modify(long ItemId , String itemJson,String deletePaths)
返回值 ： boolean: success //是否成功
String : message //错误提示
该接口可以修改商品所有字段，修改的时候，只有设置过值的字段，才会修改。如果要删除某字段，需要将该字段在json中的路径传入deletePaths。
比如:
{
"_sys":{
"category": ["服装", "女装"],
"endpoint": "web",
"schemaVersion": 0,
"itemId": 123213,
"title": "qwqwe",
"price": 123.89,
"inventory": 123,
"dataVersion":1,
"outerId":"abc123"
},
"自定义key1":"自定义value1",
"自定义key2":"自定义value2"
}
要删除price和自定义key1。那么deletePath的值是”_sys@price,自定义key1”。路径中，父子之间分隔符是@，路径之间分隔符是逗号(,)。
方法 : taobao.open.item.get(long ItemId )
返回值 ： boolean: success //是否成功
String : item //商品信息json串
String : message //错误提示
根据商品ID查询商品信息，返回值item就是具体的商品信息json串。
json中预留key的说明
key |
类型 |
说明 |
示例 |
只读 |
是否必填 |
userId |
数字 |
isv userid |
123123 |
是 |
否 |
appKey |
字符串 |
appkey |
“1231234” |
是 |
否 |
category |
数组 |
分类,按一级分类和二级分类构造成数组结构，具体可用值见下表(category分类表) |
[“服装”, “女装”] |
否 |
是 |
market |
字符串 |
对应的市场 |
“百川” |
否 |
否 |
endpoint |
字符串 |
本条数据对应的终端(如网页、移动终端等) |
“default” |
否 |
否 |
schemaVersion |
数字 |
json格式对应的schema版本 |
1 |
否 |
否 |
itemId |
数字 |
商品ID，必须通过taobao.open.item.id.generate接口生成，否则校验不通过 |
7627361738101 |
否 |
否 |
title |
字符串 |
商品标题 |
“一个好手机” |
否 |
是 |
price |
数字 |
商品价格，单位元，精确到分 |
200.05 |
否 |
是 |
inventory |
数字 |
商品库存，发布时如果值小于1，会默认替换为1 |
1 |
否 |
否 |
dataVersion |
数字 |
本条记录的版本号 |
2 |
否 |
否 |
outerId |
字符串 |
外部ID |
“abc123” |
否 |
否 |
domainId |
数字 |
领域ID |
12345 |
是 |
否 |
status |
数字 |
商品状态，-1删除、0失效、1有效。发布时系统自动设置为1 |
1 |
否 |
否 |
只读的字段，客户端写操作不会生效。
后台一级类目 |
后台二级类目 |
餐饮美食 |
茶艺馆 |
东南亚餐厅 |
|
韩国料理 |
|
火锅店 |
|
咖啡厅 |
|
零食熟食店 |
|
美食DIY |
|
面包/甜品/冷饮店 |
|
日本料理 |
|
烧烤烤肉 |
|
西餐厅 |
|
小吃快餐店 |
|
中餐厅 |
|
自助餐 |
|
酒吧 |
|
茶馆 |
|
其他 |
|
商超购物 |
便民商店/便利店 |
超市 |
|
服装鞋帽皮具店 |
|
个人用品/化妆品店 |
|
花店 |
|
花鸟鱼虫市场 |
|
家电电子卖场 |
|
家电数码 |
|
家装家居 |
|
母婴玩具 |
|
商场 |
|
蔬果水果店 |
|
体育用品店 |
|
图书音像 |
|
专卖店 |
|
综合市场 |
|
其他 |
|
景点门票 |
动物园 |
公园广场 |
|
海洋公园 |
|
纪念馆 |
|
植物园 |
|
自然景点 |
|
宗教纪念馆 |
|
其他 |
|
酒店住宿 |
五星级酒店 |
经济型酒店 |
|
四星级酒店 |
|
公寓式酒店 |
|
青年旅舍 |
|
精品酒店 |
|
度假村 |
|
客栈旅舍 |
|
三星级酒店 |
|
其他 |
|
丽人 |
美发 |
美甲 |
|
美容/SPA |
|
舞蹈 |
|
瑜伽 |
|
化妆品 |
|
美睫 |
|
祛痘 |
|
纹身 |
|
个性写真 |
|
产后塑形 |
|
齿科 |
|
瘦身纤体 |
|
其他 |
|
汽车服务 |
4S店/汽车销售 |
代驾服务 |
|
汽车救援 |
|
汽车俱乐部 |
|
汽车修理/零部件/保养/美容 |
|
汽车租赁 |
|
洗车场 |
|
其他 |
|
生活服务 |
DIY店 |
搬家公司 |
|
保洁、家政/清洗 |
|
保姆/看护 |
|
宠物服务 |
|
代办跑腿 |
|
房屋维修 |
|
废品回收 |
|
服装鞋帽修理 |
|
广告制作/传统印刷/打印/复印 |
|
家电安装维修 |
|
家居测量/空气检测 |
|
家居配送/安装/维修 |
|
健康服务 |
|
快照/冲印 |
|
旅行社 |
|
皮具护理 |
|
丧葬设施/服务 |
|
数码维修 |
|
洗浴/按摩/足浴 |
|
婴童馆 |
|
装修设计/施工/监理 |
|
其他 |
|
运动健身 |
保龄球馆 |
壁球馆 |
|
橄榄球场 |
|
高尔夫球场 |
|
海滨浴场 |
|
健身中心 |
|
篮球场/篮球馆 |
|
溜冰滑雪场 |
|
马术俱乐部 |
|
乒乓球馆 |
|
跆拳道道馆/搏击 |
|
网球场/网球馆 |
|
舞蹈室 |
|
游泳馆 |
|
瑜伽馆 |
|
羽毛球馆 |
|
桌球馆/台球馆 |
|
综合体育馆 |
|
足球场 |
|
其他 |
|
休闲娱乐 |
KTV |
迪厅/舞厅 |
|
电影院 |
|
电子游戏厅 |
|
酒吧 |
|
剧场 |
|
露营/农家乐 |
|
棋牌室 |
|
网吧 |
|
夜总会 |
|
音乐厅 |
|
游乐园 |
|
足疗按摩 |
|
洗浴 |
|
密室 |
|
桌球馆 |
|
其他 |
|
婚庆 |
婚纱摄影 |
婚纱礼服 |
|
婚庆公司 |
|
婚戒首饰 |
|
婚宴酒店 |
|
个性写真 |
|
彩妆造型 |
|
其他 |
|
其他 |
其他 |