1.一般要求

1.1 合作夥伴不得視自己為飯店的合約飯店

無論貴公司是屬於哪一種形式的業務,舉凡整合商、相關網站、行銷資料等,均不得聲稱或暗示貴公司是 Expedia 聯盟網 (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 回傳的價格或訂房條件

請勿變更述及房價、飯店和設施實際費用的價格或訂房相關金額。其中包括不得遺漏或模糊上述各項資料。

若不影響內含語意的變更則可接受,如把「游泳池」改成「泳池」、「無線網路」改成「無線上網」。"

除了在回應中提供的資訊外,請勿擅自提供額外資訊。EAN 對合作夥伴不當修改或擅加 API 資料所產生的糾紛恕不負責。

範例
此範例顯示將合作夥伴費用加進訂房總費用的正確與錯誤方法。


1.6 須清楚顯示的客戶服務編號,包括線上客戶服務工具的連結

若您不使用 EAN 客戶服務中心,請清楚顯示 EAN 服務編號或貴公司的服務編號。亦請提供線上客戶服務工具的連結,讓旅客可取回並檢查其訂房。

範例
客戶服務編號和自助服務工具顯示在上方功能表/標題區域中


1.7 請正確使用並顯示信用卡規定

合作夥伴在要求、處理或儲存旅客信用卡資料時,必須遵守 PCI (支付卡產業) 的規定。相關規定的完整參考資料位於 PCI 安全標準官方網站上。

為了協助您遵循對整合至為關鍵的 PCI 規定,EAN 為合作夥伴提供針對特定目標的指南:developer.ean.com/docs/credit-card

若遵守以上指南,可確保:

  • 所有訂房要求均使用 CSV
  • 卡號依各訂房相關頁面上的顯示和儲存要求截斷
  • SSL 用於所有訂房相關頁面 ()
  • 符合品牌同位要求



1.8 為適用合作夥伴提供 PCI 合規辨識項

若 EAN 為 Merchant of Record,則必須提供合規證明 (AOC) 等 PCI 合規辨識項。

EAN 合作夥伴必須使用 PCI 安全標準委員會的自我評估問卷檔案 "SAQ D - Merchants" 來產生適當的 AOC。

您可查看 SAQ 相關說明和指南。可在官方 PCI 安全標準文件庫中找到 "SAQ D - Merchants" 檔案,或直接將 SAQ D - Merchants 檔下載為 PDFWord 文件。

1.9 下游合作夥伴必須先同意 EAN 使用條款,而後才能存取 EAN 保留房

為使用者/旅客訂房的服務專員須同意 EAN 的下游合作夥伴協議。請將下游合作夥伴協議放在封閉平台環境中待服務專員接受。此協議隨附於貴公司與 EAN 簽署的合作夥伴合約中。

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 稅額與費用請清楚分門別類為獨立一行項目。

系統所回傳的 TaxAndServiceFee 金額請針對各項稅額和/或房價明細個別顯示,如空房資訊、訂房形式和 Expedia Collect 飯店的確認結果。

當提及 Expedia Collect 保留房的各項稅額與費用總額時,請在貴公司網站上加註以下文字。顯示內容請依據飯店據點,而非旅客所在地。

  • 歐洲:「應繳稅款」
  • 所有其他區域:「應繳稅款與服務費」
範例 (歐洲)


4.2 銷售稅和飯店入住稅在適用時需個別申報。

Surcharges 陣列回傳 salesTaxhotelOccupancyTax 時,請在您的費用總表上個別顯示這些項目。這些項目會詳細列出由當地市政府或州政府所徵收的稅金,請依照當地法律一一顯示。

徵收飯店入住稅金的州包括 (不限於) 紐約州、賓夕法尼亞州、德克薩斯州和麻薩諸塞州。



4.3 床型說明將會顯示在各客房上

BedTypes 陣列未回傳或只回傳一個值的空房回應,請顯示各客房的 rateDescriptionroomTypeDescription 值,通常會回傳同樣的值。

BedTypes 陣列回傳多個選項時,請提供旅客這些選項讓他們選擇自己喜好的房型。請使用 bedTypeId 參數在訂房要求中回傳旅客選擇的床型 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
nonRefundable 會在 CancelPolicyInfoList 陣列和 rateType 之間回傳。
"CancelPolicyInfoList": {
[array contents omitted for example]
},
"nonRefundable": true,
"rateType": "MerchantStandard",
"promoType": "Standard",
"currentAllotment": 13,
"guaranteeRequired": false,
"depositRequired": true,
XML
nonRefundable 會在 CancelPolicyInfoListHotelFees 之間回傳。
  …
  </CancelPolicyInfo>
</CancelPolicyInfoList>
<nonRefundable>true</nonRefundable>
<HotelFees size="1">
<HotelFee description="MandatoryTax" amount="56.99" />
</HotelFees> …

5.訂房頁面

5.1 敏感資料將會進行 SSL 加密

傳送或傳輸敏感資料時,必須使用 SSL 加密。敏感資料包括房客姓名、電話號碼或電子郵件、支付卡詳細資料和訂房/行程收據和確認頁面。

若旅客的瀏覽器未使用安全連線傳送或接收此資料,將無法正確嵌入 SSL。


範例
在瀏覽器中所檢視的有效 SSL


5.2 請提供各項費用的清楚明細

您的訂房頁面必須清楚列出各項費用。明細必須清楚且完整提供 SurchargeHotelFees 陣列所回傳的各項費用。

請記得將 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>
  ……
  
範例


5.3 稅額與費用請清楚分門別類為獨立一行項目。

系統回傳 TaxAndServiceFee 的金額請針對各項稅額和/或您的訂房表單上所顯示的房價明細顯示。

針對所有 Expedia Collect 保留房,當在房價明細上提及「稅額與費用」總額時,請在貴公司網站上加註以下文字。顯示內容請依據飯店據點,而非旅客所在地。

  • 歐洲:「應繳稅款」
  • 所有其他區域:「應繳稅款與服務費」


5.4 請清楚顯示收取的總房價

範例



5.5 請將合作夥伴服務費或訂房費用分開

若您要索取訂房費或服務費,請向旅客清楚說明此額外費用是由貴公司、合作夥伴而非 EAN 所收取 (如並非住宿的額外費用)。此費用不含在現有費用總表中。
合作夥伴訂房費或服務費不得列入總房價,應另行計算。

範例:
在以下範例中,客房的稅金和服務費用加起來共 27.09 歐元。在錯誤範例中,系統將合作夥伴服務費用併入 EAN 總費用中。在正確範例中,合作夥伴服務費用將另外計算,且清楚標明計費來源。



5.6 請個別申報市政/義務稅。

系統回傳 MandatoryTax 數值時,請在您的費用總表上將此數值個列出。這類費用將由飯店直接收取,並非標準追收稅款的一部分。

範例



5.7 銷售稅和飯店住宿稅請在必要時個別申報。

Surcharges 陣列回傳 salesTaxhotelOccupancyTax 時,請在您的費用總表上個別顯示這些項目。這些項目會列出當地市政單位或州郡所徵收之稅款,請依照當地法律一一顯示 (通常只限美國)。請注意這些稅額將不會針對試訂房退稅,僅會針對適用行政區的實際訂房退稅。

徵收飯店住宿稅的美國州郡包括但不限於紐約、賓夕法尼亞、德克薩斯和麻薩諸塞。



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 清楚標明取消政策

在您的訂房結帳頁面上允許旅客確認購買前,請針對精選客房提供取消政策,並要求旅客接受該政策。
旅客在未同意客房特定取消政策前皆無法訂房。

取消政策必須可隨時透過 cancelPolicyInfo 陣列從即時 API 回應中取得。

可納入此協議做為旅客同意您使用條款的一部份,如 "[選擇此核取方塊/繼續訂房/等] 後,代表您已詳讀並接受我們的使用條款與您所選客房的取消政策。"

範例

5.13 各筆訂房都須記錄電話號碼

訂房必須記錄旅客可用的連絡電話。在您訂房記錄 homePhone 欄位上記錄電話號碼。請在旅客入住前通知此他們該電話號碼將在訂房發生問題時做為連絡之用。

範例



6.確認頁面

6.1 將清楚顯示收取的總房價

範例

7.確認電子郵件/憑證

7.1 若使用自己的電子郵件,將會清楚顯示詳細費用表。

若您選擇不用 EAN 的自動旅客確認電子郵件/憑證,您寄給旅客的電子郵件/憑證請附上詳細費用表。


7.2 稅額與費用請清楚分門別類為獨立一行項目。

系統所回傳的 TaxAndServiceFee 金額請針對各項稅額和/或房價明細個別顯示,如空房資訊、訂房形式和 Expedia Collect 飯店的確認結果。

當提及 Expedia Collect 保留房的各項稅額與費用總額時,請在貴公司網站上加註以下文字。顯示內容請依據飯店據點,而非旅客所在地。

  • 歐洲:「應繳稅款」
  • 所有其他區域:「應繳稅款與服務費」


7.3 合作夥伴服務費或訂房費用必須清楚分開

若您要索取訂房費或服務費,請向旅客清楚說明此額外費用是由貴公司、合作夥伴而非 EAN 所收取 (如並非住宿的額外費用)。此費用不含在現有費用總表中。
合作夥伴訂房費或服務費不得列入總房價,應另行計算。

範例:
在以下範例中,客房的稅金和服務費用加起來共 27.09 歐元。在錯誤範例中,系統將合作夥伴服務費用併入 EAN 總費用中。在正確範例中,合作夥伴服務費用將另外計算,且清楚標明計費來源。



7.4 請個別申報市政/強制稅金

若要訂房的飯店提前回傳 MandatoryTax ,請在預先訂房價格表上個別將此金額列出。這類費用將由飯店直接收取,並非標準追收稅款的一部分。

範例



7.5 Travelscape LLC 或 Vacationspot、SL 將視為供應商

您必須根據飯店的銷售點,將飯店的合約飯店清楚標示為 Travelscape LLCVacationspot, SL,如下所示:

  • Vacationspot: 適用所有法國和比利時的銷售點 (PoSa),例如法國:Mytravel.fr 或比利時:Mytravel.be
  • Travelscape: 適用於所有其他銷售點。


7.6 床型說明將會顯示在各客房上。

在您的確認電子郵件/兌換券中確認旅客所選擇的床型。若 BedTypes 陣列未回傳或只回傳一個值的空房回應,請顯示各客房的 rateDescriptionroomTypeDescription 值,通常會回傳同樣的值。

BedTypes 陣列回傳多個選項,請從飯店的客房選擇頁面中確認旅客的選擇。請使用 bedTypeId 參數在訂房要求中回傳旅客選擇的床型 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>

8.技術與詐騙防治規定

8.1 合作夥伴將針對各筆訂房要求提供唯一的合作夥伴確認 ID

針對各筆訂房要求,您必須使用 affiliateConfirmationId 元素,旨在:

  1. 自我追蹤
  2. 防止重複訂房/從多個提交的表格收取重複費用
  3. 若訂房逾時或因上游逾時而回傳空白結果時,可在 EAN 系統上檢查行程。


8.2 已實作邏輯以處理擱置和錯誤狀態

請詳細參閱擱置中合約飯店程序頁面和我們的錯誤處理區段,協助確保您的執行方式符合此要求。

必須監控回傳 PS 狀態的訂房,直到該訂房的狀態恢復為永久確認 (CF)、錯誤 (ER) 狀態或持續長達 3 天,以先達成的狀態為主。多數訂房將在幾個小時到一天內處理完畢。



8.3 合作夥伴將透過各筆訂房要求提供旅客 IP 位址

旅客的裝置 IP 位址必須從所有 API 呼叫中通過,以識別銷售點。

此要求可確保在 EAN 系統內設定正確的銷售點,根據旅客的地點提供他們相關內容與最適合的房價。

若通過靜態 IP、虛擬 IP 或伺服器 IP,將會導致房價不符錯誤並回傳錯誤內容。



8.4 合作夥伴將針對各筆要求提供工作階段 ID

必須針對每位旅客的第一筆飯店清單搜尋使用 customerSessionId,或使用後續訂房路徑中初始清單回應回傳的值,以確保回傳的內容在每次 API 呼叫時都保持一致,且旅客從購物到訂房的整個過程都能享受一致無誤的體驗。

此數值將能大幅減輕 EAN 處理合作夥伴要求相關問題的內部偵錯程序,該程序明確連結每位旅客的要求路徑。



8.5 合作夥伴將提供各筆要求的旅客使用者代理程式字串。

若您可處理行動交易,在每一次 API 呼叫時傳送使用者代理程式資料,以辨識旅客裝置類型確保旅客收到其使用裝置相關的訂房費用。