文档
测试

5.下单

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

服务入口

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

调用特别注意事项

1.下单接口中"订单金额"与"城市版本号"必传,所以调下单接口前,请先调用“获取城市车型信息”与“计价”2个接口 2.通过城市车型信息得到最新的“城市版本号” 3.通过计价得到“订单总金额” 4.我们的价格体系与城市版本号息息相关,一旦城市版本号在我司系统变化了,需要用户侧重新获取最新的城市版本号,并重新计价

编码

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

前端UI参考

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

公共请求参数

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

应用级请求参数

参数名
类型
描述
必填
city_id
int
下单城市id; 示例:1002
必填
city_info_revision
int
当前最新的城市版本号; 值来源:调用“获取城市可选车型信息”接口返回值data.revision; 当版本号不是最新时会返回公共错误码21002,需要重新调用“获取城市可选车型信息”接口返回值revision;示例:777
必填
order_vehicle_id
int
下单车型id; 示例:17
必填
std_tag_arr
string
车型附加要求, 字符串数组;格式如:"[\"带尾板\"]";值可取“获取城市可选车型信息"接口返回值中data.vehicle_arr[0].vehicle_std_arr.name的值作为成员
可选
spec_req_arr
string
订单额外服务, 整型数组;格式如:"[2, 3, 5]";值可取“获取城市可选车型信息"接口返回值中data.spec_req_arr.type的值作为成员;1搬运 2小推车 3回单 4尾板 5返程 6回单拍照 7海外入仓 8代收货款;示例:2
可选
addr_info
string
发/收货地poi数据列表。 可参考“根据关键字检索地址poi”接口返回值;string内容为地址信息数组
必填
lat_lon
object
经纬度(wgs84坐标系); 格式如:{"lat":22.567877804561395,"lon":114.0477470255907}
必填
lat
double
发货地/收货地纬度;示例:22.573687282329747
必填
lon
double
发货地/收货地经度;示例:114.05621599118145
必填
name
string
地名; 示例:卓悦汇购物中心
必填
addr
string
地址详情; 示例:福田区梅康路
必填
city_id
int
所属城市id; 示例:1002
必填
district_name
string
所属区(县); 示例:福田区;
可选
house_number
string
楼层及门牌号
可选
contact_name
string
联系人
可选
contact_phone_no
string
联系人手机;示例:
可选
order_time
int
需用车时间(unix时间戳,单位(秒))
必填
total_price_fen
int
订单总金额(分);示例:1800; 值来源:"计价"接口返回值data.total_price_fen
必填
contact_name
string
下单联系人;示例:卡卡
必填
contact_phone_no
string
下单联系人手机;示例:18312581111
必填
pay_type
int
支付方式(3 余额支付,8 账期额度支付)
必填
order_reason
string
用车原因,限200字;
可选
remark
string
订单备注
可选

响应参数

参数名
类型
描述
必填
ret
int
结果码;示例:0
可选
msg
string
结果描述;示例:Success
可选
data
object
数据字典
可选
order_display_id
string
对外订单号;示例:268610304033
可选

request Body请求示例

```json { "app_key":"****************", "access_token":"*********************", "nonce_str":9999, "timestamp":1573717187, "city_id":1006, "order_vehicle_id":10, "spec_req_arr":"", "city_info_revision":"2",//必须为最新版城市版本号 "addr_info":"[{\"lat_lon\":{\"lat\":31.196027516575054,\"lon\":121.31625670047288},\"addr\":\"闵行区申贵路1500号\",\"name\":\"申贵路1500号\",\"city_id\":\"1006\",\"district_name\":\"闵行区\",\"house_number\":\"\",\"contact_name\":\"\",\"contact_phone_no\":\"\"},{\"lat_lon\":{\"lat\":31.202375193368646,\"lon\":121.32264161728554},\"addr\":\"长宁区人民医院\",\"name\":\"人民医院\",\"city_id\":\"1006\",\"district_name\":\"长宁区\",\"house_number\":\"\",\"contact_name\":\"\",\"contact_phone_no\":\"\"}]", "total_price_fen":"4470",//总价必须准确 "contact_name":"卡卡", "contact_phone_no":"18312581111", "pay_type":"3", "order_reason":"企业员工用车原因,限200字", "remark":"备注", "order_time":1573717187 } ```

response响应示例

```json { "ret":0, "data":{ "order_display_id":268610304033 }, "msg":"Success" } ```

返回状态码

|状态码|描述| |-|-|-| |0|成功| |1|服务器异常| |1000|传输参数异常| |20001|账号异常| |20002|企业账户信息不存在| |21001|当前城市暂无车型| |21002|车型有变更| |22001|订单待支付| |22007|地址信息有误| |23001|账户信息异常| |23002|账户余额不足| |23003|月结账户未生效| |23004|月结账户已过期| |23005|月结账户被冻结|