开放服务-API列表

热词搜索：

suning.selfmarket.apply.add 自营商品申请

￥免费

自营商品申请

公共参数

名称	类型	是否必须	示例值	描述
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授权方式为必填参数

请求参数

名称	类型	是否必须	示例值	描述
barpic	String	N	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	条形码资质图
brandCode	String	Y	A101	品牌编码
categoryCode	String	Y	R6101011	类目编码
childItem	String	N
barcode	String	N	11	子商品条形码
barpicX	String	N	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	条形码资质图
itemCodeX	String	N	111	子商品商家商品编码
parsX	String	N
parCodeX	String	N	111	子商品特性参数代码
parValueX	String	N	红色	子商品特性参数值
supplierImgAUrl	String	N	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	子商品商家商品图片
cmTitle	String	N	商品标题	商品标题
detailModule	String	N
content	String	N	模块化详情内容	模块内容
moduleId	String	N	123	模块ID
moduleName	String	N	模块名称	模块名称
num	String	N	1	序号
type	String	N	cat_mod	模块类型。cat_mod：表示运营配置； usr_mod：表示自定义
introduction	String	N	好品质好商品	商家商品介绍
itemCode	String	N	naikeabc	供应商商品编码
packingList	String	N
packingListName	String	N	电脑	装箱清单名单
packingListQty	String	N	1	装箱清单名单数量
pars	String	N
parCode	String	Y	cm_model	参数编码，基本、动态参数代码。
parValue	String	N	1	参数值，基本、动态参数值。
productName	String	Y	大衣	商品名称
supplierImgUrl	String	N
urlA	String	Y	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	商家商品图片1
urlB	String	Y	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	商家商品图片2
urlC	String	Y	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	商家商品图片3
urlD	String	Y	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	商家商品图片4
urlE	String	Y	http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg	商家商品图片5
sellingPoints	String	N	商品卖点	商品卖点
conventionPoints	String	N	常规促销卖点	常规促销卖点
conventionBeginTime	String	N	2018-02-13 11:37:00	常规促销卖点生效时间
conventionEndTime	String	N	2018-02-13 11:37:00	常规促销卖点失效时间
highPoints	String	N	高级促销卖点	高级促销卖点
highBeginTime	String	N	2018-02-13 11:37:00	高级促销卖点生效时间
highEndTime	String	N	2018-02-13 11:37:00	高级促销卖点失效时间
promotionPoints	String	N	活动关联文案	活动关联文案
promotionLink	String	N	http://shop.suning.com/70088824/10108744.html	电脑端链接
mobilePromotionLink	String	N	http://shop.suning.com/70088824/10108744.html	移动端链接
startTime	String	N	2018-02-13 11:37:00	活动链接生效时间
endTime	String	N	2018-02-13 11:37:00	活动链接失效时间
promotionFlag	String	N	是	只添加常规卖点
videoCode	String	N	108625	商品视频编码
mainPicVideoCode	String	N	108625	主图视频编码
highlightWordone	String	N	亮点词1	亮点词1
highlightWordtwo	String	N	亮点词2	亮点词2
highlightWordthree	String	N	亮点词3	亮点词3

响应参数

名称	类型	示例值	描述
applyCode	String	94d52e1d-32ae-4e8f-8a4a-d782e96f5171	申请时产生的申请编号
applyTime	String	2016-11-08 00:00:00	接口接收成功后系统时间

请求示例

XML示例
JSON示例

