API订座用户手册模板.doc

API订座用户手册
第一章 序言
依据中国公安部、民航总局要求，全部出入中国航班全部需要于5月1日发送旅客及机组人员API信息。包含：
l 旅客姓名
l 旅客出生日期
l 旅客性别
l 旅客国籍
l 证件号码
l 证件类型
l 证件到期日 (Passport Expiry Date)
l 证件签发国 (Country of Issue)
为了能按时、正确向中国政府提供旅客API信息，依据航空企业要求在订座系统中增加销售限制，即：销售人员在出票时必需在订座系统中输入中国政府要求相关信息，不然将无法打印客票（含电子客票）。
用户能够经过DPS方法和手工输入SSR指令方法输入旅客API信息。
第二章将介绍API相关指令格式及功效，其中DAPI指令和SSR DOCS指令能够输入上述八项API信息
第三章附上系统中出票限制
第二章 指令说明
2.1 DPS输入
2.1.1 指令功效
DAPI是为了方便用户向PNR中添加API信息（即SSR DOCS，DOCO，和DOCA）而设计。它会自动将目前PNR中相关信息如姓名项等显示在DPS屏幕上，用户能够经过填写DPS中相关项中内容来完成API信息添加。现在DAPI指令不提供回显功效。
2.1.2 指令格式
1 2 3 4
>DAPI:Pn/Sn,In
例1：为PNR中第二名旅客添加API信息，默认航空企业为CA
>DAPI:P2
例2：为PNR中第一名旅客按指定航段所属航空企业添加API信息
>DAPI:P1/S3
例3：为PNR中第二名旅客所带婴儿添加API信息，默认航空企业为CA
>DAPI:P2,I1

域
字符
可选
描述
1
DAPI:
否
指令
2
P1-3n
否
P后为旅客序号
3
/S1-3n
可选
/S后接航段在PNR中序号
4
,I1n
可选
,I后接婴儿序号，现在只支持1一个婴儿

2.1.3 DPS屏幕
更新DPS屏幕中内容，能够自动结构目前PNR中SSR (DOCS，DOCO，和DOCA)项
UAPI: P1 *** All Dates in DDMMMYY Format ***
指令行
SSR DOCS - PRIMARY TRAVEL DOCUMENT INFORMATION
关键旅行证件
Surname:TEST__________________________ Gender(M/F/U):_ Infant(Y/N): N
姓 性别 婴儿标识
First NameLIN___________________________ Date of Birth:_______
名 出生日期
Middle Name:______________________________ Nationality:___
中间名 国籍
Document Type:__ Document Number:_______________ Issuing Country/State:___
证件类型 证件号码 签发国
Expiry Date:_______ Multi-Passenger Primary Passport Holder(Y/N):_
过期日 是否为证件持有者

SSR DOCO - OTHER TRAVEL RELATED INFORMATION
其它旅行证件
Place of Birth:___________________________________
出生地
Document Type:_ Document Number:_______________
证件类型(现在只支持签证) 证件号码
Place of Issue:___________________________________ Issue Date:______
签发地 签发日期
Country/State applies:___
适用国

SSR DOCA - ADDRESS INFORMATION
地址信息
Residence Address:___________________________________ All(X):_
居住地 对PNR中全部旅客有效
City:___________________________________ Postal Code:_________________
城市 邮编
State/Province/Country Sub:___________________________________ Country:___
州/省/地域 国家
Destination Address:___________________________________ All(X):_
目标地 对PNR中全部旅客有效
City:___________________________________ Postal Code:_________________
城市 邮编
State/Province/Country Sub:___________________________________ Country:___
州/省/地域 国家
TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH
确定光标处 F3 – 取消 F4 – 刷新屏幕

