业务数据通讯模块概要设计文档.docx
23页
编号：时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第1页 共1页业务数据通讯模块概要设计文档杭州方欣计算机工程有限公司2009年7月目 录引言 3概述 41、背景介绍 42、通讯需求 4采用TCP/IP协议 4传递报文 4同步或异步传输 4文本或文件传输 43、通讯示意图 4第一章 通讯业务基本规则 61、通讯中涉及到的数据范围及数据流向： 62、总公司FTP服务器规范说明： 63、分公司端与总公司端通讯报文： 63.1、用途 63.2、格式 6第二章 客户端交易过程流程图 7第三章 服务端交易过程 9第四章 通讯相关业务描述 9一、基础资料传输交易 9二、基础资料传输流程图 10三、开票信息传输交易 10四、开票信息传输流程图 10第五章 通讯报文格式描述 12分公司与总公司通讯报文 121、基础资料传输交易 122、基础资料传输状态查询交易 143、开票信息传输交易 144、开票信息传输状态查询交易 155、网络状态查询 17第六章 附录 17一、交易存储过程返回代码说明： 17引言〖阅读指南〗〖阅读对象〗〖名词解释〗 【注意】 联系人【警告】无概述1、背景介绍在某大型企业的信息化应用中，分公司的业务系统需要和总公司的系统进行数据通讯和传输，每天总公司需要获得分公司的业务数据，如产品销售情况，同时更新分公司相应的基础资料信息。
数据通讯必须要遵守标准协议和约定,所以分公司数据通讯客户端与总公司的数据通讯模块服务器端之间要有统一的业务接口以便通讯服务器端在接收客户端数据后,可把数据传递给总公司管理系统, 总公司管理系统把处理的结果返回给通讯服务器端,通过服务器端再把应答消息返回给分公司数据通讯客户端2、通讯需求采用TCP/IP协议采用标准的TCP/IP协议通讯服务端是TCP/IP的服务端，是通讯连接和关闭的被动方传递报文通讯报文、业务报文格式由总公司已拟订好,通讯服务器端在接收客户端的业务报文后,根据报文内容进行后续处理,处理后生成处理结果,再把此结果信息返回给分公司客户端同步或异步传输传输可以使用同步或异步模式如果是同步模式，服务器端把业务处理完毕后才能返回消息给客户端；如果是异步模式，则服务器端接收完数据后就先把应答消息头返回给客户端,再传递业务数据处理文本或文件传输可支持文本传输，同时也支持文件的传输文件的传输通过FTP进行传输3、通讯示意图传输客户端报文传输服务端总公司管理系统分公司分公司业务系统总公司FTPTCP/IP协议总公司FTP协议第一章 通讯业务基本规则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同步或异步10:同步；1:异步3文件名50本字段在服务器端passMessage调用时起作用4文件传输标识10本字段在服务器向客户端传输文件时的标识,值为”0”则代表通过本系统传输,值为”1”则代表通过FTP服务器传输本字段不够长度的用空格补全.5业务报文长度10如果本字段为0，则表示专用报文后不需传输业务报文；如果不为0，则表示专用报文后紧跟着传输的是本字段所规定长度的业务报文。
6数据文件长度10如果本字段为0，则表示在传输业务报文之后不需要再传输数据文件；如果本字段不为0，则表示业务报文后紧跟着传输的是数据文件的内容7消息鉴别码10服务器端在接收到数据后要对该数据进行消息鉴别码的判断,如果不一样,说明数据被篡改.不再作业务处理,告诉业务业务处理失败应答.(暂不用算法实现,用10个A填充);第二章 客户端交易过程流程图流程说明：主要为两个交易：基础资料交易、开票信息交易基础资料交易[1]客户端向服务器端发送网络状态查询报文，监测能否接受服务器应答而决定是否进行后续操作[2] 客户端向通讯服务器端发送传输交易业务报文[3] 通讯服务器端的业务模块进行业务相关数据操作，生成该分公司的基础资料[4] 通讯服务器端业务模块把生成的处理结果上传至总公司FTP服务器[5] 客户端向通讯服务器端发送查询交易业务报文[6] 通讯服务器业务模块检查该次业务数据操作是否完成，并返回查询结果报文[7] 服务器端向客户端返回处理结果消息及基础资料文件[8] 客户端根据服务器端返回结果决定是否进行后续操作，成功则去FTP服务器上下载处结果文件[9] 客户端做数据验证并做更新本地基础资料数据操作，产生日志，日志本地保存，并上传至总公司FTP服务器。
开票信息交易[1]客户端向服务器端发送网络状态查询报文，监测能否接受服务器应答而决定是否进行后续操作[2] 客户端生成开票数据文件，并把生成的数据文件上传至向总公司FTP服务器[3] 客户端向通讯服务器端发送传输交易业务报文[4] 通讯服务器端的业务模块收到开票数据文件，然后进行业务相关数据操作[5] 客户端向通讯服务器端发送查询交易业务报文[6] 通讯服务器业务模块检查该次业务数据操作是否完成，并返回查询结果报文[7] 服务器端向客户端返回处理结果消息[8] 客户端根据服务器端返回结果决定是否进行后续操作，成功则去FTP服务器上下载处结果文件[9] 客户端做数据验证并做更新本地开票数据操作，对于总公司已成功接收的开票数据打上已传输标识，并产生日志，日志本地保存，并上传至总公司FTP服务器第三章 服务端交易过程流程说明：[1] 通讯服务器端接受客户端的传输交易报文，读取客户端上传文件，经过基本验证后返回应答报文[2] 通讯服务器端的业务模块进行业务数据操作，并生成返回处理结果[3] 业务模块生成处理结果并上传至总公司FTP服务器[4] 通讯服务器端接受客户端的传输交易报文，经过基本验证后返回应答报文。
[5] 客户端根据应答报文内容决定是否进行后续操作，成功则去FTP服务器上下载处结果文件[6] 客户端做数据验证并入库操作，产生日志，日志本地保存，并上传至总公司FTP服务器注：服务端程序功能已经实现，会根据报文内容处理服务端的事务因此服务端程序功能不需要在本需求中实现 第四章 通讯相关业务描述一、基础资料传输交易 分公司通过这个交易，准确地获取到公司的两个方面的基本信息其中包括： 1、分公司的基本信息 分公司基本信息以总公司为准，每次更新总公司下发的最新信息 2、产品列表信息 产品列表以总公司为准： 1)更新已经存在的产品列表信息 2)停用或者删除（未存在开票信息）没有下发确在分公司已经存在的产品列表信息二、基础资料传输流程图三、开票信息传输交易分公司端通过这个交易，将某段时间内的业务销售开票信息（包括销售单和退货单）传送到总公司根据业务表[YW_BILLINFO]的传送标记字段[CSBJ]，查询出需要未上传的票据信息CSBJ=0根据报文格式生产上传的XML文件最后根据报文格式生成数据文件上传总公司FTP服务器，再由开票信息传输交易报送到总公司端，总公司端经过验证后数据部分落地后返回日志并上传总公司FTP服务器，分公司端下载日志后分析内容，如果有错则分公司端修改数据后重新传送。
四、开票信息传输流程图第五章 通讯报文格式描述分公司与总公司通讯报文 交易名称实时性要求交易代码基础资料传输交易同步、实时76基础资料传输状态查询交易同步、实时77开票信息传输交易同步、实时80开票信息传输状态查询交易同步、实时81网络状态查询同步、实时881、基础资料传输交易交易涉及到的内容：1、分公司的基本信息 分公司基本信息以总公司为准，每次更新总公司下发的最新信息2、产品列表信息 产品列表以总公司为准： 1)更新已经存在的产品列表信息 2)停用或者删除（未存在开票信息）没有下发确在分公司已经存在的产品列表信息1.1 报文格式分公司向总公司发送报文：
