方法名称
hotel.order.cancel
使用说明
当订单提交成功后返回的结果中CancelTime属性，当时间在CancelTime的时间之前，可以通过本接口取消该订单；如果是担保预付订单，请遵循担保预付规则中关于取消的条款。
取消成功订单是可能存在罚金的，请求订单详情接口查询罚金属性。当订单状态处于取消状态超过48小时需联系艺龙客服跟进取消结果。
新单、满房、特殊满房、变价状态可无视担保预付规则直接取消；当为满房、特殊满房、变价状态时请调用取消订单接口，进行取消；已确认状态需要根据担保预付规则判断能否取消；已审状态时即时确认订单需根据担保预付规则判断能否取消，非即时确认订单可无视担保预付规则直接取消。
更为细致的使用说明请前往以下链接查看：http://open.elong.com/faq/detail?id=122&plt=2
须使用https访问本接口。
输入参数
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| OrderId | 订单编号 | Long | N | |
| CancelCode | 取消类型 | String(10) | N | 示例: 对酒店相关条件不满意 航班推迟 价格过高，客人不接受 通过其它途径预订 行程变更 已换酒店 重单 其它 |
| Reason | 具体原因 | String(50) | Y | |
| PenaltyAmount | 取消罚金 | Decimal | Y | 1.32版添加 0，默认值，不做取消罚金校验，能取消就取消，有罚金也取消，以艺龙接口计算的罚金为准 -1，若取消需要收取罚金就不取消，无罚金则取消 大于0，校验取消罚金，需要与艺龙的罚金相等才取消，否则拒绝取消 |
响应结果
| 节点 | 名称 | 类型 | 可为空 | 说明 |
|---|---|---|---|---|
| Successs | 取消请求处理结果 | Boolean | N | 注意，是三个s。 此处返回true的时候表示艺龙已经收到了请求，是否能够退款需要查看订单详情中的refundDetail节点 |
| PenaltyAmount | 取消罚金 | Decimal | Y | 1.32版添加 取消罚金值 |
输入示例
https://api-test.elong.com/rest?format=json&method=hotel.order.cancel
&user={userid}×tamp=1488508207&signature=1b34c24f5c31381a67c666f4dc211077
&data={"Version":"1.28","Local":"zh_CN","Request":{"OrderId":"1234567","CancelCode":"行程变更"}}
输出示例
{
"Code":"0",
"Result":{
"Successs": true
}
"Guid":"196d84d9-19b1-4aa2-8891-1c699e806a3c"
}
{
"Code": "H001094|取消订单失败:非常抱歉，您的订单酒店已确认入住，无法取消，如您仍需取消，请联系同程艺龙客服。",
"Result": {
"Successs": false
},
"Guid": "17787e35-8dd7-44e3-afc4-afee0a1475b5"
}
{
"Code": "H001094|取消订单失败:非常抱歉，您的订单已超过最晚取消时间，不能操作取消。",
"Result": {
"Successs": false
},
"Guid": "f1589c5d-b9ef-439b-9043-1ee30f2cc44a"
}
注意事项
如果是担保订单或预付订单，取消时候注意罚金；退款给客人的时候，需要查看订单详情的refundDetail节点。
常见错误码
| 错误码 | 解释 | 解决方法 |
|---|---|---|
| H001094 | 取消订单失败:{底层返回文案} | 检查订单是否可以取消，可以调用hotel.order.detail查看 |
| H001053 | 订单号必须填写 | 订单号必须填写 |
| H001054 | 订单ID错误，订单号不存在 | 订单ID错误，订单号不存在 |
| H001055 | 订单ID错误! OrderFrom不一致 | 订单ID错误! OrderFrom不一致 |
| H001056 | 订单已经处于取消状态 | 检查订单状态，可以调用hotel.order.detail查看 |
| H001151 | 订单已审，正在确认中，暂时不允许取消 | 检查订单状态，可以调用hotel.order.detail查看 |
| H001139 | 取消罚金不一致 | 取消接口罚金不足,应为:{0}，罚金值与艺龙计算罚金值不一致 |