《民航常旅客信息查詢及里程兌換接口數(shù)據(jù)規(guī)范》

民航常旅客信息查詢及里程兌換接口數(shù)據(jù)規(guī)范

1范圍

本文件規(guī)定了國內(nèi)航空公司建設(shè)常旅客系統(tǒng)時，對外部關(guān)聯(lián)信息系統(tǒng)提供常旅客信息查

詢以及進(jìn)行常旅客里程兌換時需要采用的數(shù)據(jù)規(guī)范。

本標(biāo)準(zhǔn)適用于國內(nèi)航空公司各銷售渠道（如B2B系統(tǒng)、B2C系統(tǒng)、呼叫中心、代理人銷售

前端等）為常旅客提供里程信息查詢和里程兌換功能，也適用于航空合作伙伴及其他行業(yè)公

司為常旅客提供里程信息查詢和里程兌換功能。

2規(guī)范性引用文件

本文件沒有規(guī)范性引用文件。

3術(shù)語和定義

本文件沒有需要界定的術(shù)語和定義。

4說明

本文件正文部分給出了常旅客信息查詢接口、免票里程運(yùn)價查詢接口、升艙兌換里程運(yùn)

價查詢接口、衍生品兌換里程運(yùn)價查詢接口、免票交易執(zhí)行接口、里程升艙交易執(zhí)行接口、

衍生品交易執(zhí)行接口、交易確認(rèn)接口、交易取消接口、交易記錄查詢接口的數(shù)據(jù)元素及其結(jié)

構(gòu)化描述、接口示例。

5流程

民航常旅客信息查詢及里程兌換交易流程見圖1。

5

圖1民航常旅客信息查詢及里程兌換交易流程圖

6接口數(shù)據(jù)規(guī)范

6.1常旅客信息查詢接口

6.1.1功能說明

該接口實(shí)現(xiàn)常旅客里程銀行賬戶查詢功能。

6.1.2節(jié)點(diǎn)說明

請求

<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/

序號字段名類型屬性示例基數(shù)注釋

O

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

號

2SYSTEM_stringM[\S\s]*DCS1請求系統(tǒng)

TAG標(biāo)志

3AIRLINEstringM\w+CA1表示發(fā)到

該航司CRM

進(jìn)行查詢

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

名稱

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

9999999詢的卡號;

前2位發(fā)

卡航司

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

FILTER求返回指

定的節(jié)點(diǎn)，

只支持

INFO下的

一級節(jié)點(diǎn)，

多個節(jié)點(diǎn)

名稱用逗

號分隔

響應(yīng)

<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/屬性示例基數(shù)注釋

O

1RESULTRESULTM1結(jié)果

2SUCCESstringM[\S\s]*1表示執(zhí)行

S成功

3QUERYQUERYM1表示查詢

報文返回

的結(jié)果

4INFOINFOM1表示查詢

的賬戶信

息

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

*9999發(fā)卡航司。

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、護(hù)照

PP，其他

OT

11CNstringO[\S\s]*12345670-1證件號碼

8

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

TUS態(tài)，表示密

碼是否可

用

13BALANCstringO[\S\s]*50000-1賬戶余額

E

14AVAILAstringO[\S\s]*50000-1賬戶可用

BLE余額

15MEMSTAstringO[\S\s]*Y0-1會員狀態(tài)，

TUS表示是否

是會員

16CLASSstringO[\S\s]*V0-1卡級別

17ALCLASstringO[\S\s]**G0-1聯(lián)盟常

S客級

別，可選

18BENEFIBENEFICIARO1

CIARYLYLIST

IST

19BENEFIBENEFICIARO1-n分支結(jié)點(diǎn)，

CIARYY表示受益

人

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

AHGN人姓名，通

常為拼音

或英文姓

名

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

9

人中文姓

名

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

換狀態(tài)

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

XTfor可以為空，

extensi為擴(kuò)展使

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免票里程運(yùn)價查詢接口

6.2.1功能說明

該接口實(shí)現(xiàn)免票所需里程運(yùn)價查詢功能。

6.2.2節(jié)點(diǎn)說明

請求

<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/

序號字段名類型屬性示例基數(shù)注釋

O

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

號

2SYSTEM_stringM[\S\s]*DCS1請求系統(tǒng)

TAG標(biāo)志

3AIRLINEstringM\w+MU1表示發(fā)到

該航司CRM

進(jìn)行查詢

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

名稱

5SEGSSEGSM1

6SEGSEGM1航段信息

