T∕CATAGS 38-2022 民航旅游产品动态打包查询预订数据规范

ICS35.240.60V07T/CATAGS中国航空运输协会团体标准T/CATAGS38—2022民航旅游产品动态打包查询预订数据规范Specificationfordynamicpackaginginquiryandreservationofcivilaviation2022–02-25发布2022-02-25实施中国航空运输协会发布T/CATAGS38—2022I目次前言................................................................................II1范围..............................................................................12规范性引用文件....................................................................13术语和定义........................................................................14说明..............................................................................15DynamicPkgAvailRQ.................................................................16DynamicPkgAvailRS...............................................................2837DynamicPkgBookRQ................................................................3068DynamicPkgBookRS................................................................307附录A（资料性）代码列表............................................................309附录B（资料性）示例................................................................359T/CATAGS38—2022II前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国航空运输协会提出并归口。本文件起草单位：中国民航信息网络股份有限公司、中国民航大学。本文件起草人员：周中雨、张强、王映彤、李建伏、田丰、徐正生、姚一、赵荣霞、李洋、林乐健、贺怀清。T/CATAGS38—20221民航旅游产品动态打包查询预订数据规范1范围本文件规定了国内航空公司作为旅游产品动态打包的服务提供商时，进行动态打包查询与预订采用的数据规范。本文件适用于使用信息系统销售国内航空公司提供的多旅游产品动态打包时，与国内航空公司之间的数据交换。2规范性引用文件本文件没有规范性引用文件。3术语和定义本文件没有需要界定的术语和定义。4说明本文件正文部分给出了查询接口请求(DynamicPkgAvailRQ)、查询接口响应(DynamicPkgAvailRS)、预订接口请求(DynamicPkgBookRQ)和预订接口响应(DynamicPkgBookRS)中包含的数据元素及其结构化描述，附录A给出了本文定义的接口中使用的代码列表，附录B给出了接口实现示例。数据元素根据其结构特点被表示为属性、简单元素和复合元素。复合元素的结构较为复杂，其中至少包括一个子元素为元素或属性；简单元素指仅包含文本、而不包含其他元素或属性的元素。1至图386是元素结构示意图。虚线矩形框表示该元素不是必选的，实线矩形框表示该元素是必选的。矩形框右边的加号表示框内的元素是复合元素。矩形框下面的a..b表示该元素最少出现a次，最多出现b次。5DynamicPkgAvailRQ5.1DynamicPkgAvailRQ元素结构查询动态打包预订中各部分的可用性，即关于机票、酒店、租车和其他相关旅游产品的可用性。其中包含12个属性和4个复合元素，如图1所示，具体如下：——EchoToken：属性，附加标识符，用于标识消息；——TimeStamp：属性，时间戳，参加ISO8601规定的时间日期格式，表示报文产生的日期和时间；——Target：属性，标识目标系统是测试或生产系统；——TargetName：属性，目标系统名称；——Version：属性，报文版本号；——TransactionIdentifier：属性，事务内报文的唯一标记；T/CATAGS38—20222——SequenceNmbr：属性，报文序号；——TransactionStatusCode：属性，事务状态代码；——RetransmissionIndicator：属性，重发标识；——CorrelationID：属性，关联ID；——PrimaryLangID：属性，首选语种代码，见ISO693-3规定的语种代码；——AltLangID：属性，备选语种代码，见ISO639-3规定的语种代码；——POS：复合元素，标识发出请求的一方或连接渠道，其元素结构见5.2；——SearchCriteria：复合元素，查询条件，包含如下6个复合元素：PromotionCodes：促销代码集合，其元素结构见5.3；AirSearch：航空产品查询条件，其元素结构见5.4；HotelSearch：酒店产品查询条件，其元素结构见5.5；PackageOptionSearch：其他打包产品查询条件，其元素结构见5.6；CarSearch：租车查询条件，其元素结构见5.7；MultimodalOffer：多模态报价，其元素结构同5.7.3的MultimodalOffer。——DynamicPackage：复合元素，包括客户信息和本打包产品的已预订部分。其中包括2个属性和3个复合元素：DynamicPkgAction：属性，对打包产品或组件进行的操作；DynamicPkgStatus：属性，动态打包产品或组件状态；Components：复合元素，动态打包组件，其元素结构见5.8；ResGuests：复合元素，预订旅客信息集合，包括1个复合元素ResGuest，表示一条预订旅客信息，其元素结构见5.9；GlobalInfo：复合元素，打包产品的全局信息，其元素结构见5.10。——InclusionSets：复合元素，打包产品包含项目集合，包括1个复合元素InclusionSet，其元素结构见5.10.3。5.2POS5.2.1POS元素结构包含1个复合元素Source，请求者信息。Source中包含10个属性和4个复合元素，如图2所示，具体如下：——AgentSine：属性，代理商实体；——PseudoCityCode：属性，城市代码；——ISOCountry：属性，国家代码，见ISO3166-3规定的国家代码；——ISOCurrency：属性，货币代码，见ISO4217-3规定的货币代码；——AgentDutyCode：属性，请求方代码；——AirlineVendorID：属性，航空公司代码，见IATA(InternationalAirTransportAssociation，国际航空运输协会)航空公司代码；——AirportCode：属性，机场代码，见IATA机场代码；——FirstDepartPoint：属性，旅程第一个出发地；——ERSP_UserID：属性，ERSP(ElectronicReservationServiceProvider，电子预订服务系统供应商)用户编号；——TerminalID：属性，电子终端代号；——RequestorID：复合元素，请求方标识，其元素结构见5.2.2；T/CATAGS38—20223——Position：复合元素，位置信息，其元素结构见5.2.3；——BookingChannel：复合元素，预订通道，其元素结构见5.2.4；——TPA_Extensions：复合元素,扩展项。图1DynamicPkgAvailRQ元素结构T/CATAGS38—20224图2POS元素结构5.2.2RequestorID元素结构包括7个属性和2个复合元素，如图3所示，具体如下：——URL：属性，请求方的URL(UniformResourceLocator，统一资源定位符)；——Type：属性，请求方的ID(Identification)类型代码，见OTAMS(OpenTravelAllianceMessageSpecifications，开放旅游联盟消息规范)2017B代码列表的UIT代码；——Instance：属性，实例；——ID：属性，请求方ID值；——ID_Context：属性，ID来源，如IATA等；——MessagePassword：属性，密码；——Name：属性，请求者姓名；——CompanyName：复合元素，公司名称，包括以下7个属性，如图4所示，具体如下：CompanyShortName：公司简称；TravelSector：旅游业分类代码，见OTAMS2017B代码列表的TVS代码；Code：公司代码；CodeContext：代码来源，如DUNS(DataUniversalNumberingSystem,商业实体或组织机构的标识符)、IATA或者公司内部代码；CountryCode：公司总部所在国家代码；Division：分支机构；Department：部门名称或编号。——TPA_Extensions：复合元素，用于扩展元素和属性。T/CATAGS38—20225图3RequestorID元素结构图4CompanyName元素结构5.2.3Position元素结构包括5个属性，如图5所示，具体如下：——Latitude：纬度；——Longitude：经度；——Altitude：高度；——AltitudeUnitOfMeasureCode：高度单位代码，见OTAMS2017B代码列表的UOM代码；——PositionAccuracyCode：定位精度代码，见附录A.1。T/CATAGS38—20226图5Position元素结构5.2.4BookingChannel元素结构包括2个属性和2个复合元素，如图6所示，具体如下：——Type：属性，预订渠道类型代码，见OTAMS2017B代码列表的BCT代码；——Primary：属性，该预订渠道是否为主要预订手段；——CompanyName：复合元素，公司名称，其元素结构同5.2.2的CompanyName；——TPA_Extensions：复合元素，扩展项。图6BookingChannel元素结构5.3PromotionCodes元素结构包含1个复合元素PromotionCode，表示促销代码。PromotionCode包含2个属性，如图7所示，具体如下：——RPH：索引编号；——Code：促销代码。图7PromotionCodes元素结构5.4AirSearch5.4.1AirSearch元素结构包括3个属性和7个复合元素,如图8所示,具体如下：——MaxResponses：属性，最大响应数；T/CATAGS38—20227——SequenceNumber：属性，序列号；——RequestType：属性，搜索类型；——PromotionInfo：复合元素，促销信息；包括1个属性PromotionCodeRPH，促销代码索引编号；——AirItinerary：复