MH/T 0061-2017 民航旅游产品动态打包查询预订数据规范

ICS35.240.60

V07

MH

中华人民共和国民用航空行业标准

MH/T0061—2017

民航旅游产品动态打包查询预订数据规范

Specificationfordynamicpackaginginquiryandreservationofcivilaviation

2017-01-02发布2017-04-01实施

中国民用航空局发布

MH/T0061—2017

目次

1范围................................................................................1

2说明................................................................................1

3查询请求接口(DynamicPkgAvailRQ).....................................................1

4查询响应接口DynamicPkgAvailRS.....................................................295

5预订请求接口(DynamicPkgBookRQ)....................................................320

6预订响应接口(DynamicPkgBookRS)....................................................321

附录A（资料性附录）代码列表.........................................................323

附录B（资料性附录）示例..............................................................374

MH

I

MH/T0061—2017

前言

本标准按照GB/T1.1给出的规则起草。

本标准由中国民用航空局人事科教司提出。

本标准由中国民用航空局航空器适航审定司批准立项。

本标准由中国民航科学技术研究院归口。

本标准起草单位：中国民航大学、中国民航信息网络股份有限公司。

本标准起草人：李建伏、周中雨、贺怀清、林乐健、惠康华、李洋、侯旭升。

II

MH/T0061—2017

民航旅游产品动态打包查询预订数据规范

1范围

本标准规定了国内航空公司作为旅游产品动态打包的服务提供商时，进行动态打包查询与预订采用

的数据规范。

本标准适用于使用信息系统销售国内航空公司提供的多旅游产品动态打包时，与国内航空公司之间

的数据交换。

2说明

本标准正文部分介绍了查询请求接口(DynamicPkgAvailRQ)、查询响应接口(DynamicPkgAvailRS)、

预订请求接口(DynamicPkgBookRQ)和预订响应接口(DynamicPkgBookRS)的数据元素，附录A给出了接口

定义中使用的代码列表，附录B给出了接口实现示例。

数据元素包括属性、简单元素和复合元素。复合元素指包含其他元素的元素；简单元素指仅包含文

本、而不包含其他元素的元素。

图1至图328是元素结构示意图。虚线矩形框表示该元素不是必选的，实线矩形框表示该元素是必选

的。矩形框右边的加号表示框内的元素是复合元素。矩形框下面的a..b表示该元素最少出现a次，最多

出现b次。

3查询请求接口(DynamicPkgAvailRQ)

3.1DynamicPkgAvailRQ元素结构

查询动态打包预订中各部分的可用性，即关于机票、酒店、租车和其他相关旅游产品的可用性。其

中包含12个属性和4个复合元素，如图1所示，具体如下：

——EchoToken：属性，附加标识符，用于标识消息；

——TimeStamp：属性，ISO8601格式的时间戳，表示报文产生的日期和时间；

——Target：属性，标识目标系统是测试或生产系统；

——TargetName：属性，目标系统名称；

——Version：属性，报文版本号；

——TransactionIdentifier：属性，事务内报文的唯一标记；

——SequenceNmbr：属性，报文序号；

——TransactionStatusCode：属性，事务状态代码；

M——RetransmissionIndicator：属性，重发标识；H

——CorrelationID：属性，关联ID；

——PrimaryLangID：属性，ISO693-3定义的首选语种代码ID；

——AltLangID：属性，ISO639-3定义的备选语种代码ID；

——POS：复合元素，标识发出请求的一方或连接渠道，其元素结构见3.2；

——SearchCriteria：复合元素，查询条件，包含如下6个复合元素：

1

MH/T0061—2017

PromotionCodes：促销代码集合，其元素结构见3.3；

AirSearch：航空产品查询条件，其元素结构见3.4；

HotelSearch：酒店产品查询条件，其元素结构见3.5；

PackageOptionSearch：其他打包产品查询条件，其元素结构见3.6；

CarSearch：租车查询条件，其元素结构见3.7；

MultimodalOffer：多模态报价，其元素结构同3.7.3的MultimodalOffer。

——DynamicPackage：复合元素，包括客户信息和本打包套餐的已预订部分。其中包括2个属性和

3个复合元素：

DynamicPkgAction：属性，对打包产品或组件进行的操作；

DynamicPkgStatus：属性，动态打包产品或组件状态；

Components：复合元素，动态打包组件，其元素结构见3.8；

