E-Build API 用户手册
编写单位:中国航信研发中心总体设计部基础平台组
1
本手册使用说明...............................................................................4
一、基本民航订座知识....................................................................5
1.1 什么是订座.......................................................................................................5
1.3 旅客姓名记录—PNR.......................................................................................5
1.4 订座流程(从查询到出票)...........................................................................6
1.5 出票...................................................................................................................6
1.6 民航系统的数据表述.......................................................................................6
1.7 注意事项...........................................................................................................7
二、什么是 E-Build API...................................................................8
2.1 E-Build API.......................................................................................................8
2.2 E-Build API 的特点..........................................................................................8
2.3 主要功能列表...................................................................................................9
三、您为什么需要.........................................................................10
3.1 构建自己的商务模式.....................................................................................10
3.2 方便的开发.....................................................................................................10
3.3 完备的日志管理.............................................................................................11
3.4 确保使用安全.................................................................................................11
四、使用之前................................................................................12
4.1 E-Build API 客户端........................................................................................12
4.2 E-Build API 客户端的运行环境....................................................................12
4.3 E-Build API 客户端的使用前提....................................................................12
4.4 开发环境部署.................................................................................................12
五、开发指南................................................................................15
5.1 AV 解惑...........................................................................................................15
5.1.1 AV 指令介绍............................................................................................................15
5.1.2 E-BUILD API 中 AV 类...........................................................................................15
5.1.3 获取舱位信息的方法..............................................................................................17
5.2 AV 和 FD 相结合............................................................................................17
5.3 订座指南.........................................................................................................19
5.3.1 订座流程图..............................................................................................................19
5.3.2 SS 的使用.................................................................................................................20
5.3.3 PNR 封口.................................................................................................................20
5.3.4 对于旅客姓名的特殊说明......................................................................................20
5.3.5 假 A 现象.................................................................................................................21
5.4 PNR 其它组的输入........................................................................................21
5.5 从费改税看 FF................................................................................................21
5.6 行动代码的说明.............................................................................................22
5.7 航班变更的处理方法.....................................................................................23
2
5.8 外航订座技巧.................................................................................................24
5.8.1 代理人系统与外航订座系统的连接方式.............................................................24
5.8.2 连接状态的查看......................................................................................................24
5.8.3 外航订座小技巧......................................................................................................26
5.9 E-Build API 新功能介绍................................................................................27
5.9.1 ASR(机上座位预订)..........................................................................................27
六、使用中的问题集......................................................................28
6.1 关于连接问题.................................................................................................28
6.2 订座不成功问题.............................................................................................28
6.3 PNR 修改问题................................................................................................28
6.4 PAT 问题.........................................................................................................29
附 1....................................................................................................................................29
E-Build API 指令接口..........................................................................................29
3
本手册使用说明
本手册内容涵盖了中航信的互联网订座引擎 E-Build API 的产品介绍、服
务申请流程和具体开发指南。
对于完全不熟悉订座业务的开发人员,在本文第一章专门介绍订座常识和
基本概念。已经熟悉这方面业务的人员完全可以跳过这一章进入后面的内容。
第二章是对于 E-Build API 的简要介绍、E-Build API 特点和基本功能简
介。第三章介绍了 E-Build API 能够解决哪些用户的哪些需要。第四章介绍了
使用 E-Build API 的前提配置、E-Build API 部署方案和申请 E-Build API 的详
细流程。其中关于 E-Build API 两个主要包的内部关系图清晰直观的给出了围
绕航班查询和订座的这些类的关系和使用方法。
第五章开发指南是手册的重点章节,介绍了使用 E-Build API 的开发过程
中可能出现的问题和解决方法,还有一些使用技巧。结合用户手中已有的接口
详细文档来看,效果最佳。最后一章的问题集收集了我们在 E-Build API 支持
中用户可能出现的问题和解答,如果您碰到了问题,可以根据问题的分类在这
里寻求答案。这样的篇章设计相信对刚开始接触 E-Build API 的用户起到很好
的帮助作用。
本手册的编写得到了公司各方面的大力支持和配合,现在还很不完善。希
望各方在读后给出修改意见,并联系我们,以便我们更好的改进。
李明 中国航信研发中心总体设计部基础平台组 Tel: 86-10-84669396
ibesupport@travelsky.com
2010-08-05
4
一、基本民航订座知识
1.1 什么是订座
简要地说,订座就是订取某航班的一个座位。在中国民航系统主机上存放了大量航班
座位信息。旅客想乘坐任何一个航空公司的客机出行,必须首先在主机系统预定一个座位
这就需要向主机询问某时间、出发到达地是否有合适的航班、可利用的座位。如果确定预
订该座位,系统就会生成一个记录编号—PNR(Passenger Name Recoder),这个订座
记录将会跟随旅客,从订妥座位,行程修改,付款,出票,机场登机,一直到航班起飞到
达目的地后,该记录才会被系统删除。不管订座的方式、流程如何复杂多样,原理都是这
样的。
大型主机系统处理能力超强,但是其特有的通信方式和指令格式给订座带来了不便。
只有受过订座指令培训的专业操作员,在专有终端上,才能够自如的与主机进行信息交互
下面就是传统订座模式图。
图 1.1 传统订座模式图
1.3 旅客姓名记录—PNR
所谓的订妥座位就是生成一个 PNR(Passenger Name Recoder,旅客订座记录)
5
- 1
- 2
前往页