API用户手册.docx

上传人:b****9 文档编号:25340451 上传时间:2023-06-07 格式:DOCX 页数:21 大小:23.15KB
下载 相关 举报
API用户手册.docx_第1页
第1页 / 共21页
API用户手册.docx_第2页
第2页 / 共21页
API用户手册.docx_第3页
第3页 / 共21页
API用户手册.docx_第4页
第4页 / 共21页
API用户手册.docx_第5页
第5页 / 共21页
点击查看更多>>
下载资源
资源描述

API用户手册.docx

《API用户手册.docx》由会员分享,可在线阅读,更多相关《API用户手册.docx(21页珍藏版)》请在冰豆网上搜索。

API用户手册.docx

API用户手册

API用户手册

第一章前言

1.1背景:

当前采用的APIS基于USEDIFACT,不能包含所有的UNEDIFACT要求的数据元素,因而美国要求航空公司于2005年10月4日采用基于UNEDIFACT标准的PAXLST,加拿大是2005年11月1日。

和目前的API信息相比,美国PAXLST增加的信息有:

居住国、美国地址(美国公民或持美国居住卡的除外)、护照到期日期,加拿大PAXLST增加的信息:

居住国、护照到期日期。

PAXLST通常都只要求一种有效证件信息,最多不超过两种,首选护照信息,每个旅客包括婴儿都必须持有至少一种有效证件。

1.2现状:

当前订座系统的有SSRPSPT内容,不包括DOCS、DOCO、DOCA,不能提供美国/加拿大PAXLST所需增加的信息。

1.3需求:

1.增加三种SSRTYPE:

DOCS、DOCO、DOCA

2.允许用户通过DPS方式以及手工输入SSR指令方式输入PAXLST信息

3.接收处理TYPE-A、TYPE-B的SSRDOCS/DOCO/DOCA报文

4.对国航飞美国/加拿大的航班进行出票限制,必须满足:

a)飞往美国的航班,出票之前PNR中必须输入SSRDOCS项以及SSRDOCAR/(居住地址)和SSRDOCAD/(目的地地址)三项内容;

b)美国出港的航班以及飞往加拿大的航班,出票之前PNR中必须输入SSRDOCS信息。

第二章指令说明

2.1DPS输入

省略

2.2SSR指令输入

2.2.1指令功能

SSRDOCS:

输入旅客的护照等证件信息

SSRDOCA:

输入旅客的居住地以及目的地地址信息

SSRDOCO:

输入旅客的其他相关信息,如VISA卡信息等

2.2.2SSRDOCS/DOCO/DOCA指令输入格式:

所有输入,如果有缺失的可选项,必须输入“/”表示该项缺失,如果该项位于输入的最后,可以不输入“/”,系统会自动将“/”补上。

以下分别对DOCS/DOCO/DOCA的格式进行说明:

有下划线的部分为必输项,其余为可选项。

注:

本格式说明参照AIRIMP制定,具体的必输或选输项请参照相关标准及离港要求。

2.2.2.1DOCS

1.指令格式:

SSRDOCS航空公司代码Action-Code1证件类型/发证国家/证件号码/国籍/出生日期/性别/证件有效期限/SURNAME(姓)/FIRST-NAME(名)/MID-NAME(中间名)/持有人标识H/P1

2.说明:

类型

说明

example

SSR

3A

指令标识

SSR

DOCS

4A

SSRServiceType,用于输入证件信息

DOCS

航空公司代码

2AN或3A

航空公司代码

CA

Action-Code

2A

ActionCode,这里,只能允许输入“HK”这一种ActionCode

HK

1

1n

Numberinparty,只能输1

1

证件类型

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*******

国籍

1-3A

旅客的国籍,代码

USA

出生日期

7AN

DDMMMYY格式

10MAY79

性别

1-2A

F--Female女

M--Male男

FI--FemaleInfant婴儿,女

MI--MaleInfant婴儿,男

