TCATAGS 51-2022 航空器载运机组人员API数据传输规范

1、 ICS 35.240.60T/CATAGSL 70中国航空运输协会团体标准T/CATAGS 512022航空器载运机组人员API数据传输规范Specification for crew Advance Passenger Information profile exchange2022- 04-22发布2022-04-22实施 T/CATAGS 512022目次前言 . III123范围 . 1规范性引用文件 . 1术语和定义 . 13.1机组 . 1政府安全校验 . 13.245缩略语 . 1航空器载运机组人员API数据传输内容 . 25.1基础信息 . 2航空器载运人员API数据 . 2

2、5.267航空器载运机组人员API数据结构化描述 . 26.1说明 . 2航空器载运机组人员API数据接口 . 26.2航空器载运机组人员API数据传输接口定义 . 87.1说明 . 8传输接口定义 . 87.2附录A（规范性附录）航空器载运机组人员API各元素格式说明. 11附录B（资料性附录）航空器载运机组人员API数据传输接口示例. 15I T/CATAGS 512022前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。II T/CATAGS 512022航空器载运机组人员API数据传输规范1范围本文件规定了航空器载运机组人员预检信息交换

3、内容和接口定义。本文件适用于航空公司各系统间航空器载运机组人员预检信息的交换。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。ISO 8601日期和时间格式（Date and time format）ISO 3166-1国家代码（COUNTRY CODES）3术语和定义下列术语和定义适用于本文件。3.1机组3.1.1机组（crew）由飞行员、乘务员、空中保卫员和其他持有空勤登机证的人员组成的工作人员。3.2政府安全校验3.2.1政府安全校验（u

4、niversal boarder security）所有通过搭乘航空器出入境的人员需在出入境前申报个人信息，该信息以报文的形式发送至各国指定的系统。4缩略语下列缩略语适用于本文件。API：机组人员预检信息，包括护照信息、签证信息等（Advanced Passenger Information）5航空器载运机组人员API数据传输内容5.1基础信息记录与航空器载运机组人员API数据申报相关的渠道、系统标识、时间等基础信息。1 T/CATAGS 5120225.2航空器载运人员API数据记录航空器载运机组人员API数据及用途，包括：操作类型；政府安全校验系统要求的待申报机组人员预检信息资料。6航空器

5、载运机组人员API数据结构化描述6.1说明本节给出了航空器载运机组人员API数据的结构化描述。图1至图13是XML元素结构示意图。虚线矩形框表示该元素或属性不是必选元素或者必选属性；实线矩形框表示该元素的最少出现次数是1次；矩形框左下角的箭头表示这个元素引用另1个元素定义；矩形框右边的加号表示框内的元素是1个复合元素；矩形框下面的1.表示最少出现次数是1次，最多出现次数不限；矩形框下面的0.表示最少出现次数是0次，最多出现次数不限；矩形框下面只出现1个具体数字表示这个元素最多出现次数和最少出现次数都是这个具体数字。具体字段的定义详见附录A。6.2航空器载运机组人员API数据接口6.2.1航空器

6、载运机组人员API数据根元素（ProfileData）ProfileData（复合元素）是航空器载运机组人员API数据的根元素，包括以下2个顺序出现的子元素：BaseInfo（复合元素）：包含渠道系统和渠道名称；Parameter元素（复合元素）：包含操作类型、航班信息和航空器载运机组人员信息。具体元素见图1。图1 ProfileData元素结构6.2.2基础信息（BaseInfo）BaseInfo（复合元素）是ProfileData元素的子元素，包括以下2个顺序出现的子元素：ChannelSystem（简单元素）：渠道系统；ChannelName（简单元素）：渠道名称。具体元素见图2。图2

7、BaseInfo元素结构2 T/CATAGS 5120226.2.3数据项（Parameter）元素结构概述Parameter（复合元素）是ProfileData元素的子元素，包括以下1个属性和2个顺序出现的子元素：Type属性：操作类型，记录航空器机组人员API数据的用途，包含如下内容：CREATE-增加新的机组人员API数据；UPDATE 修改现有机组人员API数据；DELETE 删除机组人员API数据；RELOAD 使用机组人员API数据覆盖当前航班已有机组人员API数据。Flight元素（复合元素）：记录航班信息；Crews元素（复合元素）：记录航空器载运机组人员信息。具

8、体元素见图3。图3 Parameter元素结构航班记录（Flight）Flight（复合元素）是Parameter元素的子元素，包括以下7个顺序出现的子元素：AirlineID元素（简易元素）：航空公司代码，例如：CA；FlightNumber元素（简易元素）：航班号，例如：3801；FlightSuffix元素（简易元素）：航班号后缀，取值范围：A-Z；FlightDate元素（简易元素）：航班日期,ISO8601格式日期（yyyy-mm-dd）。例如：2021-12-25；DepartureAirPortCode元素（简易元素）：航班起飞机场三字码，例如：PEK；Arriva

