新建修改类型差异单
OTA侧新建差异单申请,差异单类型为"修改"。
#
请求方式POST
uri: /disresv/init/modify
Content-Type: application/json
#
请求参数说明#
RequestHeader#
RequestBody参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
---|---|---|---|---|---|
hotelId | String | Y | 32 | 12**567 | 酒店id |
resId | String | Y | 64 | R200031####135470001 | 预订成功华住产生的订单ID |
applyReason | String | Y | 1024 | 客人要提前离店 | 差异申请原因 |
adjustedCheckOutDate | Date | Y | - | 2021-10-12 | 实际离店日期 格式:yyyy-MM-dd |
addPenalty | Integer | N | - | 1 | 是否加收违约金(0-否 1-是),如不需要加收违约金,每日价与原订单保持一致 |
dailyDiscrepancy | DiscrepancyInfoDTO | Y | - | - | 差异信息 |
notifyUrl | String | 128 | N | https://www.example.com | 回调地址,有需要时填写,不填默认使用OTA注册时配置的默认地址 |
notifyType | String | 16 | N | 回调类型(GET/POST),默认POST类型 | POST |
#
DiscrepancyInfoDTO参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
---|---|---|---|---|---|
totalOriginalRoomNights | Integer | Y | - | 3 | 总原间夜数 |
totalAdjustedRoomNights | Integer | Y | - | 2 | 总调整后间夜数 |
totalOriginalRoomPrice | BigDecimal | Y | - | 999.00 | 原房间总价 |
totalAdjustedRoomPrice | BigDecimal | Y | - | 666.00 | 调整后房间总价 |
totalAdjustedAmount | BigDecimal | Y | - | 333.00 | 笤帚预订单总价 |
dailyDiscrepancyList | List<DailyDiscrepancy> | Y | - | - | 每日差异信息 |
#
DailyDiscrepancy参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
---|---|---|---|---|---|
bizDate | Date | Y | - | 2021-10-11 | 日期 格式:yyyy-MM-dd |
marketPrice | BigDecimal | Y | - | 350.00 | 门市价 |
originalRoomCount | Integer | Y | - | 1 | 原房间数 |
originalRoomPrice | BigDecimal | Y | - | 333.00 | 原房间单价 |
originalDailyAmount | BigDecimal | Y | - | 333.00 | 原当天房费总计(房间数* 原房间单价) |
adjustedRoomCount | Integer | Y | - | 1 | 调整后房间数 |
adjustedRoomPrice | BigDecimal | Y | - | 333.00 | 调整后房价 |
adjustedDailyAmount | BigDecimal | Y | - | 333.00 | 调整后房费总计(房间数* 调整后房间单价) |
additionalDailyAmount | BigDecimal | Y | - | 0.00 | 加收违约金 |
#
响应参数说明#
content参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
---|---|---|---|---|---|
hotelId | String | Y | 32 | 12**567 | 酒店id |
discrepancyNo | String | Y | 32 | e26a036567cc41999349bf3ad366ae32 | 差异单单号 |
#
响应码异常码 | 异常类型 | 说明 |
---|---|---|
1000 | Success | |
6301 | Reservation not found | 订单不存在 |
6302 | Invalid reservation status | 订单状态异常 |
6303 | Invalid discrepant reservation status | 差异单状态异常 |
6304 | Discrepant reservation not support | 渠道不支持差异单 |
6305 | Penalty not support | 渠道不支持违约金 |
6306 | Invalid adjusteded checkout date | 调整日期不符合规则 |
其他 | 全局异常码 | 全局异常[引用] |
#
报文示例#
请求示例{ "hotelId": "12**567", "resId": "R200031####135470001", "applyReason": "zpy-test", "addPenalty": 1, "adjustedCheckOutDate": "2021-09-14", "discrepancyInfo": { "dailyDiscrepancyList": [ { "additionalDailyAmount": 0, "adjustedDailyAmount": 84.00, "adjustedRoomCount": 1, "adjustedRoomPrice": 84.00, "bizDate": "2021-09-13", "marketPrice": 0.00, "originalDailyAmount": 84.00, "originalRoomCount": 1, "originalRoomPrice": 84.00 }, { "additionalDailyAmount": 0, "adjustedDailyAmount": 0, "adjustedRoomCount": 0, "adjustedRoomPrice": 0, "bizDate": "2021-09-14", "marketPrice": 0.00, "originalDailyAmount": 84.00, "originalRoomCount": 1, "originalRoomPrice": 84.00 }, { "additionalDailyAmount": 0, "adjustedDailyAmount": 0, "adjustedRoomCount": 0, "adjustedRoomPrice": 0, "bizDate": "2021-09-15", "marketPrice": 0.00, "originalDailyAmount": 84.00, "originalRoomCount": 1, "originalRoomPrice": 84.00 } ], "totalAdjustedAmount": 0, "totalAdjustedRoomNights": 1, "totalAdjustedRoomPrice": 84.00, "totalOriginalRoomNights": 3, "totalOriginalRoomPrice": 252.00 }, "notifyUrl": "https://www.example.com", "notifyType": "POST"}
#
响应示例{ "code": 1000, "content": { "discrepancyNo": "bdf045dd1a4344e5a7e829c1e1e87064", "hotelId": "1000323" }}