# 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\":\"\"}]"
}
]
}
```
- 1、接入指南
- 2、接口列表
- 2.1、中转服务
- 2.1.1、行李免提订单生成修改
- 2.1.2、行李免提订单状态推送
- 2.1.3、中转礼包接口
- 2.2、用户中心
- 2.2.1、服务人员
- 2.2.2、车辆管理
- 2.2.3、商户管理
- 2.2.4、token相关
- 2.2.5、投诉对接
- 2.2.6、会员相关
- 2.3、消息中心
- 2.3.1、短信消息
- 2.3.2、语音消息
- 2.4、航班中心
- 2.4.1、获得指定离港航班信息
- 2.4.2、获得指定进港航班信息
- 2.4.3、获取离港航班信息列表
- 2.4.4、获取进港航班信息列表
- 2.4.5、获取离港目的地列表
- 2.4.6、获取进港出发地列表
- 2.4.7、获取热门城市列表
- 2.4.8、获得安检信息列表
- 2.4.9、获得值机信息列表
- 2.4.10、中转数据MQ接入
- 2.4.11、数据中心MQ数据(含安检)
- 2.5、订单中心
- 2.5.1、核销接口
- 2.6、对接中心
- 2.6.1大巴对接
- 2.6.2停车对接
- 2.6.3app对接
- 3、常见问题