針對特定客房要求訂房。此要求必須透過 HTTPSPOST 方式送出,才能保護旅客的付款資訊。於此要求中送出的資訊必須遵守 EAN 的專屬詐欺和安全性驗證方式規定。

要求中提供的信用卡資訊會於訂房直接付款使用。當旅客收到訂房成功的回應時就必須全額支付訂房費用 (除任何其他費用以外,如客房服務等),即便是旅客提前數月訂房亦然。

請務必使用正確的即時訂房 cid/apiKey 配對。這對成功訂房以及確認將所有應付的佣金支付到正確的帳戶來說非常重要。

若要縮短開發所需時間,或避免必須使用您自己的 SSL 認證,您可以略過此要求,不要將顧客轉至 EAN 的白色標籤範本頁面訂房。如要深入了解此程序相關資訊,請參閱混合式網站


要求格式
XML/REST URL: POST https://book.api.ean.com/ean-services/rs/hotel/v3/res
XML 父項目: <HotelRoomReservationRequest>

若要避免發生 URL 長度限制問題,請傳送 POST 內文中所有的要求值作為 application/x-www-form-urlencoded 資料。不傳送 URL 字串本身中的參數。

對於 XML 要求,必須以與 GET 要求所使用相同的格式傳送一般元素,請勿嘗試將這些值的格式設為 XML 元素。



要求參數

服務特定 URL 參數
名稱 必要 說明
currencyCode 字串 yes 針對訂房要求產生此參數時,請務必使用上個回應的 ChargeableRateInfo 節點中傳回的屬性值。
如果此值使用其他來源,可能造成不相符的錯誤。
additionalData MapEntry 適用的容器應用程式 no

請使用此限訂房使用的參數,在 EAN 聯盟夥伴中心內追蹤訂房。如需完整文件說明,請參閱我們的追蹤訂房頁面



基本參數
名稱 類型 必要 說明
apiExperience 字串 yes

利用此屬性辨識您的原始要求。請在下方提供的設定中,為每個您送出的要求選擇適當的值。

值:
PARTNER_CALL_CENTER - 來自客戶服務中心服務專員的要求
PARTNER_WEBSITE - 來自旅客服務網站的要求
PARTNER_MOBILE_WEB - 來自行動版網站的要求
PARTNER_MOBILE_APP - 來自行動 App 的要求
PARTNER_BOT_CACHE - 來自快取程式的要求
PARTNER_BOT_REPORTING - 來自報告程式的要求
PARTNER_AFFILIATE - 來自提供您專屬合作夥伴庫之 API/平台的要求

hotelId 長整數 yes 要求訂房的飯店 ID
arrivalDate 字串 yes

入住日期 (格式為 MM/DD/YYYY)。沿用客房回應值。

最晚可於飯店所在當地時間晚上 11:59 訂房 (如為太平洋標準時間和太平洋島嶼,時間則為晚上 9:59)。

departureDate 字串 yes 退房日期 (格式為 MM/DD/YYYY)。沿用客房回應值。
supplierType 字串 yes 定義執行訂房時要使用的合約飯店。沿用客房回應值。

值:
E:Expedia Collect
rateKey 字串 yes 可驗證在訂房要求中出現的參數。沿用客房回應值。使用客房回應之第一間Room物件中傳回的 rateKey,以獲得最佳效能。

如果使用的值不是上一則客房回應中提供的值,訂房就會失敗。

如果選擇允許旅客在訂房階段期間修改任何參數,請在新客房要求中送出這些參數以針對此參數取得有效的新值。

如果出現「Invalid QueryId」的錯誤訊息或房價快取錯誤,就表示機碼已經過期或無效。即使是沒有變更任何參數,也請您重新送出之前的客房要求以取得新值。
roomTypeCode 字串 yes 指定要求特定客房使用的代碼。請務必從之前的客房回應中以動態方式取得此代碼。

傳送時需搭配 rateCode
rateCode 字串 yes 指定與要求特定客房配對的房價使用的代碼。請務必從之前的客房回應中以動態方式取得此代碼。

傳送時需搭配 roomTypeCode
RoomGroup 物件 yes 定義房客和客房計數的 Room 陣列適用容器應用程式。請使用與之前客房要求中定義相同的成人、兒童和兒童年齡值。

