藝龍酒店API接口文檔

1、藝龍網(wǎng)信息技術（北京）有限公司藝龍酒店api接口文檔文檔歷史：文檔整理文檔版本日 期說明李繼東1.1.02010-11-10在elong hotel組提供的文檔基礎上進行了重新整理李繼東1.1.12011-1-081、增加了即時確認信息接口（第五部分第3個的instantconfirm接口）2、酒店靜態(tài)文件中增加的酒店特殊信息提示（靜態(tài)文件hotel_cn.xml中的availpolicy字段）3、啟用了新的api測試環(huán)境地址4、酒店的部分含早產(chǎn)品在api接口中的展示（gethotellist接口和gethotelorderlist接口）李繼東1.1.22011-2-1修改了bookingru

2、le返回值說明李繼東1.1.32011-2-281、優(yōu)化靜態(tài)數(shù)據(jù)文件更新方式，提供新版的靜態(tài)文件更新方式（見第三部分靜態(tài)文件更新）2、增加了多訂單號查詢接口（見第五部分第6接口）趙春風1.1.42011-03-071. 完善開發(fā)流程說明2. 修訂預訂規(guī)則，擔保規(guī)則，附加服務，促銷規(guī)則等規(guī)則描述一、概述3二、基本開發(fā)步驟3三、靜態(tài)數(shù)據(jù)31、通過hotelid調(diào)用酒店信息文件更新方式42、打包下載更新方式43、靜態(tài)文件字段說明5四、代理商登錄接口login11五、api動態(tài)接口121. 酒店價格查詢接-gethotellist132. 提交訂單接口 submithotelorder243. 獲取訂

3、單及時確認信息接口instantconfirm304訂單查詢接口 gethotelorderlist325. 根據(jù)orderid獲取訂單gethotelorderdetailbyorderid366、根據(jù)訂單號id獲得多個訂單信息447. 訂單取消接口 cancelhotelorderbyid49六、接口返回的錯誤信息50七、api測試工具介紹51一、概述 api接口是藝龍?zhí)峁┙o合作方使用的酒店數(shù)據(jù)倉庫，接口提供兩部分數(shù)據(jù)，一部分是api接口靜態(tài)數(shù)據(jù)，此數(shù)據(jù)主要包含酒店的基礎信息等內(nèi)容；另外一部分為動態(tài)數(shù)據(jù)，主要包括藝龍酒店價格的實時查詢、訂單實時提交、酒店訂單查詢、訂單詳細信息查詢、訂單取消

4、功能。 注意：由于訂單變更涉及到太多組合條件，api接口暫時不提供訂單變更功能；如需要進行酒店訂單變更，可以先取消原來訂單，然后再重新下取新單。 在使用藝龍api接口進行接入前，建議先在本地建立酒店信息、地理位置信息等數(shù)據(jù)庫，把酒店靜態(tài)數(shù)據(jù)、地理位置靜態(tài)數(shù)據(jù)通過程序解析到本地數(shù)據(jù)庫，然后通過各個酒店的cityid、hotelid（酒店id）、cityid等查詢條件來查看酒店的實時價格做訂單處理操作。 開發(fā)時需要注意如果某些節(jié)點沒有數(shù)據(jù)，生成請求xml時該節(jié)點也需要包含，不能省略，否則接口會返回錯誤二、基本開發(fā)步驟1、 向藝龍銷售人員索取api測試環(huán)境賬號和說明文檔，做接口接入工作前的準備，同時

5、提供上線后預期的搜索量和成單量，并發(fā)數(shù)等相關性能指標， 藝龍會根據(jù)實際情況進行上線前的系統(tǒng)準備，準備時間一般在2周左右2、 下載api接口文檔靜態(tài)數(shù)據(jù)（最好采用flashget、迅雷等下載工具下載），通過程序來解析數(shù)據(jù)格式，并把解析到的數(shù)據(jù)導入到本地（或服務器）上的數(shù)據(jù)庫中3、 確定開發(fā)語言及需要調(diào)用的動態(tài)接口，并閱讀動態(tài)接口文檔參數(shù)，對通過動態(tài)接口調(diào)用到的數(shù)據(jù)規(guī)劃自己頁面的展示方式4、 通過藝龍api測試環(huán)境調(diào)試接口（僅使用部分接口就調(diào)試部分動態(tài)接口），對所需要的接口爭取均能調(diào)試通過，需要重點測試各種場景下的擔保訂單(首晚/全額，日期擔保/房量擔保)， 不同預訂規(guī)則下的預訂場景，否則上線后可

