환불액을 예상할 때는 항상 'cancelPolicyInfoList'에 입력된 데이터를 확인해야 합니다.

고객이 호텔의 취소 정책 기간 이내에 취소를 하는 경우 먼저 취소 위약금을 계산하여 'ChargeableRateInfo(부과 가능 요금 정보)'의 '총계' 특성에서 차감합니다.

고객이 정책 기간이 지나 취소하는 경우 'ChargeableRateInfo(부과 가능 요금 정보)''총계' 특성 값을 예상 환불액으로 반환합니다.

고객에게 표시할 예상 금액을 반환할 때는 항상 명시적 또는 묵시적 보증 없이 예상 금액만 설명하는 명확한 메시지를 사용해야 합니다. 요금보증 프로그램 조정 내역, 최초 예약 이후 적용된 할인 등은 API에서 처리할 수 없습니다.

상담원이 지원되는 EAN 고객만 정확한 환불 금액을 확인할 수 있습니다. 해당 지역의 지원 번호로 전화를 걸어 정확한 금액을 알 수 있습니다.

예상 취소 위약금 계산 및 적용

이 섹션은 cancelPolicyInfoList에 포함된 정보에 대해 설명합니다. 환불 예상을 구현하기 전에 이 배열의 전체 구조를 충분히 살펴봐야 합니다. 취소에 위약금이 적용되는지 확인하려면 두 번째 'cancelPolicyInfo' 노드에서 'startWindowHours' 요소 값을 먼저 확인하세요.

취소 요청 시간이 이 기간에 해당하면 예상액에서 위약금을 차감하여 계산해야 합니다. 이 기간에 해당하지 않으면 처음에 청구된 총 금액을 예상액으로 반환합니다.

위약금을 계산하려면 첫 번째 '`cancelPolicyInfo' 노드에 반환된 위약금 세부 항목의 값을 참조하세요.

예:

<CancelPolicyInfoList>
 <CancelPolicyInfo>
   <versionId>206071749</versionId>
   <cancelTime>19:00:00</cancelTime>
   <startWindowHours>0</startWindowHours>
   <amount>50</amount>
   <currencyCode>USD</currencyCode>
   <timeZoneDescription>(GMT-06:00) 중부 표준시(미국 &amp; 캐나다)</timeZoneDescription>
 </CancelPolicyInfo>
 <CancelPolicyInfo>
  <versionId>208751445</versionId>
  <cancelTime>19:00:00</cancelTime>
  <startWindowHours>48</startWindowHours>
  <amount>0</amount>
  <currencyCode>USD</currencyCode>
  <timeZoneDescription>(GMT-06:00) 중부 표준시(미국 &amp; 캐나다)</timeZoneDescription>
</CancelPolicyInfo>
</CancelPolicyInfoList>

두 번째 노드의 'startWindowHours'가 '48' 값으로 반환되었습니다. 고객이 숙박을 시작하기 46시간 전에 취소합니다. 예약 시점에 청구된 총계에서 미화 50달러를 차감하고 예상액을 적절히 계산할 수 있습니다.

'cancelPolicyInfo' 노드에는 '총계', '비율' 또는 'nightCount'가 개별적으로 포함되어 있거나 '총계' & 'nightCount' 또는 '총계' & '비율' 조합이 포함되어 있을 수 있습니다.

단일 노드 내에서 그 외의 다른 조합은 유효하지 않으며 오류로 간주될 수 있습니다. 비어 있거나 '0'으로 반환된 요소는 정책 계산에 해당되지 않으므로 무시하세요.

정책은 기간이 지났을 때와 지나지 않았을 때 모두 위약금이 발생할 수 있습니다(첫 번째와 두 번째 노드의 양수). 일반적이지는 않지만 위의 설명과 같이 위약금 값의 조합이 유효하면 전체 정책 또한 유효합니다.

위약금 계산 및 예제

이 위약금 예제에서는 API에서 가능한 모든 유효한 조합을 다룹니다. 대부분의 경우 정책 기간 내에 이루어진 취소에 대해서만 위약금을 계산해야 합니다. 하지만 경우에 따라 정책 기간이 지나 이루어진 취소에 대해서도 위약금을 계산해야 합니다. 이 페이지의 마지막 예제를 참조하세요.

