API接口目录

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.ssshopcoupon.query 身边苏宁店铺优惠券活动列表查询接口
¥免费

身边苏宁店铺优惠券活动列表查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
shopCodeStringNS03017113苏宁门店编码
appStoreCodeStringN1111111商家自定义门店编码
activityNameStringN418大促 活动名称
activityShowStatusStringN0:全部 1:进行中 2:待开始 3:已结束4:已暂停 5:已终止活动状态
响应参数
名称 类型 示例值 描述
activityCodeString123131212活动编码
activityNameString大促418活动名称
couponDescString满x元用y元优惠说明
promotionUrlString11111111111券地址
activityStartTimeString2018-01-01 00:00:00活动开始时间
activityEndTimeString2018-01-01 00:00:00活动结束时间
effectiveStartTimeString2018-01-01 00:00:00券有效开始时间
effectiveEndTimeString2018-01-01 00:00:00券有效结束时间
activityShowStatusString1:进行中 2:待开始 3:已结束4:已暂停 5:已终止 6:未生效活动状态编码
activityShowStatusNameString进行中 待开始 已结束已暂停 已终止 未生效活动状态名称
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <querySsshopcoupon>
      <shopCode>S03017113</shopCode>
      <appStoreCode>1111111</appStoreCode>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <activityName>418大促	</activityName>
      <activityShowStatus>0:全部 1:进行中 2:待开始 3:已结束4:已暂停 5:已终止</activityShowStatus>
    </querySsshopcoupon>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "querySsshopcoupon": {
        "shopCode": "S03017113",
        "appStoreCode": "1111111",
        "pageNo": "1",
        "pageSize": "10",
        "activityName": "418大促\t",
        "activityShowStatus": "0:全部 1:进行中 2:待开始 3:已结束4:已暂停 5:已终止"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <querySsshopcoupon>
      <activityCode>123131212</activityCode>
      <activityEndTime>2018-01-01 00:00:00</activityEndTime>
      <effectiveEndTime>2018-01-01 00:00:00</effectiveEndTime>
      <couponDesc>满x元用y元</couponDesc>
      <promotionUrl>11111111111</promotionUrl>
      <activityName>大促418</activityName>
      <activityShowStatusName>进行中 待开始 已结束已暂停 已终止 未生效</activityShowStatusName>
      <activityStartTime>2018-01-01 00:00:00</activityStartTime>
      <activityShowStatus>1:进行中 2:待开始 3:已结束4:已暂停 5:已终止 6:未生效</activityShowStatus>
      <effectiveStartTime>2018-01-01 00:00:00</effectiveStartTime>
    </querySsshopcoupon>
  </sn_body>
  <sn_head>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <totalSize>1</totalSize>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "pageTotal": "1",
      "pageNo": "1",
      "totalSize": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "querySsshopcoupon": [
        {
          "activityCode": "123131212",
          "activityEndTime": "2018-01-01 00:00:00",
          "effectiveEndTime": "2018-01-01 00:00:00",
          "couponDesc": "满x元用y元",
          "promotionUrl": "11111111111",
          "activityName": "大促418",
          "activityStartTime": "2018-01-01 00:00:00",
          "activityShowStatusName": "进行中 待开始 已结束已暂停 已终止 未生效",
          "effectiveStartTime": "2018-01-01 00:00:00",
          "activityShowStatus": "1:进行中 2:待开始 3:已结束4:已暂停 5:已终止 6:未生效"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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