# 機場中轉禮包對接開發指南
# 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\":\"\"}]"
}
]
}
```