【正文】 查詢、訂單 實(shí)時(shí)提交、酒店訂單查詢、訂單詳細(xì) 信息查詢、訂單取消功能。 注意： 由于訂單變更涉及到太多組合條件， API 接口暫時(shí)不提供訂單變更功能；如需要進(jìn)行酒店訂單變更，可以先取消原來(lái)訂單 ，然后再 重新 下 取 新單。 二、 基本 開(kāi)發(fā)步驟 向藝龍銷售人員索取 API 測(cè)試環(huán)境賬號(hào)和說(shuō)明文檔 ，做接口接入工作前的準(zhǔn)備 下載 API 接 口文檔靜態(tài)數(shù)據(jù) （最好采用 FlashGet、迅雷等下載工具下載） ，通過(guò)程序 來(lái) 解析數(shù)據(jù) 格式，并把解析 到的 數(shù)據(jù)導(dǎo)入 到 本地（ 或 服務(wù)器）上的數(shù)據(jù)庫(kù) 中 確定開(kāi)發(fā)語(yǔ)言 及需要 調(diào)用 的動(dòng)態(tài)接口，并閱讀動(dòng)態(tài)接口文檔參數(shù)，對(duì)通過(guò)動(dòng)態(tài)接口調(diào)用到的數(shù)據(jù)規(guī)劃 自己頁(yè)面的 展示方式 通過(guò)藝龍 API 測(cè)試環(huán)境調(diào)試 5 個(gè)動(dòng)態(tài)接口（僅使用部分接口就調(diào)試部分動(dòng)態(tài)接口），對(duì)所需要的接口爭(zhēng)取均能調(diào)試通過(guò) , 測(cè)試環(huán)境只保證能夠通 ,不保證與正式環(huán)境 數(shù)據(jù) 一致 。 三 、靜態(tài)數(shù)據(jù) API靜態(tài)數(shù)據(jù)包含三個(gè)文件， 三個(gè)文件均以靜態(tài) xml 文件方式來(lái)提供 ，其中 提供的每一家酒店的基礎(chǔ)信息，包括酒店名稱、 id、地址、介紹等內(nèi)容 提供了每一城市的地理位置信息，包括行政區(qū)、商業(yè)區(qū)等內(nèi)容 hotelbaseinfocodes 提供了接口中部分參數(shù)字典信息 三個(gè)靜態(tài)文件下載地址為： 中文 版本 文件名為 , , 英文版本文件名為 , , 靜態(tài)數(shù)據(jù)文件的更新 由于靜態(tài)文件日常更新較慢，并且數(shù) 據(jù)變化比較??；因此，藝龍系統(tǒng)將在每周六凌晨 2 點(diǎn)對(duì)此三個(gè)靜態(tài)文件進(jìn)行一次更新，更新方式為累積更新。 由于這三個(gè)文件中， 比較大（ 160mb200mb 之間），建議先用下載工具（迅雷、FlashGet）把此文件下載到本地，然后通過(guò)程序解析的方式把此文件解析到本地?cái)?shù)據(jù)庫(kù)。 此接口的有效時(shí)間為 5分鐘 ，建議在每調(diào)用其他數(shù)據(jù)接口時(shí)，首先訪問(wèn) Login接口獲取新的數(shù)字憑證 LoginToken。所有接受的數(shù)據(jù)（ ）都需要包含 ResponseHead節(jié)點(diǎn)， 此 節(jié)點(diǎn)作為接口返回?cái)?shù)據(jù)的狀態(tài)信息。如果不填，則無(wú)論下幾張訂單，所返回的訂單號(hào)只有一個(gè)，且藝龍系統(tǒng)中下取成功的訂單頁(yè)只有一個(gè)。 城市 ID,酒店名稱，酒店 ID 至少有一個(gè)不為空， 如果 hotelname 不為空， cityid 也不能為空 。在提交訂單時(shí)，一定要給 GUID 參數(shù)進(jìn)行賦值，不同的訂單給 GUID 賦值講不同 字段 類型 描述 可為 空 備注 HotelOrder RoomGroups 目前只支持一個(gè) Room節(jié)點(diǎn) Room 節(jié)點(diǎn) Room對(duì)應(yīng)字段說(shuō)明為： 字段 類型 描述 默認(rèn)值 可為 空 備注 HotelId String 酒店 ID N 從 GetHotelList 獲取 RoomTypeId String 房型 ID N 從 GetHotelList 獲取 RatePlanID String RatePlanID N 從 GetHotelList 獲取 RatePlanCode String RatePlan 名稱 Y 從 GetHotelList 獲取 CheckInDate DateTime 入住時(shí)間 20201025 T00:00:00 N CheckOutDate DateTime 離店時(shí)間 20201026 T00:00:00 N 建議 入住日期和離店 日期可以最長(zhǎng)選擇60 天 ElongCardNo String ELONG卡號(hào) Y 此數(shù)據(jù)一般不填 GuestTypeCode String 賓客類型代碼 N 參見(jiàn) 靜態(tài)數(shù)據(jù) 文件 RoomAmount Int 房間數(shù)量 N 有幾個(gè)房間數(shù)量，對(duì)應(yīng)幾個(gè) Guest 節(jié)點(diǎn)數(shù)組 ，每一訂單房間數(shù)量最好不要超過(guò) 10間 GuestAmount Int 入住人數(shù) N 如果一個(gè)房間住兩個(gè)人，則在 Guest 節(jié)點(diǎn)數(shù)組中的 name 填寫(xiě) ”某人 1/某人 2；一個(gè)房間入住客人建議 不要超過(guò) 2 人 ，三人間可以為 3 人 PaymentTypeCode String 支付方式 0 N 默認(rèn) 0前臺(tái)自付 ArrivalEarlyTime DateTime 最早到達(dá)時(shí)間 20201025 T20:00:00 N 最早到店時(shí)間范圍為 06:0023:00，最早到店時(shí)間和最晚到店時(shí)間的日期為入住日期 加到店時(shí)間范圍 ，此字段一定要填值 ArrivalLateTime DateTime 最晚到達(dá)時(shí)間 20201025T23:00:00 N 最晚到店時(shí)間范圍為 06:0023:00，最晚到店時(shí)間和最早到店時(shí)間一般相差 3 個(gè)小時(shí)，可以讓客人僅填寫(xiě)一個(gè)最晚到店時(shí) 間，然后計(jì)算出最早到店時(shí)間 ，此字段一定要填值 CurrencyCode String 貨幣代碼 N 參見(jiàn)代碼表 TotalPrice Decimal 總價(jià) N （離店日期 入住日期） *房間數(shù) *RP 的會(huì)員價(jià) ConfirmTypeCode String 訂單確認(rèn)方式 N 參考 文件 ConfirmLanguageCode String 訂單確認(rèn)語(yǔ)言 N 參考 文件 NoteToHotel String 給酒店備注 Y NoteToElong String 給藝龍備注 Y Contacters N Contacter N Name String 姓名 N 在正式環(huán)境中姓名請(qǐng)不要填寫(xiě)“張三、李四、王五、 test、測(cè)試”等，藝龍系統(tǒng)有對(duì)應(yīng)姓名黑名單 GenderCode String 姓別代碼 Y 參見(jiàn)代碼表 Email String Email Y Mobile String 手機(jī) 13988888888 Y 手機(jī)號(hào)填寫(xiě)以 13\15\18開(kāi)頭 11位數(shù)字 IdTypeCode String 證件類別代碼 Y 參考 文件 IdNumber String 證件號(hào)碼 Y Phone Y InterCode Int 國(guó)際區(qū)號(hào) Y 可以不填 AreaCode Int 國(guó)內(nèi)區(qū)號(hào) Y Number Int 電話號(hào)碼 Y 請(qǐng)?zhí)顚?xiě) 7 位或 8 位數(shù)字 Ext Int 分機(jī)號(hào) Y Fax Y InterCode Int 國(guó)際區(qū)號(hào) Y 可以不填 AreaCode Int 國(guó)內(nèi)區(qū)號(hào) Y Number Int 電話號(hào)碼 Y 請(qǐng)?zhí)顚?xiě) 7 位或 8 位數(shù)字 Ext Int 分機(jī)號(hào) Y CreditCard Y Number String 信用卡號(hào) Y 測(cè) 試 環(huán) 境 信 用 卡 卡 號(hào) 可 填1234567890111111 1234567890111119 VeryfyCode String 校驗(yàn)碼 Y 三位數(shù)字 ValidYear Int 有效期年 Y 如 2020 ValidMonth Int 有效期月 Y 1~12 CardHolderName String 持卡人姓名 Y IdTypeCode String 證件類別代碼 Y 參考 文件 IdNumber String 證件號(hào)碼 Y 如是身份證號(hào)碼，請(qǐng)?zhí)顚?xiě)有效身份證信息，藝龍系統(tǒng)有對(duì)應(yīng)身份證號(hào)的 校驗(yàn) Guests 入住人數(shù)組 N Guest 入住人 和房間數(shù)保持一致， 有幾個(gè)房間，就對(duì)應(yīng)幾個(gè) Guest 節(jié)點(diǎn)數(shù)組 Name String 姓名 N 在正式環(huán)境中姓名請(qǐng)不要填寫(xiě)“張三、李四、王五、 test、測(cè)試”等，藝龍系統(tǒng)有姓名黑名單 機(jī)制 GenderCode String 姓 別代碼 Y Email String Email Y Mobile String 手機(jī) Y 手機(jī)號(hào)填寫(xiě)以 13\15\18開(kāi)頭 11位數(shù)字 IdTypeCode String 證件類別代碼 Y 參考 文件 IdNumber String 證件號(hào)碼 Y 如是身份證號(hào)碼，請(qǐng)?zhí)顚?xiě)有效身份證信息，藝龍系統(tǒng)有對(duì)應(yīng)身份證號(hào)的校驗(yàn) Nationality String 國(guó)籍 比如“中國(guó)“ Y 根據(jù) GetHotelList 中預(yù)訂 規(guī)則數(shù)組 判斷 Phone Y InterCode Int 國(guó)際區(qū)號(hào) Y AreaCode Int 國(guó)內(nèi)區(qū)號(hào) Y Number Int 電話號(hào)碼 Y Ext Int 分機(jī)號(hào) Y Fax InterCode Int 國(guó)際區(qū)號(hào) Y AreaCode Int 國(guó)內(nèi)區(qū)號(hào) Y Number Int 電話號(hào)碼 Y Ext Int 分機(jī)號(hào) Y ExtendInfo 備用參數(shù) ParameterString1 String 預(yù)留字符參數(shù) 1 ParameterString2 String 預(yù)留 字符參數(shù) 2 ParameterString3 String 預(yù)留字符參數(shù) 3 ParameterInt1 Int 預(yù)留整數(shù)參數(shù) 1 ParameterInt2 Int 預(yù)留整數(shù)參數(shù) 2 ParameterInt3 Int 預(yù)留整數(shù)參數(shù) 3 輸出參數(shù)： 字段 類型 描述 可為 空 備注 SubmitHotelOrderResult HotelOrderID Int 訂單 ID N CancelDeadline DateTime 最晚取消時(shí)間 N 如果日期為 99991230 23:00:00 等條件代表不限制取消時(shí)間 ，不限制取消時(shí)間的訂單，最晚取消時(shí)間為最早到店時(shí)間的前 2 個(gè)小時(shí)之前可以取消 GuaranteeMoney Decimal 擔(dān)保金額 Y 如果此訂單是擔(dān)保訂單，則在此列出擔(dān)保金額 發(fā)送請(qǐng)求 的 xml 文件示例（ 文件） ?xml version= encoding=utf16? soap:Envelope xmlns:soap= xmlns:xsi= xmlns:xsd= soap:Body SubmitHotelOrder xmlns= SubmitHotelOrderRequest RequestHead LoginToken68154537498f42f6aff5b5ab1e86e27c/LoginToken LanguageCN/Language GUID 6F9619FF8B86D011B42D00C04FC964FF/GUID //GUID在提交訂單時(shí)一定要賦值 ， 以區(qū)分不同的訂單 Version / TestMode0/TestMode /RequestHead HotelOrder RoomGroups Room HotelId40101585/HotelId RoomTypeId1021/RoomTypeId RatePlanID25522/RatePlanID RatePlanCode / CheckInDate20201104T00:00:00/CheckInDate CheckOutDate20201106T00:00:00/CheckOutDate ElongCardNo / GuestTypeCode1/GuestTypeCode RoomAmount1/RoomAmount GuestAmount2/GuestAmount PaymentTypeCode0/PaymentTypeCode ArrivalEarlyTime20201104T15:00:00/ArrivalEarlyTime