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-BSSR 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)项。 345678901UAPI: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：照片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: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:_ 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 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/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:_ 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 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