T/CCAATB 0024-2022 民用机场电子行李凭证技术规范

ICS03.220.50

CCSV51

T/CCAATB

中国民用机场协会团体标准

T/CCAATB0024—2022

民用机场电子行李凭证技术规范

TechnicalSpecificationsofElectronicIdentificationBaggage

inCivilAirport

2022-04-24发布2022-05-24实施

中国民用机场协会发布

T/CCAATB0024—2022

目次

前言..............................................................................II

引言.............................................................................III

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

2规范性引用文件...................................................................1

3术语和定义.......................................................................1

4电子行李凭证服务.................................................................2

4.1概述.........................................................................2

4.2始发站职责...................................................................2

4.3目的站职责...................................................................2

4.4行李赔付职责.................................................................3

5信息安全.........................................................................3

6标准化接口服务...................................................................3

6.1适用范围.....................................................................3

6.2电子行李凭证接口调用流程.....................................................3

6.3行李跟踪系统状态接口调用流程.................................................6

6.4刷新令牌接口调用流程........................................................12

7基本技术要求....................................................................14

7.1数据项......................................................................14

7.2显示规则....................................................................15

7.3刷新规则....................................................................16

7.4有效性......................................................................16

附录AJASON示例..................................................................17

参考文献..........................................................................21

I

T/CCAATB0024—2022

前言

本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》给出的

规则起草。

本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由中国民航信息网络股份有限公司提出。

本文件由中国民用机场协会归口。

本文件起草单位：中国民航信息网络股份有限公司。

本文件主要起草人：杜晓铭、陈新、王晓亮、高红、赵梦杰、浦黎、黄威、眭永波、吴啟彪、

邓歆、黄长春、郑飏飏、王建。

本文件为首次发布。

II

T/CCAATB0024—2022

引言

随着物联网的发展与无纸化出行的兴起，在智慧民航建设过程中，电子登机牌应运而生，从电子登

机牌投入使用至今反响较好，极大地便利了旅客的出行。为了更好地建设智慧机场、智慧旅程，纸质的

行李提取联如何从线下走到线上、电子行李凭证如何发展慢慢走进了行业发展的视野中。

与纸质行李提取联相比，电子行李凭证支持旅客无纸化便捷出行，无需行李凭证等一次性耗材，可

实现无纸化“绿色出行”。电子行李凭证具有更高的便携性，方便获取，不易丢失，使用电子行李凭证

能有效提升旅客出行体验，并能够对行李服务进行扩展。

我国目前没有针对电子行李凭证的标准，为顺应我国民航发展趋势，考虑国内机场业务模式特点，

建立国内电子行李凭证的全行业标准。该标准的制定有利于规范和促进机场自助行李托运应用和设备的

使用，拓展了旅客对于行李的感知渠道，促进我国民航运输电子化，对全行业发展有着积极正面的影响。

III

T/CCAATB0024—2022

民用机场电子行李凭证技术规范

1范围

本文件规定了中国民用机场电子行李凭证服务的基本要求，规定了访问电子行李凭证的标准服务接

口。

本文件适用于机场行李托运服务。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅注日期的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T18764-2002《民用航空旅客运输术语》

MH/T1038《公共航空行李运输服务规范》

3术语和定义

下列术语和定义适用于本文件。

3.1

行李提取联IdentificationBaggage;ClaimBaggage

承运人在航班当日办理旅客乘机手续时对旅客办理托运后，出具给旅客在目的站提取行李的有效凭

证。该提取联作为承运人出具给旅客专为识别托运行李的凭据。

3.2

行李跟踪BaggageTracking

对行李处理环节的记录跟踪，主要包含：值机、行李安检、行李分拣、行李仓储、行李装车、出港

行李运输、行李装机、行李卸载、到港行李运输、行李中转、行李到达、行李提取等。

3.3

跟踪节点TrackingNode

确定行李位置的任何行李记录创建点。

3.4

电子行李凭证ElectronicIdentificationBaggage

旅客在机场自助行李托运设备办理行李托运过程中，获得的电子的行李凭证，可通过扫描自助设备

上的二维码、机场公众号或门户网站等多种渠道获取。

注：电子行李凭证包括行李数量，电子一维条码，行李编号、行李跟踪状态、跟踪节点等信息。

示例：

1

T/CCAATB0024—2022

②

①

③

④

⑤

⑥

⑦

⑧

标引序号说明：

①行李数量；②行李编号；③行李重量；④行李跟踪节点；

⑤一维条码；⑥行李跟踪状态；⑦使用方法；⑧航班信息。

图1电子行李凭证示例

4电子行李凭证服务

4.1概述

行李提取联作为承运人与旅客之间行李关联的主要凭证，是行李承运、行李运输、行李提取、行李

查询、行李异常处理以及行李损失理赔服务中的一个重要凭证。电子行李凭证的使用仅作为辅助手段，

暂时不能取代纸质行李提取联作为唯一凭证使用。

电子行李凭证用来为旅客查询自身行李状态，了解自身行李的运输途径以及位置提供电子依据，是

支撑行李全流程跟踪的技术手段之一。

4.2始发站职责

机场或者承运人应在行李办理的始发站提供获取电子行李凭证入口，如机场公众号，承运人服务公

众号等。承运人在自助行李托运界面上增加获取渠道，旅客在办理自助托运行李的同时，应能直接获取

旅客电子行李凭证。旅客输入航班号航班信息以及证件信息可以获取本人的电子行李凭证。

4.3目的站职责