訂房時特別需要提供此物件的其他參數 - 請參閱下方內容。
RoomGroup.Room 陣列 yes Room 節點的數目可定義要求客房的數目。包含與之前客房要求中定義相同的節點數目和相同的房客計數/年齡參數。
Room.numberOfAdults 整數 yes 客房的成人房客計數。請使用與之前客房要求中定義相同的值。
Room.numberOfChildren 整數 yes (如果 > 0) 客房的兒童房客計數。請使用與之前客房要求中定義相同的值。
Room.childAges 整數的逗號分隔
清單
yes (如果兒童計數 > 0) 兒童房客的年齡 (如果有的話)。請使用與之前客房要求中定義相同的值。EAN 的判斷是年齡介於 0-17 歲的個人為兒童。
Room.firstName 字串 yes 訂房記錄中要入住的房客完整名字。於飯店入住時,姓名必須與房客身分證 (含相片) 上所列姓名完全相同。

僅接受非重音的 Latin ASCII (26 個英文字母)。

最多 25 個字元 - 不可使用稱謂或公司名稱。每間客房的房客姓名可以重複。
Room.lastName 字串 yes 訂房記錄中要入住的房客完整姓氏。於飯店入住時,姓名必須與房客身分證 (含相片) 上所列姓名完全相同。

僅接受無重音的 Latin ASCII (26 個英文字母)。

最多 40 個字元 - 不可使用稱謂或公司名稱。每間客房的房客姓名可以重複。
Room.bedTypeId 字串 yes 旅客的床型選擇代碼 (如果不提供選擇,則使用單一值)。

沿用客房回應中旅客所選客房中 BedType ID 屬性的相符值。

相同客房的多種床型選擇只限透過要求取得,且如果空房不允許,則飯店無需提供。
Room.numberOfBeds 整數 no 值為 1 或 2。僅限要求 - 只有在根據客房回應中傳回的 BedType 選項為合理的情況下才可提供。
Room.smokingPreference 字串 yes (如果使用) 已要求吸菸偏好。如果所選訂房不需使用此元素,請在要求中完全省略此元素。

可能的值:
NS:非吸菸
S:吸菸
E:皆可

只提供於客房回應中傳回的值 - 不使用上述值作為硬式編碼選擇。加入回應中未提供的值將導致訂房失敗。請勿傳送多個值。
affiliateConfirmationId 字串 yes 此值專為訂房追蹤和協助避免重複訂房所使用。

可於送出訂房前產生唯一值,例如 GUID ID (上限為 36 個字元)。如果 API 偵測到此值已與現有的訂房配對,則會以重複為由暫停所有後續訂房。

為避免有效訂房重試遭拒,若您因發生逾時以外的錯誤以致使無法重新嘗試訂房,請一律建立新值

如果 itineraryId 為未知,例如發生訂房要求逾時的情況,則此值也可與行程要求一起送出。
affiliateCustomerId 字串 no 可與合作夥伴追蹤功能一起使用的其他選擇性旅客 ID。此 ID 只限內部使用,因為若意外公開此資訊,可能導致非旅客本人人士得以擷取相關行程資訊。
itineraryId 長整數 no

如果初始訂房要求傳回信用卡錯誤訊息,請從回應中擷取此值,然後在任何後續訂房嘗試中加入此值。

再次通過後,此值就會與您首次要求時產生的現有行程記錄配對。所有重複的信用卡拒絕或錯誤訊息都會整合為單一記錄,以避免於任何統計資料中出現多筆取消資料的情況發生。

只有在使用 EAN 支援 (您沒有自己的支援代理商) 時才向客戶顯示此值。

如果傳回的值是 -1,請勿重新傳送此值。這表示沒有建立行程。傳送錯誤訊息後以新要求再次開始,並在必要時允許客戶進行修正。

chargeableRate 字串 yes 訂房記錄應付的總金額。

沿用客房回應傳回之 ChargeableRateInfo 物件中的 total 值。

送出要求時,此價格將針對提供的客房與價格代碼以最新已知價格做確認。如果最新價格較高,則系統就會傳回一則錯誤訊息,訊息中也會包含較高價格及其相符的 rateKey 值。如果最新價格較低,則要求就會以新的較低價格通過。
specialInformation 字串 no

允許旅客新增要轉交給飯店的額外資訊或要求。

其中任何資訊為僅限透過要求且不保證取得 - 不會使用此欄位與 B2B 客戶服務要求通訊,或傳送任何敏感的個人/金融資訊。

長度上限 256 個字元,且不可使用分行符號或歸位字元。如果此參數中的分行符號或歸位字元沒有移除,系統就可以會發生無法復原的錯誤。

