酒店

【国内酒店】限价类型接入指南更新时间:2025/07/17

业务介绍

    限价,顾名思义,就是限制售卖的价格,也就是最终售卖给客人的价格受到了限制。

    a.首先要通过报价的接口 (例如hotel.detail) 获取到产品的标准建议售卖价 (例如hotel.detail的Member字段) 及其限价的规则 (例如hotel.detail的PriceLimitedType字段)

      来确定最终卖给客人的价格。通俗简单的去理解,就是根据 PriceLimitedType 来确定,贵方销售给客人的价格应该 =Member, 或者 <=Member 或者 >=Member 

      或者 >Member 或者 <Member

    b.其次在成单、试单环节 (例如hotel.data.validate), 将贵方最终销售给客人的价格回传到我方的接口中。

    具体的接口细节如下


1、报价环节


    1.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时限价条件“不可返现”成立

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

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


    1.2、离线模式(该模式已废弃不建议使用)

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


2、订单环节

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

        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需不可大于当前限价产品卖价。

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


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

        1)hotel.order.create,

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

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

        

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

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

            变更为

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

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

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

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

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



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

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