《民航常旅客信息查询及里程兑换接口数据规范》

民航常旅客信息查询及里程兑换接口数据规范

1范围

本文件规定了国内航空公司建设常旅客系统时，对外部关联信息系统提供常旅客信息查

询以及进行常旅客里程兑换时需要采用的数据规范。

本标准适用于国内航空公司各销售渠道（如B2B系统、B2C系统、呼叫中心、代理人销售

前端等）为常旅客提供里程信息查询和里程兑换功能，也适用于航空合作伙伴及其他行业公

司为常旅客提供里程信息查询和里程兑换功能。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

本文件没有需要界定的术语和定义。

4说明

本文件正文部分给出了常旅客信息查询接口、免票里程运价查询接口、升舱兑换里程运

价查询接口、衍生品兑换里程运价查询接口、免票交易执行接口、里程升舱交易执行接口、

衍生品交易执行接口、交易确认接口、交易取消接口、交易记录查询接口的数据元素及其结

构化描述、接口示例。

5流程

民航常旅客信息查询及里程兑换交易流程见图1。

5

图1民航常旅客信息查询及里程兑换交易流程图

6接口数据规范

6.1常旅客信息查询接口

6.1.1功能说明

该接口实现常旅客里程银行账户查询功能。

6.1.2节点说明

请求

<QUERY_FFP_CARDINFO_RQ>

<VERSION>1.0</VERSION>

<SYSTEM_TAG>DCS</SYSTEM_TAG>

<AIRLINE>CA</AIRLINE>

<FNX>FAM</FNX>

<CARDNO>CA0187****9999</CARDNO>

<FIELDS_FILTER></FIELDS_FILTER>

</QUERY_FFP_CARDINFO_RQ>

6

M/C/

序号字段名类型属性示例基数注释

O

1VERSIONstringM[\S\s]*1.01接口版本

号

2SYSTEM_stringM[\S\s]*DCS1请求系统

TAG标志

3AIRLINEstringM\w+CA1表示发到

该航司CRM

进行查询

4FNXstringM[a-zA-Z]+FAM1接口类型

名称

5CARDNOstringM[\S\s]*CA018791表示要查

9999999询的卡号;

前2位发

卡航司

6FIELDS_stringO[\S\s]*BALANCE0-1表示只请

FILTER求返回指

定的节点，

只支持

INFO下的

一级节点，

多个节点

名称用逗

号分隔

响应

<QUERY_FFP_CARDINFO_RS>

<RESULT><SUCCESS></SUCCESS></RESULT>

<QUERY>

<INFO>

<CARDNO>0187****9999</CARDNO>

<NAME>FENG/ER</NAME>

<CNAME>冯而</CNAME>

<CTCNLIST>

<CTCN><CT>PP</CT><CN>PP36899</CN></CTCN>

<CTCN><CT>OT</CT><CN>JG3886</CN></CTCN>

</CTCNLIST>

<PINSTATUS>Y</PINSTATUS>

7

<BALANCE>30***07</BALANCE>

<AVAILABLE>30***07</AVAILABLE>

<MEMSTATUS>Y</MEMSTATUS>

<CLASS>V</CLASS>

<ALCLASS>*G</ALCLASS>

<BENEFICIARYLIST>

<BENEFICIARY><NAME>LI/YI</NAME><STATUS>Y</STATUS></BENEFICIARY>

<BENEFICIARY><NAME>ZHANG/SAN</NAME><STATUS>Y</STATUS></BENEFICIARY>

<BENEFICIARY><NAME>LI/SI</NAME><STATUS>Y</STATUS></BENEFICIARY>

<BENEFICIARY><NAME>EE/EE</NAME><STATUS>Y</STATUS></BENEFICIARY>

<BENEFICIARY><NAME>YU/ER</NAME><STATUS>Y</STATUS></BENEFICIARY>

<BENEFICIARY><NAME>A/A</NAME><STATUS>Y</STATUS></BENEFICIARY>

<BENEFICIARY><NAME>ZHANG/ZAHGN</NAME><STATUS>Y</STATUS></BENEFICIARY>

</BENEFICIARYLIST>

</FREETEXT>

</FREETEXT>

</INFO>

</QUERY>

