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

ICS35.240.60L70T/CATAGS中国航空运输协会团体标准T/CATAGS51—2022航空器载运机组人员API数据传输规范SpecificationforcrewAdvancePassengerInformationprofileexchange2022-04-22发布2022-04-22实施中国航空运输协会发布学兔兔—2022I目次前言...............................................................................III1范围..............................................................................12规范性引用文件....................................................................13术语和定义........................................................................13.1机组..........................................................................13.2政府安全校验..................................................................14缩略语............................................................................15航空器载运机组人员API数据传输内容................................................25.1基础信息......................................................................25.2航空器载运人员API数据........................................................26航空器载运机组人员API数据结构化描述..............................................26.1说明..........................................................................26.2航空器载运机组人员API数据接口................................................27航空器载运机组人员API数据传输接口定义............................................87.1说明..........................................................................87.2传输接口定义..................................................................8附录A（规范性附录）航空器载运机组人员API各元素格式说明...........................11附录B（资料性附录）航空器载运机组人员API数据传输接口示例.........................15学兔兔—2022II前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国航空运输协会提出并归口。本文件起草单位：中国民航信息网络股份有限公司、中国民航大学。本文件主要起草人：胡亚旭、张磊、高思华、许光跃、刘晓、邢统坤、黄彩虹、李伟、朱金富、姜大伟。学兔兔—20221航空器载运机组人员API数据传输规范1范围本文件规定了航空器载运机组人员预检信息交换内容和接口定义。本文件适用于航空公司各系统间航空器载运机组人员预检信息的交换。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。ISO8601日期和时间格式（Dateandtimeformat）ISO3166-1国家代码（COUNTRYCODES）3术语和定义下列术语和定义适用于本文件。3.1机组3.1.1机组（crew）由飞行员、乘务员、空中保卫员和其他持有空勤登机证的人员组成的工作人员。3.2政府安全校验3.2.1政府安全校验（universalboardersecurity）所有通过搭乘航空器出入境的人员需在出入境前申报个人信息，该信息以报文的形式发送至各国指定的系统。4缩略语下列缩略语适用于本文件。API：机组人员预检信息，包括护照信息、签证信息等（AdvancedPassengerInformation）5航空器载运机组人员API数据传输内容5.1基础信息记录与航空器载运机组人员API数据申报相关的渠道、系统标识、时间等基础信息。学兔兔—202225.2航空器载运人员API数据记录航空器载运机组人员API数据及用途，包括：——操作类型；——政府安全校验系统要求的待申报机组人员预检信息资料。6航空器载运机组人员API数据结构化描述6.1说明本节给出了航空器载运机组人员API数据的结构化描述。图1至图13是XML元素结构示意图。虚线矩形框表示该元素或属性不是必选元素或者必选属性；实线矩形框表示该元素的最少出现次数是1次；矩形框左下角的箭头表示这个元素引用另1个元素定义；矩形框右边的加号表示框内的元素是1个复合元素；矩形框下面的1..∞表示最少出现次数是1次，最多出现次数不限；矩形框下面的0..∞表示最少出现次数是0次，最多出现次数不限；矩形框下面只出现1个具体数字表示这个元素最多出现次数和最少出现次数都是这个具体数字。具体字段的定义详见附录A。6.2航空器载运机组人员API数据接口6.2.1航空器载运机组人员API数据根元素（ProfileData）ProfileData（复合元素）是航空器载运机组人员API数据的根元素，包括以下2个顺序出现的子元素：——BaseInfo（复合元素）：包含渠道系统和渠道名称；——Parameter元素（复合元素）：包含操作类型、航班信息和航空器载运机组人员信息。具体元素见图1。图1ProfileData元素结构6.2.2基础信息（BaseInfo）BaseInfo（复合元素）是ProfileData元素的子元素，包括以下2个顺序出现的子元素：——ChannelSystem（简单元素）：渠道系统；——ChannelName（简单元素）：渠道名称。具体元素见图2。图2BaseInfo元素结构学兔兔—202236.2.3数据项（Parameter）6.2.3.1元素结构概述Parameter（复合元素）是ProfileData元素的子元素，包括以下1个属性和2个顺序出现的子元素：——Type属性：操作类型，记录航空器机组人员API数据的用途，包含如下内容：CREATE-增加新的机组人员API数据；UPDATE–修改现有机组人员API数据；DELETE–删除机组人员API数据；RELOAD–使用机组人员API数据覆盖当前航班已有机组人员API数据。——Flight元素（复合元素）：记录航班信息；——Crews元素（复合元素）：记录航空器载运机组人员信息。具体元素见图3。图3Parameter元素结构6.2.3.2航班记录（Flight）Flight（复合元素）是Parameter元素的子元素，包括以下7个顺序出现的子元素：——AirlineID元素（简易元素）：航空公司代码，例如：CA；——FlightNumber元素（简易元素）：航班号，例如：3801；——FlightSuffix元素（简易元素）：航班号后缀，取值范围：A-Z；——FlightDate元素（简易元素）：航班日期,ISO8601格式日期（yyyy-mm-dd）。例如：2021-12-25；——DepartureAirPortCode元素（简易元素）：航班起飞机场三字码，例如：PEK；——ArrivalAirportCode元素（简易元素）：航班到达机场三字码，例如：SHA；——AircraftUnitNumber元素（简易元素）：航班上一组机组人员的编号，例如：123。具体元素见图4。图4Flight元素结构学兔兔—202246.2.3.3机组记录（Crews）Crews（复合元素）是Parameter元素的子元素，包括以下1个子元素：——Crew元素（复合元素）：记录机组人员的信息。具体元素见图5。图5Crews元素结构6.2.4航空器运载机组人员信息（Crew）6.2.4.1元素结构概述Crew（复合元素）是Crews元素的子元素，包括以下10个顺序出现的子元素：——CrewPassengerID元素（简易元素）：机组人员编号；——Name元素（复合元素）：机组人员姓名；——Gender元素（简易元素）：机组人员性别，F–女性，M–男性，U-性别不清；——Birth元素（复合元素）：机组人员出生信息；——Nationality元素（简易元素）：机组人员国籍信息,ISO3166-1标准国家代码。例如：CN；——ResidenceCountry元素（简易元素）：机组人员居住地所在国家，ISO3166-1标准国家代码。例如：CN；——License元素（复合元素）：机组人员执照信息；——Passport元素（复合元素）：机组人员护照信息；——CrewInfo元素（复合元素）：机组人员所在机组信息；——Home元素（复合元素）：机组人员居住地信息；——HealthCode元素（复合元素）：机组人员健康码信息；——Telephone元素（简易元素）：机组人员联系电话。例如：01084018401。具体元素见图6。图6Crew元素结构学兔兔—202256.2.4.2机组人员姓名（Name）Name（复合元素）是Crew元素的子元素，包括以下顺序出现的3个子元素：——LastName元素（简易元素）：机组人员姓，例如：ZHANG；——FirstName元素（简易元素）：机组人员名字，例如：YUHANG；——SecondName元素（简易元素）：机组人员中间名字，例如：keal。具体元素见图7。图7Name元素结构6.2.4.3机组人员出生信息（Birth）Birth（复合元素）是Crew元素的子元素，包括以下顺序出现的3个子元素：——BirthDay元素（简易元素）：机组人员出生日期，ISO8601格式日期（yyyy-mm-dd）。例如：1988-02-15；——BirthCountry元素（简易元素）：机组人员出生国家，ISO3166-1标准国家代码。例如：CN；——BirthCity元素（简易元素）：机组人员出生城市，例如：TANGSHAN。具体元素见图8。图8Birth元素结构6.2.4.4机组人员执照信息（License）License（复合元素）是Crew元素的子元素，包括以下2个顺序出现的子元素：——LicenseIssue