给据邮件跟踪查询系统和相关系统接口说明.doc

.目录目录文档信息.4变更历史.4第 1 章 总体说明.101.1 接口目的.101.2 接口实现方式.10 数据传输类接口实现方式.10 服务调用类接口实现方式.101.3 信息种类.10 数据传输类接口的信息种类.10 服务调用类接口的信息种类.12第 2 章 传输规范.132.1 传输机制.132.2 正常报文.13 总体说明.13 正常报文控制消息格式.142.3 差错处理.15 总体说明.15 批量异常报文控制消息格式.15 数据项描述.16 批量异常报文格式.16 报文体填写说明.172.4 下发信息回执.18 接口报文说明.18 接口报文传送频次.18 下发回执报文控制消息格式.18 数据项描述.18 报文格式.192.5 报文通信函数说明.202.6 TOPIC 及 QUEUE 的设置信息.20第 3 章 数据传输类接口.263.1 接口单元编码规则.26 与电子化支局系统接口单元编码.26 与中心局系统接口单元编码.27 与投递系统接口单元编码.273.2 生产数据类接口.28 给据邮件收寄信息.28 给据邮件投递信息.30 给据邮件总包发出信息-电子化支局.33 给据邮件总包到达/封发/发出信息-中心局系统.35 给据邮件到达电子化支局/投递局信息.38 大客户邮件当前状态的邮件清单信息按批次查询查询条件信息.40. 大客户邮件妥投情况统计信息按批次查询查询条件信息.42 大客户邮件当前状态的邮件清单信息按批次查询查询结果信息.44 大客户邮件妥投情况统计信息按批次查询查询结果信息.463.3 基础数据类.48 收寄邮件种类.48 行政区划信息.50 未妥投原因.52 未妥投下一步行动代码.53 客户信息.55 机构代码信息.57第 4 章 服务调用类接口.604.1 邮件当前状态查询服务调用接口.60 接口数据项描述.60 服务 URL.61 函数功能.614.2 邮件全程跟踪查询服务调用接口.63 接口数据项描述.63 服务 URL.64 函数功能.644.3 邮件收寄信息查询服务调用接口.66 接口数据项描述.66 服务 URL.68 函数功能.684.4 邮件投递信息查询服务调用接口.70 接口数据项描述.70 服务 URL.704.4.3 函数功能.704.5 邮件批量查询服务调用接口.70 接口数据项描述.70 服务 URL.70 函数功能.704.6 对内邮件当前状态查询服务调用接口.70 接口数据项描述.70 服务 URL.70 函数功能.704.7 对内邮件全程跟踪查询服务调用接口.70 接口数据项描述.70 服务 URL.70 函数功能.704.8 对内邮件收寄信息查询服务调用接口.70 接口数据项描述.70 服务 URL.70 函数功能.704.9 对内邮件投递信息查询服务调用接口.70. 接口数据项描述.70 服务 URL.70 函数功能.704.10 对内邮件批量查询服务调用接口.70 接口数据项描述.70 服务 URL.70 函数功能.70.文档信息文档信息编写者编写日期审核者审核日期批准人批准日期变更历史变更历史序号序号章节章节描述描述备注备注修改人修改人修改日期修改日期1.数据传输类接口删除：邮件备注接口史彦2009-1-082.与电子化支局系统接口单元编码删除：邮件备注接口史彦2009-1-083.邮件备注信息接口删除该节内容史彦2009-1-084.数据传输类接口在中心局系统中增加一个省份属性信息的接口史彦2009-1-125.与中心局系统接口单元编码增加一个省份属性信息的接口史彦2009-1-126.省份属性信息增加有关省份属性信息基础信息的接口史彦2009-1-127.删除省份属性信息通过一次性导入的方式解决秦永叶2009-2-58.给据邮件总包到局/出局信息删除总包号信息增加处理局、处理局属性用于中心局系统标识是否为第一个获最后一个中心局秦永叶2009-2-5.9.大客户批次代码修改数据类型为VARCHAR20秦永叶2009-2-510.投递系统到达信息投递系统只能向给据邮件跟踪查询系统传送邮件到达信息,无法提供总包到达信息史彦2009-2-611.投递系统相关描述去掉与投递系统相关的描述史彦2009-2-612.投递系统给据邮件到局信息因投递系统只能提供给据邮件的到达信息,无法提供邮件所属总包的到达信息,故对投递系统的给据邮件到局信息增加一节,单独进行描述史彦2009-2-613.数据结构、数据项说明、报文规范将本节数据结构、数据项说明、报文规范中总包的可重复次数改为9999,将报文规范中报文头最后一个域由邮件数量改为总包数量史彦2009-2-1014.数据传输类接口的信息种类在与中心局生产作业系统的接口中,增加了给据邮件封发信息的接口史彦2009-2-1615.与中心局系统接口单元编码将与中心局系统的到达/封发/出局三类接口信息合并为一个接口史彦2009-2-1616.与给据邮件到达/发出信息接口将该接口改为给据邮件到达/发出电子化支局信息史彦2009-2-16.17.与中心局系统的各类接口增加一个接口为给据邮件到达/发出中心局信息及中心局系统的邮件封发信息史彦2009-2-1618.给据邮件投递信息中的投递邮件性质对投递邮件性质做如下规定：0-包裹单,1-实物史彦2009-2-1619.第4章传输规范增加一章内容为传输规范史彦2009-2-1720.1.2接口实现方式增加一节内容为接口实现方式史彦2009-2-1921.数据传输类接口将与电子化支局系统的给据邮件到达信息改为给据邮件到达信息；将与中心局系统的给据邮件到达信息及给据邮件发出信息改为给据邮件的总包到达信息及给据邮件的总包发出信息史彦2009-2-1922.与电子化支局系统接口将到达信息的接口说明由传送给据邮件到达信息改为传送给据邮件到达信息史彦2009-2-1923.与中心局系统接口将到达/封发/发出信息的接口说明由传送邮件的到达/发出信息改为传送总包的到达/发出信息史彦2009-2-1924.给据邮件收寄信息接口去掉该接口的数据项描述中的寄件人地址、寄件人、寄件人姓名、寄件人邮编；定义数据项中投递反馈方式的取值史彦2009-2-19.25.给据邮件到达/发出信息-电子化支局系统将本节改为给据邮件发出电子化支局信息,删除到达信息的描述史彦2009-2-1926.给据邮件到达/封发/发出信息将接口说明由给据邮件的到达信息接口、发出信息接口改为给据邮件的总包到达信息接口、发出信息接口史彦2009-2-1927.给据邮件到达投递局信息将本节改为给据邮件到达电子化支局/投递局信息,将给据邮件到达电子化支局信息合并到该接口中史彦2009-2-1928.机构代码信息删除该接口数据项描述中的机构大类、机构小类、机构种类；将所属省份的字段长度改为8位史彦2009-2-1929.第3章服务调用类接口在第3章每一节的接口数据项描述中的上行信息内容中增加一个数据项查询方标识,用于进一步明确查询的来源史彦2009-2-1930.给据邮件发出信息-电子化支局系统删除该接口数据项描述中的处理动作史彦2009-2-19.31.给据邮件收寄信息、投递信息、到达电子化支局信息删除这些接口的数据项描述中的邮件ID字段史彦2009-2-2532.4.2,4.3消息头格式、差错处理在消息头中增加一个域为省份代码,用于标识报文发送省史彦2009-2-2533.批量异常报文格式在异常报文体结构增加记录头#ERRO|史彦2009-2-2534.第2章、第3章、第4章调整各章之间的顺序将第四章的内容提前变为第二章,原第二章、第三章依次变为第三章、第四章史彦2009-3-435.消息头的定义说明消息头为报文控制信息,也为报文临时文件名史彦2009-3-436.2.5TOPIC和QUEUE的设置根据信息局提供的TOPIC和QUEUE的设置表,更新本文档中的队列设置史彦2009-3-437.2.4通信函数增加通信函数的说明史彦2009-3-438.数据传输类接口实现方式将实现方式改为TOPIC+QUEUE方式,同时增加相关说明史彦2009-3-439.1.4报文规范将本节内容删除,合并到2.2.1节中史彦2009-3-440.收寄信息报文数据项描述修改数据项18、19的说明,强调信息以/结尾史彦2009-3-5.41.异常报文将异常报文格式的报文头中的接口单元编码长度改为11位定长,版本号长度改为6位定长,报文头长度改为43位、报文尾标识改为END史彦2009-3-542.2.4下发回执增加下发回执一节内容史彦2009-3-643.下发回执将下发回执的数据项描述中第四项的字段长度改为CHAR史彦2009-3-1144.投递信息报文的数据项描述将第13项签收人证件类别、第17项收件人证件类别的长度改为VARCHAR,说明这两项的内容为中文史彦2009-3-1845.4服务调用类接口修订了原来五个接口相关方法参数2的描述；增加了五个新的接口分别是相关查询的对内的方法。韩振宇2009-3-2346.5服务调用类接口十个方法参数1描述的补充；邮件批量查询对内以及对外方法参数3描述补充；下行相关属性的英文定义。韩振宇2009-4-1447.4服务调用接口增加字段类型和长度的描述胡运涛2009-5-19.48.大客户邮件当前状态的邮件清单信息按批次查询-查询条件大客户邮件妥投情况统计信息按批次查询-查询条件标题均增加为按批次/收寄日期查询,并在报文数据项中增加了一个数据项统计方式,用以标识是按批次进行统计还是按收寄日期进行统计史彦2009-7-1449.大客户邮件当前状态的邮件清单信息按批次查询-查询结果大客户邮件妥投情况统计信息按批次查询-查询结果标题均增加为按批次/收寄日期查询,并将原报文数据项大客户批次,修改为大客户批次/收寄日期史彦2009-7-1450.给据邮件投递信息在本节的数据项描述中增加一个字段投递信息录入时间,该字段仅对投递系统发来的投递信息报文有效,且投递系统的投递信息报文中该字段为必填史彦2009-8-24.51.与电子化支局之间的机构代码信息与电子化支局之间增加一个机构代码的接口。史彦2009-9-4.第第 1 章章 总体说明总体说明1.1 接口目的接口目的本文定义了电子化支局系统、中心局系统、投递系统与给据邮件跟踪查询系统之前相互传递的、与给据邮件处理相关的生产作业信息及相关的基础信息的接口规范,用以满足给据邮件跟踪查询系统的全程跟踪查询的需求。本文中定义的接口包括了数据传输类及服务调用类两类接口。本文规定了信息广播报文的使用规则、业务数据元和报文规范,还规定了相关接口的数据格式、通讯格式和交换方式。1.2 接口实现方式接口实现方式1.2.1 数据传输类接口实现方式数据传输类接口实现方式采用基于 JMS 协议的 ESB 消息中间件作为底层的通讯平台,通过异步方式完成上传、下传报文的批量传送,异常与错误会以下传报文形式返回。给据邮件跟踪查询系统和各相关系统都作为客户端访问 ESB 服务器,报文数据采用ASCII 码编码,调用 JMS 传输接口时将传输方式设置为二进制形式,报文交换采用 JMS 消息主题TOPIC+消息队列QUEUE 的方式。给据邮件跟踪查询系统提供给各相关系统的报文,统一发送到一个指定的 TOPIC 上,由ESB 服务器根据报文类型分发到不同的队列中,供各相关系统读取；各相关系统提供给给据邮件跟踪查询系统的报文,统一发送到另一个指定的 TOPIC 上,同样由 ESB 服务器根据报文类型分发到不同的队列中,供给据邮件跟踪查询系统读取。主题及队列的定义见本文 2.5 一节。给据邮件跟踪查询系统提供封装的 ESB 接口 C API 函数,供各相关系统调用,报文的打包、压缩、校验与可靠传送由给据邮件跟踪查询系统提供的 API 函数自动完成,运行环境要求是 Linux 操作系统32 位,64 位均可,Oracle10 客户端。.1.2.2 服务调用类接口实现方式服务调用类接口实现方式1.3 信息种类信息种类1.3.1 数据传输类接口的信息种类数据传输类接口的信息种类序号序号关联系统关联系统接口名称接口名称接口说明接口说明给据邮件收寄信息电子化支局系统向给据邮件跟踪查询系统传送收寄信息给据邮件投递信息电子化支局系统向给据邮件跟踪查询系统传送投递信息给据邮件发出信息电子化支局系统向给据邮件跟踪查询系统传送邮件发出信息给据邮件到达信息电子化支局系统向给据邮件跟踪查询系统传送邮件到达信息大客户邮件当前状态的邮件清单信息按批次查询的查询条件电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询条件信息大客户邮件妥投情况统计信息按批次查询的查询条件电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件妥投情况统计信息的查询条件信息大客户邮件当前状态的邮件清单信息按批次查询的查询结果给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询结果信息大客户邮件妥投情况统计信息按批次查询的查询结果给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件妥投情况统计信息的查询结果信息收寄邮件种类电子化支局系统向给据邮件跟踪查询系统传送收寄邮件种类基础信息1电子化支局系统行政区划电子化支局系统向给据邮件跟踪查询系统传送行政区划基础信息.未妥投原因电子化支局系统向给据邮件跟踪查询系统传送未妥投原因基础信息未妥投下一步动作电子化支局系统向给据邮件跟踪查询系统传送未妥投下一步动作基础信息客户信息电子化支局系统向给据邮件跟踪查询系统传送客户信息机构信息电子化支局系统向给据邮件跟踪查询系统传送机构代码基础信息给据邮件的总包发出信息中心局生产作业系统在封发局向给据邮件跟踪查询系统传送总包的发出信息给据邮件总包及邮件封发信息中心局生产作业系统在封发局向给据邮件跟踪查询系统传送总包及邮件封发信息给据邮件的总包到达信息中心局生产作业系统在接收局向给据邮件跟踪查询系统传送总包的到达信息2中心局生产作业系统机构信息中心局向给据邮件跟踪查询系统传送机构代码信息给据邮件投递信息投递系统向给据邮件跟踪查询系统传送投递信息3投递系统给据邮件到达投递局信息投递系统向给据邮件跟踪查询系统传送邮件到达投递局信息1.3.2 服务调用类接口的信息种类服务调用类接口的信息种类序号序号接口名称接口名称接口说明接口说明1邮件当前状态查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件当前状态查询接口的服务调用2邮件全程跟踪查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件全程跟踪查询接口的服务调用3邮件收寄信息查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件收寄信息查询接口的服务调用4邮件投递信息查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件投递信息查询接口的服务调用5邮件批量查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件批量.查询接口的服务调用.第第 2 章章 传输规范传输规范本接口规范定义的报文均采用本章规定的传输规范进行数据传输。2.1 传输机制传输机制(1)报文传输采用 JMS 消息机制。(2)报文格式采用文本格式。(3)报文传输方式采用二进制方式传输。(4)报文交换方式采用 JMS 消息 TOPIC+QUEUE 方式。(5)报文的接收方和发送方均需遵守本章规定的传输规范。2.2 正常报文正常报文2.2.1 总体说明总体说明(1) 批量正常报文每次数据交换都由两部分内容组成：控制消息和报文。(2) 每个报文都有一个控制消息,控制消息用于对报文的唯一标识,包含报文的控制信息,控制消息可用做临时报文文件的文件名,格式定义见。(3) 报文由报文头、报文体、报文尾三部分组成,格式定义见3.2及3.3各节中的报文规范部分。(4) 对于不需要拆分的报文,其控制消息中的报文序号为000；(5) 每个报文由若干个完整的记录组成,记录数上限值为 9999,超过 9999 需要拆分报文。拆报文的方式有三种：第一种：对于关联性不强的报文,可以按照 9999 条限制拆分为多个独立的报文,即各个报文控制消息中的消息序号不同,而报文序号都为000；第二种：对于报文内部关联性很强,需要保证一批数据完整性的报文,可以按照9999 条的报文记录上限拆分报文,对于各个拆分报文的控制消息中的消息序号要保持一致,而控制消息中的报文序号需要从001开始增加,即第一包为001,第二包为002,对于同一组的最后一个报文控制消息中的报文序号为999,表示一组报文结束。(6) 报文内信息分行存储,行结束符为换行符0 x0a,报文中第一行为报文头#HEAD开头,第二行开始为报文体,最后一行为报文尾#END 开头。(7) 每条记录中的域以竖线|分隔,最后一个报文域后也需加|,对于可选数据项即.使没有数据内容也要在报文中占位,即也须以|分隔；(8) 日期时间类型的数据格式：YYYYMMDDHH24MISS；(9) 数值类型的信息内容若有小数或负号需填写小数点或负号,小数点前后必须有数值,不允许出现1.或.12；(10)报文每个域的长度不能长于接口单元中规定的接口数据项的长度；(11)报文每个域中不能含有 |、回车符0 x0d两种字符。2.2.2 正常报文控制消息格式正常报文控制消息格式消息头说明：消息头长度为 51 个字节。以电子化支局系统到给据邮件跟踪查询系统的接口单元为例：PEO_RIT_COL_9999_11_20090301_210101_0000002_000_DAT1)接口单元为：PEO_RIT_COL。2)给据邮件跟踪查询系统中的节点编号为：9999。3)省份代码为：11北京4)发送日期为：20090301。5)发送时间为：210101。6)消息序号为： 0000002,总第 2 个消息。7)报文序号为： 000,不需要拆分的报文统一用000作为报文序号。8)报文类型： DAT 表示接口数据报文。序序号号域名称域名称长度长度示例示例取值取值说明说明1.接口单元代码CHARPEO_RIT_COL定长 11 位,具体取值参见 2.1 节的描述接口单元代码编码规则参见2.1节。2.节点代码CHAR99994 位字符,给据邮件跟踪查询系统为 9999,不足 4 位后面补 03.省份代码CHAR11两位字符,中心局系统固定为994.发送日期CHAR200903018 位字符,表示报文生成日期,格式为：YYYYMMDD接口单元的发送日期,和生成日期保持一致。5.发送时间CHAR2101016 位字符,表示报文生成时间,格式为:24HHMMSS原则上报文生成后应立即传送。.2.3 差错处理差错处理2.3.1 总体说明总体说明1.批量异常报文由报文接收方产生,并返回给发送方,用于双方对数据的核对与后续处理。2.为了便于错误查找与核对,异常报文和正常报文一一对应,即每一个正常报文产生错误都会产生一个对应的异常报文。3.批量异常报文每次交换都由两部分内容组成：控制消息和报文。4.批量异常报文的控制消息为将其对应批量正常报文控制消息后三位报文类型由DAT 改为 ERR 而得到,控制消息其他部分不变。5.批量异常报文不需要根据条数或数据量进行拆包。6.其他格式说明请参加第二章 数据传输类接口。2.3.2 批量异常报文控制消息格式批量异常报文控制消息格式批量异常报文消息头格式为：接口单元代码11_节点代码4 _省份代码2_发送日期8_发送时间6 _消息序号7_报文序号3_报文类型3。异常报文的消息头不需要新产生,异常报文消息头由其对应的正常报文消息头后三位报文类型,DAT 改为 ERR 而得到。如：6.消息序号CHAR00000027 位,取值范围为：00000019999999用于消息唯一标识,要求在 3 个月内消息保持唯一,各相关系统可以根据自己情况自行定义,建议使用取值说明里的顺序。7.报文序号CHAR0003 位,取值分为三类：000001-998999对于不需要拆包的报文,本域始终为000,对于需要拆包的报文,第一包本域为001,以后包依次增加,最后一个包为999代表整个消息结束。8.报文类型CHARDAT3 位字符,表示消息类型DAT：表示接口正常数据消息.正常报文消息头PEO_RIT_COL_节点号码_省份代码_20090301_210101_0000002_000_DAT对应异常报文消息头PEO_RIT_COL_节点号码_省份代码_20090301_210101_0000002_000_ERR2.3.3 数据项描述数据项描述序号序号信息项信息项格式格式示例示例说明说明1.出错记录号NUMBER4873批量正常报文中对应出错的行号计算行号时不包括报文头和报文体,报文级错误为 0。2.子表类型代码VARCHARCOL为正常报文中错误记录行的第一个域的内容子表类型代码。3.错误类别CHARMM：报文级错误R：记录级错误L：逻辑级错误4.错误代码CHAR缺省为：0000005.错误处理结果VARCHAR1:丢弃报文2:丢弃数据行3:以缺省值代替出错数据项6.错误描述信息VARCHAR与出错信息相关的描述信息2.3.4 批量异常报文格式批量异常报文格式 报文头报文头 结构：结构：#HEAD|接口单元代码|版本号|报文生成日期|报文生成时间|增全量标志|信息项说明：信息项说明：标识头5 位定长 固定为#HEAD接口单元代码11 位定长为其对应批量正常报文的接口单元代码版本号格式为：V1.0,如：01,不足两位前面补0,以给据邮件跟踪查询系统与各相关系统的接口规范版本号为准。报文生成日期8 为定长格式为：YYYYMMDD,如 20060518报文生成时间格式为：HHMMSS, 如 230201报文头为报文第一行,以#HEAD开头。.增全量标志1 位定长增全量标志,缺省为:A报文头中各域以|进行分割,最后一个域结尾也需要加| 。报文头长度共为 43 位。报文体报文体必要必要, ,根据对应正常报文数据而定根据对应正常报文数据而定出错信息出错信息结构：结构：#ERRO|出错记录号|子表类型代码|错误类别|错误处理结果|错误号|错误描述信息|报文尾报文尾 #END|总行数|报文最后一行,以#END开头,总行数为包括报文头、报文体、报文尾在内的行数。2.3.5 报文体填写说明报文体填写说明1.对于报文级错误：1)异常返回报文只包括一条记录。2)出错记录号为：0。3)子表类型代码为：接口单元代码后四位。4)错误类别：M。5)错误代码：根据具体的约定填写。6)错误处理结果：丢弃报文。7)错误信息描述：错误代码的相应说明。2.对于记录级和逻辑级错误：1)一条正常报文原始记录可能对应多条错误信息。2)出错记录号为：批量正常报文中对应出错的行号。3)子表类型代码为：为正常报文中错误记录行的第一个域的内容子表类型代码。4)错误类别：R,L。5)错误代码：根据约定填写。6)错误处理结果：根据具体的约定。7)错误信息描述：错误代码的相应说明。.2.4 下发信息回执下发信息回执2.4.1 接口报文说明接口报文说明本接口用于发送给据邮件跟踪查询系统对各相关系统的下发报文的回执信息,本报文的发起方为给据邮件跟踪查询系统,接收方为电子化支局系统、中心局系统及投递系统。当给据邮件跟踪查询系统收到各相关系统发送的报文之后,通过发送回执的方式告知对方相应报文已接收。本回执只作为报文接收的确认,以备日后双方核对,后续处理成功与否不在其中反映。2.4.2 接口报文传送频次接口报文传送频次给据邮件跟踪查询系统收到下发报文后立即将此回执上传各相关系统。2.4.3 下发回执报文控制消息格式下发回执报文控制消息格式下发回执报文消息头格式为：接口单元代码11_节点代码4 _省份代码2_发送日期8_发送时间6 _消息序号7_报文序号3_报文类型3。下发回执报文的消息头不需要新产生,由其对应的正常报文消息头后三位报文类型,DAT 改为 RCT 而得到。如：正常报文消息头PEO_RIT_COL_节点号码_省份代码_20090301_210101_0000002_000_DAT对应回执报文消息头PEO_RIT_COL_节点号码_省份代码_20090301_210101_0000002_000_RCT2.4.4 数据项描述数据项描述序号序号信息项信息项格式格式示例示例必要必要/可选可选说明说明1.接口单元名称CHARPEO_RIT_COLM接口单元名2.消息序号CHAR0000123M总第 123 个消息3.报文文件个数NUMBER10M本消息数据拆分成的报文文件个数4.最后接收文件名CHARPEO_RIT_COL_节点号码_省份代码_20090301_210101_M给据邮件跟踪查询系统接收的报文中消息序号对应的最后一个文件名.0000002_000_DAT5.接收记录数NUMBER100M给据邮件跟踪查询系统接收各系统的报文中的消息序号对应的记录数6.接口报文接收时间CHAR20080101124115M给据邮件跟踪查询系统接收到报文的时间7.回执发送时间CHAR20070814124515M给据邮件跟踪查询系统发送回执的时间8.备注VARCHARC预留2.4.5 报文格式报文格式报文头报文头结构：结构：#HEAD|接口单元代码|版本号|报文生成日期|报文生成时间|增全量标志|信息项说明：信息项说明：标识头5 位定长 固定为#HEAD接口单元代码11 位定长PEO_RIT_COL版本号格式为：V1.0,如：01,不足两位前面补0,以给据邮件跟踪查询系统与各相关系统的接口规范版本号为准。报文生成日期8 为定长 格式为：YYYYMMDD,如 20080101报文生成时间格式为：HHMMSS, 如 230201增全量标志1 位字符,表示传输的是增量数据还是全量数据,I：表示全量数据,A：表示增量数据。对于全量需要拆包的接口报文,第个包的接口标志为：I,后续包的接口标志为：A。全量标志需慎重,需要在双方约定情况下使用,一般情况下本标志为:A。报文头中各域以|进行分割,最后一个域结尾也需要加| 。报文头长度共为 43 位。报文头为报文第一行,以#HEAD开头。报文体报文体必要必要, ,最多重复最多重复 99999999 次次接收信息接收信息结构：结构：#RCPT|接口单元名称|消息序号|报文文件个数|最后接收文件名|接收记录数|接口报文接收时间|回执发送时间|备注|报文尾报文尾 .#END|总行数|报文最后一行,以#END开头,总行数为包括报文头、报文体、报文尾在内的行数。2.5 报文通信函数说明报文通信函数说明初始化结构变量函数初始化结构变量函数初始化结构变量函数tibems_status initTibemsInfo函数名称：initTibemsInfo功能：为结构变量 tibInfo 赋值,记录连接 tibco 服务器的所需的信息参数 1：tibInfo说明：初始化静态结构变量数据发送函数数据发送函数数据发送函数tibems_status tibemsSndMesg函数名称：tibemsSndMesg功能：报文发送参数 1：mesgFile参数 2：errInfo发送失败信息,为空则表示发送成功说明：数据发送函数数据接收函数数据接收函数数据接收函数tibems_status tibemsRcvMesgvoid ,TIBEMS_INFO tibInfo,char* errInfo函数名称：tibemsRcvMesg功能：数据接收参数 1：void 参数 2：tibInfo参数 3：errInfo说明：数据接收函数环境初始化函数环境初始化函数环境初始化函数tibems_status initTibemsEnv函数名称：initTibemsEnv功能：初始化 ESB 应用环境参数：tibEnv说明：ESB 应用环境初始化函数2.6 TOPIC 及及 QUEUE 的设置信息的设置信息系统系统方向方向类型类型TOPIC/QUEUETOPIC/QUEUE 名称名称信息类型信息类型转发参数转发参数参数取值参数取值给据向电子TOPIC大客户查询结果、TARGETRITRITPEOBJ.查询化支局系统、投递系统发送下发回执、错误报文RITPEOTJRITPEOHEBEIRITPEOSXRITPEONMGRITPEOLNRITPEOJLRITPEOHLJRITPEOSHRITPEOJSRITPEOZJRITPEOAHRITPEOFJRITPEOJXRITPEOSDRITPEOHENANRITPEOHBRITPEOHUNANRITPEOGDRITPEOGXRITPEOHAINANRITPEOCQRITPEOSCRITPEOGZRITPEOYNRITPEOXZRITPEOSHANXIRITPEOGSRITPEOQHRITPEONXRITPEOXJRITPTOBJRITPTOTJRITPTOHEBEIRITPTOSXRITPTONMGRITPTOLNRITPTOJLRITPTOHLJRITPTOSHRITPTOJSRITPTOZJRITPTOAHRITPTOFJRITPTOJX.RITPTOSDRITPTOHENANRITPTOHBRITPTOHUNANRITPTOGDRITPTOGXRITPTOHAINANRITPTOCQRITPTOSCRITPTOGZRITPTOYNRITPTOXZRITPTOSHANXIRITPTOGSRITPTOQHRITPTONXRITPTOXJRIT.COLLECT收寄信息RIT.DELIVERY投递信息RIT.INOUT邮件/总包到达、发出信息,邮件封发信息从各系统接收QUEUERIT.BASEINFO基础信息、下发回执、错误报文无无收寄信息TARGETRITCOLLECTQUEUE投递信息TARGETRITDELIVERYQUEUE邮件/总包到达、发出信息,邮件封发信息TARGETRITINOUTQUEUE各系统向给据邮件跟踪查询系统发送TOPIC基础信息、下发回执、错误报文TARGETRITBASEINFOQUEUERIT.PEO.BJ.RECEIVE 北京市支局系统 RIT.PEO.TJ.RECEIVE 天津市支局系统 CEIVE XX 省支局系统 RIT.PEO.SX.RECEIVE XX 省支局系统 RIT.PEO.NMG.RECEIVE XX 自治区支局系统 中心局系统、电子化支局系统、投递系统电子化QUEUERIT.PEO.LN.RECEI查询结果信息、下发回执、错误报文无XX 省支局系统 .VE RIT.PEO.JL.RECEIVE XX 省支局系统 RIT.PEO.HLJ.RECEIVE XX 省支局系统 RIT.PEO.SH.RECEIVE 上海市支局系统 RIT.PEO.JS.RECEIVE XX 省支局系统 RIT.PEO.ZJ.RECEIVE XX 省支局系统 RIT.PEO.AH.RECEIVE XX 省支局系统 RIT.PEO.FJ.RECEIVE XX 省支局系统 IVE XX 省支局系统 RIT.PEO.SD.RECEIVE XX 省支局系统 RIT.PEO.HENAN.RECEIVE XX 省支局系统 RIT.PEO.HB.RECEIVE XX 省支局系统 RIT.PEO.HUNAN.RECEIVE XX 省支局系统 RIT.PEO.GD.RECEIVE XX 省支局系统 RIT.PEO.GX.RECEIVE 广西壮族自治区支局系统 XX 省支局系统 RIT.PEO.CQ.RECEIVE XX 市支局系统 RIT.PEO.SC.RECEIVE XX 省支局系统 RIT.PEO.GZ.RECEIVE XX 省支局系统 EIVE XX 省支局系统 RIT.PEO.XZ.RECEIVE XX 自治区支局系统 XX 省支局系统 RIT.PEO.GS.RECEIVE XX 省支局系统 支局系统从给据邮件跟踪查询系统接收RIT.PEO.QH.RECEIVE XX 省支局系统 .RIT.PEO.NX.RECEIVE XX 支局系统 RIT.PEO.XJ.RECEIVE 新疆维吾尔自治区支局系统RIT.PTO.BJ.RECEIVE 北京市投递系统 RIT.PTO.TJ.RECEIVE 天津市投递系统 RIT.PTO.HEBEI.RECEIVE XX 省投递系统 RIT.PTO.SX.RECEIVE XX 省投递系统 RIT.PTO.NMG.RECEIVE XX 自治区投递系统 RIT.PTO.LN.RECEIVE XX 省投递系统 RIT.PTO.JL.RECEIVE XX 省投递系统 RIT.PTO.HLJ.RECEIVE XX 省投递系统 RIT.PTO.SH.RECEIVE 上海市投递系统 RIT.PTO.JS.RECEIVE XX 省投递系统 RIT.PTO.ZJ.RECEIVE XX 省投递系统 RIT.PTO.AH.RECEIVE XX 省投递系统 RIT.PTO.FJ.RECEIVE XX 省投递系统 RIT.PTO.JX.RECEIVE XX 省投递系统 RIT.PTO.SD.RECEIVE XX 省投递系统 RIT.PTO.HENAN.RECEIVE XX 省投递系统 RIT.PTO.HB.RECEIVE XX 省投递系统 RIT.PTO.HUNAN.RECEIVE XX 省投递系统 RIT.PTO.GD.RECEIVE XX 省投递系统 投递系统从给据邮件跟踪查询系统接收QUEUERIT.PTO.GX.RECEI下发回执、错误报文无广西壮族自治区.VE 投递系统 RIT.PTO.HAINAN.RECEIVEXX 省投递系统 RIT.PTO.CQ.RECEIVE XX 市投递系统 RIT.PTO.SC.RECEIVE XX 省投递系统 RIT.PTO.GZ.RECEIVE XX 省投递系统 RIT.PTO.YN.RECEIVE XX 省投递系统 RIT.PTO.XZ.RECEIVE XX 自治区投递系统 XX 省投递系统 RIT.PTO.GS.RECEIVE XX 省投递系统 RIT.PTO.QH.RECEIVE XX 省投递系统 RIT.PTO.NX.RECEIVE XX 投递系统 RIT.PTO.XJ.RECEIVE 新疆维吾尔自治区投递系统.第第 3 章章 数据传输类接口数据传输类接口3.1 接口单元编码规则接口单元编码规则接口单元编码规则为：源系统代码源系统代码3 位位_目的系统代码目的系统代码3 位位_信息种类代码信息种类代码3 位。位。电子化支局系统的系统代码 PEO,中心局系统的系统代码为 PCO,投递系统的系统代码为PTO,给据邮件跟踪查询系统的系统代码为 RIT。3.1.1 与电子化支局系统接口单元编码与电子化支局系统接口单元编码序号序号接口编码接口编码接口名称接口名称接口说明接口说明1.PEO_RIT_COL收寄信息电子化支局系统向给据邮件跟踪查询系统传送收寄信息2.PEO_RIT_DLV投递信息电子化支局系统向给据邮件跟踪查询系统传送投递信息3.PEO_RIT_IPS发出信息电子化支局系统向给据邮件跟踪查询系统传送邮件发出信息4.PEO_RIT_IPA到达信息电子化支局向系统给据邮件跟踪查询系统传送给据邮件到达信息5.PEO_RIT_CSC按批次查询大客户邮件当前状态的查询条件电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询条件信息6.PEO_RIT_DSC按批次查询大客户邮件妥投情况统计信息的查询条件电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件妥投情况统计信息的查询条件信息7.RIT_PEO_CSR按批次查询大客户邮件当前状态的查询结果给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询结果信息8.RIT_PEO_DSR按批次查询大客户邮件妥投情况统计信息的查询结果给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件妥投情况统计信息的查询结果信息.9.PEO_RIT_PKD收寄邮件种类电子化支局系统向给据邮件跟踪查询系统传送收寄邮件种类基础信息10.PEO