给据邮件跟踪查询系统及相关系统接口说明Word格式文档下载.docx
《给据邮件跟踪查询系统及相关系统接口说明Word格式文档下载.docx》由会员分享，可在线阅读，更多相关《给据邮件跟踪查询系统及相关系统接口说明Word格式文档下载.docx（123页珍藏版）》请在冰豆网上搜索。
2.2.3
给据邮件（总包）到局/出局信息
删除总包号信息
增加处理局、处理局属性（用于中心局系统标识是否为第一个获最后一个中心局）
9.
2.2.1
2.2.4
2.2.5
2.2.6
2.2.7
大客户批次代码
修改数据类型为VARCHAR（20）
10.
2.1.3
投递系统到达信息
投递系统只能向给据邮件跟踪查询系统传送邮件到达信息，无法提供总包到达信息
2009-2-6
11.
投递系统相关描述
去掉与投递系统相关的描述
12.
投递系统给据邮件到局信息
因投递系统只能提供给据邮件的到达信息，无法提供邮件所属总包的到达信息，故对投递系统的“给据邮件到局信息”增加一节，单独进行描述
13.
数据结构、数据项说明、报文规范
将本节数据结构、数据项说明、报文规范中总包的可重复次数改为“9999”，将报文规范中报文头最后一个域由“邮件数量”改为“总包数量”
2009-2-10
14.
数据传输类接口的信息种类
在与中心局生产作业系统的接口中，增加了“给据邮件封发信息”的接口
2009-2-16
15.
将与中心局系统的到达/封发/出局三类接口信息合并为一个接口
16.
与给据邮件（总包）到达/发出信息接口
将该接口改为“给据邮件（总包）到达/发出电子化支局信息”
17.
与中心局系统的各类接口
增加一个接口为“给据邮件（总包）到达/发出中心局信息及中心局系统的邮件封发信息”
18.
2.2.2
给据邮件投递信息中的投递邮件性质
对投递邮件性质做如下规定：
0--包裹单，1--实物
19.
第4章
传输规范
增加一章内容为“传输规范”
2009-2-17
20.
1.2
接口实现方式
增加一节内容为“接口实现方式”
2009-2-19
21.
1.3.1
将与电子化支局系统的“给据邮件（总包）到达信息”改为“给据邮件到达信息”；
将与中心局系统的“给据邮件（总包）到达信息”及“给据邮件（总包）发出信息”改为“给据邮件的总包到达信息”及“给据邮件的总包发出信息”
22.
与电子化支局系统接口
将到达信息的接口说明由“传送给据邮件（总包）到达信息”改为“传送给据邮件到达信息”
23.
与中心局系统接口
将到达/封发/发出信息的接口说明由“传送邮件（总包）的到达/发出信息”改为“传送总包的到达/发出信息”
24.
给据邮件收寄信息接口
去掉该接口的数据项描述中的寄件人地址、寄件人联系电话、寄件人姓名、寄件人邮编；
定义数据项中“投递反馈方式”的取值
25.
给据邮件（总包）到达/发出信息--电子化支局系统
将本节改为给据邮件（总包）发出电子化支局信息，删除到达信息的描述
26.
给据邮件（总包）到达/封发/发出信息
将接口说明由“给据邮件（总包）的到达信息接口、发出信息接口”改为“给据邮件的总包）到达信息接口、发出信息接口”
27.
给据邮件到达投递局信息
将本节改为“给据邮件到达电子化支局/投递局信息”，将给据邮件到达电子化支局信息合并到该接口中
28.
2.3.6
机构代码信息
删除该接口数据项描述中的“机构大类”、“机构小类”、“机构种类”；
将“所属省份”的字段长度改为8位
29.
第3章
服务调用类接口
在第3章每一节的接口数据项描述中的“上行信息内容”中增加一个数据项“查询方标识”，用于进一步明确查询的来源
30.
给据邮件（总包）发出信息--电子化支局系统
删除该接口数据项描述中的“处理动作”
31.
2.2.1，2.2.2，2.2.5
给据邮件收寄信息、投递信息、到达电子化支局信息
删除这些接口的数据项描述中的“邮件ID”字段
2009-2-25
32.
4.2，4.3
消息头格式、差错处理
在消息头中增加一个域为“省份代码”，用于标识报文发送省
33.
4.3.3
批量异常报文格式
在异常报文体结构增加记录头“#ERRO|”
34.
第2章、第3章、第4章
调整各章之间的顺序
将第四章的内容提前变为第二章，原第二章、第三章依次变为第三章、第四章
2009-3-4
35.
消息头的定义
说明消息头为报文控制信息，也为报文临时文件名
36.
2.5
TOPIC和QUEUE的设置
根据信息局提供的TOPIC和QUEUE的设置表，更新本文档中的队列设置
37.
2.4
通信函数
增加通信函数的说明
38.
数据传输类接口实现方式
将实现方式改为TOPIC+QUEUE方式，同时增加相关说明
39.
1.4
报文规范
将本节内容删除，合并到2.2.1节中
40.
3.2.1.4
收寄信息报文数据项描述
修改数据项18、19的说明，强调信息以“/”结尾
2009-3-5
41.
异常报文
将异常报文格式的报文头中的接口单元编码长度改为“11位定长”，版本号长度改为“6位定长”，报文头长度改为43位、报文尾标识改为“END”
42.
下发回执
增加下发回执一节内容
2009-3-6
43.
2.4.4
将下发回执的数据项描述中第四项的字段长度改为CHAR（51）
2009-3-11
44.
3.2.2.4
投递信息报文的数据项描述
将第13项签收人证件类别、第17项收件人证件类别的长度改为VARCHAR（10），说明这两项的内容为中文
2009-3-18
45.
4
修订了原来五个接口相关方法参数2的描述；
增加了五个新的接口分别是相关查询的对内的方法。
韩振宇
2009-3-23
46.
5
十个方法参数1描述的补充；
邮件批量查询对内以及对外方法参数3描述补充；
下行相关属性的英文定义。
2009-4-14
47.
服务调用接口
增加字段类型和长度的描述
胡运涛
2009-5-19
48.
3.2.6,3.2.7
大客户邮件当前状态的邮件清单信息按批次查询--查询条件
大客户邮件妥投情况统计信息按批次查询--查询条件
标题均增加为“按批次/收寄日期查询”，并在报文数据项中增加了一个数据项“统计方式”，用以标识是按批次进行统计还是按收寄日期进行统计
2009-7-14
49.
3.2.8，3.2.9
大客户邮件当前状态的邮件清单信息按批次查询--查询结果
大客户邮件妥投情况统计信息按批次查询--查询结果
标题均增加为“按批次/收寄日期查询”，并将原报文数据项“大客户批次”，修改为“大客户批次/收寄日期”
50.
3.2.2
给据邮件投递信息
在本节的数据项描述中增加一个字段“投递信息录入时间”，该字段仅对投递系统发来的投递信息报文有效，且投递系统的投递信息报文中该字段为必填
2009-8-24
51.
3.3.6
与电子化支局之间的机构代码信息
与电子化支局之间增加一个机构代码的接口。
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接口CAPI函数，供各相关系统调用，报文的打包、压缩、校验与可靠传送由给据邮件跟踪查询系统提供的API函数自动完成，运行环境要求是Linux操作系统（32位,64位均可），Oracle10客户端。
1.2.2服务调用类接口实现方式
1.3信息种类
1.3.1数据传输类接口的信息种类
关联系统
接口名称
接口说明
1．
电子化支局系统
给据邮件收寄信息
电子化支局系统向给据邮件跟踪查询系统传送收寄信息
电子化支局系统向给据邮件跟踪查询系统传送投递信息
给据邮件（总包）发出信息
电子化支局系统向给据邮件跟踪查询系统传送邮件（总包）发出信息
给据邮件到达信息
电子化支局系统向给据邮件跟踪查询系统传送邮件到达信息
大客户邮件当前状态的邮件清单信息按批次查询的查询条件
电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询条件信息
大客户邮件妥投情况统计信息按批次查询的查询条件
电子化支局系统向给据邮件跟踪查询系统传送按批次查询大客户邮件妥投情况统计信息的查询条件信息
大客户邮件当前状态的邮件清单信息按批次查询的查询结果
给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件当前状态的邮件清单信息的查询结果信息
大客户邮件妥投情况统计信息按批次查询的查询结果
给据邮件跟踪查询系统向电子化支局系统传送按批次查询大客户邮件妥投情况统计信息的查询结果信息
收寄邮件种类
电子化支局系统向给据邮件跟踪查询系统传送收寄邮件种类基础信息
行政区划
电子化支局系统向给据邮件跟踪查询系统传送行政区划基础信息
未妥投原因
电子化支局系统向给据邮件跟踪查询系统传送未妥投原因基础信息
未妥投下一步动作
电子化支局系统向给据邮件跟踪查询系统传送未妥投下一步动作基础信息
客户信息
电子化支局系统向给据邮件跟踪查询系统传送客户信息
机构信息
电子化支局系统向给据邮件跟踪查询系统传送机构代码基础信息
2．
中心局生产作业系统
给据邮件的总包发出信息
中心局生产作业系统在封发局向给据邮件跟踪查询系统传送总包的发出信息
给据邮件总包及邮件封发信息
中心局生产作业系统在封发局向给据邮件跟踪查询系统传送总包及邮件封发信息
给据邮件的总包到达信息
中心局生产作业系统在接收局向给据邮件跟踪查询系统传送总包的到达信息
中心局向给据邮件跟踪查询系统传送机构代码信息
4．
投递系统
投递系统向给据邮件跟踪查询系统传送投递信息
投递系统向给据邮件跟踪查询系统传送邮件到达投递局信息
1.3.2服务调用类接口的信息种类
邮件当前状态查询接口
实现关联系统与给据邮件跟踪查询系统之间的邮件当前状态查询接口的服务调用
邮件全程跟踪查询接口
实现关联系统与给据邮件跟踪查询系统之间的邮件全程跟踪查询接口的服务调用
3．
邮件收寄信息查询接口
实现关联系统与给据邮件跟踪查询系统之间的邮件收寄信息查询接口的服务调用
邮件投递信息查询接口
实现关联系统与给据邮件跟踪查询系统之间的邮件投递信息查询接口的服务调用
5．
邮件批量查询接口
实现关联系统与给据邮件跟踪查询系统之间的邮件批量查询接口的服务调用
第2章传输规范
本接口规范定义的报文均采用本章规定的传输规范进行数据传输。
2.1传输机制
（1）报文传输采用JMS消息机制。
（2）报文格式采用文本格式。
（3）报文传输方式采用二进制方式传输。
（4）报文交换方式采用JMS消息TOPIC+QUEUE方式。
（5）报文的接收方和发送方均需遵守本章规定的传输规范。
2.2正常报文
2.2.1总体说明
（6）批量正常报文每次数据交换都由两部分内容组成：
“控制消息”和“报文”。
（7）每个报文都有一个控制消息，“控制消息”用于对报文的唯一标识，包含报文的控制信息，“控制消息”可用做临时报文文件的文件名，格式定义见“2.2.2”。
（8）报文由“报文头”、“报文体”、“报文尾”三部分组成，格式定义见“3.2”及“3.3”各节中的报文规范部分。
（9）对于不需要拆分的报文，其“控制消息”中的“报文序号”为“000”；
（10）每个报文由若干个完整的记录组成，记录数上限值为9999（不含报文内部报文头，参数可灵活配置），超过9999需要拆分报文。
拆报文的方式有三种：
第一种：
对于关联性不强的报文，可以按照9999条限制拆分为多个独立的报文，即各个报文“控制消息”中的“消息序号”不同，而“报文序号”都为“000”；
第二种：
对于报文内部关联性很强，需要保证一批数据完整性的报文，可以按照9999条的报文记录上限拆分报文，对于各个拆分报文的“控制消息”中的“消息序号”要保持一致，而“控制消息”中的“报文序号”需要从“001”开始增加，即第一包为“001”，第二包为“002”，…，对于同一组的最后一个报文“控制消息”中的“报文序号”为“999”，表示一组报文结束。
（11）报文内信息分行存储，行结束符为换行符（0x0a），报文中第一行为报文头（#HEAD开头），第二行开始为报文体，最后一行为报文尾（#END开头）。
（12）每条记录中的域以竖线“|”分隔，最后一个报文域后也需加“|”，对于可选数据项即使没有数据内容也要在报文中占位，即也须以“|”分隔；
（13）日期时间类型的数据格式：
YYYYMMDDHH24MISS；
（14）数值类型的信息内容若有小数或负号需填写小数点或负号，小数点前后必须有数值，不允许出现“1.”或“.12”；
（15）报文每个域的长度不能长于接口单元中规定的接口数据项的长度；
（16）报文每个域中不能含有“|”、回车符“0x0d”两种字符。
2.2.2正常报文控制消息格式
消息头说明：
消息头长度为51个字节。
以电子化支局系统到给据邮件跟踪查询系统的接口单元为例：
PEO_RIT_COL_9999_11_20090301_210101_0000002_000_DAT
1）接口单元为：
PEO_RIT_COL。
2）给据邮件跟踪查询系统中的节点编号为：
9999。
3）省份代码为：
11（北京）
4）发送日期为：
20090301。
5）发送时间为：
210101。
6）消息序号为：
0000002，总第2个消息。
7）报文序号为：
000，不需要拆分的报文统一用‘000’作为报文序号。
8）报文类型：
DAT表示接口数据报文。
域名称
长度
示例
取值
说明
接口单元代码
CHAR（11）
PEO_RIT_COL
定长11位，具体取值参见2.1节的描述
接口单元代码编码规则参见“2.1”节。
节点代码
CHAR（4）
9999
4位字符，给据邮件跟踪查询系统为9999，不足4位后面补0
省份代码
CHAR
（2）
11
两位字符，中心局系统固定为“99”
发送日期
CHAR（8）
20090301
8位字符，表示报文生成日期，格式为：
YYYYMMDD
接口单元的发送日期，和生成日期保持一致。
发送时间
CHAR（6）
210101
6位字符，表示报文生成时间，格式为:
24HHMMSS
原则上报文生成后应立即传送。
消息序号
CHAR（7）
0000002
7位，取值范围为：
0000001—9999999
用于消息唯一标识，要求在3个月内消息保持唯一，各相关系统可以根据自己情况自行定义，建议使用取值说明里的顺序。
报文序号
CHAR（3）
000
3位，取值分为三类：
001-998
999
对于不需要拆包的报文，本域始终为“000”，对于需要拆包的报文，第一包本域为“001”，以后包依次增加，最后一个包为“999”代表整个消息结束。
报文类型
DAT
3位字符，表示消息类型
DAT：
表示接口正常数据消息
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而得到。
如：
正常报文消息头
PEO_RIT_COL_节点号码_省份代码_20090301_210101_0000002_000_DAT
对应异常报文消息头
PEO_RIT_COL_节点号码_省份代码_20090301_210101_0000002_000_ERR
2.3.3数据项描述
信息项
格式
出错记录号
NUMBER（4）
873
批量正常报文中对应出错的行号（计算行号时不包括报文头和报文体），报文级错误为0。
子表类型代码
VARCHAR（8）
COL
为正常报文中错误记录行的第一个域的内容（子表类型代码）。
错误类别
CHAR
（1）
M
M：
报文级错误
R：
记录级错误
L：
逻辑级错误
错误代码
缺省为：
000000
错误处理结果
VARCHAR
（2）
1:
丢弃报文
2:
丢弃数据行
3:
以缺省值代替出错数据项
错误描述信息
VARCHAR（200）
与出错信息相关的描述信息
2.3.4批量异常报文格式
报文头（必要）
结构：
#HEAD|接口单元代码|版本号|报文生成日期|报文生成时间|增全量标志|
信息项说明：
●标识头（5位定长）
固定为“#HEAD”
●接口单元代码（11位定长）
为其对应批量正常报文的接口单元代码
●版本号（6位定长）
格式为：
V1.0，如：
01，不足两位前面补‘0’，以给据邮件跟踪查询系统与各相关系统的接口规范版本号为准。
●报文生成日期（8为定长）
YYYYMMDD，如20060518
●报文生成时间（6位定长）
HHMMSS，如230201
●增全量标志（1位定长）
增全量标志，缺省为:
A
●报文头中各域以‘|’进行分割，最后一个域结尾也需要加‘|’。
●报文头长度共为43位。
报文头为报文第一行，以“#HEAD”开头。
报文体（必要，根据对应正常报文数据而定）
出错信息
#ERRO|出错记录号|子表类型代码|错误类别|错误处理结果|错误号|错误描述信息|
报文尾（必要）
#END|总行数|
报文最后一行，以“#END”开头，总行数为包括报文头、报文体、报文尾在内的行数。
2.3.5报文体填写说明
1.对于报文级错误：
1）异常返回报文只包括一条记录。
2）出错记录号为：
0。
3）子表类型代码为：
接口单元代码后四位。
4）错误类别：
”M”。
5）错误代码：
根据具体的约定填写。
6）错误处理结果：
丢弃报文。
7）错误信息描述：
错误代码的相应说明。
2.对于记录级和逻辑级错误：
1）一条正常报文原始记录可能对应多条错误信息。
批量正常报文中对应出错的行号。
”R”，
升级会员 