非税单机开票系统通讯模块概要的设计文档.docVIP

业务数据通讯模块概要设计文档 杭州方欣计算机工程有限公司 2009年7月 目 录 引言 3 概述 4 1、背景介绍 4 2、通讯需求 4 采用TCP/IP协议 4 传递报文 4 同步或异步传输 4 文本或文件传输 4 3、通讯示意图 4 第一章 通讯业务基本规则 6 1、通讯中涉及到的数据范围及数据流向： 6 2、总公司FTP服务器规范说明： 6 3、分公司端与总公司端通讯报文： 6 3.1、用途 6 3.2、格式 6 第二章 客户端交易过程流程图 7 第三章 服务端交易过程 9 第四章 通讯相关业务描述 9 一、基础资料传输交易 9 二、基础资料传输流程图 10 三、开票信息传输交易 10 四、开票信息传输流程图 10 第五章 通讯报文格式描述 12 分公司与总公司通讯报文 12 1、基础资料传输交易 12 2、基础资料传输状态查询交易 14 3、开票信息传输交易 14 4、开票信息传输状态查询交易 15 5、网络状态查询 17 第六章 附录 17 一、交易存储过程返回代码说明： 17  引言 〖阅读指南〗 。 〖阅读对象〗 〖名词解释〗 【注意】 联系人 【警告】 无。  概述 1、背景介绍 在应用中，和的进行数据通讯和传输数据通讯必须要遵守协议和约定的 第一章 通讯业务基本规则 1、通讯中涉及到的数据范围及数据流向： 注: 为了说明方便，通讯端客户端指分公司，通讯端服务端指总公司。 数据流向说明： 开票数据： 分公司-〉总公司-〉分公司（说明：客户端发起交易生成数据，传送到服务端，服务端经过数据处理后返回日志，客户端获取日志后根据日志内容修改数据库） 基础数据： 总公司-〉分公司：（说明：客户端发起交易但不生成数据，由服务端生成数据，客户端获取数据后根据数据内容修改数据库） 数据覆盖原则：以总公司为准进行覆盖。 数据范围及数据流向表 交易名称 数据流向 落地机制 数据覆盖机制 基础资料传输交易 总公司-〉分公司 允许部分落地，无法落地的信息记入错误日志表 以总公司为准进行覆盖; 服务端返回数据项中：总公司没有分公司有，采取删除原则。 开票信息传输交易 分公司-〉总公司-〉分公司 允许部分落地，无法落地的信息记入错误日志表 日志返回成功的结果回写开票表的传送标记字段，不成功的结果则不操作 2、总公司FTP服务器规范说明： 总公司FTP服务器根据不同分公司建立用户，用户名和密码都为分公司编码，在总公司FTP上建立一个目录做为根目录，然后以分公司编码做为子目录名，客户端和服务端生成的数据文件上传到该分公司编码的子目录下，命名方式以YYYYMMDD-业务名称XX.xml，总公司返回日志文件名称为YYYYMMDD-业务名称YZXX.xml。 3、分公司端与总公司端通讯报文： 3.1、用途 通讯中，任何方发送或接收的第一个内容必须是专用报文。发送方利用专用报文告诉接收方：本次通讯的目的、方式、内容；接收方必须接收到专用报文后才能确定后续应该如何操作。 3.2、格式 专用报文长度必须是512字节。如果不足512字节，则必须用空格补充。 下表说明专用报文的组成结构： 序号 名称 长度 （字节） 说明 1 应答码 4 如果本字段为“9999”，则表示是客户端向服务器发送的请求；如果本字段为“0000”，则表示服务器向客户端返回成功信息；如果本字段为“0001”，则表示客户端接收数据超时；如果本字段为“0002”，则表示接收服务器向客户端返回失败信息。如果本字段为“5555”，则表示客户端向服务器发送断开连接的请求。 2 同步或异步 1 0:同步；1:异步 3 文件名 50 本字段在服务器端passMessage调用时起作用。 4 文件传输标识 10 本字段在服务器向客户端传输文件时的标识,值为”0”则代表通过本系统传输,值为”1”则代表通过FTP服务器传输。本字段不够长度的用空格补全. 5 业务报文长度 10 如果本字段为0，则表示专用报文后不需传输业务报文；如果不为0，则表示专用报文后紧跟着传输的是本字段所规定长度的业务报文。 6 数据文件长度 10 如果本字段为0，则表示在传输业务报文之后不需要再传输数据文件；如果本字段不为0，则表示业务报文后紧跟着传输的是数据文件的内容。 7 消息鉴别码 10 服务器端在接收到数据后要对该数据进行消息鉴别码的判断,如果不一样,说明数据被篡改.不再作业务处理,告诉业务业务处理失败应答.(暂不用算法实现,用10个A填充); 第二章 客户端交易过程流程图 流程说明： 主要为两个交易：基础资料交易、开票信息交易 基础资料交易 [1]客户端向服务器端发送网络状态查询报文，监测能否接受服务器应答而决定是否进行后续操作。 [2] 客户端向通讯服务器端发送传输交易业务报文。