差异单通知&审核结果回调

当华住酒店店长发起差异单申请，华住会主动通知渠道商。当渠道商提交差异单申请，华住店长审核后，华住会将结果回调给渠道商。

请求方式#

POST

Content-Type: application/json

响应参数#

方式一: 推荐#

参数	类型	是否必填	最大长度	示例	描述
status	String	Y	10	1	状态码，1成功，-1失败
errorcode	string	N	50		对接方自行定义
errormsg	string	N	500		对接方自行定义，需描述清楚问题原因

方式二: 历史版本过渡，不建议使用#

仅接收字符串success表示成功，大小写敏感，其他均为失败

请求参数说明#

场景一：差异单审核回调#

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"
}'

接收结果示例#

接收推送成功示例#

{
    "status":1,
    "errorcode":"",
    "errormsg":""
}

结束推送失败示例#

{
    "status":-1,
    "errorcode":"12",
    "errormsg":"酒店不可用"
}