文档
测试

9.查询订单详情

POST
api_method:u-order-detail

服务入口:

测试环境:https://openapi-stg.huolala.cn/v1 正式环境:https://openapi.huolala.cn/v1

编码

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

系统级请求参数

参数名
类型
描述
必填
api_method
string
接口方法
必填
api_version
string
接口版本,固定值:1.0
必填
app_key
string
应用唯一app_key
必填
access_token
string
用户账户访问令牌
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复
必填
timestamp
number
unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时
必填
signature
string
签名值
必填

应用级请求参数

参数名
类型
描述
必填
order_display_id
string
货拉拉订单号
可选

响应参数

参数名
类型
描述
必填
ret
int
返回结果码
必填
msg
string
返回结果描述
必填
data
object
数据字典
必填
order_display_id
string
订单ID, 示例:136100807038
必填
order_status
int
订单状态, 示例:0
必填
order_status_name
string
订单状态描述, 示例:待装货
必填
order_vehicle_id
int
订单车型ID, 示例:5
必填
vehicle_type_name
string
订单车型名称, 示例:⼩⾯包⻋
必填
addr_info
array
下单地址信息
必填
name
string
地名, 示例:卓悦汇购物中⼼
必填
addr
string
地址详情, 示例:深圳市福⽥区梅康路
必填
lat_lon
object
经纬度(gcj02坐标系)
必填
lon
double
定位经度, 示例:114.05487818175
必填
lat
double
定位纬度, 示例:22.573230423997
必填
city_id
int
地址所在城市ID, 示例:1002
必填
district_name
string
地址所在区(县), 示例:福⽥区
必填
house_number
string
楼层及门牌号, 示例:
可选
contacts_name
string
地址联系人, 示例:
可选
contacts_phone_no
string
地址联系人电话 示例:
可选
contact_name
string
订单联系人
必填
contact_phone_no
string
订单联系人手机
必填
remark
string
订单备注, 示例:货拉拉测试订单,勿抢
必填
order_time
long
用车时间(unix时间戳,单位秒),示例:1568860905
必填
create_time
long
创建订单时间, 示例:1568859910
必填
complete_time
number
订单完成时间, 示例:1568859910
必填
total_price_fen
int
订单总价(分), 示例:4100
必填
total_distance
int
计费总里程(米)
可选
unpaid_price_fen
int
未支付金额(分), 示例:2000
必填
price_info
array
价格详情
必填
amount_fen
int
账单金额(分), 示例:3400
必填
bill_type
int
账单类型id: 1起步价, 2超⾥程价, 3拉拉券抵消价格,4额外需求费⽤ ,5⼩费, 6车费附加要求费⽤, 7额外补贴, 8⽤户主动⽀付的额外费⽤, 9附加费⽤, 10最低⼩费附加费, 11封顶折扣, 12保险费⽤ , 21司机添加-⾼速路桥费, 22司机添加-停⻋费, 23司机添加-搬运费, 25司机添加-逾时等候费
必填
bill_type_name
string
账单类型名称,示例:起步价
必填
pay_status
number
该条账单⽀付状态, 0未支付, 1已⽀付, 2 ⽀付失败, 3退款中, 4退款成功, 5⽀付中, 7申述中
必填
pay_status_name
string
该条账单⽀付状态名字
必填
need_to_pay
int
用户是否需要⽀付 0-不需要支付, 1-需要支付账单, 2-需要支付但当前不能支付|
必填
img_url
string
图片url
可选
driver_info
object
接单司机信息
必填
name
string
司机称呼, 示例:刘师傅
必填
physics_vehicle_name
string
司机车型, 示例:⾯包⻋
必填
phone_no
string
司机号码,有可能是虚拟号或者客服电话,未接单的时候为空
必填
phone_no_type
int
司机号码类型: 1-真实号码, 2-虚拟号码, 3-客服电话
必填
user_bind_phone_no
string
虚拟号绑定的号码
必填
lat_lon
object
司机经纬度位置信息(gcj02)
必填
lat
double
定位纬度,示例:22.573230423997
必填
lon
double
定位经度,示例:114.05487818175
必填
can_add_tips
int
能否添加⼩费, 0-不能添加, 1-可以添加
必填
can_order_cancel
int
能否取消订单, 0-能, 1-不能
必填
need_to_cancel_reason
int
是否需要选择取消原因: 0-不需要, 1-需要
必填
appeal_enabled_status
int
是否允许申述状态, 0不允许,1允许发起费⽤协商, 2允许发起账单申述,3超过申述期
必填
can_bill_appeal_list
array
可申诉账单列表
可选
bill_type
int
账单ID, 示例:8
可选
bill_type_name
string
账单名称, 示例:额外费⽤
可选
amount_fen
int
账单金额(分), 示例:1200
可选

请求json示例:

```json { "app_key":"*******************", "nonce_str":"12348", "timestamp":1574822548, "access_token":"********************", "order_display_id":324700601039 } ```

返回json示例:

```json { "ret":0, "msg":"", "data":{ "addr_info":[ { "lat_lon":{ "lat":22.573230423997, "lon":114.05487818175 }, "name":"卓悦汇购物中⼼", "addr":"深圳市福⽥区梅康路", "city_id":1002, "district_name":"福⽥区", "house_number":"", "contacts_name":"", "contacts_phone_no":"" }, { "lat_lon":{ "lat":22.572213402975, "lon":114.05448490823 }, "lat_lon_baidu":{ }, "name":"上梅林", "addr":"上梅林", "city_id":1002, "district_name":"", "house_number":"", "contacts_name":"", "contacts_phone_no":"" } ], "order_time":1568860905, "create_time":1568859910, "order_vehicle_id":5, "order_status":0, "order_status_name":"待装货", "total_price_fen":4100, "unpaid_price_fen":2000, "remark":"货拉拉测试订单,勿抢", "order_display_id":136100807038, "vehicle_type_name":"⼩⾯包⻋", "complete_time":1568859910, "need_to_pay":0, "need_to_cancel_reason":1, "can_add_tips":1, "can_order_cancel":1, "contact_name":"联系⼈", "contact_phone_no":"13699999999", "driver_info":{ "name":"刘师傅", "physics_vehicle_name":"⾯包⻋", "phone_no":"", "phone_no_type":1, "user_bind_phone_no":"", "lat_lon":{ "lat":22.573230423997, "lon":114.05487818175 } }, "price_info":[ { "amount_fen":3400, "bill_type":1, "bill_type_name":"起步价", "pay_status":1, "pay_status_name":"已⽀付", "img_url":"" } ], "appeal_enabled_status":2, "can_bill_appeal_list":[ { "bill_type":8, "bill_type_name":"额外费⽤", "amount_fen":1200 } ] } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功| |300012|订单id错误|