# 机场中转礼包对接开发指南
# 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\":\"\"}]"
}
]
}
```
