开放服务-API列表

热词搜索：订单API 接口查询退款订单 6五四三二一 appkey

suning.store.sidesnordersbymodifytime.query 苏宁小店根据订单修改时间查订单详情API

￥免费

通过此接口根据订单修改时间批量获取订单。

1.一次请求只能查询时间跨度为一天的增量交易记录，即查询修改结束时间-查询修改开始时间<=1天，通过此接口可以查询到时间范围在当前时间往前三个月的时间内；

2.返回的数据结果是以订单修改时间降序排列的，通过从后往前翻页的方式可以避免漏单问题；

3.页码和每页条数默认返回第1页、10条内容，通过请求参数的页码可以定位到具体第几页，每页条数控制每页返回的条数；

4.此api获取不到未付或未付取消订单；

5.订单状态指当前订单总状态，10-已付款 20-已接单 30-交易成功 40-已付未接单取消 50-已退单；

6.订单的实付款=行项目销售额+配送费+餐盒费-满减优惠-优惠劵优惠；

7.若同时输入苏宁门店编码和商家门店编码以苏宁门店编码为准；

公共参数

名称	类型	是否必须	示例值	描述
appMethod	String	Y	suning.custom.category.query	方法名
appRequestTime	String	Y	2012-04-25 20:23:30	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。
format	String	N	XML	默认xml,可指定格式为xml,json
appKey	String	Y	b0c332a133c102765f39de**********	分配给应用的访问令牌
versionNo	String	Y	v1.2	API的版本，目前为v1.2版本
signInfo	String	Y	460d7ff15b073e463125b4**********	appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写)，其中appSecret为appKey对应的密钥
access_token	String	N	a1c5c62b08df3a3cbf7efd**********	采用OAuth授权方式为必填参数

请求参数

名称	类型	是否必须	示例值	描述
pageNo	String	N	1	页码
pageSize	String	N	10	每页条数
storeCode	String	N	8IT6	苏宁门店编码
appStoreCode	String	N	952D	商家门店编码
startTime	String	Y	2019-01-01 00:00:00	开始时间
endTime	String	Y	2019-01-01 01:00:00	结束时间
orderStatus	String	N	10	订单状态

响应参数

名称	类型	示例值	描述
orders	String
orderSerialNumber	String	1	订单序号
shopCode	String	952D	苏宁门店编码
orderCode	String	110000269178760065	订单号
orderStatus	String	10	订单状态
orderTime	String	2017-01-01 01:01:01	下单时间
omsCreateTime	String	2017-01-01 01:01:01	订单销售日期
voucherTotalMoney	String	2.00	满减优惠
remindshipNum	String	1	催单次数
orderRemark	String	不吃辣谢谢	买家备注
returnOrderFlag	String	1	退款标记
srvMode	String	01	预约/尽快送达标识
hopeArrivalTime	String	2017-01-01 01:01:01	预约时间
userName	String	王成	买家姓名
mobphoneNum	String	1855181111	买家手机号
address	String	江苏省南京市玄武区苏宁易购总部楼b404项目间	买家具体地址（完整地址，包含省市区）
receiverLatitude	String	118.892503	买家收货地址经度
receiverLongitude	String	32.088447	买家收货地址纬度
commdityNum	String	1	商品总件数
needInvoiceFlag	String	Y	是否需要发票
invoiceType	String	04	发票类型
invoiceHead	String	江苏柏亨环保设备有限公司	发票抬头
riderMobile	String	18626429808	骑手电话
riderName	String	王成	骑手姓名
payAmount	String	25.00	实付金额
srvfee	String	0.00	餐盒费
deliveryFlag	String	02	配送方式
distributionFee	String	5.00	配送费
orderItems	String
orderItemId	String	110000269358433722	订单行号
cmmdtyName	String	爆柠四季春	商品标题
refundFlag	String	1	退款标识位
cmmdtyCode	String	10686448992	苏宁商品编码
supplierCmCode	String	skt123233	商家商品编码
totalAmount	String	20.00	行项目销售额
cscTotalMoney	String	22.00	行云车销售价总额
saleQty	String	1	商品件数
couponItems	String
couponTypeCode	String	10009	券类型编码
couponTypeName	String	无敌券	券类型名称
couponRuleId	String	C0020034984982	券规则编码
couponRuleName	String	小店无敌券	券规则名称
couponAmount	String	10.00	优惠活动扣减金额
specTypeItems	String
specType	String	1	规格类型编码
specTypeName	String	甜度	规格类型名称
specPrice	String	0.01	价格
specContent	String	多糖，中糖，少糖	规格

