发布商品 | 大麦家礼品代发API

# 发布商品

接口地址： http://www.damaijia168.com/vv/external/jdaddsp

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

名称	类型	必须	示例值	描述
owner_id	String	是		店铺 ownerId
ware	com.jd.pop.ware.ic.api.domain.Ware	是	无	商品对象
-title	String	是	无	商品名称（限制50个字符以内）
-categoryId	Number	是	1	已经授权过的京东“三级”类目(通过商家授权类目接口获取)
-multiCategoryId	Number	否	1	末级类目ID
-brandId	Number	否	1	不同类目是否必填情况不同，若发布时提示[此类目要求品牌必填]，则表示品牌需要必填。品牌ID获取方式通过商家授权类目接口获取。
-templateId	Number	否	1	发布时不可设置
-transportId	Number	是	1	运费模板ID
-wareStatus	Number	否	1	商品状态1:从未上架 2:自主下架 4:系统下架 8:在售 513:从未上架待审核 514:自主下架待审核 516:系统下架待审核 520:在售待审核 1025:从未上架审核不通过暂时没用 1026:自主下架审核不通过暂时没用 1028:系统下架审核不通过 1032:在售审核不通过
-outerId	String	否	无	商品外部ID,商家自行设置的ID（便于关联京东商品）
-itemNum	String	否	无	商品货号
-barCode	String	否	无	商品的条形码.UPC码,SN码,PLU码统称为条形码
-wareLocation	Number	否	1	商品产出地区
-delivery	Number	否	0	商品发货地
-promiseId	Number	否	1	配送时效
adWords	com.jd.pop.ware.ic.api.domain.AdWords	否	无	商品广告词对象（单品页显示的优先级低于促销广告词）
-url	String	否	无	广告词链接地址
-urlWords	String	否	无	广告词链接文案
-words	String	是	无	广告词仅文字内容
-wrap	String	否	无	包装规格（已废弃）
-packListing	String	否	无	商品包装清单
-length	Number	否	1	商品长度,单位mm。根据类目区分是否必填
-width	Number	否	1	商品宽度,单位mm。根据类目区分是否必填
-height	Number	否	1	商品高度,单位mm。根据类目区分是否必填
-weight	Number	否	1	商品重量,单位kg。根据类目区分是否必填
props	java.util.Set	否	无	属性列表(已废弃请使用multiCateProps,已经按照类目限制使用3级类目修改，请及时迁移到多级类目)
---	com.jd.pop.ware.ic.api.domain.Prop	否	无
-attrId	String	否	无	属性ID
-attrValues	String	否	无	属性值ID数组
features	java.util.Set	否	无	商品维度的特殊属性目前两个特殊属性 IBS、FBP、FCS、SCF 4种商家类型【规格型号】 model和【销售单位】 unit 字段且为必填（如个、盒、袋等）请勿填写公司名称。
---	com.jd.pop.ware.ic.api.domain.Feature	否	无
-key	String	是	无	特殊属性key
-value	String	否	无	特殊属性value
images	java.util.List	是	无	商品图片列表，发布时必须有主图(颜色为十个0，index为1的图片)
---	com.jd.pop.ware.ic.api.domain.Image	是	无
-colorId	String	是	无	颜色id，颜色id和您设置的销售属性值id对应，使用接口jingdong.category.read.findValuesByAttrIdUnlimit 获取，如果没销售属性，则默认为10个0（主图，并且主图必填）
-imgIndex	Number	是	1	图片顺序。index值：1-N，如果index存在，则直接覆盖相应index图片
-imgUrl	String	是	无	京东图片服务器地址，不包括前缀。例如：jfs/t2116/102/1731643157/81969/c3df941a/5670f868Nc441d4c3.jpg
-imgZoneId	String	否	无	图片空间中的图片Id
shopCategorys	java.util.Set	否	无	商品店内分类（商家接口获取到的最末级的分类）
----	Number[]	否	1
-mobileDesc	String	是	无	移动版的商品介绍长度限制10W个字符
-introduction	String	是	无	PC版的商品介绍长度限制10W个字符
-afterSales	String	否	无	售后服务
-jdPrice	Number	否	1	商品的京东价,人民币单元是元，最大值为9个9
-marketPrice	Number	否	1	商品的市场价,人民币单元是元，最大值为9个9
-zhuangBaId	String	否	无	商品描述装吧实例ID
-introductionUseFlag	String	否	无	商品描述使用标识 ,0：使用默认的商品描述,1：使用装吧商详
-mobileZhuangBaId	String	否	无	移动版商品描述装吧实例ID
-mobileDescUseFlag	String	否	无	移动版商品描述使用标识,0：使用默认的移动商详；1：使用装吧移动版商详
-designConcept	String	否	无	商品设计理念,适用范围是toplife类目
-fitCaseHtmlApp	String	否	无	装修案例移动版描述,装修类目才可填写
-fitCaseHtmlPc	String	否	无	装修案例PC版描述,装修类目才可填写
specialServices	java.util.List	否	无	特色服务,装修类目才可填写,装修类必填,最大为5,每个值最长为8个字符
----	String	否	无
multiCateProps	java.util.Set	否	无	类目属性列表，类目属性中有必填项时，此字段必填；若未设置或设置错误，会有“通用属性必填”等错误提示！
---	com.jd.pop.ware.ic.api.domain.Prop	否	无
-attrId	String	是	无	属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 按照类目ID获取属性类型attributeType=1为单选 attributeType=2为多选获取单选多选的属性值，属性类型attributeType=3的为输入方式请直接填写
-attrValues	String[]	是	无	属性值ID数组 jingdong.category.read.findValuesByAttrIdUnlimit 获取单选多选的属性值属性类型attributeType=1为单选 attributeType=2为多选
-expands	String[]	否	无	扩展信息
-units	String[]	否	无	单位信息
skus	java.util.List	否	无	sku列表（只写属性用于新建商品且必填）
---	com.jd.pop.ware.ic.api.domain.Sku	是	无
-skuId	Number	否	1	skuID（新建商品不需要填写）
saleAttrs	java.util.Set	是	无	SKU销售属性
---	com.jd.pop.ware.ic.api.domain.Prop	是	无
-attrValueAlias	String[]	否	无	值别名，发布商品时不可设置
-attrId	String	是	无	属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 传3级分类 type=4获取
-attrValues	String[]	是	无	销售属性值使用接口jingdong.category.read.findValuesByAttrIdUnlimit获取
features	java.util.Set	否	无	特殊属性
---	com.jd.pop.ware.ic.api.domain.Feature	是	无
-cn	String	否	无	可不填
-values	String	否	无	sku级别特殊属性值
-key	String	否	无	sku级别特殊属性
-jdPrice	Number	是	1	京东价必填单位：元
-outerId	String	否	无	外部ID,系统不保证唯一性,如需唯一性自行保证
-stockNum	String	是	无	总库存数
-barCode	String	否	无	SKU的条形码
props	java.util.Set	否	无	SKU属性(已废弃请使用multiCateProps，已经按照类目限制使用3级类目修改，请及时迁移到多级类目)
---	com.jd.pop.ware.ic.api.domain.Prop	否	无
-attrValueAlias	String[]	否	无	值别名
-attrId	String	否	无	属性ID
-attrValues	String[]	否	无	属性值
multiCateProps	java.util.Set	否	无	多级SKU属性，仅当属性可以下沉时才能设置，不验证必填！sku维度设置后，以sku上的属性为准！
---	com.jd.pop.ware.ic.api.domain.Prop	否	无
-attrValueAlias	String[]	否	无	值别名
-attrId	String	否	无	下沉到sku的属性ID 通过接口 jingdong.category.read.findAttrsByCategoryIdUnlimitCate 获取 features字段中attrLevel=1
-attrValues	String[]	否	无	下沉到sku属性值单选或者多选通过接口jingdong.category.read.findValuesByAttrIdUnlimit获取输入类型请手动输入
-expands	String[]	否	无	扩展字段
-units	String[]	否	无	单位
-capacity	String	否	20L 20T	容量，在有特殊要求的类目下必填！最多支持6位小数。
-promiseId	Number	否	123456	时效模板id
edition	string	否		版本默认:1(不传默认为1) 1:1.0,2:2.0

