1. 公告对接接口(第三方系统与电采平台)
集团采购
  • LW采购单位采购员同步接口
    • LW采购单位增量同步
      POST
    • LW采购员更新同步
      POST
    • 从LW系统拉取采购单位数据
      GET
    • 从LW系统拉取采购员数据
      GET
  • 增值服务购物车接口
    • 获取购物车列表
      GET
    • 添加到购物车
      POST
    • 更新购物车项
      POST
    • 从购物车移除
      POST
    • 清空购物车
      POST
    • 从购物车中移除商品,支持多个id用逗号分隔
      POST
  • 增值服务管理接口
    • 查询增值服务列表
      POST
    • 新建增值服务
      POST
    • 编辑增值服务
      POST
    • 删除增值服务
      POST
    • 获取增值服务详情
      GET
    • 变更服务状态
      POST
    • 获取热卖区服务
      GET
    • 获取展示服务列表
      GET
    • 获取服务详情
      GET
    • 获取增值服务集成配置
      GET
    • 免登录获取热卖区服务
      GET
    • 免登录获取展示服务列表
      GET
    • 免登录获取服务详情
      GET
  • 增值服务套餐管理接口
    • 根据增值服务ID查询套餐列表
    • 新建服务套餐
    • 编辑服务套餐
    • 删除服务套餐
    • 获取套餐详情
    • 批量删除服务套餐
  • 增值服务附件下载接口
    • 下载缩略图
    • 获取附件列表
  • 增值服务特色服务接口
    • listByServiceId
  • 用户信息认证集成接口
    • 生成一次性登录凭证
    • 验证一次性Code并返回用户信息
  • 京东工业
    • 判断是否弹出京东登录提示
    • 获取京东登录HTML
    • 申请京东PIN
    • 申请京东PIN
    • 更新京东PIN状态
  • 登录尝试管理控制器
    • 记录登录失败
    • 重置登录错误次数
  • SrmReceiceSupplierController
    • 更新供应商双零审核信息
  • 供应商信息-控制器 - 由代码生成器生成
    • 返回供应商基本信息
  • 门户接口-控制器
    • 返回采购方式数据
    • 返回公示公告类型数据
    • 返回公示公告列表分页数据
    • 返回公示公告明细数据
    • 下载附件信息
    • 返回已发布项目、完成的交易额、已注册企业、交易已归档项目数量
    • 返回门户图片数据
    • 返回门户动态列表分页数据
    • 返回门户动态明细数据
    • 返回门户操作说明
    • 返回其他公示公告列表分页数据
    • 根据关联编号和id查询关联公示公告列表
    • 返回公示公告列表分页数据
    • findMemberSupplierList
    • findMemberSupplierDetail
    • getFileInfo
  • SrmDoubleZeroManualAuditController
    • 获取待审批列表
    • 审核通过
    • 审核驳回
    • 查询审核记录详情
    • 检查是否有待审批记录
    • 获取已通过审核记录
    • 获取列表(分页)
  • webfunny
    • 初始化用户分群相关数据
    • 升级通用字段api接口
  • -控制器 - 由代码生成器生成
    • 创建采购单
  • SrmPurchaseDemandTwentyEightController
    • 批量导入二十八所采购单信息
    • 批量导出二十八所采购单信息
    • 批量导入二十八所登记结果信息
    • 下载28所登记结果导入模板
  • 评标登记信息-控制器 - 由代码生成器生成
    • 获取评标登记信息
    • 获取评标登记信息
    • 获取评标登记信息的审批状态值
    • 判断供应商是否为负面供应商(负面供应商允许落标,不允许中标)
    • 支付结果查询
  • SrmSupplierRegisterController
    • 保存采购单位说明资料
    • 获取采购单位说明资料
    • 获取登录注册验证码
    • 供应商注册
    • 手机号验证码登录
    • 手机号验证码登录-兼容多帐号
    • 多帐号选择后登录
    • 找回密码
    • 预找回密码-获取账号列表
    • 批量找回密码
    • 获取供应商信息
    • 获取采购单位
    • 获取采购单位申请文件
    • 获取采购单位信息
    • 根据名称获取采购单位信息
    • 获取准入申请列表
    • 准入申请删除
    • 准入申请撤回
    • 准入申请注销
    • 获取采购单位审核列表
    • 采购审核未通过
    • 采购审核通过
    • 获取供应商基本信息审核列表
    • 供应商信息审核未通过
    • 供应商信息审核通过
    • 获取供应商待注销列表
    • 供应商信息-有效-待审核列表
    • 校验采购单位是否重复
    • 物料分类列表
    • 获取分类
    • 分类校验
    • 获取子分类
    • 获取分类详情
    • 获取供应商详情
    • 校验供应商
    • 校验登录账号是存在
    • 获取供应商注册手机号列表
    • 账号密码登录获取验证码
    • 账号密码登录校验验证码
    • 验证短信验证码
    • 上传文件
    • 法研院校验企业双零信息
    • 注册前置校验
    • 准入双零审核
    • 注册双零审核
    • 新供应商注册
  • SrmOrderManagementController
    • 会员订单创建
    • 订单列表及开票申请
    • 下载附件
    • 删除订单
    • 申请退款
  • TiuCommonController
    • 获取当前登陆人所属公司
    • 获取当前登陆人所属公司
    • 根据数据字典key获取数据字典的value
    • 根据数据字典id获取数据字典的map集合
    • fileConvert
    • 返回机构列表
    • 获取委托用户
    • 切换帐号
    • 修改供应商名称
    • 删除供应商
    • 导出每天的日志文件
    • 获取登录名称
    • 获取供应商信息
    • 免登录获取附件列表信息
    • 免登录下载附件
    • 免登录下载单一文件根据附件组编码
  • 通用接口 - 控制器
    • (方法作废)检查业务单据编辑权限
    • 检查业务单据角色与操作权限
  • 合同信息 - 控制器
    • 合同管理库列表
    • 合同台账列表
    • 合同台账统计看板
    • 合同台账 Excel 导出
    • 合同确认
    • 合同提交审核
    • 合同审核驳回
    • 合同关闭
    • 新建合同信息
    • 编辑合同信息
    • 删除合同信息
    • 合同信息详情
    • 合同大查看页聚合数据
    • 采购负责人合同选择器
    • 供应商合同选择器
    • 自测生成合同数据
    • 自测生成平台待办
    • 自测清理平台待办
    • 自测删除单条待办
    • 自测处理待办(转已办)
    • 自测查询已办列表
    • 生成业务待办
    • 处理待办-转已办
    • 删除业务待办
    • 测试-生成合同及草稿待办
  • 履约计划 (进展)- 控制器
    • 履约计划库列表(执行中/已完成/全部)
    • 导入履约计划
    • 下载履约计划导入模板
    • 履约进展更新
    • 查询合同是否已发起计划变更
    • 新建履约计划
    • 编辑履约计划
    • 删除履约计划
    • 获取履约计划详情
    • 根据合同信息ID查询履约计划列表
    • 履约计划节点选择器
  • 履约计划变更接口
    • 查询履约计划变更列表
    • 新建履约计划变更
    • 发起履约计划变更
    • 提交履约计划变更
    • 编辑履约计划变更
    • 删除履约计划变更
    • 获取履约计划变更详情
    • 根据合同ID查询履约计划变更列表
    • 作废履约计划变更
    • 履约计划变更审核通过
    • 履约计划变更审核驳回
  • 合同质保接口
    • 查询质保列表
    • 查询有效质保列表
    • 查询超期质保列表
    • 获取质保详情
    • 编辑质保记录
    • 新建质保记录
    • 删除质保记录
    • 根据合同信息ID查询质保列表
  • 付款计划 - 控制器
    • 导入付款计划
    • 下载付款计划导入模板
    • 新建付款计划
    • 编辑付款计划
    • 删除付款计划
    • 获取付款计划详情
    • 根据合同信息ID查询付款计划列表
  • 发货管理接口
    • 查询发货记录列表
    • 新建发货记录
    • 编辑发货记录
    • 删除发货记录
    • 获取发货记录详情
    • 根据合同ID查询发货单列表
    • 发货单驳回
    • 付款提醒
    • 导入发货物品明细
    • 下载发货物品明细导入模板
    • 发货签收确认
    • 补传到货签收单
    • 发货单提交审核
    • 发货单作废
    • 发货单选择器
  • 发票管理接口
    • 查询发票列表
    • 新建发票
    • 编辑发票
    • 删除发票
    • 获取发票详情
    • 根据合同ID查询发票列表
    • 发票提交审核
    • 发票确认
    • 发票退回
    • 发票红冲
    • 导入发票信息明细
    • 下载发票信息明细导入模板
    • 发票作废
  • 验收管理接口
    • 查询验收记录列表
    • 新建验收记录
    • 编辑验收记录
    • 删除验收记录
    • 获取验收记录详情
    • 根据合同ID查询验收单列表
    • 验收单提交审核
    • 验收审核通过
    • 验收审核驳回
    • 验收单作废
  • 合同售后处理 - 控制器
    • 合同售后处理列表
    • 根据合同ID查询售后处理列表
    • 提交售后问题
    • 供应商回复售后问题(已废弃,请改用 replyInterim/replyComplete)
    • 供应商继续处理
    • 供应商处理完成
    • 供应商驳回要求补充信息
    • 采购方补充信息并推送
    • 采购方关闭售后单
    • 查询售后单沟通记录
    • 采购方驳回售后处理结果
    • 新建售后单
    • 编辑售后单
    • 删除售后单
    • 获取售后单详情
    • 根据合同信息ID查询售后处理列表
    • 作废售后单
  • 对账单管理接口
    • 查询对账单记录列表
    • 新建对账单记录
    • 编辑对账单记录
    • 删除对账单记录
    • 获取对账单记录详情
    • 根据合同ID查询对账单列表
    • 对账单选择器
    • 提交对账单审核
    • 对账单审核确认
    • 对账单驳回
    • 对账单作废
    • 导入对账单物品明细
    • 下载对账单物品明细导入模板
  • 公告对接接口(第三方系统与电采平台)
    • 公告对接接口文档
    • 根据名称模糊搜索招标单位信息
      POST
    • 附件批量上传
      POST
    • 发布公告
      POST
    • 拉取公告
      POST
    • 公告附件下载
      GET
  • 采购需求信息-控制器 - 由代码生成器生成
    • 采购需求判重
    • 更新采购需求阶段状态
    • 返回采购需求列表数据
    • 判断是否终止报名
    • 终止报名
    • 批量终止报名
    • 再次报价
    • 采购需求导入
    • 采购需求导入
    • 根据采购方式类型获取采购方式数据字典
    • 下载采购需求批量导入模板
    • 返回采购需求选择器
    • 获取再次报价信息
    • 获取采购需求信息
    • 返回采购需求列表
    • 导出采购信息
    • 转办
    • 撤回集采申请
    • 驳回集采申请
    • 集采拆包
    • 集采删除子包
    • 判断集采中心成员
    • 获取集采中心成员
    • 集采任务分配
    • 集采子包采购明细校验
    • 按成员单位维度统计采购需求
    • 导出运维管理报表
    • 获取集采申请单号
    • 获取集采标包信息
    • 获取采购员发送消息
    • updateQuoteGoods
    • 返回采购寻源列表数据
    • 获取当前采购单位采购员列表
    • checkUserIsFocus
    • 返回采购寻源列表数据
    • 批量发布
    • 是否可以下载分签单
    • 返回采购集采统计数据
    • 返回采购汇总统计数据
    • 返回采购汇总统计数据
    • 返回采购集采统计数据
    • 集采订单明细
    • 采购报价明细
    • 导出采购报价明细
    • 修改当前需求对应的集采单
    • 修改当前集采单关联的分包需求单
    • getEnrollingProjectId
    • getJCProjectId
    • sendSms
    • 判断是否有文本比对内容(返回字符串的true或false)
    • 获取文本比对内容(返回JSON字符串)
    • getTimestamp
    • 判断集采单号是否重读
  • 围标串标风险预警-控制器
    • 查询采购单围标串标预警列表
    • 查询采购单有风险预警列表
    • 重算并查询采购单围标串标预警列表
    • 采购单列表页红黄灯汇总
    • 测试-生成预警数据
    • 测试-供应商中标率查询
    • 测试-两供应商档案比对
    • 测试-查询采购单全部预警记录
    • 测试-清理采购单预警记录
  1. 公告对接接口(第三方系统与电采平台)

