# 机场中转礼包对接开发指南 # 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、业务流程介绍 业务流程图如下: ![](https://img.kancloud.cn/9a/59/9a5994edc9c778c16e7b84f479488c6a_1079x717.png) 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\":\"