文档中心 > International Hotel

How to Format the CancelPolicy Code In the HotelRooms and RoomAvailability Interface

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

1. Definition of CancelPolicy

Currently, there are several commonly used expressions for cancellation policies for international hotels on Fliggy:

  • Non-Refundable

  • Limited-Time Refundable:

This type is divided based on specific cancellation policy deduction amounts. Each segment of time and amount can be modified independently. Examples of 2 segments and 3 segments are as follows:

    • 2 Segments (Commonly Used): Free cancellation/charge a night/amount before A hours on the day of check-in, non-refundable (full charge) after A hours

    • 3 Segments: Free cancellation/charge a night or amount before A hours on the day of check-in, charge b night or amount before B hours, non-refundable (full charge) after B hours

    • N Segments: Refer to 3 segments

Mind Map

1.1. Non-Refundable

If Non-Refundable, the field <Refundable> in the HotelRooms and RoomAvailability interface needs to be set to false.

NOTE:

In the Non-Refundable scenario, the CancelPolicyInfos field is not required, otherwise an error will occur.

1.2. Limited-Time Refundable

In the limited-Time Refundable scenario, the field<Refundable> in the HotelRooms and RoomAvailability interface needs to be set to true, and CancelPolicyInfos field is also required.

NOTE:

The <NightCount> in <CancelPolicyInfos> code block represents room night and it can also be replaced with <Amount>. Please use either one at one CancelPolicyInfos , using both of them will result in an error.?

1.2.1. 2 Segments (Commonly Used)

Free cancellation/charge a night/amount before A hours on the day of check-in, Non-Refundable (full charge) after A hours

The first segment:the latest time and also the closest to the check-in date
<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>              x o'clock of check-in date
        <StartWindowHours>0</StartWindowHours>      must be 0
        <NightCount>1</NightCount>                  the night/amount need to be charged
        <TimeZone>+08:00</TimeZone>                 timezone of hotel
        <CurrencyCode>CNY</CurrencyCode>            currency code of price
    </CancelPolicyInfo>

The second segment:the earliest time and also the farthest to the check-in date
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>              x o'clock of check-in date,should be the same as it in first segment
        <StartWindowHours>48</StartWindowHours>     A hours 
        <NightCount>0</NightCount>                  if free cancel then 0, if charge a night/amount than a
        <TimeZone>+08:00</TimeZone>                 timezone of hotel
        <CurrencyCode>CNY</CurrencyCode>            currency code of price
    </CancelPolicyInfo>
</CancelPolicyInfos>

【Example】

Japanese hotel (+09:00)

Stay for 2 nights from May 10th ~ May 12th, total price 24000 (JPY).
If cancel before 0:00 on May 5th, then the first night's roomprice will be charged(12000 JPY).
If cancel after 0:00 on May 5th, then full roomprice will be charged(24000 JPY).

<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 Segments

Free cancellation/charge a night or amount before A hours on the day of check-in,

Charge b night/amount before B hours,

Non-Refundable (full charge) after B hours

The first segment:the latest time and also the closest to the check-in date
<CancelPolicyInfos>
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>             x o'clock of check-in date
        <StartWindowHours>0</StartWindowHours>     must be 0
        <NightCount>2</NightCount>                 the whole nights/amount of this order
        <TimeZone>+08:00</TimeZone>                timezone of hotel
        <CurrencyCode>CNY</CurrencyCode>           currency code of price
    </CancelPolicyInfo>

The second segment: charge b night/amount before B hours
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>            x o'clock of check-in date,should be the same as it in first segment
        <StartWindowHours>48</StartWindowHours>   B hour
        <NightCount>1</NightCount>                charge b night/amount
        <TimeZone>+08:00</TimeZone>。             timezone of hotel
        <CurrencyCode>CNY</CurrencyCode>          currency code of price
    </CancelPolicyInfo>
</CancelPolicyInfos>

The third segment:the earliest time and also the farthest to the check-in date
    <CancelPolicyInfo>
        <CancelTime>16:00</CancelTime>            x o'clock of check-in date,should be the same as it in first segment
        <StartWindowHours>72</StartWindowHours>   A hour
        <NightCount>0</NightCount>                if free cancel then 0, if charge a night/amount than a
        <TimeZone>+08:00</TimeZone>。             timezone of hotel
        <CurrencyCode>CNY</CurrencyCode>          currency code of price
    </CancelPolicyInfo>
</CancelPolicyInfos>


【Example】

Japanese hotel (+09:00)

Stay for 5 nights from May 10th ~ May 15th, total room charge 60000 (JPY).
Free cancellation before 12:00 on May 1st.
If cancel before 12:00 on May 5th, then the first night's roomprice will be charged (12000 JPY).
If cancel after 12:00 on May 5th, then the whone roomprice will be charge (60000 JPY).

<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
返回
顶部