酒店

【国内酒店】限价类型接入指南更新时间:2023/06/16

1、实时模式-搜索环节

    hotel.detail增加出参限价类型PriceLimitedType,Integer类型不可为空,用二进制bit位分别表示各个限价条件

    目前限价条件有3种:需要展示卖价(搜索模式取Basis展示、离线模式取Member/Weekend展示)不可抬价、不可立减、不可返现

    那么从右往左从一开始的三位分别是:

    第一位:0表示不需要展示卖价,1表示需要展示卖价 不可抬价(1)

    第二位:0表示可立减,1表示不可立减(2)

    第三位:0表示可返现,1表示不可返现(4)

    第四位:将来扩展

    第五位:...

    

    列举当前三位如下:

    000:表示可返现、可立减、不需要展示卖价 可抬价(此时出参PriceLimitedType为0,0时为不限价)

    001:表示可返现、可立减、需要展示卖价 不可抬价(此时出参PriceLimitedType为1)

    010:表示可返现、不可立减、不需要展示卖价 可抬价(此时出参PriceLimitedType为2)

    011:表示可返现、不可立减、需要展示卖价 不可抬价(此时出参PriceLimitedType为3)

    100:表示不可返现、可立减、不需要展示卖价 可抬价(此时出参PriceLimitedType为4)

    101:表示不可返现、可立减、需要展示卖价 不可抬价(此时出参PriceLimitedType为5)

    110:表示不可返现、不可立减、不需要展示卖价 可抬价(此时出参PriceLimitedType为6)

    111:表示不可返现、不可立减、需要展示卖价 不可抬价(此时出参PriceLimitedType为7)

    

    判断限价类型成立的方法:

    PriceLimitedType&1==1时限价条件“需要展示卖价 不可抬价”成立

    PriceLimitedType&2==2时限价条件“不可立减”成立

    PriceLimitedType&4==4时限价条件“不可返现”成立

    将来新增限价条件种类,之前限价条件判断方式不会变化。

    如果是限价产品,但是不符合当前已定义限价条件时,建议过滤处理。


2、离线模式

    hotel.data.rp、hotel.data.rate、hotel.incr.rate增加出参PriceLimitedType,Integer类型不可为空,用二进制bit位分别表示各个限价条件,定义同上


3、订单环节

    当是卖价返佣分销商时,如果是限价产品,

    1)hotel.order.create、hotel.data.validate,

        校验入参总价TotalPrice需与限价产品卖价Member相等,

        否则返回异常码:由 H001174|客人实付金额需等于限价产品卖价 变更为 H001181|总价TotalPrice需等于当前限价产品卖价。

    2)hotel.order.create,新增校验,

        需将客人实付金额CustomerPrice传入,

        否则返回异常码:H001173|限价产品CustomerPrice不能为空;

        若当前产品“不可立减”时,需要CustomerPrice大于等于限价产品卖价Member,

        否则返回异常码:H001182|客人实付金额CustomerPrice需等于限价产品卖价   H001184|客人实付金额CustomerPrice需不可小于当前限价产品卖价

        若当前产品“不可抬价”时,需要CustomerPrice小于等于限价产品卖价Member,即对客销售金额不可超过限价产品卖价,

        否则返回异常码:H001180|客人实付金额CustomerPrice需不可大于当前限价产品卖价。

        注意:如果产品既是不可抬价又是不可立减时,以上两者都会校验


    当是结算价分销商时,如果是限价产品,

    1)hotel.order.create,

        入参客人实付金额CustomerPrice的必填校验不变,

        否则返回异常码:H001173|限价产品CustomerPrice不能为空;

        

        CustomerPrice与限价产品卖价Member相等,

        否则返回异常码:H001174|客人实付金额需等于限价产品卖价。

        变更为

        若当前产品“不可立减”时,需要CustomerPrice大于等于限价产品卖价Member,

        否则返回异常码:H001182|客人实付金额CustomerPrice需等于限价产品卖价    H001184|客人实付金额CustomerPrice需不可小于当前限价产品卖价;

        若当前产品“不可抬价”时,需要CustomerPrice小于等于限价产品卖价Member,即对客销售金额不可超过限价产品卖价,

        否则返回异常码:H001180|客人实付金额CustomerPrice需不可大于当前限价产品卖价。

        注意:如果产品既是不可抬价又是不可立减时,以上两者都会校验



注:接入完成后通知商务,新校验规则生效。

原展示卖价逻辑更新为:不可抬价,会于近期上线 已上线,未接入分销商可暂缓接入 可接入。