API接口目录

O2O业务

O2O订单API
O2O商品API
联营厂送API
O2O库存API
招商API
异常码自查工具
suning.o2o.order.get 单笔订单查询
¥免费

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

公共参数
请求参数
名称 类型 是否必须 示例值 描述
b2cOrderIdStringY1606011663538B2C订单号
响应参数
名称 类型 示例值 描述
b2cOrderIdString1606011663538B2C订单号
orderTimeString2016-10-12 18:12:00订单提交时间
orderStatusString10订单头状态(10:买家已付款,30:交易完成,35:部分交易成功,40:交易关闭)
xdAddressString江苏省南京市玄武区苏宁大道1号小店地址
xdPhoneString13912932886小店电话
orderRemarkString备注备注
orderDetailString
storeCodeString910B门店代码
cmmdtyCodeString101002405商品编码
cmmdtyNameStringsony彩电商品名称
supplierCommodityCodeString101002405111商家商品编码
saleQtyString2销售数量
priceString12000.00销售单价
payStatusString11:已支付,0:取消
totalAmountString2400.00行项目销售额
couponTotalMoneyString100.00优惠券总金额
statusValueString10订单行状态(0:订单取消,10:买家已付款,30:交易成功,40:退货成功)
transportFeeString5.00000运费总额
payAmountString10.00000应付金额
customerNameString张三用户姓名
addressString江苏省南京市玄武区苏宁大道一号收货地址
mobPhoneNumString13813331111顾客手机号码
请求示例
  • 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>
      <customerName>张三</customerName>
      <mobPhoneNum>13813331111</mobPhoneNum>
      <orderDetail>
        <payAmount>10.00000</payAmount>
        <cmmdtyCode>101002405</cmmdtyCode>
        <cmmdtyName>sony彩电</cmmdtyName>
        <couponTotalMoney>100.00</couponTotalMoney>
        <price>12000.00</price>
        <payStatus>1</payStatus>
        <saleQty>2</saleQty>
        <totalAmount>2400.00</totalAmount>
        <statusValue>10</statusValue>
        <supplierCommodityCode>101002405111</supplierCommodityCode>
        <storeCode>910B</storeCode>
        <transportFee>5.00000</transportFee>
      </orderDetail>
      <address>江苏省南京市玄武区苏宁大道一号</address>
      <b2cOrderId>1606011663538</b2cOrderId>
      <orderTime>2016-10-12 18:12:00</orderTime>
      <orderRemark>备注</orderRemark>
      <orderStatus>10</orderStatus>
      <xdPhone>13912932886</xdPhone>
      <xdAddress>江苏省南京市玄武区苏宁大道1号</xdAddress>
    </getOrder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "getOrder": {
        "customerName": "张三",
        "mobPhoneNum": "13813331111",
        "orderDetail": [
          {
            "cmmdtyCode": "101002405",
            "payAmount": "10.00000",
            "cmmdtyName": "sony彩电",
            "price": "12000.00",
            "couponTotalMoney": "100.00",
            "payStatus": "1",
            "saleQty": "2",
            "totalAmount": "2400.00",
            "statusValue": "10",
            "supplierCommodityCode": "101002405111",
            "storeCode": "910B",
            "transportFee": "5.00000"
          }
        ],
        "address": "江苏省南京市玄武区苏宁大道一号",
        "b2cOrderId": "1606011663538",
        "orderTime": "2016-10-12 18:12:00",
        "orderStatus": "10",
        "orderRemark": "备注",
        "xdAddress": "江苏省南京市玄武区苏宁大道1号",
        "xdPhone": "13912932886"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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