详细描述

此接口用于新增一个商品

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

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",   
        }
    }
}

错误码

错误码 错误描述 解决方案

FAQ

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