退出
热词搜索：
API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.commodity.query 零售云商品详情查询接口
￥免费

零售云商品详情查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
cmmdtyCodeStringY23456553商品编码
distributorCodeStringY4578961230分销商编码
appIdStringYfd3af1ads4jlg3realf5ga调用方唯一编码
storeCodeStringY59021店铺编码
merchantCustNoStringY7017963441老板账号编码
响应参数
名称 类型 示例值 描述
respBeanString
cmmdtyCodeString3412312341商品编码
cmmdtyNameString空调商品名称
distributorCodeString2432123134分销商品编码
cmmdtyDetailString详情信息商品详情
colorNameString红色颜色属性名
colorDispalyNameString红色颜色属性显示名
versionNameString1.0版式名
versionDisplayNameString1.5+版式属性名
cmmdtyParameterListString
snparameterCodeString1232参数代码
snparameterSequenceString1参数排序码
snparameterdescStringXX参数参数描述
snparameterValString1参数描述值
snparametersCodeString322参数组代码
snparametersDescStringcpu参数组名称
snsequenceString1参数组排序
coreFlagString1核心参数
imgUrlListString
imgUrlStringhttps://image.suning.cn/uimg/b2c/newcatentries/0000000000-000000000101820042_1.jpg_800w_800h_4e图片url
packingDetailsString手机*1、电池*1、耳机*1包装清单
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <queryCommodity>
      <cmmdtyCode>23456553</cmmdtyCode>
      <appId>fd3af1ads4jlg3realf5ga</appId>
      <merchantCustNo>7017963441</merchantCustNo>
      <storeCode>59021</storeCode>
      <distributorCode>4578961230</distributorCode>
    </queryCommodity>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryCommodity": {
        "cmmdtyCode": "23456553",
        "appId": "fd3af1ads4jlg3realf5ga",
        "merchantCustNo": "7017963441",
        "distributorCode": "4578961230",
        "storeCode": "59021"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <queryCommodity>
      <respBean>
        <cmmdtyCode>3412312341</cmmdtyCode>
        <imgUrlList>
          <imgUrl>https://image.suning.cn/uimg/b2c/newcatentries/0000000000-000000000101820042_1.jpg_800w_800h_4e</imgUrl>
        </imgUrlList>
        <colorDispalyName>红色</colorDispalyName>
        <colorName>红色</colorName>
        <cmmdtyName>空调</cmmdtyName>
        <cmmdtyDetail>详情信息</cmmdtyDetail>
        <packingDetails>手机*1、电池*1、耳机*1</packingDetails>
        <cmmdtyParameterList>
          <snparametersDesc>cpu</snparametersDesc>
          <snparameterSequence>1</snparameterSequence>
          <snparametersCode>322</snparametersCode>
          <snparameterVal>1</snparameterVal>
          <coreFlag>1</coreFlag>
          <snsequence>1</snsequence>
          <snparameterCode>1232</snparameterCode>
          <snparameterdesc>XX参数</snparameterdesc>
        </cmmdtyParameterList>
        <versionName>1.0</versionName>
        <versionDisplayName>1.5+</versionDisplayName>
        <distributorCode>2432123134</distributorCode>
      </respBean>
    </queryCommodity>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryCommodity": {
        "respBean": {
          "cmmdtyCode": "3412312341",
          "colorDispalyName": "红色",
          "imgUrlList": [
            {
              "imgUrl": "https://image.suning.cn/uimg/b2c/newcatentries/0000000000-000000000101820042_1.jpg_800w_800h_4e"
            }
          ],
          "cmmdtyDetail": "详情信息",
          "cmmdtyName": "空调",
          "colorName": "红色",
          "packingDetails": "手机*1、电池*1、耳机*1",
          "cmmdtyParameterList": [
            {
              "snparametersDesc": "cpu",
              "snparameterSequence": "1",
              "snparametersCode": "322",
              "coreFlag": "1",
              "snparameterVal": "1",
              "snparameterCode": "1232",
              "snsequence": "1",
              "snparameterdesc": "XX参数"
            }
          ],
          "versionDisplayName": "1.5+",
          "versionName": "1.0",
          "distributorCode": "2432123134"
        }
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.retailer.querycommodity.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.retailer.querycommodity.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.retailer.querycommodity.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
biz.retailer.querycommodity.invalid-biz:100 请求参数缺失 请检查请求参数
biz.retailer.querycommodity.invalid-biz:101 接口执行返回失败 请检查请求参数
biz.retailer.querycommodity.invalid-biz:102 查询结果为空 请检查请求参数
biz.retailer.querycommodity.invalid-biz:103 系统异常 请联系苏宁技术人员
biz.retailer.querycommodity.invalid-biz:105 无效的AppId请求 请检查请求参数
biz.retailer.querycommodity.invalid-biz:106 老板编号与门店不匹配 请检查请求参数
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