开放服务-API列表

商户可通过此接口进行新品申请。
1、若商户销售的商品苏宁不存在，商户可以通过此接口申请新产品。
2、商户可输入基本信息、动态参数信息、卖点、售后服务、价格、库存、运费、销售设定等信息进行新品申请。
3、系统成功接收商品申请信息后，返回申请编号、接口接收成功系统时间。
4、商品处理结果可通过获取我的商品库信息（文化制品类）/我的商品库信息精确查询（文化制品类）/获取我的商品详情信息（文化制品类）接口进行查询。

公共参数

名称	类型	是否必须	示例值	描述
appMethod	String	Y	suning.custom.category.query	方法名
appRequestTime	String	Y	2012-04-25 20:23:30	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。
format	String	N	XML	默认xml,可指定格式为xml,json
appKey	String	Y	b0c332a133c102765f39de**********	分配给应用的访问令牌
versionNo	String	Y	v1.2	API的版本，目前为v1.2版本
signInfo	String	Y	460d7ff15b073e463125b4**********	appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写)，其中appSecret为appKey对应的密钥
access_token	String	N	a1c5c62b08df3a3cbf7efd**********	采用OAuth授权方式为必填参数

请求参数

名称	类型	是否必须	示例值	描述
categoryCode	String	N	R00001	苏宁采购目录编码。可由平台业务-商品服务-获取商品采购目录信息接口获得。需填写最底层采购目录编码。
saleCatalogCode	String	N	262676	苏宁销售目录编码。可由平台业务-商品服务-获取商品销售目录信息（文化制品类）接口获得。需填写最底层销售目录
brandCode	String	N	000C	苏宁出版社编码。可由平台业务-商品服务-获取商品品牌信息（文化制品类）接口获得。注意区分大小写。
productName	String	N	平凡的世界	商品名称，可填写中文。重码校验逻辑：期刊杂志类通过商品名称进行重码校验；中文图书、进口图书、音像制品通过ISBN号进行重码校验。
freightTemplateId	String	N		商品运费模板编码。需填写对应商家维护的运维模板编码。可由平台业务-销售准备-运费模板批量查询接口获取。
itemCode	String	N	12233	供应商商品编码
price	String	N	20.00	商品价格。单位：元。精确到小数点后2位
invQty	String	N	100	商品库存。单位：件，范围：0-99999
alertQty	String	N	10	商品库存预警值，范围：0-99999
afterSaleServiceDec	String	N	七天内包退换	商品售后服务内容，最多可填写254个汉字或字符。
sellPoint	String	N	好品质	商品卖点。中文，对多可填写40个汉字。
saleSet	String	N	0	商家商品销售设定。1：立即；0：设定日期；2：放入仓库。1表示商品申请处理成功后，系统立即进行上架；0表示商品申请处理成功后，在设定的日期，系统自动上架；2表示商品申请处理成功后，商品状态为待售状态。商户可通过平台业务-商品服务-商品上架接口对待售状态的商品进行上架操作。
saleDate	String	N	2014-01-06	商家设定的销售日期。仅在销售设定为0时展示。格式YYYY-MM-DD
auditFlag	String	N	X	X：表示审核。商品系统中已存在此商品，继续发布新商品，需要审核。
parCode	String	N		申请参数编码，基本、动态参数编码。可由平台业务-商品服务-获取商品参数模板接口获得。若需填写多个参数，需同参数值一一对应，用循环节点形式展示。
parValue	String	N		1.申请参数值。填写时需注意该参数是否含有单位。单选或多选类型参数值需填写对应的可选值编码。若需填写多个参数，需同参数编码一一对应，用循环节点形式展示。商品名称参数请按照：品牌+类目+型号组合命名。 2.注意点：当parCode值为(media_comm 媒体评论,brief_intro 内容简介,about_author 作者简介,editors_choice 编辑推荐,directory 目录,book_excerpt 图书摘要,magazine_profile 杂志社简介,about_journal 期刊简介)这些值时，需要将parValue对应的值以UTF-8字符编码进行Base64编码作为请求的参数值。
assortCode	String	N	11111111	店铺商品分类ID,可以通过店铺-店铺分类查询接口查询，必须使用最底层的店铺分类ID
cmTitle	String	N		商品标题
supplierImg1Url	String	N		商家商品图片1地址url
supplierImg2Url	String	N		商家商品图片2地址url
supplierImg3Url	String	N		商家商品图片3地址url
supplierImg4Url	String	N		商家商品图片4地址url
supplierImg5Url	String	N		商家商品图片5地址url