ResGuests：复合元素，预订旅客信息集合，包括1个复合元素ResGuest，表示一条预订

旅客信息，其元素结构见3.9；

GlobalInfo：复合元素，打包产品的全局信息，其元素结构见3.10。

——InclusionSets：复合元素，打包产品包含项目集合，包括1个复合元素InclusionSet，其元

素结构见3.11。

3.2POS

3.2.1POS元素结构

包含1个复合元素Source，请求者信息。Source中包含10个属性和4个复合元素，如图2所示，具体

如下：

——AgentSine：属性，代理商实体；

——PseudoCityCode：属性，城市代码；

——ISOCountry：属性，ISO3166-3定义的国家代码；

——ISOCurrency：属性，ISO4217定义的货币代码；

——AgentDutyCode：属性，请求方代码；

——AirlineVendorID：属性，航空公司的IATA(InternationalAirTransportAssociation，国际航空

运输协会)代码；

——AirportCode：属性，机场的IATA代码；

——FirstDepartPoint：属性，旅程出发地；

——ERSP_UserID：属性，ERSP(ElectronicReservationServiceProvider，电子预订服务系统

供应商)用户编号；

——TerminalID：属性，电子终端代号；

——RequestorID：复合元素，请求方标识，其元素结构见3.2.2；

——Position：复合元素，位置信息，其元素结构见3.2.3；

——BookingChannel：复合元素，预订通道，其元素结构见3.2.4；

——TPA_Extensions：复合元素,扩展项。

2

MH/T0061—2017

M图1DynamicPkgAvailRQH元素结构

3

MH/T0061—2017

图2POS元素结构

3.2.2RequestorID元素结构

包括7个属性和2个复合元素，如图3所示，具体如下：

——URL：属性，请求方的URL(UniformResourceLocator，统一资源定位符)；

——Type：属性，请求方的ID(Identification)类型代码，参见附录A.1；

——Instance：属性，实例；

——ID：属性，请求方ID值；

——ID_Context：属性，ID来源，如IATA等；

——MessagePassword：属性，密码；

——Name：属性，请求者姓名；

——CompanyName：复合元素，公司名称，包括以下7个属性，如图4所示，具体如下：

CompanyShortName：公司简称；

TravelSector：旅游业分类代码，参见附录A.2；

Code：公司代码；

CodeContext：代码来源，如DUNS(DataUniversalNumberingSystem,商业实体或组织

机构的标识符),IATA或者公司内部代码；

CountryCode：公司总部所在国家代码；

Division：分支机构；

Department：部门名称或编号。

——TPA_Extensions：复合元素，用于扩展元素和属性。

4

MH/T0061—2017

图3RequestorID元素结构

图4CompanyName元素结构

3.2.3Position元素结构

包括5个属性，如图5所示，具体如下：

——Latitude：纬度；

——Longitude：经度；

M——Altitude：高度；H

——AltitudeUnitOfMeasureCode：高度单位代码，参见附录A.3；

——PositionAccuracyCode：定位精度代码，参见附录A.4。

5

MH/T0061—2017

图5Position元素结构

3.2.4BookingChannel元素结构

包括2个属性和2个复合元素，如图6所示，具体如下：

——Type：属性，预订渠道类型代码，参见附录A.5；

——Primary：属性，该预订通道是否为主要预订手段；

——CompanyName：复合元素，公司名称，其元素结构同3.2.2的CompanyName；

——TPA_Extensions：复合元素，扩展项。

图6BookingChannel元素结构

3.3PromotionCodes元素结构

包含1个复合元素PromotionCode，表示促销代码。PromotionCode包含2个属性，如图7所示，具体

如下：

——RPH：索引编号；

——Code：促销代码。

图7PromotionCodes元素结构

3.4AirSearch

3.4.1AirSearch元素结构

包括3个属性和7个复合元素,如图8所示,具体如下：

——MaxResponses：属性，最大响应数；

6

MH/T0061—2017

——SequenceNumber：属性，序列号；

——RequestType：属性，搜索类型；

——PromotionInfo：复合元素，促销信息；包括1个属性PromotionCodeRPH，促销代码索引编号；

——AirItinerary：复合元素，飞行行程，包括2个属性和1个复合元素：

DirectionInd：属性，行程类型，如单程、往返、环程等；

AirItineraryRPH：属性，行程索引编号；

