开发文档 > API文档 > 商品API > store.item.add

store.item.add 添加单个商品 (同步)

详细描述

此接口用于新增一个商品

支持平台： 淘宝, 拍拍, 京东

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
method String 是

API接口名称
certi_id Number 否

分配给应用的证书ID
from_node_id String 是

API调用的来源节点ID,对于第三方开发者来说，此id即为申请应用颁发的APP KEY
from_api_v String 否

请求方版本号
to_node_id String 否

API调用的目的节点ID(除了基础服务类api，其他接口必传此参数)
to_api_v String 否

接收方版本号
callback_url String 否

响应回调地址，带http路径的标准URL。（调用异步接口此参数必填）
v String 是

矩阵API协议版本，可选值:1.0
timestamp String 是

时间戳，格式为yyyy-MM-dd hh:mm:ss，例如：2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟
format String 是

可选，指定响应格式。默认JSON ,目前支持格式为JSON
sign String 是

对调用API时所有输入参数（包括应用级参数）进行签名结果

应用级输入参数

名称 类型
默认全部
 示例值 默认值 描述
title String

淘宝(必填)

拍拍(必填)

京东(必填)

商品名称

cid Number

淘宝(必填)

拍拍(必填)

京东(必填)

商品所属平台的叶子类目ID，每个商品只能从属于一个类目id，且必须从属于一个类目id。

barcode String

淘宝(可选)

拍拍(可选)

京东(可选)

商品条码

outer_id String

淘宝(可选)

拍拍(可选)

京东(不支持)

商家外部编码

selltype String

淘宝(必填)

拍拍(必填)

京东(不支持)

商品出售类型。 可选值：fixed:（一口价），auction（拍卖） B商家不能发布拍卖商品，而且拍卖商品是没有SKU的

num Number

淘宝(必填)

拍拍(必填)

京东(可选)

商品数量，取值范围:大于零的整数。数量需要等于Sku所有数量的和

weight Number

淘宝(可选)

拍拍(可选)

京东(可选)

商品重量

approve_status String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品上传后的状态。可选值：onsale（上架销售），instock（放入仓库)，sale_on_time(定时上架)。 默认值:onsale sale_on_time仅为拍拍平台支持

stuff_status String

淘宝(可选)

拍拍(可选)

京东(不支持)

新旧程度。可选值：new（新），second（二手），unused（闲置），other(商品新旧类型-见商品说明)

is_simple Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否为简单商品；可选值：true，false （如为true ，则返回sku_id）

unit String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品单位

price String

淘宝(必填)

拍拍(可选)

京东(可选)

商品销售价。 格式：5.00；单位：元；精确到：分

member_price String

淘宝(可选)

拍拍(可选)

京东(不支持)

会员购买价 格式：1:7.8;2:5.6，表示会员等级1:价格7.8;会员等级2:价格5.6

market_price String

淘宝(可选)

拍拍(可选)

京东(可选)

商品市场价 格式：5.00；单位：元；精确到：分

cost_price String

淘宝(可选)

拍拍(可选)

京东(可选)

商品成本价 格式：5.00；单位：元；精确到：分

score String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品积分

shop_cids String

淘宝(可选)

拍拍(可选)

京东(可选)

商品所属的店铺分类列表。按逗号分隔。结构:"cid1，cid2,...,"

brand_id Number

淘宝(可选)

拍拍(可选)

京东(不支持)

商品所属的店铺内自定义品牌id

default_img_url String

淘宝(可选)

拍拍(可选)

京东(可选)

