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：照片PCHN143810297姓 名 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 2012.04.23身份证号码 Identity card No. 110108670424373POCHNZHANGDALONG1438102979CHN6704241M020423319201100DAPI: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:143810297_ 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 2005 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/143810297/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:143812097_ 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 2005 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/143812097/CHN/10APR05/MI/23APR12/ZHANG/XIAOLONG/P1 8.SSR DOCS CA HK1 P/CHN/143810297/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:143810297_ 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 2005 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 DL HK1 P/CHN/143810297/CHN/24APR67/M/23APR12/ZHANG/DALONG/H/P1 8.SSR DOCS CA HK1 P/CHN/143812097/CHN/10APR05/MI/23APR12/ZHANG/XIAOLONG/P1 9.SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR12/ZHANG/DALONG/H/P1 10.SSR DOCA DL HK1 D/USA/NO 17 STREET2/ATLANDA/GA/1234567/P1 11.SSR DOCA DL HK1 R/CHN/NO 100 DONGSI WEST STREET/BEIJING/100027/P1 12.SSR DOCA CA HK1 D/USA/NO 17 STREET2/ATLANDA/GA/I/P1 13.SSR DOCA CA HK1 R/CHN/NO 100 DONGSI WEST STREET/BEIJING/100027/I/P1 14.SSR DOCA CA HK1 D/USA/NO 17 STREET2/ATLANDA/GA/1234567/P1 15.SSR DOCA CA HK1 R/CHN/NO 100 DONGSI WEST STREET/BEIJING/100027/P1 16.OSI YY 1INF ZHANG/XIAOLONG/P1 17.RMK CA/E1EJM 18.RMK 1G/RVMLQY -19.XN/IN/ZHANG/XIAOLONG(APR05)/P1 20.PEK0992.1.4 DAPI部分错误提示TRANSMIT FROM APPROPRIATE PLACE在确认域出回车FUNCTION KEY INVALID, ONLY FUNCTION F3 AND F4 ARE VALID功能键错误，请使用F3或F4键GENGER性别输入错误，合法的性别为：F-女性M-男性 U-不确定NATIONALITY请校验国家代码的正确性DOCUMENT TYPE证件类型错误，DOCS合法的证件类型为：F,A,C,AC,P,IP,I；DOCO合法的证件类型为：VDOCUMENT NUMBER证件号码不合法DOCS IS REQUIRED FOR DOCO请在填写DOCO信息前，先填写DOCS信息CHECK INFANT请检查指定旅客是否带有婴儿USA STATE CODE ERROR美国州的两字代码错误ADDRESS TYPE:R FOR RESIDENCE;D FOR DESTINATION地址类型错误，R指居住地；D指目的地DUP ID目前指定旅客已存在相应的DOC信息EXIST INVALIDATE CHARACTER 存在不可接受的字符2.2 SSR 指令输入2.2.1 指令功能SSR DOCS：输入旅客的护照等证件信息SSR DOCA：输入旅客的居住地以及目的地地址信息SSR DOCO：输入旅客的其他相关信息，如签证信息等2.2.2 SSR DOCS/DOCO/DOCA指令输入格式：所有输入，如果有缺失的可选项，必须输入“/”表示该项缺失，如果该缺省项位于输入的最后，这时不需要补“/”。以下分别对DOCS/DOCO/DOCA的格式进行说明：有下划线的部分为必输项，其余为可选项。注：本格式说明参照AIRIMP制定，具体的必输或选输项请参照相关标准及离港要求。2.2.2.1 DOCS1. 指令格式：SSR DOCS 航空公司代码 Action-Code 1 证件类型/发证国家/证件号码/国籍/出生日期/性别/证件有效期限/SURNAME(姓)/FIRST-NAME(名)/MID-NAME(中间名)/持有人标识H/P12. 说明：类型说明exampleSSR3A指令标识SSRDOCS4ASSR Service Type，用于输入证件信息DOCS航空公司代码2AN或3A航空公司代码CAAction-Code2AAction Code，这里，只能允许输入“HK”这一种Action Code HK11nNumber in party，只能输11证件类型1-2A包括：F Approved non-standard identity documents used for travel (as defined by the issuing Country/State)AC Crew Member CertificateA, C, I Identity Card (as defined by the issuing Country/State)IP Passport CardP Passenger PassportP证件签发国1-3A证件签发的国家或地区代码USA证件号码1-15AN证件的号码P12345678国籍1-3A旅客的国籍，代码USA出生日期7ANDDMMMYY格式10MAY79性别 1-2AF - Female女M - Male男 FI - Female Infant 婴儿，女MI - Male Infant 婴儿，男U - Undisclosed Gender 未知说明：必须先有XN:输入婴儿信息之后才能输入FI/MIM证件到期日7ANDDMMMYY格式10MAY10Surname1-30A姓，需要与护照上的一致，（有扫描区的以扫描区为准）STEVENSONFirst given name1-30A名字，需要与护照上的一致，（有扫描区的以扫描区为准）JOHNSecond given name1-30A需要与护照上的一致，（有扫描区的以扫描区为准），可选（如果没有，不填）RICHARDH1AMuti-passenger passport, 护照持有者标识，可选HPSGR-IDPn旅客标识，用P1,P2等表示。说明：对单人PNR，可以不输入PSGR-ID，系统会自动为其添加/P1如果是多人PNR，必须输入PSGR-ID，并且一名旅客只能对应一个DOCS，一个SSR DOCS element也只能对应一个PSGR-ID。P13. 实例：例1、旅客张大龙，护照： 照片PCHN143810297姓 名 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 2002.04.23身份证号码 Identity card No. 110108670424373POCHNZHANGDALONG1438102979CHN6704241M02042331920110006DOCS输入：SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/ZHANG/DALONG/P1说明：证件类型：P 护照签发国：CHN 护照号：143810297 国籍：CHN出生日期：24APR67 性别：M 证件有效期：23APR02姓： ZHANG 名：DALONG注：如果出现扫描区的信息与护照上其他信息冲突的时候一定以扫描区内容为准。例2、旅客张大龙带着一名儿童张小龙和一名婴儿张强，持例一中的护照旅行：DOCS输入：SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/ZHANG/DALONG/H/P1SSR DOCS CA HK1 P/CHN/143810297/CHN/10DEC04/MI/23APR02/ZHANG/QIANG/P1SSR DOCS CA HK1 P/CHN/143810297/CHN/20SEP99/M/23APR02/ZHANG/XIAOLONG/P2说明：1) 张大龙：护照持有者（输入H）证件类型：P 护照签发国：CHN 护照号：143810297 国籍：CHN出生日期：24APR67 性别：M 证件有效期：