文档
测试

7.取消

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

接口应用场景

1.什么时候用户可取消订单? 答:订单状态order_status=0配对中 或 1装货中时,用户才可以取消订单。接口将实时返回订单取消结果(order_statu=3用户取消) 2.是否有其他情况导致订单自动取消? 答: - 下单后,在60分钟内无司机接单,订单将会自动取消(订单状态更新为5订单逾时) - 司机发起取消。当第一个司机接单后,发起取消(订单状态更新为0配对中)。订单将再次配对。当第二个司机接单后,发起取消,则订单取消(订单状态更新为4司机已拒绝) - 当司机接单后,如果在5天内未点击确认装货完成,则订单自动取消(订单状态更新为8) - 当司机接单后,如果在10天内未点击完成,则订单自动取消(订单状态更新为9)

服务入口

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

编码

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

前端UI参考:

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

公共请求参数

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

应用级请求参数

参数名
类型
描述
必填
order_display_id
string
货拉拉订单号
必填
order_status
int
订单状态
可选
reason_id
int
取消订单原因id, 值见”获取取消原因选项“接口返回值中sub_cat.sub_id;示例:1
可选
reason
string
取消原因说明, 值见”获取取消原因选项“接口返回值中sub_cat.sub_name示例:计划有变,暂时不需要用车
可选

响应参数

参数名
类型
描述
必填
ret
int
返回结果码, 示例:0
可选
msg
string
结果中文描述; 示例:Success
可选
data
array
数据列表
可选

request Body请求示例

```json { "app_key":"*****************", "access_token":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "order_display_id":264300101026, "reason_id":1, "order_status":0, "reason":"计划有变,暂时不需要用车" } ```

response响应示例

```json { "ret": 0, "data": [], "msg": "Success" } ```

返回状态码

|状态码|描述| |-|-|-| |0|成功| |1|服务器异常| |1000|传输参数异常| |22002|司机已接单被取消|