OriginDestinationOptions：复合元素，起始地/目的地选项集合。包括1个复合元素

OriginDestinationOption：起始地/目的地选项。OriginDestinationOption的元素结构

见3.4.2；

——OriginDestinationInformation：复合元素，出发地和目的地信息，其元素结构见3.4.3；

——SpecificFlightInfo：复合元素，特定航班信息，其元素结构见3.4.4；

——TravelPreferences：复合元素，旅行偏好，其元素结构见3.4.5；

——TravelRefSummary：复合元素，旅行偏好概要，其元素结构见3.4.6；

——TPA_Extensions：复合元素，用于扩展元素和属性。

图8AirSearch元素结构

3.4.2MOriginDestinationOptionH

OriginDestinationOption元素结构

包括3个属性和1个复合元素，如图9所示，具体如下：

——RefNumber：属性，OD对(OriginandDestinationpair)编号；

——RPH：属性，OD对索引编号；

——TravelPurpose：属性，旅行目的，如商务、个人，参见附录A.6；

7

MH/T0061—2017

——FlightSegment：复合元素，航班的一个或多个单独航段。包括24个属性，1个简单元素和9

个复合元素：

DepartureDateTime：属性，本航段的出发日期时间；

ArrivalDateTime：属性，本航段的到达时间日期时间；

StopQuantity：属性，航班经停数；

RPH：属性，航段索引编号；

InfoSource：属性，贸易伙伴指定的信息来源；

FlightNumber：属性，航班号；

TourOperatorFlightID：属性，航班在旅行代理库存中的ID号；

GovernmentApprovalInd：属性，航班是否获得政府批准；

GovernmentApprovalText：属性，政府批准信息；

FlownMileageQty：属性，航段飞行里程；

FareBasisCode：属性，航段价格基础代码；

ResBookDesigCode：属性，舱位类型代码；

NumberInParty：属性，和此航段相关的旅客数；

Status：属性，此航段的状态代码，参见附录A.7；

E_TicketEligibility：属性，航段是否符合电子客票；

MealCode：属性，航班的餐食服务代码；

DepartureDay：属性，出发日为星期几；

StopoverInd：属性，是否允许经停；

LineNumber：属性，先前响应中与该行段相关联的号码；

ConnectionType：属性，此航段的连接类型；

ParticipationLevelCode：属性，连接协议级别,参见附录A.8；

Distance：属性，航段里程，常用于常客里程累积；

DateChangeNbr：属性，航班到达日与出发日的间隔天数；

ValidConnectionInd：属性，有效连接标识，该值为真表示本航段构成有效的连接；

DepartureAirport：复合元素，航段的出发机场，其元素结构见；

ArrivalAirport：复合元素，航段的到达机场，其元素结构同的

DepartureAirport；

OperatingAirline：复合元素，代码共享航班的运营航空公司，其元素结构见；

Equipment：复合元素，航班使用的设备类型，其元素结构见；

TPA_Extensions：复合元素，扩展项；

MarketingAirline：复合元素，经销航空公司，其元素结构见；

MarriageGrp：简单元素，联程（两个或两个以上航段）；

BookingClassAvails：复合元素，各等级舱位的数量集合，其元素结构见；

Comment：复合元素,点评备注，包括1个属性Language,语种；

StopLocation：复合元素,经停位置，其元素结构见。

8

MH/T0061—2017

图9OriginDestinationOption元素结构

DepartureAirport元素结构

包括4个属性,如图10所示,具体如下：

——LocationCode：机场代码；

——CodeContext：代码来源，例如IATA代码或内部代码等；

——Terminal：出发或抵达航站楼；

——Gate：登机口或出口。

图10DepartureAirport元素结构

MOperatingAirline元素结构H

包括13个属性，如图11所示，具体如下：

——CompanyShortName：公司名称；

——TravelSector：旅游业分类代码，参见附录A.2；

——Code：公司代码；

——CodeContext：代码来源，如IATA或者内部代码；

9

MH/T0061—2017

——CountryCode：公司总部所在国家代码；

——Division：分支机构；

——Department：部门名称或编号；

——FlightNumber：航班号；

——ResBookDesigCode：当运营承运人不用于营销承运人时,本属性指运营承运人的舱位；

——MarketingInd：该值为真,表示信息属于营销航班；该值为假，表示信息属于运营航班；

