다음 출시 요건은 내부 담당자, 제휴 프로그램 등이 최종 고객이 아닌 소프트웨어와 상호 작용하는 B2B 통합 모델을 보유한 모든 제휴사에 적용됩니다. 최종 고객을 직접 지원하는 통합용 B2C 실행 요구 사항을 참조하세요.

1. 일반 요구 사항

1.1 제휴사의 호텔 공급자 사칭 금지

제휴사는 통합, 관련 웹 사이트, 마케팅 자료 등 사업 어느 부분에서도 EAN 숙박 시설의 공급자라고 사칭해서는 안 됩니다.
여기에는 숙박 시설이 독점적으로 제공하는 사항(예: "본 숙박 시설은 독점적으로 ~") 또는 가격 독점 사항(예: "인터넷 최저가")이 포함됩니다.
EAN 숙박 시설과 관련된 귀사의 브랜드는 공급업체가 아닌 EAN 숙박 시설의 마케팅 업체임이 분명하게 명시되어야 합니다.



1.2 Expedia/EAN 이름 또는 로고 사용 금지

어떠한 목적으로도 제휴사 사이트에 Expedia 또는 EAN의 이름이나 로고를 사용할 수 없습니다. Expedia 내부의 법무팀이나 관련 그룹에서 승인할 경우는 예외이며 제휴사 실행 기록에 승인이 첨부되어야 합니다.




1.3 제휴사는 예약 시 실제 여행객의 이름 제공

EAN 예약은 항상 실제 예약을 수행한 여행객의 이름과 함께 제출해야 합니다. 즉, 예약 본문 내에Room 개체 내의 firstNamelastName 값이 예약에 체크인하는 고객의 성/이름과 일치해야 합니다.

