API接口目录

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.commoditydetail.query 查询商品详情信息(苏宁小店)
¥免费

通过商家编码 + (苏宁门店编码 或 商家门店编码) + 苏宁商品编码 查找商品详情信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
storeCodeStringNxxx苏宁门店编码
appStoreCodeStringNxxx商家门店编码
productCodeStringYxxx苏宁商品编码
响应参数
名称 类型 示例值 描述
returnFlagStringY返回结果 Y-成功 N- 失败
firstCategoryNameString外卖上门一级类目名称
secondCategoryNameString快餐便当二级类目名称
thirdCategoryNameString便当三级类目名称
fourCategoryNameString便当四级类目名称
productNameString商品xxx商品名称
brandCodeStringxx商品品牌
cmBarcodeStringxxx商品条码
brgewStringxx毛重
supplierCmCodeStringxxx商家商品编码
advertiseStringxxx广告词
picUrlStringxxx.jpeg,xxx.jpeg商品图片
classifyCodeStringxxx一级店内分类编码
classifyNameStringxxx二级店内分类名称
secondClassifyCodeStringxxx二级店内分类编码
secondClassifyNameStringxxx二级店内分类名称
sellPriceString1.90价格
packingPriceString1.11餐盒费
qtyString1库存
deliveryAttrStringxxx配送属性
purchaseMinStringxxx起购量
servicetimeStringxx服务时长
immediateAppointString111立即预约
onTimeStringxxx立即预约时间
sellStatusStringxx上下架状态
sellHoursTypeStringxxx售卖类型
standardInfoString
standardNameStringxxx规格名称
standardCodeStringxxx规格编码
isMultiStringxxx是否支持消费者多选
choiceListString
choiceCodeStringxxx选项编码
choiceNameStringxxx选项名称
choicePriceStringxxx加价金额
attrInfoString
attrNameStringxxx属性名称
attrCodeStringxxx属性编码
attrIsMultiStringxxx是否支持多选
attrChoiceListString
attrChoiceCodeStringxx选项编码
attrChoiceNameStringxxx选项名称
paramListString
dyParamCodeStringxxx参数编码
dyParamValueStringxxx参数值
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryCommoditydetail>
      <appStoreCode>xxx</appStoreCode>
      <productCode>xxx</productCode>
      <storeCode>xxx</storeCode>
    </queryCommoditydetail>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryCommoditydetail": {
        "appStoreCode": "xxx",
        "productCode": "xxx",
        "storeCode": "xxx"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryCommoditydetail>
      <sellPrice>1.90</sellPrice>
      <sellStatus>xx</sellStatus>
      <advertise>xxx</advertise>
      <paramList>
        <dyParamValue>xxx</dyParamValue>
        <dyParamCode>xxx</dyParamCode>
      </paramList>
      <brgew>xx</brgew>
      <secondClassifyName>xxx</secondClassifyName>
      <secondClassifyCode>xxx</secondClassifyCode>
      <sellHoursType>xxx</sellHoursType>
      <standardInfo>
        <choiceList>
          <choicePrice>xxx</choicePrice>
          <choiceCode>xxx</choiceCode>
          <choiceName>xxx</choiceName>
        </choiceList>
        <isMulti>xxx</isMulti>
        <standardName>xxx</standardName>
        <standardCode>xxx</standardCode>
      </standardInfo>
      <classifyCode>xxx</classifyCode>
      <secondCategoryName>快餐便当</secondCategoryName>
      <fourCategoryName>便当</fourCategoryName>
      <thirdCategoryName>便当</thirdCategoryName>
      <brandCode>xx</brandCode>
      <deliveryAttr>xxx</deliveryAttr>
      <classifyName>xxx</classifyName>
      <picUrl>xxx.jpeg,xxx.jpeg</picUrl>
      <immediateAppoint>111</immediateAppoint>
      <purchaseMin>xxx</purchaseMin>
      <attrInfo>
        <attrChoiceList>
          <attrChoiceName>xxx</attrChoiceName>
          <attrChoiceCode>xx</attrChoiceCode>
        </attrChoiceList>
        <attrIsMulti>xxx</attrIsMulti>
        <attrName>xxx</attrName>
        <attrCode>xxx</attrCode>
      </attrInfo>
      <qty>1</qty>
      <onTime>xxx</onTime>
      <firstCategoryName>外卖上门</firstCategoryName>
      <supplierCmCode>xxx</supplierCmCode>
      <servicetime>xx</servicetime>
      <cmBarcode>xxx</cmBarcode>
      <returnFlag>Y</returnFlag>
      <productName>商品xxx</productName>
      <packingPrice>1.11</packingPrice>
    </queryCommoditydetail>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryCommoditydetail": {
        "sellStatus": "xx",
        "sellPrice": "1.90",
        "advertise": "xxx",
        "secondClassifyName": "xxx",
        "brgew": "xx",
        "paramList": [
          {
            "dyParamValue": "xxx",
            "dyParamCode": "xxx"
          }
        ],
        "sellHoursType": "xxx",
        "secondClassifyCode": "xxx",
        "standardInfo": [
          {
            "choiceList": [
              {
                "choicePrice": "xxx",
                "choiceCode": "xxx",
                "choiceName": "xxx"
              }
            ],
            "isMulti": "xxx",
            "standardCode": "xxx",
            "standardName": "xxx"
          }
        ],
        "secondCategoryName": "快餐便当",
        "classifyCode": "xxx",
        "fourCategoryName": "便当",
        "thirdCategoryName": "便当",
        "brandCode": "xx",
        "deliveryAttr": "xxx",
        "classifyName": "xxx",
        "picUrl": "xxx.jpeg,xxx.jpeg",
        "immediateAppoint": "111",
        "purchaseMin": "xxx",
        "attrInfo": [
          {
            "attrChoiceList": [
              {
                "attrChoiceName": "xxx",
                "attrChoiceCode": "xx"
              }
            ],
            "attrIsMulti": "xxx",
            "attrName": "xxx",
            "attrCode": "xxx"
          }
        ],
        "qty": "1",
        "onTime": "xxx",
        "firstCategoryName": "外卖上门",
        "servicetime": "xx",
        "supplierCmCode": "xxx",
        "cmBarcode": "xxx",
        "returnFlag": "Y",
        "productName": "商品xxx",
        "packingPrice": "1.11"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.store.querycommoditydetail.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.store.querycommoditydetail.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mcmp 服务不可用 请联系苏宁技术人员
biz.store.querycommoditydetail.invalid-biz:100 商家编码不能为空!
biz.store.querycommoditydetail.invalid-biz:101 门店编码信息有误!
biz.store.querycommoditydetail.invalid-biz:102 商家编码最多十位!
biz.store.querycommoditydetail.invalid-biz:103 门店编码最多十位!
biz.store.querycommoditydetail.invalid-biz:104 申请编码和商品编码不能同时为空!
biz.store.querycommoditydetail.invalid-biz:105 商家门店信息不存在!
公共异常码
API工具
FAQ