API接口目录

电商能力输出业务

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

四级页可用券查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
memberNoStringY123456789会员编号 (即外平台唯一会员编号)
chanIdStringY01操作渠道(01:PC,02:APP,03:WAP)
cityStringY北京城市名称 (即苏宁标准城市名)
cmmdtyCodeStringY123456789987654321商品编码 (苏宁标准18位商品编码)
businessSignStringY1商品业务标识 (0:普通商品;1:海外购;) 默认传:【0】普通商品;
marketingActivityTypeStringY0营销活动类型(0:普通商品;4-1:大聚惠;4-9:限时促销;4-12:掌上抢;14:促销价;15:大促价;19:电商输出专享价)
priceStringY123.00商品价格
saleNumStringY1商品销售数量 (四级页选择的欲购买商品数量)
响应参数
名称 类型 示例值 描述
couponResultOuterListString
couponNumberString123456789券号
couponTypeString金额券券类型 活动类型为免费领券时必有值; 10001 云券 10002 限品类云券 10004 易券 10005 限品类易券 10009 无敌券
couponShowTypeString1券标识类型 (1:金额券;2:打折券;在目前的苏宁业务中,打折卷有明显标示,但是该类型劵比重较少;金额劵占比重较大,但是未做明显标示)
couponDiscountString8.8券折扣 (仅打折券有值,打折券折扣,如8.8折)
couponRuleNameString满减券券使用规则名称
couponRuleIdString1券使用规则ID
amountString10劵面值
bonusRulesDescString满99用15奖励规则信息
couponDescString限自营手机品类部分商品使用券描述
startTimeString2018-07-03 00:00:00使用开始时间,格式: yyyy-mm-dd hh24:mi:ss,
endTimeString2018-08-03 00:00:00使用结束时间,格式: yyyy-mm-dd hh24:mi:ss
terminalTypeString01_1001终端渠道(若多个终端,则下划线拼接如:01_1001; 01:PC、 02:APP、 03:WAP、1001、1002、1003、1004、1005、1006)
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryPagefourcoupon>
      <memberNo>123456789</memberNo>
      <marketingActivityType>0</marketingActivityType>
      <city>北京</city>
      <price>123.00</price>
      <cmmdtyCode>123456789987654321</cmmdtyCode>
      <chanId>01</chanId>
      <businessSign>1</businessSign>
      <saleNum>1</saleNum>
    </queryPagefourcoupon>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryPagefourcoupon": {
        "memberNo": "123456789",
        "marketingActivityType": "0",
        "city": "北京",
        "price": "123.00",
        "cmmdtyCode": "123456789987654321",
        "chanId": "01",
        "businessSign": "1",
        "saleNum": "1"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryPagefourcoupon>
      <couponResultOuterList>
        <couponDiscount>8.8</couponDiscount>
        <couponRuleName>满减券</couponRuleName>
        <amount>10</amount>
        <couponRuleId>1</couponRuleId>
        <couponNumber>123456789</couponNumber>
        <couponShowType>1</couponShowType>
        <couponType>金额券</couponType>
        <couponDesc>限自营手机品类部分商品使用</couponDesc>
        <startTime>2018-07-03 00:00:00</startTime>
        <endTime>2018-08-03 00:00:00</endTime>
        <bonusRulesDesc>满99用15</bonusRulesDesc>
        <terminalType>01_1001</terminalType>
      </couponResultOuterList>
    </queryPagefourcoupon>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryPagefourcoupon": {
        "couponResultOuterList": [
          {
            "couponDiscount": "8.8",
            "couponRuleName": "满减券",
            "amount": "10",
            "couponRuleId": "1",
            "couponNumber": "123456789",
            "couponShowType": "1",
            "couponType": "金额券",
            "couponDesc": "限自营手机品类部分商品使用",
            "startTime": "2018-07-03 00:00:00",
            "endTime": "2018-08-03 00:00:00",
            "bonusRulesDesc": "满99用15",
            "terminalType": "01_1001"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.online.querypagefourcoupon.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.querypagefourcoupon.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.online.querypagefourcoupon.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.online.querypagefourcoupon.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.querypagefourcoupon.invalid-biz:100 json转换异常 请检查查询参数
biz.online.querypagefourcoupon.invalid-biz:101 会员编号转换异常,会员编号:XX 请检查查询参数
biz.online.querypagefourcoupon.invalid-biz:102 城市名称解析异常,城市名称:XX 请检查查询参数
biz.online.querypagefourcoupon.invalid-biz:103 未查询到四级页可用券 请检查查询参数
biz.online.querypagefourcoupon.invalid-biz:104 系统异常:XX 请联系苏宁技术人员
biz.online.querypagefourcoupon.invalid-biz:105 参数校验不通过:XX 请检查查询参数
biz.online.querypagefourcoupon.invalid-biz:106 系统繁忙:XX 请联系苏宁技术人员
biz.online.querypagefourcoupon.invalid-biz:107 商品不在选品范围内,商品编码:XX 请检查查询参数
biz.online.querypagefourcoupon.invalid-biz:108 内部调用失败
biz.online.querypagefourcoupon.invalid-biz:109 未查询到平台配置信息
公共异常码
API工具
FAQ