开放服务-API列表

1．可以对自己发布的商品进行纠错，包含修改发布的新商品、已有商品，且商品已处理完毕产生苏宁商品编码。
2．纠错的商品必须是非文化制品类的商品。
3．纠错需要审核，可凭纠错申请号调用商品纠错结果查询接口查询纠错结果。
4．当商品不含子商品时，商品可纠错的内容有：商品名称、装箱清单、商品主图1、商品主图2、商品主图3、商品主图4、商品主图5。参数值字段中，至少一个字段必须有值。参数代码、参数值字段必须成对出现。

5．当商品含有子商品时，主商品可纠错的内容有商品名称、装箱清单、主商品参数值、参数代码、参数值字段必须成对出现。子商品可以纠错的内容有子商品条形码、子商品参数值、子商品图片1、子商品图片2、子商品图片3、子商品图片4、子商品图片5。

公共参数

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

请求参数

名称	类型	是否必须	示例值	描述
productCode	String	Y	1004562459	苏宁系统主商品编码
correctParams	String	N
correctKey	String	Y	productName	1.不含子商品，可以纠错以下字段：productName以及对应的参数代码，如：cm_model(商品型号)。 2.含有子商品，可以纠错以下字段： (1)主商品纠错内容：productName、对应的参数代码，如：cm_model(商品型号)。 (2)子商品纠错内容：cm_barCode(子商品条形码)以及对应的子商品参数代码
correctValue	String	Y	美的空调	纠正后的值（参数值为多选的用英文逗号隔开）
correctReason	String	N	名字写错了	针对每个修改的值填写纠错原因(注：对商品图片纠错，只需要填写纠错理由且必填，若纠错理由和说明图片都填，默认取纠错理由，纠错理由限制为500个字；对应其他字段纠错理由和说明图片必填其一。)
correctPic	String	N	http://10.19.95.100/uimg/sop/richtext/201401240949566545.gif	针对每个修改的值填写说明图片url（url为苏宁图片上传接口返回的值）
barpic	String	N	(条形码图片地址)	条形码图片，纠错条形码参数时需填写
itemCode	String	N	10045073	商家商品编码。如需修改子商品信息时，苏宁子商品编码与商家商品编码必填其一，若都填则默认苏宁子商品编码
productCode	String	N	1004562459	苏宁子商品编码。如需修改子商品信息时，苏宁子商品编码与商家商品编码必填其一，若都填则默认苏宁子商品编码

响应参数

名称	类型	示例值	描述
applyCode	String	1000245	申请时产生的申请编号
applyTime	String	2015-03-14 16:00:00	接口接收成功后系统时间，精确到秒。

请求示例

XML示例
JSON示例

复制全部代码

                                <sn_request>
  <sn_body>
    <errCorreCont>
      <productCode>1004562459</productCode>
      <correctParams>
        <barpic>(条形码图片地址)</barpic>
        <correctKey>productName</correctKey>
        <productCode>1004562459</productCode>
        <correctValue>美的空调</correctValue>
        <correctReason>名字写错了</correctReason>
        <correctPic>http://10.19.95.100/uimg/sop/richtext/201401240949566545.gif</correctPic>
        <itemCode>10045073</itemCode>
      </correctParams>
    </errCorreCont>
  </sn_body>