公告对接接口文档

第三方系统 ↔ 电采平台 · 公告对接 REST API
创建日期:2026-10-29

一、文档信息#

项值
基础路径/api/tiu-open/srm/v1/notice
鉴权方式系统编码 XXXXX(由电采平台统一分配),所有接口共用一个编码
JSON 格式application/json
多文件上传multipart/form-data

二、接口列表#

#接口MethodPath说明
0招标单位信息查询POST/unitInfoByName前置辅助接口:推送公告前查询招标单位信息,无需系统编码
1附件批量上传POST/uploadFile
2发布公告POST/publish
3拉取公告POST/pull
4公告附件下载GET/attachment/download
系统编码:接口 1–4 统一使用同一系统编码 XXXXX,由电采平台统一分配。接口 0 为内部辅助接口,不校验系统编码。

三、接口详情#

3.0 招标单位信息查询(前置辅助接口)#

基本信息#

Method:POST
Path:/api/tiu-open/srm/v1/notice/unitInfoByName
Content-Type:application/x-www-form-urlencoded
是否需要系统编码:否(电采平台内部辅助接口,不做鉴权)
说明:根据招标单位中文名模糊匹配单位信息,返回单位名称、单位编码等。建议第三方推送公告前先调用此接口拿到准确的单位名称与单位编码,再作为 tenderUnit 与 companyAccount 一起传入发布公告接口,以保证 COMPANY_ID 正确落库。