响应参数

名称	类型	示例值	描述
applyCode	String	null	申请时产生的申请编号。如申请的商品还有规格，则只返回主商品的申请编号
applyTime	String	null	接口接收成功后系统时间

请求示例

XML示例
JSON示例

复制全部代码

                                
      	<sn_request>
	<sn_body>
		<item>
      		<categoryCode>R5101002</categoryCode>
      		<saleCatalogCode>221173</saleCatalogCode>
			<brandCode>00BC</brandCode>
			<productName>中文图片111</productName>
			<sellPoint>第一本特价销售的图片</sellPoint>
			<freightTemplateId>a920cb2b09ab455ab3699c2a4af8bf7d</freightTemplateId>
			<itemCode>234235345</itemCode>
			<price>59</price>
			<invQty>4546</invQty>
			<alertQty>67</alertQty>
			<afterSaleServiceDec>7天包退的类型哦</afterSaleServiceDec>
			<saleSet>1</saleSet>
			<saleDate>1</saleDate>
			<assortCode>111</assortCode>
			<pars>
				<parCode>cmBarcode</parCode>
				<parValue>9787510447327 </parValue>
			</pars>
			<pars>
				<parCode>grossWeight</parCode>
				<parValue>3456.23</parValue>
			</pars>
      		<pars>
				<parCode>volume</parCode>
				<parValue>34566</parValue>
			</pars>
      		<pars>
				<parCode>005423</parCode>
				<parValue>作者名称</parValue>
			</pars>	
			      <pars>
				<parCode>editors_choice</parCode>
				<parValue>编辑推荐</parValue>
			</pars>
      		<pars>
				<parCode>brief_intro</parCode>
				<parValue>内容简介</parValue>
			</pars>      <pars>
				<parCode>about_author</parCode>
				<parValue>456456</parValue>
			</pars>      <pars>
				<parCode>media_comm</parCode>
				<parValue>456456</parValue>
			</pars>      <pars>
				<parCode>directory</parCode>
				<parValue>456456</parValue>
			</pars>      <pars>
				<parCode>book_excerpt</parCode>
				<parValue>456456</parValue>
			</pars>      <pars>
				<parCode>insert_pic1</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>insert_pic2</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>insert_pic3</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>insert_pic4</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>insert_pic5</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>005002</parCode>
				<parValue>2435345</parValue>
			</pars>      <pars>
				<parCode>005690</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>005721</parCode>
				<parValue></parValue>
			</pars>      <pars>
				<parCode>005814</parCode>
				<parValue></parValue>
			</pars>	
			<pars>
				<parCode>000897</parCode>
				<parValue></parValue>
			</pars>		
			<auditFlag></auditFlag>
		</item>
	</sn_body>
