API用户手册

用户手册第一章前言1.1背景：当前采用的APIS基于USEDIFACT，不能包含所有的UNEDIFACT要求的数据元素，因而美国、加拿大要求航空公司于近日采用基于UNEDIFACT标准的PAXLST。和目前的API信息相比，美国PAXLST增加的信息有：居住国、美国地址（美国公民或持美国居住卡的除外）、护照到期日期，加拿大PAXLST增加的信息：居住国、护照到期日期。PAXLST通常都只要求一种有效证件信息，最多不超过两种，首选护照信息，每个旅客包括婴儿都必须持有至少一种有效证件。1.2现状：当前订座系统的有SSRPSPT内容，不包括DOCS、DOCO、DOCA，不能提供美国/加拿大PAXLST所需增加的信息。1.3需求：1.增加三种SSRTYPE：DOCS、DOCO、DOCA2.允许用户通过DPS方式以及手工输入SSR指令方式输入PAXLST信息3.接收处理TYPE-A、TYPE-B的SSRDOCS/DOCO/DOCA报文4.对国航飞美国/加拿大的航班进行出票限制，必须满足：a)飞往美国的航班，出票之前PNR中必须输入SSRDOCS项以及SSRDOCAR/（居住地址）和SSRDOCAD/（目的地地址）三项内容；b)美国出港的航班以及飞往加拿大的航班，出票之前PNR中必须输入SSRDOCS信息。第二章指令说明2.1DPS输入2.1.1指令功能DAPI是为了方便用户向PNR中添加API信息（即SSRDOCS，DOCO，和DOCA）而设计的。它会自动将当前PNR中的相关信息如姓名项等显示在DPS屏幕上，用户可以通过填写DPS中相关项中的内容来完成API信息的添加。目前DAPI指令不提供回显功能，建议用户使用手工方式进行修改。2.1.2指令格式输入格式：1234DAPI:Pn,In域字符可选描述1.DAPI:否指令名称2.P1-3n否P旅客标识3.,I1n是I婴儿标识DPS屏幕：更新DPS屏幕中的内容，可以自动构造当前PNR中的SSR(DOCS，DOCO，和DOCA)项。123456789012345678901234567890123456789012345678901234567890123456789012345678901UAPI:Pn,In***AllDatesinDDMMMYYFormat***2SSRDOCS–PRIMARYTRAVELDOCUMENTINFORMATION3Surname:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaGender(M/F/U):aInfant(Y/N):a姓性别是否是婴儿4FirstName:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaDateofBirth:DDMMMYY名出生日期5MiddleName:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaNationality:aaa中间名国籍6DocumentType:aaDocumentNumber:xxxxxxxxxxxxxxxIssuingCountry/State:aaa证件类型证件号码证件签发国家或地区7ExpiryDate:DDMMMYYMulti-PassengerPrimaryPassportHolder(Y/N):a有效期限否证件持有者89SSRDOCO–OTHERTRAVELRELATEDINFORMATION10PlaceofBirth:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa出生地11DocumentType:aDocumentNumber:xxxxxxxxxxxxxxx类型（目前只有VISA,V）VISA卡号12PlaceofIssue:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaIssueDate:DDMMMYYVISA卡签发地签发日期13Country/Stateapplies:aaaVISA卡使用有效国家或地区代码1415SSRDOCA–ADDRESSINFORMATION16ResidenceAddress:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx居住详细地址17City:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaPostalCode:xxxxxxxxxxxxxxxxx居住城市邮编18State/Province/CountrySub:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxCountry:aaa所在省市（州）信息居住国19DestinationAddress:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx目的地详细地址20City:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaPostalCode:xxxxxxxxxxxxxxxxx目的地城市邮编21State/Province/CountrySub:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxCountry:aaa目的地所在省市（州）信息目的地国家代码2223TRANSMITFROMHERE_F3-CANCELF4-REFRESH在此确定所作更新F3键取消修改F4键刷新24第1行UAPI:指令输入行。这行是不可以修改的。1235-UAPI:Pn,In***AllDatesinDDMMMYYFormat***域字符可选描述1.UAPI:保护指令名称2.P1-3n保护P旅客标识3.,I1n保护I婴儿标识4.保护所有日期均按DDMMMYY这种格式第2行1SSRDOCS–PRIMARYTRAVELDOCUMENTINFORMATION域字符可选描述1.保护SSRDOCS–首要信息第3行123Surname:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaGender(M/F/U):aInfant(Y/N):a域字符可选描述1.保护姓:1-30a否姓会自动按用户指定的旅客序号从当前的PNR中获得。如果PNR中的姓名与证件姓名不同，需以证件姓名为准。2.保护性别(M/F/U):1a否合法的性别：M男F女Uunspecified3.保护婴儿(Y/N):1a否标识该名旅客是否是婴儿。合法的输入：Y该名旅客是婴儿N该名旅客不是婴儿;缺省第4行12FirstName:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaDateofBirth:DDMMMYY域字符可选描述1.保护名:1-30a否名会自动按用户制定的旅客序号从当前的PNR中获得。如果PNR中的姓名与证件姓名不同，需以证件姓名为准。2.保护出生日期:DDYYYMM否出生日期第5行12MiddleName:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaNationality:xxx域字符可选描述1.保护中间名:1-30a是中间名2.保护国籍:1-3a否国家代码第6行123DocumentType:aaDocumentNumber:xxxxxxxxxxxxxxxIssuingCountry/State:aaa域字符可选描述1保护证件类型:1-2a否合法的证件类型:FApprovednon-standardidentitydocumentfortravel(definedbyissuingCountry/State)ACCrewMemberCertificateAIdentityCard(definedbyissuingCountry/State)CIdentityCard(definedbyissuingCountry/State)IIdentityCard(definedbyissuingCountry/State)IPPassportCardPPassengerPassport2.保护证件号码:1-15x否证件号码。3.保护签发国家:1-3a否签发国家。第7行12ExpiryDate:YYMMDDPrimaryPassportHolder(Y/N):a域字符可选描述1.保护过期日:YYMMDD否证件过期日2.保护多人护照的主持有者(Y/N):1aM标识，合法的输入有：Y为主持有者N非主持有者(如婴儿)第8行空行第9行1SSRDOCO–OTHERTRAVELRELATEDINFORMATION域字符可选描述1.保护SSRDOCO–其它旅行相关信息第10行1PlaceofBirth:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa域字符可选描述1.保护出生地:1-35a是出生地址第11行12DocumentType:aDocumentNumber:xxxxxxxxxxxxxxx域字符可选描述1.保护证件类型1a条件证件类型V如果为VISA信息的话，必须输入V2.保护证件号码:1-15x条件证件号码。如果为VISA的话，此项为必输项.第12行12PlaceofIssue:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaIssueDate:DDMMMYY1.保护签发地:1-35a选择签发地.如果为VISA的话，此项为必输项。2.保护签发日期:DDMMMYY选择签发日期.如果为VISA的话，此项为必输项.第13行1Country/Stateapplies:aaa域字符可选描述1.保护适用国:1-3a选择适用国.如果为VISA的话，此项为必输项.第14行空行第15行1SSRDOCA–ADDRESSINFORMATION域字符可选描述1.保护SSRDOCA–地址信息第16行1ResidenceAddress:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx域字符可选描述1.保护居住地址：1-35x是居住街道的详细信息第17行12City:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaPostalCode:xxxxxxxxxxxxxxxxx域字符可选描述1.保护城市:1-35a否居住城市2.保护邮编1-17x是居住地的邮政编码第18行12State/Province/CountrySub:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaCountry:aaa域字符可选描述1.保护州/省/市/县:1-35a是居住地所在州/省/市/县.2.保护国家1-3a否居住地的国家代码.第19行1DestinationAddress:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx域字符可选描述1.保护目的地1-35x是目的地街道详细地址第20行12City:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaPostalCode:xxxxxxxxxxxxxxxxx域字符可选描述1.保护城市:1-35aM目的地城市2.保护邮编:1-17x是邮政编码.第21行12State/Province/CountrySub:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaCountry:aaa域字符可选描述1.保护州/省/市/县:1-35a是目的地所在州/省/市/县.2.保护国家1-3a否目的地的国家代码.第22行空行第23行12TRANSMITFROMHERE_F3-CANCELF4-REFRESH域字符可选描述1.[b]保护条件在此处回车确认域.将光标移至此处后，回车将确认修改。2.保护F3–取消F4–刷新标准的DPS屏幕功能键.第24行空行2.1.3实例:旅客张大龙带着一名婴儿张小龙，持例如下护照旅行。旅客居住地址：中国北京东四西大街100号，邮编100027，带着一名婴儿。前往佐治亚州GEORGIA（GA）的亚特兰大ATLANDA（ATL）的No.17,STREET2：照片PCHN143810297姓名Nameinfull张大龙ZHANGDALONG性别Sex男M身份Profession企业管理人员MANAGER婚姻状况Maritalstatus未婚SING