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

零售云-分销商

销售报表API
零售商户API
异常码自查工具
suning.retail.xdsales.query 获取苏宁小店线下销售数据
￥免费

概述：恒大地产作为房东角色提供场地给苏宁小店开店，房租以小店线下销售扣点形式收取。故需要小店提供销售明细恒大地方查看。

1、提供订单号;销售数量;付款金额;付款时间;门店名称

2、城市名称;门店名称;销售数量;付款金额;统计日期

3、不限制只有恒大方使用，恒大方作为公司的新角色，会成为新的合作方式，可能会有新的地产方入驻查看小店数据。

恒大作为外部（现在仅是恒大，但是后面可能会增加其他外部角色）角色需要通过开放平台查看小店数据 。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
statisDateStringY20180115统计日期
storeCodeStringY912X小店编码
响应参数
名称 类型 示例值 描述
pageNoString1当前页码
totalPageCountString2总页码
totalCountString10总记录数
returnMessageString000000成功000000 失败000001
resultObjectString
salemountIdString1id
cityNameString南京城市名称
storeNameString紫金东郡苏宁小店门店名称
saleCntString100销售数量
payAmountString12.22付款金额
statisDateString20180112统计日期
etlTimeString2018-12-22 12:22:22数据处理时间
cityCodeString010城市编码
storeCodeString912X小店编码
orderCntString791订单数量
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryXdsales>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <statisDate>20180115</statisDate>
      <storeCode>912X</storeCode>
    </queryXdsales>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryXdsales": {
        "pageNo": "1",
        "pageSize": "10",
        "statisDate": "20180115",
        "storeCode": "912X"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryXdsales>
      <resultObject>
        <payAmount>12.22</payAmount>
        <etlTime>2018-12-22 12:22:22</etlTime>
        <storeName>紫金东郡苏宁小店</storeName>
        <orderCnt>791</orderCnt>
        <salemountId>1</salemountId>
        <cityName>南京</cityName>
        <cityCode>010</cityCode>
        <statisDate>20180112</statisDate>
        <saleCnt>100</saleCnt>
        <storeCode>912X</storeCode>
      </resultObject>
      <totalPageCount>2</totalPageCount>
      <totalCount>10</totalCount>
      <pageNo>1</pageNo>
      <returnMessage>000000</returnMessage>
    </queryXdsales>
  </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": {
      "queryXdsales": [
        {
          "totalPageCount": "2",
          "resultObject": [
            {
              "payAmount": "12.22",
              "etlTime": "2018-12-22 12:22:22",
              "storeName": "紫金东郡苏宁小店",
              "orderCnt": "791",
              "cityName": "南京",
              "salemountId": "1",
              "cityCode": "010",
              "saleCnt": "100",
              "statisDate": "20180112",
              "storeCode": "912X"
            }
          ],
          "totalCount": "10",
          "pageNo": "1",
          "returnMessage": "000000"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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