6、能會產(chǎn)生問題，需要配合藝龍方進行不同的場景測試，直至得到藝龍銷售人員驗收通過5、 測試環(huán)境驗證通過后，向藝龍銷售人員申請開通api正式環(huán)境賬號， 藝龍銷售人員確認系統(tǒng)功能測試完畢，藝龍系統(tǒng)接入準備完畢， 排定雙方的上線日期后開通生產(chǎn)環(huán)境帳戶6、 更改代碼中api正式環(huán)境http地址以及api賬號，把已開發(fā)好的系統(tǒng)切入到正式環(huán)境，在正式環(huán)境下一兩個訂單做簡單測試（測試訂單時請聯(lián)系相關銷售人員，測試場景需涵蓋主要擔保規(guī)則和預訂規(guī)則，訂單入住日期要在測試日期推后較長時間，以保證可以取消和不產(chǎn)生擔?？劭?，測試完的訂單要及時進行取消, 否則產(chǎn)生的賠款由代理商自己負責）7、 測試正常后，把自己網(wǎng)站或系統(tǒng)接

7、入正式api接口上線監(jiān)控2-3周，發(fā)現(xiàn)問題請及時和對口銷售或藝龍技術支持人員反饋三、靜態(tài)數(shù)據(jù)目前，靜態(tài)數(shù)據(jù)文件的初始化更新支持兩種方式，一種為通過hotelid調(diào)用酒店信息文件更新方式，一種為打包下載更新方式（此種方式將逐步放棄不用） 1、通過hotelid調(diào)用酒店信息文件更新方式（1）、api靜態(tài)數(shù)據(jù)文件包含以下： hotellist.xml 提供了藝龍所有酒店的hotelid、酒店中英文名稱、上線時間、到期時間等信息，具體字段定義見“靜態(tài)文件字段說明”，下載地址為：http:/114-/xml/hotellist.xml 每一家酒店均有一個xml文件（以hotel

8、id作為文件名） 提供了藝龍每一家酒店詳細的酒店基礎信息數(shù)據(jù)，包括酒店名稱、id、地址、介紹等內(nèi)容，具體字段定義同hotel_cn.xml文件中的字段定義，下載地址為：中文版本為：http:/114-/xml/perhotelcn/hotelid.xml英文版本為：http:/114-/xml/perhotelen/hotelid.xml 獲取指定酒店信息請?zhí)鎿Q上面鏈接中的hotelid其他靜態(tài)數(shù)據(jù)文件：包括geo_cn.xml(英文版對應geo_en.xml)、hotelbaseinfocodes_cn.xml(英文版對應hotelbase

9、infocodes_en.xml)同打包下載更新方式靜態(tài)文件（2）、靜態(tài)數(shù)據(jù)文件的初始化及更新 初始化：首先下載hotellist.xml文件到本地，通過hotellist文件解析出每家酒店的hotelid，然后通過調(diào)用每一家酒店的xml文件把酒店靜態(tài)信息解析到本地數(shù)據(jù)庫 更新：首先下載hotellist.xml文件到本地，通過hotellist.xml文件解析出藝龍到期酒店的hotelid，然后刪除本地數(shù)據(jù)庫此家酒店的基礎信息數(shù)據(jù)；再通過hotellist.xml文件解析出藝龍新簽酒店的hotelid，再調(diào)用每一家新簽酒店的xml文件把酒店靜態(tài)信息解析到本地數(shù)據(jù)庫 （3）、數(shù)據(jù)更新頻率 本更

10、新頻率為hotellist.xml、各個酒店單獨的xml文件為每天更新一次；而geo_cn.xml、hotelbaseinfocodes_cn.xml則為每周更新一次（更新時間為每周六） 2、打包下載更新方式（1）、api靜態(tài)數(shù)據(jù)文件包含三個， 三個文件均以靜態(tài)xml文件方式來提供，其中hotel_cn.xml提供的每一家酒店的基礎信息，包括酒店名稱、id、地址、介紹等內(nèi)容geo_cn.xml提供了每一城市的地理位置信息，包括行政區(qū)、商業(yè)區(qū)等內(nèi)容hotelbaseinfocodes提供了接口中部分參數(shù)字典信息 三個靜態(tài)文件下載地址為：http:/114-/xml/文件

