DB37_T 4679-2023 “山东通”协同办公平台电子公文接入要求.docx

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