资源简介
JT/T 1588—2026
目次
前言 Ⅱ
1 范围 1
2 规范性引用文件 1
3 术语和定义、缩略语 1
4 数据交换需求 2
5 数据交换流程 3
6 通信协议 5
7 接口内容 5
8 异常处置 15
9 数据交换安全 16
附录 A(规范性) 快件处理场所编号、安检设备编号、安检员编号及快件安检图像文件名称
编号生成规则 17
附录 B(资料性) 报文示例 19
参考文献 35
前言
本文件按照 GB/T 1 . 1—2020《标准化工作导则第 1 部分 :标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由全国综合交通运输标准化技术委员会( SAC/TC 571)提出并归口。
本文件起草单位 : 中国民航大学、国家邮政局邮政业安全中心、西安航空职业技术学院、天信达信息技术有限公司、首都机场集团有限公司、深圳市机场股份有限公司、顺丰航空有限公司、同方威视技术股份有限公司。
本文件主要起草人 :赵振武、邱培刚、张怡、张俊、孙茂鹏、司义品、杨玉涛、李继荣、兰海洋、钟欣怡、张婷婷、齐飞帅、李艳娇、邢肖肖、春思帆、高若琳、孙润锋。
1 范围
本文件规定了快件航空运输安检的数据交换需求、数据交换流程、通信协议、接口内容以及异常处置和数据交换安全的要求。
本文件适用于快递服务主体与航空运输企业之间的安检数据交换。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中 ,注日期的引用文件 ,仅该日期对应的版本适用于本文件;不注日期的引用文件 ,其最新版本(包括所有的修改单)适用于本文件。
GB/T 2260 中华人民共和国行政区划代码
GB/T 22239—2019 信息安全技术网络安全等级保护基本要求
GB/T 25061 信息安全技术 XML 数字签名语法与处理规范
GB 32100 法人和其他组织统一社会信用代码编码规则
GB/T 32907—2016 信息安全技术 SM4 分组密码算法
GB/T 35273 信息安全技术个人信息安全规范
3 术语和定义、缩略语
3 . 1 术语和定义
下列术语和定义适用于本文件。
3 . 1 . 1
快递服务主体 express service entity
在中华人民共和国境内依法登记的提供快递服务的企业及其分支机构 ,以及快递末端网点。 [来源 :GB/T 27917. 1—2023 ,3 . 3]
3 . 1 . 2
快件 express item
快递服务主体依法递送的信件、包裹、印刷品等。
注 :包裹内件包括消费品、工业品及其他产品。
[来源 :GB/T 27917. 1—2023 ,3 . 4]
3 . 1 . 3
快件编号 tracking number of express item
由一组阿拉伯数字和英文字母组成 ,用于标识快件的唯一代码。
[来源 :GB/T 27917. 1—2023 ,9 . 2 . 1]
3 . 1 . 4
集包 consolidated dispatch
对同一发运路线的快件 ,混装在一个容器内形成的快件运输包装单位。
注 :集包号是标识集包的唯一代码 ,与集包内快件编号形成关联关系。
[来源 :GB/T 27917 . 1—2023 ,9 . 2 . 5 ,有修改]
1
JT/T 1588—2026
3 . 1 . 5
快件处理场所 express handling area
快递服务主体专门开展快件卸载、分拣、仓储、封发、装载、交换、转运等活动的场所。 [来源 :GB/T 27917. 1—2023 ,7 . 5]
3 . 1 . 6
智能识别判图 intelligent recognition image processing
根据快件内物品的影像或物质成分等特征 ,通过人工智能算法对快件安检图像进行自动分析并生成判图结果。
3 . 1 . 7
快递信息系统 express information system
由计算机及相关设备、设施( 含网络)构成的 ,支撑快递服务主体对生产、服务、经营、管理等信息进行采集、加工、存储、传输、检索等处理的人机系统。
[来源 :GB/T 27917. 1—2023 ,7 . 17]
3 . 1 . 8
民用航空货物运输信息管理系统 air cargo transportation information management system
为航空货站提供场内仓储物流的核心业务操作和管理功能 ,覆盖国内国际进出港、中转、计费、仓
储、集控管理等核心业务 ,涵盖货站全部业务岗位和操作点 ,通过各种网络和信息技术构建的信息系统。注 :货物包括快件。
3 . 1 . 9
民用航空货物邮件安全检查信息管理系统 air cargo and mail security screening information man-
agement system
对民用航空货物邮件安全检查全过程中需要和产生的货物邮件运输信息、货邮安全检查信息、安全检查现场视音频信息、操作人员信息进行采集、存储、传输、加工、关联、检索、展示等处理的信息系统。
注 :货物包括快件。
3 . 2 缩略语
下列缩略语适用于本文件。
HTTPS:安全超文本传输协议( Hyper Text Transfer Protocol Secure) ;
SFTP :安全文件传输协议( Secure File Transfer Protocol) ;
UTF :统一码转换格式( Unicode Transformation Format) ;
XML :可扩展标记语言( Extensible Markup Language) ;
JSON :JavaScript 对象简谱(JavaScript Object Notation)。
4 数据交换需求
快件航空运输安检数据交换需求应符合表 1 的规定。
表 1 数据交换需求
序号
信息交换类型
交换数据项
发送方
接收方
交换频次
1
快递服务主体
及快件处理
场所信息
快递服务主体名称、统一社会信用代码、快件处理场所名称、快件处理场所编号、联系人、联系方式、快件处理场所地理位置
快递服务主体
承运人或地面服务代理人、民航安检机构
当信息产生时 ,一次交换 ; 当信息发生变化时 , 实时交换
2
JT/T 1588—2026
表 1 数据交换需求( 续)
序号
信息交换类型
交换数据项
发送方
接收方
交换频次
2
安检设备信息
安检设备编号、安检设备品牌、安检设备型号、速度、设备属性( 是否具备智能识别能力)
快递服务主体
民航安检机构
当信息产生时 ,一次交换 ; 当信息发生变化时 , 实时交换
3
安检员信息
安检员编号、安检员姓名、安检员手机号、所属快递服务主体
快递服务主体
民航安检机构
当信息产生时 ,一次交换 ; 当信息发生变化时 , 实时交换
4
快件快递服务主体安检信息
安检设备编号、快件编号、快件品名、快件处理结果、智能识别判图、判图员、判图时间
快递服务主体
民航安检机构
当信息产生时 ,实时交换
5
快件基本信息
航空运单号、快件数量、快件编号、快件品名、集包号与集包内快件编号关联信息
快递服务主体
承运人或地面服务代理人、民航安检机构
当信息产生或发生变化时 ,实时交换
6
收运结果信息
航空运单号、快件编号或集包号、收运快件数量、快件品名、收运结果、更新时间
承运人或地面服务代理人
民航安检机构、快递服务主体
当信息产生或发生变化时 ,实时交换
7
调取快件图像指令信息
快件编号或集包号、SFTP 上传路径
民航安检机构
快递服务主体
有需求时 , 实时交换
8
快件图像信息
快件安检图像文件名称、快件编号或集包号、SFTP 上传路径
快递服务主体
民航安检机构
当信息产生时 ,实时交换
9
快件航空安检状态信息
航空运单号、快件编号或集包号、查验放行的安检状态、更新时间
民航安检机构
快递服务主体
有需求时 , 实时交换
10
快件航空安检结论信息
航空运单号、快件编号或集包号、快件嫌疑框、快件结论、快件退运原因、处置人员
民航安检机构
承运人或地面服务代理人、快递服务主体
当信息产生时 ,实时交换
5 数据交换流程
快递信息系统、民用航空货物运输信息管理系统( 以下简称货运信息系统)、民用航空货物邮件安全检查信息管理系统( 以下简称货邮安检信息系统)之间的数据交换应采用点对点模式进行传输 ,系统应通过专网或互联网接收数据 ,并将接收的结果反馈给对方系统。快件航空运输安检数据交换流程见图 1。
3
JT/T 1588—2026
图 1 快件航空运输安检数据交换流程
4
JT/T 1588—2026
6 通信协议
6 . 1 传输协议
快递信息系统、货运信息系统、货邮安检信息系统之间的报文传输应使用 HTTPS 协议,图像文件信息应使用 SFTP 协议传输 ,数据发送应使用 POST 方式。
6 . 2 报文格式
快递信息系统、货运信息系统、货邮安检信息系统之间的数据交换报文宜采用 XML、JSON 封装格式。
7 接口内容
7 . 1 报文种类
快件航空运输安检数据交换报文种类应符合表 2 的规定。
表 2 数据交换报文种类
序号
报文种类代码
报文种类名称
发送方
接收方
1
1001
快递服务主体及快件处理场所信息
快递信息系统
货运信息系统、货邮安检信息系统
2
1002
安检设备信息
快递信息系统
货邮安检信息系统
3
1003
安检员信息
快递信息系统
货邮安检信息系统
4
1004
快件快递服务主体安检信息
快递信息系统
货邮安检信息系统
5
1005
快件基本信息
快递信息系统
货运信息系统、货邮安检信息系统
6
1006
收运结果信息
货运信息系统
快递信息系统、货邮安检信息系统
7
1007
调取快件图像指令信息
货邮安检信息系统
快递信息系统
8
1008
快件图像信息
快递信息系统
货邮安检信息系统
9
1009
快件航空安检状态信息
货邮安检信息系统
快递信息系统
10
1010
快件航空安检结论信息
货邮安检信息系统
快递信息系统、货运信息系统
7 . 2 数据项属性
各交换数据项参数用序号、字段名、中文名称、数据类型、最大长度、约束/条件、描述及要求 7 个描述属性。数据项参数属性应符合表 3 的规定。
表 3 交换数据项参数属性
序号
参数名称
说明
1
序号
参数在传入数据、返回数据中的排序
2
字段名
传入或返回字段名
3
中文名称
参数对应的中文名称
4
数据类型
参数数据取值类型
5
最大长度
数据传输允许的最大长度 ,单位为字节
6
约束/条件
参数是必备的或可选的 ,“M”表示该数据元为必备的 ,“O”表示该数据元为可选的
7
描述及要求
参数的简要解释说明和要求
5
JT/T 1588—2026
7 . 3 数据类型
快件航空运输安检数据交换中使用的数据类型应符合表 4 的规定。
表 4 数据类型
序号
数据类型
说明
1
String
字符型
2
Int
整型
3
Bool
布尔型
4
Date
日期型
5
DateTime
日期时间型
7 . 4 报文参数
快件航空运输安检数据交换接口参数应符合表 5 的规定。
表 5 快件航空运输安检数据交换接口参数
序号
字段名
中文名称
参数值
约束/条件
1
Data
数据内容
实际传输的信息符合 7. 5 的规定
M
2
Vstr
校验码
加密方式 :公共加密方式
加密规则 :报文种类代码 + 密钥 + 时间(“YYYY-MM-DDTHH :MM :SS”)
M
7 . 5 数据接口
7 . 5 . 1 快递服务主体及快件处理场所信息
快递服务主体及快件处理场所信息接口参数应符合表 6 的规定。
表 6 快递服务主体及快件处理场所信息接口参数
URL :UpLoadEnterpriseInfo 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
EnterpriseBrand
快递服务主体名称
String
30
M
示例 : × × 快递有限公司
2
EnterpriseCode
统一社会信用代码
String
20
M
统一社会信用代码为一组长度为 18 位的用于法人和其他组织身份识别的代码。该代码按照 GB 32100 中统一代码的构成规定确定
3
AreaName
快件处理场所名称
String
50
M
示例 : × × 快递有限公司天津分公司
6
JT/T 1588—2026
表 6 快递服务主体及快件处理场所信息接口参数( 续)
URL :UpLoadEnterpriseInfo 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
4
AreaCode
快件处理场所编号
String
30
M
填写快件处理场所编号 ,第一次入网时填写“Add ”
5
ContactsPeople
联系人
String
20
M
示例 :张 × ×
6
ContactsNumber
联系方式
String
20
M
示例 :18512345678
7
AreaPosition
快件处理场所地理位置
String
100
M
详细到门牌号
返回数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
Status
返回结果
Bool
1
M
true:成功;false:失败
2
Remsg
提示信息
String
100
O
错误提示信息 , 如参数不正确、授权失败、系统错误、无权限等
3
Recode
返回编号
Int
4
M
0 :失败;1 : 成功;2 : 参数不正确 ;3 :快件处理场所不存在
4
AreaCode
快件处理场所编号
String
30
M
第一次入网 ,为系统分配的编号值。生成规则按附录 A
7 . 5 . 2 安检设备信息
安检设备信息接口参数应符合表 7 的规定。
表 7 安检设备信息接口参数
URL :UpLoadDevice 方式:post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
DeviceCode
安检设备编号
String
20
M
安检设备第一次入网时填写“ Add ”
2
DeviceBrand
安检设备品牌
String
10
M
3
DeviceModel
安检设备型号
String
10
M
示例 :CX123456D
4
DeviceSpeed
速度
String
10
O
安检设备输送带的速度 , 格
式 :“ × × m/s ”
5
Intelligent
RecognitionAbility
设备属性( 是否具备智能识别能力)
Bool
1
M
true:具备智能识别能力;false :不具备智能识别能力
7
JT/T 1588—2026
表 7 安检设备信息接口参数( 续)
URL :UpLoadDevice 方式:post
返回数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
Status
返回结果
Bool
1
M
true:成功;false:失败
2
Remsg
提示信息
String
100
O
错误提示信息 , 如参数不正确、授权失败、系统错误、无权限等
3
Recode
返回编号
Int
4
M
0 :失败;1 : 成功;2 : 参数不正确 ;3 :安检设备不存在
4
DeviceCode
安检设备编号
String
20
M
第一次入网将安检设备分配的编号值返回至系统。生成规则按附录 A
7 . 5 . 3 安检员信息
安检员信息接口参数应符合表 8 的规定。
表 8 安检员信息接口参数
URL :UpLoadUserInfo 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
UserCode
安检员编号
String
30
M
填写安检员编号 ,第一次入网时填写“Add + 编号 ”
2
UserName
安检员姓名
String
20
M
示例 :李 × ×
3
UserTelephone
安检员手机号
String
20
M
示例 :18112345678
4
UserCompany
所属快递服务主体
String
30
O
示例 : × × 快递有限公司
返回数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
Status
返回结果
Bool
1
M
true:成功;false:失败
2
Remsg
提示信息
String
100
O
错误提示信息 , 如参数不正确、授权失败、系统错误、无权限等
3
Recode
返回编号
Int
4
M
0 :失败;1 : 成功;2 : 参数不正确 ;3 :快件处理场所不存在
7 . 5 . 4 快件快递服务主体安检信息
快件快递服务主体安检信息接口参数应符合表 9 的规定。
8
JT/T 1588—2026
表 9 快件快递服务主体安检信息接口参数
URL :UpLoadEnterpriseXrayInfo 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
DeviceCode
安检设备编号
String
20
M
检查快件使用的安检设备
2
PackageCode
快件编号
String
30
M
一系列数字和字母组成
3
PackageName
快件品名
String
1 000
M
若包含多个快件品名 ,按照顺序用“ ,”隔开
4
PackageConclusion
快件处理结果
Int
4
M
0 :查验放行;1 :放行
5
Intelligent
RecognitionImage
Processing
智能识别判图
Bool
1
M
true:智能识别判图;false:非智能识别判图
6
JudgeUser
判图员
String
50
O
智能识别判图为“false”时 ,选择发送此信息
7
JudgeTime
判图时间
DateTime
30
M
单件快件( 集包)全部完成判图的时间 , 格式 :“ YYYY-MM-
DDTHH :MM :SS ”
返回数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
Status
返回结果
Bool
1
M
true:成功;false:失败
2
Remsg
提示信息
String
100
O
错误提示信息 , 如参数不正确、授权失败、系统错误、无权限等
3
Recode
返回编号
Int
4
M
0 :失败;1 : 成功;2 : 参数不正确 ;3 :快件处理场所或安检设备不存在
7 . 5 . 5 快件基本信息
快件基本信息接口参数应符合表 10 的规定。
表 10 快件基本信息接口参数
URL :UpLoadBasicInfo 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
AirWayBillCode
航空运单号
String
12
M
示例 :784-12345670
2
PackageNumber
快件数量
Int
10
M
示例 :88
3
PackageCode
快件编号
String
30
M
一系列数字和字母组成
9
JT/T 1588—2026
表 10 快件基本信息接口参数( 续)
URL :UpLoadBasicInfo 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
4
PackageName
快件品名
String
1 000
M
若包含多个快件品名 ,按照顺序用“ ,”隔开
5
Consolidated
DispatchAnd
PackageRelatedInfo
集包号与集包内快件编号关联信息
String
1 000
M
集包号与包内的每一快件编号关联
返回数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
Status
返回结果
Bool
1
M
true:成功;false:失败
2
Remsg
提示信息
String
100
O
错误提示信息 , 如参数不正确、授权失败、系统错误、无权限等
3
Recode
返回编号
Int
4
M
0 :失败;1 : 成功;2 : 参数不正确 ;3 :快件处理场所不存在
7 . 5 . 6 收运结果信息
收运结果信息接口参数应符合表 11 的规定。
表 11 收运结果信息接口参数
URL :UpLoadCollectionResult 方式 :post
传入数据
序号
字段名
中文名称
数据类型
最大长度
约束/条件
描述及要求
1
AirWayBillCode
评论