11、名中文版本文件名為 geo_cn.xml, hotel_cn.xml, hotelbaseinfocodes_cn.xml英文版本文件名為 geo_en.xml, hotel_en.xml, hotelbaseinfocodes_en.xml（2）、靜態(tài)數(shù)據(jù)文件的更新 由于靜態(tài)文件日常更新較慢，并且數(shù)據(jù)變化比較??；因此，藝龍系統(tǒng)將在每周六凌晨2點對此三個靜態(tài)文件進行一次更新，更新方式為累積更新。 對于靜態(tài)文件的更新，藝龍建議合作方每一周或兩周更新一次，更新時可以先清空本地數(shù)據(jù)庫，然后進行插入操作。 由于這三個文件中，hotel_cn.xml比較大（160mb-200mb之間），建議先用下載工具

12、（迅雷、flashget）把此文件下載到本地，然后通過程序解析的方式把此文件解析到本地數(shù)據(jù)庫。 3、靜態(tài)文件字段說明 、hotellist.xml文件名稱描述備注addtime此酒店簽約時間日期格式，帶時間deltime此酒店刪除作廢時間日期格式，帶時間hotel_id酒店id可據(jù)此去perhotelcn文件夾下取酒店信息（peihotelcn下文件命名方式：hotel_id+.xml）hotel_name酒店中文名hotel_name_en酒店英文名isreserve此酒店是否可用0表示可用，1、 2表示酒店已刪除modifytime此酒店最近一次修改時間暫時不生效 、hotel_cn.xm

13、l文件（示例文件見附件） 名稱描述備注id酒店id八位數(shù)字來表示dateupdated酒店最新更新時間name酒店名稱address酒店地址zip酒店郵編category酒店星級-1，0均代表經(jīng)濟型酒店typology酒店類別目前只有hroomnumber酒店總房間數(shù)量availpolicy酒店特殊信息提示activationdate暫時不用usersrating用戶評分,目前沒有賦值elongranking酒店在藝龍的排序，暫時不用templatetype暫時不用translations暫時不用doublepricemin暫時不用doublepricemax暫時不用currency暫時不用l

14、at酒店所在位置的緯度用于位置搜索lon酒店所在位置的經(jīng)度用于位置搜索country酒店所在國家region酒店區(qū)域暫時不用，空值province酒店所在省份id表示，省份名稱和geo中province關聯(lián)city酒店所在城市id表示，城市名稱和geo中cityid關聯(lián)businesszone酒店所在商業(yè)區(qū)id表示，商業(yè)區(qū)名稱和geo中commerciallocation關聯(lián)district酒店所在行政區(qū)id表示，城市名稱和geo中district關聯(lián)propertyurl酒店在網(wǎng)站中的詳細頁urlintroeditor酒店介紹信息對酒店的詳細介紹ccaccepted

15、可支持的信用卡支持的信用卡為：銀聯(lián)、jcb、mastercard、visadescription酒店描述對酒店的簡單描述images酒店圖片信息此為一節(jié)點，節(jié)點字段解釋見下表airportpickupservice酒店免費接機信息此為一節(jié)點，節(jié)點字段解釋見下表generalamenities酒店服務設施信息此為一節(jié)點，節(jié)點字段解釋見下表roomamenities房間服務設施信息此為一節(jié)點，節(jié)點字段解釋見下表recreationamenities休閑服務設施信息此為一節(jié)點，節(jié)點字段解釋見下表conferenceamenities會議服務設施信息此為一節(jié)點，節(jié)點字段解釋見下表diningameni

16、ties餐飲服務設施信息此為一節(jié)點，節(jié)點字段解釋見下表trafficandaroundinformations周邊交通信息此為一節(jié)點，節(jié)點字段解釋見下表surroundingcommerces周邊商務信息此為一節(jié)點，節(jié)點字段解釋見下表surroundingrestaurants周邊餐飲信息此為一節(jié)點，節(jié)點字段解釋見下表surroundingattractions周邊景致信息此為一節(jié)點，節(jié)點字段解釋見下表surroundingshops周邊購物信息此為一節(jié)點，節(jié)點字段解釋見下表featureinfo酒店特色信息此為一節(jié)點，節(jié)點字段解釋見下表roominfo酒店房型信息此為一節(jié)點，節(jié)點字段解釋見下

