API接口目录

苏宁小店业务

门店API
商品API
店铺分类API
配送范围API
促销API
订单API
取消退款API
异常码自查工具
suning.store.sidesnordersbymodifytime.query 苏宁小店根据订单修改时间查订单详情API
¥免费

通过此接口根据订单修改时间批量获取订单。
1.一次请求只能查询时间跨度为一天的增量交易记录,即查询修改结束时间-查询修改开始时间<=1天,通过此接口可以查询到时间范围在当前时间往前三个月的时间内;
2.返回的数据结果是以订单修改时间降序排列的,通过从后往前翻页的方式可以避免漏单问题;
3.页码和每页条数默认返回第1页、10条内容,通过请求参数的页码可以定位到具体第几页,每页条数控制每页返回的条数;
4.此api获取不到未付或未付取消订单;
5.订单状态指当前订单总状态,10-已付款 20-已接单 30-交易成功 40-已付未接单取消  50-已退单;
6.订单的实付款=行项目销售额+配送费+餐盒费-满减优惠-优惠劵优惠;
7.若同时输入苏宁门店编码和商家门店编码以苏宁门店编码为准;

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
storeCodeStringN8IT6苏宁门店编码
appStoreCodeStringN952D商家门店编码
startTimeStringY2019-01-01 00:00:00开始时间
endTimeStringY2019-01-01 01:00:00结束时间
orderStatusStringN10订单状态
响应参数
名称 类型 示例值 描述
ordersString
orderSerialNumberString1订单序号
shopCodeString952D苏宁门店编码
orderCodeString110000269178760065订单号
orderStatusString10订单状态
orderTimeString2017-01-01 01:01:01下单时间
omsCreateTimeString2017-01-01 01:01:01订单销售日期
voucherTotalMoneyString2.00满减优惠
remindshipNumString1催单次数
orderRemarkString不吃辣谢谢买家备注
returnOrderFlagString1退款标记
srvModeString01预约/尽快送达标识
hopeArrivalTimeString2017-01-01 01:01:01预约时间
userNameString王成买家姓名
mobphoneNumString1855181111买家手机号
addressString江苏省南京市玄武区苏宁易购总部楼b404项目间买家具体地址(完整地址,包含省市区)
receiverLatitudeString118.892503买家收货地址经度
receiverLongitudeString32.088447买家收货地址纬度
commdityNumString1商品总件数
needInvoiceFlagStringY是否需要发票
invoiceTypeString04发票类型
invoiceHeadString江苏柏亨环保设备有限公司发票抬头
riderMobileString18626429808骑手电话
riderNameString王成骑手姓名
payAmountString25.00实付金额
srvfeeString0.00餐盒费
deliveryFlagString02配送方式
distributionFeeString5.00配送费
orderItemsString
orderItemIdString110000269358433722订单行号
cmmdtyNameString爆柠四季春商品标题
refundFlagString1退款标识位
cmmdtyCodeString10686448992苏宁商品编码
supplierCmCodeStringskt123233商家商品编码
totalAmountString20.00行项目销售额
cscTotalMoneyString22.00行云车销售价总额
saleQtyString1商品件数
couponItemsString
couponTypeCodeString10009券类型编码
couponTypeNameString无敌券券类型名称
couponRuleIdStringC0020034984982券规则编码
couponRuleNameString小店无敌券券规则名称
couponAmountString10.00优惠活动扣减金额
specTypeItemsString
specTypeString1规格类型编码
specTypeNameString甜度规格类型名称
specPriceString0.01价格
specContentString多糖,中糖,少糖规格
请求示例
  • 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 商家门店编码不存在 传入正确商家门店编码
公共异常码
API工具
FAQ