——BookedRBD：已预订舱位；

——TicketedRBD：出票舱位；

——FrequentFlierMiles：常客里程累积。

图11OperatingAirline元素结构

Equipment元素结构

包括3个属性,如图12所示,具体如下：

——AirEquipType：飞机型号代码，如IATA的三字码；

——ChangeofGauge：飞行器变更标识。表示是否更换飞机；

——AircraftTailNumber：飞行器编号。

图12Equipment元素结构

MarketingAirline元素结构

包括8个属性,如图13所示,具体如下：

——CompanyShortName：公司简称；

10

MH/T0061—2017

——TravelSector：旅游业分类代码，参见附录A.2；

——Code：公司代码；

——CodeContext：代码来源，例如：DUNS,IATA或者内部代码；

——CountryCode：公司总部所在国家代码；

——Division：分支机构；

——Department：部门名称或编号；

——SingleVendorInd：单一供应商标识。

图13MarketingAirline元素结构

BookingClassAvails元素结构

包括1个属性和1个复合元素,如图14所示,具体如下：

——CabinType：属性，舱位类型；

——BookingClassAvail：复合元素，可供选择舱位，包括4个属性：

ResBookDesigCode：预订舱位代码,如Y；

ResBookDesigQuantity：预订舱位数量；

ResBookDesigStatusCode：预订舱位状态代码，参考附录A.9；

MRPH：销售舱位类型索引编号。H

图14BookingClassAvails元素结构

StopLocation元素结构

包括2个属性，如图15所示，具体如下：

11

MH/T0061—2017

——LocationCode：位置代码；

——CodeContext：代码来源。

图15StopLocation元素结构

3.4.3OriginDestinationInformation

OriginDestinationInformation元素结构

包括5个复合元素，如图16所示，具体如下：

——DepartureDateTime：出发日期时间，其元素结构见；

——ArrivalDateTime：到达日期时间，其元素结构同的DepartureDateTime；

——OriginLocation：出发位置，其元素结构见；

——DestinationLocation：目的地位置，其元素结构同的OriginLocation；

——ConnectionLocatons：连接位置的集合，其中包括1个复合元素ConnectionLocaton，表示一

个连接位置。其元素结构见。

图16OriginDestinationInformation元素结构

DepartureDateTime元素结构

包括3个属性，如图17所示，具体如下：

——WindowBefore：最早开始时间；

——WindowAfter：最晚开始时间；

——CrossDateAllowedIndicator：允许跨天标识。

图17DepartureDateTime元素结构

12

MH/T0061—2017

OriginLocation元素结构

包括4个属性，如图18所示，具体如下：

——LocationCode：位置代码；

——CodeContext：位置代码来源；

——MultiAirportCityInd：多机场城市标识；

——AlternateLocationInd：备选地点标识，如果为真，表示可选择其他地点，如在一定距离内的

其他城市或机场。

图18OriginLocation元素结构

ConnectionLocaton元素结构

包括8个属性，如图19所示，具体如下：

——LocationCode：位置代码；

——CodeContext：代码来源；

——Inclusive：联程中转点标识，如果为真，表示该地点可作为联程中转点；如果为假，表示该

地点不能作为联程中转点；

——PreLevel：偏好等级；

——MinChangeTime：两个连接之间间隔的分钟数；

——ConnectionInfo：确定连接是经停或转机；

——MultiAirportCityInd：多机场城市标识；

M——ConnectType：期望的连接类型，如在线连接、离线连接和联运连接。H

13

MH/T0061—2017

图19ConnectionLocaton元素结构

3.4.4SpecificFlightInfo

SpecificFlightInfo元素结构

包括1个简单元素和3个复合元素，如图20所示，具体如下：

——FlightNumber：简单元素，航班号；

——Airline：复合元素，航空公司，其元素结构同3.2.2的CompanyName；

——BookingClassPref：复合元素，响应中应包括或排除的舱位类型，其元素结构见；

——TPA_Extensions：复合元素，扩展项。

图20SpecificFlightInfo元素结构

BookingClassPref元素结构

包括3个属性，如图21所示，具体如下：

——ResBookDesigCode：预订舱位代码；

——PreferLevel：偏好等级；

——ResBookDesigCodeType：预订舱位代码类型。

图21BookingClassPref元素结构

3.4.5TravelPreferences

TravelPreferences元素结构