개별 숙박 요금에 대한 세금을 계산할 때는 total이 아니라 nightlyRateTotal을 사용하여 세금 비율을 계산해야 합니다. 이렇게 하면 예상액을 수립하는 데 도움이 되며 EAN에서 환불에 대한 세금을 계산하는 방식과 다릅니다.


숙박 위약금 계산에서 빼는 세금 값은 총 값이 아니라 1박 기준 입니다.

아래의 모든 예제에 대해서는 다음 요금과 총계를 참조하세요.

<ChargeableRateInfo {truncated} total="983.34" nightlyRateTotal="816.05">
    <NightlyRatesPerRoom size="2">
        <NightlyRate baseRate="400.58" rate="400.58" promo="false"></NightlyRate>
        <NightlyRate baseRate="415.47" rate="415.47" promo="false"></NightlyRate>
    </NightlyRatesPerRoom>
<Surcharges size="1">
    <Surcharge type="TaxAndServiceFee" amount="167.29"></Surcharge>
</Surcharges>

취소 위약금 '금액' 값이 '50'인 환불 계산

  • '총계 - 금액'
  • '983.34' - '50=' '933.34' 예상 환불액

취소 위약금 '비율' 값이 '25'인 환불 계산

  • '총계 - (총계의 %)'
  • '983.34 - (983.34의 25%)'= '737.50' 예상 환불액

취소 위약금 'nightCount' 값이 '1'인 환불 계산

  • '총계 - (첫째 날 밤 요금 값 + 첫째 날 밤 세금)'
  • '983.34 - (400.58 + 82.12)=' '500.64' 예상 환불액

취소 위약금 'nightCount' 값이 '2'인 환불 계산

  • '총계 - ([첫째 날 밤 요금 값 + 첫째 날 밤 세금] + [둘째 날 밤 요금 값 + 둘째 날 세금])'
  • '983.34 - ([400.58 + 82.12] + [415.47 + 85.17]) =' '0.00' (위약금 계산 후 환불액 없음)

취소 위약금 '금액' 값이 '20'이며 '비율' 값이 '10'인 환불 계산

  • '총계 - 금액 - (총계의 %)'
  • '983.34 - 20 - (983.34의 10%)=' '865.01' 예상 환불액

취소 위약금 금액 값이 '30'이며 'nightCount' 값이 '1'인 환불 계산

  • '총계 - (금액 + [첫째 날 밤 요금 값 +첫째 날 밤 세금])'
  • '983.34 - (30 + [400.58 + 82.12]) =' '470.64' 예상 환불액


정책 기간 내외 위약금

아래의 취소 정책 예제에서 정책 기간이 지나지 않았을 때와 지났을 때의 위약금을 모두 계산합니다. 예제 계산에서는 위의 예제와 동일한 요금 및 총계 값을 사용합니다.

<CancelPolicyInfoList> 
 <CancelPolicyInfo>
  <versionId>208198632</versionId>
<cancelTime>23:59:00</cancelTime>
<startWindowHours>0</startWindowHours>
<nightCount>0</nightCount>
<percent>100</percent>
<currencyCode>USD</currencyCode>
<timeZoneDescription>(GMT+08:00) Kuala Lumpur, Singapore </timeZoneDescription> </CancelPolicyInfo>

<CancelPolicyInfo>
<versionId>208198631</versionId>
<cancelTime>23:59:00</cancelTime>
<startWindowHours>168</startWindowHours>
<nightCount>1</nightCount>
<currencyCode>USD</currencyCode>
<timeZoneDescription>(GMT+08:00) Kuala Lumpur, Singapore</timeZoneDescription>
</CancelPolicyInfo>
</CancelPolicyInfoList>

기간 내 환불액 계산(고객이 체크인하기 168시간 이전에 취소):

  • total - (% of total)
  • 983.34 - (100% of 983.34)= 0 예상 환불액

기간 이후 환불액 계산(고객이 168시간 정책 기간이 시작되기 전 언제든지 취소):

  • total - (first nightly rate value + first night's tax)
  • 983.34 - (400.58 + 82.12) = 500.64