交通一卡通通信信息规范传输通讯控制协议V1.0.0

2 传输约定 为了使各类应用系统能够按照本标准规范接入清算中心系统，各类应用系统的开 发必须遵循以下约定：

各类应用系统与清算中心系统的通讯协议采用 TCP/IP 的 Socket 面向连接的通 讯。
交通一卡通通信信息规范传输通讯控制协议

传输信息需遵照 ISO2022，传输中文字符需遵照 GB2312。 各接入点应用系统与清算中心系统之间以文件/报文方式交换数据。应用系统 作为客户端，清算中心系统作为服务器端。

为保证提供通信效率，单个报文包括包长度，必须小于等于 4096 字节。实际 大小请根据网络的设备的 MTU 设定。
3 通用消息报文格式 请参照城市公共交通IC卡技术规范 第4部分： 信息接口——7.3.3通用消息报文格式(表 42) 说明： 同步信息：由客户端定义的，用于匹配请求消息的数据块，服务器端在应答中原样返 回。 压缩标志： 0 – 不压缩 1 – LZ77 算法 。当前填 0，不支持压缩 加密算法： 0 – 不加密。1 – 3DES 加密 。标识报文体是否经过加密及加密算法 版本号：为描述方便，此字段在通讯数据接口每种消息包文中重复描述，在通讯交互 中只作一次使用，目前统一为 01。 消息类型：为描述方便，此字段在通讯数据接口每种消息包文中重复描述，在通讯交 互中只作一次使用。 报文内容：由消息类型决定。 4 ftp 文件传输 在全国城市交通一卡通系统侧，为各机构提供 ftp 方式传输文件。

服务器端会对客户端进行身份验证。许可证由卡公司颁发。 各接入点应用系统应支持通讯断点续传功能。当通信重新建立后，从当前断点 处开始发送，而不必从头开始发送。

文件内不能带有空行，为了核对方便，数据文件中的记录与记录之间使用回车 符分隔。

