DB37T 4679-2023“山東通”協(xié)同辦公平臺(tái) 電子公文接入要求

ICS35.240.99CCSL67ICS35.240.99CCSL67山 東 省 地 方 標(biāo) 準(zhǔn)DB37/T4679—2023“山東通”協(xié)同辦公平臺(tái)電子公文接入要求"Shandongtong"collaborativeofficeplatform—Electronicofficialdocumentaccessrequirements2023-12-28發(fā)布 2024-01-28實(shí)施山東省場(chǎng)監(jiān)理局 發(fā)布DB37/T4679DB37/T4679—2023II目 次前言 II112范引文件 13語(yǔ)定義 14略語(yǔ) 15入系 16入程 26.1概述 26.2準(zhǔn)階段 26.3登階段 26.4接階段 26.5運(yùn)階段 37入口 38入全 3附錄A（料）接注銷請(qǐng)表 4附錄B（范）接信息 5B.1獲組機(jī)列口 5B.2發(fā)接口 5B.3接接口 6B.4發(fā)回接口 7B.5報(bào)文獲接口 7B.6文上接口 8B.7文獲接口 9附錄C（范）電公文文型格式 10C.1電公文格式 10C.2電公簽文式 11C.3電公修文式 12C.4電公作文式 13C.5電公反文式 13參考獻(xiàn) 16DB37/T4679DB37/T4679—2023IIII前 言本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。DB37/T4679DB37/T4679—2023PAGEPAGE1"山東通"協(xié)同辦公平臺(tái)電子公文接入要求范圍（本文件適用于指導(dǎo)各級(jí)單位業(yè)務(wù)系統(tǒng)接入公文交換系統(tǒng)。（GB/T7408—2005數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法GB/T19488.2—2008電子政務(wù)數(shù)據(jù)元第2部分：公共數(shù)據(jù)元目錄GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求下列術(shù)語(yǔ)和定義適用于本文件。3.1電子文 electronicofficialdocumentGB/T33476.1—20163.1]3.2授信碼 creditcode用于識(shí)別接入系統(tǒng)身份和驗(yàn)證接入系統(tǒng)有效性的字符串?？s略語(yǔ)下列縮略語(yǔ)適用于本文件。ID：身份標(biāo)識(shí)號(hào)碼（IdentityDocument）OFD（OpenFixedLayoutDocument）PDF（PortableDocumentFormat）UUID（UniversallyUniqueIdentifier）1圖1 接入系概述準(zhǔn)備階段接入準(zhǔn)備準(zhǔn)備階段接入準(zhǔn)備登記階段接入登記接入階段數(shù)據(jù)接入服務(wù)接入流程接入運(yùn)維階段運(yùn)行維護(hù)圖2 接入程接入單位應(yīng)提交公文交換系統(tǒng)接入申請(qǐng)，申請(qǐng)表見(jiàn)附錄A。申請(qǐng)通過(guò)后獲取授信代碼。接入后的運(yùn)維工作，包括但不限于：A接入單位業(yè)務(wù)系統(tǒng)接入公文交換系統(tǒng)的接口應(yīng)符合接口目錄，見(jiàn)表1。各接口的輸入?yún)?shù)、輸出參數(shù)等接口說(shuō)明應(yīng)符合附錄B的相關(guān)規(guī)定。在進(jìn)行報(bào)文組裝和解析時(shí)，應(yīng)符合附錄C的相關(guān)規(guī)定。表1 接口錄序號(hào)接口名稱1獲取組織機(jī)構(gòu)列表接口2發(fā)送接口3接收接口4發(fā)送回執(zhí)接口5報(bào)文文件下載接口6文件上傳接口7文件獲取接口接入單位業(yè)務(wù)系統(tǒng)接入公文交換系統(tǒng)時(shí)安全要求包括但不限于：GB/T22239—2019Token附錄A（）接入接入/注銷申請(qǐng)表見(jiàn)表A.1。表A.1接入/注銷申請(qǐng)表日期：申請(qǐng)單位聯(lián)系人姓名聯(lián)系方式系統(tǒng)所在網(wǎng)絡(luò)環(huán)境□公共服務(wù)域□行政服務(wù)域業(yè)務(wù)類別□系統(tǒng)接入□系統(tǒng)注銷系統(tǒng)信息系統(tǒng)名稱：接入單位名稱：全省統(tǒng)一用戶管理系統(tǒng)中接入單位的UUID：申請(qǐng)單位意見(jiàn)（蓋章）省大數(shù)據(jù)主管部門意見(jiàn)（蓋章）備注DB37/T4679DB37/T4679—2023PAGE6附錄B（該接口用于獲取本單位可以發(fā)送公文的組織機(jī)構(gòu)列表。輸入?yún)?shù)見(jiàn)表B.1，輸出參數(shù)見(jiàn)表B.2。表B.1序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2organizeID單位ID必選發(fā)送機(jī)關(guān)的身份標(biāo)識(shí)表B.2序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤02：授信代碼錯(cuò)誤03：授信代碼超期04：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—3organizationInfo組織機(jī)構(gòu)—4groupName分組名稱一個(gè)或多個(gè)分組5organization單位一個(gè)或多個(gè)單位6organizationId單位標(biāo)識(shí)—7organizationName單位名稱一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2中的“機(jī)構(gòu)名稱”該接口用于向接收單位發(fā)送指定格式的報(bào)文文件。輸入?yún)?shù)見(jiàn)表B.3，輸出參數(shù)見(jiàn)表B.4。表B.3輸入?yún)?shù)序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選根據(jù)本單位ID、收發(fā)員賬號(hào)和密碼獲取一個(gè)存在有效期的授信代碼2message報(bào)文文件內(nèi)容必選見(jiàn)附錄C電子公文報(bào)文類型及格式表B.4輸出參數(shù)序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤02：授信代碼錯(cuò)誤03：授信代碼超期04：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—該接口用于從公文交換系統(tǒng)中獲取發(fā)往本單位電子文件的基本信息。輸入?yún)?shù)見(jiàn)表B.5，輸出參數(shù)見(jiàn)表B.6。表B.5序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2receiveType接收類型必選00：全部類型01：公文文件02：公文簽收文件03：公文作廢文件04：公文反饋文件05：公文修改文件表B.6序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤02：授信代碼錯(cuò)誤03：授信代碼超期04：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—3msgType類型000102：公文簽收文件03：公文作廢文件04：公文反饋文件05：公文修改文件4officialDocCount本次取得文件件數(shù)—5officialDocTotal文件總件數(shù)—6organizeID單位ID—DB37/T4679DB37/T4679—2023PAGEPAGE7表B.6輸出參數(shù)（續(xù)）序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注7organizeName單位名稱一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”8file報(bào)文文件一條或多條記錄B.7B.8表B.7序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2fileId報(bào)文文件ID可選—表B.8序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤020304：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—該接口用于根據(jù)接收接口中獲取的文件ID獲取報(bào)文文件。輸入?yún)?shù)見(jiàn)表B.9，輸出參數(shù)見(jiàn)表B.10。表B.9序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2fileId報(bào)文文件ID可選—表B.10序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤02：授信代碼錯(cuò)誤03：授信代碼超期04：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—表B.10輸出參數(shù)（續(xù)）序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注3attachmentId報(bào)文文件ID—4attachmentName報(bào)文文件名—5attachmentCon報(bào)文內(nèi)容發(fā)送單位通過(guò)發(fā)送接口發(fā)送的文件Base64Base64B.12表B.11序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2attachName上傳的文件名必選含后綴名3base64Str文件二進(jìn)制內(nèi)容的Base64編碼必選—表B.12序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤02：授信代碼錯(cuò)誤03：授信代碼超期04：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—3attachId文件ID公文或附件文件上傳后所具有的唯一標(biāo)識(shí)該接口用于各單位以二進(jìn)制流數(shù)組方式向公文交換系統(tǒng)文件服務(wù)器上傳文件。輸入?yún)?shù)見(jiàn)表B.13，輸出參數(shù)見(jiàn)表B.14。表B.13輸入?yún)?shù)序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2attachName上傳的文件名必選含后綴名3content文件二進(jìn)制流數(shù)組必選—DB37/T4679DB37/T4679—2023PAGEPAGE10表B.14輸出參數(shù)序號(hào)參數(shù)名稱參數(shù)說(shuō)明備注1errorFlag錯(cuò)誤標(biāo)識(shí)00：正常01：參數(shù)錯(cuò)誤02：授信代碼錯(cuò)誤03：授信代碼超期04：系統(tǒng)錯(cuò)誤2errMsg錯(cuò)誤信息—3attachId文件ID公文或附件文件上傳后所具有的唯一標(biāo)識(shí)Base64該接口用于各單位以Base64編碼方式獲取公文交換系統(tǒng)文件服務(wù)器上的文件。輸入?yún)?shù)見(jiàn)表B.15，輸出結(jié)果為文件二進(jìn)制內(nèi)容的Base64編碼，若獲取不到文件，則內(nèi)容為空。表B.15輸入?yún)?shù)序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2attachId文件ID必選—B.16，表B.16輸入?yún)?shù)序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1transCode授信代碼必選系統(tǒng)分配，50位以內(nèi)2attachId文件ID必選—附錄C（規(guī)范性）電子公文報(bào)文類型及格式電子公文文件格式見(jiàn)表C.1。表C.1電子公文文件格式序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1messageId報(bào)文標(biāo)識(shí)必選唯一標(biāo)識(shí)2messageType報(bào)文屬性必選固定為01，表示公文文件3mobileFlag移動(dòng)端獲取標(biāo)識(shí)必選0：不允許1：允許4internetFlag公共服務(wù)域獲取標(biāo)識(shí)必選0：不允許1：允許5sendOrganization報(bào)文發(fā)送單位必選—6organizationId身份標(biāo)識(shí)必選—7organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—2008中5.2中的“機(jī)構(gòu)名稱”8organizationDes身份描述可選—9receiveOrganization報(bào)文接收單位必選一個(gè)或多個(gè)10organizationId身份標(biāo)識(shí)必選—11organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—2008中5.2中的“機(jī)構(gòu)名稱”12organizationDes身份描述可選—13sendDate發(fā)出時(shí)間必選格式：YYYY-MM-DDGB/T7408—2005中5.4.1的要求14message信息必選—15type類型必選OFC：公文類型（默認(rèn)值）RET：公文短報(bào)文類型16fileType文件類型必選1：辦件2：閱件17handlingTime辦理時(shí)限必選格式：YYYY-MM-DD，應(yīng)符合GB/T7408—2005中5.2.1.1的要求18content內(nèi)容（OFC類型）可選—19secretLev密級(jí)和保密期限可選取值固定為“無(wú)”密級(jí)不應(yīng)固定為無(wú)20pressing緊急程度可選21sendOrg發(fā)送機(jī)關(guān)必選—表C.1 子文件式（序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注22receiveOrg接收機(jī)關(guān)必選—23title公文標(biāo)題必選—24officialDocType公文字號(hào)可選—25officialDocCode發(fā)文機(jī)關(guān)代字可選—26officialDocYear年份可選—27officialDocNo發(fā)文順序號(hào)可選—28contacts聯(lián)系人可選—29contactNum聯(lián)系方式可選—30officialDocName公文文件名必選應(yīng)為PDF、OFD格式的文件；31officialDocCon公文內(nèi)容可選—32officialDocId公文文件ID可選使用文件上傳接口將公文文件成功傳至服務(wù)器后返回的文件ID33attachmentInfo附件可選可為多個(gè)34attachmentName附件名稱必選含擴(kuò)展名，若存在附件該項(xiàng)為必選35attachmentSuffix擴(kuò)展名可選—36attachmentId附件標(biāo)識(shí)必選保證唯一性，若存在附件該項(xiàng)為必選37attachmentSize附件大小可選—38attachmentCon附件內(nèi)容可選附件文件二進(jìn)制流的Base編碼電子公文簽收文件格式見(jiàn)表C.2。表C.2電子公文簽收文件格式序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1messageId原報(bào)文標(biāo)識(shí)必選唯一標(biāo)識(shí)，簽收的公文ID2messageType報(bào)文屬性必選固定為02，表示公文簽收文件3mobileFlag移動(dòng)端獲取標(biāo)識(shí)必選0：不允許1：允許4internetFlag公共服務(wù)域獲取標(biāo)識(shí)必選0：不允許1：允許5sendOrganization報(bào)文發(fā)送單位必選—6organizationId身份標(biāo)識(shí)必選—7organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”8organizationDes身份描述可選—9receiveOrganization報(bào)文接收單位必選一個(gè)或多個(gè)10organizationId身份標(biāo)識(shí)必選—表C.2 子文收件格（序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注11organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”12organizationDes身份描述可選—13operationType業(yè)務(wù)類型必選Accepted：簽收14operationTime時(shí)間必選—15operator操作人必選—16operatorOrg操作人處室（科室）必選—17operatorPhone操作人電話必選—18operationCon附言可選—電子公文修改文件格式見(jiàn)表C.3。表C.3電子公文修改文件格式序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1messageId報(bào)文標(biāo)識(shí)必選原報(bào)文標(biāo)識(shí)2messageType報(bào)文屬性必選固定為05，表示公文修改文件3mobileFlag移動(dòng)端獲取標(biāo)識(shí)必選0：不允許1：允許4internetFlag公共服務(wù)域獲取標(biāo)識(shí)必選0：不允許1：允許5sendOrganization報(bào)文發(fā)送單位必選—6organizationId身份標(biāo)識(shí)必選—7organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”8organizationDes身份描述可選—9receiveOrganization報(bào)文接收單位必選一個(gè)或多個(gè)10organizationId身份標(biāo)識(shí)必選—11organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”12organizationDes身份描述可選—13sendDate發(fā)出時(shí)間必選格式：YYYY-MM-DDhh:mm:ss，應(yīng)符GB/T7408—20055.4.1表C.3 子文改件格（序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注14fileType文件類型必選1：辦件2：閱件15handlingTime辦理時(shí)限可選GB/T7408—20055.2.1.1值為空時(shí)表示不變更辦理時(shí)限16handlingTimeCancel辦理時(shí)限取消標(biāo)識(shí)可選值為1時(shí)表示該公文取消辦理時(shí)限值為空時(shí)表示該公文變更辦理時(shí)限17modificationReason辦理時(shí)限修改原因必選取消及修改辦理時(shí)限時(shí)填寫(xiě)18approver批準(zhǔn)人必選—19operator經(jīng)辦人必選—電子公文作廢文件格式見(jiàn)表C.4。表C.4電子公文作廢文件格式序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1messageId原報(bào)文標(biāo)識(shí)必選唯一標(biāo)識(shí)2messageType報(bào)文屬性必選固定為03，表示公文作廢文件3mobileFlag移動(dòng)端獲取標(biāo)識(shí)必選0：不允許1：允許4internetFlag公共服務(wù)域獲取標(biāo)識(shí)必選0：不允許1：允許5sendOrganization報(bào)文發(fā)送單位必選—6organizationId身份標(biāo)識(shí)必選—7organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”8organizationDes身份描述可選—9receiveOrganization報(bào)文接收單位必選一個(gè)或多個(gè)10organizationId身份標(biāo)識(shí)必選—11organization身份名稱必選一般使用單位全稱，應(yīng)符合GB/T19488.2—20085.2稱”12organizationDes身份描述可選—13deleteReason作廢原因必選—電子公文反饋文件格式見(jiàn)表C.5。表C.5電子公文反饋文件格式序號(hào)參數(shù)名稱參數(shù)說(shuō)明約束備注1messageId原報(bào)文標(biāo)識(shí)必選唯一標(biāo)識(shí)2messageType報(bào)文屬性必選固定為04，表示公文反饋文件3mobileFlag移動(dòng)端獲取標(biāo)識(shí)必選0：不允許1：允許4internetFlag公共服務(wù)域獲取標(biāo)識(shí)必選0：不允許1：允許5sendOrganization報(bào)文發(fā)送單位必選—6organizationId身份標(biāo)識(shí)必選—7organiz