文档
测试

11.查询订单列表

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

服务入口

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

编码

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

前端UI参考

![image.png](https://cos.easydoc.net/48578360/files/ka21btv5.png)

公共请求参数

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

应用级请求参数

参数名
类型
描述
必填
order_display_id
string
货拉拉对外订单号
可选
page_no
int
页数
可选
page_size
int
每页条数
可选

响应参数

参数名
类型
描述
必填
ret
int
结果码,示例:0
可选
msg
string
结果码中文;示例:Success
可选
data
object
数据字典
可选
total
int
数据总条数;示例:1
可选
order_arr
array
数据列表
可选
order_display_id
string
货拉拉对外订单号;示例:268610304033
可选
order_id
number
货拉拉内部订单id;示例:136348
可选
order_uuid
string
货拉拉内部订单uuid;示例:10019070120095609310020043138027
可选
order_status
number
订单状态: 0配对中,1待装货,3订单取消,4司机拒绝,5订单逾时,6订单未支付,8五天未装货自动取消,7运送中,9十天完成自动取消,10司机点完成,11异常完成,12结清费用,13客户确认账单中,14账单申诉中,2最终完成;示例:5
可选
pay_status
number
支付状态0-待支付,1-已支付,2-未支付,3退款中,4-已退款,5支付中;示例:2
可选
pay_type
number
支付方式,3:余额支付,8:账期支付;示例:3
可选
addr_info_arr
array
地址信息数据列表
可选
lat_lon_item
object
经纬度数据字典
可选
lat
number
纬度;示例:22.57368728233
可选
lon
number
经度;示例:114.05621599118
可选
name
string
地标; 示例:卓悦汇购物中心
可选
addr
string
地址;示例:深圳市福田区梅康路
可选
city_id
number
城市id;示例:1002
可选
district_name
string
区域;示例:福田区
可选
house_number
string
楼层及门牌号;示例:
可选
contact_name
string
联系人;示例:
可选
contact_phone_no
string
联系人手机号;示例:
可选
order_vehicle_id
number
订单车型;示例:17
可选
vehicle_type_name
string
订单车型名称;示例:面包车
可选
remark
string
备注;示例:
可选
order_reason
string
企业员工用车原因,限200字;示例:
可选
price_fen
number
订单总金额;示例:1800
可选
order_price_arr
array
各项价格信息;数据列表
可选
type
number
计价类型1:起步价,2:超⾥程价,4:额外需求,5:小费,6:车型要求,7:平台订单补贴,8:额外费用;示例:1
可选
price_fen
number
计价金额(以分为单位);示例:1800
可选
pay_status
number
支付状态0-待支付,1-已支付,2-未支付,3退款中,4-已退款,5支付中;示例:4
可选
order_time
string
用车时间;示例:2019-07-01 20:19:54
可选
create_time
string
订单创建时间;示例:2019-07-01 20:09:56
可选
user_id
number
用户id;示例:13363
可选
city_id
number
城市id; 示例:1002
可选
ep_id
number
企业id; 示例:11003210
可选
send_bill_time
string
司机发送帐单时间,默认为空;示例:
可选
driver_id
number
当前司机Id,默认为0;示例:0
可选
send_bill_price_fen
number
发送账单时的价格;示例:1800
可选
update_bill_time
string
更新账单时间;示例:
可选
is_complain_order
number
订单是否有申诉,0-无申诉,1-有申诉,默认为0;示例:0
可选
complain_bill_time
string
账单申诉时间 ,默认为空串;示例:
可选
abnormal_bill_time
string
订单异常时间,默认为空串;示例:
可选

request Body请求示例

```json { "app_key":"Z7KGxOgKha7gvrEEfXQD", "access_token":"*****************", "nonce_str":"474", "timestamp":"1565225482040", } ```

response响应示例

```json { "ret":0, "data":{ "total":1, "order_arr":[ { "order_id":136348, "order_uuid":"10019070120095609310020043138027", "addr_info_arr":[ { "lat_lon_item":{ "lat":22.573687282329999, "lon":114.05621599118 }, "name":"卓悦汇购物中心", "addr":"深圳市福田区梅康路", "city_id":1002, "district_name":"福田区", "house_number":"", "contact_name":"", "contact_phone_no":"" }, { "lat_lon_item":{ "lat":22.573553521727, "lon":114.05410106119 }, "name":"上梅林-b出口", "addr":"深圳市上梅林地铁站-B出口", "city_id":1002, "district_name":"福田区", "house_number":"", "contact_name":"", "contact_phone_no":"" } ], "order_time":"2019-07-01 20:19:54", "create_time":"2019-07-01 20:09:56", "order_vehicle_id":17, "order_status":5, "order_price_arr":[ { "type":1, "price_fen":1800, "pay_status":4 }, { "type":15, "price_fen":0, "pay_status":4 } ], "remark":"", "vehicle_type_name":"面包车", "price_fen":1800, "user_id":13363, "city_id":1002, "ep_id":11003210, "pay_status":2, "order_display_id":"268610304033", "send_bill_time":"", "driver_id":0, "send_bill_price_fen":1800, "update_bill_time":"", "is_complain_order":0, "complain_bill_time":"", "abnormal_bill_time":"", "order_reason":"", "pay_type":3 } ] }, "msg":"Success" } ```

返回状态码

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