文档
测试

9.查询订单详情

POST
https://openapi-pre.huolala.cn/api/e-order-detail

服务入口

测试环境:https://openapi-pre.huolala.cn/api/e-order-detail 正式环境:https://openapi.huolala.cn/api/e-order-detail

编码

数据编码: Accept:application/json Content-type: application/json 字符编码: utf-8

订单状态流转说明

![未命名文件 1.png](https://cos.easydoc.net/48578360/files/k5c1k72k.png)

费用说明

√货拉拉费用总分为五部分 1.基础费用,主要由起步价(起步公里数)+超里程价(区间)组成。此费用是按照导航等进行计算出来的,属于前置费用。需用户下单时就立即支付或从账户余额扣款 2.车型特殊要求的费用vehicle_std_price_arr。如用户可选择带尾板(收费)的车型。属于车型的附加要求。用户不选择则不收费。此费用属于前置费用。需用户下单时就立即支付或从账户余额扣款 3.用户额外需求的费用spec_req_price_arr。每个下单城市可供用户选择一些特殊的增值服务,如回单,返程等。这些额外费用根据用户选择进行收费,不选择额外需求则不收费。此费用属于前置费用。需用户下单时就立即支付或从账户余额扣款 4.小费。用户自主选择是否添加。此费用也属于前置费用。用户需要添加小费时,就需进行立即支付或从账户余额扣款 5.司机添加的额外费用bill_price_arr。主要由高速费,停车费,等候费,搬运费组成.此费用是司机在运货过程中实时产生的,由司机进行添加。 属于后置费用。订单结束前需下单用户对账单及司机添加的额外费用进行确认,确认后从账户或余额扣款

公共请求参数

参数名
类型
描述
必填
app_key
string
app唯一标识.
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,仅用于保证签名不可预测;示例:474
必填
timestamp
string
Unix时间戳(单位:秒),60s内有效,超过60s则超时;示例:1565225482
必填
access_token
string
访问令牌码,对应货拉拉唯一的用户,当用户授权后生成对应访问码
必填

应用级请求参数

参数名
类型
描述
必填
order_display_id
string
货拉拉对外订单号;示例:
必填

响应参数

参数名
类型
描述
必填
ret
int
返回结果码,示例:0
必填
msg
string
返回结果描述,示例:Success
必填
data
object
数据字典
必填
order_detail_item
object
订单明细信息
必填
order_item
object
订单信息
必填
order_display_id
string
货拉拉订单号(对外)
必填
order_id
number
货拉拉订单号(对内)
必填
order_uuid
string
示例:10019122512471424210020016443861
必填
order_status
number
订单当前状态 示例:13
必填
pay_status
number
订单总支付状态1已支付,0未支付 示例:1
必填
order_vehicle_id
number
订单车型ID, 示例:7
必填
vehicle_type_name
string
订单车型名称, 示例:小型厢货
必填
addr_info_arr
array
订单地址信息
必填
lat_lon_item
object
经纬度(wgs84坐标系)
必填
lat
number
纬度 示例:22.572521260981
必填
lon
number
经度 示例:114.05507565816
必填
name
string
地址名称 示例:卓悦汇购物中心
必填
addr
string
地址详情 示例:深圳市-福田区-中康路126号
必填
city_id
number
地址所属城市ID 示例:1002
必填
district_name
string
地址所属区(县) 示例:福田区
必填
house_number
string
楼层及门牌号 示例:4楼403
必填
contact_name
string
地址联系人 示例:roly
必填
contact_phone_no
string
地址联系人手机 示例:18825162021
必填
order_time
string
需用车时间 示例:2019-12-25 12:57:04
必填
create_time
string
订单创建时间, 示例:2019-12-25 12:47:14
必填
order_reason
string
员工用车原因, 示例:测试
必填
remark
string
订单备注, 示例:测试
必填
price_fen
number
订单总价格 示例:3500
必填
order_price_arr
array
订单计价明细数组
必填
type
number
计价类型 1-起步价,2-超里程价,3-拉拉券扣减,4-额外需求产生的费用,5-小费,6-规格,7-平台订单补贴,8-司机添加的额外费用,15-货物保险费用,21-高速费,22-停车费,23-搬运费,24-其他,25-逾时等候费
必填
price_fen
number
计价金额(以分为单位)
必填
pay_status
number
支付状态 1已支付, 0未支付
必填
user_id
number
下单用户ID, 示例:100010115
必填
city_id
number
下单城市ID 示例:1002
必填
ep_id
number
下单用户企业账号ID
必填
driver_id
number
接单司机ID, 示例:1781
必填
send_bill_time
string
司机账单发送时间, 示例:2019-12-25 12:53:40
必填
send_bill_price_fen
number
司机账单发送金额(分) 示例:3500
必填
update_bill_time
string
账单更新时间 示例:2019-12-25 12:53:40
必填
is_complain_order
number
用户是否申诉账单
必填
complain_bill_time
string
账单申诉时间, 示例:2019-12-25 12:53:40
必填
abnormal_bill_time
string
账单异常完成时间, 示例:2019-12-25 12:53:40
必填
pay_type
number
支付方式(3企业账户余额支付,8账期支付)
必填
order_type
number
订单类型
必填
contact_name
string
下单联系人 示例:罗瑞
必填
contact_phone_no
string
下单联系人手机 示例:14716866598
必填
total_distance
int
总里数(m), 示例:5519
必填
exceed_distance
int
超里数(m) 示例:481
必填
driver_id
int
接单司机ID, 示例:1781
必填
vehicle_std_price_arr
array
车型附加要求项及费用信息
必填
spec_req_price_arr
array
订单额外服务项及费用信息
必填
type
int
示例:6
必填
price_fen
int
示例:0
必填
price_type
int
示例:4
必填
name
string
示例:拍照回单
必填
price_value_fen
int
示例:0
必填
bill_price_arr
array
司机添加的额外费用信息
必填
bill_type
number
费用类型ID,1过桥费,2停车费,3搬运费,5逾时等候费
必填
name
string
费用类型名称 示例:高速路桥费
必填
price_fen
number
费用金额(分) 示例:0
必填
img_url
string
票据凭证图片链接 示例:
必填
progress_str
string
订单跟踪信息, 示例:订单已提交|2019-12-25 12:47,司机已接单|2019-12-25 12:48,货物已装车|2019-12-25 12:48,订单已完成|2019-12-25 12:48,账单已发送|2019-12-25 12:53
必填
complete_time
string
订单完成时间 示例:2019-12-25 12:48:35
必填
vehicle_id
int
下单车型ID, 示例:3242
必填
pickup_ts
string
司机接单时间戳:
必填
loaded_ts
string
司机装货时间戳
必填
driver_amount_fen
int
示例:0
必填
amount_fen
int
示例:0
必填
brokerage_fen
int
平台信息费, 示例:0
必填
goods_type_id
int
示例:0
必填
person_insurance_fen
int
保险费用 示例:3242
必填
virtual_bind_status
int
虚拟号绑定状态, 示例:0
必填
use_virtual_phone
int
用户虚拟号 示例:0
必填
last_bind_phone_no
int
最后绑定用户 示例:0
必填
virtual_phone_info
array
用户虚拟号信息
必填
driver_info
object
接单司机信息
必填
name
string
司机称呼, 示例:罗师傅
必填
phone_no
string
司机联系方式, 示例:15013567586
必填
license_plate
string
司机车牌号, 示例:京ABDRJJJ
必填
lat_lon
object
司机当前经纬度(wgs84坐标系)
必填
lat
double
纬度, 示例:22.570849999927
必填
lon
double
经度 示例:114.05644299963
必填

request Body请求示例

```json { "app_key":"*****************", "access_token":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "order_display_id":268610304033, } ```

response响应示例

```json { "ret": 0, "data": { "order_detail_item": { "order_item": { "order_id": 105907, "order_uuid": "10019122512471424210020016443861", "addr_info_arr": [ { "lat_lon_item": { "lat": 22.572521260981, "lon": 114.05507565816 }, "name": "卓悦汇购物中心", "addr": "深圳市-福田区-中康路126号", "city_id": 1002, "district_name": "福田区", "house_number": "4楼403", "contact_name": "roly", "contact_phone_no": "18825162021" }, { "lat_lon_item": { "lat": 22.604841125873, "lon": 114.03705116201 }, "name": "白石龙地铁站-A口", "addr": "深圳市白石龙地铁站-A口", "city_id": 1002, "district_name": "", "house_number": "7楼708", "contact_name": "", "contact_phone_no": "" } ], "order_time": "2019-12-25 12:57:04", "create_time": "2019-12-25 12:47:14", "order_vehicle_id": 7, "order_status": 13, "order_price_arr": [ { "type": 1, "price_fen": 3500, "pay_status": 1 }, { "type": 4, "price_fen": 0, "pay_status": 1 }, { "type": 15, "price_fen": 0, "pay_status": 1 }, { "type": 18, "price_fen": 0, "pay_status": 1 } ], "remark": "测试", "vehicle_type_name": "小型厢货", "price_fen": 3500, "user_id": 100010115, "city_id": 1002, "ep_id": 382135001, "pay_status": 1, "order_display_id": "217510500090", "send_bill_time": "2019-12-25 12:53:40", "driver_id": 1781, "send_bill_price_fen": 3500, "update_bill_time": "", "is_complain_order": 0, "complain_bill_time": "", "abnormal_bill_time": "", "order_reason": "测试", "pay_type": 3, "order_type": 0 }, "contact_name": "罗瑞", "contact_phone_no": "14716866598", "total_distance": 5519, "exceed_distance": -481, "driver_id": 1781, "spec_req_price_arr": [ { "type": 6, "price_fen": 0, "price_type": 4, "name": "拍照回单", "price_value_fen": 0 } ], "vehicle_std_price_arr": [], "bill_price_arr": [ { "bill_type": 1, "price_fen": 0, "name": "高速路桥费", "img_url": "" }, { "bill_type": 2, "price_fen": 0, "name": "停车费", "img_url": "" }, { "bill_type": 3, "price_fen": 0, "name": "搬运费", "img_url": "" }, { "bill_type": 4, "price_fen": 0, "name": "逾时等候费", "img_url": "" } ], "progress_str": "订单已提交|2019-12-25 12:47,司机已接单|2019-12-25 12:48,货物已装车|2019-12-25 12:48,订单已完成|2019-12-25 12:48,账单已发送|2019-12-25 12:53", "complete_time": "2019-12-25 12:48:35", "vehicle_id": 3242, "pickup_ts": "", "loaded_ts": "", "driver_amount_fen": 0, "amount_fen": 0, "brokerage_fen": 0, "goods_type_id": 0, "person_insurance_fen": 0, "virtual_bind_status": 0, "use_virtual_phone": 0, "last_bind_phone_no": 0, "virtual_phone_info": [] }, "driver_info": { "lat_lon": { "lat": 22.570849999927, "lon": 114.05644299963 }, "phone_no": "15013567586", "license_plate": "京ABDRJJJ", "name": "罗师傅" } }, "msg": "Success" } ```

返回状态码

|状态码|描述| |-|-|-| |0|成功| |1|服务器异常| |1000|传输参数异常| |20002|企业账户信息不存在|