sendReservationEmail 布林值 no

如果是傳送自己的確認電子郵件,則以 false 傳送;如果不是則省略。

只有在您已向帳戶經理或支援部門詢問過您自己的確認電子郵件系統相關資訊後,才能使用此參數。

付款資訊參數
此類參數會定義驗證旅客的信用卡,以及使用旅客信用卡收取費用時使用的資訊。

付款資訊會透過 ReservationInfo 物件和 AddressInfo 物件提供。這兩個物件中的適用值都會使用持卡人的發卡銀行資訊做驗證。

部分於付款驗證和處理時使用的系統無法剖析非英文字元,因此請確認所有參數只允許輸入英文字元,以避免發生資料驗證錯誤。

請參閱信用卡類型頁面的驗證部分,瞭解要求和處理卡片資訊的最佳做法。

名稱 必要 說明
ReservationInfo 物件 yes 包含旅客的聯絡和信用卡資訊。
ReservationInfo.email 字串 yes 旅客的電子郵件地址。EAN (travelnow.com) 的電子郵件確認函會自動傳送至此地址。必須為有效的電子郵件地址,即使是整合方式將此欄位視為限內部使用處理亦然。
完整地址長度上限為 50 個字元,包括 @ 及 .
ReservationInfo.firstName 字串 yes 信用卡持卡人的完整名字。
僅接受非重音的 Latin ASCII (26 個英文字母)。
最多 25 個字元 - 不可使用稱謂或公司名稱。
ReservationInfo.lastName 字串 yes 信用卡持卡人的完整姓氏。
僅接受非重音的 Latin ASCII (26 個英文字母)。
最多 40 個字元 - 不可使用稱謂或公司名稱。
ReservationInfo.homePhone 字串 yes

旅客的住家電話號碼。客服人員可在需要與旅客聯絡以解決他們訂房的相關問題時使用。

數字必須至少 5 個數字長。限制使用 0-9、+、- 及 ( )。

ReservationInfo.workPhone 字串 no 旅客的辦公室電話號碼。數字必須至少 5 個數字長。限制使用 0-9、+、- 及 ( )。
ReservationInfo.extension 字串 no 旅客的辦公室電話號碼分機 (如果需要的話)。最多 5 個字元。
ReservationInfo.faxPhone 字串 no 旅客的傳真號碼。數字必須至少 5 個數字長。限制使用 0-9、+、- 及 ( )。
ReservationInfo.companyName 字串 no 公司名稱 (供員工旅遊收據或稅金用途使用)
ReservationInfo.creditCardType 字串 yes 使用的信用卡類型。如需信用卡類型的特定值和驗證的詳細資料,請檢閱此頁面
ReservationInfo.creditCardNumber 字串 yes 旅客的信用卡號碼。
ReservationInfo.creditCardIdentifier 字串 yes 信用卡安全碼或位於卡片背面的卡片安全值 (CSV 或 CVV)。系統絕對不會在旅客初始輸入和訂房嘗試後儲存此值。
ReservationInfo.creditCardExpirationMonth 字串 yes 信用卡到期月份 (格式為 MM)。
ReservationInfo.creditCardExpirationYear 字串 yes 信用卡到期年份 (格式為 YYYY)。
地址資訊
持卡人地址資訊會以物件分別傳送,不與 ReservationInfo 中的付款信用卡詳細資料一同傳送。特殊值可在開發以執行靜態測試訂房期間,於此物件中使用。
名稱 必要 說明
AddressInfo 物件 yes 包含持卡人的地址資訊。此資訊必須與信用卡提供者的付款記錄相符才能成功處理。
AddressInfo.address1 字串 yes 旅客的街道地址 (最多 28 個字元)。請確認字元的編碼方式正確無誤。
AddressInfo.address2 字串 no 街道地址的選擇性第二行,最多 28 個字元。
AddressInfo.address3 字串 no 街道地址的選擇性第三行,最多 28 個字元。
city 字串 yes 旅客的居住城市。
stateProvinceCode 字串 yes (如為US、
CA、AU)
包含指定城市的州/省代碼 (兩個字元)。如為澳洲,則必須使用下方提供的特殊代碼。

參考資料:
美國代碼
加拿大省份 / 領土代碼
澳洲省份 / 領土代碼
  • 澳洲首都 - AC
  • 新南威爾斯 - NW
  • 北領地 - NO
  • 昆士蘭 - QL
  • 南澳洲 - SA
  • 塔斯馬尼亞 - TS
  • 維多利亞 - VC
  • 西澳洲 - WT
