7.取消订单

websocket测试

POST

api_method:u-order-cancel

服务入口:

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

调用注意事项

1.什么时候用户可取消订单？答:订单状态order_status=0配对中或 1装货中时,用户才可以取消订单。接口将实时返回订单取消结果(order_statu=3用户取消) 2.是否有其他情况导致订单自动取消？答: - 下单后,在60分钟内无司机接单，订单将会自动取消(订单状态更新为5订单逾时) - 司机发起取消。当第一个司机接单后,发起取消(订单状态更新为0配对中)。订单将再次配对。当第二个司机接单后,发起取消,则订单取消(订单状态更新为4司机已拒绝) - 当司机接单后,如果在5天内未点击确认装货完成,则订单自动取消(订单状态更新为8) - 当司机接单后,如果在10天内未点击完成,则订单自动取消(订单状态更新为9) 3.开发者应何时显示取消入口？答:请开发者判断订单详情中字段"是否可取消订单can_order_cancel" 4.取消时,什么场景下需要选择取消原因？答:取消时,是否需要选择取消原因,请开发者判断订单详情中字段“need_to_cancel_reason是否需选择取消原因”

编码

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

前端UI界面参考:

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

系统级请求参数

参数名

类型

描述

必填

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

货拉拉订单号

必填

reason

string

取消原因描述，

可选

order_status

int

当前订单状态

必填

响应参数

参数名

类型

描述

必填

ret

int

返回结果码，示例：0

必填

msg

string

返回结果描述，示例：

必填

data

object

返回数据

必填

order_status

int

订单状态

必填

请求json示例：

```json { "app_key":"****************", "access_token":"**************", "nonce_str":"474", "timestamp":"1565225482040", "signature":"*******************", "order_display_id":*******, "reason":"", "order_statu":0 } ```

返回json示例:

```json { "ret": 0, "msg": "", "data": { "order_statu":3 } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功| |30012|订单id错误| |31001|只有处于配对中或待装货的订单才可以取消| |31002|订单状态已变更|