API接口目录

苏宁小店业务

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

身边苏宁限时打折活动列表查询接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
storeCodeStringNS03017113门店编码
activityStatusStringN空:全部 s01:处理中 s02:待开始 s03:进行中 s04:已终止 s05:已结束 s09:即将结束活动状态
activityNameStringN418大促活动活动名称
appStoreCodeStringN1111111111商家自定义门店编码
响应参数
名称 类型 示例值 描述
activityCodeString15062915240410000001活动编码
activityNameString418大促活动活动名称
createChannelString1:PC 3:移动端或API ,4:BD 5:商家ERP创建创建渠道
productNumString20活动商品数量
startTimeString0000-00-00 00:00:00活动开始时间
endTimeString活动结束时间0000-00-00 00:00:00
activityStatusString01:处理中 020:待开始 021:进行中 03:已终止 022:已结束 0200:即将结束 0210:即将结束活动状态
activityStatusNameString01:处理中 020:待开始 021:进行中 03:已终止 022:已结束 0200:即将结束 0210:即将结束活动状态名称
buttonListString
buttonNameString1=复制 2=终止 3=编辑按钮名称
buttonCodeString1=复制 2=终止 3=编辑操作码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <querySsprice>
      <appStoreCode>1111111111</appStoreCode>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <activityStatus>空:全部 s01:处理中 s02:待开始 s03:进行中 s04:已终止 s05:已结束 s09:即将结束</activityStatus>
      <activityName>418大促活动</activityName>
      <storeCode>S03017113</storeCode>
    </querySsprice>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "querySsprice": {
        "appStoreCode": "1111111111",
        "pageNo": "1",
        "pageSize": "10",
        "activityStatus": "空:全部 s01:处理中 s02:待开始 s03:进行中 s04:已终止 s05:已结束 s09:即将结束",
        "activityName": "418大促活动",
        "storeCode": "S03017113"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <querySsprice>
      <activityCode>15062915240410000001</activityCode>
      <startTime>0000-00-00 00:00:00</startTime>
      <productNum>20</productNum>
      <activityStatus>01:处理中 020:待开始 021:进行中 03:已终止 022:已结束 0200:即将结束 0210:即将结束</activityStatus>
      <endTime>0000-00-00 00:00:00</endTime>
      <activityStatusName>01:处理中 020:待开始 021:进行中 03:已终止 022:已结束 0200:即将结束 0210:即将结束</activityStatusName>
      <activityName>418大促活</activityName>
      <buttonList>
        <buttonCode>1=复制 2=终止 3=编辑</buttonCode>
        <buttonName>1=复制 2=终止 3=编辑</buttonName>
      </buttonList>
      <createChannel>1:PC 3:移动端或API ,4:BD 5:商家ERP创建</createChannel>
    </querySsprice>
  </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": {
      "querySsprice": [
        {
          "startTime": "0000-00-00 00:00:00",
          "activityCode": "15062915240410000001",
          "productNum": "20",
          "activityStatus": "01:处理中 020:待开始 021:进行中 03:已终止 022:已结束 0200:即将结束 0210:即将结束",
          "endTime": "0000-00-00 00:00:00",
          "activityName": "418大促活",
          "activityStatusName": "01:处理中 020:待开始 021:进行中 03:已终止 022:已结束 0200:即将结束 0210:即将结束",
          "buttonList": [
            {
              "buttonCode": "1\u003d复制 2\u003d终止 3\u003d编辑",
              "buttonName": "1\u003d复制 2\u003d终止 3\u003d编辑"
            }
          ],
          "createChannel": "1:PC 3:移动端或API ,4:BD 5:商家ERP创建"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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