订单关闭接口
订单关闭接口
| 接口名称 | 订单关闭 |
|---|---|
| 接口类型 | HTTP POST |
| 接口格式 | application/json;charset=UTF-8 |
| 线上地址 | https://openapi.wanshifu.com/user-open/order/closeOrder |
| 测试地址 | https://openapi.wanshifu.com/pre-release/test/user-order-open-api/user-open/order/closeOrder |
| 接口说明 | 第三方调用此接口关闭订单 |
| 是否加密 | 是 |
业务参数
| 字段名称 | 字段说明 | 字段类型 | 是否必传参数 |
|---|---|---|---|
| reason | 关单原因 | String | 是 |
| thirdOrderNo | 第三方订单id | String | 是 |
业务参数示例
{
"reason": "no reason",
"thirdOrderNo": "aqeryest500001"
}最终请求参数示例
{
"busData": "eyJyZWFzb24iOiJubyByZWFzb24iLCJ0aGlyZE9yZGVyTm8iOiJhcWVyeWVzdDUwMDAwMSJ9",
"checkData": "BCF678E8545AEED30913958632A4655B",
"childAccount": "",
"licenseId": "dWKA1O33",
"timestamp": 1654072370500
}返回信息
关单成功由回调服务节点通知| 字段名称 | 字段说明 | 字段类型 |
|---|---|---|
| retCode | 错误码 | Integer |
| retData | 处理返回数据 | Integer |
| retMsg | 错误描述 | String |
retCode 说明
| retCode | 说明 |
|---|---|
| 200 | 接口处理成功 |
| 500 | 接口处理失败 |
| 其他code | 接口处理失败 |
成功示例
{
"code": "200",
"msg": "成功",
"retCode": "200",
"retData": null,
"retMsg": "成功"
}失败示例
{
"code": "500",
"msg": "错误原因",
"retCode": "500",
"retData": null,
"retMsg": "错误原因"
}失败原因
| retCode | retMsg |
|---|---|
| 801 | 非月结订单用户已托管费用，不可关单！ |
| 802 | 月结订单总包已报价，不可关单！ |
| 803 | 当前已指派师傅，无法关闭订单！ |
| 804 | 取消订单失败，此订单非系统对接订单！ |
| 805 | 取消订单失败，此账号无关单权限！ |
| 806 | 取消订单失败，此订单为其它账号所属订单！ |
答疑：
答：如果是总包月结订单，在总包报价前，可以正常通过该接口关单，如果已经报价，这个时候就无法通过接口关闭订单，只能通过联系客服进行关单。
修改于 2024-02-22 03:36:34