文档中心> 开发文档> 接口列表> 图书商品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