U--UndisclosedGender未知

说明:

必须先有XN:

输入婴儿信息之后才能输入FI/MI

M

证件有效期限

7AN

DDMMMYY格式

10MAY10

Surname

1-30A

姓,需要与护照上的一致,(有扫描区的以扫描区为准)

STEVENSON

Firstgivenname

1-30A

名字,需要与护照上的一致,(有扫描区的以扫描区为准)

JOHN

Secondgivenname

1-30A

需要与护照上的一致,(有扫描区的以扫描区为准),可选(如果没有,不填)

RICHARD

H

1A

Muti-passengerpassport,护照持有者标识,可选

H

PSGR-ID

Pn

旅客标识,用P1,P2等表示。

说明:

对单人PNR,可以不输入PSGR-ID,系统会自动为其添加/P1

如果是多人PNR,必须输入PSGR-ID,并且一名旅客只能对应一个DOCS,一个SSRDOCSelement也只能对应一个PSGR-ID。

P1

3.实例:

例1、旅客张大龙,护照:

照片

P

CHN

7

姓名Nameinfull

张大龙

ZHANGDALONG

性别Sex

M

身份Profession

企业管理人员

MANAGER

婚姻状况Maritalstatus

未婚

SINGLE

出生日期Dateofbirth

24APR1967

出生地点Placeofbirth

北京

BEIJING

有效期至Dateofexpiry

身份证号码IdentitycardNo.

POCHNZHANG<

9CHN6704241M020423

DOCS输入:

说明:

出生日期:

24APR67性别:

M证件有效期:

23APR02

姓:

ZHANG名:

DALONG

注:

如果出现扫描区的信息与护照上其他信息冲突的时候一定以扫描区内容为准。

例2、旅客张大龙带着一名儿童张小龙和一名婴儿张强,持例一中的护照旅行:

DOCS输入:

//H/P1

/MI/23APR02/ZHANG/QIANG/P1

SSRDOCSC/P2

说明:

1)张大龙:

护照持有者(输入H)

出生日期:

24APR67性别:

M证件有效期:

23APR02

姓:

ZHANG名:

DALONG

2)张强:

男婴(性别输入MI),护照信息与张大龙的一致,出生日期为2004年12月10日,不占座。

3)张小龙:

护照信息与张大龙的一致,男孩(性别输入M),出生日期为1999年9月20日,占座,P2

2.2.2.2DOCO

目前此项属于可选项。

1.指令格式

SSRDOCO航空公司代码HK1出生地/类型V/VISA卡号码/发卡地区/发卡日期/卡有效国家或地区/婴儿标识I/P1

说明:

类型

说明

example

SSR

3A

指令标识

SSR

DOCO

4A

SSRServiceType,用于输入证件信息

DOCO

航空公司代码

2AN或3A

航空公司代码

CA

Action-Code

2A

ActionCode,这里,只能允许输入“HK”这一种ActionCode

HK

1

1n

Numberinparty,只能输1

1

出生地

1-35A

旅客或机组成员的出生地

AMBERHILLGBR

类型V

1A

TravelDocumentType,目前只有”v”,表示信用卡,如果出现这一项,接下来的卡号,发卡地区,发卡日期,卡有效国家或州等各项都必须输入。

若不输入信用卡信息,直接输入:

SSRDOCOCAHK1Birth-place/p1

SSRDOCOCAHK1Birth-place/I/p1(婴儿)

V

VISA卡号码

1-15AN

信用卡号码

9891404

发卡地区

1-35A

LONDON

发卡日期

7AN

DDMMMYY格式

10MAY04

卡有效国家或地区

1-3A

信用卡有效使用的国家或地区国家或州)的代码

USA

婴儿标识I

1A

婴儿标识,可选,必须先有XN:

输入婴儿信息之后才能输入婴儿标识

I

PSGR-ID

Pn

旅客标识,用P1,P2等表示。

说明:

