# 機場中轉禮包對接開發指南
# 1、實現目標
為支持集團成員機場對中轉旅客的優質服務和機場的中轉戰略，在集團旅客服務云上構建了中轉服務平臺，支持各機場的中轉線上線下服務。本文檔是外部OTA、航司等對接各機場中轉服務產品的技術對接方案。
# 2、各機場產品及匹配規則介紹
## 2.1西安中轉產品內容
| 產品名稱 | 產品編號 |
| --- | --- |
| 免住宿 | 001 |
| 免正餐| 002 |
| 免觀光| 003 |
| 免聯運| 004 |
| 免寄存| 014 |
| 免休息| 015 |
## 2.2西安中轉產品規則
### 免住宿:
規則1：中轉停留時間8-48h
規則2：中轉類型：(1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空5： 地面國際7:國際地面)
規則3：往返航班不算
*****
### 免休息：
規則1：中轉停留時間4-8h
規則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：國內地面
)
*****
*****
## 2.3銀川中轉產品內容
| 產品名稱 | 產品編號 |
| --- | --- |
| 150元優惠券（住宿） | 001 |
| 免寄存| 014 |
| 50元優惠券（餐飲，購物，巴士）| 099|
## 2.4銀川中轉產品規則
### 50元券：
規則1：中轉停留時間1-24h
規則2：空空中轉旅客（1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空）
規則3：同一券只限當天使用一個服務項，不能同時用
*****
### 150券（住宿）：
規則1：中轉停留時間1-24h
規則2：空空中轉旅客（1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空）
規則3：隔夜（在銀川機場中轉停留時間要求跨凌晨1點）
*****
### 免寄存服務：
規則1：中轉停留時間1-24h
規則2：空空中轉旅客（1：國內空空2：國內國際空空3：國際國內空空4：國際國際空空）
*****
*****
## 2.5西寧中轉產品內容
| 產品名稱 | 產品編號 |
| --- | --- |
| 冬免夏優住宿 | 001 |
| 免正餐| 002 |
| 免觀光| 003 |
| 免寄存| 014 |
## 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 | int| 是 | 訂單來源 2 同程 6 攜程 8航班管家 9 華夏航空 10 航旅縱橫 11去哪兒|
| tripInNum | String | 是 | 進港航班 |
| tripInType | String | 是 | 進港類型 ，AIRCRAFT 航空/HIGHT_SPEED_RAIL 高鐵|
| tripInTime | Date | 是 | 進港時間 |
| tripOutNum | String | 是 | 離港航班 |
| tripOutType | String | 是 | 離港類型 ，AIRCRAFT 航空/HIGHT_SPEED_RAIL 高鐵|
| tripOutTime | Date | 是 | 離港時間 |
| tripPssName | String | 是 | 旅客姓名 |
| tripPssTel | String | 是 | 旅客電話 AS128加密 （pco2naLPhSkkfdko） |
| tripPssCertType | String | 是 | 證件類型1身份證,2護照,3軍官證,4士兵證,5警官證,6臺胞證，港澳通行證,7海員證,8學生證,9戶口簿,10其他 |
| tripPssCertNo | String | 是 | 證件號碼 AS128加密（pco2naLPhSkkfdko） |
| tripAirportCode | String | 是 | 機場三字碼 如 西安XIY |
| runum | String | 是 | 流水號 八位隨機字符串 |
## 請求報文
數據類型Content-Type: Params
```
appCode=""
timeStamp=""
sign=""
runum=""
```
數據類型Content-Type: application/json
```
{
"tripAirportCode": "XIY",
"tripPssName": "阿三",
"tripPssCertNo": "ujilKn1s6RBaBLb0sNnwuuIOrqOf2oYOJWvzrXttuao=",
"tripInTime": 1591803600000,
"tripSource": 6,
"tripOutType": "AIRCRAFT",
"tripInNum": "MU1111",
"tripPssTel": "GGNkzOryLc8eXOLYF1tSqQ==",
"tripOutNum": "MU2222",
"tripInType": "AIRCRAFT",
"tripPssCertType": "1",
"tripOutTime": 1591840500000,
"runum": "fec2e7ce"
}
```
## 響應參數
| 字段 | | 類型 | 描述 | 備注 |
| --- | --- | --- | --- | --- |
| 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": "免觀光"
},
{
"goodsNo": "014",
"businessStatus": "已審核",
"consumerCode": "0060203231",
"beginTime": "2020-06-02 15:12:28",
"endTime": "2020-06-03 08:58:28",
"goodsName": "免寄存"
},
{
"goodsNo": "001",
"businessStatus": "已審核",
"consumerCode": "0060203232",
"beginTime": "2020-06-02 15:12:28",
"endTime": "2020-06-03 08:58:28",
"goodsName": "免住宿"
},
{
"goodsNo": "002",
"businessStatus": "已審核",
"consumerCode": "0060203233",
"beginTime": "2020-06-02 15:12:28",
"endTime": "2020-06-03 08:58:28",
"goodsName": "免正餐"
}
]
}
}
```
# 4、查詢服務項詳情
## 接口描述
查詢服務項詳情
## 接口地址
https://ip/api/ota/findGoodsByNo
## 請求參數
| 字段 | 類型 | 是否必須 | 備注 |
| --- | --- | --- | --- |
| tripAirportCode | String | 是 | 機場編號 |
|goodsNo | List | 是 | 服務項編號列表 |
| runum | String | 是 | 流水號 |
[TOC]
## 請求報文
數據類型Content-Type: Params
```
appCode=""
timeStamp=""
sign=""
```
數據類型Content-Type: application/json
```
{
"goodsNo": [
"string"
],
"runum": "string",
"tripAirportCode": "string"
}
```
## 響應參數
| 字段 | | 類型 | 描述 | 備注 |
| --- | --- | --- | --- | --- |
| code | | int| 返回狀態 | 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\":\"\"}]"
}
]
}
```
