API接口目录

电商能力输出业务

商品API
商品API
价格API
订单API
营销API
基础数据API
物流API
促销API
同城帮定制API
优惠券定制业务API
会员API
客服沟通咨询API
三方库存API
账单API
异常码自查工具
suning.online.promotiontags.query 查询促销标签展示接口
¥免费

搜索促销标签展示接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
memberNoStringY1232332342会员编码
chanIdStringY01终端编码:(01-PC;02-APP;03:WAP)
cityStringY平凉市城市名称
productsListStringN
productNumberStringY1232332342商品编码
productPriceStringY10.00商品价格
businessSignStringY0业务标识:0-普通商品;
marketingActivityTypeStringY0营销活动类型(0:普通商品;4-1:大聚惠;4-9:限时促销;4-12:掌上抢;14:促销价;15:大促价;19:渠道专享价;)
shopCodeStringN123456店铺编码,C店商品时必填
supplierCodeStringN0000000000供应商编码,C店商品时必填
响应参数
名称 类型 示例值 描述
productsListString
productNumberString1232332342商品编码
shopCodeString123456店铺编码
activityListString
activityTypeIdString4活动类型
activityIdString1232332342活动编码
activitySecretKeyString1232332342活动秘钥
activityDescriptionString满2件打9折活动描述
bonusListString
bonusIdString1232332342奖励编码
couponTypeString10001券类型: 10001-云券;10002-限品类云券;10004-易券;10005-限品类易券;10009-无敌券;
couponValueString10.00券面值
couponPromotionLabelString满99用1券规则优惠说明
couponStartTimeString2020-02-10 12:23:43券规则开始时间
couponEndTimeString2020-02-10 12:44:55券规则结束时间
bonusRulesDescString满2件打9折奖励规则信息
couponRuleInfoString
couponShowTypeString1券标识类型:1.金额券 2,打折券
couponRuleBonusListString
levelIdString1奖励层级ID
baseAddUpTypeString0基数累计方式 0:无 1:固定值 2:每 3:满
bounsLimitString满100元打8.8折的100基数数值
baseQuantifierTypeString1基数量词类型1:金额: 2:人数 3:件数 4:概率 5 : 类目类型
bounsAmountString10.00奖励数值
rewardQuantifierTypeString5奖励量词类型 1:金额: 2:人数 3:件数 4:概率 5:折扣 6、外围系统指定 8、定价
singleMaxRewardAmountString最多减免Y元的Y单次奖励最大值
preferentialDistinctString满10用5奖励优惠说明
activityRuleListString
baseAddUpTypeString0基数累计方式 枚举:0:无 1:固定值 2:每 3:满 4:第 5:阶梯时间 6:阶梯次数 示例: 满100减10 ,基数积累方式取值满 每100减10元,最大优惠200 最大优惠200 基数积累方式取值每
floorString1/2/3/4/5…… 含义:层级指的是,满100减10,满200减25, 两个层级层级
baseAmountString含义:例如满100减10基数值是100, 满3件打9折,最大优惠200的基数值是3基数数值
baseQuantifierTypeString枚举:1:金额: 2:人数 3:件数 4:概率 5 : 类目类型 例如满100减10基数值量词是类型是金额, 满3件打9折,最大优惠200的基数类型是折扣基数量词类型
scopeTypeString1:一级类目 2:二级类目 3:三级类目 4:四级类目 5 : 品牌类目类型
rewardAmountString例如满100减10奖励数值即10 满3件减1件 优惠值是1件,即1注意:满3件打9折奖励值是1折 如果是券则是9 如果是活动,则是0.1奖励数值
rewardQuantifierTypeString"枚举:1:金额: 2:人数 3:件数 4:概率 5:折扣 6、外围系统指定 8、定价 例如满100减10类型是金额,满100打9折是折扣,满3件减1件是件数"奖励量词类型
singleMaxRewardAmountString1单次奖励最大值
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryPromotiontags>
      <memberNo>1232332342</memberNo>
      <productsList>
        <shopCode>123456</shopCode>
        <marketingActivityType>0</marketingActivityType>
        <businessSign>0</businessSign>
        <productNumber>1232332342</productNumber>
        <supplierCode>0000000000</supplierCode>
        <productPrice>10.00</productPrice>
      </productsList>
      <city>平凉市</city>
      <chanId>01</chanId>
    </queryPromotiontags>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryPromotiontags": {
        "memberNo": "1232332342",
        "productsList": [
          {
            "shopCode": "123456",
            "marketingActivityType": "0",
            "businessSign": "0",
            "productNumber": "1232332342",
            "supplierCode": "0000000000",
            "productPrice": "10.00"
          }
        ],
        "city": "平凉市",
        "chanId": "01"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryPromotiontags>
      <productsList>
        <shopCode>123456</shopCode>
        <productNumber>1232332342</productNumber>
        <activityList>
          <activitySecretKey>1232332342</activitySecretKey>
          <activityId>1232332342</activityId>
          <activityRuleList>
            <singleMaxRewardAmount>1</singleMaxRewardAmount>
            <baseAddUpType>0</baseAddUpType>
            <rewardQuantifierType>"枚举:1:金额: 2:人数 3:件数 4:概率 5:折扣 6、外围系统指定 8、定价 例如满100减10类型是金额,满100打9折是折扣,满3件减1件是件数"</rewardQuantifierType>
            <scopeType>1:一级类目 2:二级类目 3:三级类目 4:四级类目 5 : 品牌</scopeType>
            <baseQuantifierType>枚举:1:金额: 2:人数 3:件数 4:概率 5 : 类目类型 例如满100减10基数值量词是类型是金额, 满3件打9折,最大优惠200的基数类型是折扣</baseQuantifierType>
            <rewardAmount>例如满100减10奖励数值即10  满3件减1件 优惠值是1件,即1注意:满3件打9折奖励值是1折 如果是券则是9 如果是活动,则是0.1</rewardAmount>
            <floor>1/2/3/4/5…… 含义:层级指的是,满100减10,满200减25, 两个层级</floor>
            <baseAmount>含义:例如满100减10基数值是100, 满3件打9折,最大优惠200的基数值是3</baseAmount>
          </activityRuleList>
          <couponRuleInfo>
            <couponRuleBonusList>
              <bounsLimit>满100元打8.8折的100</bounsLimit>
              <preferentialDistinct>满10用5</preferentialDistinct>
              <singleMaxRewardAmount>最多减免Y元的Y</singleMaxRewardAmount>
              <baseAddUpType>0</baseAddUpType>
              <rewardQuantifierType>5</rewardQuantifierType>
              <baseQuantifierType>1</baseQuantifierType>
              <levelId>1</levelId>
              <bounsAmount>10.00</bounsAmount>
            </couponRuleBonusList>
            <couponShowType>1</couponShowType>
          </couponRuleInfo>
          <activityDescription>满2件打9折</activityDescription>
          <activityTypeId>4</activityTypeId>
          <bonusList>
            <couponEndTime>2020-02-10 12:44:55</couponEndTime>
            <couponPromotionLabel>满99用1</couponPromotionLabel>
            <couponType>10001</couponType>
            <couponStartTime>2020-02-10 12:23:43</couponStartTime>
            <bonusId>1232332342</bonusId>
            <bonusRulesDesc>满2件打9折</bonusRulesDesc>
            <couponValue>10.00</couponValue>
          </bonusList>
        </activityList>
      </productsList>
    </queryPromotiontags>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryPromotiontags": {
        "productsList": [
          {
            "shopCode": "123456",
            "productNumber": "1232332342",
            "activityList": [
              {
                "activitySecretKey": "1232332342",
                "activityId": "1232332342",
                "activityRuleList": [
                  {
                    "singleMaxRewardAmount": "1",
                    "baseAddUpType": "0",
                    "rewardQuantifierType": "\"枚举:1:金额: 2:人数 3:件数 4:概率 5:折扣 6、外围系统指定 8、定价 例如满100减10类型是金额,满100打9折是折扣,满3件减1件是件数\"",
                    "scopeType": "1:一级类目 2:二级类目 3:三级类目 4:四级类目 5 : 品牌",
                    "baseQuantifierType": "枚举:1:金额: 2:人数 3:件数 4:概率 5 : 类目类型 例如满100减10基数值量词是类型是金额, 满3件打9折,最大优惠200的基数类型是折扣",
                    "rewardAmount": "例如满100减10奖励数值即10  满3件减1件 优惠值是1件,即1注意:满3件打9折奖励值是1折 如果是券则是9 如果是活动,则是0.1",
                    "floor": "1/2/3/4/5…… 含义:层级指的是,满100减10,满200减25, 两个层级",
                    "baseAmount": "含义:例如满100减10基数值是100, 满3件打9折,最大优惠200的基数值是3"
                  }
                ],
                "couponRuleInfo": {
                  "couponRuleBonusList": [
                    {
                      "bounsLimit": "满100元打8.8折的100",
                      "preferentialDistinct": "满10用5",
                      "singleMaxRewardAmount": "最多减免Y元的Y",
                      "baseAddUpType": "0",
                      "rewardQuantifierType": "5",
                      "baseQuantifierType": "1",
                      "levelId": "1",
                      "bounsAmount": "10.00"
                    }
                  ],
                  "couponShowType": "1"
                },
                "activityDescription": "满2件打9折",
                "activityTypeId": "4",
                "bonusList": [
                  {
                    "couponEndTime": "2020-02-10 12:44:55",
                    "couponPromotionLabel": "满99用1",
                    "couponType": "10001",
                    "couponStartTime": "2020-02-10 12:23:43",
                    "bonusId": "1232332342",
                    "bonusRulesDesc": "满2件打9折",
                    "couponValue": "10.00"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.querypromotiontags.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.querypromotiontags.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.online.querypromotiontags.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
PANGU-SEARCHPROMOTIONTAGS-001 请求参数不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-002 会员编码不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-003 终端编码不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-004 终端编码错误 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-005 城市名称不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-006 商品列表不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-007 商品个数不能大于5 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-008 商品编码不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-009 商品价格不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-010 业务标识不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-011 营销活动类型不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-012 平台账号不能为空 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-013 平台配置信息不存在 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-014 所有商品都不在选品池 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-015 商品不在选品池,商品编码:xxx,xxx 请检查查询参数
PANGU-SEARCHPROMOTIONTAGS-016 城市编码转换失败 请联系苏宁技术人员
PANGU-SEARCHPROMOTIONTAGS-017 内部促销接口响应结果为空 请联系苏宁技术人员
PANGU-SEARCHPROMOTIONTAGS-018 内部接口发生xx异常 请联系苏宁技术人员
PANGU-SEARCHPROMOTIONTAGS-090 内部接口发生异常 请联系苏宁技术人员
PANGU-SEARCHPROMOTIONTAGS-099 接口异常 请联系苏宁技术人员
公共异常码
API工具
FAQ