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

O2O业务

O2O订单API
O2O商品API
O2O库存API
招商API
异常码自查工具
suning.oto.order.get 单笔订单查询
￥免费

1.外部商户通过此接口完成单笔订单信息的查询
2、订单号可通过接口根据订单时间批量获取O2O订单的订单号；
3、订单头状态指订单状态，10表示买家已付款、30表示交易完成、35表示部分交易成功，40表示交易关闭四种状态； 

公共参数
请求参数
名称 类型 是否必须 示例值 描述
b2cOrderIdStringY1606011663538B2C订单号
响应参数
名称 类型 示例值 描述
addressString江苏省南京市玄武区苏宁大道一号收货地址
b2cOrderIdString1606011663538B2C订单号
customerNameString张三用户姓名
mobPhoneNumString13813331111顾客手机号码
orderDetailString
cmmdtyCodeString101002405商品编码
cmmdtyNameStringsony彩电商品名称
couponTotalMoneyString100.00优惠券总金额
distChannelString50分销渠道
hopeArrivalTimeString2016-10-27 11:30:16期望送达时间（yyyy-MM-dd HH:mm:ss）
isReserveOrderString1预定订单标识（1：预定订单，0：非预定订单）
payAmountString10.00000应付金额
payStatusString11：已支付，0：取消
priceString12000.00销售单价
saleQtyString2销售数量
statusValueString10订单行状态（0：订单取消，10：买家已付款，30：交易成功，40：退货成功）
storeCodeString910B门店代码
supplierCommodityCodeString101002405111商家商品编码
totalAmountString2400.00行项目销售额
transportFeeString5.00000运费总额
orderItemIdString00062466530501oms行号
billTypeString1订单类型(1:销售订单，-1:退货订单)
detailOrderTimeString2016-11-02 14:57:41订单行下单时间
orderDetailPayInfoString
payCodeString6901支付方式编码
bankTypeCodeString8012银行种类编码
payAmountString10.00000支付金额
payTimeString2017-04-26 09:29:16支付时间
orderRemarkString备注备注
orderStatusString10订单头状态（10：买家已付款，30：交易完成，35：部分交易成功，40：交易关闭）
orderTimeString2016-10-12 18:12:00订单提交时间
xdAddressString江苏省南京市玄武区苏宁大道1号小店地址
xdPhoneString13912932886小店电话
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <getOrder>
      <b2cOrderId>1606011663538</b2cOrderId>
    </getOrder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "getOrder": {
        "b2cOrderId": "1606011663538"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <getOrder>
      <xdAddress>江苏省南京市玄武区苏宁大道1号</xdAddress>
      <b2cOrderId>1606011663538</b2cOrderId>
      <address>江苏省南京市玄武区苏宁大道一号</address>
      <orderTime>2016-10-12 18:12:00</orderTime>
      <orderRemark>备注</orderRemark>
      <orderStatus>10</orderStatus>
      <xdPhone>13912932886</xdPhone>
      <orderDetail>
        <distChannel>50</distChannel>
        <detailOrderTime>2016-11-02 14:57:41</detailOrderTime>
        <transportFee>5.00000</transportFee>
        <statusValue>10</statusValue>
        <orderItemId>00062466530501</orderItemId>
        <cmmdtyCode>101002405</cmmdtyCode>
        <billType>1</billType>
        <cmmdtyName>sony彩电</cmmdtyName>
        <couponTotalMoney>100.00</couponTotalMoney>
        <supplierCommodityCode>101002405111</supplierCommodityCode>
        <totalAmount>2400.00</totalAmount>
        <payAmount>10.00000</payAmount>
        <orderDetailPayInfo>
          <payAmount>10.00000</payAmount>
          <payTime>2017-04-26 09:29:16</payTime>
          <bankTypeCode>8012</bankTypeCode>
          <payCode>6901</payCode>
        </orderDetailPayInfo>
        <price>12000.00</price>
        <hopeArrivalTime>2016-10-27 11:30:16</hopeArrivalTime>
        <isReserveOrder>1</isReserveOrder>
        <saleQty>2</saleQty>
        <payStatus>1</payStatus>
        <storeCode>910B</storeCode>
      </orderDetail>
      <customerName>张三</customerName>
      <mobPhoneNum>13813331111</mobPhoneNum>
    </getOrder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "getOrder": {
        "xdAddress": "江苏省南京市玄武区苏宁大道1号",
        "b2cOrderId": "1606011663538",
        "address": "江苏省南京市玄武区苏宁大道一号",
        "orderTime": "2016-10-12 18:12:00",
        "orderRemark": "备注",
        "orderStatus": "10",
        "xdPhone": "13912932886",
        "orderDetail": [
          {
            "distChannel": "50",
            "detailOrderTime": "2016-11-02 14:57:41",
            "transportFee": "5.00000",
            "statusValue": "10",
            "orderItemId": "00062466530501",
            "cmmdtyCode": "101002405",
            "billType": "1",
            "cmmdtyName": "sony彩电",
            "couponTotalMoney": "100.00",
            "supplierCommodityCode": "101002405111",
            "totalAmount": "2400.00",
            "payAmount": "10.00000",
            "orderDetailPayInfo": [
              {
                "payAmount": "10.00000",
                "payTime": "2017-04-26 09:29:16",
                "bankTypeCode": "8012",
                "payCode": "6901"
              }
            ],
            "price": "12000.00",
            "hopeArrivalTime": "2016-10-27 11:30:16",
            "isReserveOrder": "1",
            "saleQty": "2",
            "payStatus": "1",
            "storeCode": "910B"
          }
        ],
        "customerName": "张三",
        "mobPhoneNum": "13813331111"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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