表2.1 UAPI指令DPS各个域具体描述
序号
域
描述
备注
1
Surname
姓
姓名会自动按用户指定旅客序号从目前PNR中取得。
假如和证件中姓名不一致，则需重新输入，即以证件中姓名为准。
2
Gender
性别
M 男性 F 女性 U 中性
3
Infant
婴儿标识
Y 该名旅客是婴儿
N 该名旅客不是婴儿
4
First Name
名
姓名会自动按用户指定旅客序号从目前PNR中取得。
假如和证件中姓名不一致，则需重新输入，即以证件中姓名为准。
5
Date of Birth
出生日期
格式为DDMMMYY
6
Middle Name
中间名
为可选项
7
Nationality
国籍
ISO国家2字或3字代码
8
Document Type
证件类型
正当证件类型有：
F Approved non-standard identity document for travel (defined by issuing Country/State)
AC Crew Member Certificate
A Identity Card (defined by issuing Country/State)
C Identity Card (defined by issuing Country/State)
I Identity Card (defined by issuing Country/State)
IP Passport Card
P Passenger Passport
9
Document Number
证件号码
只接收数字和字母类字符
10
Issuing Country/State
签发国
ISO国家2字或3字代码
11
Expiry Date
过期日
格式为DDMMMYY
12
Multi-Passenger Primary Passport Holder(Y/N)
是否为证件持有者
Y 该名旅客为证件持有者
N 该名旅客非证件持有者
13
Place of Birth
出生地
只接收字母类字符
14
Document Type
证件类型
现在只支持V 即签证
15
Document Number
证件号码
只接收数字和字母类字符
16
Place of Issue
签发地
只接收字母类字符
17
Issue Date
签发日期
格式为DDMMMYY
18
Country/State applies
适用国
ISO国家2字或3字代码
19
Residence Address
居住地
居住地街道具体信息
20
All(X)
对PNR中全部旅客有效
表示对PNR中全部旅客有效，反应到pnr中则为不带psgr-id，而且HK后数值为PNR总人数
21
City
城市
居住城市
22
Postal Code
邮编
居住地邮政编码
23
State/Province/Country Sub
州/省/地域
假如居住国为美国，此处必需输入州名2字代码
24
Country
国家
ISO国家2字或3字代码
25
Destination Address
目标地
目标地街道具体信息
All(X):表示对PNR中全部旅客有效，反应到pnr中则为不带psgr-id，而且HK后数值为PNR总人数
26
All(X)
对PNR中全部旅客有效
表示对PNR中全部旅客有效，反应到pnr中则为不带psgr-id，而且HK后数值为PNR总人数
27
City
城市
目标城市
28
Postal Code
邮编
目标地邮政编码
29
State/Province/Country Sub
州/省/地域
假如目标国为美国，此处必需输入州名2字代码
30
Country
国家
ISO国家2字或3字代码

2.1.3 实例:
旅客张大龙带着一名婴儿张小龙，持例以下护照旅行。旅客居住地址：中国北京东四西大街100号，邮编100027，带着一名婴儿。前往佐治亚州GEORGIA（GA）亚特兰大ATLANDA（ATL）No. 17, STREET2：
照片
P
CHN

姓 名 Name in full
张 大 龙
ZHANG DALONG
性 别 Sex
男
M
身 份 Profession
企 业 管 理 人 员
MANAGER
婚姻情况 Marital status
未 婚
SINGLE
出生日期 Date of birth
1976.04.24
24 APR 1967
出生地点 Place of birth
北 京
BEIJING
使用期至 Date of expiry
.04.23
身份证号码 Identity card No.
373
POCHNZHANG<NR：
1.ZHANG/DALONG RZPPP
2. CA981 Y SA10DEC PEKJFK HK1 1300 1330 E
3. DL175 Y MO12DEC JFKATL HK1 1730 DCNT
4.C
5.T
6.SSR OTHS 1E TKTL ADV TKT NBR TO CA BY 08NOV05/1331/PEK TIM/OR NO ALL SG/BCS
CA 981 /Y/10DEC/PEKJFK
7.OSI YY 1INF ZHANG/XIAOLONG/P1
8.RMK CA/E1EJM
9.RMK 1G/RVMLQY
10.XN/IN/ZHANG/XIAOLONG(APR05)/P1
11.PEK099

假如需要向CA提供成人API信息，可输入>DAPI:P1（系统默认航空企业为CA）

UAPI: P1 *** All Dates in DDMMMYY Format ***
SSR DOCS - PRIMARY TRAVEL DOCUMENT INFORMATION
Surname:ZHANG_________________________ Gender(M/F/U):M Infant(Y/N): N
First Name:DALONG________________________ Date of Birth:24APR67
Middle Name:______________________________ Nationality:CHN
Document Type:P_ Document Number:______ Issuing Country/State:CHN
Expiry Date:23APR02 Multi-Passenger Primary Passport Holder(Y/N):Y

SSR DOCO - OTHER TRAVEL RELATED INFORMATION
Place of Birth:___________________________________
Document Type:_ Document Number:_______________
Place of Issue:___________________________________ Issue Date:_______
Country/State applies:___

SSR DOCA - ADDRESS INFORMATION
Residence Address:NO_100_DONGSI_WEST_STREET__________
City:BEIJING____________________________ Postal Code:100027___________
State/Province/Country Sub:_________________________ Country:CHN
Destination Address:NO_17_STREET2____________________
City:ATLANDA____________________________ Postal Code:1234567__________
State/Province/Country Sub:GA_________________________________ Country:USA

TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH 

按上例填写完对应内容后，PNR 输出以下：

