取消订单
取消酒店预订单
请求方式#
POST
uri: /reservation/cancel
Content-Type: application/json
请求参数说明#
RequestHeader#
RequestBody#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| resId | String | Y | 64 | 华住订单号 |
响应参数说明#
content#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| penaltyAmount | BigDecimal | N | - | 取消罚金，财务对账的参考字段 | |
| penaltyCurrencyCode | String | N | 8 | 取消罚金对应币种 |
响应码#
| 异常码 | 异常类型 | 说明 |
|---|---|---|
| 1000 | Success | |
| 5401 | Reservation cannot be cancelled | 订单不可取消 |
| 5402 | Reservation already cancelled | 预订已取消 |
| 5403 | Reservation not found | 未找到订单 |
| 5404 | Reservation not belong to requester | 订单与当前渠道不匹配 |
| 5405 | Reservation cannot be cancelled - service has started | 取消失败，订单已入住或离店 |
| 其他 | 全局异常码 | 全局异常[引用] |
报文示例#
Case1: 正常取消#
请求示例#
{ "resId":"R200031####135470001"}响应成功示例#
{ "code":1000}响应失败示例#
{ "code":5402, "message":"Reservation already cancelled"}