差异单通知&审核结果回调
当华住酒店店长发起差异单申请,华住会主动通知渠道商。 当渠道商提交差异单申请,华住店长审核后,华住会将结果回调给渠道商。
请求方式#
POST
Content-Type: application/json
请求参数说明#
场景一:差异单审核回调#
RequestHeader#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| method | String | Y | 64 | - | 固定传:disresv.review |
RequestBody#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hotelId | String | Y | 32 | 12**567 | 酒店ID |
| resId | String | Y | 64 | R200031####135470001 | 预订成功华住产生的订单ID |
| discrepancyNo | String | Y | 64 | 92208df7385745f79c3ee20ebeea0dbe | 差异单单号 |
| reviewStatus | Integer | Y | - | 3 | 差异单审核状态(2,同意;3,拒绝) |
| refuseReason | String | N | 1024 | 非合理请求 | 差异单拒绝原因 |
| auditor | String | N | 64 | Huazhu | 审核方 |
场景二:新建取消类型差异单通知#
RequestHeader#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| method | String | Y | 64 | - | 固定传:disresv.init.cancel |
RequestBody#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hotelId | String | Y | 32 | 12**567 | 酒店id |
| resId | String | Y | 64 | R200031####135470001 | 预订成功华住产生的订单ID |
| initiator | String | Y | 32 | HOTA | 发起方 |
| applyReason | String | Y | 1024 | 客人强烈要求不住了 | 差异申请原因 |
| discrepancyNo | String | Y | 64 | 92208df7385745f79c3ee20ebeea0dbe | 差异单单号 |
场景三:新建修改类型差异单通知#
RequestHeader#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| method | String | Y | 64 | - | 固定传:disresv.init.modify |
RequestBody#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hotelId | String | Y | 32 | 12**567 | 酒店id |
| resId | String | Y | 64 | R200031####135470001 | 预订成功华住产生的订单ID |
| initiator | String | Y | 32 | HOTA | 发起方 |
| applyReason | String | Y | 1024 | 客人要提前离店 | 差异申请原因 |
| priceChanged | Boolean | Y | - | true | 每日价是否改变(加收罚金true,不收罚金每日价保持一致false) |
| adjustCheckOutDate | Date | N | - | 2021-10-12 | 实际离店日期 格式:yyyy-MM-dd |
| discrepancyNo | String | Y | 64 | 92208df7385745f79c3ee20ebeea0dbe | 差异单单号 |
| dailyDiscrepancy | DiscrepancyInfoDTO | Y | - | - | 差异信息 |
DiscrepancyInfoDTO#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| totalOriginalRoomNights | Integer | Y | - | 3 | 总原间夜数 |
| totalAdjustRoomNights | Integer | Y | - | 2 | 总调整后间夜数 |
| totalOriginalRoomPrice | BigDecimal | Y | - | 999.00 | 原房间总价 |
| totalAdjustRoomPrice | BigDecimal | Y | - | 666.00 | 调整后房间总价 |
| dailyDiscrepancyList | List<DailyDiscrepancy> | Y | - | - | 每日差异信息 |
DailyDiscrepancy#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| bizDate | Date | Y | - | 2021-10-11 | 日期 格式:yyyy-MM-dd |
| roomCount | Integer | Y | - | 1 | 房间数 |
| marketPrice | BigDecimal | Y | - | 350.00 | 门市价 |
| originalRoomPrice | BigDecimal | Y | - | 333.00 | 原房间单价 |
| adjustRoomPrice | BigDecimal | Y | - | 333.00 | 调整后房价 |
| originalDailyAmount | BigDecimal | Y | - | 333.00 | 原当天房费总计(房间数* 原房间单价) |
| adjustDailyAmount | BigDecimal | Y | - | 333.00 | 调整后房费总计(房间数* 调整后房间单价) |
场景四:差异单撤销回调#
RequestHeader#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| method | String | Y | 64 | disresv.cancel | 固定传值:disresv.cancel |
RequestBody#
| 参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| hotelId | String | Y | 32 | 12**567 | 酒店ID |
| resId | String | Y | 64 | R200031####135470001 | 预订成功华住产生的订单ID |
| discrepancyNo | String | Y | 64 | 92208df7385745f79c3ee20ebeea0dbe | 差异单单号 |
| canceler | String | Y | 64 | Huazhu | 撤销方 |
请求示例#
请求报文#
通知类型默认采用POST类型,样例如下:
curl --location --request POST 'https://www.thisisotadomainsample.com' \--header 'method: disresv.review' \--header 'Content-Type: application/json' \--data-raw '{ "hotelId": "2000827", "resId": "R2000827062607579001", "discrepancyNo": "e26a036567cc41999349bf3ad366ae32", "reviewStatus": 3, "refuseReason": "非合理请求", "auditor": "12**567"}'