# 查詢訂單信息
## 1、基本信息
請求API名稱:orderQuery
接口描述:根據接入方訂單編號,查詢訂單的狀態 、配送員信息等
## 2、請求參數
| 字段名 | 類型 | 是否必填 | 示例 | 描述 |
| --- | --- | --- | --- | --- |
|ordersn_third| String | 是 | 2020103012000012345678 | 接入方訂單編號 |
請求示例:
{
"ordersn_third": "2020103012000012345678"
}
## 3、響應結果
| 字段名 | 類型 | 示例 | 描述 |
| --- | --- | --- | --- | --- |
|id|String|1|啦啦外賣訂單自增ID|
|ordersn|String| 20200728144905060634|啦啦外賣訂單編號|
|goods_price|String|10.5|訂單商品價格|
|goods_weight|String|2.3|商品重量|
|buy_username|String|張三|取貨聯系人|
|buy_sex|String|男|取貨聯系人性別|
|buy_mobile|String|15364816001|取貨聯系電話|
|buy_address|String|山西省太原市|取貨詳細地址|
|buy_location_x|String|37.957075|取貨地址緯度|
|buy_location_y|String|112.539401|取貨地址經度|
|accept_username|String|李四|收貨人姓名|
|accept_sex|String|1|收貨人性別|
|accept_mobile|String|15364816002|收貨人電話|
|accept_address|String|山西省太原市|收貨人詳細地址|
|accept_location_x|String|37.791148|收貨地址緯度|
|accept_location_y|String|112.57779|收貨地址經度|
|distance|String|26.137|配送距離 單位km|
|delivery_time|String|2020-07-28 12:30|預計送達時間|
|delivery_status|String|4|配送狀態碼 見附錄|
|delivery_status_cn|String|已完成|配送狀態碼說明|
|status_cn|String|已完成|訂單狀態中文說明|
|deliveryer_id|String|16|配送員ID|
|status|String|3|訂單狀態碼 見附錄|
|is_pay|String|1|是否已支付 1已付 0未付|
|addtime|String|1595918945|訂單創建時間戳|
|paytime|String|1595918945|訂單支付時間戳|
|delivery_assign_time|String|1595918956|配送員接單時間戳|
|delivery_success_time|String|1595918963|配送完成時的時間戳|
|delivery_success_location_x|String|37.791461|配送完成時配送員所在位置的緯度|
|delivery_success_location_y|String|112.575363|配送完成時配送員所在位置的經度|
|delivery_fee|String|73.42|配送費|
|delivery_tips|String|4|配送小費|
|total_fee|String|77.42|訂單總金額|
|discount_fee|String|0|訂單優惠金額|
|final_fee|String|77.42|訂單實際支付金額|
|note|String|不要辣椒|訂單備注|
|log|Array||當前訂單狀態日志|
|logs|Array||訂單狀態日志列表|
|deliveryer|Array||配送員信息|
log、logs字段說明
| 字段名 | 類型 | 示例 | 描述 |
| --- | --- | --- | --- | --- |
|id|String|1|訂單日志自增ID|
|oid|String|1|日志對應的訂單ID|
|status|String|4|訂單狀態碼|
|title|String|已完成|訂單狀態說明|
|addtime|String|1595918963|記錄日志的時間戳|
deliveryer字段說明
| 字段名 | 類型 | 示例 | 描述 |
| --- | --- | --- | --- | --- |
|id|String|16|配送員ID|
|title|String|王五|配送員姓名|
|sex|String|男|配送員性別|
|mobile|String|15364816003|配送員手機號|
|location_x|String|37.791461|配送員最近一次上傳位置的緯度坐標|
|location_y|String|112.575363|配送員最近一次上傳位置的經度坐標|
正確響應結果示例:
{
"errno": 0,
"message": {
"id": "166",
"order_sn": "20200728144905060634",
"goods_price": "10.5",
"goods_weight": "2.3",
"buy_username": "張三",
"buy_sex": "1",
"buy_mobile": "15364816001",
"buy_address": "山西省太原市",
"buy_location_x": "37.957075",
"buy_location_y": "112.539401",
"accept_username": "李四",
"accept_sex": "1",
"accept_mobile": "15364816002",
"accept_address": "山西省太原市",
"accept_location_x": "37.791148",
"accept_location_y": "112.57779",
"distance": "26.137",
"delivery_time": "2020-07-28 12:30",
"delivery_status": "4",
"deliveryer_id": "16",
"status": "4",
"is_pay": "1",
"addtime": "1595918945",
"paytime": "1595918945",
"delivery_assign_time": "1595918956",
"delivery_success_time: "1595918963",
"delivery_success_location_x": "37.791461",
"delivery_success_location_y": "112.575363",
"delivery_fee": "73.42",
"delivery_tips": "4",
"total_fee": "77.42",
"discount_fee": "0",
"final_fee": "77.42",
"note": "不要辣椒",
"status_cn": "已完成",
"delivery_status_cn": "已完成",
"log": {
"id": "1150",
"oid": "166",
"status": "4",
"title": "訂單已完成",
"addtime": "1595918963"
},
"logs": [{
"id": "1145",
"oid": "166",
"status": "1",
"title": "訂單提交成功",
"addtime": "14:49"
}, {
"id": "1146",
"oid": "166",
"status": "1",
"title": "待支付",
"addtime": "14:49"
}, {
"id": "1147",
"oid": "166",
"status": "2",
"title": "訂單已支付",
"addtime": "14:49"
}, {
"id": "1148",
"oid": "166",
"status": "1",
"title": "待接單",
"addtime": "14:49"
}, {
"id": "1149",
"oid": "166",
"status": "3",
"title": "已接單",
"addtime": "14:49"
}, {
"id": "1150",
"oid": "166",
"status": "5",
"title": "訂單已完成",
"addtime": "14:49"
}],
"deliveryer": {
"id": "16",
"title": "王五",
"sex": "男",
"mobile": "15364816003",
"location_x": "37.791461",
"location_y": "112.57536315918"
}
}
}
錯誤響應結果示例:
{
"errno": -1,
"message": "訂單編號不能為空"
}
## 附錄
#### 訂單狀態碼 status
|狀態碼|狀態名|說明|
| --- | --- | --- | --- | --- | --- |
|1|待接單|正在調度、分配或者等待配送員接單|
|2|已接單|配送員已接單|
|3|已完成|訂單配送完成|
|4|已取消|訂單取消|
#### 訂單配送狀態碼 delivery_status
|狀態碼|狀態名|說明|
| --- | --- | --- | --- | --- | --- |
|1|待接單|等待配送員接單|
|2|待取貨|配送員已接單,正在取貨途中|
|3|配送中|配送員已取貨,正在配送|
|4|已完成|配送員配送完成|