17、表phone酒店電話(前臺)fax酒店傳真(前臺)openingdate酒店開業(yè)日期renovationdate酒店裝修日期landmarks酒店附近標志物 id表示， 標志物名稱對應geo中l(wèi)andmarklocations列表節(jié)點包含多個子節(jié)點，節(jié)點對應字段說明為：名稱描述備注imageurl圖片url地址imgtype圖片類型？title圖片標題imgnum 節(jié)點下對應字段說明為：名稱描述備注extensiondata暫時不用enddate免費接機結束日期endtime接機每天結束時間startdate免費接機開始日期starttime接機每天開始時間節(jié)點下對應字段說明為：名稱描述備注e

18、xtensiondata暫時不用amenitysimplelist服務設施列表overview酒店服務設施概述節(jié)點下對應字段說明為：名稱描述備注extensiondata暫時不用amenitysimplelist服務設施列表overview房間服務設施概述節(jié)點下對應字段說明為：名稱描述備注extensiondata暫時不用amenitysimplelist服務設施列表overview休閑服務設施概述節(jié)點可能包含多個子節(jié)點，對應字段說明為：名稱描述備注amenitylist會議室列表包含多個子節(jié)點overview酒店會議室設施概述子節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不

19、用amenitydetail會議室介紹amenityname會議室名稱節(jié)點節(jié)點可能包含多個子節(jié)點，對應字段說明為：名稱描述備注amenitylist餐廳列表包含多個子節(jié)點overview酒店餐廳設施概述子節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不用amenitydetail餐廳介紹amenityname餐廳名稱節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不用overview周邊交通信息概述trafficandaroundinformationlist周邊交通信息列表的子節(jié)點可能包含多個節(jié)點，其對應字段說明為：名稱描述備注extensiondata暫時不用

20、distances到酒店距離name周邊交通名稱note備注信息timetaken所用時間transportfee交通花費費用transportations乘坐的交通工具參見hotelbaseinfocodes_cn.xml信息節(jié)點包含多子節(jié)點，節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不用distances到酒店距離name周邊商業(yè)區(qū)名稱note備注信息timetaken所用時間transportfee交通花費費用transportations乘坐的交通工具參見hotelbaseinfocodes_cn.xml信息節(jié)點包含多子節(jié)點，節(jié)點對應字段說明為：名稱描述備注exte

21、nsiondata暫時不用description餐廳描述distances到酒店距離name周邊餐廳名稱節(jié)點包含多子節(jié)點，節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不用distances到酒店距離name周邊餐廳名稱節(jié)點包含多子節(jié)點，節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不用description商業(yè)區(qū)描述distances到酒店距離name商業(yè)區(qū)名稱節(jié)點對應字段說明為：名稱描述備注hotelid酒店iddrivingguide駕車指南propertyotherhightlights酒店其他特色propertyamenitieshightlights

22、服務設施特色locationhighlights地理位置特色overview酒店特色信息概述節(jié)點包含多個子節(jié)點，節(jié)點對應字段說明為：名稱描述備注roomtypeid房型idroomname房型名稱roomtypenum房型數(shù)量area房間面積floor房型所在的樓層hasbroadband是否有寬帶0表示無寬帶，1 表示有寬帶hasbroadbandfee寬帶是否收費 0表示免費，1 表示收費beddescription房間描述包括大床、雙床、寬帶等一類描述note備注節(jié)點包含多個子節(jié)點，節(jié)點對應字段說明為：名稱描述備注extensiondata暫時不用hotelid酒店idlandmarki

23、d酒店附近標志物idlandmarkname酒店附近標志物名稱landmarknameen酒店附近標志物英文名稱、geo_cn.xml文件說明名稱描述備注idgeoid,從1開始，依次加1country國家provincename省份名稱provinceid省份idcityname城市名稱citycode城市idproperties該城市下的有效酒店個數(shù) url該酒店在網(wǎng)站上的搜索列表urldistricts行政區(qū)節(jié)點location列表commerciallocations商業(yè)區(qū)節(jié)點location列表landmarklocations城市標志物節(jié)點location

