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

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.scope.query 门店配送范围查询
￥免费

通过此接口可批量查询门店配送范围。

1、页码和每页条数必须同时填写方可生效，否则将默认返回第1页、10条内容；

2、返回结果分页展示，通过请求参数的页码可以定位到具体第几页，每页条数控制每页返回的条数；

3、平台门店编码、商户自定义门店编码都填写，则以平台门店编码为准；若都不传，则返回该供应商下面所有维护过销售范围的门店。

4、若查询的门店未设置销售范围，则该门店销售范围返回为空。

5、所有的坐标均已高德地图坐标为准，请按照高德坐标为准进行查看。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
storeCodeStringNsuning001平台门店编码
appStoreCodeStringNS123456商户自定义门店编码
响应参数
名称 类型 示例值 描述
storeCodeStringsuning001平台门店编码
appStoreCodeStringS123456商户自定义门店编码
serviceStateString01服务状态（01未开始，02正在服务，03暂停）
coverageTypeString0覆盖范围类型（0-不规则 1 圆形）
latitudeRectangleString118.895439,32.093072;118.896229,32.093347;118.897163,32.093592;不规则图形坐标集合
radiusString2000圆形半径(单位：米)
shopLongitudeString118.895439圆形中心经度
shopLatitudeString32.093072圆形中心纬度
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryScope>
      <appStoreCode>S123456</appStoreCode>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <storeCode>suning001</storeCode>
    </queryScope>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryScope": {
        "appStoreCode": "S123456",
        "pageNo": "1",
        "pageSize": "10",
        "storeCode": "suning001"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryScope>
      <shopLatitude>32.093072</shopLatitude>
      <latitudeRectangle>118.895439,32.093072;118.896229,32.093347;118.897163,32.093592;</latitudeRectangle>
      <appStoreCode>S123456</appStoreCode>
      <coverageType>0</coverageType>
      <radius>2000</radius>
      <serviceState>01</serviceState>
      <storeCode>suning001</storeCode>
      <shopLongitude>118.895439</shopLongitude>
    </queryScope>
  </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": {
      "queryScope": [
        {
          "shopLatitude": "32.093072",
          "appStoreCode": "S123456",
          "latitudeRectangle": "118.895439,32.093072;118.896229,32.093347;118.897163,32.093592;",
          "coverageType": "0",
          "radius": "2000",
          "serviceState": "01",
          "shopLongitude": "118.895439",
          "storeCode": "suning001"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.store.queryscope.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.store.queryscope.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.store.queryscope.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mims 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