DB37∕T 4679-2023 “山东通”协同办公平台 电子公文接入要求(山东省).pdf

ICS 35.240.99 CCS L 67 37 山东省地方标准 DB37/T 46792023 “山东通”协同办公平台 电子公文接入要求 Shandongtong collaborative office platformElectronic official document access requirements 2023-12-28 发布 2024-01-28 实施 山东省市场监督管理局 发 布 DB37/T 46792023 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 接入关系.1 6 接入流程.2 概述.2 6.1 准备阶段.2 6.2 登记阶段.2 6.3 接入阶段.2 6.4 运维阶段.3 6.5 7 接入接口.3 8 接入安全.3 附录 A（资料性）接入/注销申请表.4 附录 B（规范性）接口信息.5 B.1 获取组织机构列表接口.5 B.2 发送接口.5 B.3 接收接口.6 B.4 发送回执接口.7 B.5 报文文件获取接口.7 B.6 文件上传接口.8 B.7 文件获取接口.9 附录 C（规范性）电子公文报文类型及格式.10 C.1 电子公文文件格式.10 C.2 电子公文签收文件格式.11 C.3 电子公文修改文件格式.12 C.4 电子公文作废文件格式.13 C.5 电子公文反馈文件格式.13 参考文献.16 DB37/T 46792023 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省大数据局提出、归口并组织实施。DB37/T 46792023 1 山东通协同办公平台 电子公文接入要求 1 范围 本文件规定了各级单位承载电子公文办理业务的系统（以下简称“业务系统”）接入“山东通”协同办公平台电子公文交换系统（以下简称“公文交换系统”）的接入关系、接入流程、接入接口和接入安全。本文件适用于指导各级单位业务系统接入公文交换系统。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 74082005 数据元和交换格式 信息交换 日期和时间表示法 GB/T 19488.22008 电子政务数据元 第2部分：公共数据元目录 GB/T 222392019 信息安全技术 网络安全等级保护基本要求 3 术语和定义 下列术语和定义适用于本文件。3.1 电子公文 electronic official document 以数字形式存储于磁盘、光盘等媒体，依赖计算机系统阅读、处理并可在通信网络上传输的公文。来源：GB/T 33476.12016，定义3.1 3.2 授信代码 credit code 用于识别接入系统身份和验证接入系统有效性的字符串。4 缩略语 下列缩略语适用于本文件。ID：身份标识号码（Identity Document）OFD：开放式版式文件（Open Fixed Layout Document）PDF：便携式文档格式（Portable Document Format）UUID：通用唯一识别码（Universally Unique Identifier）5 接入关系 DB37/T 46792023 2 公文交换系统接入关系为省级业务系统、市级业务系统和县级业务系统接入公文交换系统，公文交换系统接入关系见图1。公文交换系统作为电子政务外网的办公数据交换枢纽，用于支撑全省的电子公文收发需求及业务数据的互联互通。各级单位业务系统通过接入公文交换系统完成电子公文和业务数据的传递。图1 接入关系 6 接入流程 概述 6.1 业务系统接入公文交换系统流程主要包括准备、登记、接入和运维四个阶段，接入流程见图2。接入准备准备阶段接入登记登记阶段数据接入服务接入流程接入接入阶段运行维护运维阶段 图2 接入流程 准备阶段 6.2 接入单位应梳理业务需求及系统建设情况，根据公文交换系统提供的接口信息，对系统进行开发或适配性改造，以支撑电子公文的收发和相关数据的交换。登记阶段 6.3 接入单位应提交公文交换系统接入申请，申请表见附录A。申请通过后获取授信代码。接入阶段 6.4 接入单位获取授信代码后，应开展业务系统与公文交换系统的组织机构等数据信息的对接、接口服务的对接、业务流程的对接，并进行相关测试，完成接入。DB37/T 46792023 3 运维阶段 6.5 接入后的运维工作，包括但不限于：a)接入单位应指定相关人员开展系统的缺陷修正及更新发布等工作；b)业务系统注销时，应填写申请表，申请通过后进行系统注销，申请表见附录 A。7 接入接口 接入单位业务系统接入公文交换系统的接口应符合接口目录，见表1。各接口的输入参数、输出参数等接口说明应符合附录B的相关规定。在进行报文组装和解析时，应符合附录C的相关规定。表1 接口目录 序号 接口名称 1 获取组织机构列表接口 2 发送接口 3 接收接口 4 发送回执接口 5 报文文件下载接口 6 文件上传接口 7 文件获取接口 8 接入安全 接入单位业务系统接入公文交换系统时安全要求包括但不限于：a)接入单位业务系统应符合 GB/T 222392019 中的第二级及以上安全等级保护要求；b)接入单位业务系统调用接口时应进行 Token 验证；c)应定期对接口调用情况进行监测，发现异常应及时上报公文交换系统管理人员。DB37/T 46792023 4 A A 附录A （资料性）接入/注销申请表 接入/注销申请表见表A.1。表A.1 接入/注销申请表 日期：申请单位 联系人姓名 联系方式 系统所在网络环境 公共服务域 行政服务域 业务类别 系统接入 系统注销 系统信息 系统名称：接入单位名称：全省统一用户管理系统中接入单位的 UUID：申请单位意见（盖章）省大数据主管部门 意见（盖章）备注 DB37/T 46792023 5 B B 附录B （规范性）接口信息 B.1 获取组织机构列表接口 该接口用于获取本单位可以发送公文的组织机构列表。输入参数见表B.1，输出参数见表B.2。表B.1 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 organizeID 单位 ID 必选 发送机关的身份标识 表B.2 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 3 organizationInfo 组织机构 4 groupName 分组名称 一个或多个分组 5 organization 单位 一个或多个单位 6 organizationId 单位标识 7 organizationName 单位名称 一般使用单位全称，应符合GB/T 19488.22008 中 5.2中的“机构名称”B.2 发送接口 该接口用于向接收单位发送指定格式的报文文件。输入参数见表B.3，输出参数见表B.4。表B.3 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 根据本单位 ID、收发员账号和密码获取一个存在有效期的授信代码 2 message 报文文件内容 必选 见附录 C 电子公文报文类型及格式 DB37/T 46792023 6 表B.4 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 B.3 接收接口 该接口用于从公文交换系统中获取发往本单位电子文件的基本信息。输入参数见表B.5，输出参数见表B.6。表B.5 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 receiveType 接收类型 必选 00：全部类型 01：公文文件 02：公文签收文件 03：公文作废文件 04：公文反馈文件 05：公文修改文件 表B.6 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 3 msgType 类型 00：全部类型 01：公文文件 02：公文签收文件 03：公文作废文件 04：公文反馈文件 05：公文修改文件 4 officialDocCount 本次取得文件件数 5 officialDocTotal 文件总件数 6 organizeID 单位 ID DB37/T 46792023 7 表 B.6 输出参数（续）序号 参数名称 参数说明 备注 7 organizeName 单位名称 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”8 file 报文文件 一条或多条记录 B.4 发送回执接口 该接口用于向公文交换系统发送报文接收回执，发送回执成功后，再次调用接收接口时将不再获取该报文。输入参数见表B.7，输出参数见表B.8。表B.7 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 fileId 报文文件 ID 可选 表B.8 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 B.5 报文文件获取接口 该接口用于根据接收接口中获取的文件ID获取报文文件。输入参数见表B.9，输出参数见表B.10。表B.9 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 fileId 报文文件 ID 可选 表B.10 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 DB37/T 46792023 8 表 B.10 输出参数（续）序号 参数名称 参数说明 备注 3 attachmentId 报文文件 ID 4 attachmentName 报文文件名 5 attachmentCon 报文内容 发送单位通过发送接口发送的文件 B.6 文件上传接口 B.6.1 Base64编码方式 该接口用于各单位以Base64编码方式向公文交换系统文件服务器上传文件。输入参数见表B.11，输出参数见表B.12。表B.11 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 attachName 上传的文件名 必选 含后缀名 3 base64Str 文件二进制内容的 Base64 编码 必选 表B.12 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 3 attachId 文件 ID 公文或附件文件上传后所具有的唯一标识 B.6.2 二进制流数组方式 该接口用于各单位以二进制流数组方式向公文交换系统文件服务器上传文件。输入参数见表B.13，输出参数见表B.14。表B.13 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 attachName 上传的文件名 必选 含后缀名 3 content 文件二进制流数组 必选 DB37/T 46792023 9 表B.14 输出参数 序号 参数名称 参数说明 备注 1 errorFlag 错误标识 00：正常 01：参数错误 02：授信代码错误 03：授信代码超期 04：系统错误 2 errMsg 错误信息 3 attachId 文件 ID 公文或附件文件上传后所具有的唯一标识 B.7 文件获取接口 B.7.1 Base64编码方式 该接口用于各单位以Base64编码方式获取公文交换系统文件服务器上的文件。输入参数见表B.15，输出结果为文件二进制内容的Base64编码，若获取不到文件，则内容为空。表B.15 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 attachId 文件 ID 必选 B.7.2 二进制流数组方式 该接口用于各单位以二进制流数组方式获取公文交换系统文件服务器上的文件。输入参数见表B.16，输出结果为为数组类型的二进制文件，若获取不到文件，则内容为空。表B.16 输入参数 序号 参数名称 参数说明 约束 备注 1 transCode 授信代码 必选 系统分配，50 位以内 2 attachId 文件 ID 必选 DB37/T 46792023 10 C C 附录C （规范性）电子公文报文类型及格式 C.1 电子公文文件格式 电子公文文件格式见表C.1。表C.1 电子公文文件格式 序号 参数名称 参数说明 约束 备注 1 messageId 报文标识 必选 唯一标识 2 messageType 报文属性 必选 固定为01，表示公文文件 3 mobileFlag 移动端获取标识 必选 0：不允许 1：允许 4 internetFlag 公共服务域获取标识 必选 0：不允许 1：允许 5 sendOrganizationsendOrganization 报文发送单位报文发送单位 必选必选 6 organizationId 身份标识 必选 7 organization 身份名称 必选 一般使用单位全称，应符合GB/T 19488.22008中5.2中的“机构名称”8 organizationDes 身份描述 可选 9 receiveOrganizationreceiveOrganization 报文接收单位报文接收单位 必选必选 一个或多个一个或多个 10 organizationId 身份标识 必选 11 organization 身份名称 必选 一般使用单位全称，应符合GB/T 19488.22008中5.2中的“机构名称”12 organizationDes 身份描述 可选 13 sendDate 发出时间 必选 格式：YYYY-MM-DD hh:mm:ss，应符合GB/T 74082005中5.4.1的要求 14 message 信息 必选 15 type 类型 必选 OFC：公文类型（默认值）RET：公文短报文类型 16 fileType 文件类型 必选 1：办件 2：阅件 17 handlingTime 办理时限 必选 格式：YYYY-MM-DD，应符合GB/T 74082005中5.2.1.1的要求 18 contentcontent 内容（内容（OFCOFC类型）类型）可选可选 19 secretLev 密级和保密期限 可选 取值固定为“无”密级不应固定为无 20 pressing 紧急程度 可选 备选项：特急、特提、平急、加急、无；21 sendOrg 发送机关 必选 DB37/T 46792023 11 表 C.1 电子公文文件格式（续）序号 参数名称 参数说明 约束 备注 22 receiveOrg 接收机关 必选 23 title 公文标题 必选 24 officialDocType 公文字号 可选 25 officialDocCode 发文机关代字 可选 26 officialDocYear 年份 可选 27 officialDocNo 发文顺序号 可选 28 contacts 联系人 可选 29 contactNum 联系方式 可选 30 officialDocName 公文文件名 必选 应为PDF、OFD格式的文件；31 officialDocCon 公文内容 可选 32 officialDocId 公文文件ID 可选 使用文件上传接口将公文文件成功传至服务器后返回的文件ID 33 attachmentInfoattachmentInfo 附件附件 可选可选 可为多个可为多个 34 attachmentName 附件名称 必选 含扩展名，若存在附件该项为必选 35 attachmentSuffix 扩展名 可选 36 attachmentId 附件标识 必选 保证唯一性，若存在附件该项为必选 37 attachmentSize 附件大小 可选 38 attachmentCon 附件内容 可选 附件文件二进制流的Base编码 C.2 电子公文签收文件格式 电子公文签收文件格式见表C.2。表C.2 电子公文签收文件格式 序号 参数名称 参数说明 约束 备注 1 messageId 原报文标识 必选 唯一标识，签收的公文 ID 2 messageType 报文属性 必选 固定为 02，表示公文签收文件 3 mobileFlag 移动端获取标识 必选 0：不允许 1：允许 4 internetFlag 公共服务域获取标识 必选 0：不允许 1：允许 5 sendOrganizationsendOrganization 报文发送单位报文发送单位 必选必选 6 organizationId 身份标识 必选 7 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”8 organizationDes 身份描述 可选 9 receiveOrganizationreceiveOrganization 报文接收单位报文接收单位 必选必选 一个或多个一个或多个 10 organizationId 身份标识 必选 DB37/T 46792023 12 表 C.2 电子公文签收文件格式（续）序号 参数名称 参数说明 约束 备注 11 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”12 organizationDes 身份描述 可选 13 operationType 业务类型 必选 Received：送达 Accepted：签收 Rejected：驳回 14 operationTime 时间 必选 15 operator 操作人 必选 16 operatorOrg 操作人处室（科室）必选 17 operatorPhone 操作人电话 必选 18 operationCon 附言 可选 C.3 电子公文修改文件格式 电子公文修改文件格式见表C.3。表C.3 电子公文修改文件格式 序号 参数名称 参数说明 约束 备注 1 messageId 报文标识 必选 原报文标识 2 messageType 报文属性 必选 固定为 05，表示公文修改文件 3 mobileFlag 移动端获取标识 必选 0：不允许 1：允许 4 internetFlag 公共服务域获取标识 必选 0：不允许 1：允许 5 sendOrganizationsendOrganization 报文发送单位报文发送单位 必选必选 6 organizationId 身份标识 必选 7 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”8 organizationDes 身份描述 可选 9 receiveOrganizationreceiveOrganization 报文接收单位报文接收单位 必选必选 一个或多个一个或多个 10 organizationId 身份标识 必选 11 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”12 organizationDes 身份描述 可选 13 sendDate 发出时间 必选 格式：YYYY-MM-DD hh:mm:ss，应符合 GB/T 74082005 中 5.4.1 的要求 DB37/T 46792023 13 表 C.3 电子公文修改文件格式（续）序号 参数名称 参数说明 约束 备注 14 fileType 文件类型 必选 1：办件 2：阅件 15 handlingTime 办理时限 可选 格式：YYYY-MM-DD，应符合 GB/T 74082005 中 5.2.1.1 的要求；值为空时表示不变更办理时限 16 handlingTimeCancel 办理时限取消标识 可选 值为1时表示该公文取消办理时限 值为空时表示该公文变更办理时限 17 modificationReason 办理时限修改原因 必选 取消及修改办理时限时填写 18 approver 批准人 必选 19 operator 经办人 必选 C.4 电子公文作废文件格式 电子公文作废文件格式见表C.4。表C.4 电子公文作废文件格式 序号 参数名称 参数说明 约束 备注 1 messageId 原报文标识 必选 唯一标识 2 messageType 报文属性 必选 固定为 03，表示公文作废文件 3 mobileFlag 移动端获取标识 必选 0：不允许 1：允许 4 internetFlag 公共服务域获取标识 必选 0：不允许 1：允许 5 sendOrganizationsendOrganization 报文发送单位报文发送单位 必选必选 6 organizationId 身份标识 必选 7 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”8 organizationDes 身份描述 可选 9 receiveOrganizationreceiveOrganization 报文接收单位报文接收单位 必选必选 一个或多个一个或多个 10 organizationId 身份标识 必选 11 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”12 organizationDes 身份描述 可选 13 deleteReason 作废原因 必选 C.5 电子公文反馈文件格式 电子公文反馈文件格式见表C.5。DB37/T 46792023 14 表C.5 电子公文反馈文件格式 序号 参数名称 参数说明 约束 备注 1 messageId 原报文标识 必选 唯一标识 2 messageType 报文属性 必选 固定为 04，表示公文反馈文件 3 mobileFlag 移动端获取标识 必选 0：不允许 1：允许 4 internetFlag 公共服务域获取标识 必选 0：不允许 1：允许 5 sendOrganizationsendOrganization 报文发送单位报文发送单位 必选必选 6 organizationId 身份标识 必选 7 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”8 organizationDes 身份描述 可选 9 receiveOrganizationreceiveOrganization 报文接收单位报文接收单位 必选必选 一个或多个一个或多个 10 organizationId 身份标识 必选 11 organization 身份名称 必选 一般使用单位全称，应符合 GB/T 19488.22008 中 5.2 中的“机构名称”12 organizationDes 身份描述 可选 13 feedbackConfeedbackCon 反馈内容反馈内容 必选必选 14 fdType 反馈类型 必选 01：办理过程 02：办理结果 03：办结 15 fdOperation 操作 可选 反馈类型为 01 时，该字段备选项为拟办、批办、分办、转办（包括但不限于上述备选项）；类型为 02、03 时，该字段可为空 16 fdOperator 操作人 必选 17 fdOperatorDept 操作人处室（科室）必选 18 fdOperatorPhone 操作人联系方式 必选 19 fdTime 时间 必选 格式：YYYY-MM-DD hh:mm:ss，应符合 GB/T 74082005 中 5.4.1 的要求 20 fdContent 反馈内容正文 可选 反馈类型为 01 时，该字段为办理情况的具体内容，必选；反馈类型为 02 时，该字段为办理结果的具体内容，可选；反馈类型为 03 时，该字段为办结附言，可选 DB37/T 46792023 15 表 C.5 电子公文反馈文件格式（续）序号 参数名称 参数说明 约束 备注 21 attachmentInfoattachmentInfo 附件附件 可选可选 可可为为多个多个 22 attachmentName 附件名称 必选 含扩展名，若存在附件该项为必选 23 attachmentSuffix 扩展名 可选 24 attachmentId 附件标识 必选 保证唯一性，若存在附件该项为必选 25 attachmentSize 附件大小 可选 26 attachmentCon 附件内容 可选 二进制流的 Base64 编码 DB37/T 46792023 16 参考文献 1 GB/T 33476.12016 党政机关电子公文格式规范 第1部分：公文结构 2 党政机关公文处理工作条例（中办发201214号）3 山东省“十四五”数字强省建设规划。（鲁政字2021128号）