countryCode 字串 yes 包含指定城市的國家/地區的兩字元 ISO-3166 代碼。只能使用如 ISO-3166 解碼表中「官方指派」的國家/地區代碼。
postalCode 字串 yes 旅客的帳單郵遞區號。如為美國則最少 5 個字元,如為其他國家/地區則最多 10 個字元。此項目必須與信用卡發卡銀行的記錄相符,否則訂房無效。
將此欄位標記為"帳單郵遞區號"以減少失敗次數。有效的字元為英文字母、空格、底線 ( _ ) 和連字號 ( - )


訂房回應
確認要求的客房訂房成功,或在沒有確認為成功時提供訂房的狀態資訊。

成功訂房的回應也包含旅客的行程編號、確認編號,以及旅客的客房選擇和支付房價的確認。

因為此回應包含客戶資料,所以透過 HTTPS 以安全的方式傳回該資料給使用者。

回應內容
父項目: HotelRoomReservationResponse


名稱 說明
itineraryId 長整數 訂房資料的 EAN 唯一 ID。

可針對 EAN 或您自己的客服部門與旅客之間所做的任何通訊與訂房確認編號搭配使用。請確認這兩種值皆已明確地提供給旅客。
confirmationNumbers 字串陣列 訂房的確認編號,每間預訂的客房都會有一個確認編號。由 EAN 的訂房資料庫產生。

供 EAN 與旅客之間任何通訊之用,與行程 ID 一起使用。如果您傳送自己的電子郵件需使用 EAN 支援服務 (您沒有自己的代理商),請務必明確地將這兩個值提供給旅客。如果您使用代理商對代理商的支援服務,請勿將此值提供給旅客。
processedWithConfirmation 布林值 在處理訂房時表示飯店是否已自行確認訂房。

如果傳回為 false,則表示飯店尚未傳回該訂房的確認編號。訂房可能會與 PS 狀態一起傳回。

如果是這種情況,EAN 代理商將監督訂房狀態,直到訂房已完全確認為止。系統將寄送確認電子郵件給旅客,告知旅客在飯店提供確認編號後,服務專員就會將此編號轉寄給旅客。
errorText 字串 所有可能已於訂房程序進行期間產生的錯誤訊息內容,除了 EanWSError 共同項目的內容以外。
hotelReplyText 字串 訂房時來自飯店的所有資訊
supplierType 字串 確認處理訂房使用的合約飯店系統。
reservationStatusCode 字串 表示訂房時合約飯店系統中的訂房狀態。預期所有未確認值的合適旅客訊息。

值:
CF 已確認
CX 已取消
UC 未確認。將此狀態視為與 DT 相同。API 永遠不會將此狀態指派給即時訂房。
PS 待處理的供應商。請參閱我們的等候處理指南。
ER 錯誤。可能會在需要代理商協助處理訂房,或是信用卡遭拒時發生。如果傳回信用卡錯誤,以合適的方式通知旅客。如果旅客嘗試再次訂房,則重新傳送訂房失敗回應所傳回的 itineraryId
DT 已刪除的行程 (通常是測試或已失敗的訂房)
existingItinerary 布林值 避免重複訂房時使用的指標,可與 affiliateConfirmationId 要求參數結合使用。如果相同的確認值傳送超過一次,則會與現有的已確認行程一起傳回為 true
numberOfRoomsBooked 整數 確認訂房的客房數目。將與傳回的確認編號數目相符。
drivingDirections 字串 通常為空白,不建議顯示。
checkInInstructions 字串 飯店的入住指示
arrivalDate 字串 入住日期的確認
departureDate 字串 退房日期的確認
hotelName 字串 訂房的飯店名稱
hotelAddress 字串 飯店街道地址
hotelCity 字串 飯店城市
hotelStateProvinceCode 字串 包含指定城市的州/省代碼 (兩個字元)。只傳回 US、CA 和 AU 國家節點。