24、列表節(jié)點對應字段說明：名稱描述ididname名稱、hotelbaseinfocodes_cn.xml文件說明 hotelbaseinfocodes_cn.xml包含以下字典信息： 星級代碼 擔保類別代碼（目前api接口只支持“不擔保”和“信用卡擔?！眱深悾?訂單狀態(tài)代碼 客人類別代碼 支付方式代碼（目前api接口只支持“前臺自付”方式） 貨幣代碼 確認方式代碼 語言代碼 性別代碼 證件類型代碼 訂單取消原因代碼 交通工具 酒店類別（目前靜態(tài)文件中只有“h”類型） 房態(tài)類別代碼 增值服務代碼 預訂規(guī)則類別代碼 促銷規(guī)則代碼 取消規(guī)則類型代碼四、代理商登錄接口login 代理商登錄接口主要是為獲

25、取到數(shù)字憑證logintoken，logintoken是訪問其他api動態(tài)接口的必需參數(shù)。 動態(tài)接口的訪問地址為：正式環(huán)境:http:/114-/northboundservice/v1.1/northboundapiservice.asmx 測試環(huán)境：98/northboundservice/v1.1/northboundapiservice.asmx 此接口輸入?yún)?shù)為：字段類型描述是否可為空備注usernamestringapi登錄賬號名npasswordstringapi登錄密碼n 輸入?yún)?shù)后，生成的requestion.x

26、ml請求如下： 0 username /必須填寫 userpassword /必須填寫 此接口輸出參數(shù)為：字段類型描述可為空備注loginresult logintokenstring登錄憑證y輸出參數(shù)生成的response.xml如下： 0 /判斷請求是否成功標志 2010-10-06t10:49:21.3432823+08:00 succeed /如果不成功，錯誤信息將在此字段列出 e1f0b736-f798-47ce-a798-993620bac4b8 /獲取的logintoken數(shù)字憑證 2010-10-06t10:54:21.3432823+08:00/數(shù)字憑證logintoken的

27、有效時間 五、api動態(tài)接口 在調(diào)用api接口中，所有發(fā)送的請求數(shù)據(jù)（request.xml）都需要包含節(jié)點，此節(jié)點作為接口的數(shù)字驗證字段。所有接受的數(shù)據(jù)（response.xml）都需要包含節(jié)點，此節(jié)點作為接口返回數(shù)據(jù)的狀態(tài)信息。requesthead字段說明參數(shù)類型說明備注可否為空logintoken string訪問憑證登錄接口除外nlanguagestring接口語言cn:中文、en:英文， 大寫字母nguidstring唯一標識id在submithotelorder接口中必須填寫，并且不同的訂單對應的guid不能相同， 否則不能正常成單。 如果成單出現(xiàn)超時再次提交相同請求，則guid

28、不需要改變，否則可能會出現(xiàn)生成重復訂單問題，nversionstring版本號可省略ytestmodeint測試開關0-正式，1-測試，默認為0, 暫時不起作用yrequesthead節(jié)點內(nèi)容 e1f0b736-f798-47ce-a798-993620bac4b8 /調(diào)用login獲取的訪問憑證 cn /請求數(shù)據(jù)的語言，cn-中文，en-英文 /可以為空，但在提交訂單接口（submithotelorder）則需要填寫不同的值，以進行不同訂單的區(qū)分。如果不填，則無論下幾張訂單，所返回的訂單號只有一個，且藝龍系統(tǒng)中下取成功的訂單頁只有一個。 /可以不填 0 /可以不填 responsehead字

29、段內(nèi)容為：參數(shù)類型說明描述可否為空resultcodestring結果編號0-成功,1-失敗nresultmessagestring結果信息錯誤信息或提示信息ytimestampdatetime結果生成的時間yyyy-mm-ddthh:mm:ss例如: 2009-01-14t16:50:20nresponsehead節(jié)點內(nèi)容 0 /返回結果，0-請求成功 1-請求失敗 2010-10-08t10:36:36.6428603+08:00 注意：所有接口的節(jié)點字段中，即是有些參數(shù)你不需要填寫（比如），但在實例化中也需要保留此字段，并把此字段進行默認賦值(string類型為空，int類型為0，日期類

30、型為“0001-01-01 00:00:00”)1. 酒店價格查詢接-gethotellist輸入?yún)?shù)（gethotel condition）節(jié)點下字段說明為（紅色字體代表是個節(jié)點數(shù)組）：字段類型描述默認值可為空備注gethotelcondition checkindatedatetime入住日期0001-01-01 00:00:00n日期有效，建議入住日期和離店日期不要超過20天 checkoutdatedatetime離店日期0001-01-01 00:00:00n日期有效，返回結果中不包含離店日期的價格信息，離店日期大于入住日期cityid string城市id空n1、酒店名稱可為酒店名