复制全部代码

                                
<sn_request>
  <sn_body>
    <addApply>
      <childItem>
        <barpicX>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</barpicX>
        <itemCodeX>111</itemCodeX>
        <barcode>11</barcode>
        <supplierImgAUrl>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</supplierImgAUrl>
        <parsX>
          <parCodeX>111</parCodeX>
          <parValueX>红色</parValueX>
        </parsX>
      </childItem>
      <conventionEndTime>2018-02-13 11:37:00</conventionEndTime>
      <pars>
        <parValue>1</parValue>
        <parCode>cm_model</parCode>
      </pars>
      <itemCode>naikeabc</itemCode>
      <conventionBeginTime>2018-02-13 11:37:00</conventionBeginTime>
      <productName>大衣</productName>
      <packingList>
        <packingListName>电脑</packingListName>
        <packingListQty>1</packingListQty>
      </packingList>
      <mobilePromotionLink>http://shop.suning.com/70088824/10108744.html</mobilePromotionLink>
      <barpic>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</barpic>
      <cmTitle>商品标题</cmTitle>
      <highlightWordtwo>亮点词2</highlightWordtwo>
      <startTime>2018-02-13 11:37:00</startTime>
      <detailModule>
        <num>1</num>
        <moduleName>模块名称</moduleName>
        <moduleId>123</moduleId>
        <type>cat_mod</type>
        <content>模块化详情内容</content>
      </detailModule>
      <highlightWordthree>亮点词3</highlightWordthree>
      <introduction>好品质好商品</introduction>
      <brandCode>A101</brandCode>
      <promotionLink>http://shop.suning.com/70088824/10108744.html</promotionLink>
      <videoCode>108625</videoCode>
      <highBeginTime>2018-02-13 11:37:00</highBeginTime>
      <conventionPoints>常规促销卖点</conventionPoints>
      <categoryCode>R6101011</categoryCode>
      <supplierImgUrl>
        <urlE>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</urlE>
        <urlC>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</urlC>
        <urlD>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</urlD>
        <urlA>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</urlA>
        <urlB>http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg</urlB>
      </supplierImgUrl>
      <mainPicVideoCode>108625</mainPicVideoCode>
      <highEndTime>2018-02-13 11:37:00</highEndTime>
      <promotionFlag>是</promotionFlag>
      <endTime>2018-02-13 11:37:00</endTime>
      <highPoints>高级促销卖点</highPoints>
      <sellingPoints>商品卖点</sellingPoints>
      <highlightWordone>亮点词1</highlightWordone>
      <promotionPoints>活动关联文案</promotionPoints>
    </addApply>
  </sn_body>
