酒店-取消订单
基本信息
Path： /hotel/cancelOrder
Method： POST
使用说明
- 当订单提交成功后返回的结果中CancelTime属性，当时间在CancelTime的时间之前，可以通过本接口取消该订单；如果是担保预付订单，请遵循担保预付规则中关于取消的条款。
- 取消成功订单是可能存在罚金的，请请求订单详情接口查询罚金属性。
新单、满房、特殊满房、变价状态可无视担保预付规则直接取消；当为满房、特殊满房、变价状态时请调用取消订单接口，进行取消；已确认状态需要根据担保预付规则判断能否取消；已审状态时即时确认订单需根据担保预付规则判断能否取消，非即时确认订单可无视担保预付规则直接取消。
请求参数
Headers
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| Content-Type | application/json | 是 | ||
| x-lvcang-api-account | 开放平台分配 | 是 | aaa.test |
Body
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| orderId | number | 必须 | |
| lcOrderId | string | 必须 | 旅仓订单号 |
| affiliateConfirmationId | string | 必须 | 联盟订单号 |
| reason | string | 必须 | 取消具体原因 |
| cancelCode | string | 非必须 | 取消类型 示例: 对酒店相关条件不满意、航班推迟、价格过高、客人不接受、通过其它途径预订、行程变更、已换酒店、重单、其它 |
| penaltyAmount | number | 必须 | 取消罚金 0，默认值，不做取消罚金校验，能取消就取消，有罚金也取消，以接口计算的罚金为准。 -1，若取消需要收取罚金就不取消，无罚金则取消。 大于0，校验取消罚金，需要与平台的罚金相等才取消，否则拒绝取消。 |
返回数据
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | number | 非必须 | 状态码 0-成功 500-失败 |
| message | string | 非必须 | 返回信息 |
| success | boolean | 非必须 | 请求是否成功 |
| data | object | 非必须 | 返回内容 |
| ├─ successs | boolean | 非必须 | 取消结果 |
| ├─ penaltyAmount | number | 非必须 | 取消罚金 |
| guid | string | 非必须 |