参数说明#

参数类型必填说明
unitNameString是招标单位中文名(模糊匹配)

响应说明(RestResult.data 为匹配到的单位列表,精简字段)#

字段类型说明
unitNameString单位中文名(回传给推送公告时的 tenderUnit)
unitCodeString单位编码(回传给推送公告时的 companyAccount)
unitIdString单位在电采平台的内部 ID(字符串)
返回的是列表,可能多个模糊命中的单位;第三方取列表中期望的那一个即可。
未匹配到单位时返回空列表 [],此时第三方可只传 tenderUnit 名称到发布公告接口,电采平台将仅保存中文名、COMPANY_ID 留空。

请求示例#

POST /api/tiu-open/srm/v1/notice/unitInfoByName
Content-Type: application/x-www-form-urlencoded

unitName=中国电子科技集团公司第三十四研究所

响应示例#

{
   "success": true,
   "message": "操作成功!",
   "code": 200,
   "data": [
       {
           "unitName": "中国电子科技集团公司第三十四研究所",
           "unitCode": "ZDK34",
           "unitId": "25874"
        }
    ]
}
未匹配到单位:
{
  "success": true,
  "code": 200,
  "message": "操作成功!",
  "data": []
}

3.1 附件批量上传#

基本信息#

Method:POST
Path:/api/tiu-open/srm/v1/notice/uploadFile
Content-Type:multipart/form-data
说明:多文件共用一个附件组编码 FILE_PATH。发布公告时以 FILE_PATH 字段传入。