9、lAirportCode元素（简易元素）：航班到达机场三字码，例如：SHA；AircraftUnitNumber元素（简易元素）：航班上一组机组人员的编号，例如：123。具体元素见图4。图4 Flight元素结构3 T/CATAGS 512022机组记录（Crews）Crews（复合元素）是Parameter元素的子元素，包括以下1个子元素：Crew元素（复合元素）：记录机组人员的信息。具体元素见图5。图5 Crews元素结构6.2.4航空器运载机组人员信息（Crew）元素结构概述Crew（复合元素）是Crews元素的子元素，包括以下10个顺序出现的子元素：Crew

10、PassengerID元素（简易元素）：机组人员编号；Name元素（复合元素）：机组人员姓名；Gender元素（简易元素）：机组人员性别，F女性，M男性，U-性别不清；Birth元素（复合元素）：机组人员出生信息；Nationality元素（简易元素）：机组人员国籍信息,ISO 3166-1标准国家代码。例如：CN；ResidenceCountry元素（简易元素）：机组人员居住地所在国家，ISO 3166-1标准国家代码。例如：CN；License元素（复合元素）：机组人员执照信息；Passport元素（复合元素）：机组人员护照信息；CrewInfo元素（复合元素）：机组人员所在机组信息；Ho

11、me元素（复合元素）：机组人员居住地信息；HealthCode元素（复合元素）：机组人员健康码信息；Telephone元素（简易元素）：机组人员联系电话。例如：01084018401。具体元素见图6。图6 Crew元素结构4 T/CATAGS 5120机组人员姓名（Name）Name（复合元素）是Crew元素的子元素，包括以下顺序出现的3个子元素：LastName元素（简易元素）：机组人员姓，例如：ZHANG；FirstName元素（简易元素）：机组人员名字，例如：YUHANG；SecondName元素（简易元素）：机组人员中间名字，例如：keal。具体元素见图7。图7 Na

12、me元素结构机组人员出生信息（Birth）Birth（复合元素）是Crew元素的子元素，包括以下顺序出现的3个子元素：BirthDay元素（简易元素）：机组人员出生日期，ISO8601格式日期（yyyy-mm-dd）。例如：1988-02-15；BirthCountry元素（简易元素）：机组人员出生国家，ISO3166-1标准国家代码。例如：CN；BirthCity元素（简易元素）：机组人员出生城市，例如：TANG SHAN。具体元素见图8。图8 Birth元素结构机组人员执照信息（License）License（复合元素）是Crew元素的子元素，包括以下2个顺序出

13、现的子元素：LicenseIssueCountry元素（简易元素）：飞行证件签发国，ISO3166-1标准国家代码。例如：USA；LicenseNumber元素（简易元素）：签发证件号码，例如：1235224。具体元素见图9。图9 License元素结构机组人员护照信息（Passport）Passport（复合元素）是Crew的子元素，包括以下顺序出现的6个子元素：5 T/CATAGS 512022PassportNumber元素（简易元素）：护照号，例如：2124422121；PassportType元素（简易元素）：护照类型，例如：P；PassportExpiryDate元素

14、（简易元素）：护照有效期截止日期，ISO8601格式日期（yyyy-mm-dd）。例如：2019-05-21；PassportIssueCountry元素（简易元素）：护照发布国家，ISO3166-1标准国家代码。例如：USA；PassportIssueDate元素（简易元素）：护照发行日期，ISO 8601格式日期（yyyy-mm-dd）。例如：2018-06-09；IsPassportHolder元素（简易元素）：是否本人持有护照，Y 本人持有， N 非本人持有；具体元素见图10。图10 Passport元素结构机组人员所在机组信息（CrewInfo）CrewInfo（复合元

15、素）是Crew的子元素，包括以下顺序出现的4个子元素：CrewStatus元素（简易元素）：机组属性，包含如下类型：1.当值机组；2.乘务组；3.非当值机组；4.货运不驾驶机组；5.不当值机组；CrewChange元素（简易元素）：机组变更标识，Y-是，N-否；IsInTransitCrew元素（简易元素）：是否是过境机组人员,Y-是，N-否；CrewType元素（简易元素）：机组类型，包含如下类型：X=positionningcrew，C=operatingcrew。具体元素见图11。图11 Preference元素结构机组人员居住地信息（Home）Home（复合元素）是Cre