</sn_request>

                                {
  "sn_request": {
    "sn_body": {
      "errCorreCont": {
        "productCode": "1004562459",
        "correctParams": [
          {
            "barpic": "(条形码图片地址)",
            "correctKey": "productName",
            "productCode": "1004562459",
            "correctReason": "名字写错了",
            "correctValue": "美的空调",
            "correctPic": "http://10.19.95.100/uimg/sop/richtext/201401240949566545.gif",
            "itemCode": "10045073"
          }
        ]
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              <sn_responseContent>
  <sn_body>
    <errCorreCont>
      <applyTime>2015-03-14 16:00:00</applyTime>
      <applyCode>1000245</applyCode>
    </errCorreCont>
  </sn_body>
</sn_responseContent>

                              {
  "sn_responseContent": {
    "sn_body": {
      "errCorreCont": {
        "applyTime": "2015-03-14 16:00:00",
        "applyCode": "1000245"
      }
    }
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

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

业务异常码

异常码	错误描述	解决方案
biz.custom.modifymainproduct.missing-parameter:*	参数必填	请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.mcmp	服务不可用	请联系苏宁技术人员
biz.custom.modifymainproduct.invalid-biz:100	苏宁商品编码不存在	检查苏宁商品编码是否正确
biz.custom.modifymainproduct.invalid-biz:101	苏宁商品编码对应多个商家商品编码	检查苏宁商品编码是否正确
biz.custom.modifymainproduct.invalid-biz:102	纠错请求不能重复提交，请稍后	请稍后重试或联系苏宁技术人员
biz.custom.modifymainproduct.invalid-biz:103	O2O协议终止屏蔽中	请联系苏宁联系运营人员
biz.custom.modifymainproduct.invalid-biz:104	纠错信息为空	检查纠错信息是否为空
biz.custom.modifymainproduct.invalid-biz:105	不支持该业务的纠错	请联系苏宁联系运营人员
biz.custom.modifymainproduct.invalid-biz:106	当前商家没权限操作该商品	请更换操作的产品Code
biz.custom.modifymainproduct.invalid-biz:107	该商品的一级类目必须为非文化制品	请更换操作的产品Code为非文化制品
biz.custom.modifymainproduct.invalid-biz:108	该商品审批未完成，不能纠错	等待该商品审批完成后进行纠错
biz.custom.modifymainproduct.invalid-biz:109	商品主数据未下发，请稍后再试	请稍后再试
biz.custom.modifymainproduct.invalid-biz:110	C店运营商类目业务类型不支持纠错	请更换操作的类目
biz.custom.modifymainproduct.invalid-biz:111	汽车服务类型值错误	请更换操作的参数Code
biz.custom.modifymainproduct.invalid-biz:112	不支持纠错的汽车服务类型	请更换操作的参数Code
biz.custom.modifymainproduct.invalid-biz:113	纠错参数编码为空	检查纠错参数编码是否为空
biz.custom.modifymainproduct.invalid-biz:114	缺少参数值*	检查纠错参数值是否为空
biz.custom.modifymainproduct.invalid-biz:115	纠错参数编码重复	检查纠错参数编码是否重复
biz.custom.modifymainproduct.invalid-biz:116	该主商品不存在子商品信息	只能对主商品纠错，请删除子商品编码
biz.custom.modifymainproduct.invalid-biz:117	该主商品与子商品不存在父子关系	请对该主商品的子商品进行纠错
biz.custom.modifymainproduct.invalid-biz:118	相同子码只能对一个isbn纠错	如果传了相同的子商品Code，只能对ISBN进行一遍纠错
biz.custom.modifymainproduct.invalid-biz:119	子码维度下只能对isbn纠错	只能对子商品的ISBN进行纠错
biz.custom.modifymainproduct.invalid-biz:120	商品名称最多支持60个字	将商品名称控制在60字内
biz.custom.modifymainproduct.invalid-biz:121	商品名称包含以下敏感词:*	替换敏感词
biz.custom.modifymainproduct.invalid-biz:122	商品名称校验重复失败	系统异常，请稍后再试或联系运营人员
biz.custom.modifymainproduct.invalid-biz:123	商品名称重复	请至苏宁商品库中搜索已有商品，或者发布新商品
biz.custom.modifymainproduct.invalid-biz:124	此商品的名称禁止修改，如有需要请联系商管	联系苏宁运营人员
biz.custom.modifymainproduct.invalid-biz:125	产地错误	请调用国家编码获取和城市编码获取接口获取正确编码
biz.custom.modifymainproduct.invalid-biz:126	通码无法纠错条形码	请删除条形码
biz.custom.modifymainproduct.invalid-biz:127	条形码只能输入数字或大写字母或者13个0，请核查	请填写由数字和字母组成的条形码
biz.custom.modifymainproduct.invalid-biz:128	条形码已经存在，不能删除，若有疑问，请联系商管	若有疑问，请联系商管
biz.custom.modifymainproduct.invalid-biz:129	条形码被占用	请联系商管
biz.custom.modifymainproduct.invalid-biz:130	目前有在库库存，不能修改条形码	如有疑问，请联系商管
biz.custom.modifymainproduct.invalid-biz:131	条形码资质图必填	请填写条形码资质图
biz.custom.modifymainproduct.invalid-biz:132	条形码资质图错误	请填写正确的条形码资质图
biz.custom.modifymainproduct.invalid-biz:133	单品体积格式错误	单品体积只能填写数字，且整数部分最多10位，小数部分最多3位
biz.custom.modifymainproduct.invalid-biz:134	体积不允许为零	请正确填写体积
biz.custom.modifymainproduct.invalid-biz:135	单品毛重格式错误	单品毛重最多支持13个字只支持数字，且小数部分最多3位
biz.custom.modifymainproduct.invalid-biz:136	毛重不允许为零	请正确填写毛重
biz.custom.modifymainproduct.invalid-biz:137	装箱清单值超长	发货清单值总长度不能超过最大长度600
biz.custom.modifymainproduct.invalid-biz:138	发货清单值总项数不能超多20项	发货清单值总项数不能超多20项
biz.custom.modifymainproduct.invalid-biz:139	发货清单值格式不正确	请检查发货清单值
biz.custom.modifymainproduct.invalid-biz:140	发货清单值物品名称超长	发货清单值物品名称最多不超过60个字
biz.custom.modifymainproduct.invalid-biz:141	发货清单值数量格式不正确	发货清单值数量必须是数字，且最多不超多13位
biz.custom.modifymainproduct.invalid-biz:142	物流净重格式不正确	物流净重只能填写数字，且小数部分最多3位
biz.custom.modifymainproduct.invalid-biz:143	保质期格式不正确	保质期单位为天，且最多输入4位正整数
biz.custom.modifymainproduct.invalid-biz:144	厂家包装含量格式不正确	厂家包装含量最多输入5位正整数
biz.custom.modifymainproduct.invalid-biz:145	商品型号格式不正确	商品型号，最多输入40个字符
biz.custom.modifymainproduct.invalid-biz:146	参数编码为单选类型参数只能选择一个选项	请填写单个选项
biz.custom.modifymainproduct.invalid-biz:147	参数编码选项CODE错误, 不在对应的参数模板中	请填写正确的选项CODE
biz.custom.modifymainproduct.invalid-biz:148	参数属性值长度超长	请缩减参数值到规定范围内
biz.custom.modifymainproduct.invalid-biz:149	参数编码参数值错误	参数编码参数属性值须为数字,宽不超过xxx位，小数为数最多3位的数字
biz.custom.modifymainproduct.invalid-biz:150	参数编码的日期格式不正确或值非法	请填写格式正确的参数
biz.custom.modifymainproduct.invalid-biz:151	参数编码的时间格式为hh:mm:ss,例如 01:01:01	请填写格式正确的参数
biz.custom.modifymainproduct.invalid-biz:152	参数值包含以下敏感词	替换敏感词
biz.custom.modifymainproduct.invalid-biz:153	参数编码不存在	请输入正确的参数编码
biz.custom.modifymainproduct.invalid-biz:154	3C认证不存在	，请填写有效的证书编号和（生产者）制造商。
biz.custom.modifymainproduct.invalid-biz:155	苏宁子商品编码和商家商品编码必须有一个字段有值	苏宁子商品编码和商家商品编码必须有一个字段有值
biz.custom.modifymainproduct.invalid-biz:156	商家商品编码不存在	请检查商家商品编码或联系苏宁技术人员
biz.custom.modifymainproduct.invalid-biz:157	苏宁子商品编码不存在	请检查苏宁子商品编码

公共异常码

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