参数说明(form-data)#

参数类型必填说明
sysCodeString是系统编码,由电采平台统一分配,固定传 XXXXX
filesMultipartFile[]是附件文件,支持多文件(同一参数名重复传);单个附件建议不超过 50MB

响应(JSON)#

字段类型说明
statusString00 = 成功;02 = 失败
messageString响应信息
FILE_NAMEString上传的原始文件名,多个以逗号拼接
FILE_PATHString附件组编码,发布公告接口字段取值

请求示例#

POST /api/tiu-open/srm/v1/notice/uploadFile
Content-Type: multipart/form-data

sysCode=XXXXX
files=@招标公告.pdf
files=@附件清单.docx

响应示例#

{
  "status": "00",
  "message": "上传成功",
  "FILE_NAME": "招标公告.pdf,附件清单.docx",
  "FILE_PATH": "GRP-a1b2c3d4"
}

3.2 发布公告#

基本信息#

Method:POST
Path:/api/tiu-open/srm/v1/notice/publish
Content-Type:application/json
说明:以 sourceCode + sourcingOrderNo 作为幂等键;重复推送将返回已存在的公告 ID。

请求体结构(NoticePublishVo)#

字段类型必填长度说明
sourcingOrderNoString是50采购寻源单号(幂等去重键)
sourceCodeString是50数据来源编码,由电采平台统一分配,固定传 XXXXX(用于鉴权及来源识别)
sourceUnitString否100来源系统单位
sourceSystemString否100来源系统名称
projectNumberString是50项目编号
tenderUnitString否100招标单位名称。与 companyAccount 建议配套传入。推荐做法:推送公告前先调用 招标单位信息查询 接口,拿到名称与账号后再一起传入;仅在查询不到结果时才按此名称单独传入(此时电采平台仅保存中文名,COMPANY_ID 为空)
companyAccountString否50招标单位账号(对应电采平台单位编码)。与 tenderUnit 配套传入;账号命中后自动带出招标单位 ID,未匹配到时从发布单位向上取所属单位;仍未匹配到时仅保存 tenderUnit 中文名
procurementUnitOrSectionNoString是50采购包或标段编号,无标段传 "无"
procurementContentString是500采购内容
procurementCategoryString是20采购分类字典码:Goods-货物类 / Engineering-工程类 / Service-服务类
procurementPurposeString是50采购用途字典码:1-对外贸易 / 2-固定资产 / 3-行政办公经营消耗 / 4-军品科研生产 / 5-民品科研生产 / 6-军民共用科研生产
procurementMethodString是50采购方式字典码:Focus-集中采购 / OpenTender-招标采购 / InviteTender-邀请招标 / CompetitiveNegotiation-谈判采购 / Inquiry-询比采购 / SingleSource-单一来源 / ContinueSource-延续性采购 / Petty-其他直接采购 / BidTender-竞价采购
procurementOrganizationFormString是50采购组织形式字典码:1-一级集采 / 2-二级集采 / 3-自行采购
isEntrustedToAgencyString是1是否委托招标机构:1=是,0=否
isPublishedOnMilitaryEquipmentInfoNetworkString否1是否发布全军武器装备采购信息网;不传默认 0
isPublishedOnPublicServicePlatformString否1是否发布公共服务平台;不传默认 0
isPublishedOnElectronicProcurementString否1是否发布电采公告;不传默认 1;传 0 时公告仍落库但不对外展示
electronicProcurementAnnouncementTypeString是50电采公告类型字典码:1-采购需求 / 2-中标候选人公示 / 3-变更公告 / 4-中标公告 / 5-其他公告 / 6-全部;必须与 announcementType 传相同的值
relatedPublicAnnouncementString否100关联公示公告
announcementTypeString是50公告类型字典码:1-采购需求 / 2-中标候选人公示 / 3-变更公告 / 4-中标公告 / 5-其他公告 / 6-全部;必须与 electronicProcurementAnnouncementType 传相同的值
announcementViewScopeString否20公告查看范围字典码:SUPPLIER-供应商 / UNIT-成员单位 / UNIT_SELF-本单位 / ALL-全部;不传默认 ALL
titleString是200公告标题
budgetAmountWanYuanString是50预算金额(万元),纯数字,最多两位小数,≥ 0
publishTimeString是—发布时间,格式 yyyy-MM-dd HH:mm:ss
endTimeString是—结束时间,格式 yyyy-MM-dd HH:mm:ss,必须晚于 publishTime
FILE_PATHString否255附件编码,取 /uploadFile 接口返回的 FILE_PATH
publishContentString是—发布内容,富文本/HTML;电采平台将进行 XSS 安全过滤
remarksString否500备注
publishUnitString否100发布单位名称。作为兜底:联系人账号未识别到用户、且 publishUnitAccount 也未匹配到部门时,用该名称匹配部门;仍匹配不到则直接作为发布单位名称保存
publishUnitAccountString否50发布单位账号(对应电采平台部门编码)。作为兜底:联系人账号未识别到用户时,用它匹配部门;命中后自动带出部门 ID、部门编码、部门名称
contactPersonString否50联系人姓名。与 contactAccount 至少填一个;账号未匹配到用户时用该姓名匹配用户;两者均未命中时接口返回 400 错误
contactAccountString否50联系人账号(对应电采平台用户编码)。与 contactPerson 至少填一个;命中后自动带出用户 ID、用户编码、用户姓名
contactPhoneString是20联系方式(手机号或固话)
SUBMIT_TIMESTAMPString否—数据时间戳,13 位毫秒时间戳字符串