商品主图url路径，目前只支持gif,jpg,jpeg,png格式。比如 [http://www.shopex.cn/test/test.jpg] 拍拍平台图片通过商品图片接口上传

description String

淘宝(必填)

拍拍(必填)

京东(可选)

商品描述。字数要大于5个字符，小于25000个字符，受违禁词控制

brief String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品简介

list_time String

淘宝(可选)

拍拍(可选)

京东(不支持)

定时上架时间 （格式：yyyy-MM-dd HH:mm:ss） 当approve_status = sale_on_time时必填

delist_time String

淘宝(可选)

拍拍(可选)

京东(不支持)

定时下架时间 （格式：yyyy-MM-dd HH:mm:ss）

country String

淘宝(可选)

拍拍(必填)

京东(不支持)

商品所在地所属国家

state String

淘宝(必填)

拍拍(必填)

京东(不支持)

所在地省份。如浙江

city String

淘宝(必填)

拍拍(必填)

京东(不支持)

所在地城市。杭州

district String

淘宝(可选)

拍拍(可选)

京东(不支持)

所在地区/县

props String

淘宝(可选)

拍拍(可选)

京东(可选)

商品属性列表。格式:pid:vid;pid:vid。 属性的pid调用store.item.types.get取得，属性值的vid用store.item.typeprops.get取得vid。 如果该类目下面没有属性，可以不用填写。如果有属性，必选属性必填。拍拍数据用16进制表示

input_pids String

淘宝(可选)

拍拍(可选)

京东(不支持)

用户自行输入的类目属性ID串。结构："pid1，pid2，pid3"

input_str String

淘宝(可选)

拍拍(可选)

京东(不支持)

用户自行输入的子属性名和属性值。 结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,...."，如：“耐克;耐克系列;科比系列;科比系列;2K5,Nike 乔丹鞋;乔丹系列;乔丹鞋系列;乔丹鞋系列;json5”，多个自定义属性用','分割，input_str需要与input_pids一一对应，注：通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过3999字节

valid_thru Number

淘宝(可选)

拍拍(可选)

京东(不支持)

有效期，表示商品上架以后过多久会被系统自动下架。 可选值:7，14;单位:天;默认值:14

auto_repost Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否设置自动重发上架。可选值:true，false;默认值:false(不重发)

has_showcase Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否橱窗商品。可选值:true，false;默认值:false(不推荐)

postage_id String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品所属的运费模板id，如果没有则说明没有使用运费模板。 模板可以通过store.postages.get获得

freight_payer String

淘宝(可选)

拍拍(可选)

京东(不支持)

运费承担方式。可选值：seller（卖家承担），buyer(买家承担)。 拍拍平台默认值：buyer，淘宝平台默认值：seller

auction_point Number

淘宝(可选)

拍拍(可选)

京东(不支持)

商品的积分返点比例。如:5，表示:返点比例0.5%. 注意：返点比例必须是>0的整数，而且最大是90,即为9%。 B商家在发布非虚拟商品时，返点必须是 5的倍数，即0.5%的倍数。其它是1的倍数，即0.1%的倍数

post_fee Price

淘宝(可选)

拍拍(可选)

京东(不支持)

平邮费用。取值范围:0.01-10000.00;精确到2位小数;单位:元。如:5.07，表示:5元7分

express_fee Price

淘宝(可选)

拍拍(可选)

京东(不支持)

快递费用。快递费用。取值范围:0.01-10000.00;精确到2位小数;单位:元。如:15.07，表示:15元7分

ems_fee Price

淘宝(可选)

拍拍(可选)

京东(不支持)

ems费用。取值范围:0-100000000;精确到2位小数;单位:元。如:25.07，表示:25元7分

has_invoice Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否有发票。可选值:true，false; 默认值:false(无发票)。 商城卖家此字段必须为true

has_warranty Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否有保修。可选值:true，false; 默认值:false(不保修)

has_discount Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

支持会员打折。可选值:true，false; 默认值:false(不打折)

increment String

淘宝(可选)

拍拍(可选)

京东(不支持)

加价幅度。如果为0，代表系统代理幅度

is_virtual Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否为虚拟商品。可选值:true，false; 默认值:false(否)

sku_properties String

淘宝(可选)

拍拍(可选)

京东(可选)

Sku的属性串 格式:pid:vid;pid:vid。如果新增商品包含了sku，则此字段一定要传入。

sku_quantities String

淘宝(可选)

拍拍(可选)

京东(可选)

Sku的数量串，结构如：num1，num2，num3 如：2，3

sku_prices String

淘宝(可选)

拍拍(可选)

京东(可选)

Sku的价格串，结构如：10.00，5.00，…

sku_costs String

淘宝(可选)

拍拍(可选)

京东(不支持)

Sku的成本价格串，结构如：10.00，5.00，…
sku_outer_ids String

淘宝(可选)

拍拍(可选)

京东(不支持)

Sku的外部id串，结构如：1234，1342，…

sku_bns String

淘宝(可选)

拍拍(可选)

京东(不支持)

Sku的编码串，结构如：test1，test2，…

sku_memos String

淘宝(可选)

拍拍(可选)

京东(不支持)

Sku的备注串,结构如:test,test,... sku_properties， sku_quantities， sku_prices，sku_costs, sku_outer_ids,sku_bns,sku_memos在输入数据时要一一对应，如果没有值可写成：“, ,”

supplier_id String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品所属供应商编码

supplier_name String

淘宝(可选)

拍拍(可选)

京东(可选)

商品所属供应商名称

property_alias String

淘宝(可选)

拍拍(可选)

京东(不支持)

属性值别名。 目前只针对淘宝平台，如pid:vid:别名;pid1:vid1:别名1 ，其中：pid是属性id vid是属性值id。

lang String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品文字的字符集。繁体传入"zh_HK"，简体传入"zh_CN"，不传默认为简体。目前只支持淘宝平台

product_id String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品所属的产品id(B商家发布商品需要用)

auto_fill String

淘宝(可选)

拍拍(可选)

京东(不支持)

代充商品类型。在代充商品的类目下，不传表示不标记商品类型（交易搜索中就不能通过标记搜到相关的交易了）。可选值： no_mark(不做类型标记)，time_card(点卡软件代充)，fee_card(话费软件代充)

is_3D Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否是3D

after_sale_id String

淘宝(可选)

拍拍(可选)

京东(不支持)

售后说明模板id

sell_promise String

淘宝(可选)

拍拍(可选)

京东(不支持)

是否承诺退换货服务，虚拟商品无须设置此项。

cod_postage_id Number

淘宝(可选)

拍拍(可选)

京东(不支持)

此为货到付款运费模板的id，对应的JAVA类型是long，如果COD卖家应用了货到付款运费模板，此值要进行设置。

desc_theme String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品详情页面颜色主题。可选值：THEME_DEFAULT（默认风格），THEME_PINK（粉色回忆），THEME_NATURE（自然印象），THEME_METAL（金属狂潮）；默认值：THEME_DEFAULT

buy_limit String

淘宝(可选)

拍拍(可选)

京东(不支持)

购买限制，默认为0，表示不限制。大于0的值表示单个买家购买该商品不得超过该数目

send_type String

淘宝(可选)

拍拍(可选)

京东(不支持)

商品的发货方式。可选值：sendbymoney（款到发货），cod（货到付款），sendbydesc（见商品描述)

