DB35T 2167-2024政务服务 公共资源交易公共服务系统数据接口要求

ICS01.040.35CCSL7035Administrativeservice—DatainterfacerequirementsofpublicresourcetradingIDB35/T2167—2024前言 2规范性引用文件 3术语和定义 4缩略语 25数据交换模式 26接口要求 4附录A（资料性）接口示例 8附录B（规范性）代码集 参考文献 DB35/T2167—2024本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建省经济信息中心提出。本文件由福建省信息化标准化技术委员会（SAFJ/TC11）归口。本文件起草单位：福建省经济信息中心、福建省公共资源交易公共服务平台有限公司、福建元素信息科技有限公司、福建省网络与信息安全测评中心、福州市公共资源交易中心、厦门市公共资源交易中心、泉州市公共资源交易中心、莆田市公共资源交易中心、漳州市公共资源交易中心、龙岩市公共资源交易服务中心、宁德市公共资源交易中心、三明市公共资源交易中心、南平市公共资源交易中心、福建省平潭综合实验区行政服务中心、福建省数字经济发展促进中心、福州福大经纬信息科技有限公司、福建省经纬数字科技有限公司。本文件主要起草人：林平、江峰、林宗昭、陈旭辉、罗峰、李娟、吴阳、周伟东、高松涛、李志锴、吴钦阳、郑晓冬、陈勇志、陈少煌、孙宇斌、戴森河、甘立君、钟顺相、张斌、邓婷、许志雄、蔡璐、蔡忠灏、曹杰、林晓枫、高陈晟、林泰崴、陈广胜、姚峰、张晓晟、罗峰华、杨善峰、张文星、兰美玲、何赐清、钟木娟、张素钦、林荔晶。GB/T22239—2019信息安全技术网络安全3.3公共资源交易电子交易平台onlinepublicresourcetra公共资源交易电子公共服务平台onlinepublicresourcetrading2DB35/T2167—20243.5公共资源交易公共服务系统publicresourcetradingservicesystem由电子行政监督平台、电子交易平台和电子公共服务平台组成的公共服务总称。4缩略语下列缩略语适用于本文件。BLOB：二进制大对象（BinaryLargeObjectBlock）CLOB：字符大对象（CharacterLargeObjectBlock）HTTP：超文本传输协议（HyperTextTransferProtocol）HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）JSON：轻量级的数据交换格式（JavaScriptObjectNotation）SFTP：一种安全的文件传输协议（SSHFileTransferProtocol）URL：统一资源定位符（UniformResourceLocator）XML：可扩展标记语言（ExtensibleMarkupLanguage）5数据交换模式5.1技术架构电子公共服务平台、电子行政监督平台和电子交易平台之间数据交换的技术架构见图1，包括数据查询接口和数据上传接口。数据查询接口：电子交易平台通过电子公共服务平台从电子行政监督平台获取项目报建信息、项目备案审查信息。数据上传接口：电子交易平台通过接口上报公共资源交易过程数据到电子公共服务平台。3DB35/T2167—2024图1技术架构图5.2基本要求公共资源交易公共服务系统数据接口应满足以下要求：a)结构化数据采用HTTPS协议传输；b)非结构化数据交换通过SFTP协议实现；c)消息封装采用JSON格式或XML格式；d)安全要求按照GB/T22239—2019第8章的规定；e)数据类型及格式见表1。表1数据类型说明表12）：4DB35/T2167—2024表1数据类型说明表（续）3YYYYMMDD：表示YYYY年MM月DD46接口要求6.1接口分类公共资源交易公共服务系统数据接口主要包括数据查询接口和数据上传接口，见图2。数据查询接口包括电子行政监督平台与电子交易平台之间的获取项目报建信息接口、获取项目备案审查信息接口，电子公共服务平台与电子交易平台之间的获取交易数据接口。数据上传接口包括电子公共服务平台与电子交易平台之间的上传结构化交易数据接口、上传非结构化交易数据接口（不包括多媒体数据）和上传多媒体接口。图2公共资源交易数据接口分类6.2数据查询接口6.2.1获取项目报建信息接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口类型：WebService；c)接口名称：GetBaoJianInfo；d)输入/请求参数：见表2；e)输出/返回参数：见表3；5DB35/T2167—2024f)请求示例：见附录A的A.1.1；g)返回示例：见附录A的A.1.2。表2获取项目报建信息接口请求参数表1是2是表3获取项目报建信息接口返回参数表1236.2.2获取项目备案审查信息接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口类型：WebService；c)接口名称：GetBeiAnInfo；d)输入/请求参数：见表4；e)输出/返回参数：见表5；f)请求示例：见附录A的A.2.1；g)返回示例：见附录A的A.2.2。表4获取项目备案审查信息接口请求参数表1是2是表5获取项目备案审查信息接口返回参数表1236DB35/T2167—20246.2.3获取交易数据接口电子交易平台通过此接口从电子公共服务平台获取交易数据，主要包括信用分数据、工程建设项目交易数据、政府采购交易数据、国有产权交易数据等。接口要求如下：a)接口地址：https://IP地址:端口/；b)接口类型：https；c)接口名称：queryForGov；d)输入/请求参数：见表6；e)输出/返回参数：见表7；f)请求示例：见附录A的A.3.1；g)返回示例：见附录A的A.3.2。表6获取交易数据接口请求参数表1是2是3是4是查询参数，字符串格式的JSON字符串，按表7获取交易数据接口返回参数表1236.3数据上传接口6.3.1上传交易结构化数据接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口类型：WebService；c)接口名称：UploadData_G；d)输入/请求参数：见表8；e)输出/返回参数：见表9；f)请求示例：见附录A的A.4.1；g)返回示例：见附录A的A.4.2。7DB35/T2167—2024表8上传交易结构化数据请求参数表1是2是表9上传交易结构化数据接口返回参数表126.3.2上传交易非结构化数据接口接口要求如下：a)接口地址：sftp://IP地址:端口/；b)接口类型：sftp；c)接口名称：无。6.3.3上传多媒体接口接口要求如下：a)接口地址：https://IP地址:端口/；b)接口类型：webservice；c)接口名称：UploadData；d)输入/请求参数：见表10；e)输出/返回参数：见表11；f)请求示例：见附录A的A.5.1；g)返回示例：见附录A的A.5.2。表10上传多媒体接口请求参数表1是2是表11上传多媒体接口返回参数表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获取交易数据接口请求示例如下：{"ts":1703497349628,//Unix时间戳，对应2023-1"sign":"e93264b47759c9cdd21ba"dataName":"PURCHASE_QUALI_"startTimestamp":1665995174000,//Unix时间戳，对应2022-"endTimestamp":1703497349628//Unix时间戳，对应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上传交易结构化数据接口请求示例如下：{"DATA_KEY":"11115012016"CA_KEY":"88888888889999999999"{"BINARY_CONTENT":"公共资源交易入场登记表.docx"{}]}}}DB35/T2167—2024返回示例如下：{}A.5上传多媒体接口请求示例如下：{}"TENDER_PROJECT_COD}}返回示例如下：{}DB35/T2167—2024（规范性）代码集B.1获取项目报建信息接口返回参数获取项目报建信息接口返回参数的数据见表B.1。表B.1获取项目报建信息接口返回参数中的数据信息表1是2是3是4是5是6是7是8是9是是是是是是是是DB35/T2167—2024表B.1获取项目报建信息接口返回参数中的数据信息表（续）是是是是是是是是是是是是是是是是是是是是是DB35/T2167—2024表B.1获取项目报建信息接口返回参数中的数据信息表（续）否是是是是是是是是是APPROVAL_CONTACT_INFORMATI是是是是是是B.2获取项目备案审查信息接口返回参数获取项目备案审查信息接口返回参数见表B.2、表B.3、表B.4、表B.5、表B.6。DB35/T2167—2024表B.2项目备案审查结果信息表1是2是3是4是5是住建行业（0：暂存；1：待签收；2：退回6是7是8是9是是是是是是是是是DB35/T2167—2024表B.2项目备案审查结果信息表（续）是是是是表B.3历史操作信息表1是2是3是4是5是材料不完整；5：审查通过；6：审查不通过；8：签表B.4项目信息表1否2否3否4是5是6否7否DB35/T2167—2024表B.4项目信息表（续）8否9是否否否否是是否是E是否是是是是是是是是是DB35/T2167—2024表B.5招标项目信息表1否2否3是4否5否6否7否8是9否否否否是是是否否否否否是否是DB35/T2167—2024表B.5招标项目信息表（续）否是是 是是是是是是是是是是是是是是是DB35/T2167—2024表B.6标段（包）信息表1否2否3否4是5否6TENDER_PROJECT_CLASSIFY否7是8是9是否是是否是是是是是是是是是DB35/T2167—2024表B.6标段（包）信息表（续）是是是是M_ATT_QUALIFICATION_D是是是是B.3获取交易数据接口请求参数获取交易数据接口请求参数见表B.7。表B.7获取交易数据接口请求参数中的数据信息表12345B.4获取交易数据接口返回参数获取交易数据接口返回参数见表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采购项目信息表（续）是是是是是是是是是表B.9采购公告信息表1是2是3是4是5是6是7是8是9是是DB35/T2167—2024表B.9采购公告信息表（续）是是是是表B.10更正公告1是2是3否4是5是6是7MODIFICATION_START_TI是8是9是是是表B.11中标结果公告信息表1是2是DB35/T2167—2024表B.11中标结果公告信息表（续）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上传交易结构化数据请求参数上传交易结构化数据请求参数见表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项目信息表（续）是是是表B.14招标项目信息表1是2是3否4是5是6是7是8否9是是是是是是是否DB35/T2167—2024表B.14招标项目信息表（续）否是是是否否否是是是是是表B.15标段（包）信息表1是2是3是4是5是6是7是8是DB35/T2167—2024表B.15标段（包）信息表（续）9是是否否否是是是是是是是表B.16招标公告信息表1是2是3是4是5是6是7是DB35/T2167—2024表B.16招标公告信息表（续）8是9是是是是是是BID_DOC_REFER_END_T是否否否否是是是BULLETIN_DUTY_CODE_T是是是是是是DB35/T2167—2024表B.17中标候选人公示信息表1是2是3是4是5是6是7是8是9是是是是是是是是表B.18中标结果公示信息表1是2是3是4是DB35/T2167—2024表B.18中标结果公示信息表（续）5是67是8是9是是是是是是是是是是NUM（20,4）否否否否是是是是是DB35/T2167—2024表B.18中标结果公示信息表（续）否是是是是是B.6上传多媒体接口请求参数上传多媒体接口请求参数见表B.19。表B.19上传多媒体接口请求参数中的数据信息表1是2是3是4是5是B.7工程类别工程类别代码见表B.20。表B.20工程类别表1—2—DB35/T2167—2024表B.20工程类别表（续）303-1 4 5 6 7 899-1 B.8招标组织形式招标组织形式见表B.21。表B.21招标组织形式表11 22 39 B.9备案类型代码备案类型见表B.22。表B.22备案类型表1————DB35/T2167—2024表B.22备案类型表（续）2— —3— —— B.10招标项目类型招标项目类型代码见表B.23。表B.23招标项目类型表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主体角色类型表（续）9—B.13招标方式招标方式见表B.26。表B.26招标方式表11 22 39 B.14标段（包）分类编