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 4DAPI:Pn/Sn,In例1：为PNR中第二名旅客添加API信息，默认航空企业为CADAPI:P2例2：为PNR中第一名旅客按指定航段所属航空企业添加API信息DAPI:P1/S3例3：为PNR中第二名旅客所带婴儿添加API信息，默认航空企业为CADAPI:P2,I1域字符可选描述1DAPI:否指令2P1-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 Name:LIN_ 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各个域具体描述序号域描述备注1Surname姓姓名会自动按用户指定旅客序号从目前PNR中取得。假如和证件中姓名不一致，则需重新输入，即以证件中姓名为准。2Gender性别M 男性 F 女性 U 中性3Infant婴儿标识Y 该名旅客是婴儿N 该名旅客不是婴儿4First Name名姓名会自动按用户指定旅客序号从目前PNR中取得。假如和证件中姓名不一致，则需重新输入，即以证件中姓名为准。5Date of Birth出生日期格式为DDMMMYY6Middle Name中间名为可选项7Nationality国籍ISO国家2字或3字代码8Document Type证件类型正当证件类型有：F Approved non-standard identity document for travel (defined by issuing Country/State)AC Crew Member CertificateA 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 CardP Passenger Passport9Document Number证件号码只接收数字和字母类字符10Issuing Country/State签发国ISO国家2字或3字代码11Expiry Date过期日格式为DDMMMYY12Multi-Passenger Primary Passport Holder(Y/N)是否为证件持有者Y 该名旅客为证件持有者N 该名旅客非证件持有者13Place of Birth出生地只接收字母类字符14Document Type证件类型现在只支持V 即签证15Document Number证件号码只接收数字和字母类字符16Place of Issue签发地只接收字母类字符17Issue Date签发日期格式为DDMMMYY18Country/State applies适用国ISO国家2字或3字代码19Residence Address居住地居住地街道具体信息20All(X) 对PNR中全部旅客有效表示对PNR中全部旅客有效，反应到pnr中则为不带psgr-id，而且HK后数值为PNR总人数21City城市居住城市22Postal Code邮编居住地邮政编码23State/Province/Country Sub州/省/地域假如居住国为美国，此处必需输入州名2字代码24Country国家ISO国家2字或3字代码25Destination Address目标地目标地街道具体信息All(X):表示对PNR中全部旅客有效，反应到pnr中则为不带psgr-id，而且HK后数值为PNR总人数26All(X) 对PNR中全部旅客有效表示对PNR中全部旅客有效，反应到pnr中则为不带psgr-id，而且HK后数值为PNR总人数27City城市目标城市28Postal Code邮编目标地邮政编码29State/Province/Country Sub州/省/地域假如目标国为美国，此处必需输入州名2字代码30Country国家ISO国家2字或3字代码2.1.3 实例:旅客张大龙带着一名婴儿张小龙，持例以下护照旅行。旅客居住地址：中国北京东四西大街100号，邮编100027，带着一名婴儿。前往佐治亚州GEORGIA（GA）亚特兰大ATLANDA（ATL）No. 17, STREET2：照片PCHN姓 名 Name in full 张 大 龙 ZHANG DALONG性 别 Sex 男 M身 份 Profession企 业 管 理 人 员 MANAGER婚姻情况 Marital status未 婚SINGLE出生日期 Date of birth1976.04.2424 APR 1967出生地点 Place of birth北 京BEIJING使用期至 Date of expiry .04.23身份证号码 Identity card No. 373POCHNZHANGDALONGCHN6704241M100DAPI: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,I1UAPI: 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/S3UAPI: 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