guarantee_compensation Boolean

淘宝(必填)

拍拍(必填)

京东(不支持)

是否假一赔三诚信保证商品。 可选值：true，false; 默认值：false（表示非假一赔三诚信保证商品）

guarantee_7_days Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否7天包退诚信保证商品。可选值：true，false;默认值：false（表示非7天包退诚信保证商品）

guarantee_14_days Boolean

淘宝(可选)

拍拍(可选)

京东(不支持)

是否14天先行赔付诚信保证商品。可选值：true，false;默认值：false（表示非14天先行赔付诚信保证商品）

sizetable_id String

淘宝(可选)

拍拍(可选)

京东(不支持)

尺码表Id

related_items String

淘宝(可选)

拍拍(可选)

京东(不支持)

推荐搭配商品id，多个以|隔开。推荐商品必需上架，只有2钻以上用户才能设置(目前只支持拍拍平台)

pic_path String

淘宝(可选)

拍拍(可选)

京东(不支持)

相册或图片空间的地址，当pic_path和default_img_url同时存在时以pic_path为准。传值格式为url。

food_security FoodSecurity

淘宝(可选)

拍拍(不支持)

京东(不支持)

食品安全信息，包括： 生产许可证号、产品标准号、厂名、厂址等（json串）

返回结果

名称 类型 是否必须 示例值 描述
item Item 是

无

商品结构,仅有iid和created返回

同步示例 异步示例

XML数据格式：

			
JSON数据格式：

			
{
    "rsp":"succ",  
    "msg_id":3463421b2581604c74dcb9b74ffab2e4,
    "data":{
       "item": {
         "iid":"200001",
         "created":"2010-03-22 14:22:06",   
        }
    }
}

		

		
	

	

	

		

			
错误码

		

		

			

				
					

						错误码
						错误描述
						解决方案
					

				
				
									
			

		

	

	

		

			
API工具

		

		

			

				API TOOLS 在线测试工具
			

			

				SDK 调用示例
			


		

	

	

		

			
FAQ

		

		

			

				
									
			

		

	

	
修改时间：2013-01-30 15:49:23