响应(NoticePublishResponse)#

字段类型说明
successbooleantrue = 成功;false = 失败
messageString响应信息
codeint200=成功;400=参数错误;401=鉴权失败;409=公告已存在(幂等命中);500=系统异常
dataObject业务数据,成功时含 noticeId(供应商公告表 ID)、publicAnnouncementId(公共公告表 ID)

请求示例#

{
  "sourcingOrderNo": "XJ-2026-0001",
  "sourceCode": "XXXXX",
  "sourceUnit": "中国电子科技集团公司第三十四研究所",
  "sourceSystem": "XX采购管理系统",
  "projectNumber": "32-XJ-2606-4061",
  "tenderUnit": "中国电子科技集团公司第三十四研究所",
  "companyAccount": "ZDK34",
  "procurementUnitOrSectionNo": "无",
  "procurementContent": "线缆一批",
  "procurementCategory": "Goods",
  "procurementPurpose": "2",
  "procurementMethod": "Inquiry",
  "procurementOrganizationForm": "3",
  "isEntrustedToAgency": "0",
  "isPublishedOnElectronicProcurement": "1",
  "electronicProcurementAnnouncementType": "1",
  "announcementType": "1",
  "announcementViewScope": "SUPPLIER",
  "title": "202606CGGYZX询价项目线缆项目公告",
  "budgetAmountWanYuan": "100.50",
  "publishTime": "2026-10-28 10:00:00",
  "endTime": "2026-11-05 17:00:00",
  "FILE_PATH": "GRP-a1b2c3d4",
  "publishContent": "<p>公告正文...</p>",
  "publishUnit": "中国电子科技集团公司第三十四研究所",
  "publishUnitAccount": "ZDK34",
  "contactPerson": "张三",
  "contactAccount": "zhangsan",
  "contactPhone": "0773-6345713",
  "SUBMIT_TIMESTAMP": "1782900214038"
}