</sn_request>

                                
      	{
  "sn_request": {
    "sn_body": {
      "item": {
        "categoryCode": "R5101002",
        "saleCatalogCode": "221173",
        "brandCode": "00BC",
        "productName": "中文图片111",
        "sellPoint": "第一本特价销售的图片",
        "freightTemplateId": "a920cb2b09ab455ab3699c2a4af8bf7d",
        "itemCode": "234235345",
        "price": "59",
        "invQty": "4546",
        "alertQty": "67",
        "afterSaleServiceDec": "7天包退的类型哦",
        "saleSet": "1",
        "saleDate": "1",
        "assortCode": "111",
        "pars": [
          {
            "parCode": "cmBarcode",
            "parValue": "9787510447327 "
          },
          {
            "parCode": "grossWeight",
            "parValue": "3456.23"
          },
          {
            "parCode": "volume",
            "parValue": "34566"
          },
          {
            "parCode": "005423",
            "parValue": "作者名称"
          },
          {
            "parCode": "editors_choice",
            "parValue": "编辑推荐"
          },
          {
            "parCode": "brief_intro",
            "parValue": "内容简介"
          },
          {
            "parCode": "about_author",
            "parValue": "456456"
          },
          {
            "parCode": "media_comm",
            "parValue": "456456"
          },
          {
            "parCode": "directory",
            "parValue": "456456"
          },
          {
            "parCode": "book_excerpt",
            "parValue": "456456"
          },
          { "parCode": "insert_pic1" },
          { "parCode": "insert_pic2" },
          { "parCode": "insert_pic3" },
          { "parCode": "insert_pic4" },
          { "parCode": "insert_pic5" },
          {
            "parCode": "005002",
            "parValue": "2435345"
          },
          { "parCode": "005690" },
          { "parCode": "005721" },
          { "parCode": "005814" },
          { "parCode": "000897" }
        ]
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              
      	<sn_responseContent>
	<sn_head/>
	<sn_body>
		<item>
			<applyCode>100144925</applyCode>
			<applyTime>2014-01-26 14:59:37</applyTime>
		</item>
	</sn_body>
</sn_responseContent>

                              
      	{
  "sn_responseContent": {
    "sn_body": {
      "item": {
        "applyCode": "100144925",
        "applyTime": "2014-01-26 14:59:37"
      }
    }
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}

业务异常码

异常码	错误描述	解决方案
biz.item.missing-parameter:*	*代表对应字段，不能为空	检查对应字段是否为空
biz.custom.item.invalid-biz:categoryCode	1. 非文化制品的采购目录 2. 商品采购目录编码未绑定销售范围 3. 采购目录编码不是最底层的 4. 采购目录编码字符长度不能大于9 5. 采购目录编码不存在	1、请检查输入 2、请检查商品类目是否绑定销售范围
biz.custom.item.invalid-biz:saleCatalogCode	1. 销售目录编码字符长度不能大于9 2. 销售目录编码不存在	检查销售目录编码
biz.custom.item.invalid-biz:brandCode	1. 品牌编码字符长度不能大于9 2. 非文化制品品牌编码 3. 品牌编码不存在	检查品牌编码
biz.custom.item.invalid-biz:productName	商品名称字符长度不能大于60	检查商品名称
biz.custom.item.invalid-biz:sellPoint	商品卖点字符长度不能大于40	检查商品卖点
biz.custom.item.invalid-biz:afterSaleServiceDec	售后服务字符长度不能大于254	检查售后服务
biz.custom.item.invalid-biz:saleSet	销售设定只能为 0 1 2（1：立即；0：设定日期；2：放入仓库。）	检查销售设定
biz.custom.item.invalid-biz:saleDate	1. 销售设定为0时，销售日期必填 2 销售日期的格式有误，应为YYYY-MM-DD 3 销售日期不能早于当天	检查销售日期
biz.custom.item.invalid-biz:price	1. 价格字段需精确到小数点后2位数 2. 商品的价格范围是必须是￥ 0.01-9,999,999,999,999.99	检查价格
biz.custom.item.invalid-biz:invQty	库存字段填写的内容应为正整数	检查库存
biz.custom.item.invalid-biz:alertQty	库存预警值字段填写的内容应为正整数	检查库存预警
biz.custom.item.invalid-biz:auditFlag	需要审核时只能填写 X	检查审核标志
biz.custom.item.invalid-biz:parCode	1. 参数代码不能为空 2. 参数代码不能重复 3. 输入参数个数跟模板下参数个数不匹配	检查参数代码
biz.custom.item.invalid-biz:*	图片URL不合法（*为img1Url，img2Url，img3Url，img4Url，img5Url）	检查图片地址
biz.custom.item.invalid-biz:custom	非文化制品类商家，无权操作	检查商家权限信息
biz.custom.item.invalid-biz:isbn	非法的ISBN号	检查isbn的参数代码对应的参数值
biz.custom.item.invalid-biz:invaddress	商家仓库不存在	请先创建，若已经创建，请联系苏宁客服人员
biz.custom.item.invalid-biz:grossWeight	1. 毛重参数值只能填写数字,且小数部分最多3位 2. 毛重参数值不允许为零	检查毛重参数代码对应的参数值
biz.custom.item.invalid-biz:volume	体积参数值只能填写数字，且小数部分最多3位	检查体积参数代码对应的参数值
biz.custom.item.invalid-biz:forbidden	商品名称、卖点、售后服务有敏感词	检查参数值
biz.custom.item.invalid-biz:intrpars- + 商品详情字段名	商品详情(" + desc + ")长度不允许超过10000字	检查商品详情参数值
biz.custom.item.invalid-biz:itemCode	商家商品编码长度不允许大于20	检查商家商品编码
biz.custom.item.invalid-biz:productName-exist	商品已存在	可通过平台业务-商品API-商品内容维护接口维护苏宁已有商品
biz.custom.item.invalid-biz:intrpars	该目录非文化制品目录，获取内容模板为空	请检查输入
biz.custom.item.invalid-biz:img	图片地址错误或非苏宁图片地址	请检查输入
biz.custom.item.invalid-biz:img1url	主图第一张图片不允许为空	请检查输入
biz.custom.item.invalid-biz:freightTemplateId	运费模板不存在	请检查输入
biz.custom.item.invalid-biz:img1Url/img2Url/img3Url/ img4Url/ img5Url	1.商品图片不存在 2.类目为中文图书，主图(img1Url)的尺寸不能小于400400；类目为进口图书、音像、期刊，主图(img1Url) 的尺寸不能小于800800	请检查输入
biz.custom.item.invalid-biz:imgUrl	商品主图不允许重复	请检查输入
biz.custom.item.invalid-biz:productName-existing	商品已存在且处理中	可通过平台业务-商品API-商品内容维护接口维护苏宁已有商品
biz.custom.item.invalid-biz:price-upper	该类目下商品价格超过商品限价的上限	请检查输入
biz.custom.item.invalid-biz:price-lower	该类目下商品价格低于商品限价的下限	请检查输入
biz.custom.item.invalid-biz:+参数名	1.输入参数非法（必填没有填，选项输入值非选择项等） 2.对应的参数值需要进行Base64编码	请检查输入
biz.custom.item.invalid-biz:productName-error	校验商品重码接口出错	请联系苏宁运维人员
biz.custom.item.invalid-biz:intrpars-error	保存内容详情(" + desc + ")时发生错误	请联系苏宁运维人员
biz.custom.item.invalid-biz:insert_pic-outspace+图片字段名	图片宽度大于750px或大小超过1024kb	请检查输入
biz.custom.item.invalid-biz:insert_pic+图片字段名	非该商家图片	请检查输入
biz.custom.item.invalid-biz:insert_pic-error+图片字段名	插图信息出错，系统级错误	请联系苏宁运营人员
biz.custom.item.invalid-biz:brand-expired	品牌过期	请通过商家后台品牌资质管理流程重新维护
biz.custom.item.invalid-biz:contract-expired	合同与基本资质过期	请通过商家后台基本资质管理流程重新维护
biz.custom.item.invalid-biz:assortCode	非法的店铺分类ID	请检查输入
biz.custom.item.invalid-biz:isPunish-+punishOverTime	商家处于处罚中，禁止发布商品	请于处罚时间结束后发布商品

公共异常码

异常码	错误描述	解决方案
sys.check.user-permission:inexistence	访问令牌不存在	更换访问令牌
sys.check.user-permission:overdue	访问令牌已过期	请使用刷新令牌刷新
sys.check.api-permission:inexistence	Api方法不存在	请参考帮助中心
sys.check.api-permission:overdue	Api方法已过期	请参考帮助中心
sys.check.method-permission:authority	无权操作此api	确认是否有访问该方法权限
sys.auth.vendor-request:errory	无权操作此供应商	请确认供应商编码是否正确
sys.controller.api-request:limit	Api请求受控	超过请求次数
sys.check.app-time:error	请求参数错误api请求时间误差大	参考帮助中心
sys.check.request-params:error	请求报文结构错误	参考帮助中心、日期格式等
sys.check.starttime-format:error	请求开始时间错误	参考帮助中心、日期格式等
biz.handler.data-get:success	业务数据查询成功	无
biz.handler.data-get:fail	业务数据查询失败	检查请求条件
biz.handler.data-get:no-result	业务数据结果为空	无
sys.check.pageno-format:error	pageNo格式错误，只允许1到99999之间的整数	检查pageNo输入是否有误
sys.check.pagesize-format:error	pageSize格式错误，只允许1到50之间的整数(订单相关是1到100)	检查pageSize输入是否有误
sys.check.page-param:error	pageNo或者pageSize不在要求范围内，pageNo只允许1到99999之间的整数，pageSize只允许1到50之间的整数(订单相关是1到100)	检查pageNo和pageSize输入是否有误
sys.check.miss-time:starttime	不存在开始时间(节点)	检查输入
sys.check.miss-time:endtime	不存在结束时间(节点)	检查输入
sys.check.starttime-value:null	开始时间为空(值)	检查输入
sys.check.endtime-value:null	结束时间为空(值)	检查输入
sys.check.starttime-format:error	校验开始时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.endtime-format:error	校验结束时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.query-time:error	开始时间是否小于结束时间	检查开始和结束时间大小
sys.check.query-time:outofrange	时间查询是否超出指定范围	检查时间范围
sys.check.app-sign:null	签名信息为空	检查签名信息
sys.check.app-sign:error	签名信息错误	检查签名信息
sys.check.missing-parameter:apiversion	API版本号未指定	检查API版本号
sys.check.missing-parameter:appRequestTime	请求时间丢失	检查请求时间
sys.check.missing-nestElement:sn_body	缺少sn_body节点	检查sn_body是否存在
sys.check.user-permission:inexistence	用户key不存在	检查用户key是否存在
biz.handler.batch-handler:no-support	非查询类API不支持批量操作	检查API类型
biz.handler.request-message:error	查询类API输入多个业务节点	检查业务节点
sys.check.header-param:null	header参数为空	请检查header参数
sys.controller.api-access:limit	访问限制	无
sys.controller.api-frequency:limit	访问频率限制	无
sys.error.network:failure	网络异常	无
sys.error.network-status:?	响应失败 ?为状态码	无
sys.check.snunionid.length.is.not:48	混淆会员编码长度不是48位	使用转换器转换混淆会员编码规定要求混淆会员编码48位

API工具

API TOOLS 在线测试工具异常码查询工具 SDK调用示例 SDK下载

FAQ

Q：重码校验是什么？

A：重码校验是指商户在进行产品申请时，要保证商户申请的产品是唯一的苏宁商品库不存在的新产品。若商户申请的商品，苏宁已存在，可通过平台业务-商品模块-商品内容维护接口维护商品。

Q：重码校验规则是什么？

A：期刊杂志类通过商品名称进行重码校验；中文图书、进口图书、音像制品通过ISBN号进行重码校验。