16、w的子元素，包括以下顺序出现的5个子元素：HomeAddress元素（简易元素）：机组人员家庭地址；6 T/CATAGS 512022HomeCity元素（简易元素）：机组人员家庭所在城市，例如：PEK；HomeZipCode元素（简易元素）：机组人员家庭所在地邮政编号，例如：300300；HomeStateName元素（简易元素）：机组人员家庭所在省，例如：LN；HomeCountry元素（简易元素）：机组人员家庭所在国家，ISO 3166-1标准国家代码。例如：USA。具体元素见图12。图12 Home元素结构机组人员健康码信息（HealthCode）HealthCode（复

17、合元素）是Crew元素的子元素，包括以下顺序出现的6个子元素：ValidResult元素（简易元素）：健康码认证结果；UpdateTime元素（简易元素）：健康码生成时间，ISO8601格式日期（yyyy-mm-dd）。例如：2020-04-25；ValidTime元素（简易元素）：健康码有效截止时间，ISO8601格式日期（yyyy-mm-dd）。例如：2020-04-29。具体元素见图13。图13 HealthCode元素结构7航空器载运机组人员API数据传输接口定义7.1说明本节图14至图18是XML元素结构示意图。虚线矩形框表示该元素或属性不是必选元素或者必选属性；实线矩形框表示该元素

18、的最少出现次数是1次；矩形框左下角的箭头表示这个元素引用另1个元素定义；矩形框右边的加号表示框内的元素是1个复合元素；矩形框下面的1.表示最少出现次数是1次，最多出现次数不限；矩形框下面的0.表示最少出现次数是0次，最多出现次数不限；矩形框下面只出现1个具体数字表示这个元素最多出现次数和最少出现次数都是这个具体数字。具体报文举例详见附录B。7 T/CATAGS 5120227.2传输接口定义说明7.2.1外部接入访问方式基于Http/Https协议；数据标准采用符合行业通行的XML及JSON接口数据。7.2.2载运航空器机组API信息请求接口（CrewAPIRQ）CrewAPIRQ元素（复合元

19、素）是航空器载运机组人员API数据请求接口的根元素，包括以下1个子元素：ProfileData元素（复合元素）：航空器载运机组人员API数据项。具体元素见图14。图14 CrewAPIRQ接口结构7.2.3载运航空器机组API信息正常响应接口（CrewAPIRS）CrewAPIRS元素（复合元素）是航空器载运机组人员API数据正常响应接口的根元素，包括以下5个顺序出现的子元素：Version元素（简易元素）：版本信息；RequestID元素（简易元素）：请求编号；TransactionID元素（简易元素）：交易编码；SessionID元素（简易元素）：会话编号；Success元素（简易元素）：

20、请求是否成功，1-是，0-否；具体元素见图15。图15 CrewAPIRS接口结构7.2.4载运航空器机组API信息异常响应接口（CrewAPIRSException）CrewAPIRSException元素（复合元素）是航空器载运机组人员API数据异常响应接口的根元素，包含以下5个顺序出现的子元素：Version元素（简易元素）：版本信息；RequestID元素（简易元素）：请求编号；TransactionID元素（简易元素）：交易编码；SessionID元素（简易元素）：会话编号；Errors元素（复合元素）：错误信息。具体元素见图16。8 T/CATAGS 512022图16 CrewA

21、PIRSException接口结构错误信息根元素(Errors).1元素结构概述Errors是CrewAPIRS元素（复合元素）的子元素，包括以下1个子元素：Error元素（复合元素）：记录CrewAPIRQ中的错误信息。具体元素见图17。图17 Errors接口结构.2错误信息子元素（Error）Error是Errors元素（复合元素）的子元素，包括以下顺序出现的2个子元素：Code元素（简易元素）：错误号，例如：024-02-02-00007；Value元素（简易元素）：错误详细信息。具体元素见图18。图18 Error接口结构9 T/CATAGS

22、 512022AA附录 A（规范性附录）航空器载运机组人员API各元素格式说明表A.1为ProfileData元素格式说明。表A.1 ProfileData元素格式序号英文名称BaseInfoParameter中文名称基础信息数据项数据类型BaseInfoParameter属性状态12见表A.2见表A.3MM表A.2为BaseInfo元素格式说明。表A.2 BaseInfo元素格式序号英文名称中文名称渠道系统渠道名称数据类型属性状态12ChannelSystemChannelNameStringStringA-Za-z2,3A-Za-z3MM表A.3为Parameter元素格式说明。表A.3