</QUERY_FFP_CARDINFO_RS>

序号字段名类型M/C/属性示例基数注释

O

1RESULTRESULTM1结果

2SUCCESstringM[\S\s]*1表示执行

S成功

3QUERYQUERYM1表示查询

报文返回

的结果

4INFOINFOM1表示查询

的账户信

息

5CARDNOstringO[\S\s]*0187***1卡号，不含

*9999发卡航司。

6NAMEstringO[\S\s]*FENG/ER0-1持卡人英

文或者配

8

音姓名

7CNAMEstringO[\S\s]*冯而0-1中文姓名

8CTCNLICTCNLISTO[\S\s]*0-1

ST

9CTCNCTCNO0-n

10CTstringO[\S\s]*NI0-1证件类型，

身份证

NI、护照

PP，其他

OT

11CNstringO[\S\s]*12345670-1证件号码

8

12PINSTAstringO[\S\s]*Y0-1PIN状

TUS态，表示密

码是否可

用

13BALANCstringO[\S\s]*50000-1账户余额

E

14AVAILAstringO[\S\s]*50000-1账户可用

BLE余额

15MEMSTAstringO[\S\s]*Y0-1会员状态，

TUS表示是否

是会员

16CLASSstringO[\S\s]*V0-1卡级别

17ALCLASstringO[\S\s]**G0-1联盟常

S客级

别，可选

18BENEFIBENEFICIARO1

CIARYLYLIST

IST

19BENEFIBENEFICIARO1-n分支结点，

CIARYY表示受益

人

20NAMEstringO[\S\s]*ZHANG/Z0-1表示受益

AHGN人姓名，通

常为拼音

或英文姓

名

21CNAMEstringO[\S\s]*张三0-1表示受益

9

人中文姓

名

22STATUSstringO[\S\s]*Y0-1表示可对

换状态

23FREETEstringO[\S\s]*Thisis0-1自由文本，

XTfor可以为空，

extensi为扩展使

on用

6.1.3错误编码

错误码ERRCODE错误描述FAILURE

QUERY_FFP_CARDINFOFORMAT

FFPL-0101-19

ERR

QUERY_FFP_CARDINFOHASNO

FFPL-0102-10

PRIVILEGETOEXECUTE

QUERY_FFP_CARDINFOCRM

FFPL-0103-11

RETURNERR

QUERY_FFP_CARDINFONOT

FFPL-0104-12

SUPPORT

QUERY_FFP_CARDINFO

FFPL-0105-24

DATABASEERR

QUERY_FFP_CARDINFOQUERY

FFPL-0106-69

TIMEOUT

QUERY_FFP_CARDINFO

FFPL-0107-71

INTERNALERR

6.2免票里程运价查询接口

6.2.1功能说明

该接口实现免票所需里程运价查询功能。

6.2.2节点说明

请求

<QUERY_FFP_REDEEM_PRICE_RQ>

<VERSION>1.0</VERSION>

<SYSTEM_TAG>DCS</SYSTEM_TAG>

<AIRLINE>CA</AIRLINE>

<FNX>FQF</FNX>

<SEGS>

10

<SEG>

<ORIDES>PEKCAN</ORIDES>

<AL1>CA</AL1>

<AL2>CA</AL2>

<FL>1351</FL>

<DATE>20201010</DATE>

<TIME>0800</TIME>

<CLASS>X</CLASS>

</SEG>

</SEGS>

</QUERY_FFP_REDEEM_PRICE_RQ>

M/C/

序号字段名类型属性示例基数注释

O

1VERSIONstringM[\S\s]*1.01接口版本

号

2SYSTEM_stringM[\S\s]*DCS1请求系统

TAG标志

3AIRLINEstringM\w+MU1表示发到

该航司CRM

进行查询

4FNXstringM[a-zA-Z]+FRB1接口类型

名称

5SEGSSEGSM1

6SEGSEGM1航段信息

分支节点

7ORIDESstringM[a-zA-Z]+PEKPVG1起始地目

的地机场

三字代码

对。

如PEKPV

G

8AL1stringM\w+CA1票面承运

人

9AL2stringM\w+CA1实际承运

人

10FLstringM[a-zA-Z0-9]+18351航班号，包

括Suffix。

如1234T