成功响应示例#

{
  "success": true,
  "message": "发布成功",
  "code": 200,
  "data": {
    "noticeId": "402007",
    "publicAnnouncementId": "402007"
  }
}

幂等命中响应示例#

{
  "success": true,
  "message": "公告已存在,幂等返回",
  "code": 200,
  "data": {
    "noticeId": "402007",
    "publicAnnouncementId": "402007",
    "idempotentHit": true
  }
}

失败响应示例#

{
  "success": false,
  "message": "公告类型取值错误:announcementType不支持xxx",
  "code": 400,
  "data": {}
}

3.3 拉取公告#

基本信息#

Method:POST
Path:/api/tiu-open/srm/v1/notice/pull
Content-Type:application/json
说明:按天拉取指定发布日期的公告;过滤字段传字典码数组,不传、空数组或含"全部"码(6/ALL)视为不过滤。

请求体结构(NoticePullVo)#

字段类型必填说明
sysCodeString是系统编码,由电采平台统一分配,固定传 XXXXX
publishTimeString是发布日期,格式 yyyy-MM-dd,按天拉取当日发布的公告
procurementMethodString[]否采购方式字典码,数组可多选:Focus-集中采购 / OpenTender-招标采购 / InviteTender-邀请招标 / CompetitiveNegotiation-谈判采购 / Inquiry-询比采购 / SingleSource-单一来源 / ContinueSource-延续性采购 / Petty-其他直接采购 / BidTender-竞价采购;不传或空数组 = 全部
announcementTypeString[]否公告类型字典码,数组可多选:1-采购需求 / 2-中标候选人公示 / 3-变更公告 / 4-中标公告 / 5-其他公告 / 6-全部;不传、空数组或含 "6"(全部)= 全部
announcementViewScopeString[]否公告查看范围字典码,数组可多选:SUPPLIER-供应商 / UNIT-成员单位 / UNIT_SELF-本单位 / ALL-全部;不传、空数组或含 "ALL"(全部)= 全部

响应(NoticePullResponse)#

字段类型说明
successbooleantrue = 成功;false = 失败
messageString响应信息
codeint200=成功;400=参数错误;401=鉴权失败;500=系统异常
data.totalint符合条件的公告总条数
data.listNoticePullItemVo[]公告数组

NoticePullItemVo 字段#

字段类型说明
noticeIdString公告 ID(供应商公告表 ID)
sourcingOrderNoString采购寻源单号
sourceCodeString来源编码
sourceUnitString来源系统单位
sourceSystemString来源系统名称
projectNumberString项目编号
tenderUnitString招标单位名称
companyAccountString招标单位账号(电采平台单位编码)
procurementUnitOrSectionNoString采购包或标段编号
procurementContentString采购内容
procurementCategoryString采购分类字典码:Goods-货物类 / Engineering-工程类 / Service-服务类
procurementPurposeString采购用途字典码:1-对外贸易 / 2-固定资产 / 3-行政办公经营消耗 / 4-军品科研生产 / 5-民品科研生产 / 6-军民共用科研生产
procurementMethodString采购方式字典码:Focus-集中采购 / OpenTender-招标采购 / InviteTender-邀请招标 / CompetitiveNegotiation-谈判采购 / Inquiry-询比采购 / SingleSource-单一来源 / ContinueSource-延续性采购 / Petty-其他直接采购 / BidTender-竞价采购
procurementOrganizationFormString采购组织形式字典码:1-一级集采 / 2-二级集采 / 3-自行采购
isEntrustedToAgencyString是否委托招标机构:1 / 0
isPublishedOnMilitaryEquipmentInfoNetworkString是否发布全军信息网:1 / 0
isPublishedOnPublicServicePlatformString是否发布公共服务平台:1 / 0
electronicProcurementAnnouncementTypeString电采公告类型字典码:1-采购需求 / 2-中标候选人公示 / 3-变更公告 / 4-中标公告 / 5-其他公告 / 6-全部
relatedPublicAnnouncementString关联公示公告
announcementTypeString公告类型字典码:1-采购需求 / 2-中标候选人公示 / 3-变更公告 / 4-中标公告 / 5-其他公告 / 6-全部
announcementViewScopeString公告查看范围字典码:SUPPLIER-供应商 / UNIT-成员单位 / UNIT_SELF-本单位 / ALL-全部
titleString公告标题
budgetAmountWanYuanString预算金额(万元)
publishTimeString发布时间 yyyy-MM-dd HH:mm:ss
endTimeString结束时间 yyyy-MM-dd HH:mm:ss
updateTimeString更新时间 yyyy-MM-dd HH:mm:ss
publishContentString发布内容(富文本/HTML)
remarksString备注
publishUnitString发布单位名称(电采平台部门名称)
publishUnitAccountString发布单位账号(电采平台部门编码)
contactPersonString联系人姓名(电采平台用户姓名)
contactAccountString联系人账号(电采平台用户编码)
contactPhoneString联系方式
attachmentsNoticePullAttachmentVo[]附件列表,无附件时为空数组

