# OTA中轉對接方案 # 1、實現目標 在航班時刻資源有限的情況下，提供高效、貼心、周到的中轉服務不僅可以增加旅客運輸量，還可以提高航線的資源利用率，這是目前許多機場都在著力打造中轉產品的重要原因。然而，服務好中轉旅客，讓其在出行上有更多獲得感、滿足感，進而提高旅客對機場的忠誠度，并不是一件容易的事。中轉服務重在體驗，總結為兩個詞，那就是“便利”“舒適”。行李是否直掛，是否可優先辦理各種手續，食、住、行有無保障措施，這是中轉旅客關心的，也是機場一直在努力做的。在此前提下集團提供對接OTA的中轉禮包申請指南，為順利實現對接提供相關指導。 # 2、各大機場產品及匹配規則介紹 ## 2.1西安中轉產品內容 免住宿、免休息、免正餐、免寄存、免觀光、免聯運 ## 2.2西安中轉產品規則 免住宿: 規則1：中轉停留時間8-24h 規則2：中轉類型：(1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5： 地面國際7:國際地面) 規則3：往返航班不算 免正餐: 規則1：中轉停留時間48h以內 規則2：中轉類型：(1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5：地面國際6：地面國內7：國際地面8：國內地面) 規則3：往返航班不算 免觀光: 規則1：中轉停留時間6-48h 規則2：中轉類型：(1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空 ) 規則3：往返航班不算 免聯運: 規則1：中轉停留時間48h以內 規則2：中轉類型：(5：地面國際6：地面國內7：國際地面8：國內地面 ) 規則3：往返航班不算 免寄存： 規則1：中轉停留時間48h以內 規則2：中轉類型：(1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5：地面國際6：地面國內7：國際地面8：國內地面 ) 免休息 規則1：中轉停留時間4-8h 規則2：中轉類型：(1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5： 地面國際7:國際地面) 規則3：往返航班不算 ## 2.3銀川中轉產品內容 50元券，150元券（住宿），150元券（頭等艙休息），免寄存服務 ## 2.4銀川中轉產品規則 50元券： 規則1：中轉停留時間0-24h 規則2：空空中轉旅客（1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空） 規則3：同一券只限當天使用一個服務項，不能同時用 150券（住宿）： 規則1：中轉停留時間0-24h 規則2：空空中轉旅客（1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空） 規則3：隔夜（在銀川機場中轉停留時間要求跨凌晨1點） 150券（頭等艙休息）： 規則1：中轉停留時間 2-24h 規則2：空空中轉旅客 規則3：不隔夜（在銀川機場中轉停留時間要求不跨凌晨1點） 免寄存服務： 規則1：中轉停留時間0-24h 規則2：空空中轉旅客（1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空） ## 2.5西寧中轉產品內容 東免夏優、免正餐、免寄存、免觀光、免聯運 ## 2.6西寧中轉產品規則 冬免夏優住宿 (10月1日至5月31日期間免費享受1晚住宿，6月1日至9月31日期間享受1晚半價優惠住宿(1人1床位，同性拼房，8周歲以下（含）不提供床位)) ? ???? 規則1：中轉停留時間在6-48小時內 ? 規則2：中轉類型 （1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5：地面國際6：地面國內） ? 規則3：隔夜 規則4：提前24小時預訂 ? 規則5：往返航班不算 免正餐 (享受航站樓內合作餐飲商戶及空港酒店免費餐食服務(11:00-13:00 17:00-19:00)) ? ??? 規則1：中轉停留時間在48小時內 ? 規則2：中轉類型 （1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5：地面國際6：地面國內） ? 規則3：在飯點 規則4：往返航班不算 免觀光 (提供機場至西寧市區往返大巴各一次) ????? 規則1：中轉時間3-48小時 規則2：中轉類型 （1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空） 規則3：往返航班不算 免聯運 (提供西寧機場到西寧市區往返大巴單程票一張) ???? 規則1：中轉停留時間在48小時內 ? 規則2：中轉類型 （5：地面國際6：地面國內7：國際地面8：國內地面） ? 規則3：往返航班不算 免寄存 （享受1件行李24小時寄存服務(早8點到晚10點)） ?? ???? 規則1：中轉停留時間在2-48小時內 ? 規則2：中轉類型 （1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5：地面國際6：地面國內7：國際地面8：國內地面 ）? 規則3：往返航班不算 ## 2.7榆林中轉產品(待發布) # 3、業務流程介紹 業務流程圖如下：  1、OTA作為機場中轉服務的渠道方可按以上規則展示相關產品給匹配旅客 2.、旅客完成機票訂票后（包括在機場中轉的前后段航班），OTA調用西部機場集團服務云的中轉訂單生成接口，傳入旅客中轉行程 3.、服務云收到請求后匹配中轉服務產品，自動審核完成，將結果以同步的方式返回給攜程，返回數據中包含核銷碼、產品名稱、產品編號，消費時間，同時服務云也會自動發送這些信息到旅客短信上 4、OTA調用中轉產品查詢接口，按產品編號查詢相關核銷時間、地址、商戶等信息，并展示給 旅客 5、旅客在機場商戶出示核銷碼，核銷人員使用服務云的核銷小程序完成核銷，服務云給旅客發送消費短信。 6、后段航班起飛后如果旅客的券沒有使用，服務云自動將這些券設置為已過期，不可再用 # 4、對接方案 ## 接口描述 創建中轉產品申請訂單 ## 接口地址 https://ip/api/ota/addTranOrder ## 請求參數 | 字段 | 類型 | 是否必須 | 備注 | | --- | --- | --- | --- | | tripSource | String | 是 | 訂單來源 2 同程 6 攜程 8航班管家 9 華夏航空 | | tripInNum | String | 是 | 進港航班 | | tripInType | String | 是 | 進港類型 ，AIRCRAFT/HIGHT_SPEED_RAIL| | tripInTime | Date | 是 | 進港時間 | | tripOutNum | String | 是 | 離港航班 | | tripOutType | String | 是 | 離港類型 ，AIRCRAFT/HIGHT_SPEED_RAIL| | tripOutTime | Date | 是 | 離港時間 | | tripPssName | String | 是 | 旅客姓名 | | tripPssTel | String | 是 | 旅客電話 | | tripPssCertType | String | 是 | 證件類型1身份證,2護照,3軍官證,4士兵證,5警官證,6臺胞證，港澳通行證,7海員證,8學生證,9戶口簿,10其他 | | tripPssCertNo | String | 是 | 證件號碼 | | tripAirportCode | String | 是 | 機場編號 西安：XIY， 銀川 ：INC ，西寧：XNN，榆林：UYN| | runum | String | 是 | 流水號 | ## 請求報文 ``` appCode="" timeStamp="" sign="" ``` 示例 ``` addTranOrder?timeStamp=1572948189901&sign=78C00B3BDC54BAABD8FEA1034E8F83CCB504D1E5&appCode=appCode ``` 數據類型Content-Type: application/json ``` { "maintainer": "string", "runum": "string", "tripAirportCode": "string", "tripInNum": "string", "tripInTime": "2019-11-05T08:58:28.489Z", "tripInType": "string", "tripOutNum": "string", "tripOutTime": "2019-11-05T08:58:28.489Z", "tripOutType": "string", "tripPssCertNo": "string", "tripPssCertType": "string", "tripPssName": "string", "tripPssTel": "string", "tripSource": "string" } ``` ## 響應參數 | 字段 | | 類型 | 描述 | 備注 | | --- | --- | --- | --- | --- | | code | | String | 返回狀態 | 0- 失敗 1- 成功 | | message | | String | 錯誤說明 | 請求失敗或者發生錯誤的具體描述 | | timeStamp | | datetime | 請求時間戳 | 請求時帶的時間戳 | | result | | Object | | 結果集 | ## 響應報文 ``` { "success": true, "message": "操作成功", "code": 1, "timestamp": 1591083585797, "result": { "orderId": "3e0819f0f622436bb0d71157e896634e", "order_detail": [ { "goodsNo": "003", "businessStatus": "已審核", "consumerCode": "0060203230", "beginTime": "2020-06-02 15:12:28", "endTime": "2020-06-03 08:58:28", "goodsName": "免觀光", "vendorInfo": "[{\"transferServiceItemAddress\":\"請在可使用時間內前往：T2或T3出發廳旅客服務中心柜臺領取消費劵后，前往機場大巴售票點兌換乘車劵即可\",\"transferServiceItemPicture\":\"\",\"transferServiceItemName\":\"咸陽機場大巴聯運\",\"transferServiceItemPhone\":\"\"}]" }, { "goodsNo": "014", "businessStatus": "已審核", "consumerCode": "0060203231", "beginTime": "2020-06-02 15:12:28", "endTime": "2020-06-03 08:58:28", "goodsName": "免寄存", "vendorInfo": "[{\"transferServiceItemAddress\":\"請在可使用時間內前往咸陽機場T3行李寄存部：T3航站樓2層國際出發廳行李寄存點，出示消費碼\",\"transferServiceItemPicture\":\"\",\"transferServiceItemName\":\"咸陽機場T3行李寄存部\",\"transferServiceItemPhone\":\"18300000000\"},{\"transferServiceItemAddress\":\"請在可使用時間內前往咸陽機場T2行李寄存部：T2二層出發廳行李寄存點，出示消費碼\",\"transferServiceItemName\":\"咸陽機場T2行李寄存部\",\"transferServiceItemPhone\":\"\"}]" }, { "goodsNo": "001", "businessStatus": "已審核", "consumerCode": "0060203232", "beginTime": "2020-06-02 15:12:28", "endTime": "2020-06-03 08:58:28", "goodsName": "免住宿", "vendorInfo": "[{\"transferServiceItemAddress\":\"請在可使用時間內前往：T3航站樓326門口坐酒店班車前往酒店,在前臺出示消費碼即可(電話029-33246688 手機15129789527)\",\"transferServiceItemPicture\":\"\",\"transferServiceItemName\":\"咸陽機場皇家龍空港酒店\",\"transferServiceItemPhone\":\"\"}]" }, { "goodsNo": "002", "businessStatus": "已審核", "consumerCode": "0060203233", "beginTime": "2020-06-02 15:12:28", "endTime": "2020-06-03 08:58:28", "goodsName": "免正餐", "vendorInfo": "[{\"transferServiceItemAddress\":\"T2候機廳\",\"transferServiceItemPicture\":\"https://imagetest.cwagpss.com/kwSZsT_1559529169295.jpg\",\"transferServiceItemName\":\"咸陽機場航星餐廳\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T3航站樓中心商業區3FB-5標段，電話029-88790665\",\"transferServiceItemPicture\":\"https://imagetest.cwagpss.com/4t3rKX_1559529355132.png\",\"transferServiceItemName\":\"咸陽機場陜西逸臣餐飲\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T2航站樓安檢內9號口或15號口(029-88796249)\",\"transferServiceItemPicture\":\"https://imagetest.cwagpss.com/fy3Zwc_1559530213136.jpg\",\"transferServiceItemName\":\"咸陽機場T2小推車\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T3航站樓二樓出發廳安檢外或T3航站樓安檢內H06登機口(029-88790650)\",\"transferServiceItemPicture\":\"https://imagetest.cwagpss.com/WjxD2G_1559530247982.png\",\"transferServiceItemName\":\"咸陽機場T3小推車\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T3航站樓內\",\"transferServiceItemPicture\":\"\",\"transferServiceItemName\":\"咸陽機場空港大酒店\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T2候機廳(02988790258)\",\"transferServiceItemName\":\"咸陽機場丹尼斯餐飲\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"維迪莎咖啡T3航站樓出發廳中心商業區(88790596)或漢堡王店T3航站樓出發廳中心商業區(88790592)\",\"transferServiceItemPicture\":\"https://imagetest.cwagpss.com/dAiDPw_1559530239910.jpg\",\"transferServiceItemName\":\"咸陽機場T3精選餐飲\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T2航站樓1樓到達廳(02988799842)\",\"transferServiceItemName\":\"咸陽機場麥當勞\",\"transferServiceItemPhone\":\"183000000000\"},{\"transferServiceItemAddress\":\"T2航站樓1樓到達廳(18092211125)\",\"transferServiceItemName\":\"咸陽機場永和大王\",\"transferServiceItemPhone\":\"\"},{\"transferServiceItemAddress\":\"T2航站樓二樓出發廳美食街區(029-88796249)\",\"transferServiceItemPicture\":\"https://imagetest.cwagpss.com/CppJw6_1559530224601.jpg\",\"transferServiceItemName\":\"咸陽機場西港味道\",\"transferServiceItemPhone\":\"\"}]" } ] } } ``` # 4、查詢服務項詳情 ## 接口描述 查詢服務項詳情 ## 接口地址 https://ip/api/ota/findGoodsByNo ## 請求參數 | 字段 | 類型 | 是否必須 | 備注 | | --- | --- | --- | --- | | tripAirportCode | String | 是 | 機場編號 | |goodsNo | List | 是 | 服務項編號列表 | | runum | String | 是 | 流水號 | ## 請求報文 數據類型Content-Type: Params ``` appCode="" timeStamp="" sign="" ``` 數據類型Content-Type: application/json ``` { "goodsNo": [ "string" ], "runum": "string", "tripAirportCode": "string" } ``` ## 響應參數 | 字段 | | 類型 | 描述 | 備注 | | --- | --- | --- | --- | --- | | code | | String | 返回狀態 | 0- 失敗 1- 成功 | | message | | String | 錯誤說明 | 請求失敗或者發生錯誤的具體描述 | | timeStamp | | datetime | 請求時間戳 | 請求時帶的時間戳 | | result | | Object | | 結果集 | ## 響應報文 ``` { "success": true, "message": "操作成功", "code": 1, "timestamp": 1591084156965, "result": [ { "goodsNo": "001", "goodsName": "免住宿", "remind": "[{\"transferServiceItemAddress\":\"請在可使用時間內前往：T3航站樓326門口坐酒店班車前往酒店,在前臺出示消費碼即可(電話029-33246688 手機15129789527)\",\"transferServiceItemPicture\":\"\",\"transferServiceItemName\":\"咸陽機場皇家龍空港酒店\",\"transferServiceItemPhone\":\"\"}]" } ] } ```