GB/T33479-2016
党政机关电子公文交换接口规范
ExchangeinterfacespecificationforelectronicofficialdocumentofPartyandgovernmentorgans
- 中国标准分类号（CCS）L76
- 国际标准分类号（ICS）35.240.30
- 实施日期2017-07-01
- 文件格式PDF
- 文本页数20页
- 文件大小433.45KB
以图片形式预览党政机关电子公文交换接口规范
党政机关电子公文交换接口规范
国家标准 GB/T33479一2016 党政机关电子公文交换接口规范 ExchangeinterfacespeeifieationforeleetromieofieialdoeumentofPartyand governmentorgans 2016-12-30发布 2017-07-01实施 国家质量监督检监检疫总局 发布 国家标准花管理委员会国家标准
GB/T33479一2016 前 言 本标准按照GB/T1.1一2009给出的规则起草
请注意本文件的某些内容可能涉及专利
本文件的发布机构不承担识别这些专利的责任 本标准由中共中央办公厅、国务院办公厅提出
本标准由国家电子文件管理部际联席会议办公室归口
本标准起草单位;中办信息中心,电子技术标准化研究院、国家信息安全工程技术中心、华迪计 算机集团有限公司、软件与技术服务股份有限公司,方正国际软件(北京)有限公司北京华宇信息 技术有限公司北京电子科技学院、太极计算机股份有限公司,浪潮电子信息产业股份有限公司、北京神 舟航天软件技术有限公司、神州数码系统集成股份有限公司
本标准主要起草人:李海波,高林、高鹏、丛培勇、李平立、陈亚军、方春燕、冯解、袁峰、方伟强、 曹广阳、贾曙瑞、王寒冰、张宇,武娟,陈海,刘丹,朱宪,高明,王世凡
GB/T33479一2016 引 言 使用电子政务内网交换体系进行公文交换的,遵循电子政务内网业务信息和电子文件交换系统技 术规范的相关要求,本标准不再赘述
GB/T33479一2016 党政机关电子公文交换接口规范 范围 本标准规定了电子公文交换系统之间以及交换系统与电子公文处理系统间进行数据交换时采用的 报文数据格式和接口 本标准适用于电子公文系统的数据交换
规范性引用文件 下列文件对于本文件的应用是必不可少的
凡是注日期的引用文件,仅注日期的版本适用于本文 件
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件
GM/T0006密码应用标识规范 缩略语 下列缩略语适用于本文件
UUD;通用唯一标识符(UniversallyUniqueIdentifier 系统结构 第5章定义了交换系统应用于电子公文时使用的业务类型结构
第6章定义了交换系统之间、交换系统与处理系统之间使用的数据格式
第7章定义了交换系统之间,交换系统与处理系统之间调用的接口形式
上述数据格式和接口关系见图1
公文传输信封 公文传输信封 处理系统入 交换系统 处理系统D 交换系统2 处理系统B 报文传输信封 图示 交换系统3 交换系纷交换系统 处理系统c 处理系统 处理系统 公文传输信封 交换系统间接口 交换系统和处 处理系统E 处理系统 处理系统G 紧纷简接 图1电子公文交换接口与数据格式
GB/T33479一2016 公文交换业务 5.1 概述 交换系统通过报文内容的交换完成任意电子文件数据的传输或者相关消息的传递
按照不同用 途,报文内容分为系统报文和业务报文
系统报文用于各种计算机状态消息的传递,业务报文则用于文 件数据的传输和业务状态消息的传递
当用于传输公文时,业务报文内容既可以是公文文件,也可能仅是简短的业务状态消息
在本标准 中,这两种报文内容节点分别使用“公文类型”或“公文短报文类型”进行限定
5.2公文类型 当业务报文中“类型”取值为“oFC”时,6.1.5中“内容”节点按照“公文类型”进行解析,公文类型的 结构见图2
密级 紧急程度 发文机关 公文类型 收文机关 公文标题 公文内容 扩展属性 图2公文类型结构 公文类型的元素说明见表1
表1公文类型元素说明 名称 类型 说明 备油 密级 可选 待交换公文的元数据,文件的秘密等级 xs;string 紧急程度 待交换公文的元数据,送达和办理的时限要求 可选 xs:string 发文机关 待交换公文的元数据,文件的发文机关 可选 xs;string 可选 收文机关 待交换公文的元数据,文件的收文机关 Xs:strIng 待交换公文的元数据,公文标题
文件密级为“绝密”时,应置 公文标题 可选 xs;string 为空 公文内容 电子公文二进制内容的1 编码 必选 xs:base64Binary base64 扩展属性 可选 为自主扩展预留 xs;anyType
GB/T33479一2016 5.3公文短报文类型 当业务报文中“类型”取值为“RET”时,6.1.5中“内容”节点按照“公文短报文类型”进行解析,公文 短报文类型的结构见图3， 原报文标识 业务类型 公文短报文类型 时间 意见 图3公文短报文类型结构 公文短报文类型的元素说明见表2 表2公文短报文类型元素说明 名称 类型 说明 备注 原报文标识 本报文针对的报文的标识 必选 Xs;string 业务类型 本报文的业务报文类型,可取值见表3 必选 xs;string 时间 xs:string 本报文的组装时间 必选 本报文的意见内容 意见 xs;string 可选 公文短报文业务类型的取值及其说明见表3
表3公文短报文类型的取值说明 取值 说明 送达 Received 签收 Accepted 拒收 Reected 数据格式 6.1公共数据类型 6.1.1简单类型说明 报文属性类型的取值及其说明见表个 表4报文属性类型的取值说明 取值 说明 系统报文 SYS B1Z 业务报文
GB/T33479一2016 报文内容类型的取值及其说明见表5. 表5报文内容类型的取值说明 名称 说明 O)Fc 表明出现的内容节点按照“公文类型”进行解析 RET 表明出现的内容节点按照“公文短报文类型”进行解析 注:报文内容类型是一个可扩展项,在本标准中仅针对公文进行了扩展
6.1.2收发机构类型 收发机构类型结构见图4
身份标识 收发机构类型 身份名称 身份描述 图4收发机构类型结构 收发机构类型的元素说明见表6
表6收发机构类型元素说明 名称 类型 说明 备注 身份标识 机构或者地址在系统中的唯一标识 必选 xs;string 身份名称 机构或者地址在系统中的名称 必选 xs;string 身份描述 机构或者地址的其他补充描述 可选 xs:string 6.1.3密码算法类型 密码算法类型结构见图5
签名算法 密码算法类型 加密算法 图5密码算法类型结构 密码算法类型元素说明见表7
GB/T33479一2016 表7密码算法类型元素说明 说明 名称 类型 备注 签名所采用的签名算法,当需要对信封进行签名时出现 签名算法 xs;string 可选 该节点 加密所采用的加密算法,当需要对报文内容加密时出现 可选 加密算法 xs;string 该节点,仅适用于业务报文 商密的摘要和签名算法遵照GM/T0006,其他密级的算法遵照相应规范
6.1.4系统报文类型 系统报文类型结构见图6
原报文标识 类型 系统报文类型 时间 备迷 图6系统报文类型结构 系统报文类型的元素说明见表8
表8系统报文类型元素说明 名称 类型 说明 备注 xs;string 必选 原报文标识 该报文针对的报文的标识 报文消息类型 必选 类型 Xs:strIng 时间 xs:string 报文消息的时间 必选 备注 xs:string 报文消息的内容 可选 6.1.5业务报文类型 业务报文类型的结构见图7
GB/T33479一2016 类型 内容 业务报文类型 附件名称 扩展名 附件 附件标识 附件大小 附件内容 图7业务报文类型结构 业务报文类型的元素说明见表9.
表9业务报文类型元素说明 类型 说明 名称 备注 报文内容的类型,确定其后出现的内容节点按何种类型 报文内容类型 类型 必选 进行扩展解释,见表5 报文内容,依据类型声明按照不同结构进行分析,见5.2 内容 必选 xs;string 和5.3 与内容相关的附件 附件 可选 附件名称 附件的名称 必选 xs;string 附件的扩展名 扩展名 xs:string 可选 附件的标识,由具体的应用确定,应保证唯一性,例如报 -附件标识 xs:string 可选 文标识加编号 附件大小 xs;unsignedlnt 附件的文件大小,单位为字节 可选 附件内容 xs:base64Binary 附件文件二进制流的base64编码 必选 6.2报文传输信封 报文传输信封组成 6.2. 交换系统之间传输的数据文件称为报文传输信封,该文件为XML.报文信封模型见附录A
根节 点“报文传输信封”的结构见图8
GB/T33479一2016 曰atributes 版本 报文传输信封 报文头 报文体 签名 图8报文传输信封结构 报文传输信封的属性与元素说明见表10
表10报文传输信封属性与元素说明 名称 类型 说明 备注 用于协议互通的版本号,固定为1.0 必选 版本 xs;string 报文头 报文传输的头部结构 必选 必选 报文体 报文传输的主体部分结构,用于封装报文内容和附件 需要对报文内容作签名保护时,记录针对整个报文信封 可选 签名 的签名值和相关信息 6.2.2报文头 报文头结构见图9 报文标识 报文属性 报文发送方 报文接收方 报文头 发出时间 密码算法 报文备注 传输票据 图g报文头结构 报文头的元素说明见表11
GB/T33479一2016 表11报文头元素说明 类型 说明 备注 名称 报文标识 报文传输中的唯一标识信息 必选 xs;string 报文的属性,区分报文体中是系统报文还是业务报文， 报文属性 报文属性类型 必选 见表5 收发机构类型 报文发送方 报文发送方相关信息,见表6 必选 报文接收方 收发机构类型 报文接收方相关信息,见表6 必选 发出时间 s;dateTinme 报文发出的时间 必选 保护报文内容使用的算法等信息,此节点不存在时不做 密码算法 密码算法类型 任何保护;出现时应用密码保护,可以是加密和签名的 可选 组合应用,见表7 报文备注 报文的备注信息 可选 xs:string 传输票揭 表示后续公文传输关系的信任凭证 可选 Xs;string 6.2.3报文体 报文体结构见图10
庄 系统报文 报文体 明文报文 母 密文报文 图10报文体结构 报文体的元素说明见表12 表12报文体元素说明 名称 类型 说明 备注 系统短报文内容,报文头中报文属性取值为SYS时应出 系统报文 系统报文类型 必选 现此节点 待传输的报文内容,见6.1.5;报文头中报文属性取值为 明文报文 业务报文类型 必选 Bz且密码算法中不出现加密选项时出现 待传输的经加密的报文内容,是“明文报文”节点内容的 文报文 xs;base64Binary 必选 密码运算结果;报文头中报文属性取值为B1Z且密码算 法中出现加密选项时出现 6.2.4签名 签名的结构见图11
GB/T33479一2016 签名者 签名 签名时间 签名值 图11签名类型结构 签名类型的元素说明见表13
表13签名类型元素说明 名称 类型 说明 备注 xs;string 执行签名的机构或服务 可选 签名者 签名时间 s;dateTinme 签名的时间 可选 对报文传输信封整个文件(本节点内容置空)的二进制 签名值 内容计算所得的数字签名值;签名和验证签名时,应将 必选 Xs;base64Binary 本节点内容置空后再进行相关运算 6.3公文传输信封 交换系统与处理系统之间传输的数据文件称为公文传输信封,该文件以xML形式描述,其根节点 “公文传输信封”的结构见图12
attributes 版本 报文标识 公文传输信封 发文机关 封装实体 收文机关 明文报文 图12公文传输信封结构 公文传输信封元素说明见表14
GB/T33479一2016 表14公文传输信封元素说明 类型 名称 说明 备注 用于协议互通的版本号,固定为1.0 Version xs;string 必选 被传输实体,可出现多次 封装实体 必选 -报文标识 报文传输中的唯一标识信息 必选 Xs;string 发文机关 收发机构类型 必选 报文发送方相关信息,见表6 收文机关 收发机构类型 报文接收方相关信息,见表6 必选 明文报文 业务报文类型 传递的报文内容,见6.1.5 必选 接口 7.1 总体要求 电子公文交换系统与处理系统以及不同的交换系统之间以报文形式进行数据交换,交换系统和处 理系统以webService方式提供对外接口
7.2交换系统间的接口 7.2.1受信代码要求 交换系统之间进行报文传输之前应先建立受信代码
受信代码由系统随机产生、双方认可且不重 复的字符串组成,用于确认双方身份
受信代码要求如下 受信代码为32位的UUD b)交换系统之间进行报文传输应带有受信代码信息,否则被请求方应拒绝接收; c)受信代码建立后在有效期内可多次使用;有效时间由双方协商确定,双方均可强行终止 d受信代码建立后在有效期内不再重复请求受信代码 交换系统应维护受信代码、及时销毁已经超时的受信代码
注:双方受信代码不一致的情况有可能发生,如一方系统故障或一方主动销毁 7.2.2建立受信代码 功能说明 请求受信代码 接口原型 reqwebService(stringumitld.stringlinkCode,stringseconds,stringreqType) string！ 参数说明(4个参数) 参数1:unitla请求建立受信代码的单位标识 参数2;linkCode预设握手字符串,由发送方生成的一串随机字符组成
此字符串用于确认 被请求方返回的信息是否是针对本次请求; 表示超时时间,即受信代码的有效时间,单位秒; 参数3:seconds 参数4;reqType代表请求类型,枚举值,可取值为,BGN请求建立受信代码;END请求强制 终止受信代码
返回值说明 10
GB/T33479一2016 rcesult>(unild).<(inkCode)(tran.Code).GB/T33479一2016 附 录A 规范性附录 电子公文交换相关报文信封的XM模型 电子公文交换相关报文信封的XML模型如下: (?xmlversion=" 1.o" encoding="UTF-8"? xs:schemaxmlns;xs="http://www.w3.org/2001/XMLSchema"elermentFormDefault="quali fied" attributeFormDefault="unqualified" --交换系统之间的报文协议--) pleTy Typename="报文属性类型"y Xs;simp Xsrestrictionbase "xs;string" xs;enumerationvalue="SYS" xs:annotation xs:documentation)系统报文业务报文〈/xs:documentation /xs;annotation>》 《/xs:enumeration》 /xs;restriction /xs:simpleType xssimpleTypename="报文内容类型")》 xs:restrictionbase="xs:string"》 xsenumerationvalue="OFC")y xs:annotation》 xs:documentation)公文《/xs:documentationm /xs:annotation xs:enumeration xs;:enumerationvalue="RET")y xs:annotation 〈xs;documentation)公文短报文GB/T33479一2016 /xs:sequence /xscomplexType' "密码算法类型"y xs:complexType name= 《xS;seguence minOccurs="o"八 xS;elementname "签名算法”ype="x;string" xs:elementname="加密算法" minOccurs="o"八 type=“Xs:string" XSsequence nplexType) xs:comI xs:complexTy "业务报文类型" ypename= Xs:seguence xs:elementname="类型" "报文内容类型"〉 type= name="内容”type="xs:anyType") XS:element "附件”minOceurs一"o”maxOccurs="unbounded"y 《XS:elementname5 xs;complexType XS;Seguence -"附件名称"type="xs;string")y xs;elementname= xs:elementname="扩展名”type="xs:sring”minecurs="o") xs:elememtname="附件标识”type="xs:=string”minOeurs "o"八 xs:elementname="附件大小"type="xs;unsignedlnt"nin(Occurs= "p") xs;elementname="附件内容"type="xs;base64Binary"八 《7/Xs:sequence (/xs:complexType》 《/xs:element /xs:sequence /xs:complexType xs:complexTypename="系统报文类型") xs:sequence xs;elementname="原报文标识”type="xs;string") xs:elementname="类型”type="xs;string"八 xs;elementname="时间”type="xs;dateTime") xs:elementname="备注”type="xs;string”minOccurs="o") 7/Xs:sequence /xs:complexType xs:;elementname="报文传输信封") Xs;complexType xs:sequence ref="报文头"八 Xs;element xs;elementre[="报文体"八 xs;elementref="签名”minOecurs="0"八 /Xs:sequence xs:attributename="Version" reguired”fixed="1.0" type="xs;string”use="re 13
GB/T33479一2016 /xs:complexType 《/xS;element "报文头"" 《XS:elementname= xs:complexT Iype xS;Seguence -"xs;s g") -"报文标识”type= strimng" xs:elementname一 "报文属性”type="报文属性类型"八 Xs:elementname= xs:elementname="报文发送方”type="收发机构类型"八 xs;elementname="报文接收方" "收发机构类型"max(Occurs= type "unbounded" xs;elementname= "发出时间" type="xs;dateTime") xs:elementname="密码算法”type="密码算法类型”minOccurs="o"八 xs:elementname="报文备注" type="xsstring”minOeeurs-"0") (xs;elementnamc="传输票据”type=" "xs;string”minOccurs="o"八 《/xs:seguence /xs:complexType /xs:element》 xs:elementname="报文体") xs:complexType》 xs:choice (xs:elementname="系统报文”type="系统报文类型") (xs:elementname="明文报文"type="业务报文类型") (xs;:elementname="密文报文”type="xs;base64Binary" 《/xs:choice /xs:complexType /xs:element》 (xs;elenmentname="签名" xs:complexType Xs:sequence ="o"八 xs;elementname="签名者”type="xs;string”nminOceurs=！ (xs:elementnarme="签名时间”type="xs:dateTime”rminOceurs="O") (xs:elementname="签名值”type="xs:base64Binary") /Xs:sequence /xs;complexType /xs:element》 -处理和交换系统间的协议- xs:complexTypename="公文类型" Xs;sequence "0"八 -"密级”type="xs;string”minOccurs= XS;elementname三 minOccurs="o"八 《Xs:elementname -"紧急程度”type="xs:string" minOccurs="o"八 -"发文机关”type="xs;string" xs;elementname一 minOccurs="o"八 XS;elementname= "收文机关”type="xsstring" minOccurs="o"八 -"公文标题”type="xs:string" xS;elementname 14
GB/T33479一2016 xselementname= e="公文内容”type="xs;bascG4Binary" e="扩展属性”type="xs;anyType”minOccurs="0") xS;elementname= 7xs:sequence /xs:complexType) xs;simpleType name= "短报文业务类型")》 ;string" xs:restrictionbaSe=xs xs;enumerationvalue="Received"y xs:ann nnotation xs:documentation)送达(/xs:documentation xS:annotation XS:enumerat1On xs:enumerationvalue="Accepted"》 :annotat1On xs;documentation)签收〈/xs;documentation xs:annotation xs;enumeration xs:enumerationvalue="Rejected" xs;annotation》 xs:documentation)拒收(/xs:documentation 《/xs:annotation》 /xs:enumeration /xs:restriction /xs:simpleType xs:complexTypename="公文短报文类型"y xs:sequence xs;elementname="原报文标识”type="xs;string") (xs;elenmentname="业务类型”type="短报文业务类型") xs;elementname="时间”type="xs;dateTime") xs;elementname="意见”type="xs;string”rminOceurs="0" /xs;sequence 《7xs:complexType xs;elementname="公文传输信封") xs:complexType xs;sequence srelemetname="封装实体”maxOceurs="unbounded" 〈xs;complexType) Xs:sequence> xsdlementname-"报文标识”type-"xs:string" (xs;elementname="发文机关”type=！ ="收发机构类型") maxOc 《xselementname= "收文机关”type="收发机构类型" curs="unbounded" xs;elementname="明文报文"type="业务报文类型"八 /xs;sequence 15
GB/T33479?2016 /xs:complexType /xs:element / xs:sequence xs;attributename="Version" "requiredixed="1.0" se "xs;string" type= / /xsrcomplexType)y /xs:element /xs;schema 16
党政机关电子公文交换接口规范GB/T33479-2016
随着信息化技术的不断发展，党政机关电子公文交换已经成为现代化办公的一个基本环节。在这一背景下，党政机关电子公文交换接口规范GB/T33479-2016应运而生。 该标准主要针对党政机关之间进行电子公文交换时所需要遵守的规范进行了详细说明。其中包括电子公文交换的流程、接口协议、数据格式等各方面内容，确保公文交换的安全性、可靠性和高效性。 在实际应用中，该标准的使用可以有效地解决党政机关电子公文交换过程中出现的一系列问题。首先，规范化的接口协议可以大幅度降低因接口不兼容或者错误导致交换失败的可能性，从而提高交换的成功率。其次，标准化的数据格式使得各个党政机关之间可以实现无缝对接，从而降低了交换成本和交换时间。 此外，该规范还对电子公文交换过程中的安全性问题进行了详细说明。其中包括数据加密、身份识别等多种措施，确保电子公文交换的安全性和保密性。 总之，党政机关电子公文交换接口规范GB/T33479-2016是一项非常重要的行业标准，对于现代化办公、信息化建设具有重要意义。在未来，我们相信该标准会在各个领域得到广泛应用和推广，为党政机关电子公文交换提供更加高效、可靠的解决方案。
