1、API 用户手册第一章 前言1.1 背景：当前采用的 APIS 基于 US EDIFACT，不能包含所有的 UN EDIFACT 要求的数据元素，因而美国要求航空公司于 2005 年 10 月 4 日采用基于 UN EDIFACT 标准的 PAXLST，加拿大是 2005 年 11 月 1 日。和目前的 API 信息相比，美国 PAXLST 增加的信息有：居住国、美国地址（美国公民或持美国居住卡的除外） 、护照到期日期，加拿大 PAXLST 增加的信息：居住国、护照到期日期。PAXLST 通常都只要求一种有效证件信息，最多不超过两种，首选护照信息，每个旅客包括婴儿都必须持有至少一种有效证件。1
2、.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/（目的
3、地地址）三项内容；b) 美国出港的航班以及飞往加拿大的航班，出票之前 PNR 中必须输入 SSR DOCS信息。第二章 指令说明2.1 DPS 输入省略2.2 SSR 指令输入2.2.1 指令功能SSR DOCS：输入旅客的护照等证件信息SSR DOCA：输入旅客的居住地以及目的地地址信息SSR DOCO：输入旅客的其他相关信息，如 VISA 卡信息等2.2.2 SSR DOCS/DOCO/DOCA 指令输入格式：所有输入，如果有缺失的可选项，必须输入“/”表示该项缺失，如果该项位于输入的最后，可以不输入“/” ，系统会自动将 “/”补上。以下分别对 DOCS/DOCO/DOCA 的格式进行说
4、明：有下划线的部分为必输项，其余为可选项。注：本格式说明参照 AIRIMP 制定，具体的必输或选输项请参照相关标准及离港要求。2.2.2.1 DOCS1. 指令格式：SSR DOCS 航空公司代码 Action-Code 1 证件类型/ 发证国家/证件号码/ 国籍/出生日期/性别/证件有效期限/SURNAME( 姓)/FIRST-NAME(名)/MID-NAME(中间名)/持有人标识 H/P12. 说明：类型 说明 exampleSSR 3A 指令标识 SSRDOCS 4A SSR Service Type，用于输入证件信息 DOCS航空公司代码 2AN 或 3A 航空公司代码 CAActio
5、n-Code 2A Action Code，这里，只能允许输入“HK”这一种 Action Code HK1 1n Number in party，只能输 1 1证件类型 1-2A 包括：F Approved non-standard identity documents used for travel (as defined P类型 说明 exampleby the issuing Country/State)AC Crew Member CertificateA, C, I Identity Card (as defined by the issuing Country/State)IP
6、Passport CardP Passenger Passport发证国家 1-3A 证件签发的国家或地区代码 USA证件号码 1-15AN 证件的号码 P12345678国籍 1-3A 旅客的国籍，代码 USA出生日期 7AN DDMMMYY 格式 10MAY79性别 1-2A F - Female 女M - Male 男 FI - Female Infant 婴儿，女MI - Male Infant 婴儿，男U - Undisclosed Gender 未知说明：必须先有 XN:输入婴儿信息之后才能输入 FI/MIM证件有效期限 7AN DDMMMYY 格式 10MAY10Surname
7、1-30A 姓，需要与护照上的一致， （有扫描区的以扫描区为准）STEVENSONFirst given name 1-30A 名字，需要与护照上的一致， （有扫描区的以扫描区为准）JOHNSecond given name 1-30A 需要与护照上的一致， （有扫描区的以扫描区为准） ，可选（如果没有，不填）RICHARDH 1A Muti-passenger passport, 护照持有者标识，可选HPSGR-ID Pn 旅客标识，用 P1,P2 等表示。说明：对单人 PNR，可以不输入PSGR-ID，系统会自动为其添加/P1如果是多人 PNR，必须输入 PSGR-ID，并且一名旅客只能对
8、应一个DOCS，一个 SSR DOCS element 也只能对应一个 PSGR-ID。P13. 实例：例 1、旅客张大龙，护照： P CHN 143810297姓 名 Name in full张 大 龙ZHANG DALONG照片性 别 Sex男身 份 Profession企 业 管 理 人 员婚姻状况 Marital status未 婚M MANAGER SINGLE出生日期 Date of birth1976.04.2424 APR 1967出生地点 Place of birth北 京BEIJING有效期至 Date of expiry2002.04.23身份证号码 Identity c
9、ard 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、旅客张大龙带着一名儿童张小龙和一名婴儿
10、张强，持例一中的护照旅行：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出生日期：24APR
11、67 性别：M 证件有效期：23APR02姓： ZHANG 名：DALONG2) 张强：男婴（性别输入 MI） ，护照信息与张大龙的一致，出生日期为 2004 年 12 月 10 日，不占座。3) 张小龙：护照信息与张大龙的一致，男孩（性别输入 M） ，出生日期为 1999 年 9 月 20 日，占座，P22.2.2.2 DOCO目前此项属于可选项。1. 指令格式SSR DOCO 航空公司代码 HK1 出生地/类型 V/VISA 卡号码 /发卡地区/发卡日期/卡有效国家或地区/婴儿标识 I/P1说明：类型 说明 exampleSSR 3A 指令标识 SSRDOCO 4A SSR Service
12、 Type，用于输入证件信息 DOCO航空公司代码 2AN 或 3A 航空公司代码 CAAction-Code 2A Action Code，这里，只能允许输入“HK”这一种 Action Code HK1 1n Number in party，只能输 1 1出生地 1-35A 旅客或机组成员的出生地 AMBER HILL GBR类型 V 1A Travel Document Type，目前只有”v”，表示信用卡，如果出现这一项，接下来的卡号，发卡地区，发卡日期，卡有效国家或州等各项都必须输入。若不输入信用卡信息，直接输入：SSR DOCO CA HK1 Birth-place/p1SSR D
13、OCO CA HK1 Birth-place/I/p1(婴儿)VVISA 卡号码 1-15AN 信用卡号码 9891404发卡地区 1-35A LONDON发卡日期 7AN DDMMMYY 格式 10MAY04卡有效国家或地区 1-3A 信用卡有效使用的国家或地区国家或州）的代码USA婴儿标识 I 1A 婴儿标识，可选，必须先有 XN:输入婴儿信息之后才能输入婴儿标识IPSGR-ID Pn 旅客标识，用 P1,P2 等表示。说明：对单人 PNR，可以不输入 PSGR-ID，系统会自动为其添加/P1如果是多人 PNR，必须输入 PSGR-ID，并且一名旅客只能对应一个 DOCO，一个SSR DO
14、CO element 也只能对应一个PSGR-ID。P12. 实例：1) 输全：SSR DOCO CA HK1 出生地/类型 V/VISA 卡号码/ 发卡地区/发卡日期/ 卡有效国家或州/婴儿标识 I/P1如：SSR DOCOCA HK1 BIRTHPLACE/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/I/P1输出：5.SSR DOCS CA HK1 P/USA/PASSPORTNUMBER/USA/10MAY79/M/10MAY10/SURNAME/ /FIRSENAME/MIDNAME/H/P1 2) 省略出生的信息SSR DOCO CA HK1 /类型 V/
15、VISA 卡号码/ 发卡地区/发卡日期/ 卡有效国家或州/婴儿标识I/P1SSR DOCOCA HK1 /V/VISANUMBER/ISSUEPLACE/10MAY04/USA/I/P1 输出：5.SSR DOCO CA HK1 /V/VISANUMBER/ISSUEPLACE/10MAY04/USA/I/P13) 省略 VISA 信息SSR DOCO CA HK1 出生地/婴儿标识 I/P1如：输入：SSR DOCO CA HK1 BIRTHPLACE/I/P1输出：5.SSR DOCO CA HK1 BIRTHPLACE/I/P1 输入：SSR DOCO CA HK1 BIRTH ADDR
16、ESS/P1 输出：5.SSR DOCO CA HK1 BIRTH ADDRESS/P14) 省略 婴儿标识 ISSR DOCO CA HK1 出生地/类型 V/VISA 卡号码/ 发卡地区/发卡日期/卡有效国家或州/P1如：输入：SSR DOCOCA HK1 BIRTHPLACE/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/P1输出：5.SSR DOCO CA HK1 BIRTHPLACE/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/P12.2.2.3 DOCA1. 指令格式：SSR DOCA 航空公司代码 HK1 地址类型/ 国家/详
17、细地址 /城市/所在省市（州）信息/邮编/I婴儿标识/P1注意：前往美国旅行的旅客，目的地地址(SSR DOCA D/)的所有项必须输全（除了婴儿标识）;所在州必须输两字代码（如 TX） ，请查阅相关代码表。2. 说明：类型 说明 exampleSSR 3A 指令标识 SSRDOCA 4A SSR Service Type，用于输入证件信息 DOCA航空公司代码 2AN 或 3A 航空公司代码 CA类型 说明 exampleAction-Code 2A Action Code，这里，只能允许输入“HK”这一种 Action Code HK1 1n Number in party，只能输 1 1
18、地址类型 1A DOCA 的地址类型：R 居住的地址标识D 目的地地址标识R国家 1-3A 国家代码 USA详细地址 1-35AN 详细地址 1600 SMITH STREET城市 1-35A 所在城市 HOUSTON所在省市（州）信息1-35A 所在省市（州）信息 TX邮编 1-17AN 邮编 77001婴儿标识 I 1A 婴儿标识，可选，必须先有 XN:输入婴儿信息之后才能输入婴儿标识IPSGR-ID Pn 旅客标识，用 P1,P2 等表示。说明：对单人 PNR，可以不输入 PSGR-ID，系统会自动为其添加/P1；如果是多人 PNR，必须输入 PSGR-ID；并且对于每一种 DOCA 地
19、址类别（R/D） ，一名旅客只能对应一个 DOCA，一个 SSR DOCA element 也只能对应一个 PSGR-ID。P13. 举例：SSR DOCA CA HK1 R 或 D 标识/ 国家/详细地址/ 城市/所在省市（州）信息/邮编/I 婴儿标识/P1例 1、旅客居住地址：美国佐治亚州 Georgia（GA）亚特兰大 Atlanta（ATL） ，详细地址为：No. 7, STREET1，邮编 12345，带着一名婴儿。前往德克萨斯州 TEXAS（TX）的奥斯汀AUSTIN（AUS）的 No. 17, STREET2。如：SSR DOCA CA HK1 R/USA/No. 7, STRE
20、ET1/ATLANTA/GA/12345/P1SSR DOCA CA HK1 R/USA/ No. 7, STREET1/ATLANTA/GA/12345/I/P1SSR DOCA CA HK1 D/USA/ No. 17, STREET2/AUSTIN/TX/12345/P1SSR DOCA CA HK1 D/USA/ No. 17, STREET2/AUSTIN/TX/12345/I/P1例 2、居住地址项省略详细地址：SSR DOCA CA HK1 R 或 D 标识 /国家/ /城市/ 所在省市（州）信息 /邮编/I 婴儿标识/P1如：SSR DOCA CA HK1 R/USA/ ATL
21、ANTA /GA/77001/I/P1输出：16.SSR DOCA CA HK1 R/USA/ ATLANTA /GA/77001/I/P1例 3、居住地址项省略多处 OPTIONAL 项（都在输入的最后）SSR DOCA CA HK1 R 或 D 标识/ 国家/详细地址/ 城市/所在省市（州）信息/邮编/I 婴儿标识/P1如：SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON /P1输出：11.SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/P1 例 4、居住地址项省略所在省市、邮编但有婴儿标识
22、I 的输入方法SSR DOCA CA HK1 R 或 D 标识/ 国家/详细地址/ 城市/所在省市（州）信息/邮编/I 婴儿标识/P1如：省略邮编SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/TX/I/P1注：需要输入/I，否则，会把 “I”当成邮编的自由文本输入输出：11.SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/TX/I/P1 错误输入：SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/TX/I/P111.SSR DOCA CA HK1
23、 R/USA/16000 SMITH STREET/HOUSTON/TX/I/P1 同样的如果所在省市和邮编都省略，则需要输入/ISSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/I/P111.SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/I/P1 错误输入：SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/TX/I/P111.SSR DOCA CA HK1 R/USA/16000 SMITH STREET/HOUSTON/TX/I/P1 说明：此
24、时把“I”当成所在省市的自由文本处理。2.2.3 部分错误提示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 R
25、ESIDENCE;D FOR DESTINATION地址类型错误， R指居住地； D指目的地DUP ID目前指定旅客已存在相应的 DOC 信息第三章 出票限制对美国/加拿大航线的航班进行出票限制，必须满足：1. 美国入港的航班，出票之前 PNR 中必须输入 SSR DOCS 项以及 SSR DOCA R/（居住地址）和 SSR DOCA D/（目的地地址）三项内容；a) 旅客必须按要求输入护照或其他证件信息：SSR DOCS婴儿也必须输入相应的 SSR DOCS 项，否则不允许出票，提示：PLEASE INPUT SSR DOCS/SSR DOCA ELEMENT!b) 旅客必须按要求输入居住
26、地址信息：SSR DOCA R/ 婴儿也必须输入相应的 SSR DOCA R/ 项，否则不允许出票，提示：PLEASE INPUT SSR DOCS/SSR DOCA ELEMENT!c) 旅客必须按要求输入目的地址信息：SSR DOCA D/婴儿也必须输入相应的 SSR DOCA D/ 项，否则不允许出票，提示：PLEASE INPUT SSR DOCS/SSR DOCA ELEMENT!2. 美国出港的航班以及加拿大入港的航班，出票之前 PNR 中必须输入 SSR DOCS 信息。旅客必须按要求输入护照或其他证件信息：SSR DOCS婴儿也必须输入相应的 SSR DOCS 项，否则不允许出
27、票，提示：PLEASE INPUT SSR DOCS/SSR DOCA ELEMENT!【特别提示】对于无扫描区的护照，请务必严格按照护照中内容准确输入，避免给旅客在值机时带来不必要的麻烦，甚至导致航班的延误。附录 1 国家代码列表国家名称 二字代码 三字代码ANDORRA AD ANDANGOLA AO AGOANTARTICA AQ ATAANTIQUA / BARBUDA AG ATGARMENIA AM ARMARUBA AW ABWAUSTRIA AT AUTBAHAMAS BS BHSBANGLADESH BD BGDBARBADOS BB BRBBELARUS BY BLRBEL
28、IZE BZ BLZBENIN BJ BENBRUNI DARUSSALAM BN BRNBURUNDI BI BDICAPE VERDE CV CPVCAYMAN ISLANDS KY CYMCENTRAL AFRICAN REPUBLIC CF CAFCHAD TD TCDCHILE CL CHLCHINA CN CHNCOMOROS KM COMCONGO CG COGCOOK ISLANDS CK COKCZECH REPUBLIC CS CZEDENMARK DK DNKEL SALVADOR SV SLVESTONIA EE ESTEQUITORIAL GUINEA GQ GNQF
29、AROE ISLANDS FO FROFAULKLAND ISLANDS FK FLKFRENCH GUIANA GF GUFFRENCH POLYNESIA PF PYFGERMANY DE DEUGREENLAND GL GRLGRENADA GD GRDGUADELOUPE GP GLPGUINEA GN GINGUINEA-BISSAU GY GNBGUYANA GY GUYIRAQ IQ IRQIRELAND IE IRLISREAL IL ISRJAMACIA JM JAMKAZAKHSTAN KZ KAZKOREA DEMOCRATIC REPUBLIC KP PRKKOREA
30、REPUBLIC KR KORLIBERIA LR LBRLIBIA LY LBYMACAU MO MACMADIGASCAR MG MDGMALDIVES MV MDVMALTA MT MLTMARTINIQUE MQ MTQMICRONESIA FM FSMMEXICO MX MEXMOLDAVIA MD MOAMOZAMBIQUE MZ MOZNIUE NU NIUNORTHERN MARIANA ISLAND MP MNPPAKISTAN PK PAKPALAU PW PLWPAPUA NEW GUINEA PG PNGPARAGUAY PY PRYPOLAND PL POLPORTU
31、GAL PT PRTSENEGAL SN SENSLOVAK REPUBLIC SK SVKSLOVINIA SI SVNSOLOMON ISLANDS SB SLBST. PIERRE AND MIQUELON PM SPMSURINAM SR SURSWAZILZND SZ SWZSWEDEN SE SWESYCHELLES SC SYCTUNISIA TN TUNTURKMENISTAN TM TKMTURKEY TR TURTUVALU TV TUVUKRAINE UA UKRUNITED ARAB EMIRATES AE AREUNITED STATES US USAURUGUAY
32、UY URYWALLIS/FORTUNA ISLANDS WF WLFDEMOCRATIC YEMEN YD YMDZAIRE ZR ZARCANADA CA CANTHAILAND TH THA附录 2 美国州名两字码州名 二字代码Alabama ALAlaska AKArizona AZArkansas ARCalifornia CAColorado COConnecticut CTDelaware DEFlorida FLGeorgia GAHawaii HIIdaho IDIllinois ILIndiana INIowa IAKansas KSKentucky KYLouisiana
33、 LAMaine MEMaryland MDMassachusetts MAMichigan MIMinnesota MNMississippi MSMissouri MOMontana MTNebraska NENevada NVNew Hampshire NHNew Jersey NJNew Mexico NMNew York NYNorth Carolina NCNorth Dakota NDOhio OHOklahoma OKOregon ORPennsylvania PARhode Island RISouth Carolina SCSouth Dakota SDTennessee TNTexas TXUtah UTVermont VTVirginia VAWashington WAWest Virginia WVWisconsin WIWyoming WY
