酒店通用分销
方法名称
taobao.xhotel.order.distribution.cancel
使用说明
概述
取消订单接口。订单状态推进到确认有房后，分销商发起的取消操作可能存在罚金，具体以退改政策为准。
取消订单流程
注意事项
- 确认支付接口支持幂等。如出现网络抖动等因素导致未接收到调用结果，分销商需要重试【取消订单】或查询【订单详情】获取订单最新状态。
- 当接口返回成功时，订单取消成功。当接口返回失败时，返回错误信息到分销商。分销商可识别错误码做相应操作。
- 取消订单成功后，飞猪会发送【状态变更消息】通知分销商，订单状态变为已关闭/已取消。
- 罚金金额请以订单详情接口返回为准。
API入参
字段 |
类型 |
可为空 |
示例值 |
描述 |
dis_order_id |
String |
N |
4564658412 |
外部分销订单号，飞猪订单号与外部订单号不能都为空 |
distributor |
String |
N |
hello |
分销渠道 |
fliggy_order_id |
Number |
N |
飞猪订单号，飞猪订单号与外部订单号不能都为空 |
API出参
字段 |
类型 |
可为空 |
示例值 |
描述 |
result |
Object |
Y |
取消请求响应 |
|
is_success |
Boolean |
N |
true |
请求是否成功 |
error_msg |
String |
Y |
该订单不属于此分销渠道，不可操作 |
错误信息 |
error_resp_code |
Number |
Y |
111 |
错误码 |
msg_for_dev |
String |
Y |
开发查看的错误信息 |
result节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
cancel_success |
Boolean |
N |
是否取消成功 |
|
forfeit_fee |
Number |
N |
100 |
罚金金额，单位：分 |
常见错误
错误码 |
解释 |
解决方案 |
101 |
飞猪订单号与外部分销订单号不能都为空 |
检查请求参数是否符合要求 |
102 |
分销渠道信息不能为空 |
检查请求参数是否符合要求 |
112 |
请求参数有误 |
检查请求参数是否符合要求 |
214 |
当前订单状态不支持取消 |
检查订单状态，如需强制取消，联系飞猪业务同学 |
215 |
当前订单按退订政策不允许取消哦 |
检查退改政策，如需强制取消，联系飞猪业务同学 |
223 |
订单申请取消中 |
订单取消中，等待卖家确认，请等待 |
305 |
订单取消失败，请稍后重试 |
系统异常，请重试 |
回复