NoticePullAttachmentVo 字段#

字段类型说明
fileIdString附件唯一标识(附件 ID,下载接口入参)
fileNameString原始文件名(含后缀)
fileTypeString附件类型(文件后缀,如 pdf、doc、docx)
fileSizeLong附件大小(字节)
downloadUrlString完整下载地址(指向 /attachment/download,需携带 sysCode)

请求示例#

{
  "sysCode": "XXXXX",
  "publishTime": "2026-10-28",
  "procurementMethod": ["Inquiry", "CompetitiveNegotiation"],
  "announcementType": ["1", "4"],
  "announcementViewScope": ["SUPPLIER"]
}

响应示例#

{
  "success": true,
  "message": "success",
  "code": 200,
  "data": {
    "total": 1,
    "list": [
      {
        "noticeId": "402007",
        "sourcingOrderNo": "XJ-2026-0001",
        "sourceCode": "XXXXX",
        "sourceUnit": "中国电子科技集团公司第三十四研究所",
        "sourceSystem": "XX采购管理系统",
        "projectNumber": "32-XJ-2606-4061",
        "tenderUnit": "中国电子科技集团公司第三十四研究所",
        "companyAccount": "ZDK34",
        "procurementUnitOrSectionNo": "无",
        "procurementContent": "线缆一批",
        "procurementCategory": "Goods",
        "procurementPurpose": "2",
        "procurementMethod": "Inquiry",
        "procurementOrganizationForm": "3",
        "isEntrustedToAgency": "0",
        "isPublishedOnMilitaryEquipmentInfoNetwork": "0",
        "isPublishedOnPublicServicePlatform": "0",
        "electronicProcurementAnnouncementType": "1",
        "relatedPublicAnnouncement": null,
        "announcementType": "1",
        "announcementViewScope": "SUPPLIER",
        "title": "202606CGGYZX询价项目线缆项目公告",
        "budgetAmountWanYuan": "100.50",
        "publishTime": "2026-10-28 10:00:00",
        "endTime": "2026-11-05 17:00:00",
        "updateTime": "2026-10-28 10:00:00",
        "publishContent": "<p>公告正文...</p>",
        "remarks": null,
        "publishUnit": "中国电子科技集团公司第三十四研究所",
        "publishUnitAccount": "ZDK34",
        "contactPerson": "张三",
        "contactAccount": "zhangsan",
        "contactPhone": "0773-6345713",
        "attachments": [
          {
            "fileId": "402007",
            "fileName": "招标公告.pdf",
            "fileType": "pdf",
            "fileSize": 102400,
            "downloadUrl": "http://host/api/tiu-open/srm/v1/notice/attachment/download?fileId=402007&sysCode=XXXXX&noticeId=402007"
          }
        ]
      }
    ]
  }
}

3.4 公告附件下载#

基本信息#

Method:GET
Path:/api/tiu-open/srm/v1/notice/attachment/download

参数说明#

参数类型必填说明
fileIdString是附件 ID,取拉取接口返回的 attachments[].fileId
sysCodeString是系统编码,由电采平台统一分配,固定传 XXXXX
noticeIdString否公告 ID,取拉取接口返回的 noticeId,用于下载流水留痕

成功响应#

Content-Type:application/octet-stream
Content-Disposition:attachment;filename=<URLEncoder编码后的原始文件名>
Body:附件二进制流

失败响应(JSON)#

{
  "success": false,
  "message": "附件不存在或已被删除"
}

调用示例#

GET /api/tiu-open/srm/v1/notice/attachment/download?fileId=402007&sysCode=XXXXX&noticeId=402007

四、权限说明#