目的站承认旅客电子行李凭证的有效性，旅客行李异常的情况，旅客可以持电子行李凭证到行李查

询部门查询行李轨迹。

目的站应提供条码阅读设备，通过扫描旅客登机牌和行李条，确认旅客提供的电子凭证信息，保证

旅客顺利进港。

2

T/CCAATB0024—2022

4.4行李赔付职责

承运人承认旅客电子行李凭证的有效性，旅客可以通过提供电子行李凭证签署承运人行李赔付协

议，并获得承运人的赔偿。承运人应提供有效的手段，支持查询旅客电子行李凭证的真实性，并协助旅

客完成行李赔付过程。

5信息安全

电子行李凭证中涉及旅客数据，应遵照《中华人民共和国网络安全法》、《中华人民共和国数据

安全法》、网络安全等级保护制度2.0等相关规定妥善保管，不得作用于其他应用，如出现违反相关规

定及法规的情况，应由责任人承担一切后果。

6标准化接口服务

6.1适用范围

使用接口的机场，航司及其他被授权方。

6.2电子行李凭证接口调用流程

6.2.1通信协议

采用https协议进行数据传输和通信。通信双方采用一问一答的通讯机制，即一次请求对应于一次

应答。连续发送请求的频率不宜超过60秒。

6.2.2接口描述

以下为接口功能的描述包含返回数据格式、调用步骤等信息。

通过此接口，查询用户的行李信息，并以JSON的格式返回给调用方。

电子行李凭证接口调用流程图请见图2，调用步骤如下：

持有效令牌，并提供需要获取电子行李凭证的旅客的航班号、航班日期、证件号（身份证号、护照

号等）或客票号信息。

针对该旅客7日内有效行程，接口提供该行程的行李提取联。

3

T/CCAATB0024—2022

图2电子行李凭证接口调用流程图

6.2.3接口说明

接口支持JSON格式的数据，支持HTTPPOST的请求方式，具体更多内容见错误!未找到引用源。：

表1电子行李凭证接口说明

URLhttps://ip:端口/v1/travel/passengerBag/getBagInfoAndBarcode

支持格式JSON

HTTP请求方式POST

是否登录验证否

请求数限制无

6.2.4输入参数

电子行李凭证接口header信息如错误!未找到引用源。。

表2电子行李凭证接口header信息

参数名必选类型及范围说明

client-令牌√String接口提供的有效令牌

注：令牌过期后，需调用令牌刷新接口，获取新令牌。具体接口调用流程参照6.4

4

T/CCAATB0024—2022

电子行李凭证接口参数说明如错误!未找到引用源。。

表3电子行李凭证接口参数说明

参数名必选类型数据样例说明

{"entity":{"fltNo":"","fltDate":""

requestVo√StringJSON格式的参数

,"certNo":"","ticketNumber":""}}

输入参数具体说明如错误!未找到引用源。。

表4电子行李凭证接口输入参数具体说明

参数名必选类型数据样例说明

fltNo√StringCA1626航班号

航班日期（格式

fltDate√String2021-03-01

yyyy-MM-dd）

5LjO2Dj+ZZqNGuXYHjeaAN+gXhKLcJEB证件号（身份证、

certNoString

ZUPhB7lOxrcgIg==护照）

√

5bvK3jz7Z5eEHebSGfjRuvwqE++94+Ju

ticketNumberString客票号

/vwInT8=

注：certNo和ticketNumber两者必选其一；证件号、客票号的加密方式采用AES/GCM/NoPadding加密算法，256

位密钥。

6.2.5参数校验

以下为参数校验规则：

证件号或客票号有一个必传，不应都为空。

航班号、航班日期不应为空。

航班日期格式正确与否。

证件号、客票号加密方式正确与否。

6.2.6输出参数

输出参数主要包括状态值、接口调用状态说明、回调说明、接口具体返回值等多个参数，具体见错

误!未找到引用源。。

表5电子行李凭证接口输出参数说明

返回键类型返回值说明

statusString状态值200

messageString接口调用状态说明成功

callbackString回调说明

resultString接口具体返回值JSON格式报文体

每个航班允许旅客携带的行李数

>allowBagCount字符串允许行李数量

量不同，故需要返回此参数

每个航班允许旅客携带的行李重

>allowBagWeight字符串允许行李重量

量不同，故需要返回此参数

5

T/CCAATB0024—2022

返回键类型返回值说明

是机场行李条码扫描枪能够识别

电子行李条码图片编码（可直的行李条码，根据行李编号生成，

>bagBarCode字符串

接转为png图片）扫描枪扫码后能够直接获得行李

编号

>bagNumber字符串行李编号行李唯一标识

>bagTagtype字符串行李标签类型行李是否取消

>bagType字符串行李类型普通行李、客舱狗笼等

NI表示身份证，PSPT表示护照，

>certtype字符串证件类型(NI、PSPT等)其他证件类型，参考民航局的证

件类型列表

>currBagCount字符串当前行李数量旅客本次行程的行李总数量

>currBagWeight字符串当前行李重量（KG）旅客本次行程的行李总重量

>depCode字符串出发机场三字码旅客始发机场三字码

>arrCode字符串到达机场三字码旅客到达机场三字码

>fltNo字符串航班号本次行程的航班号

>fltDate字符串航班日期（yyyy-MM-dd）本次行程的航班日期

>ticketNumber字符串电子客票号电子客票号

>bagArrCode字符串行李目的地行李到达机场三字码

6.2.7错误代码对照表

错误代码对照表如错误!未找到引用源。。

表6电子行李凭证接口错误代码对照表