请求示例

XML示例
JSON示例

复制全部代码

                                <sn_request>
  <sn_body>
    <querySidesnordersbymodifytime>
      <pageNo>1</pageNo>
      <orderStatus>10</orderStatus>
      <pageSize>10</pageSize>
      <startTime>2019-01-01 00:00:00</startTime>
      <endTime>2019-01-01 01:00:00</endTime>
      <appStoreCode>952D</appStoreCode>
      <storeCode>8IT6</storeCode>
    </querySidesnordersbymodifytime>
  </sn_body>
</sn_request>

                                {
  "sn_request": {
    "sn_body": {
      "querySidesnordersbymodifytime": {
        "pageNo": "1",
        "orderStatus": "10",
        "pageSize": "10",
        "startTime": "2019-01-01 00:00:00",
        "endTime": "2019-01-01 01:00:00",
        "appStoreCode": "952D",
        "storeCode": "8IT6"
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              <sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <querySidesnordersbymodifytime>
      <orders>
        <riderMobile>18626429808</riderMobile>
        <omsCreateTime>2017-01-01 01:01:01</omsCreateTime>
        <receiverLatitude>118.892503</receiverLatitude>
        <distributionFee>5.00</distributionFee>
        <orderRemark>不吃辣谢谢</orderRemark>
        <orderStatus>10</orderStatus>
        <returnOrderFlag>1</returnOrderFlag>
        <orderItems>
          <totalAmount>20.00</totalAmount>
          <orderItemId>110000269358433722</orderItemId>
          <cmmdtyCode>10686448992</cmmdtyCode>
          <cmmdtyName>爆柠四季春</cmmdtyName>
          <refundFlag>1</refundFlag>
          <supplierCmCode>skt123233</supplierCmCode>
          <saleQty>1</saleQty>
          <couponItems>
            <couponTypeName>无敌券</couponTypeName>
            <couponRuleName>小店无敌券</couponRuleName>
            <couponAmount>10.00</couponAmount>
            <couponRuleId>C0020034984982</couponRuleId>
            <couponTypeCode>10009</couponTypeCode>
          </couponItems>
          <specTypeItems>
            <specType>1</specType>
            <specTypeName>甜度</specTypeName>
            <specPrice>0.01</specPrice>
            <specContent>多糖，中糖，少糖</specContent>
          </specTypeItems>
          <cscTotalMoney>22.00</cscTotalMoney>
        </orderItems>
        <commdityNum>1</commdityNum>
        <orderTime>2017-01-01 01:01:01</orderTime>
        <payAmount>25.00</payAmount>
        <srvfee>0.00</srvfee>
        <invoiceType>04</invoiceType>
        <hopeArrivalTime>2017-01-01 01:01:01</hopeArrivalTime>
        <deliveryFlag>02</deliveryFlag>
        <shopCode>952D</shopCode>
        <srvMode>01</srvMode>
        <address>江苏省南京市玄武区苏宁易购总部楼b404项目间</address>
        <needInvoiceFlag>Y</needInvoiceFlag>
        <mobphoneNum>1855181111</mobphoneNum>
        <remindshipNum>1</remindshipNum>
        <userName>王成</userName>
        <riderName>王成</riderName>
        <voucherTotalMoney>2.00</voucherTotalMoney>
        <invoiceHead>江苏柏亨环保设备有限公司</invoiceHead>
        <orderCode>110000269178760065</orderCode>
        <receiverLongitude>32.088447</receiverLongitude>
        <orderSerialNumber>1</orderSerialNumber>
      </orders>
    </querySidesnordersbymodifytime>
  </sn_body>
</sn_responseContent>

                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "querySidesnordersbymodifytime": [
        {
          "orders": [
            {
              "riderMobile": "18626429808",
              "omsCreateTime": "2017-01-01 01:01:01",
              "receiverLatitude": "118.892503",
              "distributionFee": "5.00",
              "orderRemark": "不吃辣谢谢",
              "orderStatus": "10",
              "returnOrderFlag": "1",
              "orderItems": [
                {
                  "totalAmount": "20.00",
                  "orderItemId": "110000269358433722",
                  "cmmdtyCode": "10686448992",
                  "cmmdtyName": "爆柠四季春",
                  "refundFlag": "1",
                  "supplierCmCode": "skt123233",
                  "saleQty": "1",
                  "couponItems": [
                    {
                      "couponTypeName": "无敌券",
                      "couponRuleName": "小店无敌券",
                      "couponAmount": "10.00",
                      "couponRuleId": "C0020034984982",
                      "couponTypeCode": "10009"
                    }
                  ],
                  "specTypeItems": [
                    {
                      "specType": "1",
                      "specTypeName": "甜度",
                      "specPrice": "0.01",
                      "specContent": "多糖，中糖，少糖"
                    }
                  ],
                  "cscTotalMoney": "22.00"
                }
              ],
              "commdityNum": "1",
              "orderTime": "2017-01-01 01:01:01",
              "payAmount": "25.00",
              "srvfee": "0.00",
              "invoiceType": "04",
              "hopeArrivalTime": "2017-01-01 01:01:01",
              "deliveryFlag": "02",
              "shopCode": "952D",
              "srvMode": "01",
              "address": "江苏省南京市玄武区苏宁易购总部楼b404项目间",
              "needInvoiceFlag": "Y",
              "mobphoneNum": "1855181111",
              "remindshipNum": "1",
              "userName": "王成",
              "riderName": "王成",
              "voucherTotalMoney": "2.00",
              "invoiceHead": "江苏柏亨环保设备有限公司",
              "orderCode": "110000269178760065",
              "receiverLongitude": "32.088447",
              "orderSerialNumber": "1"
            }
          ]
        }
      ]
    }
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}

业务异常码

异常码	错误描述	解决方案
biz.store.querysidesnordersbymodifytime.format-error:*	参数格式错误	请检查此参数的值,*号表示参数字段名
biz.store.querysidesnordersbymodifytime.missing-parameter:*	参数必填	请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result	查询没结果	请检查查询参数
isp.sys.service.unavailable.moms	服务不可用	请联系苏宁技术人员
biz.store.querysidesnordersbymodifytime.invalid-biz:100	商家编码不能为空	公共参数有误，请稍候再试
biz.store.querysidesnordersbymodifytime.invalid-biz:101	商家编码格式不正确	公共参数有误，请稍候再试
biz.store.querysidesnordersbymodifytime.invalid-biz:102	开始时间不能为空	请输入时间
biz.store.querysidesnordersbymodifytime.invalid-biz:103	结束时间不能为空	请输入时间
biz.store.querysidesnordersbymodifytime.invalid-biz:104	交易开始时间格式错误	请输入正确时间格式：yyyy-MM-dd HH:mm:ss
biz.store.querysidesnordersbymodifytime.invalid-biz:105	交易结束时间格式错误	请输入正确时间格式：yyyy-MM-dd HH:mm:ss
biz.store.querysidesnordersbymodifytime.invalid-biz:106	开始时间不能晚于结束时间	请输入正确时间范围
biz.store.querysidesnordersbymodifytime.invalid-biz:107	开始时间和结束时间间隔超过1天	请输入正确时间范围
biz.store.querysidesnordersbymodifytime.invalid-biz:108	订单状态参数不合法	请输入正确参数(10-已付款 20-已接单 30-交易成功 40-已付未接单取消 50-已退单)
biz.store.querysidesnordersbymodifytime.invalid-biz:109	每页数量超出正常范围	请输入正确页码1-99999
biz.store.querysidesnordersbymodifytime.invalid-biz:110	页码超出正常范围	请输入正每页数量1-100
biz.store.querysidesnordersbymodifytime.invalid-biz:111	查不到符合的数据,订单头数据为空	请输入正确订单号
biz.store.querysidesnordersbymodifytime.invalid-biz:112	查不到符合的数据，订单行信息为空	请输入正确订单号
biz.store.querysidesnordersbymodifytime.invalid-biz:113	查不到符合的数据，组合信息为空	请输入正确订单号
biz.store.querysidesnordersbymodifytime.invalid-biz:114	查询时间范围超出时间允许范围	查询到时间范围在当前时间往前三个月的时间内
biz.store.querysidesnordersbymodifytime.invalid-biz:115	商家门店编码不存在	传入正确商家门店编码

公共异常码

异常码	错误描述	解决方案
sys.oauth.check.access_token:inexistence	访问令牌过期或未进行授权	请重新授权或使用刷新令牌刷新新的访问令牌
sys.oauth.check.access_token:overdue	访问令牌已过期	请使用刷新令牌刷新
sys.check.api-permission:inexistence	Api方法不存在	请参考帮助中心
sys.check.api-permission:overdue	Api方法已过期	请参考帮助中心
sys.check.api-permission:authority	无权操作此api	确认是否有访问该方法权限
sys.auth.vendor-request:errory	无权操作此供应商	请确认供应商编码是否正确
sys.controller.api-request:limit	Api请求受控	超过请求次数
sys.check.app-time:error	请求参数错误api请求时间误差大	参考帮助中心
sys.check.request-params:error	请求报文结构错误	参考帮助中心、日期格式等
sys.check.starttime-format:error	请求开始时间错误	参考帮助中心、日期格式等
biz.handler.data-get:success	业务数据查询成功	无
biz.handler.data-get:fail	业务数据查询失败	检查请求条件
biz.handler.data-get:no-result	业务数据结果为空	无
sys.check.pageno-format:error	pageNo格式错误，只允许1到99999之间的整数	检查pageNo输入是否有误
sys.check.pagesize-format:error	pageSize格式错误，只允许1到50之间的整数(订单相关是1到100)	检查pageSize输入是否有误
sys.check.page-param:error	pageNo或者pageSize不在要求范围内，pageNo只允许1到99999之间的整数，pageSize只允许1到50之间的整数(订单相关是1到100)	检查pageNo和pageSize输入是否有误
sys.check.miss-time:starttime	不存在开始时间(节点)	检查输入
sys.check.miss-time:endtime	不存在结束时间(节点)	检查输入
sys.check.starttime-value:null	开始时间为空(值)	检查输入
sys.check.endtime-value:null	结束时间为空(值)	检查输入
sys.check.starttime-format:error	校验开始时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.endtime-format:error	校验结束时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.query-time:error	开始时间是否小于结束时间	检查开始和结束时间大小
sys.check.query-time:outofrange	时间查询是否超出指定范围	检查时间范围
sys.check.app-sign:null	签名信息为空	检查签名信息
sys.check.app-sign:error	签名信息错误	检查签名信息
sys.check.missing-parameter:apiversion	API版本号未指定	检查API版本号
sys.check.missing-parameter:appRequestTime	请求时间丢失	检查请求时间
sys.check.missing-nestElement:sn_body	缺少sn_body节点	检查sn_body是否存在
sys.check.user-permission:inexistence	用户key不存在	检查用户key是否存在
biz.handler.batch-handler:no-support	非查询类API不支持批量操作	检查API类型
biz.handler.request-message:error	查询类API输入多个业务节点	检查业务节点
sys.check.header-param:null	header参数为空	请检查header参数
sys.controller.api-access:limit	访问限制	无
sys.controller.api-frequency:limit	访问频率限制	无
sys.error.network:failure	网络异常	无
sys.error.network-status:?	响应失败 ?为状态码	无
sys.check.app-ip:illegal	请求的客户端IP地址非法，与设置的应用IP白名单信息不符	应用白名单设置增加客户端ip
sys.controller.frequency-limit:004	内部系统超频拦截	无
sys.error.http.network-status:?	内部http请求响应异常码	根据异常码判断响应异常原因
sys.check.snunionid.length.is.not:48	混淆会员编码长度不是48位	使用转换器转换混淆会员编码规定要求混淆会员编码48位

API工具

API TOOLS 在线测试工具异常码查询工具 SDK调用示例 SDK下载

FAQ

苏宁小店业务