所有公告接口统一使用系统编码 XXXXX(由电采平台统一分配),无需申请 Token、无需配置 IP。
项说明
系统编码4 个接口均传 XXXXX(由电采平台统一分配);publish 接口传在 sourceCode 字段,其余接口传在 sysCode 字段
白名单电采平台侧通过配置项 notice.sysCode 维护,格式为 编码/名称,多个用逗号分隔
XXXXX 为接口传值,名称部分仅用于电采平台调用日志展示
调用方只需关心编码部分,无需传中文名

五、字典取值总览#

5.1 公告类型(ANNOUNCEMENT_TYPE)#

字典码中文名
1采购需求
2中标候选人公示
3变更公告
4中标公告
5其他公告
6全部

5.2 采购分类(procurementCategory)#

字典码中文名
Goods货物类
Engineering工程类
Service服务类

5.3 采购用途(procurementPurpose)#

字典码中文名
1对外贸易
2固定资产
3行政办公经营消耗
4军品科研生产
5民品科研生产
6军民共用科研生产

5.4 采购方式(procurementMethod)#

字典码中文名
Focus集中采购
OpenTender招标采购
InviteTender邀请招标
CompetitiveNegotiation谈判采购
Inquiry询比采购
SingleSource单一来源
ContinueSource延续性采购
Petty其他直接采购
BidTender竞价采购

5.5 采购组织形式(procurementOrganizationForm)#

字典码中文名
1一级集采
2二级集采
3自行采购

5.6 公告查看范围(announcementViewScope)#

字典码中文名
SUPPLIER供应商
UNIT成员单位
UNIT_SELF本单位
ALL全部

5.7 布尔值字段#

以下字段统一使用 "1" 表示是、"0" 表示否:
isEntrustedToAgency
isPublishedOnMilitaryEquipmentInfoNetwork
isPublishedOnPublicServicePlatform
isPublishedOnElectronicProcurement

六、注意事项#

主题说明
字典字段所有字典字段(采购分类、采购用途、采购方式、采购组织形式、公告类型、公告查看范围)直接传字典码,不要传中文名;拉取接口返回的字典字段同样是字典码;完整字典见第五章
系统编码所有接口统一传 XXXXX(由电采平台统一分配);编码错误或不在白名单内返回 401
幂等publish 以 sourceCode + sourcingOrderNo 为幂等键,重复推送返回 200 + 已存在公告 ID
发布单位 / 联系人联系人必须命中后台用户:先按 contactAccount(用户编码)匹配用户,未命中再按 contactPerson(中文姓名)匹配;两项均未命中时接口返回 400 错误。发布单位优先从已识别的联系人反查:取用户的所属部门作为发布单位(部门 ID、编码、名称均取后台);若反查不到,再按 publishUnitAccount(部门编码)匹配,最后按 publishUnit 中文名称匹配。contactAccount/contactPerson 至少填写一个,publishUnitAccount/publishUnit 至少填写一个
招标单位推荐前置查询:推送公告前先调用 招标单位信息查询接口 传入单位中文名,返回的名称与单位编码分别作为 tenderUnit 与 companyAccount 一起推送。后端兜底规则:先按 companyAccount(单位编码)匹配单位,未命中再用 tenderUnit 名称匹配;均未匹配到时向上取发布单位所属单位;仍未匹配到时仅保存 tenderUnit 中文名,单位 ID 为空
XSS 安全publishContent 为富文本 HTML,电采平台入库前会过滤 <script>、<iframe>、on* 事件、javascript: 协议等危险片段
isPublishedOnElectronicProcurement=0公告仍落库(公共公告表 + 供应商公告表均有记录),但不会出现在供应商门户公告列表和 /pull 拉取接口中
时间格式publishTime、endTime 统一 yyyy-MM-dd HH:mm:ss;pull.publishTime 仅日期 yyyy-MM-dd,按当天 [00:00:00, 24:00:00) 范围过滤
附件下载必须带 sysCode,下载流水无论成功失败均记录到 SRM_NOTICE_ATTACH_LOG
调用记录所有接口请求自动写入 SRM_NOTICE_API_LOG,含 sysCode、接口名、耗时、参数、结果码、错误信息、请求 IP、requestId
announcementType 与 electronicProcurementAnnouncementType推送接口中这两个字段必须传相同的值,否则返回参数校验错误

七、响应码汇总#

code场景
200成功;幂等命中也返回 200(data.idempotentHit=true)
400参数校验失败(必填缺失、格式错误、字典值不支持、时间顺序错误等)
401鉴权失败(sysCode/sourceCode 为空或不在白名单内)
500系统内部异常

如接口有变更,以最新发布的接口文档为准。
上一页
下载对账单物品明细导入模板
下一页
根据名称模糊搜索招标单位信息
Built with