对单人PNR,可以不输入PSGR-ID,系统会自动为其添加/P1

如果是多人PNR,必须输入PSGR-ID,并且一名旅客只能对应一个DOCO,一个SSRDOCOelement也只能对应一个PSGR-ID。

P1

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

1.指令格式:

SSRDOCA航空公司代码HK1地址类型/国家/详细地址/城市/所在省市(州)信息/邮编/I婴儿标识/P1

注意:

前往美国旅行的旅客,目的地地址(SSRDOCAD/)的所有项必须输全(除了婴儿标识);

所在州必须输两字代码(如TX),请查阅相关代码表。

2.说明:

类型

说明

example

SSR

3A

指令标识

SSR

DOCA

4A

SSRServiceType,用于输入证件信息

DOCA

航空公司代码

2AN或3A

航空公司代码

CA

Action-Code

2A

ActionCode,这里,只能允许输入“HK”这一种ActionCode

HK

1

1n

Numberinparty,只能输1

1

地址类型

1A

DOCA的地址类型:

R–居住的地址标识

D–目的地地址标识

R

国家

1-3A

国家代码

USA

详细地址

1-35AN

详细地址

1600SMITHSTREET

城市

1-35A

所在城市

HOUSTON

所在省市(州)信息

1-35A

所在省市(州)信息

TX

邮编

1-17AN

邮编

77001

婴儿标识I

1A

婴儿标识,可选,必须先有XN:

输入婴儿信息之后才能输入婴儿标识

I

PSGR-ID

Pn

旅客标识,用P1,P2等表示。

说明:

对单人PNR,可以不输入PSGR-ID,系统会自动为其添加/P1;如果是多人PNR,必须输入PSGR-ID;并且对于每一种DOCA地址类别(R/D),一名旅客只能对应一个DOCA,一个SSRDOCAelement也只能对应一个PSGR-ID。

P1

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或D标识/国家/详细地址/城市/所在省市(州)信息/邮编/I婴儿标识/P1

如:

SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/P1

输出:

11.SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON////P1

例4、居住地址项省略所在省市、邮编但有婴儿标识I的输入方法

SSRDOCACAHK1R或D标识/国家/详细地址/城市/所在省市(州)信息/邮编/I婴儿标识/P1

如:

省略邮编

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

错误输入:

SSRDOCACAHK1R/USA/16000SMITHSTREET/HOUSTON/TX/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合法的证件类型为:

V

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/项,否则不允许出票,提示:

PLEASEINPUTSSRDOCS/SSRDOCAELEMENT!

c)旅客必须按要求输入目的地址信息:

SSRDOCAD/

婴儿也必须输入相应的SSRDOCAD/项,否则不允许出票,提示:

PLEASEINPUTSSRDOCS/SSRDOCAELEMENT!

2.美国出港的航班以及加拿大入港的航班,出票之前PNR中必须输入SSRDOCS信息。

旅客必须按要求输入护照或其他证件信息:

SSRDOCS

婴儿也必须输入相应的SSRDOCS项,否则不允许出票,提示:

PLEASEINPUTSSRDOCS/SSRDOCAELEMENT!

【特别提示】对于无扫描区的护照,请务必严格按照护照中内容准确输入,避免给旅客在值机时带来不必要的麻烦,甚至导致航班的延误。

附录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

CHN

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

GY

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

USA

URUGUAY

UY

URY

WALLIS/FORTUNAISLANDS

WF

WLF

DEMOCRATICYEMEN

YD

YMD

ZAIRE

ZR

ZAR

CANADA

CA

CAN

THAILAND

TH

THA

附录2美国州名两字码

州名

二字代码

Alabama

AL

Alaska

AK

Ariz

展开阅读全文
相关资源
猜你喜欢
相关搜索

当前位置:首页 > PPT模板 > 其它模板

copyright@ 2008-2022 冰豆网网站版权所有

经营许可证编号:鄂ICP备2022015515号-1