23、Parameter元素格式序号英文名称中文名称操作类型数据类型属性状态1TypeStringCREATE,UDPATE,DELE MTE,RELOAD23FlightCrews航班记录FlightCrews见表A.4见表A.5MM航空器运载机组人员信息表A.4为Flight元素格式说明。表A.4 Flight元素格式序号英文名称中文名称数据类型StringStringStringDate属性状态1234567AirlineID航空公司代码航班号0-9A-Z2,3d3,4MMOMMOOFlightNumberFlightSuffix航班号后缀航班日期A-ZFlightDateYYYY-MM-DD

24、A-Z3A-Z30-91,3DepartureAirPortCodeArrivalAirportCodeAircraftUnitNumber航班起飞机场三字码 String航班到达机场三字码 String航班机组号String10 T/CATAGS 512022表A.5为Crews元素格式说明表A.5 Crews元素格式序号英文名称中文名称数据类型属性状态1Crew机组人员信息Crew见表A.6M表A.6为Crew元素格式说明。表A.6 Crew元素格式序号1英文名称CrewPassengerIDName中文名称数据类型属性状态机组人员编号StringName0-91,16见表A.7MMMM2

25、机组人员姓名3Gender机组人员性别StringBirthStringA-Z1见表A.84Birth机组人员出生信息机组人员国籍信息5NationalityResidenceCountryLicenseA-Z a-z2,3 MA-Z a-z2,3 O6机组人员居住地所在国家 String7机组人员执照信息LicensePassportCrewInfoHome见表A.9见表A.10见表A.11见表A.12见表A.130-9OMMOMM8PassportCrewInfoHome机组人员护照信息9机组人员所在机组信息机组人员居住地信息机组人员健康码信息机组人员联系电话信息101112HealthC

26、odeTelephoneHealthCodeString表A.7为Name元素格式说明。表A.7 Name元素格式说明序号英文名称LastNameFirstNameSecondName中文名称数据类型StringStringString属性状态123机组人员姓sS1,50sS1,50sS1,50MMO机组人员名字机组人员中间名字表A.8为Birth元素格式说明。表A.8 Birth元素格式序号英文名称中文名称数据类型Date属性状态123Birthday机组人员出生日期机组人员出生国家机组人员出生城市YYYY-MM-DD0-9A-Z2,3sSMOOBirthCountryBirthCitySt

27、ringString11 T/CATAGS 512022表A.9为License元素格式说明。表A.9 License元素格式序号英文名称中文名称数据类型String属性状态12LicenseIssueCountryLicenseNumber飞行证件签发国签发证件号码A-Z a-z2,3 OStringsS1,30M表A.10为Passport元素格式说明。表A.10 Passport元素格式序号英文名称中文名称数据类型属性状态123456PassportNumberPassportType护照号StringsSMOMMOM护照类型StringDatesS1,2YYYY-MM-DDA-Z a-

28、z2,3YYYY-MM-DDA-ZPassportExpiryDatePassportIssueCountryPassportIssueDateIsPassportHolder护照有效截止日期护照发布国家护照发行日期是否本人持有护照StringDateString表A.11为CrewInfo元素格式说明表A.11 CrewInfo元素格式序号英文名称中文名称数据类型String属性状态1234CrewStatusCrewChangeIsInTransitCrewCrewType机组状态0-9A-ZA-ZA-ZMOMO机组变更标识String是否为过境机组人员 String机组类型String表

29、A.12为Home元素格式说明。表A.12 Home元素格式序号英文名称中文名称数据类型String属性状态12345HomeAddressHomeCity机组人员家庭地址机组人员家庭所在城市sSOOOOOStringsS3SsHomeZipCodeHomeStateNameHomeCountry机组人员家庭所在地邮政编码 String机组人员家庭所在省StringStringSs2A-Z2,3机组人员家庭所在国家12 T/CATAGS 512022表A.13为HealthCode元素格式说明。表A.13 HealthCode元素说明序号英文名称中文名称数据类型BooleanDate属性状态1

30、23ValidResultUpdateTimeValidTime健康码状态码健康码生成时间健康码有效截止时间sS1,10YYYY-MM-DDYYYY-MM-DDMMODate13 T/CATAGS 512022BB附录 B（资料性附录）航空器载运机组人员API数据传输接口示例表B.1为一个创建航空器载运机组人员API数据请求示例。表B.1创建航空器载运机组人员AIP数据请求示例UpdateCrewAPIRQ: ProfileData: BaseInfo: ChannelName: AAA,ChannelSystem: PE,Parameter: Type: CREATE,Flight: AirlineID: CA,FlightDate: 2020-05-07,FlightSuffix: A,FlightNumber: 3801,DepartureAirportCode: PEK,ArrivalAirportCode: SHA,AircraftUnitNumber: 123,Crews: CrewPassengerID: 2345689,Name:FirstName: jack,LastName: ABC,SecondName: keal,Gender: M,Birth: