给据邮件跟踪查询系统和相关系统接口说明.doc
《给据邮件跟踪查询系统和相关系统接口说明.doc》由会员分享,可在线阅读,更多相关《给据邮件跟踪查询系统和相关系统接口说明.doc(96页珍藏版)》请在课桌文档上搜索。
1、.目录目录文档信息.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 下发回执报文控制消息格式.
2、18 数据项描述.18 报文格式.192.5 报文通信函数说明.202.6 TOPIC 及 QUEUE 的设置信息.20第 3 章 数据传输类接口.263.1 接口单元编码规则.26 与电子化支局系统接口单元编码.26 与中心局系统接口单元编码.27 与投递系统接口单元编码.273.2 生产数据类接口.28 给据邮件收寄信息.28 给据邮件投递信息.30 给据邮件总包发出信息-电子化支局.33 给据邮件总包到达/封发/发出信息-中心局系统.35 给据邮件到达电子化支局/投递局信息.38 大客户邮件当前状态的邮件清单信息按批次查询查询条件信息.40. 大客户邮件妥投情况统计信息按批次查询查询条件
3、信息.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 函数功能
4、.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 服务
5、 URL.70 函数功能.704.10 对内邮件批量查询服务调用接口.70 接口数据项描述.70 服务 URL.70 函数功能.70.文档信息文档信息编写者编写日期审核者审核日期批准人批准日期变更历史变更历史序号序号章节章节描述描述备注备注修改人修改人修改日期修改日期1.数据传输类接口删除:邮件备注接口史彦2009-1-082.与电子化支局系统接口单元编码删除:邮件备注接口史彦2009-1-083.邮件备注信息接口删除该节内容史彦2009-1-084.数据传输类接口在中心局系统中增加一个省份属性信息的接口史彦2009-1-125.与中心局系统接口单元编码增加一个省份属性信息的接口史彦2009-
6、1-126.省份属性信息增加有关省份属性信息基础信息的接口史彦2009-1-127.删除省份属性信息通过一次性导入的方式解决秦永叶2009-2-58.给据邮件总包到局/出局信息删除总包号信息增加处理局、处理局属性用于中心局系统标识是否为第一个获最后一个中心局秦永叶2009-2-5.9.大客户批次代码修改数据类型为VARCHAR20秦永叶2009-2-510.投递系统到达信息投递系统只能向给据邮件跟踪查询系统传送邮件到达信息,无法提供总包到达信息史彦2009-2-611.投递系统相关描述去掉与投递系统相关的描述史彦2009-2-612.投递系统给据邮件到局信息因投递系统只能提供给据邮件的到达信息
7、,无法提供邮件所属总包的到达信息,故对投递系统的给据邮件到局信息增加一节,单独进行描述史彦2009-2-613.数据结构、数据项说明、报文规范将本节数据结构、数据项说明、报文规范中总包的可重复次数改为9999,将报文规范中报文头最后一个域由邮件数量改为总包数量史彦2009-2-1014.数据传输类接口的信息种类在与中心局生产作业系统的接口中,增加了给据邮件封发信息的接口史彦2009-2-1615.与中心局系统接口单元编码将与中心局系统的到达/封发/出局三类接口信息合并为一个接口史彦2009-2-1616.与给据邮件到达/发出信息接口将该接口改为给据邮件到达/发出电子化支局信息史彦2009-2-
8、16.17.与中心局系统的各类接口增加一个接口为给据邮件到达/发出中心局信息及中心局系统的邮件封发信息史彦2009-2-1618.给据邮件投递信息中的投递邮件性质对投递邮件性质做如下规定:0-包裹单,1-实物史彦2009-2-1619.第4章传输规范增加一章内容为传输规范史彦2009-2-1720.1.2接口实现方式增加一节内容为接口实现方式史彦2009-2-1921.数据传输类接口将与电子化支局系统的给据邮件到达信息改为给据邮件到达信息;将与中心局系统的给据邮件到达信息及给据邮件发出信息改为给据邮件的总包到达信息及给据邮件的总包发出信息史彦2009-2-1922.与电子化支局系统接口将到达信
9、息的接口说明由传送给据邮件到达信息改为传送给据邮件到达信息史彦2009-2-1923.与中心局系统接口将到达/封发/发出信息的接口说明由传送邮件的到达/发出信息改为传送总包的到达/发出信息史彦2009-2-1924.给据邮件收寄信息接口去掉该接口的数据项描述中的寄件人地址、寄件人、寄件人姓名、寄件人邮编;定义数据项中投递反馈方式的取值史彦2009-2-19.25.给据邮件到达/发出信息-电子化支局系统将本节改为给据邮件发出电子化支局信息,删除到达信息的描述史彦2009-2-1926.给据邮件到达/封发/发出信息将接口说明由给据邮件的到达信息接口、发出信息接口改为给据邮件的总包到达信息接口、发出
10、信息接口史彦2009-2-1927.给据邮件到达投递局信息将本节改为给据邮件到达电子化支局/投递局信息,将给据邮件到达电子化支局信息合并到该接口中史彦2009-2-1928.机构代码信息删除该接口数据项描述中的机构大类、机构小类、机构种类;将所属省份的字段长度改为8位史彦2009-2-1929.第3章服务调用类接口在第3章每一节的接口数据项描述中的上行信息内容中增加一个数据项查询方标识,用于进一步明确查询的来源史彦2009-2-1930.给据邮件发出信息-电子化支局系统删除该接口数据项描述中的处理动作史彦2009-2-19.31.给据邮件收寄信息、投递信息、到达电子化支局信息删除这些接口的数据
11、项描述中的邮件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通信
12、函数增加通信函数的说明史彦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.下发回执将下发回执的数据项描述中第四项的字段长度改为CHA
13、R史彦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.大客户邮件当前状态的邮件清单信息按批次查询-查询条件大客户邮件妥投情况统计信息按
14、批次查询-查询条件标题均增加为按批次/收寄日期查询,并在报文数据项中增加了一个数据项统计方式,用以标识是按批次进行统计还是按收寄日期进行统计史彦2009-7-1449.大客户邮件当前状态的邮件清单信息按批次查询-查询结果大客户邮件妥投情况统计信息按批次查询-查询结果标题均增加为按批次/收寄日期查询,并将原报文数据项大客户批次,修改为大客户批次/收寄日期史彦2009-7-1450.给据邮件投递信息在本节的数据项描述中增加一个字段投递信息录入时间,该字段仅对投递系统发来的投递信息报文有效,且投递系统的投递信息报文中该字段为必填史彦2009-8-24.51.与电子化支局之间的机构代码信息与电子化支局
15、之间增加一个机构代码的接口。史彦2009-9-4.第第 1 章章 总体说明总体说明1.1 接口目的接口目的本文定义了电子化支局系统、中心局系统、投递系统与给据邮件跟踪查询系统之前相互传递的、与给据邮件处理相关的生产作业信息及相关的基础信息的接口规范,用以满足给据邮件跟踪查询系统的全程跟踪查询的需求。本文中定义的接口包括了数据传输类及服务调用类两类接口。本文规定了信息广播报文的使用规则、业务数据元和报文规范,还规定了相关接口的数据格式、通讯格式和交换方式。1.2 接口实现方式接口实现方式1.2.1 数据传输类接口实现方式数据传输类接口实现方式采用基于 JMS 协议的 ESB 消息中间件作为底层的
16、通讯平台,通过异步方式完成上传、下传报文的批量传送,异常与错误会以下传报文形式返回。给据邮件跟踪查询系统和各相关系统都作为客户端访问 ESB 服务器,报文数据采用ASCII 码编码,调用 JMS 传输接口时将传输方式设置为二进制形式,报文交换采用 JMS 消息主题TOPIC+消息队列QUEUE 的方式。给据邮件跟踪查询系统提供给各相关系统的报文,统一发送到一个指定的 TOPIC 上,由ESB 服务器根据报文类型分发到不同的队列中,供各相关系统读取;各相关系统提供给给据邮件跟踪查询系统的报文,统一发送到另一个指定的 TOPIC 上,同样由 ESB 服务器根据报文类型分发到不同的队列中,供给据邮件
17、跟踪查询系统读取。主题及队列的定义见本文 2.5 一节。给据邮件跟踪查询系统提供封装的 ESB 接口 C API 函数,供各相关系统调用,报文的打包、压缩、校验与可靠传送由给据邮件跟踪查询系统提供的 API 函数自动完成,运行环境要求是 Linux 操作系统32 位,64 位均可,Oracle10 客户端。.1.2.2 服务调用类接口实现方式服务调用类接口实现方式1.3 信息种类信息种类1.3.1 数据传输类接口的信息种类数据传输类接口的信息种类序号序号关联系统关联系统接口名称接口名称接口说明接口说明给据邮件收寄信息电子化支局系统向给据邮件跟踪查询系统传送收寄信息给据邮件投递信息电子化支局系统
18、向给据邮件跟踪查询系统传送投递信息给据邮件发出信息电子化支局系统向给据邮件跟踪查询系统传送邮件发出信息给据邮件到达信息电子化支局系统向给据邮件跟踪查询系统传送邮件到达信息大客户邮件当前状态的邮件清单信息按批次查询的查询条件电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询条件信息大客户邮件妥投情况统计信息按批次查询的查询条件电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件妥投情况统计信息的查询条件信息大客户邮件当前状态的邮件清单信息按批次查询的查询结果给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询结果信
19、息大客户邮件妥投情况统计信息按批次查询的查询结果给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件妥投情况统计信息的查询结果信息收寄邮件种类电子化支局系统向给据邮件跟踪查询系统传送收寄邮件种类基础信息1电子化支局系统行政区划电子化支局系统向给据邮件跟踪查询系统传送行政区划基础信息.未妥投原因电子化支局系统向给据邮件跟踪查询系统传送未妥投原因基础信息未妥投下一步动作电子化支局系统向给据邮件跟踪查询系统传送未妥投下一步动作基础信息客户信息电子化支局系统向给据邮件跟踪查询系统传送客户信息机构信息电子化支局系统向给据邮件跟踪查询系统传送机构代码基础信息给据邮件的总包发出信息中心局生产作业系统
20、在封发局向给据邮件跟踪查询系统传送总包的发出信息给据邮件总包及邮件封发信息中心局生产作业系统在封发局向给据邮件跟踪查询系统传送总包及邮件封发信息给据邮件的总包到达信息中心局生产作业系统在接收局向给据邮件跟踪查询系统传送总包的到达信息2中心局生产作业系统机构信息中心局向给据邮件跟踪查询系统传送机构代码信息给据邮件投递信息投递系统向给据邮件跟踪查询系统传送投递信息3投递系统给据邮件到达投递局信息投递系统向给据邮件跟踪查询系统传送邮件到达投递局信息1.3.2 服务调用类接口的信息种类服务调用类接口的信息种类序号序号接口名称接口名称接口说明接口说明1邮件当前状态查询接口实现关联系统与给据邮件跟踪查询系
21、统之间的邮件当前状态查询接口的服务调用2邮件全程跟踪查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件全程跟踪查询接口的服务调用3邮件收寄信息查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件收寄信息查询接口的服务调用4邮件投递信息查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件投递信息查询接口的服务调用5邮件批量查询接口实现关联系统与给据邮件跟踪查询系统之间的邮件批量.查询接口的服务调用.第第 2 章章 传输规范传输规范本接口规范定义的报文均采用本章规定的传输规范进行数据传输。2.1 传输机制传输机制(1)报文传输采用 JMS 消息机制。(2)报文格式采用文本格式。(3)报文传输方式
22、采用二进制方式传输。(4)报文交换方式采用 JMS 消息 TOPIC+QUEUE 方式。(5)报文的接收方和发送方均需遵守本章规定的传输规范。2.2 正常报文正常报文2.2.1 总体说明总体说明(1) 批量正常报文每次数据交换都由两部分内容组成:控制消息和报文。(2) 每个报文都有一个控制消息,控制消息用于对报文的唯一标识,包含报文的控制信息,控制消息可用做临时报文文件的文件名,格式定义见。(3) 报文由报文头、报文体、报文尾三部分组成,格式定义见3.2及3.3各节中的报文规范部分。(4) 对于不需要拆分的报文,其控制消息中的报文序号为000;(5) 每个报文由若干个完整的记录组成,记录数上限
23、值为 9999,超过 9999 需要拆分报文。拆报文的方式有三种:第一种:对于关联性不强的报文,可以按照 9999 条限制拆分为多个独立的报文,即各个报文控制消息中的消息序号不同,而报文序号都为000;第二种:对于报文内部关联性很强,需要保证一批数据完整性的报文,可以按照9999 条的报文记录上限拆分报文,对于各个拆分报文的控制消息中的消息序号要保持一致,而控制消息中的报文序号需要从001开始增加,即第一包为001,第二包为002,对于同一组的最后一个报文控制消息中的报文序号为999,表示一组报文结束。(6) 报文内信息分行存储,行结束符为换行符0 x0a,报文中第一行为报文头#HEAD开头,
24、第二行开始为报文体,最后一行为报文尾#END 开头。(7) 每条记录中的域以竖线|分隔,最后一个报文域后也需加|,对于可选数据项即.使没有数据内容也要在报文中占位,即也须以|分隔;(8) 日期时间类型的数据格式:YYYYMMDDHH24MISS;(9) 数值类型的信息内容若有小数或负号需填写小数点或负号,小数点前后必须有数值,不允许出现1.或.12;(10)报文每个域的长度不能长于接口单元中规定的接口数据项的长度;(11)报文每个域中不能含有 |、回车符0 x0d两种字符。2.2.2 正常报文控制消息格式正常报文控制消息格式消息头说明:消息头长度为 51 个字节。以电子化支局系统到给据邮件跟踪
25、查询系统的接口单元为例: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
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 邮件 跟踪 查询 系统 相关 接口 说明
链接地址:https://www.desk33.com/p-19205.html