分支節(jié)點(diǎn)

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

的地機(jī)場

三字代碼

對。

如PEKPV

G

8AL1stringM\w+CA1票面承運(yùn)

人

9AL2stringM\w+CA1實(shí)際承運(yùn)

人

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

括Suffix。

如1234T

11

11DATEstringMyyyyMMdd20201221航班日期，

5格式

如YYYYM

MDD

12TIMEstringMHHmm08051航班起飛

時間，格式

如HHMM

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

I

響應(yīng)

<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/屬性示例基數(shù)注釋

O

1RESULTRESULTM1結(jié)果

2SUCCESSUCCESSM1表示執(zhí)行

S成功

3QUERYQUERYM1查詢類指

令必須結(jié)

點(diǎn)，是查詢

報文返回

的結(jié)果

4PRICELPRICELISTM1

IST

5PRICEPRICEO0-n

12

6QIDstringO[\S\s]*10-1查詢序號

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

二字碼

8CODEstringO[\S\s]*NORMAL0-1銷售代碼

9SGstringO[0-9]*10-1航段數(shù)

10TPstringO[\S\s]*OW0-1表示為單

程

11SPENDSPENDO0-1表示消費(fèi)

類型和數(shù)

量

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

程運(yùn)價

13NOstringO[\S\s]*120000-1總的消費(fèi)

里程數(shù)，單

位為KM

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

航空公司

發(fā)過來的

信息。

15SDstringOyyyyMMdd20****0-1Start

25Date。銷

售代碼起

始有效日

期

16EDstringOyyyyMMdd20****0-1End

25Date。銷

售代碼最

后有效日

期，可以為

空。

17CHstringO[\S\s]*Y0-1改簽標(biāo)識，

可以為Y

或N中的

一個。Y表

示可以改

簽。N表示

不能改簽。

如果沒有

這一結(jié)點(diǎn)，

默認(rè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升艙兌換里程運(yùn)價查詢接口

6.3.1功能說明

該接口實(shí)現(xiàn)升艙兌換所需里程運(yùn)價查詢功能。

6.3.2節(jié)點(diǎn)說明

請求

<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/

序號字段名類型屬性示例基數(shù)注釋

O

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

號

2SYSTEM_stringM[\S\s]*DCS1請求系統(tǒng)

TAG標(biāo)志

3AIRLINEstringM\w+CA1表示發(fā)到

該航司CRM

進(jìn)行查詢

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

名稱

5SEGSSEGSM1

6SEGSEGM1航段信息

分支節(jié)點(diǎn)，

只能有一

個

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

的地機(jī)場

三字代碼

對。

如PEKPV

G

8AL1stringM\w+CA1票面承運(yùn)

人

9AL2stringM\w+CA1實(shí)際承運(yùn)

人

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原艙位。

響應(yīng)

<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/屬性示例基數(shù)注釋

O

1RESULTRESULTM1結(jié)果

2SUCCESSUCCESSM1表示執(zhí)行

S成功

3QUERYQUERYM1查詢類指

令必須結(jié)

點(diǎn)，是查詢

報文返回

的結(jié)果

4PRICELPRICELISTM1

IST

5PRICEPRICEO0-n

6QIDstringO[\S\s]*10-1查詢序號

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

二字碼

8CODEstringO[\S\s]*NORMAL0-1銷售代碼

16

9SGstringO[0-9]*10-1航段數(shù)

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

艙類型

11SPENDSPENDO0-1表示消費(fèi)

類型和數(shù)

量

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

程運(yùn)價

13NOstringO[\S\s]*120000-1總的消費(fèi)

里程數(shù)，單

位為KM

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

航空公司

發(fā)過來的

信息

15SDstringOyyyyMMdd20****0-1Start

25Date。銷

售代碼起

始有效日

期

16EDstringOyyyyMMdd20****0-1End

25Date。銷

售代碼最

后有效日

期，可以為

空。

17CHstringO[\S\s]*Y0-1改簽標(biāo)識，

可以為Y

或N中的

一個。Y表

示可以改

簽。N表示

不能改簽。

如果沒有

這一結(jié)點(diǎn)，

默認(rè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衍生品兌換里程運(yùn)價查詢接口

6.4.1功能說明

該接口實(shí)現(xiàn)衍生品兌換所需里程運(yùn)價查詢功能。

6.4.2節(jié)點(diǎn)說明

請求

<QUERY_FFP_DERIVATIVES_PRICE_RQ>

<VERSIO