文档中心 > International Hotel

询价试单接口-取消政策详解

更新时间:2024/07/31 访问次数:940

1. 取消政策概念定义

飞猪国际酒店目前几种常用取消政策表达如下

  1. 不可取消

  1. 限时取消:此类型按照具体的取消政策扣款金额来分段,每一段的时间和金额可以自行修改,以2段、3段举例如下:

    • 分2段(常用):入住日当天x点的A小时前免费取消/扣a金额取消,A小时后不可取消(扣全款)

    • 分3段:入住日当天x点的A小时前免费取消/扣a金额取消,B小时前扣取b金额取消,B小时后不可取消(扣全款)

    • 分n段:参考分3段

思维导图:

1.1. 不可取消

若不可取消,则询价和试单中<Refundable>字段需要传false

NOTE:

不可取消场景无需CancelPolicyInfos字段,否则会报错

1.2. 限时取消

限时取消场景下,<Refundable>字段需要传true,同时需要CancelPolicyInfos字段。

NOTE:

<CancelPolicyInfos>代码块中<NightCount>表示房晚,也可以替换为<Amount>金额。注意二选一使用,混用会导致报错。

1.2.1. 分2段:入住日当天x点的A小时前免费取消/扣a金额取消,A小时后不可取消(扣全款)

第一段:时间最晚、离入住日最近的一段
<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>              当天x点
        <StartWindowHours>0</StartWindowHours>      必须为0
        <NightCount>1</NightCount>                 扣全额:订单完整晚数
        <TimeZone>+08:00</TimeZone>                 酒店所在时区
        <CurrencyCode>CNY</CurrencyCode>            报价币种
    </CancelPolicyInfo>

第二段:时间最早的那段
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>            当天x点,与上一段canceltime保持一致
        <StartWindowHours>48</StartWindowHours>     A小时
        <NightCount>0</NightCount>                  免费则为0/扣a金额则换算a对应房晚
        <TimeZone>+08:00</TimeZone>。               酒店所在时区
        <CurrencyCode>CNY</CurrencyCode>           报价币种
    </CancelPolicyInfo>
</CancelPolicyInfos>

【具体示例】

日本酒店,5.10~5.12日连住2晚,总房费24000(JPY)

5.5日0点之前取消扣首晚房费(12000JPY)

5.5日0点之后取消扣全额房费

<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>00:00</CancelTime>
        <StartWindowHours>0</StartWindowHours>
        <NightCount>2</NightCount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
    <CancelPolicyInfo>
        <CancelTime>00:00</CancelTime>
        <StartWindowHours>120</StartWindowHours>
        <NightCount>1</NightCount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
</CancelPolicyInfos>
<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>00:00</CancelTime>
        <StartWindowHours>0</StartWindowHours>
        <Amount>24000</Amount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
    <CancelPolicyInfo>
        <CancelTime>00:00</CancelTime>
        <StartWindowHours>120</StartWindowHours>
        <Amount>12000</Amount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
</CancelPolicyInfos>

1.2.2. 分3段:入住日当天x点的A小时前免费取消/扣a金额取消,B小时前扣取b金额取消,B小时后不可取消(扣全款)

第一段:时间最晚、离入住日最近的一段
<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>             当天x点
        <StartWindowHours>0</StartWindowHours>     必须为0
        <NightCount>2</NightCount>                 扣全额:订单完整晚数
        <TimeZone>+08:00</TimeZone>                酒店所在时区
        <CurrencyCode>CNY</CurrencyCode>           报价币种
    </CancelPolicyInfo>

第二段:中间那段,B小时前扣取b金额取消
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>            当天x点,与上一段canceltime保持一致
        <StartWindowHours>48</StartWindowHours>   B小时
        <NightCount>1</NightCount>                扣b金额则换算b对应房晚
        <TimeZone>+08:00</TimeZone>。             酒店所在时区
        <CurrencyCode>CNY</CurrencyCode>          报价币种
    </CancelPolicyInfo>
</CancelPolicyInfos>

第三段:时间最早的那段
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>            当天x点,与上一段canceltime保持一致
        <StartWindowHours>72</StartWindowHours>   A小时
        <NightCount>0</NightCount>                免费则为0/扣a金额则换算a对应房晚
        <TimeZone>+08:00</TimeZone>。             酒店所在时区
        <CurrencyCode>CNY</CurrencyCode>          报价币种
    </CancelPolicyInfo>
</CancelPolicyInfos>

【具体示例】

日本酒店,5.10~5.15日连住5晚,总房费60000(JPY)

5.1日12点之前免费取消

5.5日12点前取消扣首晚房费(12000JPY)

5.5日12点之后取消扣全额房费(60000JPY)。

<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>12:00</CancelTime>
        <StartWindowHours>0</StartWindowHours>
        <NightCount>5</NightCount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
    <CancelPolicyInfo>
        <CancelTime>12:00</CancelTime>
        <StartWindowHours>120</StartWindowHours>
        <NightCount>1</NightCount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
</CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>12:00</CancelTime>
        <StartWindowHours>216</StartWindowHours>
        <NightCount>0</NightCount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
</CancelPolicyInfos>
<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>12:00</CancelTime>
        <StartWindowHours>0</StartWindowHours>
        <Amount>60000</Amount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
    <CancelPolicyInfo>
        <CancelTime>12:00</CancelTime>
        <StartWindowHours>120</StartWindowHours>
        <Amount>12000</Amount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
</CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>12:00</CancelTime>
        <StartWindowHours>216</StartWindowHours>
        <Amount>0</Amount>
        <TimeZone>+09:00</TimeZone>
        <CurrencyCode>JPY</CurrencyCode>
    </CancelPolicyInfo>
</CancelPolicyInfos>

FAQ

关于此文档暂时还没有FAQ
返回
顶部