包括7个属性和7个复合元素，如图22所示，具体如下：

——SmokingAllowed：属性，允许吸烟标识；

——OnTimeRate：属性，准点率；

——ETicketDesired：属性，是否偏好电子票；

——MaxStopsQuantity：属性，最大中转数；

——Start：属性，开始时间；

——Duration：属性，持续时长；

——End：属性，结束时间；

14

MH/T0061—2017

——VendorPref：复合元素，供应商偏好，其元素结构见；

——FlightTypePref：复合元素，航班类型偏好，其元素结构见；

——FareRestrictPref：复合元素，运价偏好，其元素结构见；

——CabinPref：复合元素，舱位偏好，其元素结构见；

——EquipPref：复合元素，设备偏好，其元素结构见；

——TicketDistribPref：复合元素，出票渠道偏好，其元素结构见；

——BookingSeatPref：复合元素，座位偏好，其元素结构见。

图22TravelPreferences元素结构

VendorPref元素结构

包括11个属性，如图23所示，具体如下：

——CompanyShortName：公司简称；

——TravelSector：旅游业分类代码，参见附录A.2；

——Code：公司代码；

——CodeContext：代码来源，如IATA或者内部代码；

M——CountryCode：公司总部所在国家代码；H

——Division：分支机构；

——Department：部门名称或编号；

——PreferLevel：偏好等级；

——AllianceAllowedInd：允许同联盟其他承运人标识；

——LoyaltyAllowedInd：允许其他航空公司的常旅客计划标识；

15

MH/T0061—2017

——AwardOnlyFareInd：该值为真，表示只返回这个航空公司的优惠票价；该值为假，返回所有票

价。

图23VendorPref元素结构

FlightTypePref元素结构

包括11个属性，如图24所示，具体如下：

——PreferLevel：偏好等级；

——FlightType：航班类型，如非经停、直达、中转；

——MaxConnections：期望的最大连接数；

——NonScheduledFltInfo：不定期航班信息；

——BackhaulIndicator：回程标识；

——GroundTransportIndicator：地面交通运输标识，如果该值为真，表示至少包含一段地面交通；

——DirectAndNonStopOnlyInd：仅包含直达和非经停标识；

——NonStopsOnlyInd：仅包含直达标识；

——OnlineConnectionsOnlyInd：仅包含联程航班。如相同的营销航公司；

——RoutingType：旅行路线偏好；

——ExcludeTrainInd：不包含铁路标识。

16

MH/T0061—2017

图24FlightTypePref元素结构

FareRestrictPref

.1FareRestrictPref元素结构

包括5个属性和3个复合元素，如图25所示，具体如下：

——PreferLevel：属性，偏好等级；

——FareRestriction：属性，票价限制类型,如无限制、提前购买、变更惩罚等，参见附录A.10；

——Date：属性，与票价限制相关的日期；

——FareDisplayCurrency：属性，显示费用的货币单位；

——CurrencyOverride：属性，显示的货币单位不是当地通用货币单位；

——AdvResTicketing：复合元素，提前预订或出票限制，其元素结构见.2；

——StayRestrictions：复合元素，最大停留或最小停留时间限制，其元素结构见.3；

M——VoluntaryChanges：复合元素，自愿变更惩罚，其元素结构见H.4。

图25FareRestrictPref元素结构

.2AdvResTicketing元素结构

17

MH/T0061—2017

包括3个属性和2个复合元素，如图26所示，具体如下：

——AdvResInd：属性，标识请求或响应中有无提前预订限制；

——AdvTicketingInd：属性，标识请求或响应中有无提前出票限制；

——RequestedTicketingDate：属性，旅客期望的出票日期；

——AdvReservation：复合元素，提前预订的限制条件，包括3个属性：

LatestTimeOfDay：提前预订的截止时间；

LatestPeriod：出发前到提前预订的最晚时间长度；

LatestUnit：LatestPeriod值的时间单位。

——AdvTicketing：复合元素，提前出票限制，包括6个属性：

FromResTimeOfDay：预订后截止提前出票的日期时间；

FromResPeriod：预订后到提前出票的截止时间的长度；

FromResUnit：FromResPeriod值的时间单位；

FromDepartTimeOfDay：出发前提前出票的截止日期时间；

FromDepartPeriod：提前出票的截止时间到出发的时间长度；

FromDepartUnit：FromDepartPeriod值的时间单位。