샘플 코드
REST
……
&room1=2
&room1FirstName={actual traveller's name}
&room1LastName={actual traveller's name}
&room1BedTypeId=23
&room1SmokingPreference=NS
……
XML
……
<RoomGroup>
<Room>
<numberOfAdults>2</numberOfAdults>
<firstName>{actual traveller's name}</firstName>
<lastName>{actual traveller's name}</lastName>

<bedTypeId>23</bedTypeId>
<smokingPreference>NS</smokingPreference>
</Room>
</RoomGroup> ……



1.4 제휴사 이용약관에 EAN 예약 이용약관 URL 표시

최종 사용자/여행객에게 귀사 사이트의 자체 이용약관 텍스트 내부에서 EAN 이용약관 링크를 제공해야 합니다. 귀사 이용약관 페이지 상단과 같이 찾기 쉬운 위치에 다음 링크를 배치하십시오. http://developer.ean.com/terms/en/




1.5 API로부터 반환되는 가격 또는 예약 조건 변경 금지

숙박 비용, 숙박 시설 및 편의 시설 등의 항목을 설명하는 가격 또는 예약 관련 값을 변경할 수 없습니다. 여기에는 해당 데이터를 누락시키거나 은폐하는 행위도 포함됩니다.

"수영장"을 "풀"로 변경하거나 "무선 인터넷"을 "WiFi"로 변경하는 등 포함되어 있는 단어의 뜻에 영향을 주지 않는 변경 사항은 허용됩니다."

응답을 통해 제공되는 정보 이외의 추가 정보를 제공하지 마십시오. EAN은 제휴사가 API 데이터를 부적절하게 변경하거나 API 데이터에 항목을 추가하여 발생하는 분쟁에 대해 책임지지 않습니다.


이 예는 총 예약 요금에 더해지는 제휴사 수수료를 표시하는 올바르지 않은 방법과 올바른 방법을 보여줍니다.


1.6 온라인 서비스 도구 링크를 비롯한 고객 서비스 번호를 명확하게 표시

EAN 지원 번호, 또는 EAN 고객 지원 센터를 사용하지 않는 경우 자체 지원 번호를 명확하게 표시합니다. 고객이 본인의 예약을 검색하여 검토할 수 있도록 온라인 고객 서비스 도구 링크도 제공해야 합니다.


상단 메뉴/헤더 영역에 제시된 고객 서비스 번호 및 셀프 서비스 도구


1.7 신용카드 규정에 대한 적절한 사용 및 표시

제휴사는 고객 신용카드 데이터를 요청, 처리, 저장할 때 PCI (Payment Card Industry) 규정을 따라야 합니다. 공식 PCI 보안 표준 웹 사이트에서 규정 전문을 확인할 수 있습니다.

귀사의 통합에 있어 중요한 PCI 규칙을 지원하기 위해, EAN에서는 다음과 같이 파트너를 위한 맞춤형 안내서를 제공합니다. developer.ean.com/docs/credit-card

위 안내서를 따르면 다음 사항이 보장됩니다.

  • 모든 예약 요청에 CSV를 필수로 요구
  • 표시 및 저장을 위해 카드 번호 길이 줄이기 요구 사항 충족
  • 모든 예약 관련 페이지에서 SSL 사용()
  • 브랜드 패리티 요구 사항 충족



1.8 해당 파트너에게 제공되는 PCI 준수 증거

EAN이 판매업체 기록인 경우 AOC(Attestation of Compliance)와 같은 PCI 준수에 대한 증거 자료가 제공되어야 합니다.

EAN 제휴사는 PCI 보안 표준 기관의 자가 평가 질문지 파일"SAQ D - 판매자"을 사용하여 올바른 AOC를 생성해야 합니다.

공식 PCI 보안 표준 문서 라이브러리에서 SAQ 지침 및 안내를 검토하고 "SAQ D - 판매자"를 확인할 수 있으며, SAQ D - 판매자 파일을 PDF 또는 Word 문서로 다운로드할 수도 있습니다.

1.9 다운스트림 제휴사는 EAN 상품 목록에 액세스하려면 EAN 이용약관에 동의해야 함

최종 사용자/여행객을 대신하여 예약을 수행하는 담당자는 EAN의 다운스트림 제휴사 이용약관에 동의해야 합니다. 본 계약은 귀사와 EAN 사이의 계약에 속합니다. 귀사에서는 담당자가 수락할 수 있도록 귀사의 폐쇄형 플랫폼 환경 내에 다운스트림 제휴사 이용약관을 호스팅하거나 다음 URL을 통해 링크해야 합니다. http://developer.ean.com/terms/agent/en/


1.10 TripAdvisor 콘텐츠 사용 시 완성된 TripAdvisor 동의 제공

EAN API로 제공되는 TripAdvisor 콘텐츠를 사용할 예정이라면 액세스 권한 부여를 위해 TripAdviso 지침을 준수하는 데 동의해야 합니다.
동의는 실행 승인 요청 시점 또는 라이브 이후 임의의 시점에 support@ean.com으로 이메일을 통해 제공해야 합니다. TripAdvisor는 권한이 부여된 이후에도 언제든지 TripAdvisor 콘텐츠에 대한 액세스를 유보/제거할 권한을 보유합니다

2. 검색 페이지

2.1 적절한 메시지와 자녀 연령 입력 시 제휴사가 예약을 허용하는 어린이

귀사의 통합에서 어린이 고객이 허용되는 경우, 모든 Expedia Collect 숙박 시설에서 성인 고객과 별도로 어린이 고객 및 해당 연령을 명시할 수 있는 기능을 제공해야 합니다. 이 정보는 numberOfChildrenchildAges 요소를 통해 제공됩니다(아래 샘플 코드 참조).

고객이 어린이 고객을 명시하는 경우, API 응답에는 나이 제한 및/또는 추가 투숙 인원 또는 유아용 침대 요금이 포함될 수 있으며, 이는 예약 가능성 또는 예약 요금에 영향을 줄 수 있습니다. 이러한 항목은 고객이 체크아웃하기 전 쇼핑 중에 명확하게 인지할 수 있도록 제공되어야 합니다.

모든 호텔은 어린이로 분류하는 연령 범주를 구성합니다. 일반적으로 만 17세 이하의 개인이 어린이로 간주됩니다. 일부 숙박 시설은 18세 이하의 투숙객을 허용하지 않습니다.

샘플 코드
REST
list? 
apiKey=#####
&cid=#####
&sig=####################
&customerIpAddress=#####
&customerUserAgent=######
&customerSessionId=#####
&minorRev=##
&locale=en_US
&currencyCode=USD
&city=Seattle
&stateProvinceCode=WA
&countryCode=US
&arrivalDate=09/04/2015
&departureDate=09/05/2015
&room1=1,3,6

XML
 
<HotelListRequest>
    <city>Seattle</city>
    <stateProvinceCode>WA</stateProvinceCode>
    <countryCode>US</countryCode>
    <arrivalDate>08/01/2015</arrivalDate>
    <departureDate>08/03/2015</departureDate>
    <RoomGroup>
      <Room>
        <numberOfAdults>2</numberOfAdults>
        <numberOfChildren>2</numberOfChildren>
        <childAges>3,6</childAges>
      </Room>
    </RoomGroup>
</HotelListRequest>



3. 호텔 목록 결과 페이지

3.1 세금 및 요금 내역을 제공하는 경우 개별 요금을 명확하게 표시해야 함

호텔 목록 결과 페이지에서 청구 내역 표시 여부는 선택 사항입니다. 추가 요금을 숙박비와 함께 표시하려는 경우에는 SurchargesHotelFees 배열에서 반환되는 모든 세금과 요금을 표시해야 합니다. HotelFees 배열에 의해 반환되는 수수료는 체크인 또는 체크아웃 시 (EAN 또는 현지 정부가 아닌) 숙박 시설 자체에서 부과되므로 별도로 표시해야 합니다. 전체 내역에는 숙박비(총 요금 또는 숙박일별 요금) SurchargeHotelFee 금액, 그리고 총 요금이 포함됩니다.

객실 요금만 표시하려는 경우에는 개별 숙박일별 요금으로 표시할 수도 있고 오른쪽 이미지에 나와 있는 것처럼 선택한 날짜의 총 요금(세금 제외)으로 표시할 수도 있습니다.

샘플 코드
이 블록은 본 요구 사항에서 언급한 요금 배열을 포함합니다. 다음은 전체 호텔 목록 응답에서 발췌한 관련 부분입니다.
REST
  ……
  
"Surcharges": {
      "@size": "1",
      "Surcharge": {
  		"@type": "TaxAndServiceFee",
		"@amount": "64.65"
	    }}    },
"nonRefundable": false,
	"HotelFees":
	 {"@size": "1","HotelFee":
	  {    "@description": "MandatoryTax",
	      "@amount": "57.11"}
	      },
	      "rateType": "MerchantStandard",
	      "currentAllotment": 1}
      ……
      
XML
  ……
  <NightlyRate baseRate="545.82" rate="545.82" promo="false" />
  </NightlyRatesPerRoom>
  <Surcharges size="1">
  <Surcharge type="TaxAndServiceFee" amount="64.65" />
  </Surcharges></ChargeableRateInfo>
  <nonRefundable>false</nonRefundable>
  <HotelFees size="1">
  <HotelFee description="MandatoryTax" amount="57.11" />
  </HotelFees>
  <rateType>MerchantStandard</rateType>
  <currentAllotment>1</currentAllotment>
  </RateInfo>
  ……
  

4. 호텔/객실 예약 가능 여부

4.1 세금 및 수수료가 별도의 항목으로 명시적으로 설명됨

모든 세금 참조 또는 Expedia Collect 숙박 시설에 대한 요금 내역(예약 가능 객실, 예약 양식, 확인 결과 등)이 제공되는 곳에 TaxAndServiceFee에 반환된 값을 정확히 포함해야 합니다.

"세금 및 요금" 총액을 나타낼 때 모든 Expedia Collect 재고에 대한 사이트에서 아래의 정확한 텍스트가 법적으로 요구됩니다. 고객의 위치가 아닌 호텔의 위치를 기반으로 표시해야 합니다.

  • 유럽: "세금"
  • 다른 모든 지역: "세금 및 서비스 요금"
예(유럽)


4.2 판매세는 해당하는 경우 별도로 보고

salesTax이(가) Surcharges 배열을 통해 반환되면 청구 내역에 이 항목을 표시합니다. 해당 항목은 현지 시 또는 주에서 청구하는 세금을 제공하며, 현지법에 따라 표시되어야 합니다.

샘플 코드
XML 예

<Surcharges size="2">
<Surcharge type="SalesTax" amount="126.62" />
<Surcharge type="TaxAndServiceFee" amount="133.62" />
</Surcharges>
REST 예

"Surcharges": {
"@size": "2",
"Surcharge": [
{
"@type": "SalesTax",
"@amount": "126.62"

}, {
"@type": "TaxAndServiceFee",
"@amount": "133.62"
} …
예:


4.3 각 객실에 대한 침대 유형 설명이 있음

BedTypes 배열이 하나의 값을 반환하지 않는 예약 가능 여부 응답의 경우, 각 객실의 rateDescription 값 또는 roomTypeDescription 값을 표시합니다. 이러한 값은 일반적으로 같은 값을 반환합니다.

BedTypes 배열이 여러 개의 옵션을 반환하는 경우, 고객이 선호 사항을 선택할 수 있도록 해당 옵션을 모두 제공합니다. bedTypeId 매개 변수를 사용하여 예약 요청에 고객이 선택한 BedType ID를 반환합니다.

또한 요청 시에만 동일한 객실의 여러 침대 유형 중 하나를 선택할 수 있으며, 예약 가능 객실이 없는 경우 호텔에서 요청을 접수하지 않을 수 있다는 메시지를 표시해야 합니다.

샘플 코드
단일 침대 유형 XML 예

<rateCode>205109735</rateCode>
<roomTypeCode>201048862</roomTypeCode>
<rateDescription>Deluxe Room, 2 Single Beds</rateDescription>
<roomTypeDescription>Deluxe Room, 2 Single Beds</roomTypeDescription>

<supplierType>E</supplierType>
<propertyId>18813</propertyId>
<BedTypes size="1">
<BedType id="43">
<description>2 single beds</description>
</BedType>

</BedTypes>

복수 침대 유형 XML 예
요금/객실 유형 설명에는 침대 유형 설명이 포함되지 않는다는 사실에 유의하십시오.
<rateCode>204975819</rateCode>
<roomTypeCode>201019993</roomTypeCode>
<rateDescription>Executive Room</rateDescription>
<roomTypeDescription>Executive Room</roomTypeDescription>

<supplierType>E</supplierType>
<propertyId>18813</propertyId>
<BedTypes size="2">
<BedType id="14">
<description>1 king bed</description>
</BedType>
<BedType id="43">
<description>2 single beds</description>
</BedType>

</BedTypes>
단일 침대 유형 REST 예
"rateCode": 484072,
"roomTypeCode": 198058,
"rateDescription": "Deluxe Room, 1 King Bed",
"roomTypeDescription": "Deluxe Room, 1 King Bed",

"supplierType": "E",
"propertyId": 5900,
"BedTypes": {
"@size": "1",
"BedType": {
"@id": "14",
"description": "1 king bed"

}
},
복수 침대 유형 REST 예
"rateCode": 206423129,
"roomTypeCode": 426739,
"rateDescription": "Family Apartment sleeps 6",
"roomTypeDescription": "Family Apartment sleeps 6",

"supplierType": "E",
"propertyId": 914263,
"BedTypes": {
"@size": "2",
"BedType": [
{
"@id": "69",
"description": "1 double and 1 sofa bed"
}, {
"@id": "70",
"description": "2 twin and 1 sofa bed"

}
]
},


4.4 체크인 지침 표시

객실 예약 가능 여부 응답에 반환될 때 checkInInstructions의 콘텐츠가 각 객실에 표시되어야 합니다. 이러한 지침은 체크인이나 운영 시간 이후 체크인 시 발생할 수 있는 수수료와 같은 중요한 정보가 포함됩니다. 항상 예약 가능 여부 응답의 값을 사용하십시오. 호텔 정보 또는 정적 데이터베이스 체크인 지침 값은 최신 정보가 아닐 수 있습니다.

샘플 코드
REST
{ "HotelRoomAvailabilityResponse": {
     "@size": "3",
     "customerSessionId": "0ABAAAAE-48DC-3914-D0B2-A769E3903921",
     "hotelId": 127092,
     "arrivalDate": "09/03/2015",
     "departureDate": "09/04/2015",
     "hotelName": "The Edgewater - A Noble House Hotel",
     "hotelAddress": "Pier 67, 2411 Alaskan Way",
     "hotelCity": "Seattle",
     "hotelStateProvince": "WA",
     "hotelCountry": "US",
     "numberOfRoomsRequested": 1,
     "checkInInstructions": "<p><b>Know Before You Go</b> <br /><ul> 
<li>Children 18 years old and younger stay free when occupying the parent or guardian's room,
 using existing bedding. </li> </ul></p><p><b>Fees</b> <br /><p>The following fees and deposits
 are charged by the property at time of service, check-in, or check-out. </p> <ul> 
<li>Breakfast fee: USD 22 per person (approximately)</li> <li>Fee for in-room wireless 
Internet: USD 9.95 (for 24 hours, rates may vary)</li> 
<li>Fee for wireless Internet in public areas: USD 9.95 (for 24 hours, rates may vary)</li> 
<li>Valet parking fee: USD 38 per night (in/out privileges)</li> 
<li>Late check-out fee: USD 125</li> 
<li>Rollaway bed fee: USD 20 per night</li>
<li>Facilities fee: USD 12.00 per accommodation, per night</li> </ul> 
<p>The above list may not be comprehensive. Fees and deposits may not include tax and 
are subject to change. </p></p>",
"HotelRoomResponse": [……
……
 


XML
<ns2:HotelRoomAvailabilityResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/" size="5">
 <customerSessionId>0ABAAA4D-082E-AA91-4D02-B8BAE1397B78</customerSessionId>
 <hotelId>127092</hotelId>
 <arrivalDate>09/03/2015</arrivalDate>
 <departureDate>09/04/2015</departureDate>
 <hotelName>The Edgewater - A Noble House Hotel</hotelName>
 <hotelAddress>Pier 67, 2411 Alaskan Way</hotelAddress>
 <hotelCity>Seattle</hotelCity>
 <hotelStateProvince>WA</hotelStateProvince>
 <hotelCountry>US</hotelCountry>
 <numberOfRoomsRequested>1</numberOfRoomsRequested>
 <checkInInstructions><p><b>Know Before You Go</b> <br /><ul> <li>Children 18 years old and
 younger stay free when occupying the parent or guardian's room, using existing bedding. </li>
 </ul></p><p><b>Fees</b> <br /><p>The following fees and deposits are charged by the property 
at time of service, check-in, or check-out. </p> <ul> <li>Breakfast fee: USD 22 per person 
(approximately)</li> <li>Fee for in-room wireless Internet: USD 9.95 (for 24 hours, 
rates may vary)</li> <li>Fee for wireless Internet in public areas: USD 9.95 (for 24 hours,
 rates may vary)</li> <li>Valet parking fee: USD 38 per night (in/out privileges)</li> 
<li>Late check-out fee: USD 125</li> <li>Rollaway bed fee: USD 20 per night</li>
<li>Facilities fee: USD 12.00 per accommodation, per night</li> </ul> 
<p>The above list may not be comprehensive. Fees and deposits may not include tax and 
are subject to change. </p></p></checkInInstructions> <HotelRoomResponse>


4.5 환불 불가능 정책이 명시적으로 표시됨

환불 불가능 예약 가능 여부는 nonRefundable=true로 표시됩니다. 이 값은 기타 정책 데이터에 언제나 우선합니다. 어떤 경우에도 숙박 시설은 이러한 예약을 환불하지 않습니다.

숙박 시설 또는 객실 선택 시 nonRefundable=true 가 반환되는 경우, 개별적인 예약 가능 여부가 제공될 때는 해당 객실을 명확하게 표시하여 제공합니다(전체 객실 선택 페이지, 목록 결과 페이지의 부분적인 선택 등).

환불 가능한 예약 가능 여부의 경우에는 cancelPolicyInfo 배열에 의해 제공되는 위약금 산정 가이드를 참조하십시오.

샘플 코드
REST
nonRefundableCancelPolicyInfoList 배열과 rateType 중간에 반환됩니다.
"CancelPolicyInfoList": {
[array contents omitted for example]
},
"nonRefundable": true,
"rateType": "MerchantStandard",
"promoType": "Standard",
"currentAllotment": 13,
"guaranteeRequired": false,
"depositRequired": true,
XML
nonRefundableCancelPolicyInfoListHotelFees 중간에 반환됩니다.
  …
  </CancelPolicyInfo>
</CancelPolicyInfoList>
<nonRefundable>true</nonRefundable>
<HotelFees size="1">
<HotelFee description="MandatoryTax" amount="56.99" />
</HotelFees> …

4.6 제휴사가 반환될 때 specialCheckInInstructions의 내용이 표시됨

반환될 때 각 객실에 대해 specialCheckInInstructions가 표시되어야 합니다.
이 필드에는 숙박 시설에 예정 도착 시간 알림, 게스트 건물의 다른 장소에서 체크인, 이메일을 통해 숙박 시설에서 고지하는 특수 체크인 지침 등과 같이 체크인에 중요한 정보가 checkInInstructions 필드에 포함될 수 있습니다.
기본 체크인 지침과 동일한 영역에 이 정보를 표시합니다.

샘플 코드
REST
……
"checkInInstructions": "<p><b>Know  Before You Go</b> <br /><ul>  <li>Reservations  are required for massage services and spa treatments. Reservations can  be made by contacting the hotel prior to arrival, using the contact  information on the booking confirmation. </li> <li>One child  12 years old or younger stays free when occupying the parent or  guardian's room, using existing bedding. </li><li>Only  registered guests are allowed in the guestrooms. </li>  <li>Some facilities may have restricted access. Guests can contact  the property for details using the contact information on the booking  confirmation. </li>  </ul></p><p><b>Fees</b> <br  /><p>The following fees and deposits are charged by the  property at time of service, check-in, or check-out. </p>  <ul> <li>Fee for buffet breakfast: AED 88 per person  (approximately)</li>                <li>Rollaway bed fee:  AED 110 per night</li>  </ul> <p>The above list may  not be comprehensive. Fees and deposits may not include tax and are  subject to change. </p></p>",
"specialCheckInInstructions": "The Dubai International Hotel is meant exclusively for transit passengers. Guests who book a stay in the hotel cannot go out of the airport, nor can they retrieve checked-in luggage. Guests should not proceed through passport control, as they will then not be able to access the hotel. Guests should contact the hotel in advance with their flight details so that staff can assist them in arriving at the hotel. Contact details can be found on the booking confirmation. Guests must provide their boarding pass and passport at check-in as this hotel is inside the airport. For more details, please contact the office using the information on the reservation confirmation received after booking.", ……
XML
…… <checkInInstructions><p><b>Know  Before You Go</b> <br /><ul>  <li>Reservations  are required for massage services and spa treatments. Reservations can  be made by contacting the hotel prior to arrival, using the contact  information on the booking confirmation. </li> <li>One child  12 years old or younger stays free when occupying the parent or  guardian's room, using existing bedding. </li><li>Only  registered guests are allowed in the guestrooms. </li>  <li>Some facilities may have restricted access. Guests can contact  the property for details using the contact information on the booking  confirmation. </li>  </ul></p><p><b>Fees</b> <br  /><p>The following fees and deposits are charged by the  property at time of service, check-in, or check-out. </p>  <ul> <li>Fee for buffet breakfast: AED 88 per person  (approximately)</li>                <li>Rollaway bed fee:  AED 110 per night</li>  </ul> <p>The above list may  not be comprehensive. Fees and deposits may not include tax and are  subject to change. </p></p></checkInInstructions>
<specialCheckInInstructions>The Dubai International Hotel is meant exclusively for transit passengers. Guests who book a stay in the hotel cannot go out of the airport, nor can they retrieve checked-in luggage. Guests should not proceed through passport control, as they will then not be able to access the hotel. Guests should contact the hotel in advance with their flight details so that staff can assist them in arriving at the hotel. Contact details can be found on the booking confirmation. Guests must provide their boarding pass and passport at check-in as this hotel is inside the airport. For more details, please contact the office using the information on the reservation confirmation received after booking.</specialCheckInInstructions> ……

5. 예약 페이지

5.1 민감한 정보에 대해 SSL 암호화 제공됨

민감한 정보를 보내거나 전송할 때는 SSL 암호화를 사용해야 합니다. 민감한 정보에는 투숙객 이름, 전화번호 또는 이메일, 결제 카드 세부 정보, 예약/일정 영수증 및 확인 페이지가 포함됩니다.

고객의 브라우저에서 이러한 정보를 보내거나 받기 위해 보안 연결을 사용하지 않는 경우, SSL이 제대로 통합되지 않을 수 있습니다.



브라우저에 표시되는 유효한 SSL 인증


5.2 명확한 청구 내역 제공

예약 페이지에는 청구 내역이 표시되어야 합니다. 청구 내역에는 Surcharge 배열 및 HotelFees 배열로 반환되는 개별적인 내역을 모두 명확하게 표시해야 합니다.

HotelFees 배열에 의해 반환되는 수수료는 체크인 또는 체크아웃 시 (EAN 또는 현지 정부가 아닌) 숙박 시설 자체에서 부과되므로 별도로 표시해야 합니다.

선택한 날짜에 대해 개별 1박 요금을 포함하거나 세금 없이 총 숙박일 요금 합계를 포함합니다. 최종 내역에는 숙박비(총 요금 또는 숙박일별 요금), SurchargeHotelFee 금액, 그리고 총 요금이 포함되어야 합니다.

샘플 코드
이 블록은 본 요구 사항에서 언급한 요금 배열을 포함합니다. 다음은 전체 호텔 목록 응답에서 발췌한 관련 부분입니다.
REST
  ……
  
"Surcharges": {
      "@size": "1",
      "Surcharge": {
  		"@type": "TaxAndServiceFee",
		"@amount": "64.65"
	    }}    },
"nonRefundable": false,
	"HotelFees":
	 {"@size": "1","HotelFee":
	  {    "@description": "MandatoryTax",
	      "@amount": "57.11"}
	      },
	      "rateType": "MerchantStandard",
	      "currentAllotment": 1}
      ……
      
XML
  ……
  <NightlyRate baseRate="545.82" rate="545.82" promo="false" />
  </NightlyRatesPerRoom>
  <Surcharges size="1">
  <Surcharge type="TaxAndServiceFee" amount="64.65" />
  </Surcharges></ChargeableRateInfo>
  <nonRefundable>false</nonRefundable>
  <HotelFees size="1">
  <HotelFee description="MandatoryTax" amount="57.11" />
  </HotelFees>
  <rateType>MerchantStandard</rateType>
  <currentAllotment>1</currentAllotment>
  </RateInfo>
  ……
  



5.3 세금 및 수수료가 별도의 항목으로 명시적으로 설명됨

모든 세금 참조 및/또는 예약 양식에 요금 내역이 제공되는 곳에 TaxAndServiceFee에 반환된 값을 정확히 포함해야 합니다.

가격 내역에 "세금 및 요금" 총액을 나타낼 때 모든 Expedia Collect 재고에 대한 사이트에서 아래의 정확한 텍스트가 법적으로 요구됩니다. 고객의 위치가 아닌 호텔의 위치를 기반으로 표시해야 합니다.

  • 유럽: "세금"
  • 다른 모든 지역: "세금 및 서비스 요금"


5.4 총 요금을 명확하게 표시



5.5 제휴사 서비스 또는 예약 수수료는 분명히 구분되어야 함

자체적인 예약 또는 서비스 요금을 청구하는 경우 고객에게 EAN이 아니라 제휴사의 별도 서비스임을 분명히 밝혀야 합니다(예: 숙박 시설 제공을 위한 추가 청구가 아님). 기존 요금 내역에 수수료를 포함하지 않습니다.
제휴사 예약 또는 서비스 수수료는 요금에 포함하여 제공하지 않고 별도로 구분해야 합니다.

예:
예시로 제공되는 아래 객실에는 총 27.09유로의 세금 및 서비스 요금이 포함되어 있습니다. 올바르지 않은 예에서는 파트너 서비스 요금이 EAN 총 수수료에 포함되어 있습니다. 올바른 예에서는 파트너 서비스 요금이 별도로 제공되어 있으며, 그 출처가 분명하게 명시되어 있습니다.



5.6 시 세금을 별도로 보고

MandatoryTax 값이 반환되는 경우 이를 청구 내역에 별도로 명시합니다. 해당 요금은 표준 세금이 아니며, 호텔에 의해 직접 부과됩니다.




5.7 판매세는 해당하는 경우 별도로 보고

salesTax이(가) Surcharges 배열을 통해 반환되면 청구 내역에 이 항목을 표시합니다. 해당 항목은 현지 시 또는 주에서 청구하는 세금을 제공하며, 현지법에 따라 표시되어야 합니다.

샘플 코드
XML 예

<Surcharges size="2">
<Surcharge type="SalesTax" amount="126.62" />
<Surcharge type="TaxAndServiceFee" amount="133.62" />
</Surcharges>
REST 예

"Surcharges": {
"@size": "2",
"Surcharge": [
{
"@type": "SalesTax",
"@amount": "126.62"

}, {
"@type": "TaxAndServiceFee",
"@amount": "133.62"
} …
예:


5.8 체크인 지침 표시

객실 예약 가능 여부 응답에 반환될 때 checkInInstructions의 콘텐츠가 각 객실에 표시되어야 합니다. 이러한 정보는 고객이 예약 완료 전 체크인 시 잠재적으로 발생 가능한 수수료 또는 특별 액세스 지침에 대해 분명히 알 수 있도록 예약 전 페이지에 표시되어야 합니다.

항상 예약 가능 여부 응답의 값을 사용하십시오. 호텔 정보 또는 정적 데이터베이스 체크인 지침 값은 최신 정보가 아닐 수 있습니다.

샘플 코드
REST
{ "HotelRoomAvailabilityResponse": {
     "@size": "3",
     "customerSessionId": "0ABAAAAE-48DC-3914-D0B2-A769E3903921",
     "hotelId": 127092,
     "arrivalDate": "09/03/2015",
     "departureDate": "09/04/2015",
     "hotelName": "The Edgewater - A Noble House Hotel",
     "hotelAddress": "Pier 67, 2411 Alaskan Way",
     "hotelCity": "Seattle",
     "hotelStateProvince": "WA",
     "hotelCountry": "US",
     "numberOfRoomsRequested": 1,
     "checkInInstructions": "<p><b>Know Before You Go</b> <br /><ul> 
<li>Children 18 years old and younger stay free when occupying the parent or guardian's room,
 using existing bedding. </li> </ul></p><p><b>Fees</b> <br /><p>The following fees and deposits
 are charged by the property at time of service, check-in, or check-out. </p> <ul> 
<li>Breakfast fee: USD 22 per person (approximately)</li> <li>Fee for in-room wireless 
Internet: USD 9.95 (for 24 hours, rates may vary)</li> 
<li>Fee for wireless Internet in public areas: USD 9.95 (for 24 hours, rates may vary)</li> 
<li>Valet parking fee: USD 38 per night (in/out privileges)</li> 
<li>Late check-out fee: USD 125</li> 
<li>Rollaway bed fee: USD 20 per night</li>
<li>Facilities fee: USD 12.00 per accommodation, per night</li> </ul> 
<p>The above list may not be comprehensive. Fees and deposits may not include tax and 
are subject to change. </p></p>",
"HotelRoomResponse": [……
……


XML
<ns2:HotelRoomAvailabilityResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/" size="5">
 <customerSessionId>0ABAAA4D-082E-AA91-4D02-B8BAE1397B78</customerSessionId>
 <hotelId>127092</hotelId>
 <arrivalDate>09/03/2015</arrivalDate>
 <departureDate>09/04/2015</departureDate>
 <hotelName>The Edgewater - A Noble House Hotel</hotelName>
 <hotelAddress>Pier 67, 2411 Alaskan Way</hotelAddress>
 <hotelCity>Seattle</hotelCity>
 <hotelStateProvince>WA</hotelStateProvince>
 <hotelCountry>US</hotelCountry>
 <numberOfRoomsRequested>1</numberOfRoomsRequested>
 <checkInInstructions><p><b>Know Before You Go</b> <br /><ul> <li>Children 18 years old and
 younger stay free when occupying the parent or guardian's room, using existing bedding. </li>
 </ul></p><p><b>Fees</b> <br /><p>The following fees and deposits are charged by the property 
at time of service, check-in, or check-out. </p> <ul> <li>Breakfast fee: USD 22 per person 
(approximately)</li> <li>Fee for in-room wireless Internet: USD 9.95 (for 24 hours, 
rates may vary)</li> <li>Fee for wireless Internet in public areas: USD 9.95 (for 24 hours,
 rates may vary)</li> <li>Valet parking fee: USD 38 per night (in/out privileges)</li> 
<li>Late check-out fee: USD 125</li> <li>Rollaway bed fee: USD 20 per night</li>
<li>Facilities fee: USD 12.00 per accommodation, per night</li> </ul> 
<p>The above list may not be comprehensive. Fees and deposits may not include tax and 
are subject to change. </p></p></checkInInstructions> <HotelRoomResponse>


5.9 제휴사가 각 예약 요청에 대해 고객의 이메일 주소 또는 모니터링된 이메일 사서함 제공

ReservationInfo 안의 email 요소에는 확인 이메일 처리를 위해 귀사의 통합에서 모니터링하는 고객의 이메일 주소 또는 사서함이 포함되어야 합니다. 이렇게 하면 EAN에서 생성되는 모든 이메일의 목적지가 언제나 분명히 파악될 수 있습니다. 이는 예약 분쟁 또는 문제 해결 시 필요하게 됩니다.



5.10 총 예약 금액이 청구된다는 사실을 예약 전에 명시

Expedia Collect 예약 가능 객실의 예약 페이지에 총 예약 금액이 신용 카드로 즉시 청구됨을 명시해야 합니다. Expedia Collect 예약 확인 페이지에 총 예약 요금이 지불되어야 한다고 설명해야 합니다.




5.11 해당하는 경우 어린이 연령을 분명하게 명시

귀사의 통합에서 어린이 고객이 허용되는 경우, 그리고 고객이 객실 선택 시 어린이 고객을 명시하는 경우, 모든 Expedia Collect 숙박 시설에서 어린이 고객의 명수와 해당 연령을 명시해야 합니다. 이 정보는 객실 예약 가능 여부 응답의 numberOfChildrenchildAges 요소를 통해 제공됩니다.

고객이 어린이 고객을 명시하는 경우, API 응답에는 나이 제한 및/또는 추가 투숙 인원 또는 유아용 침대 요금이 포함될 수 있으며, 이는 예약 가능성 또는 예약 요금에 영향을 줄 수 있습니다. 이러한 항목은 고객이 체크아웃하기 전 명확하게 인지할 수 있도록 제공되어야 합니다.

모든 호텔은 어린이로 분류하는 연령 범주를 구성합니다. 일반적으로 만 17세 이하의 개인이 어린이로 간주됩니다. 일부 숙박 시설은 18세 이하의 투숙객을 허용하지 않습니다.




5.12 환불 불가능 정책이 명시적으로 표시됨

환불 불가능 예약 가능 여부는 nonRefundable=true로 표시됩니다. 이 값은 기타 정책 데이터에 언제나 우선합니다. 객실 선택 페이지에 해당 객실은 환불이 불가능함을 분명하게 명시하고, 최종 예약 페이지에도 환불 불가 정책을 다시 한 번 명시합니다. 어떤 경우에도 숙박 시설은 이러한 예약을 환불하지 않습니다.

환불 가능한 예약 가능 여부의 경우에는 cancelPolicyInfo 배열에 의해 제공되는 위약금 산정 가이드를 참조하십시오.



5.13 취소 정책을 명확하게 표시

최종 예약 페이지에서 고객의 구매 내역을 확인하기 전에 선택한 객실에 대한 취소 정책과 계속 진행하기 위해 필요한 확인용 체크박스를 제공해야 합니다.
고객은 객실별 취소 정책에 동의해야 예약을 진행할 수 있습니다.

취소 정책은 항상 실제 API 응답의 cancelPolicyInfo 배열을 통해서 획득해야 합니다.

귀사 이용약관&의 일부로 해당 사항에 대한 동의를 포함할 수 있습니다. 예: "[이 체크상자를 선택함으로써/본 예약을 진행함으로써 등] 귀하는 이용약관 및 선택한 객실의 취소 정책에 동의하게 됩니다.


5.14 각 예약 요청에 전화번호 포함

제휴사는 후속 조치를 위해 예약에 고객 연락처 또는 담당자 연락처 전화번호를 제공해야 합니다.



5.15 제휴사가 반환될 때 specialCheckInInstructions의 내용이 표시됨

반환될 때 각 객실에 대해 specialCheckInInstructions가 표시되어야 합니다.
이 필드에는 숙박 시설에 예정 도착 시간 알림, 게스트 건물의 다른 장소에서 체크인, 이메일을 통해 숙박 시설에서 고지하는 특수 체크인 지침 등과 같이 체크인에 중요한 정보가 checkInInstructions 필드에 포함될 수 있습니다.
기본 체크인 지침과 동일한 영역에 이 정보를 표시합니다.

샘플 코드
REST
……
"checkInInstructions": "<p><b>Know  Before You Go</b> <br /><ul>  <li>Reservations  are required for massage services and spa treatments. Reservations can  be made by contacting the hotel prior to arrival, using the contact  information on the booking confirmation. </li> <li>One child  12 years old or younger stays free when occupying the parent or  guardian's room, using existing bedding. </li><li>Only  registered guests are allowed in the guestrooms. </li>  <li>Some facilities may have restricted access. Guests can contact  the property for details using the contact information on the booking  confirmation. </li>  </ul></p><p><b>Fees</b> <br  /><p>The following fees and deposits are charged by the  property at time of service, check-in, or check-out. </p>  <ul> <li>Fee for buffet breakfast: AED 88 per person  (approximately)</li>                <li>Rollaway bed fee:  AED 110 per night</li>  </ul> <p>The above list may  not be comprehensive. Fees and deposits may not include tax and are  subject to change. </p></p>",
"specialCheckInInstructions": "The Dubai International Hotel is meant exclusively for transit passengers. Guests who book a stay in the hotel cannot go out of the airport, nor can they retrieve checked-in luggage. Guests should not proceed through passport control, as they will then not be able to access the hotel. Guests should contact the hotel in advance with their flight details so that staff can assist them in arriving at the hotel. Contact details can be found on the booking confirmation. Guests must provide their boarding pass and passport at check-in as this hotel is inside the airport. For more details, please contact the office using the information on the reservation confirmation received after booking.", ……
XML
…… <checkInInstructions><p><b>Know  Before You Go</b> <br /><ul>  <li>Reservations  are required for massage services and spa treatments. Reservations can  be made by contacting the hotel prior to arrival, using the contact  information on the booking confirmation. </li> <li>One child  12 years old or younger stays free when occupying the parent or  guardian's room, using existing bedding. </li><li>Only  registered guests are allowed in the guestrooms. </li>  <li>Some facilities may have restricted access. Guests can contact  the property for details using the contact information on the booking  confirmation. </li>  </ul></p><p><b>Fees</b> <br  /><p>The following fees and deposits are charged by the  property at time of service, check-in, or check-out. </p>  <ul> <li>Fee for buffet breakfast: AED 88 per person  (approximately)</li>                <li>Rollaway bed fee:  AED 110 per night</li>  </ul> <p>The above list may  not be comprehensive. Fees and deposits may not include tax and are  subject to change. </p></p></checkInInstructions>
<specialCheckInInstructions>The Dubai International Hotel is meant exclusively for transit passengers. Guests who book a stay in the hotel cannot go out of the airport, nor can they retrieve checked-in luggage. Guests should not proceed through passport control, as they will then not be able to access the hotel. Guests should contact the hotel in advance with their flight details so that staff can assist them in arriving at the hotel. Contact details can be found on the booking confirmation. Guests must provide their boarding pass and passport at check-in as this hotel is inside the airport. For more details, please contact the office using the information on the reservation confirmation received after booking.</specialCheckInInstructions> ……


5.16 EAN MoR – 체크아웃 페이지에 표시되는 결제 처리 위치

EAN이 거래의 판매업체 기록인 경우 결제를 처리하는 국가를 체크아웃 페이지에서 쉽게 확인할 수 있는 위치에 표시해야 합니다. 국가 이름 앞에는 "이 결제가 처리되는 국가:"라는 문구를 삽입해야 합니다.

이 정보를 검색하려면 결제 API를 사용하십시오.

샘플 코드
REST
{
"HotelPaymentResponse": {
"@size": "7",
"@currencyCode": "USD",
"customerSessionId": "0c0a51e9-aedc-4909-b17c-ba57ab53fc28",
"PaymentType": [
{
"code": "AX",
"name": "American Express"
}, {
"code": "BC",
"name": "BC Card"
}, {
"code": "DC",
"name": "DINERS CLUB INTERNATIONAL"
}, {
"code": "DS",
"name": "Discover"
}, {
"code": "JC",
"name": "JCB"
}, {
"code": "CA",
"name": "Master Card",
"mandatoryDisplayText": "This payment will be processed in the United States.",
"processorCountryCode": "US"
}, {
"code": "VI",
"name": "Visa",
"mandatoryDisplayText": "This payment will be processed in the United States.",
"processorCountryCode": "US"
}
]
}
}
XML
<ns2:HotelPaymentResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/" size="7" currencyCode="USD">
<customerSessionId>ce9e5fab-2984-4510-bb8e-240ce16ddd82</customerSessionId>
<PaymentType>
<code>AX</code>
<name>American Express</name>
</PaymentType>
<PaymentType>
<code>BC</code>
<name>BC Card</name>
</PaymentType>
<PaymentType>
<code>DC</code>
<name>DINERS CLUB INTERNATIONAL</name>
</PaymentType>
<PaymentType>
<code>DS</code>
<name>Discover</name>
</PaymentType>
<PaymentType>
<code>JC</code>
<name>JCB</name>
</PaymentType>
<PaymentType>
<code>CA</code>
<name>Master Card</name>
<mandatoryDisplayText>This payment will be processed in the United States.</mandatoryDisplayText>
<processorCountryCode>US</processorCountryCode>
</PaymentType>
<PaymentType>
<code>VI</code>
<name>Visa</name>
<mandatoryDisplayText>This payment will be processed in the United States.</mandatoryDisplayText>
<processorCountryCode>US</processorCountryCode>
</PaymentType>
</ns2:HotelPaymentResponse>

6. 확인 페이지

6.1 총 요금을 명확하게 표시

7. 확인 이메일/바우처

7.1 자체 이메일을 통해 명확한 청구 내역 제공

EAN의 자동 고객 확인 이메일/바우처 수신을 사용하지 않는 경우, 귀사에서 고객에게 자체적으로 전송하는 이메일/바우처에 청구 내역이 포함되어야 합니다.


7.2 세금 및 수수료가 별도의 항목으로 명시적으로 설명됨

모든 세금 참조 또는 Expedia Collect 숙박 시설에 대한 요금 내역(예약 가능 객실, 예약 양식, 확인 결과 등)이 제공되는 곳에 TaxAndServiceFee에 반환된 값을 정확히 포함해야 합니다.

"세금 및 요금" 총액을 나타낼 때 모든 Expedia Collect 재고에 대한 사이트에서 아래의 정확한 텍스트가 법적으로 요구됩니다. 고객의 위치가 아닌 호텔의 위치를 기반으로 표시해야 합니다.

  • 유럽: "세금"
  • 다른 모든 지역: "세금 및 서비스 요금"


7.3 제휴사 서비스 또는 예약 요금을 명확하게 구분

자체적인 예약 또는 서비스 요금을 청구하는 경우 고객에게 EAN이 아니라 제휴사의 별도 서비스임을 분명히 밝혀야 합니다(예: 숙박 시설 제공을 위한 추가 청구가 아님). 기존 요금 내역에 수수료를 포함하지 않습니다.
제휴사 예약 또는 서비스 수수료는 요금에 포함하여 제공하지 않고 별도로 구분해야 합니다.

예:
예시로 제공되는 아래 객실에는 총 27.09유로의 세금 및 서비스 요금이 포함되어 있습니다. 올바르지 않은 예에서는 파트너 서비스 요금이 EAN 총 수수료에 포함되어 있습니다. 올바른 예에서는 파트너 서비스 요금이 별도로 제공되어 있으며, 그 출처가 분명하게 명시되어 있습니다.



7.4 시 세금을 별도로 보고

예약 대상 숙박 시설에 대해 이전에 MandatoryTax 값이 반환된 경우, 예약 전 가격 내역에 이 값을 별도로 반환합니다. 해당 요금은 표준 세금이 아니며, 호텔에 의해 직접 부과됩니다.




7.5 Travelscape LLC 또는 Vacationspot, SL을 공급자로 명시

다음과 같이 호텔의 위치에 따라 호텔의 공급자를 Travelscape LLC 또는 Vacationspot, SL로 명시해야 합니다.

  • Vacationspot: 프랑스 및 벨기에 전역, 예를 들어 프랑스: Mytravel.fr 또는 벨기에: Mytravel.be
  • Travelscape: 기타 모든 숙박 시설.


7.6 각 객실에 대한 침대 유형 설명이 있음

귀사의 자체 이메일/바우처에서 고객이 선택한 침대 유형을 확인합니다. BedTypes 배열이 하나의 값을 반환하지 않는 예약 가능 여부 응답의 경우, 각 객실의 rateDescription 값 또는 roomTypeDescription 값을 표시합니다. 이러한 값은 일반적으로 같은 값을 반환합니다.

BedTypes 배열이 복수의 옵션을 반환하는 경우, 해당 호텔의 객실 선택 페이지에서 고객의 선택 사항을 확인합니다. bedTypeId 매개 변수를 사용하여 예약 요청에 고객이 선택한 BedType ID를 반환합니다.

또한 요청 시에만 동일한 객실의 여러 침대 유형 중 하나를 선택할 수 있으며, 예약 가능 객실이 없는 경우 호텔에서 요청을 접수하지 않을 수 있다는 메시지를 표시해야 합니다.

샘플 코드
단일 침대 유형 XML 예

<rateCode>205109735</rateCode>
<roomTypeCode>201048862</roomTypeCode>
<rateDescription>Deluxe Room, 2 Single Beds</rateDescription>
<roomTypeDescription>Deluxe Room, 2 Single Beds</roomTypeDescription>

<supplierType>E</supplierType>
<propertyId>18813</propertyId>
<BedTypes size="1">
<BedType id="43">
<description>2 single beds</description>
</BedType>

</BedTypes>

복수 침대 유형 XML 예
요금/객실 유형 설명에는 침대 유형 설명이 포함되지 않는다는 사실에 유의하십시오.
<rateCode>204975819</rateCode>
<roomTypeCode>201019993</roomTypeCode>
<rateDescription>Executive Room</rateDescription>
<roomTypeDescription>Executive Room</roomTypeDescription>

<supplierType>E</supplierType>
<propertyId>18813</propertyId>
<BedTypes size="2">
<BedType id="14">
<description>1 king bed</description>
</BedType>
<BedType id="43">
<description>2 single beds</description>
</BedType>

</BedTypes>
단일 침대 유형 REST 예
"rateCode": 484072,
"roomTypeCode": 198058,
"rateDescription": "Deluxe Room, 1 King Bed",
"roomTypeDescription": "Deluxe Room, 1 King Bed",

"supplierType": "E",
"propertyId": 5900,
"BedTypes": {
"@size": "1",
"BedType": {
"@id": "14",
"description": "1 king bed"

}
},
복수 침대 유형 REST 예
"rateCode": 206423129,
"roomTypeCode": 426739,
"rateDescription": "Family Apartment sleeps 6",
"roomTypeDescription": "Family Apartment sleeps 6",

"supplierType": "E",
"propertyId": 914263,
"BedTypes": {
"@size": "2",
"BedType": [
{
"@id": "69",
"description": "1 double and 1 sofa bed"
}, {
"@id": "70",
"description": "2 twin and 1 sofa bed"

}
]
},


7.7 체크인 지침 표시

객실 예약 가능 여부 응답에 반환될 때 checkInInstructions의 콘텐츠가 각 객실에 표시되어야 합니다. 이러한 정보는 고객이 체크인 시 잠재적으로 발생 가능한 수수료 또는 특별 액세스 지침에 대해 분명히 알 수 있도록 확인 이메일에 표시되어야 합니다.

항상 예약 가능 여부 응답의 값을 사용하십시오. 호텔 정보 또는 정적 데이터베이스 체크인 지침 값은 최신 정보가 아닐 수 있습니다.

샘플 코드
REST
{ "HotelRoomAvailabilityResponse": {
     "@size": "3",
     "customerSessionId": "0ABAAAAE-48DC-3914-D0B2-A769E3903921",
     "hotelId": 127092,
     "arrivalDate": "09/03/2015",
     "departureDate": "09/04/2015",
     "hotelName": "The Edgewater - A Noble House Hotel",
     "hotelAddress": "Pier 67, 2411 Alaskan Way",
     "hotelCity": "Seattle",
     "hotelStateProvince": "WA",
     "hotelCountry": "US",
     "numberOfRoomsRequested": 1,
     "checkInInstructions": "<p><b>Know Before You Go</b> <br /><ul> 
<li>Children 18 years old and younger stay free when occupying the parent or guardian's room,
 using existing bedding. </li> </ul></p><p><b>Fees</b> <br /><p>The following fees and deposits
 are charged by the property at time of service, check-in, or check-out. </p> <ul> 
<li>Breakfast fee: USD 22 per person (approximately)</li> <li>Fee for in-room wireless 
Internet: USD 9.95 (for 24 hours, rates may vary)</li> 
<li>Fee for wireless Internet in public areas: USD 9.95 (for 24 hours, rates may vary)</li> 
<li>Valet parking fee: USD 38 per night (in/out privileges)</li> 
<li>Late check-out fee: USD 125</li> 
<li>Rollaway bed fee: USD 20 per night</li>
<li>Facilities fee: USD 12.00 per accommodation, per night</li> </ul> 
<p>The above list may not be comprehensive. Fees and deposits may not include tax and 
are subject to change. </p></p>",
"HotelRoomResponse": [……
……

XML
<ns2:HotelRoomAvailabilityResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/" size="5">
 <customerSessionId>0ABAAA4D-082E-AA91-4D02-B8BAE1397B78</customerSessionId>
 <hotelId>127092</hotelId>
 <arrivalDate>09/03/2015</arrivalDate>
 <departureDate>09/04/2015</departureDate>
 <hotelName>The Edgewater - A Noble House Hotel</hotelName>
 <hotelAddress>Pier 67, 2411 Alaskan Way</hotelAddress>
 <hotelCity>Seattle</hotelCity>
 <hotelStateProvince>WA</hotelStateProvince>
 <hotelCountry>US</hotelCountry>
 <numberOfRoomsRequested>1</numberOfRoomsRequested>
 <checkInInstructions><p><b>Know Before You Go</b> <br /><ul> <li>Children 18 years old and
 younger stay free when occupying the parent or guardian's room, using existing bedding. </li>
 </ul></p><p><b>Fees</b> <br /><p>The following fees and deposits are charged by the property 
at time of service, check-in, or check-out. </p> <ul> <li>Breakfast fee: USD 22 per person 
(approximately)</li> <li>Fee for in-room wireless Internet: USD 9.95 (for 24 hours, 
rates may vary)</li> <li>Fee for wireless Internet in public areas: USD 9.95 (for 24 hours,
 rates may vary)</li> <li>Valet parking fee: USD 38 per night (in/out privileges)</li> 
<li>Late check-out fee: USD 125</li> <li>Rollaway bed fee: USD 20 per night</li>
<li>Facilities fee: USD 12.00 per accommodation, per night</li> </ul> 
<p>The above list may not be comprehensive. Fees and deposits may not include tax and 
are subject to change. </p></p></checkInInstructions> <HotelRoomResponse>


7.8 일정 ID 및 확인 번호를 적절히 표시

귀사의 통합에 의해 EAN의 itineraryIdconfirmationNumbers가 고객에게 직접 제공되는 경우, 확인 이메일에 이러한 번호를 명시해야 합니다.

EAN의 자동 고객 확인 이메일/바우처 수신을 사용하지 않는 경우, 담당자가 EAN 고객 지원을 요청하는 경우 담당자가 원래 EAN 일정 ID 및 확인 번호에 접근할 수 있다는 증빙 자료를 제공해야 합니다.

코드 샘플
REST
customerSessionId: "0ABAAA80-6022-F319-1492-8BACB0B09974",
    itineraryId: 177592654,
    confirmationNumbers: 1234,
    processedWithConfirmation: true,
    supplierType: "E",
    reservationStatusCode: "CF",
    existingItinerary: false,

XML
<ns2:HotelRoomReservationResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0ABAAA8A-B59C-1291-4982-BDA2A8793A49</customerSessionId>
<itineraryId>177598724</itineraryId>
<confirmationNumbers>1234</confirmationNumbers>

<processedWithConfirmation>true</processedWithConfirmation>
<supplierType>E</supplierType>
<reservationStatusCode>CF</reservationStatusCode>
<existingItinerary>false</existingItinerary>

7.9 제휴사가 반환될 때 specialCheckInInstructions의 내용이 표시됨

반환될 때 각 객실에 대해 specialCheckInInstructions가 표시되어야 합니다.
이 필드에는 숙박 시설에 예정 도착 시간 알림, 게스트 건물의 다른 장소에서 체크인, 이메일을 통해 숙박 시설에서 고지하는 특수 체크인 지침 등과 같이 체크인에 중요한 정보가 checkInInstructions 필드에 포함될 수 있습니다.
기본 체크인 지침과 동일한 영역에 이 정보를 표시합니다.

샘플 코드
REST
……
"checkInInstructions": "<p><b>Know  Before You Go</b> <br /><ul>  <li>Reservations  are required for massage services and spa treatments. Reservations can  be made by contacting the hotel prior to arrival, using the contact  information on the booking confirmation. </li> <li>One child  12 years old or younger stays free when occupying the parent or  guardian's room, using existing bedding. </li><li>Only  registered guests are allowed in the guestrooms. </li>  <li>Some facilities may have restricted access. Guests can contact  the property for details using the contact information on the booking  confirmation. </li>  </ul></p><p><b>Fees</b> <br  /><p>The following fees and deposits are charged by the  property at time of service, check-in, or check-out. </p>  <ul> <li>Fee for buffet breakfast: AED 88 per person  (approximately)</li>                <li>Rollaway bed fee:  AED 110 per night</li>  </ul> <p>The above list may  not be comprehensive. Fees and deposits may not include tax and are  subject to change. </p></p>",
"specialCheckInInstructions": "The Dubai International Hotel is meant exclusively for transit passengers. Guests who book a stay in the hotel cannot go out of the airport, nor can they retrieve checked-in luggage. Guests should not proceed through passport control, as they will then not be able to access the hotel. Guests should contact the hotel in advance with their flight details so that staff can assist them in arriving at the hotel. Contact details can be found on the booking confirmation. Guests must provide their boarding pass and passport at check-in as this hotel is inside the airport. For more details, please contact the office using the information on the reservation confirmation received after booking.", ……
XML
…… <checkInInstructions><p><b>Know  Before You Go</b> <br /><ul>  <li>Reservations  are required for massage services and spa treatments. Reservations can  be made by contacting the hotel prior to arrival, using the contact  information on the booking confirmation. </li> <li>One child  12 years old or younger stays free when occupying the parent or  guardian's room, using existing bedding. </li><li>Only  registered guests are allowed in the guestrooms. </li>  <li>Some facilities may have restricted access. Guests can contact  the property for details using the contact information on the booking  confirmation. </li>  </ul></p><p><b>Fees</b> <br  /><p>The following fees and deposits are charged by the  property at time of service, check-in, or check-out. </p>  <ul> <li>Fee for buffet breakfast: AED 88 per person  (approximately)</li>                <li>Rollaway bed fee:  AED 110 per night</li>  </ul> <p>The above list may  not be comprehensive. Fees and deposits may not include tax and are  subject to change. </p></p></checkInInstructions>
<specialCheckInInstructions>The Dubai International Hotel is meant exclusively for transit passengers. Guests who book a stay in the hotel cannot go out of the airport, nor can they retrieve checked-in luggage. Guests should not proceed through passport control, as they will then not be able to access the hotel. Guests should contact the hotel in advance with their flight details so that staff can assist them in arriving at the hotel. Contact details can be found on the booking confirmation. Guests must provide their boarding pass and passport at check-in as this hotel is inside the airport. For more details, please contact the office using the information on the reservation confirmation received after booking.</specialCheckInInstructions> ……

8. 기술 및 사기 방지 요구 사항

8.1 제휴사는 각 예약 요청에 대해 제휴사 확인 ID를 제공

모든 예약 요청에 대해 다음을 위해 affiliateConfirmationId 요소를 반드시 사용해야 합니다.

  1. 자체적인 추적
  2. 복수의 양식 제출로 인한 중복 예약 방지/중복 청구 방지
  3. 예약 시간이 초과되었거나 업스트림 타임아웃으로 인해 공백 결과가 반환된 경우 EAN 시스템에서 일정 확인


8.2 논리 구현으로 보류 중 및 오류 상태 처리

보류 중인 공급자 처리 페이지 및 오류 처리 섹션을 참조하면 이러한 요구 사항을 충족시킬 수 있습니다.

PS 상태와 함께 반환되는 예약은 영구 확인(CF), 오류(ER) 상태 또는 최대 3일 중 가장 빠른 옵션이 충족될 때까지 반드시 모니터링되어야 합니다. 대부분의 예약은 몇 시간부터 하루 이내에 해결됩니다.



8.3 제휴사는 각 요청에 대해 고객의 IP 주소를 제공

판매 지점 식별을 위해 고객의 장치 IP 주소가 모든 API 호출에 반드시 포함되어야 합니다.

이렇게 하면 고객에게 관련 콘텐츠 및 위치에 기반한 적합한 요금을 제공할 수 있도록 EAN 시스템에 올바른 POS가 설정될 수 있습니다.

정적, 더미 또는 서버 IP를 포함하면 가격 불일치 오류 및 올바르지 않은 콘텐츠 반환으로 이어집니다.



8.4 제휴사는 각 예약 요청에 대해 세션 ID 제공

첫 번째 호텔 목록 검색을 시작하는 각 고객에 대해 반드시customerSessionId를 사용하거나 나머지 예약 경로에 초기 목록 응답에 반환된 값을 사용해야만 반환되는 콘텐츠가 전 API 호출에 걸쳐 일관되게 적용되고 고객이 쇼핑에서 예약까지 일관된 경험을 가지도록 보장할 수 있습니다.

이 값을 포함하면 개별 고객에 대한 요청 경로를 확실히 연결하기 때문에 파트너 요청 문제에 대한 EAN의 내부 디버깅 프로세스가 훨씬 간편해집니다.



8.5 제휴사는 각 예약 요청에 대해 고객의 사용자 에이전트 문자열 제공

귀사에서 모바일 거래를 사용하는 경우, 고객 장치 유형을 식별하고 고객이 사용 중인 장치에 해당하는 요금을 확인할 수 있도록 반드시 사용자 에이전트 데이터를 제공해야 합니다.

8.6 제휴사는 추가 사기 방지 방법 통합

EAN이 통합의 판매업체 기록인 경우에는 EAN에서 제공하는 추가 사기 방지 요소를 통합해야 할 수 있습니다. 여기에는 API 요청에 대한 추가 데이터 요소 및 JavaScript 코드를 비롯한 여러 항목이 포함될 수 있습니다. 예를 들어 apiExperience, 신용카드의 전체 이름, 고객 이메일, stateProvinceCode, postalCode 등을 통합할 수 있습니다. 판매 담당자가 이 요구 사항이 통합에 적용되는지 여부를 알려 주며 EAN의 사기 방지 통합 가이드 액세스 권한을 제공합니다.