GB/T 33479-2016 党政机关电子公文交换接口规范

　　ICS 35.240.30 L 76

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 33479—2016

　　党政机关电子公文交换接口规范

　　Exchangeinterfacespecification forelectronicofficialdocumentofParty and

　　governmentorgans

　　2016-12-30发布 2017-07-01实施

　　中华人民共和国国家质量监督检验检疫总局中 国 国 家 标 准 化 管 理 委 员 会

　　发

　　布

　　GB/T 33479—2016

　　前 言

　　本标准按照 GB/T 1. 1—2009给出的规则起草 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别这些专利的责任 。

　　本标准由中共中央办公厅 、国务院办公厅提出 。

　　本标准由国家电子文件管理部际联席会议办公室归 口 。

　　本标准起草单位 : 中办信息中心 、中国电子技术标准化研究院 、国家信息安全工程技术中心 、华迪计算机集团有限公司 、中国软件与技术服务股份有限公司 、方正国际软件(北京) 有限公司 、北京华宇信息技术有限公司 、北京电子科技学院 、太极计算机股份有限公司 、浪潮电子信息产业股份有限公司 、北京神舟航天软件技术有限公司 、神州数码系统集成股份有限公司 。

　　本标准主要起草 人 : 李 海 波 、高 林 、高 鹏 、丛 培 勇 、李 平 立 、陈 亚 军 、方 春 燕 、冯 辉 、袁 峰 、方 伟 强 、曹广阳 、贾曙瑞 、王寒冰 、张宇 、武娟 、陈海 、刘丹 、朱宪 、高明 、王世凡 。

　　GB/T 33479—2016

　　引

　　言

　　使用电子政务内网交换体系进行公文交换的 ,遵循电子政务内网业务信息和电子文件交换系统技术规范的相关要求 ,本标准不再赘述 。

　　党政机关电子公文交换接口规范

　　1 范围

　　本标准规定了电子公文交换系统之间以及交换系统与电子公文处理系统间进行数据交换时采用的报文数据格式和接 口 。

　　本标准适用于电子公文系统的数据交换 。

　　2 规范性引用文件

　　下列文件对于本文件的应用是必不可少的 。凡是注 日期的引用文件 ,仅注 日期的版本适用于本文件 。凡是不注日期的引用文件 ,其最新版本(包括所有的修改单)适用于本文件 。

　　GM/T 0006 密码应用标识规范

　　3 缩略语

　　下列缩略语适用于本文件 。

　　UUID:通用唯一标识符(Universally Unique Identifier)

　　4 系统结构

　　第 5 章定义了交换系统应用于电子公文时使用的业务类型结构 。

　　第 6章定义了交换系统之间 、交换系统与处理系统之间使用的数据格式 。

　　第 7章定义了交换系统之间 、交换系统与处理系统之间调用的接口形式 。

　　上述数据格式和接口关系见图 1。

　　图 1 电子公文交换接口与数据格式

　　5 公文交换业务

　　5. 1 概述

　　交换系统通过报文内容的交换完成任意电子文件数据的传输或者相关消息的传递 。按照不同用途 ,报文内容分为系统报文和业务报文 。 系统报文用于各种计算机状态消息的传递 ,业务报文则用于文件数据的传输和业务状态消息的传递 。

　　当用于传输公文时 ,业务报文内容既可以是公文文件 ,也可能仅是简短的业务状态消息 。在本标准中 ,这两种报文内容节点分别使用 “公文类型 ”或 “公文短报文类型 ”进行限定 。

　　5.2 公文类型

　　当业务报文中 “类型 ”取值为“OFC”时 ,6. 1. 5 中 “内容 ”节点按照 “公文类型 ”进行解析 ,公文类型的结构见图 2。

　　图 2 公文类型结构

　　公文类型的元素说明见表 1。

　　表 1 公文类型元素说明

　　5.3 公文短报文类型

　　当业务报文中 “类型 ”取值为“RET”时 ,6. 1. 5 中 “内容 ”节点按照 “公文短报文类型 ”进行解析 ,公文短报文类型的结构见图 3。

　　图 3 公文短报文类型结构

　　公文短报文类型的元素说明见表 2。

　　表 2 公文短报文类型元素说明

　　公文短报文业务类型的取值及其说明见表 3。

　　表 3 公文短报文类型的取值说明

　　6 数据格式

　　6. 1 公共数据类型

　　6. 1. 1 简单类型说明

　　报文属性类型的取值及其说明见表 4。

　　表 4 报文属性类型的取值说明

　　报文内容类型的取值及其说明见表 5。

　　表 5 报文内容类型的取值说明

　　6. 1.2 收发机构类型

　　收发机构类型结构见图 4。

　　图 4 收发机构类型结构

　　收发机构类型的元素说明见表 6。

　　表 6 收发机构类型元素说明

　　6. 1.3 密码算法类型

　　密码算法类型结构见图 5。

　　图 5 密码算法类型结构

　　密码算法类型元素说明见表 7。

　　表 7 密码算法类型元素说明

　　商密的摘要和签名算法遵照 GM/T 0006,其他密级的算法遵照相应规范 。

　　6. 1.4 系统报文类型

　　系统报文类型结构见图 6。

　　图 6 系统报文类型结构

　　系统报文类型的元素说明见表 8。

　　表 8 系统报文类型元素说明

　　6. 1.5 业务报文类型

　　业务报文类型的结构见图 7。

　　图 7 业务报文类型结构

　　业务报文类型的元素说明见表 9。

　　表 9 业务报文类型元素说明

　　6.2 报文传输信封

　　6.2. 1 报文传输信封组成

　　交换系统之间传输的数据文件称为报文传输信封 ,该文件为 XML,报文信封模型见附录 A。根节点 “报文传输信封 ”的结构见图 8。

　　图 8 报文传输信封结构

　　报文传输信封的属性与元素说明见表 10。

　　表 10 报文传输信封属性与元素说明

　　6.2.2 报文头

　　报文头结构见图 9。

　　图 9 报文头结构

　　报文头的元素说明见表 11。

　　表 11 报文头元素说明

　　6.2.3 报文体

　　报文体结构见图 10。

　　图 10 报文体结构

　　报文体的元素说明见表 12。

　　表 12 报文体元素说明

　　6.2.4 签名

　　签名的结构见图 11。

　　图 11 签名类型结构

　　签名类型的元素说明见表 13。

　　表 13 签名类型元素说明

　　6.3 公文传输信封

　　交换系统与处理系统之间传输的数据文件称为公文传输信封 ,该文件以 XML形式描述 ,其根节点“公文传输信封 ”的结构见图 12。

　　图 12 公文传输信封结构

　　公文传输信封元素说明见表 14。

　　表 14 公文传输信封元素说明

　　7 接口

　　7. 1 总体要求

　　电子公文交换系统与处理系统以及不同的交换系统之间以报文形式进行数据交换 ,交换系统和处理系统以 WebService方式提供对外接 口 。

　　7.2 交换系统间的接口

　　7.2. 1 受信代码要求

　　交换系统之间进行报文传输之前应先建立受信代码 。受信代码由系统随机产生 、双方认可且不重复的字符串组成 ,用于确认双方身份 。受信代码要求如下 :

　　a) 受信代码为 32位的 UUID;

　　b) 交换系统之间进行报文传输应带有受信代码信息 ,否则被请求方应拒绝接收 ;

　　c) 受信代码建立后在有效期内可多次使用 ;有效时间由双方协商确定 ,双方均可强行终止 ;

　　d) 受信代码建立后在有效期内不再重复请求受信代码 ;

　　e) 交换系统应维护受信代码 、及时销毁已经超时的受信代码 。

　　注 : 双方受信代码不一致的情况有可能发生 ,如一方系统故障或一方主动销毁 。

　　7.2.2 建立受信代码

　　功能说明 :

　　请求受信代码 。

　　接口原型 :

　　string reqWebService(string unitId,string linkCode,string seconds,string reqType)参数说明(4个参数) :

　　参数 1:unitId 请求建立受信代码的单位标识 ;

　　参数 2:linkCode 预设握手字符串 , 由发送方生成的一串随机字符组成 。此字符串用于确认被请求方返回的信息是否是针对本次请求 ;

　　参数 3:seconds 表示超时时间 , 即受信代码的有效时间 ,单位秒 ;

　　参数 4:reqType 代表请求类型 ,枚举值 ,可取值为 :BGN 请求建立受信代码;END 请求强制终止受信代码 。

　　返回值说明 :

　　. . . . . . . . .

　　其中 , unitId为被请求方的单位标识 , linkCode为请求方生成的握手信号 , transCode为受 信代码 。

　　若该接口返回值为 refuse(拒绝连接) ,则请求方应终止后继操作 。

　　7.2.3 传输报文

　　功能说明 :

　　请求传输报文 。

　　接口原型 :

　　string sendBaseXMLEsbWebService(string transCode,string message)参数说明(2个参数) :

　　参数 1:transCode 受信代码 ;

　　参数 2:message 报文 ,其格式应遵照 6. 2 的要求 。

　　返回值说明 :

　　0 表示报文接收成功 ;

　　1 表示被请求方不认可作为参数的受信代码 。则请求方应按照 7. 2. 2 请求得到新的受信代码后再传输报文 。

　　其他非 0值表示错误代码 。

　　7.3 处理系统与交换系统间接口

　　7.3. 1 交换系统接收报文

　　功能说明 :

　　交换系统接收处理系统发送的报文 ,与交换系统之间的传输报文的接口名称一致 ,但不需要受信代码作为参数 。

　　接口原型 :

　　string sendBaseXMLEsbWebService(string message)参数说明(1个参数) :

　　参数 1:message传输报文 ,格式应遵照 6. 3 的要求 。

　　返回值说明 :

　　success表示报文接收成功 ,否则报文接收失败 。

　　7.3.2 处理系统接收报文

　　处理系统接收交换系 统 发 送 的 报 文 采 用 注 册 机 制 , 交 换 系 统 调 用 注 册 的 处 理 系 统 接 口 完 成 报 文传输 。

　　附 录 A

　　(规范性附录)

　　电子公文交换相关报文信封的 XML模型

　　电子公文交换相关报文信封的 XML模型如下 :

　　fied".w3.org/2001/XMLSchema"elementFormDefault= "quali-

　　< xs:simpleTypename= "报文属性类型 ">

　　< xs:enumeration value= "SYS">

　　< xs:documentation>系统报文

　　< xs:enumeration value= "BIZ">

　　< xs:documentation>业务报文

　　< xs:simpleTypename= "报文内容类型 ">

　　< xs:enumeration value= OFC >

　　< xs:documentation>公文

　　< xs: m:aiue= "RET">

　　< xs:documentation>公文短报文

　　< xs:complexTypename= "收发机构类型 ">

　　< xs:complexTypename= "密码算法类型 ">

　　< xs:sequence>

　　< xs:elementname= "加密算法 " type= "xs:string" minOccurs= "0"/>

　　< xs:elementname= 类型type= 报文内容类 "/>

　　< xs:sequence>

　　< xs:elementname= "附件名称 " type= "xs:string"/>

　　" < xs: element name= "附件大小 " type= "xs: unsignedInt" minOccurs=

　　< xs:elementname= "附件内容 " type= "xs:base64Binary"/>

　　< xs:complexTypename= "系统报文类型 ">

　　< xs:sequence>

　　< xs:elementname= "原报文标识 " type= "xs:string"/>

　　< xs:elementref= 签名 minOccurs= 0 />

　　< xs:elementname= "报文头 ">

　　< xs:sequence>

　　" < xs: element name= "报 文 接 收 方 " type= "收 发 机 构 类 型 " maxOccurs=

　　< xs:elementname= 密码算法 type= 密码算法类型 minOccurs= 0 />

　　< xs:elementname= "报文体 ">

　　< xs:choice>

　　< xs:elementname= 密文报文 type= xs:base64Binary />

　　< xs:elementname= "签名 ">

　　< xs:sequence>

　　< xs:elementname= "签名时间 " type= "xs:dateTime" minOccurs= "0"/>

　　< ! --处理和交换系统间的协议-->

　　< xs:complexTypename= "公文类型 ">

　　< xs:sequence>

　　< xs:elementname= "扩展属性 " type= "xs:anyType" minOccurs= "0"/>

　　< xs:enumeration value= "Received">

　　< xs:documentation>送达

　　< xs:enumeration value= "Accepted">

　　< xs:documentation>签收

　　< xs:enumeration value= "Rejected">

　　< xs:documentation>拒收

　　< xs:complexTypename= "公文短报文类型 ">

　　< xs:sequence>

　　< xs:elementname= 意见 type= xs:string minOccurs= 0 />

　　< xs:elementname= "封装实体 " maxOccurs= "unbounded">

　　curs= "unbounded"/> " " " "

　　< xs:attribute name= "Version" type= "xs:string" use= "required" fixed= "1. 0"/>