ICS 35.240.60 CCS GJSH M80 上 海 市 工 商 联 国 际 物 流 商 会 团体标准 T/GJSH 000022—2021 邮政业安检联网的接口和上联技术规范 Technical specification for interface and uplink of postal security inspection networking 2021 - 12 - 22发布 2021 - 12 - 29实施 上海市工商联国际物流商会 发布 全国团体标准信息平台 全国团体标准信息平台 T/GJSH 000022 —2021 I 目次 前言 ................................ ................................ ................. II 1 范围 ................................ ................................ ............... 1 2 规范性引用文件 ................................ ................................ ..... 1 3 术语和定义 ................................ ................................ ......... 1 4 传输协议 ................................ ................................ ........... 1 5 数据格式 ................................ ................................ ........... 1 6 调用说明 ................................ ................................ ........... 1 7 信息交换流程 ................................ ................................ ....... 2 8 容错机制 ................................ ................................ ........... 3 9 接口详细说明 ................................ ................................ ....... 3 附录A（规范性） 包裹异常类型编号对照表 ................................ ............... 9 附录B（规范性） 编号生成规则 ................................ ........................ 11 全国团体标准信息平台 T/GJSH 000022 —2021 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件 的发布机构 不承担识别专利的责任。 本文件由上海市工商联国际物流商会提出并归口。 本文件起草单位：国家邮政局邮政业安全中心、同方威视技术股份有限公司、邮政科学研究规划院 有限公司、无锡日联科技股份有限公司、中国邮政集团有限公司、顺丰科技有限公司、北京京邦达贸易 有限公司、国邮恒 安（北京）科技有限公司 本文件主要起草人：张婷婷、邱培刚、任仰奇、齐飞帅、刘旭东。 全国团体标准信息平台 T/GJSH 000022 —2021 1 邮政业安检联网的接口和上联技术规范 1 范围 本文件规定 了安检机联网信息交换需求，包含联网数据传输协议、数据格式、调用 说明、信息交换 流程、容错机制和 接口详细说明等。 本文件适用于各快递服务组织快件分拨中心和有安检流程的包裹收寄点使用的安检机进行联网集 中监管的信息交换。其他行业的安检信息数据交换可参照使用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成必不可少的条款。其中，注日期的引用文件，仅该 日期对应的版本适用于本文件； 不注日期的引用文件， 其最新版本 （包括所有的修改单） 适用于本文件。 GB/T 27917 .1-2011 快递服务 第1部分：基本术语 3 术语和定义 下列术语和定义适用于本文件。 快递服务组织 express service organization 在中国境内依法注册的，提供快递服务的企业及其加盟企业、代理企业。 注： 快递服务组织包括快递服务组织和邮政企业提供快递服务的机构。 [来源：GB/T 27917.1 —2011，2.2] 快件 express item 快递服务组织依法递送的信件、 包裹、印刷品等的统称。 [来源：GB/T 27917.1 —2011，2.3] FTP 文件传输协议 ,用于在网络上进行文件传输的一套标准协议。 4 传输协议 普通文本信息应使用 HTTP协议进行交互，安检员信息及嫌疑快件相关信息应使用 HTTPS协议交互， 图像文件信息应使用 FTP协议传输。 5 数据格式 数据传输与数据返回应采用 JSON格式。 6 调用说明 参数、返回值描述属性 接口参数和返回值应用 序号、字段名、中文名称、数据类型、约束 /条件、说明等属性描述，参数、 返回值内容描述属性应符合 表1要求。 全国团体标准信息平台 T/GJSH 000022 —2021 2 表1 序号 描述属性 解释说明 1 序号 数据元在传入参数、返回参数中的排序 2 字段名 数据库的字段名称 3 中文名称 数据库的字段名称的对应中文名称 4 数据类型 数据元的数据取值类型 5 最大长度 数据传输允许的最大长度，单位为字节 6 约束/条件 数据元是必备的或可选的， ”M”表示该数据元为必备的 ,”O”表示该数据元 为可选的 7 说明 数据元的简要解释和应用说明 参数说明 应明确 “传入参数 ”的内容。相关 参数说明见表 2。 表2 序号 字段名 中文名称 参数值 约束/条件 1 Data 数据内容 真正传输的信息，实际参考 9.1～9.10 M 2 SiteCode 站点编号 系统分配 ,站点编号 。新增时传 “Add” M 3 DeviceCode 设备编号 系统分配， 为每台入网的安检机标识号 。新增时传 “Add”, 上 传站点或人员信息时，传空 M 4 Vstr 校验码 加密方式： 公共加密方法 加密规则：设备编号 + URL +公钥+时间（“yyyyMMddHH” ） M 7 信息交换流程 有安检联网需求的快递服务组织将数据通过点对点模式传输给上联系统，上联系统通过专网或互 联网接收数据，并将接收的结果反馈给快递服务组织。安检信息交换流程见图 1。 快递服务组织 上联系统 专网或互联网 企业基础信息 业务系统 存储系统 接入系统 认证系统 内部系统 发送基础信息 设备基础信息 发送基础信息 安检员基础信息 发送基础信息 设备状态信息 发送状态信息 安检员状态信息 发送状态信息 快件基础信息1.发送包裹文本信息 2.返回是否调取包裹图像 是否调取 图像 上传图像是 3.图像上传至指定位置 图1 安检信息交换流程 全国团体标准信息平台 T/GJSH 000022 —2021 3 8 容错机制 网络异常处理 与上联管理系统连接 超时，应将要上传的 数据缓存 在本地环境， 缓存时间不少于三天。 当本地缓存 不为空时，使用轮询方式 调用“网络状态检查 （9.1）”接口检测 网络状态 ，当网络恢复时，需将缓存 的记录逐一上传至上联管理系统，并在系统返回成功 后，清除本地 缓存记录。 续传处理 在调用上联管理系统 上传接口时，应监控每一次返回结果 。如返回结果是失败 或超时，应重新上传 ， 上传周期为每 10秒钟调用一次，连续 10次失败，停止调用 并及时反馈。 信息要求 上传的图片等资源文件原则上 每张图片大小 应不超过 200 KB。为了保证快速读取， 在不影响质量的 前提下， 可尽量减小图片 占用空间 。图片格式仅限 为未加密的 jpg格式。 中文处理 接口中涉及到中文传递，应全部通过 utf-8方式转码后再发送 。 9 接口详细 说明 网络状态检查 检查网络是否连通，在无法连接上联系统时应进行轮询调用，轮询频率 30 s/次。相关参数见表3。 表3 URL: GetNetState 方式：post 传入参数 Data部分 序号 字段名 中文名称 数据类型 最大长度 约束/条件 说明 1 UpdateTime