DB35T 2167-2024政務(wù)服務(wù) 公共資源交易公共服務(wù)系統(tǒng)數(shù)據(jù)接口要求

ICS01.040.35CCSL7035Administrativeservice—DatainterfacerequirementsofpublicresourcetradingIDB35/T2167—2024前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 25數(shù)據(jù)交換模式 26接口要求 4附錄A（資料性）接口示例 8附錄B（規(guī)范性）代碼集 參考文獻(xiàn) DB35/T2167—2024本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由福建省經(jīng)濟(jì)信息中心提出。本文件由福建省信息化標(biāo)準(zhǔn)化技術(shù)委員會（SAFJ/TC11）歸口。本文件起草單位：福建省經(jīng)濟(jì)信息中心、福建省公共資源交易公共服務(wù)平臺有限公司、福建元素信息科技有限公司、福建省網(wǎng)絡(luò)與信息安全測評中心、福州市公共資源交易中心、廈門市公共資源交易中心、泉州市公共資源交易中心、莆田市公共資源交易中心、漳州市公共資源交易中心、龍巖市公共資源交易服務(wù)中心、寧德市公共資源交易中心、三明市公共資源交易中心、南平市公共資源交易中心、福建省平潭綜合實驗區(qū)行政服務(wù)中心、福建省數(shù)字經(jīng)濟(jì)發(fā)展促進(jìn)中心、福州福大經(jīng)緯信息科技有限公司、福建省經(jīng)緯數(shù)字科技有限公司。本文件主要起草人：林平、江峰、林宗昭、陳旭輝、羅峰、李娟、吳陽、周偉東、高松濤、李志鍇、吳欽陽、鄭曉冬、陳勇志、陳少煌、孫宇斌、戴森河、甘立君、鐘順相、張斌、鄧婷、許志雄、蔡璐、蔡忠灝、曹杰、林曉楓、高陳晟、林泰崴、陳廣勝、姚峰、張曉晟、羅峰華、楊善峰、張文星、蘭美玲、何賜清、鐘木娟、張素欽、林荔晶。GB/T22239—2019信息安全技術(shù)網(wǎng)絡(luò)安全3.3公共資源交易電子交易平臺onlinepublicresourcetra公共資源交易電子公共服務(wù)平臺onlinepublicresourcetrading2DB35/T2167—20243.5公共資源交易公共服務(wù)系統(tǒng)publicresourcetradingservicesystem由電子行政監(jiān)督平臺、電子交易平臺和電子公共服務(wù)平臺組成的公共服務(wù)總稱。4縮略語下列縮略語適用于本文件。BLOB：二進(jìn)制大對象（BinaryLargeObjectBlock）CLOB：字符大對象（CharacterLargeObjectBlock）HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）JSON：輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）SFTP：一種安全的文件傳輸協(xié)議（SSHFileTransferProtocol）URL：統(tǒng)一資源定位符（UniformResourceLocator）XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）5數(shù)據(jù)交換模式5.1技術(shù)架構(gòu)電子公共服務(wù)平臺、電子行政監(jiān)督平臺和電子交易平臺之間數(shù)據(jù)交換的技術(shù)架構(gòu)見圖1，包括數(shù)據(jù)查詢接口和數(shù)據(jù)上傳接口。數(shù)據(jù)查詢接口：電子交易平臺通過電子公共服務(wù)平臺從電子行政監(jiān)督平臺獲取項目報建信息、項目備案審查信息。數(shù)據(jù)上傳接口：電子交易平臺通過接口上報公共資源交易過程數(shù)據(jù)到電子公共服務(wù)平臺。3DB35/T2167—2024圖1技術(shù)架構(gòu)圖5.2基本要求公共資源交易公共服務(wù)系統(tǒng)數(shù)據(jù)接口應(yīng)滿足以下要求：a)結(jié)構(gòu)化數(shù)據(jù)采用HTTPS協(xié)議傳輸；b)非結(jié)構(gòu)化數(shù)據(jù)交換通過SFTP協(xié)議實現(xiàn)；c)消息封裝采用JSON格式或XML格式；d)安全要求按照GB/T22239—2019第8章的規(guī)定；e)數(shù)據(jù)類型及格式見表1。表1數(shù)據(jù)類型說明表12）：4DB35/T2167—2024表1數(shù)據(jù)類型說明表（續(xù)）3YYYYMMDD：表示YYYY年MM月DD46接口要求6.1接口分類公共資源交易公共服務(wù)系統(tǒng)數(shù)據(jù)接口主要包括數(shù)據(jù)查詢接口和數(shù)據(jù)上傳接口，見圖2。數(shù)據(jù)查詢接口包括電子行政監(jiān)督平臺與電子交易平臺之間的獲取項目報建信息接口、獲取項目備案審查信息接口，電子公共服務(wù)平臺與電子交易平臺之間的獲取交易數(shù)據(jù)接口。數(shù)據(jù)上傳接口包括電子公共服務(wù)平臺與電子交易平臺之間的上傳結(jié)構(gòu)化交易數(shù)據(jù)接口、上傳非結(jié)構(gòu)化交易數(shù)據(jù)接口（不包括多媒體數(shù)據(jù)）和上傳多媒體接口。圖2公共資源交易數(shù)據(jù)接口分類6.2數(shù)據(jù)查詢接口6.2.1獲取項目報建信息接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口類型：WebService；c)接口名稱：GetBaoJianInfo；d)輸入/請求參數(shù)：見表2；e)輸出/返回參數(shù)：見表3；5DB35/T2167—2024f)請求示例：見附錄A的A.1.1；g)返回示例：見附錄A的A.1.2。表2獲取項目報建信息接口請求參數(shù)表1是2是表3獲取項目報建信息接口返回參數(shù)表1236.2.2獲取項目備案審查信息接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口類型：WebService；c)接口名稱：GetBeiAnInfo；d)輸入/請求參數(shù)：見表4；e)輸出/返回參數(shù)：見表5；f)請求示例：見附錄A的A.2.1；g)返回示例：見附錄A的A.2.2。表4獲取項目備案審查信息接口請求參數(shù)表1是2是表5獲取項目備案審查信息接口返回參數(shù)表1236DB35/T2167—20246.2.3獲取交易數(shù)據(jù)接口電子交易平臺通過此接口從電子公共服務(wù)平臺獲取交易數(shù)據(jù)，主要包括信用分?jǐn)?shù)據(jù)、工程建設(shè)項目交易數(shù)據(jù)、政府采購交易數(shù)據(jù)、國有產(chǎn)權(quán)交易數(shù)據(jù)等。接口要求如下：a)接口地址：https://IP地址:端口/；b)接口類型：https；c)接口名稱：queryForGov；d)輸入/請求參數(shù)：見表6；e)輸出/返回參數(shù)：見表7；f)請求示例：見附錄A的A.3.1；g)返回示例：見附錄A的A.3.2。表6獲取交易數(shù)據(jù)接口請求參數(shù)表1是2是3是4是查詢參數(shù)，字符串格式的JSON字符串，按表7獲取交易數(shù)據(jù)接口返回參數(shù)表1236.3數(shù)據(jù)上傳接口6.3.1上傳交易結(jié)構(gòu)化數(shù)據(jù)接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口類型：WebService；c)接口名稱：UploadData_G；d)輸入/請求參數(shù)：見表8；e)輸出/返回參數(shù)：見表9；f)請求示例：見附錄A的A.4.1；g)返回示例：見附錄A的A.4.2。7DB35/T2167—2024表8上傳交易結(jié)構(gòu)化數(shù)據(jù)請求參數(shù)表1是2是表9上傳交易結(jié)構(gòu)化數(shù)據(jù)接口返回參數(shù)表126.3.2上傳交易非結(jié)構(gòu)化數(shù)據(jù)接口接口要求如下：a)接口地址：sftp://IP地址:端口/；b)接口類型：sftp；c)接口名稱：無。6.3.3上傳多媒體接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口類型：webservice；c)接口名稱：UploadData；d)輸入/請求參數(shù)：見表10；e)輸出/返回參數(shù)：見表11；f)請求示例：見附錄A的A.5.1；g)返回示例：見附錄A的A.5.2。表10上傳多媒體接口請求參數(shù)表1是2是表11上傳多媒體接口返回參數(shù)表128DB35/T2167—2024（資料性）接口示例A.1獲取項目報建信息接口請求示例如下：{}}}返回示例如下：{9DB35/T2167—2024"APPROVAL_CONTACT_INFORMATION":"}DB35/T2167—2024A.2獲取項目備案審查信息接口請求示例如下：{}}}返回示例如下：{"SUPERVISE_DEPT_NAM"TENDER_PROJECT_CODE":"N76350101230"M_ATT_TENDER_AGENT_CONT"PROJECT_CODE":"N7635010"PLATFORM_CODE":"12350100"CREATE_DATE":"2023-06-2"M_ATT_PROJECT_REG_APP"TENDER_AGENCY_CODE"TENDER_PROJECT_NAME"UNIFIED_DEAL_CODE":"111111111111111111-2023062"TENDER_AGENT_CONTRADB35/T2167—2024"TENDER_PROJECT_CODE"CONSTRUCTION_ID":"3501"TENDER_AGENCY_ROLE":"01""TENDER_PROJECT_CODE":"N763501012"COMMIT_TIME":"2023-06"ATTACHMENT_ID":"c8e83a9616874c4387155cfe4df8bca{"ATTACHMENT_ID":"cb19eff6291e4018a04aa7c46b7d6bf{DB35/T2167—2024"ATTACHMENT_ID":"0e43591473ca4c379b67890a35a10300"{"ATTACHMENT_ID":"4afeeea022644fcb86ca1834c43921e5"{"OPERATION_PERSON":{"OPERATION_PERSON":{"ATTACHMENT_ID":"27dd200622634ac58dd81bb0af99b117"}DB35/T2167—2024"DATA_TIMESTAMP1":"2023-06"CONTRIBUTION_SCALE":"財政資金投資比例：35(%)，自籌資金投資比例：40(%)，其他資金投資比"M_ATT_PROJECT_APPROVAL_F"PROJECT_CODE":"N7635010"CONSTRUCTION_ID":"350101230625070"REVIEW_CODE":"A07DB35/T2167—2024"TENDER_PROJECT_CODE":"N76350101230"M_ATT_TENDER_AGENT_CONT"PLATFORM_CODE":"12350100"CREATE_DATE":"2023-06-2"BID_SECTION_CODE":"N7635010123062"M_ATT_QUALIFICATION"UNIFIED_DEAL_CODE":"111111111111111111-2023062"CONTROL_PRICE_CURR"BEGIN_DATE":"2023-06-"TENDER_PROJECT_CLASSIFY_CODE"M_ATT_TENDER_FILE_ATT}DB35/T2167—2024A.3獲取交易數(shù)據(jù)接口請求示例如下：{"ts":1703497349628,//Unix時間戳，對應(yīng)2023-1"sign":"e93264b47759c9cdd21ba"dataName":"PURCHASE_QUALI_"startTimestamp":1665995174000,//Unix時間戳，對應(yīng)2022-"endTimestamp":1703497349628//Unix時間戳，對應(yīng)2023-1}}返回示例如下：{"BID_CLOSING_TIME":1"PURCHASE_SECTION_CODE":"201"M_KEY":"02015512016"BULLETIN_START_TIME":1"PURCHASE_PROJECT_CODE":"201"PLATFORM_CODE":"1235020"UNIFIED_DEAL_CODE":"D02-12350200426605541R-878498"PUB_SERVICE_PLAT_CODE":"1235000DB35/T2167—2024}}A.4上傳交易結(jié)構(gòu)化數(shù)據(jù)接口請求示例如下：{"DATA_KEY":"11115012016"CA_KEY":"88888888889999999999"{"BINARY_CONTENT":"公共資源交易入場登記表.docx"{}]}}}DB35/T2167—2024返回示例如下：{}A.5上傳多媒體接口請求示例如下：{}"TENDER_PROJECT_COD}}返回示例如下：{}DB35/T2167—2024（規(guī)范性）代碼集B.1獲取項目報建信息接口返回參數(shù)獲取項目報建信息接口返回參數(shù)的數(shù)據(jù)見表B.1。表B.1獲取項目報建信息接口返回參數(shù)中的數(shù)據(jù)信息表1是2是3是4是5是6是7是8是9是是是是是是是是DB35/T2167—2024表B.1獲取項目報建信息接口返回參數(shù)中的數(shù)據(jù)信息表（續(xù)）是是是是是是是是是是是是是是是是是是是是是DB35/T2167—2024表B.1獲取項目報建信息接口返回參數(shù)中的數(shù)據(jù)信息表（續(xù)）否是是是是是是是是是APPROVAL_CONTACT_INFORMATI是是是是是是B.2獲取項目備案審查信息接口返回參數(shù)獲取項目備案審查信息接口返回參數(shù)見表B.2、表B.3、表B.4、表B.5、表B.6。DB35/T2167—2024表B.2項目備案審查結(jié)果信息表1是2是3是4是5是住建行業(yè)（0：暫存；1：待簽收；2：退回6是7是8是9是是是是是是是是是DB35/T2167—2024表B.2項目備案審查結(jié)果信息表（續(xù)）是是是是表B.3歷史操作信息表1是2是3是4是5是材料不完整；5：審查通過；6：審查不通過；8：簽表B.4項目信息表1否2否3否4是5是6否7否DB35/T2167—2024表B.4項目信息表（續(xù)）8否9是否否否否是是否是E是否是是是是是是是是是DB35/T2167—2024表B.5招標(biāo)項目信息表1否2否3是4否5否6否7否8是9否否否否是是是否否否否否是否是DB35/T2167—2024表B.5招標(biāo)項目信息表（續(xù)）否是是 是是是是是是是是是是是是是是是DB35/T2167—2024表B.6標(biāo)段（包）信息表1否2否3否4是5否6TENDER_PROJECT_CLASSIFY否7是8是9是否是是否是是是是是是是是是DB35/T2167—2024表B.6標(biāo)段（包）信息表（續(xù)）是是是是M_ATT_QUALIFICATION_D是是是是B.3獲取交易數(shù)據(jù)接口請求參數(shù)獲取交易數(shù)據(jù)接口請求參數(shù)見表B.7。表B.7獲取交易數(shù)據(jù)接口請求參數(shù)中的數(shù)據(jù)信息表12345B.4獲取交易數(shù)據(jù)接口返回參數(shù)獲取交易數(shù)據(jù)接口返回參數(shù)見表B.8、表B.9、表B.10、表B.11、表B.12。DB35/T2167—2024表B.8采購項目信息表1是2是3是4否5否6是7是8是9是否否否否否是否是是是是否否DB35/T2167—2024表B.8采購項目信息表（續(xù)）是是是是是是是是是表B.9采購公告信息表1是2是3是4是5是6是7是8是9是是DB35/T2167—2024表B.9采購公告信息表（續(xù)）是是是是表B.10更正公告1是2是3否4是5是6是7MODIFICATION_START_TI是8是9是是是表B.11中標(biāo)結(jié)果公告信息表1是2是DB35/T2167—2024表B.11中標(biāo)結(jié)果公告信息表（續(xù)）3否4是5是6是7是8是9WIN_BID_BULLETIN_TIT是是 是是是是是是NUM（20,4）否否否否否是是是DB35/T2167—2024表B.12采購合同信息表1是2是3是4是5是6是7是開8是9是是是否否否否否否是是是DB35/T2167—2024B.5上傳交易結(jié)構(gòu)化數(shù)據(jù)請求參數(shù)上傳交易結(jié)構(gòu)化數(shù)據(jù)請求參數(shù)見表B.13、表B.14、表B.15、表B.16、表B.17、表B.18。表B.13項目信息表1是2是3是4是5否6是7是8是9是是否是是是否否否是是是DB35/T2167—2024表B.13項目信息表（續(xù)）是是是表B.14招標(biāo)項目信息表1是2是3否4是5是6是7是8否9是是是是是是是否DB35/T2167—2024表B.14招標(biāo)項目信息表（續(xù)）否是是是否否否是是是是是表B.15標(biāo)段（包）信息表1是2是3是4是5是6是7是8是DB35/T2167—2024表B.15標(biāo)段（包）信息表（續(xù)）9是是否否否是是是是是是是表B.16招標(biāo)公告信息表1是2是3是4是5是6是7是DB35/T2167—2024表B.16招標(biāo)公告信息表（續(xù)）8是9是是是是是是BID_DOC_REFER_END_T是否否否否是是是BULLETIN_DUTY_CODE_T是是是是是是DB35/T2167—2024表B.17中標(biāo)候選人公示信息表1是2是3是4是5是6是7是8是9是是是是是是是是表B.18中標(biāo)結(jié)果公示信息表1是2是3是4是DB35/T2167—2024表B.18中標(biāo)結(jié)果公示信息表（續(xù)）5是67是8是9是是是是是是是是是是NUM（20,4）否否否否是是是是是DB35/T2167—2024表B.18中標(biāo)結(jié)果公示信息表（續(xù)）否是是是是是B.6上傳多媒體接口請求參數(shù)上傳多媒體接口請求參數(shù)見表B.19。表B.19上傳多媒體接口請求參數(shù)中的數(shù)據(jù)信息表1是2是3是4是5是B.7工程類別工程類別代碼見表B.20。表B.20工程類別表1—2—DB35/T2167—2024表B.20工程類別表（續(xù)）303-1 4 5 6 7 899-1 B.8招標(biāo)組織形式招標(biāo)組織形式見表B.21。表B.21招標(biāo)組織形式表11 22 39 B.9備案類型代碼備案類型見表B.22。表B.22備案類型表1————DB35/T2167—2024表B.22備案類型表（續(xù)）2— —3— —— B.10招標(biāo)項目類型招標(biāo)項目類型代碼見表B.23。表B.23招標(biāo)項目類型表1—2—303-1—4—5—6—7—899-1—DB35/T2167—2024B.11主體類別主體類別見表B.24。表B.24主體類別表11 22 33 44 55 66 77 89 B.12主體角色類型主體角色類型見表B.25。表B.25主體角色類型表12345678DB35/T2167—2024表B.25主體角色類型表（續(xù)）9—B.13招標(biāo)方式招標(biāo)方式見表B.26。表B.26招標(biāo)方式表11 22 39 B.14標(biāo)段（包）分類編