11

11DATEstringMyyyyMMdd20201221航班日期，

5格式

如YYYYM

MDD

12TIMEstringMHHmm08051航班起飞

时间，格式

如HHMM

13CLASSstringM^[a-zA-Z]{1}$O1舱位。如O、

I

响应

<QUERY_FFP_REDEEM_PRICE_RS>

<RESULT><SUCCESS></SUCCESS></RESULT>

<QUERY>

<PRICELIST>

<PRICE>

<QID>1</QID><AL>CA</AL><CODE>NORMAL</CODE><SG>1</SG>

<TP>OW</TP><SPEND><TYPE>MI</TYPE><NO>12000</NO><BACK>12000</BACK></SPEND><SD>20

080101</SD><ED>20121231</ED><CH>Y</CH>

<NOTE>MILEAGEAWARDTICKET</NOTE>

</PRICE>

</PRICELIST>

</QUERY>

</QUERY_FFP_REDEEM_PRICE_RS>

序号字段名类型M/C/属性示例基数注释

O

1RESULTRESULTM1结果

2SUCCESSUCCESSM1表示执行

S成功

3QUERYQUERYM1查询类指

令必须结

点，是查询

报文返回

的结果

4PRICELPRICELISTM1

IST

5PRICEPRICEO0-n

12

6QIDstringO[\S\s]*10-1查询序号

7ALstringO\w+CA0-1航空公司

二字码

8CODEstringO[\S\s]*NORMAL0-1销售代码

9SGstringO[0-9]*10-1航段数

10TPstringO[\S\s]*OW0-1表示为单

程

11SPENDSPENDO0-1表示消费

类型和数

量

12TYPEstringO[\S\s]*MI0-1表示是里

程运价

13NOstringO[\S\s]*120000-1总的消费

里程数，单

位为KM

14BACKstringO[\S\s]*120000-1用于回传

航空公司

发过来的

信息。

15SDstringOyyyyMMdd20****0-1Start

25Date。销

售代码起

始有效日

期

16EDstringOyyyyMMdd20****0-1End

25Date。销

售代码最

后有效日

期，可以为

空。

17CHstringO[\S\s]*Y0-1改签标识，

可以为Y

或N中的

一个。Y表

示可以改

签。N表示

不能改签。

如果没有

这一结点，

默认为可

改签。

18NOTEstringO[\S\s]*MILEAG0-1签注。其它

E可能需要

13

AWARD的提示

TICKET

6.2.3错误编码

错误码ERRCODE错误描述FAILURE

QUERY_FFP_REDEEM_PRICE

FFPL-0601-14

FORMATERR

QUERY_FFP_REDEEM_PRICE

FFPL-0602-15

HASNOPRIVILEGETOEXECUTE

QUERY_FFP_REDEEM_PRICE

FFPL-0603-16

CRMRETURNERR

QUERY_FFP_REDEEM_PRICE

FFPL-0604-17

NOTSUPPORT

QUERY_FFP_REDEEM_PRICE

FFPL-0605-29

DATABASEERR

QUERY_FFP_REDEEM_PRICE

FFPL-0606-64

QUERYTIMEOUT

QUERY_FFP_REDEEM_PRICE

FFPL-0607-76

INTERNALERR

6.3升舱兑换里程运价查询接口

6.3.1功能说明

该接口实现升舱兑换所需里程运价查询功能。

6.3.2节点说明

请求

<QUERY_FFP_UPCLASS_PRICE_RQ>

<VERSION>1.0</VERSION>

<SYSTEM_TAG>DCS</SYSTEM_TAG>

<AIRLINE>CA</AIRLINE>

<FNX>FQU</FNX>

<SEGS>

<SEG>

<ORIDES>PEKPVG</ORIDES>

<AL1>CA</AL1>

<AL2>CA</AL2>

14

<FL>1835</FL>

<DATE>20****25</DATE>

<TIME>0805</TIME>

<CLASS>O</CLASS>

<OCLASS>Y</OCLASS>

</SEG>

</SEGS>

</QUERY_FFP_UPCLASS_PRICE_RQ>

M/C/

序号字段名类型属性示例基数注释

O

1VERSIONstringM[\S\s]*1.01接口版本

号