</sn_request>

                                
{
  "sn_request": {
    "sn_body": {
      "addApply": {
        "childItem": [
          {
            "barpicX": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "itemCodeX": "111",
            "barcode": "11",
            "supplierImgAUrl": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "parsX": [
              {
                "parCodeX": "111",
                "parValueX": "红色"
              }
            ]
          }
        ],
        "conventionEndTime": "2018-02-13 11:37:00",
        "pars": [
          {
            "parValue": "1",
            "parCode": "cm_model"
          }
        ],
        "itemCode": "naikeabc",
        "conventionBeginTime": "2018-02-13 11:37:00",
        "productName": "大衣",
        "packingList": [
          {
            "packingListName": "电脑",
            "packingListQty": "1"
          }
        ],
        "mobilePromotionLink": "http://shop.suning.com/70088824/10108744.html",
        "barpic": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
        "cmTitle": "商品标题",
        "highlightWordtwo": "亮点词2",
        "startTime": "2018-02-13 11:37:00",
        "detailModule": [
          {
            "num": "1",
            "moduleName": "模块名称",
            "moduleId": "123",
            "type": "cat_mod",
            "content": "模块化详情内容"
          }
        ],
        "highlightWordthree": "亮点词3",
        "introduction": "好品质好商品",
        "brandCode": "A101",
        "promotionLink": "http://shop.suning.com/70088824/10108744.html",
        "videoCode": "108625",
        "highBeginTime": "2018-02-13 11:37:00",
        "conventionPoints": "常规促销卖点",
        "categoryCode": "R6101011",
        "supplierImgUrl": [
          {
            "urlE": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "urlC": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "urlD": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "urlA": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg",
            "urlB": "http://10.19.95.100/uimg/sop/commodity/181223352817344502976922_x.jpg"
          }
        ],
        "mainPicVideoCode": "108625",
        "highEndTime": "2018-02-13 11:37:00",
        "promotionFlag": "是",
        "endTime": "2018-02-13 11:37:00",
        "highPoints": "高级促销卖点",
        "sellingPoints": "商品卖点",
        "highlightWordone": "亮点词1",
        "promotionPoints": "活动关联文案"
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              
<sn_responseContent>
  <sn_body>
    <addApply>
      <applyCode>94d52e1d-32ae-4e8f-8a4a-d782e96f5171</applyCode>
      <applyTime>2016-11-08 00:00:00</applyTime>
    </addApply>
  </sn_body>
</sn_responseContent>

                              
{
  "sn_responseContent": {
    "sn_body": {
      "addApply": {
        "applyCode": "94d52e1d-32ae-4e8f-8a4a-d782e96f5171",
        "applyTime": "2016-11-08 00:00:00"
      }
    }
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

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

业务异常码

异常码	错误描述	解决方案
biz.selfmarket.addapply.length-overlong:*	参数的值超过规定长度	请检查此参数的值,*号表示参数字段名
biz.selfmarket.addapply.missing-parameter:*	参数必填	请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp	服务不可用	请联系苏宁技术人员
biz.selfmarket.addapply.invalid-biz:100	子码条形码重复	子码条形码其他商品重复，请替换
biz.selfmarket.addapply.invalid-biz:101	商品详情错误	校验introduction字段
biz.selfmarket.addapply.invalid-biz:102	条形码重复	条形码和其他商品重复，请替换
biz.selfmarket.addapply.invalid-biz:103	缺少条形码资质图	填写缺少条形码资质图-barpic
biz.selfmarket.addapply.invalid-biz:104	条形码资质图不合规范	条形码资质图不合规范
biz.selfmarket.addapply.invalid-biz:105	条形码资质图不属于商家	条形码资质图不属于商家
biz.selfmarket.addapply.invalid-biz:106	条形码资质图大小过大	条形码资质图大小过大
biz.selfmarket.addapply.invalid-biz:107	条形码资质图长或宽小于800px	条形码资质图长或宽小于800px
biz.selfmarket.addapply.invalid-biz:108	子码条形码资质图不属于商家	子码条形码资质图不属于商家
biz.selfmarket.addapply.invalid-biz:109	子码条形码资质图不属于商家	子码条形码资质图不属于商家
biz.selfmarket.addapply.invalid-biz:110	子码条形码资质图长宽大于800px	子码条形码资质图长宽大于800px
biz.selfmarket.addapply.invalid-biz:111	缺少运营模块	缺少运营模块
biz.selfmarket.addapply.invalid-biz:112	运营模块和自定义模块的名称不能一样	运营模块和自定义模块的名称不能一样
biz.selfmarket.addapply.invalid-biz:113	既不是运营模块，也不是自定义模块	既不是运营模块，也不是自定义模块
biz.selfmarket.addapply.invalid-biz:114	自定义 id必为空，名称和内容必填	自定义 id必为空，名称和内容必填
biz.selfmarket.addapply.invalid-biz:115	自定义模块个数大于10个	自定义模块个数大于10个
biz.selfmarket.addapply.invalid-biz:116	所填运营模块id不在模板当中	所填运营模块id不在模板当中
biz.selfmarket.addapply.invalid-biz:117	运营模板中必填的模块未填写值	运营模板中必填的模块未填写值
biz.selfmarket.addapply.invalid-biz:118	不允许自定义顺序	不允许自定义顺序
biz.selfmarket.addapply.invalid-biz:119	content必须是base64加密	content必须是base64加密
biz.selfmarket.addapply.invalid-biz:120	num重复，或者不为数字	num重复，或者不为数字
biz.selfmarket.addapply.invalid-biz:121	自定义模块名含有敏感词	自定义模块名含有敏感词
biz.selfmarket.addapply.invalid-biz:122	报文中的特性值与参数模板中的不符	报文中的特性值与参数模板中的不符
biz.selfmarket.addapply.invalid-biz:123	产地报错	校验country，region，city是否正确
biz.selfmarket.addapply.invalid-biz:124	基本参数和模板不符合	检查基本参数
biz.selfmarket.addapply.invalid-biz:125	入的报文与所给的类目的通子码属性不符合	校验类目和childItem
biz.selfmarket.addapply.invalid-biz:126	子码条形码必填	子码条形码必填
biz.selfmarket.addapply.invalid-biz:127	子码资质图必填	子码资质图必填
biz.selfmarket.addapply.invalid-biz:128	子商品无特性节点	子商品无特性节点
biz.selfmarket.addapply.invalid-biz:129	特性参数值不符合规范	包含，
biz.selfmarket.addapply.invalid-biz:130	商品主图长或宽小于800px	商品主图长或宽小于800px
biz.selfmarket.addapply.invalid-biz:131	子商品主图长或宽小于800px	子商品主图长或宽小于800px
biz.selfmarket.addapply.invalid-biz:132	报错	看错误描述
biz.selfmarket.addapply.invalid-biz:133	所选充值类型不存在	选择正确的充值类型
biz.selfmarket.addapply.invalid-biz:134	活动链接内容存在时生效时间、失效时间、电脑端链接和移动端链接必填
biz.selfmarket.addapply.invalid-biz:135	活动链接失效时间不得小于生效时间
biz.selfmarket.addapply.invalid-biz:136	输入合法的生效时间和失效时间
biz.selfmarket.addapply.invalid-biz:137	活动链接时间异常
biz.selfmarket.addapply.invalid-biz:138	活动关联文案内容超过25
biz.selfmarket.addapply.invalid-biz:139	商品卖点内容包含手机号
biz.selfmarket.addapply.invalid-biz:140	商品卖点内容超过45
biz.selfmarket.addapply.invalid-biz:141	商品卖点包含敏感词
biz.selfmarket.addapply.invalid-biz:142	活动关联文案内容包含手机号
biz.selfmarket.addapply.invalid-biz:143	活动关联文案内容包含敏感词
biz.selfmarket.addapply.invalid-biz:144	电脑端促销链接不允许出现外部链接
biz.selfmarket.addapply.invalid-biz:145	电脑端促销链接长度不能大于256
biz.selfmarket.addapply.invalid-biz:146	移动端促销链接不允许出现外部链接
biz.selfmarket.addapply.invalid-biz:147	移动端促销链接长度不能大于256
biz.selfmarket.addapply.invalid-biz:148	商品名称最多支持60个字
biz.selfmarket.addapply.invalid-biz:149	电脑端促销链接无效
biz.selfmarket.addapply.invalid-biz:150	移动端促销链接无效
biz.selfmarket.addapply.invalid-biz:151	促销卖点存在时生效时间和失效时间必填
biz.selfmarket.addapply.invalid-biz:152	促销卖点生效时间和失效时间异常
biz.selfmarket.addapply.invalid-biz:153	促销卖点超过30
biz.selfmarket.addapply.invalid-biz:154	促销卖点内容包含手机号
biz.selfmarket.addapply.invalid-biz:155	促销卖点包含敏感词
biz.selfmarket.addapply.invalid-biz:156	亮点词首位不能为空
biz.selfmarket.addapply.invalid-biz:157	国标码+码洋价已被占用
biz.custom.item.invalid-biz.check-hit:urlA	第1张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlB	第2张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlC	第3张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlD	第4张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlE	第5张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlF	第6张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlG	第7张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlH	第8张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlI	第9张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:urlJ	第10张主图图片被稽查命中
biz.custom.item.invalid-biz.check-hit:child-1Url	子码图片被稽查命中
biz.custom.item.invalid-biz:categoryNotActive	您选择的商品类目“类目名称”，已被苏宁禁用	请更换或申请其他类目

公共异常码

异常码	错误描述	解决方案
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

自营业务