# 请求示例

{

}

# 请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

Pyton请求代码示例

# 响应参数

名称	类型	示例值	描述
data	object	数据信息
ware	com.jd.pop.ware.ic.api.domain.Ware	无	商品数据对象
-wareId	Number	1	商品id
skus	java.util.List	无	sku集合
---	com.jd.pop.ware.ic.api.domain.Sku	无
-skuId	Number	1	skuId
saleAttrs	java.util.Set	无	销售属性
---	com.jd.pop.ware.ic.api.domain.Prop	无
-attrValueAlias	String[]	无	值别名
-attrId	String	无	属性ID
-attrValues	String[]	无	属性值
-expands	String[]	无	expands
-units	String[]	无	units
deduct_money	int	1	消耗点券
status	int	0	状态码，0为成功

# 返回数据

{
"data": {
        "deduct_money":1,
        "jingdong_ware_write_add_response": {
"ware": {
"skus": [
{
"---": {
"skuId": "1",
"saleAttrs": [
{
"---": {
"attrValueAlias": "无",
"attrId": "无",
"expands": "无",
"units": "无",
"attrValues": "无"
}
}
]
}
}
],
"wareId": "1"
}
}

  },
    "status": 0
}

# 响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API调用次数不足,请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权

← 8-t_京东-设置sku库存 1_商家订购时长 →