API訂座用戶手冊.doc

API訂座用戶手冊第一章 前言根據(jù)中國公安部、民航總局的要求，所有出入中國的航班都需要于5月1日發(fā)送旅客及機(jī)組人員的API信息。包括：l 旅客姓名l 旅客出生日期l 旅客性別l 旅客國籍l 證件號碼l 證件類型l 證件到期日(Passport Expiry Date)l 證件簽發(fā)國(Country of Issue)為了能按時、準(zhǔn)確的向中國政府提供旅客API信息，根據(jù)航空公司的要求在訂座系統(tǒng)中增加銷售限制，即：銷售人員在出票時必須在訂座系統(tǒng)中輸入中國政府要求相關(guān)的信息，否則將無法打印客票（含電子客票）。用戶可以通過DPS方式以及手工輸入SSR指令方式輸入旅客API信息。第二章將介紹API相關(guān)指令的格式及功能，其中DAPI指令和SSR DOCS指令可以輸入上述八項API信息第三章附上系統(tǒng)中的出票限制第二章 指令說明2.1 DPS輸入2.1.1 指令功能DAPI是為了方便用戶向PNR中添加API信息（即SSR DOCS，DOCO，和DOCA）而設(shè)計的。它會自動將當(dāng)前PNR中的相關(guān)信息如姓名項等顯示在DPS屏幕上，用戶可以通過填寫DPS中相關(guān)項中的內(nè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后為旅客序號3/S1-3n可選/S后接航段在PNR中的序號4,I1n可選,I后接嬰兒序號，目前只支持1一個嬰兒2.1.3 DPS屏幕更新DPS屏幕中的內(nèi)容，可以自動構(gòu)造當(dāng)前PNR中的SSR (DOCS，DOCO，和DOCA)項。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)識First Name:LIN_ Date of Birth:_ 名 出生日期Middle Name:_ Nationality:_ 中間名 國籍Document Type:_ Document Number:_ Issuing Country/State:_ 證件類型 證件號碼 簽發(fā)國Expiry Date:_ Multi-Passenger Primary Passport Holder(Y/N):_ 過期日 是否為證件的持有者 SSR DOCO - OTHER TRAVEL RELATED INFORMATION 其它旅行證件Place of Birth:_ 出生地Document Type:_ Document Number:_ 證件類型(目前只支持簽證) 證件號碼Place of Issue:_ Issue Date:_ 簽發(fā)地 簽發(fā)日期Country/State applies:_ 適用國 SSR DOCA - ADDRESS INFORMATION 地址信息 Residence Address:_ All(X):_ 居住地 對PNR中所有旅客有效 City:_ Postal Code:_ 城市 郵編 State/Province/Country Sub:_ Country:_ 州/省/地區(qū) 國家Destination Address:_ All(X):_ 目的地 對PNR中所有旅客有效 City:_ Postal Code:_ 城市 郵編 State/Province/Country Sub:_ Country:_ 州/省/地區(qū) 國家 TRANSMIT FROM HERE_ F3 - CANCEL F4 - REFRESH 確認(rèn)光標(biāo)處 F3 取消 F4 刷新屏幕表2.1 UAPI指令的DPS各個域詳細(xì)描述序號域描述備注1Surname姓姓名會自動按用戶指定的旅客序號從當(dāng)前PNR中獲得。如果與證件中姓名不一致，則需重新輸入，即以證件中姓名為準(zhǔn)。2Gender性別M 男性 F 女性 U 中性3Infant嬰兒標(biāo)識Y 該名旅客是嬰兒N 該名旅客不是嬰兒4First Name名姓名會自動按用戶指定的旅客序號從當(dāng)前PNR中獲得。如果與證件中姓名不一致，則需重新輸入，即以證件中姓名為準(zhǔn)。5Date of Birth出生日期格式為DDMMMYY6Middle Name中間名為可選項7Nationality國籍ISO國家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證件號碼只接受數(shù)字和字母類的字符10Issuing Country/State簽發(fā)國ISO國家2字或3字代碼11Expiry Date過期日格式為DDMMMYY12Multi-Passenger Primary Passport Holder(Y/N)是否為證件的持有者Y 該名旅客為證件的持有者N 該名旅客非證件的持有者13Place of Birth出生地只接受字母類的字符14Document Type證件類型目前只支持V 即簽證15Document Number證件號碼只接受數(shù)字和字母類的字符16Place of Issue簽發(fā)地只接受字母類的字符17Issue Date簽發(fā)日期格式為DDMMMYY18Country/State applies適用國ISO國家2字或3字代碼19Residence Address居住地居住地街道的詳細(xì)信息20All(X) 對PNR中所有旅客有效表示對PNR中所有旅客有效，反映到pnr中則為不帶psgr-id，并且HK后數(shù)值為PNR總?cè)藬?shù)21City城市居住城市22Postal Code郵編居住地的郵政編碼23State/Province/Country Sub州/省/地區(qū)如果居住國為美國，此處必須輸入州名的2字代碼24Country國家ISO國家2字或3字代碼25Destination Address目的地目的地街道的詳細(xì)信息All(X):表示對PNR中所有旅客有效，反映到pnr中則為不帶psgr-id，并且HK后數(shù)值為PNR總?cè)藬?shù)26All(X) 對PNR中所有旅客有效表示對PNR中所有旅客有效，反映到pnr中則為不帶psgr-id，并且HK后數(shù)值為PNR總?cè)藬?shù)27City城市目的城市28Postal Code郵編目的地的郵政編碼29State/Province/Country Sub州/省/地區(qū)如果目的國為美國，此處必須輸入州名的2字代碼30Country國家ISO國家2字或3字代碼2.1.3 實例:旅客張大龍帶著一名嬰兒張小龍，持例如下護(hù)照旅行。旅客居住地址：中國北京東四西大街100號，郵編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身份證號碼 Identity card No. 110108670424373POCHNZHANG<<DALONG<<<<<<<<<<<<<<<<<<<<<<<<<<1438102979CHN6704241M020423319201100<<<<<<06訂一個如下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 按上例填寫完相應(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 按上例填寫完相應(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 按上例填寫完相應(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部分錯誤提示TRANSMIT FROM APPROPRIATE PLACE在確認(rèn)域出回車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目前指定旅客已存在相應(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指令輸入格式：所有輸入，如果有缺失的可選項，必須輸入“/”表示該項缺失，如果該缺省項位于輸入的最后，這時不需要補(bǔ)“/”。以下分別對DOCS/DOCO/DOCA的格式進(jìn)行說明：有下劃線的部分為必輸項，其余為可選項。注：本格式說明參照AIRIMP制定，具體的必輸或選輸項請參照相關(guān)標(biāo)準(zhǔn)及離港要求。2.2.2.1 DOCS1. 指令格式：SSR DOCS 航空公司代碼 Action-Code 1 證件類型/發(fā)證國家/證件號碼/國籍/出生日期/性別/證件有效期限/SURNAME(姓)/FIRST-NAME(名)/MID-NAME(中間名)/持有人標(biāo)識H/P12. 說明：類型說明exampleSSR3A指令標(biāo)識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ā)國1-3A證件簽發(fā)的國家或地區(qū)代碼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姓，需要與護(hù)照上的一致，（有掃描區(qū)的以掃描區(qū)為準(zhǔn)）STEVENSONFirst given name1-30A名字，需要與護(hù)照上的一致，（有掃描區(qū)的以掃描區(qū)為準(zhǔn)）JOHNSecond given name1-30A需要與護(hù)照上的一致，（有掃描區(qū)的以掃描區(qū)為準(zhǔn)），可選（如果沒有，不填）RICHARDH1AMuti-passenger passport, 護(hù)照持有者標(biāo)識，可選HPSGR-IDPn旅客標(biāo)識，用P1,P2等表示。說明：對單人PNR，可以不輸入PSGR-ID，系統(tǒng)會自動為其添加/P1如果是多人PNR，必須輸入PSGR-ID，并且一名旅客只能對應(yīng)一個DOCS，一個SSR DOCS element也只能對應(yīng)一個PSGR-ID。P13. 實例：例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身份證號碼 Identity card No. 110108670424373POCHNZHANG<<DALONG<<<<<<<<<<<<<<<<<<<<<<<<<<1438102979CHN6704241M020423319201100<<<<<<06DOCS輸入：SSR DOCS CA HK1 P/CHN/143810297/CHN/24APR67/M/23APR02/ZHANG/DALONG/P1說明：證件類型：P 護(hù)照簽發(fā)國：CHN 護(hù)照號：143810297 國籍：CHN出生日期：24APR67 性別：M 證件有效期：23APR02姓： ZHANG 名：DALONG注：如果出現(xiàn)掃描區(qū)的信息與護(hù)照上其他信息沖突的時候一定以掃描區(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說明：1) 張大龍：護(hù)照持有者（輸入H）證件類型：P 護(hù)照簽發(fā)國：CHN 護(hù)照號：143810297 國籍：CHN出生日期：24APR67 性別：M 證件有效期：