2SYSTEM_stringM[\S\s]*DCS1请求系统

TAG标志

3AIRLINEstringM\w+CA1表示发到

该航司CRM

进行查询

4FNXstringM[a-zA-Z]+FQU1接口类型

名称

5SEGSSEGSM1

6SEGSEGM1航段信息

分支节点，

只能有一

个

7ORIDESstringM[a-zA-Z]+PEKPVG1起始地目

的地机场

三字代码

对。

如PEKPV

G

8AL1stringM\w+CA1票面承运

人

9AL2stringM\w+CA1实际承运

人

10FLstringM[a-zA-Z0-9]+18351航班号，包

括Suffix。

如1234T

11DATEstringMyyyyMMdd20201221航班日期，

5格式

如YYYYM

15

MDD

12TIMEstringMHHmm08051航班起飞

时间，格式

如HHMM

13CLASSstringM^[a-zA-Z]{1}$O1舱位。如O、

I

14OCLASSstringM^[a-zA-Z]{1}$Y1原舱位。

响应

<QUERY_FFP_UPCLASS_PRICE_RS>

<RESULT><SUCCESS></SUCCESS></RESULT>

<QUERY>

<PRICELIST>

<PRICE>

<QID>1</QID><AL>CA</AL><CODE>NORMAL</CODE><SG>1</SG><TP>UP</TP><SPEND><TYPE>MI<

/TYPE><NO>12000</NO><BACK>12000</BACK></SPEND><SD>20****25</SD><ED>20****25</ED

><CH></CH><NOTE>MILEAGEAWARDTICKET</NOTE>

</PRICE>

</PRICELIST>

</QUERY_FFP_UPCLASS_PRICE_RS>

序号字段名类型M/C/属性示例基数注释

O

1RESULTRESULTM1结果

2SUCCESSUCCESSM1表示执行

S成功

3QUERYQUERYM1查询类指

令必须结

点，是查询

报文返回

的结果

4PRICELPRICELISTM1

IST

5PRICEPRICEO0-n

6QIDstringO[\S\s]*10-1查询序号

7ALstringO\w+CA0-1航空公司

二字码

8CODEstringO[\S\s]*NORMAL0-1销售代码

16

9SGstringO[0-9]*10-1航段数

10TPstringO[\S\s]*UP0-1表示为升

舱类型

11SPENDSPENDO0-1表示消费

类型和数

量

12TYPEstringO[\S\s]*MI0-1表示是里

程运价

13NOstringO[\S\s]*120000-1总的消费

里程数，单

位为KM

14BACKstringO[\S\s]*120000-1用于回传

航空公司

发过来的

信息

15SDstringOyyyyMMdd20****0-1Start

25Date。销

售代码起

始有效日

期

16EDstringOyyyyMMdd20****0-1End

25Date。销

售代码最

后有效日

期，可以为

空。

17CHstringO[\S\s]*Y0-1改签标识，

可以为Y

或N中的

一个。Y表

示可以改

签。N表示

不能改签。

如果没有

这一结点，

默认为可

改签。

18NOTEstringO[\S\s]*MILEAG0-1签注。其它

E可能需要

AWARD的提示

TICKET

6.3.3错误编码

17

错误码ERRCODE错误描述FAILURE

QUERY_FFP_UPCLASS_PRICE

FFPL-0201-10

FORMATERR

QUERY_FFP_UPCLASS_PRICE

FFPL-0202-11

HASNOPRIVILEGETOEXECUTE

QUERY_FFP_UPCLASS_PRICE

FFPL-0203-12

CRMRETURNERR

QUERY_FFP_UPCLASS_PRICE

FFPL-0204-13

NOTSUPPORT

QUERY_FFP_UPCLASS_PRICE

FFPL-0205-25

DATABASEERR

QUERY_FFP_UPCLASS_PRICE

FFPL-0206-60

QUERYTIMEOUT

QUERY_FFP_UPCLASS_PRICE

FFPL-0207-72

INTERNALERR

6.4衍生品兑换里程运价查询接口

6.4.1功能说明

该接口实现衍生品兑换所需里程运价查询功能。

6.4.2节点说明

请求

<QUERY_FFP_DERIVATIVES_PRICE_RQ>

<VERSIO