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

电商能力输出业务

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

查询账户下有哪些优惠券

公共参数
请求参数
名称 类型 是否必须 示例值 描述
chanIdStringY01操作渠道 （01:PC，02:APP，03:WAP）
memberIdStringY9511588会员编号（即外平台唯一会员编号）
timeRangeStringY1券的时间范围（1到30之间的整数）
timeTypeStringY1时间类型排序（1:过期时间升序 2：过期时间倒序 3：生效时间升序 4：生效时间降序 5：发券时间倒序）
couponStatusStringY2券状态（2、已绑定 4、已使用 5、已过期 -1、全部）
couponTypeStringY10001券类型（10001：云券 10002：限品类云券 10004：易券 10005：限品类易券 -1：全部 10009 无敌券）
pageStringY1页码
perpageNumberStringY12每页数量
响应参数
名称 类型 示例值 描述
couponNumberString1券数量
pageNumberString1总页数
couponMaxValueString150领券最大值
couponInfoListString
couponNoString70040775894671券号
couponRuleIdString1201812170002052346券规则编码
couponTypeString10001券类型
couponRuleNameString贵酒满300打85折易券券规则编码名称
couponValueString50.00券面值
remainValueString10.00券余额
startTimeString2018-12-15 00:00:00券开始时间
endTimeString2019-02-01 00:00:00券结束时间
couponInitiatorString3券发起方
storeIdString0070164144店铺编码
couponStatusString2券状态
couponShowTypeString1券标识类型
couponDiscountString8.5券折扣
businessSignString0业务标识
activityTypeString2003活动类型
sourceChannelString01来源终端
sourceActivityIdString201807260002948992来源活动ID
sourceActivityNameStringSUPER会员海外购运费券（2017）来源活动名称
grantTimeString2018-12-25 11:19:09券发放时间
couponUseCityCodeString010用券城市编码
couponUseCityNameString北京市用券城市名称
couponRulesTerminalListString
couponRulesTerminalString01券规则终端（ 01：PC、 02：APP、 03：WAP、1001、1002、1003、1004、1005、1006）
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryAccountcouponlist>
      <couponType>10001</couponType>
      <couponStatus>2</couponStatus>
      <perpageNumber>12</perpageNumber>
      <timeType>1</timeType>
      <chanId>01</chanId>
      <page>1</page>
      <memberId>9511588</memberId>
      <timeRange>1</timeRange>
    </queryAccountcouponlist>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryAccountcouponlist": {
        "couponType": "10001",
        "couponStatus": "2",
        "perpageNumber": "12",
        "timeType": "1",
        "chanId": "01",
        "page": "1",
        "memberId": "9511588",
        "timeRange": "1"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryAccountcouponlist>
      <pageNumber>1</pageNumber>
      <couponNumber>1</couponNumber>
      <couponInfoList>
        <couponRuleName>贵酒满300打85折易券</couponRuleName>
        <couponRuleId>1201812170002052346</couponRuleId>
        <grantTime>2018-12-25 11:19:09</grantTime>
        <couponShowType>1</couponShowType>
        <sourceChannel>01</sourceChannel>
        <couponNo>70040775894671</couponNo>
        <storeId>0070164144</storeId>
        <couponValue>50.00</couponValue>
        <couponDiscount>8.5</couponDiscount>
        <sourceActivityName>SUPER会员海外购运费券（2017）</sourceActivityName>
        <couponUseCityCode>010</couponUseCityCode>
        <couponType>10001</couponType>
        <remainValue>10.00</remainValue>
        <couponInitiator>3</couponInitiator>
        <couponStatus>2</couponStatus>
        <couponUseCityName>北京市</couponUseCityName>
        <startTime>2018-12-15 00:00:00</startTime>
        <couponRulesTerminalList>
          <couponRulesTerminal>01</couponRulesTerminal>
        </couponRulesTerminalList>
        <businessSign>0</businessSign>
        <endTime>2019-02-01 00:00:00</endTime>
        <activityType>2003</activityType>
        <sourceActivityId>201807260002948992</sourceActivityId>
      </couponInfoList>
      <couponMaxValue>150</couponMaxValue>
    </queryAccountcouponlist>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryAccountcouponlist": {
        "pageNumber": "1",
        "couponNumber": "1",
        "couponInfoList": [
          {
            "couponRuleName": "贵酒满300打85折易券",
            "couponRuleId": "1201812170002052346",
            "grantTime": "2018-12-25 11:19:09",
            "couponShowType": "1",
            "sourceChannel": "01",
            "couponNo": "70040775894671",
            "storeId": "0070164144",
            "couponValue": "50.00",
            "couponDiscount": "8.5",
            "sourceActivityName": "SUPER会员海外购运费券（2017）",
            "couponUseCityCode": "010",
            "couponType": "10001",
            "remainValue": "10.00",
            "couponInitiator": "3",
            "couponStatus": "2",
            "couponUseCityName": "北京市",
            "startTime": "2018-12-15 00:00:00",
            "couponRulesTerminalList": [
              {
                "couponRulesTerminal": "01"
              }
            ],
            "businessSign": "0",
            "endTime": "2019-02-01 00:00:00",
            "activityType": "2003",
            "sourceActivityId": "201807260002948992"
          }
        ],
        "couponMaxValue": "150"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.online.queryaccountcouponlist.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.online.queryaccountcouponlist.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.online.queryaccountcouponlist.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.pangu 服务不可用 请联系苏宁技术人员
biz.online.queryaccountcouponlist.invalid-biz:100 json转换异常 请检查请求参数是否符合json格式
biz.online.queryaccountcouponlist.invalid-biz:101 未查询到平台配置信息 请确认平台账号是否正确
biz.online.queryaccountcouponlist.invalid-biz:102 超出取值范围：%s 检查请求参数是否合法
biz.online.queryaccountcouponlist.invalid-biz:103 业务异常：%s 请联系苏宁业务人员
biz.online.queryaccountcouponlist.invalid-biz:104 系统异常：%s 请联系苏宁业务人员
biz.online.queryaccountcouponlist.invalid-biz:105 内部调用失败，错误码：%s，错误描述：%s 内部接口调用失败
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