API用户手册.doc

用户手册第一章 前言1.1 背景：当前采用的APIS基于US EDIFACT，不能包含所有的UN EDIFACT要求的数据元素，因而美国、加拿大要求航空公司于近日采用基于UN EDIFACT标准的PAXLST。和目前的API信息相比，美国PAXLST增加的信息有：居住国、美国地址（美国公民或持美国居住卡的除外）、护照到期日期，加拿大PAXLST增加的信息：居住国、护照到期日期。PAXLST通常都只要求一种有效证件信息，最多不超过两种，首选护照信息，每个旅客包括婴儿都必须持有至少一种有效证件。1.2 现状：当前订座系统的有SSR PSPT内容，不包括DOCS、DOCO、DOCA，不能提供美国/加拿大PAXLST所需增加的信息。1.3 需求：1. 增加三种SSR TYPE：DOCS、DOCO、DOCA2. 允许用户通过DPS方式以及手工输入SSR指令方式输入PAXLST信息3. 接收处理TYPE-A、TYPE-B的SSR DOCS/DOCO/DOCA报文4. 对国航飞美国/加拿大的航班进行出票限制，必须满足：a) 飞往美国的航班，出票之前PNR中必须输入SSR DOCS项以及SSR DOCA R/（居住地址）和SSR DOCA D/（目的地地址）三项内容；b) 美国出港的航班以及飞往加拿大的航班，出票之前PNR中必须输入SSR DOCS信息。第二章 指令说明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,In域字符可选描述1.DAPI:否指令名称2.P1-3n 否P旅客标识3.,I1n是I 婴儿标识DPS屏幕：更新DPS屏幕中的内容，可以自动构造当前PNR中的SSR (DOCS，DOCO，和DOCA)项。 123456789012345678901234567890123456789012345678901234567890123456789012345678901UAPI:Pn,In * All Dates in DDMMMYY Format *2SSR DOCS PRIMARY TRAVEL DOCUMENT INFORMATION3Surname: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Gender(M/F/U): a Infant(Y/N): a姓 性别 是否是婴儿4First Name: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Date of Birth: DDMMMYY名 出生日期5Middle Name: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Nationality: aaa中间名 国籍6Document Type: aa Document Number: xxxxxxxxxxxxxxx Issuing Country/State: aaa证件类型 证件号码 证件签发国家或地区7Expiry Date: DDMMMYY Multi-Passenger Primary Passport Holder(Y/N): a有效期限 否证件持有者89SSR DOCO OTHER TRAVEL RELATED INFORMATION 10Place of Birth: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 出生地11Document Type: a Document Number: xxxxxxxxxxxxxxx 类型（目前只有VISA,V） VISA卡号12Place of Issue: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Issue Date: DDMMMYYVISA卡签发地 签发日期13Country/State applies: aaa VISA卡使用有效国家或地区代码1415SSR DOCA ADDRESS INFORMATION16Residence Address: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx居住详细地址17 City: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Postal Code: xxxxxxxxxxxxxxxxx居住城市 邮编18 State/Province/Country Sub: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Country: aaa 所在省市（州）信息 居住国19Destination Address: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx目的地详细地址20 City: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Postal Code: xxxxxxxxxxxxxxxxx 目的地城市 邮编21 State/Province/Country Sub: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Country: aaa 目的地所在省市（州）信息 目的地国家代码2223 TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH 在此确定所作更新 F3键取消修改 F4键刷新24第1行 UAPI: 指令输入行。这行是不可以修改的。1 2 3 5-UAPI:Pn,In * All Dates in DDMMMYY Format *域字符可选描述1.UAPI:保护指令名称2.P1-3n 保护P旅客标识3.,I1n保护I 婴儿标识4. 保护所有日期均按DDMMMYY 这种格式第2行1SSR DOCS PRIMARY TRAVEL DOCUMENT INFORMATION域字符可选描述 1. 保护SSR DOCS 首要信息第3行1 2 3Surname: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Gender(M/F/U): a Infant(Y/N): a 域字符可选描述 1. 保护姓: 1-30a否姓会自动按用户指定的旅客序号从当前的PNR中获得。如果PNR中的姓名与证件姓名不同，需以证件姓名为准。2. 保护性别(M/F/U): 1a否合法的性别： M 男 F 女 U unspecified3.保护婴儿(Y/N): 1a否 标识该名旅客是否是婴儿。合法的输入：Y 该名旅客是婴儿 N 该名旅客不是婴儿;缺省第4行1 2 First Name: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Date of Birth: DDMMMYY域字符可选描述 1. 保护名: 1-30a否名会自动按用户制定的旅客序号从当前的PNR中获得。如果PNR中的姓名与证件姓名不同，需以证件姓名为准。2. 保护出生日期: DDYYYMM否出生日期第5行1 2 Middle Name: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Nationality: xxx域字符可选描述 1. 保护中间名: 1-30a是中间名2.保护国籍: 1-3a否国家代码第 6 行1 2 3Document Type: aa Document Number: xxxxxxxxxxxxxxx Issuing Country/State: aaa 域字符可选描述 1 保护 证件类型: 1-2a 否合法的证件类型: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 Passport2. 保护 证件号码: 1-15x 否证件号码。 3.保护签发国家: 1-3a否签发国家。第 7 行 1 2 Expiry Date: YYMMDD Primary Passport Holder(Y/N): a域字符可选描述 1. 保护 过期日: YYMMDD 否证件过期日2. 保护多人护照的主持有者 (Y/N): 1aM标识，合法的输入有：Y 为主持有者 N 非主持有者 (如婴儿)第8行空行第9行1SSR DOCO OTHER TRAVEL RELATED INFORMATION域字符可选描述 1. 保护SSR DOCO 其它旅行相关信息第10行1 Place of Birth: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 域字符可选描述 1. 保护出生地: 1-35a是出生地址第 11 行1 2Document Type: a Document Number: xxxxxxxxxxxxxxx域字符可选描述 1. 保护 证件类型 1a条件证件类型V 如果为VISA信息的话，必须输入V2. 保护证件号码: 1-15x条件 证件号码。 如果为VISA的话，此项为必输项.第 12 行1 2 Place of Issue: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Issue Date: DDMMMYY 1. 保护签发地: 1-35a 选择签发地. 如果为VISA的话，此项为必输项。2. 保护签发日期: DDMMMYY选择签发日期. 如果为VISA的话，此项为必输项.第 13 行1 Country/State applies: aaa 域字符可选描述 1. 保护适用国: 1-3a 选择适用国. 如果为VISA的话，此项为必输项.第14 行空行第15 行1SSR DOCA ADDRESS INFORMATION域字符可选描述 1. 保护SSR DOCA 地址信息第16行1 Residence Address: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 域字符可选描述 1. 保护居住地址： 1-35x是居住街道的详细信息第17行 1 2 City: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Postal Code: xxxxxxxxxxxxxxxxx域字符可选描述 1. 保护城市: 1-35a 否居住城市2. 保护邮编 1-17x是居住地的邮政编码第18行 1 2 State/Province/Country Sub: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Country: aaa域字符可选描述 1. 保护州/省/市/县: 1-35a 是居住地所在州/省/市/县. 2. 保护国家 1-3a 否居住地的国家代码. 第19行1 Destination Address: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 域字符可选描述 1. 保护目的地 1-35x是目的地街道详细地址第20行 1 2 City: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Postal Code: xxxxxxxxxxxxxxxxx域字符可选描述 1. 保护 城市: 1-35a M 目的地城市2. 保护邮编: 1-17x是邮政编码.第21行 1 2 State/Province/Country Sub: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Country: aaa域字符可选描述 1. 保护 州/省/市/县: 1-35a 是 目的地所在州/省/市/县. 2. 保护 国家 1-3a 否 目的地的国家代码. 第 22 行空行第 23 行 1 2 TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH 域字符可选描述 1. b 保护条件在此处回车确认域. 将光标移至此处后，回车将确认修改。2. 保护 F3 取消 F4 刷新标准的DPS屏幕功能键.第 24 行空行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 2002.04.23身份证号码 Identity card No. 110108670424373POCHNZHANGDALONG1438102979CHN6704241M020423319201100DAPI:P1UAPI: 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 DNRT4 2. CA981 Y TU13SEP PEKJFK HK1 1300 1430 3. DL175 Y TU13SEP JFKATL HN1 1720 2000 4.C 5.T 6.SSR OTHS CA TKTL ADV TKT NBR TO CA BY 11SEP05/1514/PEK TIM/OR NO ALL SG/BCS CA 981 /Y/13SEP/PEKJFK 7.SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/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.XN/IN/ZHANG/XIAOLONG(DEC04)/P1 12.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:10DEC04 Middle Name:_ Nationality:CHN Document Type:P_ Document Number:143810297_ Issuing Country/State:CHN Expiry Date:23APR02 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 DNRT4 2. CA981 Y TU13SEP PEKJFK HK1 1300 1430 3. DL175 Y TU13SEP JFKATL HN1 1720 2000 4.C 5.T 6.SSR OTHS CA TKTL ADV TKT NBR TO CA BY 11SEP05/1514/PEK TIM/OR NO ALL SG/BCS CA 981 /Y/13SEP/PEKJFK 7.SSR DOCS CA HK1 P/CHN/143810297/CHN/10DEC04/MI/23APR02/ZHANG/XIAOLONG/ /P1 8.SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/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.XN/IN/ZHANG/XIAOLONG(DEC04)/P1 15.PEK099 说明：1) 张大龙：护照持有者（输入H）证件类型：P 护照签发国：CHN 护照号：143810297 国籍：CHN出生日期：24APR67 性别：M 证件有效期：23APR02姓： ZHANG 名：DALONG2) 张小龙：男婴，护照信息与张大龙的一致，出生日期为2004年12月10日，不占座。7.SSR DOCS CA HK1 P/CHN/143810297/CHN/10DEC04/MI/23APR02/ZHANG/XIAOLONG/P1 8.SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/ZHANG/DALONG/H/P1 3) 居住地址：中国北京东四西大街100号，邮编1000274) 目的地址：佐治亚州GEORGIA（GA）亚特兰大ATLANDA（ATL），No. 17, STREET2。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 2.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信息2.2 SSR 指令输入2.2.1 指令功能SSR DOCS：输入旅客的护照等证件信息SSR DOCA：输入旅客的居住地以及目的地地址信息SSR DOCO：输入旅客的其他相关信息，如VISA卡信息等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 护照号：14381