文档中心> 开发文档> 接口列表> 图书商品API> dangdang.item.update
dangdang.item.add
添加商品
dangdang.item.update
修改商品
dangdang.item.get
获取单个商品信息
dangdang.item.delete
删除商品信息
dangdang.item.search
获取商品列表信息
dangdang.item.stock....
库存修改
dangdang.item.update...
库存修改(支持地区仓)
dangdang.item.price....
价格更新
dangdang.item.status...
设置商品状态
dangdang.item.postag...
设置商品运费
dangdang.item.cod.up...
设置是否支持cod
dangdang.item.bestpa...
查询商品最佳拍档
dangdang.item.bastPa...
设置商品最佳拍档
dangdang.item.column...
查询公共栏目
dangdang.item.column...
设置商品公共栏目
dangdang.item.stock....
库存查询(支持地区仓)
dangdang.item.stock....
增量更新库存(支持地...
dangdang.custom.getI...
通过商家标识符获取商...
dangdang.custom.getO...
通过商品标识符获取商...
dangdang.custom.stoc...
通过商家标识符更新库...
dangdang.custom.pric...
通过商家标识符更新价...
系统级输入参数:
请参考系统级输入参数
应用级输入参数:
;书写纸;艺术纸;画报纸;涂布纸;特种纸。
参数名称
参数类型
是否必填
示例值
参数说明
gShopID
Number
是
489
店铺ID。
item_id
Number
是
1012284020
商品ID。
out_id
String
否
xxnn1234
商家商品外部编码。不可以重复。字符串,最多可输入50个字符。
bar_code
String
否
3123123bar
条形码。数字或者字母,最多可输入40个字符。
item_name
String
否
这是商品名称
商品名称。最多可输入100个字符。
item_sub_name
String
否
这是副标题
副标题。最多可输入100个字符。
item_category_id
Number
否
1805
商品主分类。当当标准商品分类的最底级分类编号。
item_sub_category_ids
Number
否
18061807
商品从属分类。当当标准商品分类的最底级分类编号。多值用,分隔。
shop_category_ids
String
否
10231024
店内分类。多值用,分隔。
stock
Number
否
12
库存。取值范围:0-999999。
market_price
Number
否
100.11
市场价。以元为单位。取值范围:0-9999999.99。
sale_price
Number
否
80.99
当当价。以元为单位。取值范围:0-9999999.99。
purchase_price
Price
否
60
进货价。以元为单位。取值范围:0-9999999.99。
is_cod
Number
否
1
是否支持COD。取值:1,支持;0,不支持。
is_shop_vip
Number
否
1
是否支持店铺VIP。取值:1,支持;0,不支持。
status
Number
否
0
商品状态。取值:0,上架;6,下架。
postage
Number
否
0
运费模板ID。默认0(店铺运费)。
volume
Number
否
10
商品体积。单位:立方米。
weight
Number
否
10
商品重量。单位:千克。
standard_attribs
String
否
性别:女性,质地:牛皮
商品标准属性。如果商品所属分类的准属性为必填类型,那么属性必须填写。
column_descs
String
否
10001|4999,10002|5001
栏目化描述。格式:栏目ID|顺序号。多值用,分隔。
best_partners
String
否
1012284024|1,1012284025|6
最佳拍档。格式:拍档ID|顺序号。多值用,分隔。
item_descs.editor_recomm
String
否
这是编辑推荐
详情,编辑推荐。字符串,最多可输入10万个字符。
item_descs.content_recomm
String
否
这是内容推荐
详情,内容推荐。字符串,最多可输入10万个字符。
item_descs.catalog
String
否
这是目录
详情,目录。字符串,最多可输入10万个字符。
item_descs.digest
String
否
这是精彩书摘
详情,精彩书摘。字符串,最多可输入10万个字符。
item_descs.author_intro
String
否
这是作者简介
详情,作者简介。字符串,最多可输入10万个字符。
item_descs.preface
String
否
这是前言
详情,前言。
item_descs.media_comment
String
否
这是媒体评论
详情,媒体评论。字符串,最多可输入10万个字符。
item_descs.illustration
String
否
<img src = />
详情,书摘与插画。字符串,最多可输入10万个字符。
category_attribs.isbn
String
否
21231123123
类目属性,isbn。字符串,最多可输入25个字符。
category_attribs.author
String
否
[美]埃克尔
类目属性,作者。字符串,最多可输入40个字符。
category_attribs.editor
String
否
小编
类目属性,编者。字符串,最多可输入20个字符。
category_attribs.translator
String
否
小译
类目属性,译者。字符串,最多可输入20个字符。
category_attribs.painter
String
否
小绘
类目属性,绘者。字符串,最多可输入20个字符。
category_attribs.publisher
String
否
机械工业出版社
类目属性,出版社。字符串,最多可输入50个字符。
category_attribs.version
Number
否
4
类目属性,版次。大于零的整数。
category_attribs.print_copy
Number
否
10
类目属性,印次。大于零的整数。
category_attribs.words_num
Number
否
9996
类目属性,字数。大于零的整数。
category_attribs.pages_num
Number
否
999
类目属性,页数。大于零的整数。
category_attribs.copies_num
Number
否
9
类目属性,册数。大于零的整数。
category_attribs. print_paper
String
否
5.9
类目属性,印张。大于零的小数。
category_attribs.size
String
否
16开
类目属性,开本。取值:128开;108开;96开;64开;60开;50开;48开;44开;42开;40开;36开;大32开;32开;28开;25开;20开;18开;大16开;16开;12开;10开;8开;6开;4开;3开。
category_attribs. paper_quality
String
否
胶版纸
类目属性,用纸。取值:胶版纸;轻型纸;纯质纸;铜版纸;凸版纸;宣纸;字典纸;字帖纸
category_attribs.binding
String
否
平装
类目属性,包装。取值:平装;精装;盒装;袋装;线装;挂图;软精装;组合包装。
category_attribs.language
String
否
中文(简体)
类目属性,语种。取值:中文(简体);中文(繁体);英语;俄语;法语;西班牙语;日语;韩语;德语;蒙古语;中英双语;其它(含多语)。
category_attribs.present
String
否
光盘
类目属性,附赠。取值:光盘;磁带;光盘/磁带;其它。
category_attribs.present_num
Number
否
3
类目属性,附赠数量。大于零的整数。
category_attribs.cbl_category
String
否
32313123
类目属性,中图法分类号。字符串,最多可输入20个字符。
category_attribs.original_book_mame
String
否
这是原版书名
类目属性,原版书名。字符串,最多可输入50个字符。
category_attribs.main_book_name
String
否
这是主书名
类目属性,主书名。字符串,最多可输入50个字符。
category_attribs.is_suit
String
否
1
类目属性,是否套装。取值:1,是;0,否。
category_attribs.is_pinyin
String
否
1
类目属性,是否注音。取值:1,是;0,否。
category_attribs.publish_date
Date
否
39234
类目属性,出版时间。格式:yyyy-mm-dd。
category_attribs.print_date
Date
否
39600
类目属性,印刷时间。格式:yyyy-mm-dd。
item_descs.desc
String
否
详情
详情。字符串,最多可输入10万个字符。
XML数据格式:
01
|
<? xml version = "1.0" encoding = "GBK" standalone = "yes" ?>
|
02
|
< response >
|
03
|
< functionId >item-update</ functionId >
|
04
|
< result >true</ result >
|
05
|
< resultCode >0</ resultCode >
|
06
|
< resultMessage >业务处理成功.</ resultMessage >
|
07
|
< time >2014-12-30 18:37:34</ time >
|
08
|
< item >
|
09
|
< item_id >1012284020</ item_id >
|
10
|
< out_id >outid123</ item out id>
|
11
|
< item_name >这是商品名称</ item_name >
|
12
|
</ item >
|
13
|
</ response >
|
JSON数据格式:
01
|
{
|
02
|
"response" : {
|
03
|
"functionId" : "item-update" ,
|
04
|
"result" : true ,
|
05
|
"resultCode" : 0,
|
06
|
"resultMessage" : "业务处理成功." ,
|
07
|
"time" : "2015-01-07 10:52:55" ,
|
08
|
"item" : {
|
09
|
"item_id" : 1012284020
|
10
|
"out_id" : "outid123"
|
11
|
"item_name" : "这是商品名称" ,
|
12
|
}
|
13
|
}
|
14
|
}
|
java版 |
SdkClient
sdkClient=new SdkClient(appKey, appSecret, session, version) ; |
php版 |
$sdkClient = new DDHttpClient(appKey,appSecret,session) |
Copyright © 当当网 2004-2012, All Rights Reserved