參考資料:
美國代碼
加拿大省份/地區代碼
澳洲省份/領土代碼
hotelCountryCode 字串 飯店所在國家的 ISO-3166 代碼 (兩個字元)。
hotelPostalCode 字串 飯店郵遞區號
roomDescription 字串 客房訂房的簡短說明
rateOccupancyPerRoom 整數 確認客房訂房的保證入住房客人數。
RoomGroup 物件 定義房客和客房計數的 Room 陣列適用容器應用程式。確認每間預訂客房的房客和床型詳細資料。
RoomGroup.Room 陣列 節點數目將與 numberOfRoomsBooked 的值相符。
Room.numberOfAdults 整數 客房的成人房客計數。
Room.numberOfChildren 整數 客房的兒童房客計數。
Room.childAges 整數的逗號分隔
清單
兒童房客的年齡 (如果有的話)。
Room.firstName 字串 訂房記錄中要入住的房客完整名字。
Room.lastName 字串 訂房記錄中要入住的房客完整姓氏。
Room.bedTypeId 字串 旅客的床型選擇代碼 (如果不提供選擇,則使用單一值)。
Room.bedTypeDescription 字串 確認床型選擇的描述。
Room.numberOfBeds 整數 值為 1 或 2
Room.smokingPreference 字串 確認要求的吸菸偏好。
Room.ChargeableNightlyRates 陣列 客房 NightlyRate 陣列的容器。依住宿期間的順序,傳回個別客房的特定房價。

針對多間客房的每晚平均費用,使用 nightlyRatesPerRoom 提供的值。

minorRev=29 以上時傳回。
ChargeableNightlyRates.NightlyRate 物件

提供要求之住宿期間內住宿一晚的房價。

表示促銷房價、基本房價及套用促銷後的房價 (若有的話)。僅包含屬性。

若要求多間客房,則此值為所有客房的每晚平均費用。EAN 建議顯示多間客房的房價時,使用新的每房 ChargeableNightlyRates 陣列。

針對 minorRev=28 以下的多間客房要求,此元素僅會提供第一間客房的房價,而不會提供平均房價。

屬性:

promo 布林值 表示此晚住宿房價是否有套用促銷價格。
rate 字串 套用促銷 (如果有的話) 後的每晚房價。
baseRate 字串 套用促銷 (如果有的話) 前的每晚房價。
ChargeableNightlyRates.
ConvertedNightlyRates
物件 轉換成旅客要求的貨幣價格資訊。僅在飯店或旅客市場地區無法以要求的貨幣計費時傳回。包含與 ChargeableNightyRates 相同的屬性。 minorRev=29 以上時傳回。
RateInfos RateInfo 適用的容器應用程式 包含 RateInfo 元素的陣列,可針對個別客房提供詳細的房價資訊。

如果您使用舊版整合方式,且執行 minorRev=6 或較舊參數,RateInfo 將不會與 RateInfos 容器應用程式一起傳回。
RateInfos.RateInfo 物件 包含多種不同物件和個別值以內的單一客房所有房價資訊。

屬性:
priceBreakdown布林值 表示是否包含完整房價分類,包括稅金和要支付的總費用。
promo 布林值 表示房價是否為促銷價格。
rateChange 布林值 表示住宿期間是否至少有一晚的房價不同。
RateInfo.cancellationPolicy 字串 飯店的取消政策。為必要顯示項目。以低於 minorRev=20 的回應本文傳回
RateInfo.CancelPolicyInfoList 陣列 取消政策的特定詳細資料,通常是決定懲罰期和取消所產生的懲罰時間。以低於 minorRev=20的回應傳回本文
檢閱 CancelPolicyInfo 陣列的詳細資料
RateInfo.nonRefundable 布林值 確認客房回應傳回的值。如果成功訂房回應傳回 true,應付的金額就是最終金額。限 Expedia Collect 可用。以低於 minorRev=20 的回應本文傳回
RateInfo.ChargeableRateInfo 物件 此物件的屬性包含訂房應支付的絕對總金額以及平均房價和總價。物件內的節點提供每晚房價和附加費的詳細資料。

屬性:
total 字串 訂房應支付的所有每晚房價、稅金和附加費總金額。此為必須顯示讓旅客查看,且需包含在訂房要求中的總值。
surchargeTotal 字串 TaxAndServiceFeeExtraPersonFee 的總值,來自 Surcharges 陣列。
nightlyRateTotal 字串 此物件中包含的 nightlyRatesPerRoom 陣列內所有值的總值。
maxNightlyRate 字串 所有傳回的房價中最高的每晚房價
currencyCode 字串 傳回房價的貨幣代碼
commissionableUsdTotal 字串 計算合作夥伴佣金使用的金額,以美金 (USD) 為單位。附加費較低的每晚房價總金額。
averageRate 字串 所有每晚房價平均值,包含適用的促銷值且不含附加費。
averageBaseRate 字串 所有每晚房價平均值,而且沒有任何適用的促銷值或附加費。如果沒有促銷,則將傳回與之前相同的值。
ChargeableRateInfo.nightlyRatesPerRoom 陣列 NightlyRate 陣列適用的容器應用程式。有 size 屬性以表示陣列中的節點數目,此數目將與要求中的住宿天數相對應。依住宿期間的順序傳回房價。
nightlyRatesPerRoom.NightlyRate 在要求的住宿期間內一晚住宿的房價詳細資料。表示促銷價格、基本價格及套用促銷後的價格 (如果適用)。僅包含屬性。

