行李额增值服务上线流程与注意事项
1. 上线流程
-
联系对口业务提供增值服务合同，供应商签订合同后寄给我司，合同走OA审批流程。
-
登录供应商管理系统-附加产品-行李价格库，供应商可以查看对应航线的行李价格，操作手册见如下。
-
合同审批通过后，增值服务才可以开放。
-
供应商提供行李额结算负责人与联系方式，对接我司财务同事结算。
-
上线后，生产环境下单测试是否正常。
行李额价格库操作手册
1. 查询携程行李价格库数据
选择审核状态“审核通过“，点击“查询“按钮：
注：携程行李价格库数据里是航司的原始价格，使用后会自动加价
2. 提出异议
如果航司价格有更新，跟携程价格差距较大，则点击“异议“，在异议页面填入新的预订价或者补订价，如果不确定补订价，可以不填。
2. 预订流程
行李额增值服务预订流程：
1. 生单
在乘机人页面展示行李额选项供用户选择，用户选择行李额后，生单request中会附带行李额参数，本次生单请求返回成功，则视为行李预订成功。
| 字段名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| passengerbaggages | No | array | 乘机人预订行李信息，参考 PassengerBaggage Element |
注意点：用户订位之后再回退修改/添加/取消购买行李额，会重新发送一次订位请求（订单号相同）
Modify订位请求报文：
2. 出票
用户机票与行李打包购买并支付成功后，订单处理API接口与Tbooking系统中机票的出票单中会有客人购买行李额的出票信息，机票回填出票成功后，行李会mock出票成功，无需供应商手动回填行李出票结果。
备注：行李mock出票仅限随机票一起订位的场景。
老API接口行李参数见下表，契约地址：
https://trade.trip.com/fltconfigsystem/ApiDoc/zh-cn/Booking/FlightApi/OpenApiExchange/IssueBillInfo
| 字段名 | 说明 | 类型 | 备注 |
|---|---|---|---|
| BaggagesAndMealInfos | 行李和餐食信息集合 | List | |
| BaggagesAndMealInfo | 餐食和行李详细信息 | ||
| ProductOrderID | 产品ID | Int64 | |
| Sequence | 航程序列 | int | |
| BaggagesType | 产品类型 | Byte | 1:行李 2:餐食 3:行李+餐食 |
| Weight | 行李重量 | decimal | |
| MealsType | 餐食类型 | int | 0:默认值 餐食类型待开放 |
| ProductDescription | 餐食或行李说明 | string | |
| PrintPrice | 票面价格 | decimal | |
| SalePrice | 卖价 | decimal | |
| CostPrice | 底价 | decimal | |
| RefundInfo | 退票描述 | string | 对客人的退票描述 |
| RefundSupplierInfo | 供应商退票描述 | string | |
| PassengerName | 乘客姓名 | string | |
| OrderStatus | 行李额子状态 | string | W:待处理 C:已取消 S:已成交 |
| SegmentNo | 航段号 | int | 多程航班对应客人选择的航段编号 |
| AirportSalePrice | 机场卖价 | decimal |
新API接口名QueryIssuingDetail，契约节点见BaggageAndMealInfo，契约地址：
https://developers.trip.com/flight/docs/supplier-ticketing-service/?lang=zh-CN#tag/Service/operation/QueryIssuingDetail
图1 Online增值服务页面行李购买示意图
图2 行李额订单Tbooking示意图
3. 注意事项
-
加价规范：适用于预订与补订
-
售卖增值行李的航线，需准确给自带的免费托运行李或手提行李赋值，避免用户投诉。
-
增值服务开放后，请提供票台负责的结算同事的姓名、联系方式，行李订单由财务同事单独结算，两周一次。
-
行李订单能通过订单处理出票API接口获得订单信息（自动出票）；另，T-booking里面未出票列表中也能获得订单信息，但需要点开出票单详情查看（手工出票）。
-
airportSalePrice节点代表“机场参考价“，如果机场参考价比行李卖价高的话，会展示出来，引导用户购买。
4. 行李额补订
补订行李的功能会同步开放，价格在预订价的基础上按照一定规则加价作为补订价。
1. 补订订单Tbooking显示列表
增值服务单据 ➜ 增值服务预订
2. 补订订单出票方式
预订列表 ➜ 【类型】国际行李额 ➜ 查询 ➜ 操作 ➜ 出票成功
（点击“认领“后会进入“我的预订列表“）
3. 补订行李订单出票API接口地址
https://developers.trip.com/flight/docs/supplier-ancillary-service/?lang=zh-CN
- (1) X产品行李额出票单列表查询接口：QueryAncillaryIssuingList
- (2) X产品行李额出票单详情查询接口：QueryAncillaryIssuingDetail
- (3) X产品出票单回执接口：SubmitAncillaryStatus
注意：
-
仅能获取补订订单，预订订单仍按照老模式；
-
同一次预订下的所有行李需要一起返回结果，用issueinfoID区分是否是同一次预订；
-
接入接口后，tbooking增值服务单据仍可显示行李订单；
-
行李producttype=8；
-
列表查询接口，查询出票成功的行李单据时，能查询到mock出票成功的单据。单据Issuingway=0，则表示mock出票的单据。