为了保证文件不被重复发送，发送方需将已发送的文件移到备份目录。 连接超时，由于传输物理介质的不可靠性，会出现连接超时的情况。客户端和 服务段都必须设置超时中断。超时时间设置在 30s－60s 之间。
7. （服务端）发送断点通知报文（4005） 8. （客户端）发送数据报文（4004） 9. （服务端）发送应答报文(4008) 10. 重复8、9，直至文件传输完成 11. （客户端）发送文件传输结束报文（4007） 12. （服务端）发送应答报文(4008) 13. 转第6步，开始下一个文件的传输，如无文件则执行第14步 14. （客户端）关闭Socket连接 15. （客户端）断开拨号连接 （有拨号的情况）
2015.3.26 2015.8.1
王琦 张淳
Байду номын сангаас
草稿 v1.0.0 初稿 v1.0.0
文档说明：由于引用的《城市公共交通 IC 卡技术规范 第 4 部分：信息接 口》文档尚未正式出版，因此本文档为初稿，待引用文档出版后定稿。
第 2 页 共 9 页
交通一卡通通信信息规范传输通讯控制协议
目录
1 数据类型说明 ...................................................................................................................................... 1 2 传输约定 .............................................................................................................................................. 1 3 通用消息报文格式 .............................................................................................................................. 2 4 FTP 文件传输 ....................................................................................................................................... 2 5 流文件传输 .......................................................................................................................................... 3 5.1 文件传输流程 .............................................................................................................................. 3
第 3 页 共 9 页
1 数据类型说明 为了方便维护和管理，报文头和报文体都采用自定义的 ASCII 码报文结构。 清算中心系统与各接入点应用系统之间的接口通过报文来约定，各种报文格式中的数 据类型描述一般遵循以下规定： 标示代码 A a N 说明 大写字母，左靠，右补空格 小写字母，左靠，右补空格 数值 0-9；右靠，左补零；负号（－）使用“0X2D”，靠左，如：－ 00001 表示“负一” S AN ANS AS H YY MM DD hh mm ss VAR 特殊符号，需要专门说明 字母和/或数字，左靠，右部多余部分填空格 字母、数字和/或特殊符号，左靠，右部多余部分填空格 字母和/或特殊符号，左靠，右部多余部分填空格 十六进制数 0-F； A-F 为大写字母 年 月 日 时 分 秒 可变长说明，需要专门说明 未定义或未使用的域默认全部填写为：0
版本号定义规则： 版本号由清算中心维护。 使用阿拉伯数字，并由小数点分割成三部分。 第一部分（一位有效数字）：清算中心整体升级或改造时使用。 第二部分（一位有效数字）：本文档重大修改时使用。通常需要修改当前生产使用的 应用程序。 第三部分（位数不限）：本文档简单修改时使用。通常是增加说明、更加详细的描述， 不影响当前生产使用的应用程序。 第一部分和第二部分的有效数字需要在消息格式的版本号域、本文档标题和文件名中体 现。 日 期 姓 名 版 本 更 新 记 录
5.2 文件传输报文说明 ...................................................................................................................... 4
5.2.1 文件上传请求--文件请求报文(4001) ..................................... 4 5.2.2 文件下载请求--文件下载报文(4002) ..................................... 5 5.2.3 文件信息通知报文（4003） ..................................................... 5 5.2.4 断点通知报文(4005) ................................................................. 5 5.2.5 文件数通知报文(4006) ............................................................. 5 5.2.6 文件传输结束报文(4007) ......................................................... 5 5.2.7 数据报文(4004) ......................................................................... 5 5.2.8 应答报文(4008) ......................................................................... 5
第 2 页 共 9 页
交通一卡通通信信息规范传输通讯控制协议
具体路径为：/机构代码/upload、/机构代码/download、/机构代码/downbak、/机构 代码/tmp。机构每天从 download 目录获取未下载的文件，获取成功后移到 downbak。上传 文件时，文件先上传到 tmp 目录，传输结束后，再移到 upload 目录。 每个机构分配一个用户，每个机构只能访问自己机构目录下的文件及目录。 5 流文件传输 文件传输采用如下的流程进行，接收方在接收完每一个文件后，需要对文件大小，摘 要等信息进行验证处理等流程处理通过后，才能返回文件传输结束报文（4007）的成功应 答报文。验证不通过，则需要删除本地文件，返回失败，关闭连接，等待客户端重新上传 或重新下载。 传输过程中，如果有仍一方，发现通信接收或发送有问题，均需要主动关闭连接，不 得重新发送报文，避免接收方出现串包等问题。 5.1 文件传输流程 5.1.1 客户端上传文件流程 1. （客户端）建立连接 2. （客户端）发送文件上传请求报文（4001） 3. （服务端）验证身份，发送应答报文(4008) 4. （客户端）发送文件数通知报文（4006） 5. （服务端）发送应答报文(4008) 6. (客户端）发送文件信息通知报文（4003）
5.1.1 客户端上传文件流程 ................................................................. 3 5.1.2 客户端下载文件流程 ................................................................. 4
文件版本 文件编号 文件状态 文件等级
V1.0.0 GC_TEH_020 [√]草稿 [ ]修改版 [ ]正式版 [√]一般 [ ]普通 [ ]重要
交通一卡通通信信息规范 传输通讯控制协议 （初稿）
中国交通通信信息中心 2015 年 8 月 3 日
交通一卡通通信信息规范传输通讯控制协议
文档控制页
文 档 历 史 记 录
第 3 页 共 9 页
交通一卡通通信信息规范传输通讯控制协议
5.1.2 客户端下载文件流程 1. （客户端）建立连接 2. （客户端）发送文件下载请求（4002） 3. （服务端）验证身份 不通过则发送失败的文件数通知4006报文,响应码非00，并关闭连接，结束 下载； 通过则发送成功的文件数通知报文（4006）。 如果4006报文中需要下发的文件为0,则中心关闭连接，结束下载。 4. （客户端）发送应答报文（4008） 5. （服务端）发送文件信息通知报文（4003） 6. （客户端）发送断点通知报文（4005） 7. （服务端）发送应答报文（4008） 8. （服务端）发送数据报文（4004） 9. （客户端）发送应答报文（4008） 10. 重复8，9两步直到文件传输结束 11. （服务端）发送文件传输结束报文（4007） 12. （客户端）发送应答报文（4008） 13. （服务端）将成功传送的文件移到备份目录 重复5-13，直到所有的文件都传输完成 14. （客户端）关闭Socket连接 15. （客户端）断开拨号连接（有拨号的情况） 5.2 文件传输报文说明 各接入点应用系统与清算中心系统之间的文件是通过报文来传输的。报文分为控制报 文与数据报文两类、是文件传输的基本单元；控制报文包含传输数据报文所需的控制信 息； 一个文件需被按序拆成多个数据报文，每次传送一个数据报文。 5.2.1 文件上传请求--文件请求报文(4001) 请参照城市公共交通IC卡技术规范 第4部分： 信息接口——7.3.4.2文件请求报文(表43)
6 通信报文消息类型清单-消费报文类型清单 .................................................................................... 5 7 通信应答码定义 .................................................................................................................................. 6 8 测试环境 IP 和端口 ............................................................................................................................ 6