屬性:
promo 布林值 表示此晚住宿房價是否有套用促銷價格。
rate 字串 套用促銷 (如果有的話) 後的每晚房價。
baseRate 字串 套用促銷 (如果有的話) 前的每晚房價。
RateInfo.promoType 字串 表示傳回的任何促銷是否為行動版特定或標準促銷傳回行動版促銷的 Mobile 和所有其他的 Standard
如果要傳回行動版促銷,您必須透過合適的 customerUserAgent 字串辨識您的行動網站或 App。
minorRev=21 以上參數時即可使用。
RateInfo.depositRequired 布林值 表示訂房時是否需支付訂金才能確認訂房。
RateInfo.rateType 字串 表示傳回的房價是否已透過 EAN 於線上付款或之後將於飯店付款。與線上付款的空房情況 MerchantStandard 值一起傳回,或針對之後於飯店付款完全不傳回。
minorRev=18 以上參數時即可使用。
ChargeableRateInfo.Surcharges 陣列 Surcharge 陣列適用的容器應用程式。此陣列會逐項列出組成 surchargeTotal傳回值的個別附加費。有 size 屬性以表示陣列中的節點數目。
Surcharges.Surcharge 詳細列出單一附加費的金額與類型。僅包含屬性。

屬性:
amount 字串 特定附加費的金額
type 字串 附加費名稱。
可能的值:
  • TaxAndServiceFee
  • ExtraPersonFee
  • Tax
  • ServiceFee
  • SalesTax
  • HotelOccupancyTax

TaxAndServiceFeeExtraPersonFee 可計入 surchargeTotal。所有其他值都是 TaxAndServiceFee 值的個別元件。


注意:根據紐約州法律規定,必須顯示 SalesTaxHotelOccupancyTax 附加費類型。確保您期望和擷取這些值,以在最終房價分類中顯示為 "飯店住宿與銷售稅" 。
RateInfo.HotelFees 陣列

此元素會顯示由飯店收取的特定稅金與費用明細,如果不顯示,則不會在附加費陣列中特別詳細列出。

此元素中所有值都會由飯店在旅客入住或退房時收取。這些值不屬於訂房時收取的任何費用。

產生時,使用此元素即可符合主要搜尋引擎和彙總工具所需的價格 / 稅金 / 費用顯示格式。

請注意,任何傳回的費用皆為訂房總價的總計值,包括說明此為每晚或每間客房的房價。範例:每晚房價為 $10 並住宿 4 晚,總價會以 40.00
的值表示
包含 size 屬性以表示包含費用筆數。

minorRev=19 以上參數時即可使用。

HotelFees.HotelFee

包含單筆費用的說明、金額和貨幣屬性。

詳細列出任何營業稅、州/省/城市稅、度假區費用,或任何其他必須收取的總計費用。

於可訂房貨幣中傳回的費用會以 ChargeableRateInfocurrencyCode 屬性表示。

屬性:

description 字串 費用的類型,例如營業稅或渡假區費用
amount 字串 總計費用值

minorRev=19 以上參數時即可使用。

ValueAdds ValueAdd 適用的容器應用程式 包括所有此訂房所包含的新增值有 size 屬性以表是傳回的新增值數。

minorRev=28 以上參數時即可使用。
ValueAdds.ValueAdd 陣列

包括 description 元素以敘述由提供的客房及價格所供應的免費服務,例如早餐或無線網際網路。

minorRev=28 或以上時可使用。

ConvertedRateInfo 物件 轉換成旅客要求的貨幣價格資訊。只有在付款使用和轉換的貨幣不同時才會傳回,也就是說,當飯店無法接受旅客要求的貨幣時。包含與 ChargeableRateInfo 相同的屬性。
此物件中傳回的值為不可訂房。嘗試以轉換值訂房將導致系統發生錯誤。
RoomGroup 物件 確認相同的 RoomGroup 物件內容因適用於提供的房價,所以已於要求中傳送。