API訂座用戶手冊(cè).doc

API訂座用戶手冊(cè)第一章 前言根據(jù)中國(guó)公安部、民航總局的要求，所有出入中國(guó)的航班都需要于5月1日發(fā)送旅客及機(jī)組人員的API信息。包括：l 旅客姓名l 旅客出生日期l 旅客性別l 旅客國(guó)籍l 證件號(hào)碼l 證件類型l 證件到期日(Passport Expiry Date)l 證件簽發(fā)國(guó)(Country of Issue)為了能按時(shí)、準(zhǔn)確的向中國(guó)政府提供旅客API信息，根據(jù)航空公司的要求在訂座系統(tǒng)中增加銷售限制，即：銷售人員在出票時(shí)必須在訂座系統(tǒng)中輸入中國(guó)政府要求相關(guān)的信息，否則將無(wú)法打印客票（含電子客票）。用戶可以通過(guò)DPS方式以及手工輸入SSR指令方式輸入旅客API信息。第二章將介紹API相關(guān)指令的格式及功能，其中DAPI指令和SSR DOCS指令可以輸入上述八項(xiàng)API信息第三章附上系統(tǒng)中的出票限制第二章 指令說(shuō)明2.1 DPS輸入2.1.1 指令功能DAPI是為了方便用戶向PNR中添加API信息（即SSR DOCS，DOCO，和DOCA）而設(shè)計(jì)的。它會(huì)自動(dòng)將當(dāng)前PNR中的相關(guān)信息如姓名項(xiàng)等顯示在DPS屏幕上，用戶可以通過(guò)填寫(xiě)DPS中相關(guān)項(xiàng)中的內(nèi)容來(lái)完成API信息的添加。目前DAPI指令不提供回顯功能。2.1.2 指令格式 1 2 3 4>DAPI:Pn/Sn,In例1：為PNR中的第二名旅客添加API信息，默認(rèn)航空公司為CA>DAPI:P2例2：為PNR中的第一名旅客按指定航段所屬航空公司添加API信息>DAPI:P1/S3例3：為PNR中的第二名旅客所帶嬰兒添加API信息，默認(rèn)航空公司為CA>DAPI:P2,I1域字符可選描述1DAPI:否指令2P1-3n否P后為旅客序號(hào)3/S1-3n可選/S后接航段在PNR中的序號(hào)4,I1n可選,I后接?jì)雰盒蛱?hào)，目前只支持1一個(gè)嬰兒2.1.3 DPS屏幕更新DPS屏幕中的內(nèi)容，可以自動(dòng)構(gòu)造當(dāng)前PNR中的SSR (DOCS，DOCO，和DOCA)項(xiàng)。UAPI: P1 * All Dates in DDMMMYY Format * 指令行SSR DOCS - PRIMARY TRAVEL DOCUMENT INFORMATION 主要旅行證件Surname:TEST_ Gender(M/F/U):_ Infant(Y/N): N 姓 性別 嬰兒標(biāo)識(shí)First Name:LIN_ Date of Birth:_ 名 出生日期Middle Name:_ Nationality:_ 中間名 國(guó)籍Document Type:_ Document Number:_ Issuing Country/State:_ 證件類型 證件號(hào)碼 簽發(fā)國(guó)Expiry Date:_ Multi-Passenger Primary Passport Holder(Y/N):_ 過(guò)期日 是否為證件的持有者 SSR DOCO - OTHER TRAVEL RELATED INFORMATION 其它旅行證件Place of Birth:_ 出生地Document Type:_ Document Number:_ 證件類型(目前只支持簽證) 證件號(hào)碼Place of Issue:_ Issue Date:_ 簽發(fā)地 簽發(fā)日期Country/State applies:_ 適用國(guó) SSR DOCA - ADDRESS INFORMATION 地址信息 Residence Address:_ All(X):_ 居住地 對(duì)PNR中所有旅客有效 City:_ Postal Code:_ 城市 郵編 State/Province/Country Sub:_ Country:_ 州/省/地區(qū) 國(guó)家Destination Address:_ All(X):_ 目的地 對(duì)PNR中所有旅客有效 City:_ Postal Code:_ 城市 郵編 State/Province/Country Sub:_ Country:_ 州/省/地區(qū) 國(guó)家 TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH 確認(rèn)光標(biāo)處 F3 取消 F4 刷新屏幕表2.1 UAPI指令的DPS各個(gè)域詳細(xì)描述序號(hào)域描述備注1Surname姓姓名會(huì)自動(dòng)按用戶指定的旅客序號(hào)從當(dāng)前PNR中獲得。如果與證件中姓名不一致，則需重新輸入，即以證件中姓名為準(zhǔn)。2Gender性別M 男性 F 女性 U 中性3Infant嬰兒標(biāo)識(shí)Y 該名旅客是嬰兒N 該名旅客不是嬰兒4First Name名姓名會(huì)自動(dòng)按用戶指定的旅客序號(hào)從當(dāng)前PNR中獲得。如果與證件中姓名不一致，則需重新輸入，即以證件中姓名為準(zhǔn)。5Date of Birth出生日期格式為DDMMMYY6Middle Name中間名為可選項(xiàng)7Nationality國(guó)籍ISO國(guó)家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證件號(hào)碼只接受數(shù)字和字母類的字符10Issuing Country/State簽發(fā)國(guó)ISO國(guó)家2字或3字代碼11Expiry Date過(guò)期日格式為DDMMMYY12Multi-Passenger Primary Passport Holder(Y/N)是否為證件的持有者Y 該名旅客為證件的持有者N 該名旅客非證件的持有者13Place of Birth出生地只接受字母類的字符14Document Type證件類型目前只支持V 即簽證15Document Number證件號(hào)碼只接受數(shù)字和字母類的字符16Place of Issue簽發(fā)地只接受字母類的字符17Issue Date簽發(fā)日期格式為DDMMMYY18Country/State applies適用國(guó)ISO國(guó)家2字或3字代碼19Residence Address居住地居住地街道的詳細(xì)信息20All(X) 對(duì)PNR中所有旅客有效表示對(duì)PNR中所有旅客有效，反映到pnr中則為不帶psgr-id，并且HK后數(shù)值為PNR總?cè)藬?shù)21City城市居住城市22Postal Code郵編居住地的郵政編碼23State/Province/Country Sub州/省/地區(qū)如果居住國(guó)為美國(guó)，此處必須輸入州名的2字代碼24Country國(guó)家ISO國(guó)家2字或3字代碼25Destination Address目的地目的地街道的詳細(xì)信息All(X):表示對(duì)PNR中所有旅客有效，反映到pnr中則為不帶psgr-id，并且HK后數(shù)值為PNR總?cè)藬?shù)26All(X) 對(duì)PNR中所有旅客有效表示對(duì)PNR中所有旅客有效，反映到pnr中則為不帶psgr-id，并且HK后數(shù)值為PNR總?cè)藬?shù)27City城市目的城市28Postal Code郵編目的地的郵政編碼29State/Province/Country Sub州/省/地區(qū)如果目的國(guó)為美國(guó)，此處必須輸入州名的2字代碼30Country國(guó)家ISO國(guó)家2字或3字代碼2.1.3 實(shí)例:旅客張大龍帶著一名嬰兒張小龍，持例如下護(hù)照旅行。旅客居住地址：中國(guó)北京東四西大街100號(hào)，郵編100027，帶著一名嬰兒。前往佐治亞州GEORGIA（GA）的亞特蘭大ATLANDA（ATL）的No. 17, STREET2：照片PCHN143810297姓 名 Name in full 張 大 龍 ZHANG DALONG性 別 Sex 男 M身 份 Profession企 業(yè) 管 理 人 員 MANAGER婚姻狀況 Marital status未 婚SINGLE出生日期 Date of birth1976.04.2424 APR 1967出生地點(diǎn) Place of birth北 京BEIJING有效期至 Date of expiry 2012.04.23身份證號(hào)碼 Identity card No. 110108670424373POCHNZHANG<<DALONG<<<<<<<<<<<<<<<<<<<<<<<<<<1438102979CHN6704241M020423319201100<<<<<<06訂一個(gè)如下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.OSI YY 1INF ZHANG/XIAOLONG/P1 8.RMK CA/E1EJM 9.RMK 1G/RVMLQY 10.XN/IN/ZHANG/XIAOLONG(APR05)/P1 11.PEK099如果需要向CA提供成人的API信息，可輸入>DAPI:P1（系統(tǒng)默認(rèn)航空公司為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 按上例填寫(xiě)完相應(yīng)內(nèi)容后，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 再次輸入嬰兒相關(guān)信息，可輸入>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 按上例填寫(xiě)完相應(yīng)內(nèi)容后，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 按上例填寫(xiě)完相應(yīng)內(nèi)容后，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部分錯(cuò)誤提示TRANSMIT FROM APPROPRIATE PLACE在確認(rèn)域出回車FUNCTION KEY INVALID, ONLY FUNCTION F3 AND F4 ARE VALID功能鍵錯(cuò)誤，請(qǐng)使用F3或F4鍵GENGER性別輸入錯(cuò)誤，合法的性別為：F-女性M-男性 U-不確定NATIONALITY請(qǐng)校驗(yàn)國(guó)家代碼的正確性DOCUMENT TYPE證件類型錯(cuò)誤，DOCS合法的證件類型為：F,A,C,AC,P,IP,I；DOCO合法的證件類型為：VDOCUMENT NUMBER證件號(hào)碼不合法DOCS IS REQUIRED FOR DOCO請(qǐng)?jiān)谔顚?xiě)DOCO信息前，先填寫(xiě)DOCS信息CHECK INFANT請(qǐng)檢查指定旅客是否帶有嬰兒USA STATE CODE ERROR美國(guó)州的兩字代碼錯(cuò)誤ADDRESS TYPE:'R' FOR RESIDENCE;'D' FOR DESTINATION地址類型錯(cuò)誤，R指居住地；D指目的地DUP ID目前指定旅客已存在相應(yīng)的DOC信息EXIST INVALIDATE CHARACTER 存在不可接受的字符2.2 SSR 指令輸入2.2.1 指令功能SSR DOCS：輸入旅客的護(hù)照等證件信息SSR DOCA：輸入旅客的居住地以及目的地地址信息SSR DOCO：輸入旅客的其他相關(guān)信息，如簽證信息等2.2.2 SSR DOCS/DOCO/DOCA指令輸入格式：所有輸入，如果有缺失的可選項(xiàng)，必須輸入“/”表示該項(xiàng)缺失，如果該缺省項(xiàng)位于輸入的最后，這時(shí)不需要補(bǔ)“/”。以下分別對(duì)DOCS/DOCO/DOCA的格式進(jìn)行說(shuō)明：有下劃線的部分為必輸項(xiàng)，其余為可選項(xiàng)。注：本格式說(shuō)明參照AIRIMP制定，具體的必輸或選輸項(xiàng)請(qǐng)參照相關(guān)標(biāo)準(zhǔn)及離港要求。2.2.2.1 DOCS1. 指令格式：SSR DOCS 航空公司代碼 Action-Code 1 證件類型/發(fā)證國(guó)家/證件號(hào)碼/國(guó)籍/出生日期/性別/證件有效期限/SURNAME(姓)/FIRST-NAME(名)/MID-NAME(中間名)/持有人標(biāo)識(shí)H/P12. 說(shuō)明：類型說(shuō)明exampleSSR3A指令標(biāo)識(shí)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證件簽發(fā)國(guó)1-3A證件簽發(fā)的國(guó)家或地區(qū)代碼USA證件號(hào)碼1-15AN證件的號(hào)碼P12345678國(guó)籍1-3A旅客的國(guó)籍，代碼USA出生日期7ANDDMMMYY格式10MAY79性別 1-2AF - Female女M - Male男 FI - Female Infant 嬰兒，女MI - Male Infant 嬰兒，男U - Undisclosed Gender 未知說(shuō)明：必須先有XN:輸入嬰兒信息之后才能輸入FI/MIM證件到期日7ANDDMMMYY格式10MAY10Surname1-30A姓，需要與護(hù)照上的一致，（有掃描區(qū)的以掃描區(qū)為準(zhǔn)）STEVENSONFirst given name1-30A名字，需要與護(hù)照上的一致，（有掃描區(qū)的以掃描區(qū)為準(zhǔn)）JOHNSecond given name1-30A需要與護(hù)照上的一致，（有掃描區(qū)的以掃描區(qū)為準(zhǔn)），可選（如果沒(méi)有，不填）RICHARDH1AMuti-passenger passport, 護(hù)照持有者標(biāo)識(shí)，可選HPSGR-IDPn旅客標(biāo)識(shí)，用P1,P2等表示。說(shuō)明：對(duì)單人PNR，可以不輸入PSGR-ID，系統(tǒng)會(huì)自動(dòng)為其添加/P1如果是多人PNR，必須輸入PSGR-ID，并且一名旅客只能對(duì)應(yīng)一個(gè)DOCS，一個(gè)SSR DOCS element也只能對(duì)應(yīng)一個(gè)PSGR-ID。P13. 實(shí)例：例1、旅客張大龍，護(hù)照： 照片PCHN143810297姓 名 Name in full 張 大 龍 ZHANG DALONG性 別 Sex 男 M身 份 Profession企 業(yè) 管 理 人 員 MANAGER婚姻狀況 Marital status未 婚SINGLE出生日期 Date of birth1976.04.2424 APR 1967出生地點(diǎn) Place of birth北 京BEIJING有效期至 Date of expiry 2002.04.23身份證號(hào)碼 Identity card No. 110108670424373POCHNZHANG<<DALONG<<<<<<<<<<<<<<<<<<<<<<<<<<1438102979CHN6704241M020423319201100<<<<<<06DOCS輸入：SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/ZHANG/DALONG/P1說(shuō)明：證件類型：P 護(hù)照簽發(fā)國(guó)：CHN 護(hù)照號(hào)：143810297 國(guó)籍：CHN出生日期：24APR67 性別：M 證件有效期：23APR02姓： ZHANG 名：DALONG注：如果出現(xiàn)掃描區(qū)的信息與護(hù)照上其他信息沖突的時(shí)候一定以掃描區(qū)內(nèi)容為準(zhǔn)。例2、旅客張大龍帶著一名兒童張小龍和一名嬰兒張強(qiáng)，持例一中的護(hù)照旅行：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說(shuō)明：1) 張大龍：護(hù)照持有者（輸入H）證件類型：P 護(hù)照簽發(fā)國(guó)：CHN 護(hù)照號(hào)：143810297 國(guó)籍：CHN出生日期：24APR67 性別：M 證件有效期：