API用户手册Word格式.docx
《API用户手册Word格式.docx》由会员分享，可在线阅读，更多相关《API用户手册Word格式.docx（19页珍藏版）》请在冰豆网上搜索。
证件类型
1-2A
包括：
F—Approvednon-standardidentitydocumentsusedfortravel（asdefinedbytheissuingCountry/State）
AC—CrewMemberCertificate
A,C,I—IdentityCard（asdefinedbytheissuingCountry/State）
IP—PassportCard
P—PassengerPassport
P
发证国家
1-3A
证件签发的国家或地区代码
USA
证件号码
1-15AN
证件的号码
P1*******
国籍
旅客的国籍，代码
出生日期
7AN
DDMMMYY格式
10MAY79
性别
F--Female女
M--Male男
FI--FemaleInfant婴儿，女
MI--MaleInfant婴儿，男
U--UndisclosedGender未知
说明：
必须先有XN:
输入婴儿信息之后才能输入FI/MI
M
证件有效期限
10MAY10
Surname
1-30A
姓，需要与护照上的一致，（有扫描区的以扫描区为准）
STEVENSON
Firstgivenname
名字，需要与护照上的一致，（有扫描区的以扫描区为准）
JOHN
Secondgivenname
需要与护照上的一致，（有扫描区的以扫描区为准），可选（如果没有，不填）
RICHARD
H
1A
Muti-passengerpassport,护照持有者标识，可选
PSGR-ID
Pn
旅客标识，用P1,P2等表示。
对单人PNR，可以不输入PSGR-ID，系统会自动为其添加/P1
如果是多人PNR，必须输入PSGR-ID，并且一名旅客只能对应一个DOCS，一个SSRDOCSelement也只能对应一个PSGR-ID。
P1
3.实例：
例1、旅客张大龙，护照：
照片
CHN
7
姓名Nameinfull
张大龙
ZHANGDALONG
性别Sex
男
M
身份Profession
企业管理人员
MANAGER
婚姻状况Maritalstatus
未婚
SINGLE
出生日期Dateofbirth
24APR1967
出生地点Placeofbirth
北京
BEIJING
有效期至Dateofexpiry
身份证号码IdentitycardNo.
POCHNZHANG<
<
DALONG<
9CHN6704241M020423
DOCS输入：
出生日期：
24APR67性别：
M证件有效期：
23APR02
姓：
ZHANG名：
DALONG
如果出现扫描区的信息与护照上其他信息冲突的时候一定以扫描区内容为准。
例2、旅客张大龙带着一名儿童张小龙和一名婴儿张强，持例一中的护照旅行：
//H/P1
/MI/23APR02/ZHANG/QIANG/P1
SSRDOCSC/P2
1）张大龙：
护照持有者（输入H）
2）张强：
男婴（性别输入MI），护照信息与张大龙的一致，出生日期为2004年12月10日，不占座。
3）张小龙：
护照信息与张大龙的一致，男孩（性别输入M），出生日期为1999年9月20日，占座，P2
2.2.2.2DOCO
目前此项属于可选项。
1.指令格式
SSRDOCO航空公司代码HK1出生地/类型V/VISA卡号码/发卡地区/发卡日期/卡有效国家或地区/婴儿标识I/P1
DOCO
出生地
1-35A
旅客或机组成员的出生地
AMBERHILLGBR
类型V
TravelDocumentType，目前只有”v”，表示信用卡，如果出现这一项，接下来的卡号，发卡地区，发卡日期，卡有效国家或州等各项都必须输入。
若不输入信用卡信息，直接输入：
SSRDOCOCAHK1Birth-place/p1
SSRDOCOCAHK1Birth-place/I/p1（婴儿）
V
VISA卡号码
信用卡号码
9891404
发卡地区
LONDON
发卡日期
7AN
10MAY04
卡有效国家或地区
信用卡有效使用的国家或地区国家或州）的代码
婴儿标识I
婴儿标识，可选，必须先有XN:
输入婴儿信息之后才能输入婴儿标识
I
如果是多人PNR，必须输入PSGR-ID，并且一名旅客只能对应一个DOCO，一个SSRDOCOelement也只能对应一个PSGR-ID。
2.实例：
1）输全：
SSRDOCOCAHK1出生地/类型V/VISA卡号码/发卡地区/发卡日期/卡有效国家或州/婴儿标识I/P1
如：
SSRDOCOCAHK1BIRTHPLACE/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/I/P1
输出：
5.SSRDOCSCAHK1P/USA/PASSPORTNUMBER/USA/10MAY79/M/10MAY10/SURNAME/
/FIRSENAME/MIDNAME/H/P1
2）省略出生的信息
SSRDOCOCAHK1/类型V/VISA卡号码/发卡地区/发卡日期/卡有效国家或州/婴儿标识I/P1
SSRDOCOCAHK1/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/I/P1
5.SSRDOCOCAHK1/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/I/P1
3）省略VISA信息
SSRDOCOCAHK1出生地/婴儿标识I/P1
输入：
SSRDOCOCAHK1BIRTHPLACE/I/P1
5.SSRDOCOCAHK1BIRTHPLACE//////I/P1
SSRDOCOCAHK1BIRTHADDRESS/P1
5.SSRDOCOCAHK1BIRTHADDRESS///////P1
4）省略婴儿标识I
SSRDOCOCAHK1出生地/类型V/VISA卡号码/发卡地区/发卡日期/卡有效国家或州//P1
SSRDOCOCAHK1BIRTHPLACE/V/VISANUMBER/ISSUEPLACE/10MAY04/USA/P1
5.SSRDOCOCAHK1BIRTHPLACE/V/VISANUMBER/ISSUEPLACE/10MAY04/USA//P1
2.2.2.3DOCA
SSRDOCA航空公司代码HK1地址类型/国家/详细地址/城市/所在省市（州）信息/邮编/I婴儿标识/P1
注意：
前往美国旅行的旅客，目的地地址（SSRDOCAD/）的所有项必须输全（除了婴儿标识）;
所在州必须输两字代码（如TX），请查阅相关代码表。
DOCA
地址类型
DOCA的地址类型：
R–居住的地址标识
D–目的地地址标识
R
国家
国家代码
详细地址
1-35AN
1600SMITHSTREET
城市
所在城市
HOUSTON
所在省市（州）信息
TX
邮编
1-17AN
77001
对单人PNR，可以不输入PSGR-ID，系统会自动为其添加/P1；
如果是多人PNR，必须输入PSGR-ID；
并且对于每一种DOCA地址类别（R/D），一名旅客只能对应一个DOCA，一个SSRDOCAelement也只能对应一个PSGR-ID。
3.举例：
SSRDOCACAHK1R或D标识/国家/详细地址/城市/所在省市（州）信息/邮编/I婴儿标识/P1
例1、旅客居住地址：
美国佐治亚州Georgia（GA）亚特兰大Atlanta（ATL），详细地址为：
No.7,STREET1，邮编12345，带着一名婴儿。
前往德克萨斯州TEXAS（TX）的奥斯汀AUSTIN（AUS）的No.17,STREET2。
SSRDOCACAHK1R/USA/No.7,STREET1/ATLANTA/GA/12345/P1
SSRDOCACAHK1R/USA/No.7,STREET1/ATLANTA/GA/12345/I/P1
SSRDOCACAHK1D/USA/No.17,STREET2/AUSTIN/TX/12345/P1
SSRDOCACAHK1D/USA/No.17,STREET2/AUSTIN/TX/12345/I/P1
例2、居住地址项省略详细地址：
SSRDOCACAHK1R或D标识/国家//城市/所在省市（州）信息/邮编/I婴儿标识/P1
SSRDOCACAHK1R/USA//ATLANTA/GA/77001/I/P1
16.SSRDOCACAHK1R/USA//ATLANTA/GA/77001/I/P1
例3、居住地址项省略多处OPTIONAL项（都在输入的最后）
SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/P1
11.SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON////P1
例4、居住地址项省略所在省市、邮编但有婴儿标识I的输入方法
省略邮编
SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/TX//I/P1
需要输入//I，否则，会把“I”当成邮编的自由文本输入
11.SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/TX//I/P1
错误输入：
SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/TX/I/P1
11.SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/TX/I//P1
同样的如果所在省市和邮编都省略，则需要输入///I
SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON///I/P1
11.SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON///I/P1
11.SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/TX/I///P1
此时把“I”当成所在省市的自由文本处理。
2.2.3部分错误提示
GENGER
性别输入错误，合法的性别为：
F-女性M-男性U-不确定
NATIONALITY
请校验国家代码的正确性
DOCUMENTTYPE
证件类型错误，DOCS合法的证件类型为：
F,A,C,AC,P,IP,I；
DOCO合法的证件类型为：
DOCUMENTNUMBER
证件号码不合法
DOCSISREQUIREDFORDOCO
请在填写DOCO信息前，先填写DOCS信息
CHECKINFANT
请检查指定旅客是否带有婴儿
USASTATECODEERROR
美国州的两字代码错误
ADDRESSTYPE:
'
R'
FORRESIDENCE;
D'
FORDESTINATION
地址类型错误，’R’指居住地；
’D’指目的地
DUPID
目前指定旅客已存在相应的DOC信息
第三章出票限制
对美国/加拿大航线的航班进行出票限制，必须满足：
1.美国入港的航班，出票之前PNR中必须输入SSRDOCS项以及SSRDOCAR/（居住地址）和SSRDOCAD/（目的地地址）三项内容；
a）旅客必须按要求输入护照或其他证件信息：
SSRDOCS
婴儿也必须输入相应的SSRDOCS项，否则不允许出票，提示：
PLEASEINPUTSSRDOCS/SSRDOCAELEMENT!
b）旅客必须按要求输入居住地址信息：
SSRDOCAR/
婴儿也必须输入相应的SSRDOCAR/项，否则不允许出票，提示：
c）旅客必须按要求输入目的地址信息：
SSRDOCAD/
婴儿也必须输入相应的SSRDOCAD/项，否则不允许出票，提示：
2.美国出港的航班以及加拿大入港的航班，出票之前PNR中必须输入SSRDOCS信息。
旅客必须按要求输入护照或其他证件信息：
【特别提示】对于无扫描区的护照，请务必严格按照护照中内容准确输入，避免给旅客在值机时带来不必要的麻烦，甚至导致航班的延误。
附录1国家代码列表
国家名称
二字代码
三字代码
ANDORRA
AD
AND
ANGOLA
AO
AGO
ANTARTICA
AQ
ATA
ANTIQUA/BARBUDA
AG
ATG
ARMENIA
AM
ARM
ARUBA
AW
ABW
AUSTRIA
AT
AUT
BAHAMAS
BS
BHS
BANGLADESH
BD
BGD
BARBADOS
BB
BRB
BELARUS
BY
BLR
BELIZE
BZ
BLZ
BENIN
BJ
BEN
BRUNIDARUSSALAM
BN
BRN
BURUNDI
BI
BDI
CAPEVERDE
CV
CPV
CAYMANISLANDS
KY
CYM
CENTRALAFRICANREPUBLIC
CF
CAF
CHAD
TD
TCD
CHILE
CL
CHL
CHINA
CN
COMOROS
KM
COM
CONGO
CG
COG
COOKISLANDS
CK
COK
CZECHREPUBLIC
CS
CZE
DENMARK
DK
DNK
ELSALVADOR
SV
SLV
ESTONIA
EE
EST
EQUITORIALGUINEA
GQ
GNQ
FAROEISLANDS
FO
FRO
FAULKLANDISLANDS
FK
FLK
FRENCHGUIANA
GF
GUF
FRENCHPOLYNESIA
PF
PYF
GERMANY
DE
DEU
GREENLAND
GL
GRL
GRENADA
GD
GRD
GUADELOUPE
GP
GLP
GUINEA
GN
GIN
GUINEA-BISSAU
GY
GNB
GUYANA
GUY
IRAQ
IQ
IRQ
IRELAND
IE
IRL
ISREAL
IL
ISR
JAMACIA
JM
JAM
KAZAKHSTAN
KZ
KAZ
KOREADEMOCRATICREPUBLIC
KP
PRK
KOREAREPUBLIC
KR
KOR
LIBERIA
LR
LBR
LIBIA
LY
LBY
MACAU
MO
MAC
MADIGASCAR
MG
MDG
MALDIVES
MV
MDV
MALTA
MT
MLT
MARTINIQUE
MQ
MTQ
MICRONESIA
FM
FSM
MEXICO
MX
MEX
MOLDAVIA
MD
MOA
MOZAMBIQUE
MZ
MOZ
NIUE
NU
NIU
NORTHERNMARIANAISLAND
MP
MNP
PAKISTAN
PK
PAK
PALAU
PW
PLW
PAPUANEWGUINEA
PG
PNG
PARAGUAY
PY
PRY
POLAND
PL
POL
PORTUGAL
PT
PRT
SENEGAL
SN
SEN
SLOVAKREPUBLIC
SK
SVK
SLOVINIA
SI
SVN
SOLOMONISLANDS
SB
SLB
ST.PIERREANDMIQUELON
PM
SPM
SURINAM
SR
SUR
SWAZILZND
SZ
SWZ
SWEDEN
SE
SWE
SYCHELLES
SC
SYC
TUNISIA
TN
TUN
TURKMENISTAN
TM
TKM
TURKEY
TR
TUR
TUVALU
TV
TUV
UKRAINE
UA
UKR
UNITEDARABEMIRATES
AE
ARE
UNITEDSTATES
US
URUGUAY
UY
URY
WALLIS/FORTUNAISLANDS
WF
WLF
DEMOCRATICYEMEN
YD
YMD
ZAIRE
ZR
ZAR
CANADA
CAN
THAILAND
TH
THA
附录2美国州名两字码
州名
Alabama
AL
Alaska
AK
Ariz
升级会员 