31、稱的一部分。2、城市id,酒店名稱，酒店id至少有一個不為空， 如果hotelname不為空，cityid也不能為空。3、酒店id為多個時, id之間可用英文逗號分隔hotelnamestring酒店名稱空nhotelidstring酒店id 空nroomtypeidstring房型id空y通過此兩個字段可查詢某個酒店的詳細產(chǎn)品信息rateplanidintrateplanid0ystarcodestring星級代碼空y參見星級代碼信息starcodes，多個以英文逗號分隔highestrateint產(chǎn)品最高價格0y1、字段為0則不限價 2、如搜200元以下，則highestrate=200，

32、lowestrate=0 3、如搜600元以上，則highestrate=10000，lowestrate=600lowestrateint產(chǎn)品最低價格0ypositionmodecodestring位置查詢模式0y0：不按位置搜索； 1：按矩形方式； 2：按點-半徑方式startlongitudedecimal起始經(jīng)度0y1、此5個字段作為地圖搜索使用，在positionmodecode=2或3時，使用此字段2、radius字段的單位為：米startlatitudedecimal起始緯度0yendlongitudedecimal終止經(jīng)度0yendlatitudedecimal終止緯度0yra

33、diusint半徑0ydistrictidstring行政區(qū)id空y如果按照這3個查詢，則城市id必須輸入， id的具體數(shù)值從geo_cn.xml中獲取commerciallocationidstring商業(yè)區(qū)id空ylandmarklocationidstring標志物id空yopeningdatedatetime開業(yè)日期0001-01-01 00:00:00y暫不支持，默認填寫0001-01-01 00:00:00decorationdatedatetime裝修日期0001-01-01 00:00:00y暫不支持，默認填寫0001-01-01 00:00:00roomamountint房間

34、數(shù)量0y默認為1，暫不支持orderbycodestring排序標準空yelong：默認 star：按星級 price：按價格distance：按距離ordertypecodestring排序類型空yasc :升序desc:降序pageindexint分頁頁數(shù)0y默認從1開始maxrowsint最大返回記錄數(shù)0y0或空表示不限制如果超過elong默認的最大記錄數(shù)，則以elong設置為準，默認最大為20currencycodestring空rmb ：人民幣 usd ：美元 hkd ：港元 mop ：澳元（暫不支持） sgd ：新幣（暫不支持），此查詢條件暫時不提供輸出參數(shù)字段類型描述可為空備注h

35、otelcountint酒店個數(shù)n查詢結果中返回的酒店個數(shù)hotels hotels包含n個hotel數(shù)組hotelhotel數(shù)組 hotelnamestring酒店名稱n hotelidstring酒店idnstarcodestring星級代碼n參見靜態(tài)數(shù)據(jù)文件hotelbaseinfocodes_cn.xmlhoteladdressstring酒店地址n hotelinvstatuscodestring酒店房態(tài)n0-正常 1-部分日期滿房，2-全部滿房 lowestpricedecimal酒店最低價n roomsrooms下包含n個room數(shù)組，參見下面介紹 hotelpromotions

36、酒店活動節(jié)點節(jié)點包含多個子節(jié)點，節(jié)點對應字段說明為： roomn roomnamestring房型名稱n roomtypeidstring房型idn roominvstatuscodestring房型房態(tài)n0-正常 1-部分日期滿房，2-全部滿房rateplansrateplan數(shù)組節(jié)點節(jié)點包含多個子節(jié)點，節(jié)點對應字段說明為： rateplan rateplanidintrpid藝龍在房型基礎上把產(chǎn)品進一個細分，細分后的每一產(chǎn)品稱為rateplan，簡稱rp rateplancodestringrp業(yè)務編碼 rateplannamestringrp名稱guesttypecodestring客人

