生产、委外、质检三域开放(403 个接口)
采购与供应链服务的剩余成套业务接入开放平台,新增 403 个接口:
三个新域 subcontract(委外 98)、production(生产 54)、
quality(质检 39),另有 197 个补入 srm、15 个补入 inventory。
站点接口总数 962 → 1365。
三个新域
| 域 | 覆盖 | 接口数 |
|---|---|---|
subcontract 委外 | 订单、发料、回厂、退料、对账、供应商档案、报表、追溯链 | 98 |
production 生产 | 装配、拆解、生产领料、改制、商品组合、组装报表、缺料看板 | 54 |
quality 质检 | 检验单、不合格处理(NCR)、待检库存、产品实例追溯、SN 核验 | 39 |
三者都承载于 comap-srm,但权限上彼此独立、也独立于 srm——可以只授予
委外协作而不给采购下单权,或只授予质检数据而不给物料主数据。
⚠️ 需要重新授权
production / subcontract / quality 是新增的范围词汇。在此之前完成授权的
凭证不包含这三个域——即便原先勾了 srm:read,也访问不到委外、生产、质检接口。
- OAuth 凭证:重新走一次授权流程,勾选所需范围
- AppKey:授权范围创建时固定,需新建后切换、再吊销旧的
同批补入既有域
srm 增加 197 个(供应商拉黑与评分、物料批量操作与临时物料、采购订单全流程、
BOM 结构编辑与版本、采购付款申请、采购待办池、到货登记与通知等),由 93 增至 290;
inventory 增加 15 个(库存锁定、库存报表等),由 144 增至 159。
高危操作
新增接口中 160 个标记为高危。本批大量涉及单据状态流转——提交、审核、反审核、
作废、撤回、确认入库、完工、释放、下达——这类操作会推动业务流程且多数不可逆,
故从严标记。新建与编辑(create / update / save / copy)不在其列。
经 MCP 调用高危接口须先向用户复述操作内容并获得明确同意,再携 confirm: true
重新调用。
未纳入本批
登记前按「能否经统一 invoke 入口调通」逐条筛过,以下确认调不通或不适合开放:
- 服务间 Feign 调用(133 个):内部 RPC,不属于对外能力。
- Excel 导入(9 个):参数是
MultipartFile,虽然接口规格把它渲染成{"file": "string"},实际仍需 multipart 表单,JSON 入口传不了。 - 文件下载与模板下载(10 个):直接写响应流,统一入口只返回 JSON 信封。
- 附件绑定(7 个)与各类导入导出任务:与其他域的处理一致。
- 供应商门户免登录入口:走 302 跳转,且设计上不经开放平台鉴权。