1.ZHANG/DALONG RZPPP
2. CA981 Y SA10DEC PEKJFK HK1 1300 1330 E
3. DL175 Y MO12DEC JFKATL HK1 1730 DCNT
4.C
5.T
6.SSR OTHS 1E TKTL ADV TKT NBR TO CA BY 08NOV05/1331/PEK TIM/OR NO ALL SG/BCS
CA 981 /Y/10DEC/PEKJFK
7.SSR DOCS CA HK1 P/CHN//CHN/24APR67/M/23APR12/ZHANG/DALONG//H/P1
8.SSR DOCA CA HK1 D/USA/NO 17 STREET2/ATLANDA/GA/1234567/P1
9.SSR DOCA CA HK1 R/CHN/NO 100 DONGSI WEST STREET/BEIJING//100027/P1
10.OSI YY 1INF ZHANG/XIAOLONG/P1
11.RMK CA/E1EJM
12.RMK 1G/RVMLQY
13.XN/IN/ZHANG/XIAOLONG(APR05)/P1
14.PEK099

再次输入婴儿相关信息，可输入>DAPI:P1,I1

UAPI: P1,I1 *** All Dates in DDMMMYY Format ***
SSR DOCS - PRIMARY TRAVEL DOCUMENT INFORMATION

Surname:ZHANG_________________________ Gender(M/F/U):M Infant(Y/N): Y
First Name:XIAOLONG______________________ Date of Birth:10APR05
Middle Name:______________________________ Nationality:CHN
Document Type:P_ Document Number:______ Issuing Country/State:CHN
Expiry Date:23APR12 Multi-Passenger Primary Passport Holder(Y/N):N

SSR DOCO - OTHER TRAVEL RELATED INFORMATION
Place of Birth:__________________
Document Type:_ Document Number:_______________
Place of Issue:___________________________________ Issue Date:_______
Country/State applies:___

SSR DOCA - ADDRESS INFORMATION
Residence Address:NO_100_DONGSI_WEST_STREET__________
City:BEIJING____________________________ Postal Code:100027___________
State/Province/Country Sub:___________________________________ Country:CHN
Destination Address:NO_17_STREET2______________________
City:ATLANDA____________________________ Postal Code:_________________
State/Province/Country Sub:GA Country:USA

TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH  

按上例填写完对应内容后，PNR 输出以下：

1.ZHANG/DALONG RZPPP
2. CA981 Y SA10DEC PEKJFK HK1 1300 1330 E
3. DL175 Y MO12DEC JFKATL HK1 1730 DCNT
4.C
5.T
6.SSR OTHS 1E TKTL ADV TKT NBR TO CA BY 08NOV05/1331/PEK TIM/OR NO ALL SG/BCS
CA 981 /Y/10DEC/PEKJFK
7.SSR DOCS CA HK1 P/CHN//CHN/10APR05/MI/23APR12/ZHANG/XIAOLONG/P1
8.SSR DOCS CA HK1 P/CHN//CHN/24APR67/M/23APR12/ZHANG/DALONG//H/P1
9.SSR DOCA CA HK1 D/USA/NO 17 STREET2/ATLANDA/GA//I/P1
10.SSR DOCA CA HK1 R/CHN/NO 100 DONGSI WEST STREET/BEIJING//100027/I/P1
11.SSR DOCA CA HK1 D/USA/NO 17 STREET2/ATLANDA/GA/1234567/P1
12.SSR DOCA CA HK1 R/CHN/NO 100 DONGSI WEST STREET/BEIJING//100027/P1
13.OSI YY 1INF ZHANG/XIAOLONG/P1
14.RMK CA/E1EJM
15.RMK 1G/RVMLQY
16.XN/IN/ZHANG/XIAOLONG(APR05)/P1
17.PEK099

假如需要向DL提供成人API信息，可输入>DAPI:P1/S3

UAPI: P1 *** All Dates in DDMMMYY Format ***
SSR DOCS - PRIMARY TRAVEL DOCUMENT INFORMATION
Surname:ZHANG_________________________ Gender(M/F/U):M Infant(Y/N): N
First Name:DALONG________________________ Date of Birth:24APR67
Middle Name:______________________________ Nationality:CHN
Document Type:P_ Document Number______ Issuing Country/State:CHN
Expiry Date:23APR02 Multi-Passenger Primary Passport Holder(Y/N):Y

SSR DOCO - OTHER TRAVEL RELATED INFORMATION
Place of Birth:___________________________________
Document Type:_ Document Number:_______________
Place of Issue:___________________________________ Issue Date:_______
Country/State applies:___

SSR DOCA - ADDRESS INFORMATION
Residence Address:NO_100_DONGSI_WEST_STREET__________
City:BEIJING__________________________ Postal Code:100027___________
State/Province/Country Sub:___________________________________ Country:CHN
Destination Address:NO_17_STREET2____________________
City:ATLANDA____________________________ Postal Code:1234567__________
State/Province/Country Sub:GA_________________________________ Country:USA

TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH 

按上例填写完对应内容后，PNR 输出以下：

1.ZHANG/DALONG RZPPP