37、類型代碼參見靜態(tài)數(shù)據(jù)hotelbaseinfocodes_cn.xml文件ratesnrp價格數(shù)組，參見下面介紹garanteerulesy擔保規(guī)則數(shù)組，參見下面介紹bookingrulessy預訂規(guī)則數(shù)組，參見下面介紹addvaluesy增值服務信息數(shù)組，參見下面介紹addvaluesdescriptiony增值服務信息描述，參見下面介紹drrrulesy產(chǎn)品促銷規(guī)則數(shù)組，參見下面介紹hotelpromotionsy酒店促銷活動數(shù)組，參見下面介紹節(jié)點對應字段說明為：rates 房價數(shù)組 totalpricedecimal總價 currencycodestring貨幣代碼 taxesamoun

38、tint稅費節(jié)點， 包含類型，價格，暫不使用 rate每日價格數(shù)組節(jié)點對應字段說明為： rate每日價格數(shù)組 datedatetime對應日期n假設你查詢2010-10-5到2010-10-7價格，則對應rate展示3天（5，6，7）價格數(shù)據(jù)（rate） currencycodestring貨幣代碼 invstatuscodestring每日房態(tài)n0-正常 1、2-全部滿房 retailratedecimal門市價n memberratedecimal會員價格n預訂酒店價格，返回-1代表此房無價，無價和滿房都不能進行預訂 addbedratedecimal加床價格y返回-1代表不能加床，0-免

39、費加床，大于0表示加床的費用節(jié)點節(jié)點包含多個子節(jié)點，節(jié)點對應字段說明為：garanteerules garanteerule garanteerulestypecodeint擔保規(guī)則類型 1- 信用卡-日期擔保2- 信用卡-房量擔保， 房量擔保時也有有效日期的限制，同時可能會并存客人到店時間的判斷條件，不能只簡單的校驗房量，需要遍歷檢查rulevalues中的每個節(jié)點后進行綜合判斷 rulevaluesdictionaryentry規(guī)則的具體數(shù)據(jù)數(shù)組, 規(guī)則有幾個參數(shù)，對應幾個節(jié)點值 descriptionstring該條擔保規(guī)則對應的描述，如果代理不想解析規(guī)則，可以直接在預定流程中展示該描述

40、節(jié)點對應字段說明為： rulevalues key對應擔保條件字段n value對應擔保條件值yrulevalue項說明：項示例值說明備注startdate2010-05-04 00:00:00需要擔保開始日期1-入住日期2-在店日期3-預訂日期舉例：datetype為1表示當前訂單的入住日期落在startdate 和 enddate之間，并且入住日期符合周設置時才需要判斷其它條件是否擔保，否則不需要擔保 enddate2010-12-31 00:00:00需要擔保結束日期datetype1擔保條件日期判斷基準weekset1,2,3,4,5,6,7周有效天數(shù)， 一般為周一到周日都有效， 判斷

41、日期符合日期段同時也要滿足周設置的有效周一對應為1，周二對應為2， 依次類推gage1信用卡擔保 ,該字段目前可以忽略系統(tǒng)默認為1 isarrivetimevouch0是否校驗到店時間 0為不校驗到店時間1為需要校驗到店時間當isarrivetimevouch為1時，arrivestattime、arriveendtime、istomorrow才有值arrivestattime18:00到店擔保的開始時間arriveendtime6:00到店擔保的結束時間istomorrow1到店擔保的結束時間是否為第二天 0為當天，1為次日isroomcountvouch0是否校驗房量 0為不校驗房量條件，

42、1為校驗房量條件當garanteerulestypecode為2時有效roomcount0擔保的房間數(shù),預定幾間房以上要擔保vouchmoneytype2擔保金額, 1為首晚房費2為全額房費ischange1是否允許變更1為允許變更2為不允許變更changerule4擔保規(guī)則條數(shù)，規(guī)則1、不允許變更取消 2、允許變更/取消,需在xx日yy時之前通知3、允許變更/取消,需在最早到店時間之前幾小時通知4、允許變更/取消,需在到店日期的24點之前幾小時通知當存在規(guī)則2、3、4時，需要查看daynum、hournum、timenum數(shù)據(jù)以及ischange當changerule=2時，需包含字段為：daynum2011-02-28幾日對應規(guī)則3描述中 “允許變更/取消,需在xx日yy時之前通知” 中的xx日，yy時timenum18：00幾時當changerule=3時，需包含字段為：hournum6幾小時對應規(guī)則3描述中 “ 允許變更/取消,需在最早到店時間之前幾小時通知” 中的幾小時當changerule=4時，需校驗字段為：hournum5幾