API接口目录

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.commoditydetail.query 推广商品详情信息接口
¥免费

推广商品详情信息接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
cityCodeStringN025城市编码 默认为025
commodityStrStringY10586599073-0000000000_10586596940-0070067633格式 商品编码1-供应商编码1_商品编码2-供应商编码2... 商品编码取有效位,供应商编码左补零至10位 最大查询10个商品
picWidthStringN800图片宽度 默认为800
picHeightStringN800图片高度 默认为800
couponMarkStringN11表示拿到券后价,不传按照以前逻辑取不到券后价
响应参数
名称 类型 示例值 描述
commodityInfoString
commodityNameString商品名称示例商品名称
commodityCodeString761137021商品编码
supplierCodeString0000000000供应商编码
supplierNameString供应商名称示例供应商名称
pictureUrlString
locationIdString1图片位置
picUrlStringhttp://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e图片Url
sellingPointString商品卖点示例商品卖点
monthSalesString100月销量
snPriceString100.00易购价
commodityPriceString99.00商品价格
commodityTypeString1商品类型 1:自营 2:C店 3:海外购自营 4:海外购 5:特卖 6:极物
priceTypeString大聚惠价格类型
priceTypeCodeString1价格类型编码 0:正常价格,1:大聚惠 , 2:抢购, 3:渠道专享, 4:限时促销 ,5:爆款抢购,6:掌上抢,7:特卖,99:乐拼购
baoyouString1是否包邮 0:不包邮 1:包邮
rateString20.00佣金比例 (数值为百分比数据)
saleStatusString0是否可售 0:可售,1:无货,2:本地暂不销售
productUrlStringhttps://product.suning.com/供应商编码/商品编码.html四级页地址
forbiddenMarkString11:禁售 0:非禁售
isActString10不是 1是
pgInfoString
pgNumString3成团人数
pgPriceString20.00拼购价
pgUrlStringhttps://pin.suning.com/pgs/product/45918238111498247256.html拼购四级页地址
pgActionIdString45918238111498247256拼购活动ID
minOrderQuantityString1拼购商品起售数量
categoryInfoString
firstSaleCategoryIdString50000一级销售目录ID
firstSaleCategoryNameString一级销售目录名称示例一级销售目录名称
secondSaleCategoryIdString50000二级销售目录ID
secondSaleCategoryNameString二级销售目录名称示例二级销售目录名称
thirdSaleCategoryIdString50000三级销售目录ID
thirdSaleCategoryNameString三级销售目录名称示例三级销售目录名称
firstPurchaseCategoryIdStringR001一级采购目录ID
firstPurchaseCategoryNameString一级采购目录名称示例一级采购目录名称
secondPurchaseCategoryIdStringR002二级采购目录ID
secondPurchaseCategoryNameString二级采购目录名称示例二级采购目录名称
thirdPurchaseCategoryIdStringR003三级采购目录ID
thirdPurchaseCategoryNameString三级采购目录名称示例三级采购目录名称
goodsGroupCategoryIdStringR9001213商品组目录ID
goodsGroupCategoryNameString商品组目录名称示例商品组目录名称
couponInfoString
couponUrlStringhttps://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM券链接URL
activityIdString201907040010040371券活动编码
activitySecretKeyStringmzekhfSGwaRrZIopV0M1wGRM券秘钥
couponValueString10.00券面额
couponCountString2000券总数
couponStartTimeString2019-07-04 17:10:47券领取开始时间
couponEndTimeString2019-07-04 17:10:47券领取结束时间
startTimeString2019-07-04 17:10:47券使用开始时间
endTimeString2019-07-04 17:10:47券使用结束时间
bounsLimitString15.00基数数值
activityDescriptionString免费领取送券10元活动描述
afterCouponPriceString60.00券后价
preferentialDistinctString奖励优惠说明奖励优惠说明
couponShowTypeString1券标识类型,1.金额券 2,打折券
descriptionForListString列表页券描述列表页券描述
bounsAmountString奖励数值(券面额)奖励数值(券面额)
advanceSaleString
isReserveCommodityString1是否预售
depositAmountString100定金
depositEndTimeString2017-10-10 10:00:00付定金结束时间
orderActivityString
activityRuleListString
floorString1层级
baseAmountString2基数数值
rewardAmountString0.2奖励数值
activityDescriptionString满2件打8折奖励描述
cmmdtyReviewInfoString
totalReviewCountString123评价总数
goodReviewCountString12好评数量
goodRateString12好评率
subCodeListString
subCodeString123子码
parametersListString
parameterCodeString2参数代码
parameterSequenceString12参数排序码
parameterDescString12参数描述
parameterValString12参数描述值
parametersCodeString12参数组代码
parametersDescString12参数组描述
sequenceString1参数组排序
explainString说明参数说明文
coreFlagString1核心参数
arrivalPriceString10商品到手价
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryCommoditydetail>
      <picWidth>800</picWidth>
      <couponMark>1</couponMark>
      <picHeight>800</picHeight>
      <cityCode>025</cityCode>
      <commodityStr>10586599073-0000000000_10586596940-0070067633</commodityStr>
    </queryCommoditydetail>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryCommoditydetail": {
        "picWidth": "800",
        "couponMark": "1",
        "picHeight": "800",
        "cityCode": "025",
        "commodityStr": "10586599073-0000000000_10586596940-0070067633"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryCommoditydetail>
      <advanceSale>
        <depositAmount>100</depositAmount>
        <depositEndTime>2017-10-10 10:00:00</depositEndTime>
        <isReserveCommodity>1</isReserveCommodity>
      </advanceSale>
      <subCodeList>
        <subCode>123</subCode>
      </subCodeList>
      <couponInfo>
        <activitySecretKey>mzekhfSGwaRrZIopV0M1wGRM</activitySecretKey>
        <couponShowType>1</couponShowType>
        <afterCouponPrice>60.00</afterCouponPrice>
        <couponCount>2000</couponCount>
        <couponUrl>https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&amp;activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM</couponUrl>
        <couponValue>10.00</couponValue>
        <bounsLimit>15.00</bounsLimit>
        <couponEndTime>2019-07-04 17:10:47</couponEndTime>
        <activityId>201907040010040371</activityId>
        <preferentialDistinct>奖励优惠说明</preferentialDistinct>
        <couponStartTime>2019-07-04 17:10:47</couponStartTime>
        <descriptionForList>列表页券描述</descriptionForList>
        <startTime>2019-07-04 17:10:47</startTime>
        <activityDescription>免费领取送券10元</activityDescription>
        <endTime>2019-07-04 17:10:47</endTime>
        <bounsAmount>奖励数值(券面额)</bounsAmount>
      </couponInfo>
      <orderActivity>
        <activityRuleList>
          <rewardAmount>0.2</rewardAmount>
          <floor>1</floor>
          <baseAmount>2</baseAmount>
        </activityRuleList>
        <activityDescription>满2件打8折</activityDescription>
      </orderActivity>
      <pgInfo>
        <pgUrl>https://pin.suning.com/pgs/product/45918238111498247256.html</pgUrl>
        <pgActionId>45918238111498247256</pgActionId>
        <pgNum>3</pgNum>
        <minOrderQuantity>1</minOrderQuantity>
        <pgPrice>20.00</pgPrice>
      </pgInfo>
      <arrivalPrice>10</arrivalPrice>
      <parametersList>
        <explain>说明</explain>
        <parameterDesc>12</parameterDesc>
        <sequence>1</sequence>
        <parameterVal>12</parameterVal>
        <parametersCode>12</parametersCode>
        <parameterSequence>12</parameterSequence>
        <coreFlag>1</coreFlag>
        <parametersDesc>12</parametersDesc>
        <parameterCode>2</parameterCode>
      </parametersList>
      <categoryInfo>
        <firstPurchaseCategoryId>R001</firstPurchaseCategoryId>
        <secondPurchaseCategoryId>R002</secondPurchaseCategoryId>
        <goodsGroupCategoryId>R9001213</goodsGroupCategoryId>
        <firstPurchaseCategoryName>一级采购目录名称示例</firstPurchaseCategoryName>
        <thirdSaleCategoryId>50000</thirdSaleCategoryId>
        <secondSaleCategoryId>50000</secondSaleCategoryId>
        <secondSaleCategoryName>二级销售目录名称示例</secondSaleCategoryName>
        <goodsGroupCategoryName>商品组目录名称示例</goodsGroupCategoryName>
        <firstSaleCategoryId>50000</firstSaleCategoryId>
        <thirdPurchaseCategoryId>R003</thirdPurchaseCategoryId>
        <firstSaleCategoryName>一级销售目录名称示例</firstSaleCategoryName>
        <thirdSaleCategoryName>三级销售目录名称示例</thirdSaleCategoryName>
        <thirdPurchaseCategoryName>三级采购目录名称示例</thirdPurchaseCategoryName>
        <secondPurchaseCategoryName>二级采购目录名称示例</secondPurchaseCategoryName>
      </categoryInfo>
      <cmmdtyReviewInfo>
        <goodRate>12</goodRate>
        <goodReviewCount>12</goodReviewCount>
        <totalReviewCount>123</totalReviewCount>
      </cmmdtyReviewInfo>
      <commodityInfo>
        <supplierName>供应商名称示例</supplierName>
        <pictureUrl>
          <picUrl>http://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e</picUrl>
          <locationId>1</locationId>
        </pictureUrl>
        <priceType>大聚惠</priceType>
        <baoyou>1</baoyou>
        <sellingPoint>商品卖点示例</sellingPoint>
        <saleStatus>0</saleStatus>
        <supplierCode>0000000000</supplierCode>
        <commodityPrice>99.00</commodityPrice>
        <commodityType>1</commodityType>
        <monthSales>100</monthSales>
        <snPrice>100.00</snPrice>
        <forbiddenMark>1</forbiddenMark>
        <isAct>1</isAct>
        <priceTypeCode>1</priceTypeCode>
        <rate>20.00</rate>
        <commodityCode>761137021</commodityCode>
        <productUrl>https://product.suning.com/供应商编码/商品编码.html</productUrl>
        <commodityName>商品名称示例</commodityName>
      </commodityInfo>
    </queryCommoditydetail>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryCommoditydetail": {
        "advanceSale": [
          {
            "depositAmount": "100",
            "depositEndTime": "2017-10-10 10:00:00",
            "isReserveCommodity": "1"
          }
        ],
        "subCodeList": [
          {
            "subCode": "123"
          }
        ],
        "couponInfo": [
          {
            "activitySecretKey": "mzekhfSGwaRrZIopV0M1wGRM",
            "couponShowType": "1",
            "afterCouponPrice": "60.00",
            "couponCount": "2000",
            "couponUrl": "https://quan.suning.com/lqzx_recommend.do?activityId=201907040010040371&activitySecretKey=mzekhfSGwaRrZIopV0M1wGRM",
            "couponValue": "10.00",
            "bounsLimit": "15.00",
            "couponEndTime": "2019-07-04 17:10:47",
            "activityId": "201907040010040371",
            "preferentialDistinct": "奖励优惠说明",
            "couponStartTime": "2019-07-04 17:10:47",
            "descriptionForList": "列表页券描述",
            "startTime": "2019-07-04 17:10:47",
            "activityDescription": "免费领取送券10元",
            "endTime": "2019-07-04 17:10:47",
            "bounsAmount": "奖励数值(券面额)"
          }
        ],
        "orderActivity": [
          {
            "activityRuleList": [
              {
                "rewardAmount": "0.2",
                "floor": "1",
                "baseAmount": "2"
              }
            ],
            "activityDescription": "满2件打8折"
          }
        ],
        "pgInfo": [
          {
            "pgUrl": "https://pin.suning.com/pgs/product/45918238111498247256.html",
            "pgActionId": "45918238111498247256",
            "pgNum": "3",
            "minOrderQuantity": "1",
            "pgPrice": "20.00"
          }
        ],
        "arrivalPrice": "10",
        "parametersList": [
          {
            "explain": "说明",
            "parameterDesc": "12",
            "sequence": "1",
            "parameterVal": "12",
            "parametersCode": "12",
            "parameterSequence": "12",
            "coreFlag": "1",
            "parametersDesc": "12",
            "parameterCode": "2"
          }
        ],
        "categoryInfo": [
          {
            "firstPurchaseCategoryId": "R001",
            "secondPurchaseCategoryId": "R002",
            "goodsGroupCategoryId": "R9001213",
            "firstPurchaseCategoryName": "一级采购目录名称示例",
            "thirdSaleCategoryId": "50000",
            "secondSaleCategoryId": "50000",
            "secondSaleCategoryName": "二级销售目录名称示例",
            "goodsGroupCategoryName": "商品组目录名称示例",
            "firstSaleCategoryId": "50000",
            "thirdPurchaseCategoryId": "R003",
            "firstSaleCategoryName": "一级销售目录名称示例",
            "thirdSaleCategoryName": "三级销售目录名称示例",
            "thirdPurchaseCategoryName": "三级采购目录名称示例",
            "secondPurchaseCategoryName": "二级采购目录名称示例"
          }
        ],
        "cmmdtyReviewInfo": [
          {
            "goodRate": "12",
            "goodReviewCount": "12",
            "totalReviewCount": "123"
          }
        ],
        "commodityInfo": [
          {
            "supplierName": "供应商名称示例",
            "pictureUrl": [
              {
                "picUrl": "http://imgservice.suning.com/oss_xzsit_01/b2c/imagesit/XeLxwI2tuqZUZ1WsIwJ5sw.jpg_200w_200h_4e",
                "locationId": "1"
              }
            ],
            "priceType": "大聚惠",
            "baoyou": "1",
            "sellingPoint": "商品卖点示例",
            "saleStatus": "0",
            "supplierCode": "0000000000",
            "commodityPrice": "99.00",
            "commodityType": "1",
            "monthSales": "100",
            "snPrice": "100.00",
            "forbiddenMark": "1",
            "isAct": "1",
            "priceTypeCode": "1",
            "rate": "20.00",
            "commodityCode": "761137021",
            "productUrl": "https://product.suning.com/供应商编码/商品编码.html",
            "commodityName": "商品名称示例"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.netalliance.querycommoditydetail.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.netalliance.querycommoditydetail.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.suis 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