6 通信报文消息类型清单-消费报文类型清单 .................................................................................... 5 7 通信应答码定义 .................................................................................................................................. 6 8 测试环境 IP 和端口 ............................................................................................................................ 6
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 页
交通一卡通通信信息规范传输通讯控制协议
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)
7. （服务端）发送断点通知报文（4005） 8. （客户端）发送数据报文（4004） 9. （服务端）发送应答报文(4008) 10. 重复8、9，直至文件传输完成 11. （客户端）发送文件传输结束报文（4007） 12. （服务端）发送应答报文(4008) 13. 转第6步，开始下一个文件的传输，如无文件则执行第14步 14. （客户端）关闭Socket连接 15. （客户端）断开拨号连接 （有拨号的情况）
第 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）
2 传输约定 为了使各类应用系统能够按照本标准规范接入清算中心系统，各类应用系统的开 发必须遵循以下约定：

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

传输信息需遵照 ISO2022，传输中文字符需遵照 GB2312。 各接入点应用系统与清算中心系统之间以文件/报文方式交换数据。应用系统 作为客户端，清算中心系统作为服务器端。
第 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.1.1 客户端上传文件流程 ................................................................. 3 5.1.2 客户端下载文件流程 ................................................................. 4
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