1、 ICS 35.240.20 CCS L 76 41 河南省地方标准 DB41/T 30462025 一体化协同办公 电子公文 交换系统接入规范 2025-12-04 发布 2026-03-03 实施 河南省市场监督管理局 发 布 DB41/T 30462025 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 接入方式.2 6 接入流程.2 7 接入接口.3 8 接入安全.11 附录 A(资料性)电子公文交换系统接入申请表.13 附录 B(资料性)返回状态码.14 参考文献.15 DB41/T 30462025 II 前言 本文件按照GB/T
2、 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。本文件的某些内容可能涉及专利。本文件发布机构不承担识别这些专利的责任。本文件由河南省行政审批和政务信息管理局提出。本文件由河南省大数据标准化技术委员会(HN/TC 26)归口。本文件起草单位:河南省政务大数据中心、中国电子系统技术有限公司、正数网络技术有限公司。本文件主要起草人:齐彦欣、陈晓、刘慧芳、王彦生、王宏建、李力、董江波、关寒冰、金溢、周楠、韩逸、钱重光、陈雪刚、来豆豆。DB41/T 30462025 1 一体化协同办公 电子公文 交换系统接入规范 1 范围 本文件规定了政务部门电子公文交换系统的接入方式、
3、接入流程、接入接口和接入安全等内容。本文件适用于政务部门的各类非涉密电子公文系统接入电子公文交换系统进行数据交换管理。电子公文系统包括但不限于:协同办公系统、公文处理系统、公文流转系统、公文传输系统等。本文件仅涉及系统服务器端之间的数据交换。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 33477 党政机关电子公文标识规范 GB/T 33479 党政机关电子公文交换接口规范 GB/T 33480 党政机关电子公文元数据规范 3
4、术语和定义 下列术语和定义适用于本文件。电子公文 以数字形式存储于磁盘、光盘等媒体,依赖计算机系统阅读、处理并可在通信网络上传输的公文。来源:GB/T 33476.12016,3.1 电子公文系统 电子公文全生命周期过程或部分环节所使用的信息系统的统称。来源:GB/T 334822016,3.1 电子公文交换系统 提供安全传输机制和统一的交换接口,实现电子公文跨系统交换的信息系统。来源:GB/T 334822016,3.3 4 缩略语 下列缩略语适用于本文件。IP:网际互连协议(Internet Protocol)LDAP:轻量目录访问协议(Lightweight Directory Acce
5、ss Protocol)SSL:安全套接层(Secure Socket Layer)DB41/T 30462025 2 TLS:传输层安全性协议(Transport Layer Security)UTF-8:UCS转换格式8(UCS Transformation Format 8)UUID:通用唯一识别码(Universally Unique Identifier)XML:可扩展标记语言(Extensible Markup Language)5 接入方式 电子公文系统按照GB/T 33479规定的接口方式接入电子公文交换系统,通过接口实现公文数据交换管理。6 接入流程 接入流程见图1,主要包括
6、a)申请:接入单位向电子公文交换系统管理部门提交申请表,启动接入流程,申请表见附录 A;b)审批:电子公文交换系统管理部门接收申请后进行审批,审批通过后,完成对接业务配置;c)对接:接入单位应进行代码开发,确保系统间的技术连接;d)测试:接入单位和电子公文交换系统管理部门分别进行接口测试和业务联调测试,使系统稳定运行;e)上线:通过测试后,电子公文系统进行集成上线,正式接入电子公文交换系统。图1 接入流程 DB41/T 30462025 3 7 接入接口 概述 电子公文交换系统通过报文内容的交换完成任意电子文件数据的传输或者相关消息的传递。当用于传输公文时,业务报文内容既可以是公文文件,也可
7、以是简短的业务状态消息,本标准通过报文类型进行区分。电子公文交换系统提供10类接口,包括登录接口、获取字段设置信息接口、获取电子公文系统信息接口、同步收发文单位接口、公文发送接口、获取待接收数据接口、获取公文业务数据接口、发送反馈意见数据接口、获取反馈意见数据接口、发送操作状态已获取接口。电子公文系统通过定时轮询机制,调用获取待接收数据接口,获取公文及其状态变化信息。电子公文交换系统采用字符集UTF-8,电子公文系统在接入时,应避免字符集错误导致的接口调用异常。登录接口 接口名称:login。功能说明:用户登录时验证用户合法性,并返回合法性结果。接口的请求参数见表1,返回值结果见表2。表1 请
8、求参数 参数名 类型 必选 参数说明 loginId String 是 用户登录名 password String 是 用户登录密码 loginType Int 是 登录方式(0 数据库验证,1 动态密码验证,2 LDAP验证)ipAddress String 是 用户IP地址 表2 返回值结果 参数名 类型 必选 参数说明 sessionCode String 是 1:返回空值,表示登录失败,应提示报错 2:返回用户唯一标识码(32位UUID),表示登录成功 获取字段设置信息接口 接口名称:getExchangeFields。功能说明:获取电子公文交换系统字段设置信息。请求参数见表3,返回值
9、结果见表4。表3 请求参数 参数名 类型 必选 参数说明 sessionCode String 是 用户唯一标识码(32位UUID)DB41/T 30462025 4 表4 返回值结果 参数名 类型 必选 参数说明 string String 是 此用户所在单位配置交换字段信息 获取电子公文系统信息接口 接口名称:getAccessSystemData。功能说明:通过sessionCode(用户唯一标识码)从电子公文交换系统获取登录用户的系统编码、系统名称、系统描述。请求参数见表5,返回值结果见表6。表5 请求参数 参数名 类型 必选 参数说明 sessionCode String 是 用户唯
10、一标识码(32位UUID)表6 返回值结果 参数名 类型 必选 参数说明 result Int 是 0:成功 1:失败 Response_Msg String 是 反馈详情 Ws_Access_Syscode String 是 系统编码 Ws_Access_Sysname String 是 系统名称 Ws_Access_Sysdesc String 是 系统描述 同步收发文单位接口 接口名称:synchronizeOdocExchangeReceiveOrSendUnit。功能说明:通过sessionCode(用户唯一标识码)从电子公文交换系统获取登录系统的收发文单位。请求参数见表7,返回值结
11、果见表8。表7 请求参数 参数名 类型 必选 参数说明 sessionCode String 是 用户唯一标识码(32位UUID)表8 返回值结果 参数名 类型 必选 参数说明 result Int 是 0:成功 1:失败 DB41/T 30462025 5 表8 返回值结果(续)参数名 类型 必选 参数说明 Response_Msg String 是 反馈详情 systemCode String 是 系统编码 systemName String 是 系统名称 receiveorSendUnitCode String 是 此系统下的单位编码 receiveorSendUnitName Stri
12、ng 是 此系统下的单位名称 公文发送接口 接口名称:sendData。功能说明:发送公文时调用,电子公文系统调用该接口将公文数据上传到电子公文交换系统,电子公文交换系统返回发送状态、公文标识和反馈详情。请求参数见表9,返回值结果见表10。表9 请求参数 参数名 类型 必选 参数说明 appData String 是 公文数据,XML格式 sessionCode String 是 用户唯一标识码(32位UUID)表10 数据结构说明 参数名 类型 必选 参数说明 Document_Identifier String 否 公文标识,发文的唯一标识 取值符合GB/T 33477要求 issuer
13、是 发文单位 Identification_of_Document_Issuer String 是 发文单位唯一标识 Name_of_Document_Issuer String 是 发文单位名称 receiver 是 收文单位 Identification_of_Document_Receiver String 是 收文单位唯一标识 Name_of_Document_Receiver String 是 收文单位名称 Plaintext_Message 是 明文报文 type String 是 报文类型,取值范围:公文(OFC)、公文短报文(RET)Document_Type String 否
14、 公文的种类,取值符合GB/T 33480规定 Serial_Number_of_Copies String 否 份号,6位数字 取值示例:000001 Security_Classification_And_Duration String 是 默认为非密 Emergency_Degree String 否 紧急程度,公文的紧急程度取值为特急、加急、无,电报的紧急程度取值为特提、特急、加急、平急、无 DB41/T 30462025 6 表10 数据结构说明(续)参数名 类型 必选 参数说明 Issued_Number_of_Document String 否 发文字号,取值示例:XX 发201
15、610 号 signer String 否 签发人,取值示例:张XX李XX Document_Title String 是 公文标题 Main_Receiver_Department String 否 主送机关,取值示例:XX市政府办公厅XX市委办公厅 attachment String 否 附件说明,取值示例:关于 XX 的调查报告关于 XX 事宜的调查方案 Signature_of_Document_Issuing_Agency String 否 发文机关署名,应与发送机关标志中的发文机关名称一致,取值示例:XX市政府 Issued_Date_of_Document String 是 成文
16、日期,格式为 YYYY-MM-DD 取值示例:2023-04-16 Annotation String 否 附注 Copy_to_Department String 否 抄送机关 Printing_And_Sending_Department String 否 印发机关 Printing_Date String 否 印发日期,格式为 YYYY-MM-DD 取值示例:2023-04-15 Release_Level String 否 发布层次,即公文允许传达的范围 可取值:公开发布、依申请公开、不公开 Document_Text 是 正文 Document_Text_Name String 是
17、正文标题 Document_Text_Content String 是 正文内容,采用Base64将二进制数据转化为 ASCII字符 Document_Attachments 否 附件列表 Attachment_Detail 否 附件明细 Name_of_Attachment String 是 附件名称 Extension_of_Attachment String 是 附件扩展名 MD5_of_Attachment String 是 附件MD5值,校验文件完整性 Identification_of_Attachment String 是 附件唯一标识 Size_of_Attachment St
18、ring 否 附件大小,不超过100M Content_of_Attachment String 是 附件内容,采用Base64将二进制数据转化为ASCII字符 表11 返回值结果 参数名 类型 必选 参数说明 result Int 是 返回状态码,取值范围为0、2、3、4、5、6、7、8、9,具体含义见附录B Document_Identifierss String 是 公文标识 Response_Msg String 是 反馈详细信息 DB41/T 30462025 7 获取待接收数据接口 接口名称:getAllUnProcessData。功能说明:接收公文时调用,电子公文系统发起请求,电
19、子公文交换系统返回待处理的公文列表,包括公文业务数据、公文反馈数据。请求参数见表12,返回值结果见表13。表12 请求参数 参数名 类型 必选 参数说明 docType String 是 文档类型 取值范围:公文业务数据、公文反馈数据 sessionCode String 是 用户唯一标识码(32位UUID)表13 返回值结果 参数名 类型 必选 参数说明 allUnProcessData String 是 待处理的文档列表 result Int 是 返回状态码,取值范围为0、2、3、10、11,具体含义见附录B Response_Msg String 是 反馈详细信息 receiveId I
20、nt 是 公文路由的唯一标识 获取公文业务数据接口 接口名称:receiveData。功能说明:接收公文时调用,电子公文系统根据公文路由唯一标识,从电子公文交换系统获取公文业务数据。请求参数见表14,数据结构说明见表15。表14 请求参数 参数名 类型 必选 参数说明 routeId Int 是 路由唯一标识 sessionCode String 是 用户唯一标识码(32位UUID)表15 数据结构说明 参数名 类型 必选 参数说明 Document_Identifier String 是 公文标识,发文的唯一标识 取值符合GB/T 33477要求 issuer 是 发文单位 Identifi
21、cation_of_Document_Issuer String 是 发文单位唯一标识 DB41/T 30462025 8 表15 数据结构说明(续)参数名 类型 必选 参数说明 Name_of_Document_Issuer String 是 发文单位名称 receiver 是 收文单位 Identification_of_Document_Receiver String 是 收文单位唯一标识 Name_of_Document_Receiver String 是 收文单位名称 Plaintext_Message 是 明文报文 type String 是 报文类型,取值范围:公文(OFC)、公
22、文短报文(RET)Document_Type String 否 公文的种类,取值符合GB/T 33480规定 Serial_Number_of_Copies String 否 份号,6位数字 取值示例:000001 Security_Classification_And_Duration String 是 默认为非密 Emergency_Degree String 否 紧急程度,公文的紧急程度取值为特急、加急、无,电报的紧急程度取值为特提、特急、加急、平急、无 Issued_Number_of_Document String 否 发文字号,取值示例:XX发202310号 signer Stri
23、ng 否 签发人,取值示例:张XX李XX Document_Title String 是 公文标题 Main_Receiver_Department String 否 主送机关,取值示例:XX市政府办公厅XX市委办公厅 attachment String 否 附件说明,取值示例:关于XX的调查报告关于XX事宜的调查方案 Signature_of_Document_Issuing_Agency String 否 发文机关署名,应与发送机关标志中的发文机关名称一致,取值示例:XX市政府 Issued_Date_of_Document String 是 成文日期,格式为YYYY-MM-DD 取值示例
24、2023-04-16 annotation String 否 附注 Copy_to_Department String 否 抄送机关 Printing_And_Sending_Department String 否 印发机关 Printing_Date String 否 印发日期,格式为YYYY-MM-DD 取值示例:2023-04-15 Release_Level String 否 发布层次,即公文允许传达的范围 可取值:公开发布、依申请公开、不公开 Document_Text 否 正文 Document_Text_Name String 否 正文标题 Document_Text_Cont
25、ent String 否 正文内容,采用Base64将二进制数据转化为ASCII字符 Document_Attachments 否 附件列表 Attachment_Detail 否 附件明细 Name_of_Attachment String 是 附件名称 DB41/T 30462025 9 表15 数据结构说明(续)参数名 类型 必选 参数说明 Extension_of_Attachment String 是 附件扩展名 MD5_of_Attachment String 是 附件MD5值,校验文件完整性 Identification_of_Attachment String 是 附件唯一标识
26、 Size_of_Attachment String 否 附件大小 Content_of_Attachment String 是 附件内容 发送反馈意见数据接口 接口名称:postDocOperateData。功能说明:电子公文系统发送反馈信息时调用,将电子公文系统公文反馈数据(撤销、作废、签收、拒收、退回、办结)上传到电子公文交换系统。请求参数见表16,数据结构说明见17,返回值结果见表18。表16 请求参数 参数名 类型 必选 参数说明 sessionCode String 是 用户唯一标识码(32位UUID)表17 数据结构说明 参数名 类型 必选 参数说明 Document_Ident
27、ifier String 是 原公文标识 issuer 是 发文单位 Identification_of_Document_Issuer String 是 原发文单位唯一标识 Name_of_Document_Issuer String 是 原发文单位名称 receiver 是 原收文单位 Identification_of_Document_Receiver String 是 原收文单位唯一标识 Name_of_Document_Receiver String 是 原收文单位名称 Plaintext_Message 是 明文报文 type String 是 报文类型,RET:公文短报文 Bu
28、siness_Type String 是 业务类型,取值范围:撤销(Revoked)、作废(Cancelled)、签收(Accepted)、拒收(Rejected)、退回(Sendedback)、办结(Finished)operator String 否 操作者 Operate_Date String 否 操作日期,格式为YYYY-MM-DD 取值示例:2023-09-06 Operate_Time String 否 操作时间,格式为HH:mm:ss:sss 取值示例:11:52:08:008 note String 否 意见备注 DB41/T 30462025 10 表17 数据结构说明(续
29、参数名 类型 必选 参数说明 time String 是 本报文生成时间 格式为:YYYY-MM-DDTHH:mm:ss 取值示例:2023-09-06T11:52:08 表18 返回值结果 参数名 类型 必选 参数说明 result Int 是 返回状态码,取值范围为0、2、3、4、5、12、13,具体含义见附录B Response_Msg String 是 反馈详细信息 获取反馈意见数据接口 接口名称:getDocOperateData。功能说明:电子公文系统接收反馈信息时调用,电子公文系统从电子公文交换系统获取公文反馈数据(撤销、作废、签收、拒收、办理、办结)。请求参数见表19,返回值
30、结果见表20,数据结构说明见表21。表19 请求参数 参数名 类型 必选 参数说明 routeId Int 是 路由唯一标识 sessionCode String 是 用户唯一标识码(32位UUID)表20 返回值结果 参数名 类型 必选 参数说明 unProcessOperateData String 是 公文反馈数据 表21 数据结构说明 参数名 类型 必选 参数说明 Document_Identifier String 是 原公文标识 issuer 是 发文单位 Identification_of_Document_Issuer String 是 原发文单位唯一标识 Name_of_Do
31、cument_Issuer String 是 原发文单位名称 receiver 是 原收文单位 Identification_of_Document_Receiver String 是 原收文单位唯一标识 Name_of_Document_Receiver String 是 原收文单位名称 Plaintext_Message 是 明文报文 DB41/T 30462025 11 表21 数据结构说明(续)参数名 类型 必选 参数说明 type String 是 报文类型,RET:公文短报文 Bissiness_Type String 是 业务类型,取值范围:撤销(Revoked)、作废(Canc
32、elled)、签收(Accepted)、拒收(Rejected)、办理(Handled)、办结(Finished)operator String 否 操作者 Operate_Date String 否 操作日期,格式为YYYY-MM-DD 取值示例:2023-09-06 Operate_Time String 否 操作时间,格式为HH:mm:ss:sss 取值示例:11:52:08:008 note String 否 意见备注 time String 是 本报文生成时间 格式为:YYYY-MM-DDTHH:mm:ss 取值示例:2023-09-06T11:52:08 发送操作状态已获取接口 接
33、口名称:postReceivedOperateStatusData。功能说明:电子公文系统收到操作意见状态后调用,发送公文操作意见数据已获取的信息。请求参数见表22,返回值结果见表23。表22 请求参数 参数名 类型 必选 参数说明 operateId Int 是 路由唯一标识 sessionCode String 是 用户唯一标识码(32位UUID)表23 返回值结果 参数名 类型 必选 参数说明 result Int 是 返回状态码,取值范围为0、2、3、10、12,具体含义见附录B Response_Msg String 是 反馈详情 8 接入安全 基本要求 电子公文系统应符合下列基本要
34、求:a)应基于电子政务外网运行;b)应通过网络安全等级保护第三级(含)以上认证;DB41/T 30462025 12 c)应通过商用密码应用安全性评估。传输安全 数据传输应使用TLS 1.3或国密SSL协议,不应使用弱加密算法。数据保护 电子公文系统数据处理应符合下列要求:a)应至少采用 SM4 算法进行加密存储;b)应实施字段级、文件级、卷级分层加密;c)不应明文存储非公开数据;d)在开发、测试、分析等非生产环境使用生产数据时,应对数据进行脱敏处理。DB41/T 30462025 13 A A 附录A (资料性)电子公文交换系统接入申请表 电子公文交换系统接入申请表见表A.1。表A.1 电子
35、公文交换系统接入申请表 申请单位 联系人及联系方式 电子公文系统名称 电子政务外网IP地址 电子公文系统使用单位 接入事项说明 日 期:单位盖章:DB41/T 30462025 14 B B 附录B (资料性)返回状态码 返回状态码含义见表B.1。表B.1 返回状态码 返回状态码 描述 0 成功 1 失败 2 调用接口参数错误 3 获取调用者信息失败 4 解析XML失败 5 数据校验未通过 6 写入XML数据失败 7 正文生成失败 8 附件生成失败 9 保存数据到交换系统失败 10 未查询到数据 11 生成XML数据失败 12 更新数据失败 13 反馈意见状态不合法 C C D D DB41/T 30462025 15 参考文献 1 GB/T 33476.12016 党政机关电子公文格式 第1部分公文结构 2 GB/T 334822016 党政机关电子公文系统建设规范