采购与供应链业务设置接入(168 个接口,含编码变更)
采购与供应链的 35 项业务设置接入 config 域,新增 168 个接口。
同时 BOM 分类由 srm.bom.category.* 迁至 config.srm.bom-category.*,
所需范围由 srm:* 改为 config:*——旧编码即刻失效,继续调用返回
92201 接口未登记或已停用。
覆盖的 35 项
| 分组 | 配置项 |
|---|---|
| 物料 | 商品分类、计量单位、商品品牌、物料来源类型、物料属性、商品编码规则、单位换算、条码打印模板 |
| BOM | BOM 分类 |
| 供应商 | 供应商级别、供应商分类 |
| 采购 | 采购分类、采购付款条件、采购应付节点模板 |
| 仓储 | 仓库类型、报损类型、锁库原因、释放原因、其他入库类型、其他出库类型、物流公司(两套)、库存预警设置、库存预警规则 |
| 质检 | 检验方案、检验项目、检验项目分类 |
| 生产 | 改制原因、拆解原因 |
| 委外 | 加工类型、退料原因、加工价目、全局配置 |
| 通用 | 导入模板、导出模板 |
完整清单见采购与供应链业务设置。
编码规则
与销售业务设置的「四件套」不同,本组动作段按后端接口命名:
- 查询:
.list/.tree/.page/.detail/.list-enabled/.get - 写:
.create/.update/.delete/.save(新增或更新合一)/.toggle/.toggle-enabled(启停)/.sort/.set-default/.copy
例:config.srm.product-category.tree、config.srm.supplier-level.toggle、
config.srm.subcontract-config.save。
⚠️ BOM 分类编码变更
| 旧编码 | 新编码 |
|---|---|
srm.bom.category.tree | config.srm.bom-category.tree |
srm.bom.category.create | config.srm.bom-category.create |
srm.bom.category.update | config.srm.bom-category.update |
srm.bom.category.delete | config.srm.bom-category.delete |
BOM 分类本质是业务设置,此前登记在 srm 域属归类遗留。本次随同类项一并归位,
srm 域相应由 78 条降为 74 条。
授权
config 是既有范围词汇。已勾选 config:read / config:write 的凭证无需重新授权
即可访问本批接口——这与销售、财务两批业务设置共用同一组范围。
但仅勾了 srm:* 的凭证会失去 BOM 分类的访问权,需补勾 config 范围。
- OAuth 凭证:重新走一次授权流程,勾选
config:read/config:write - AppKey:授权范围创建时固定,需新建后切换、再吊销旧的
高危操作
31 个删除类接口标记为高危。字典项删除会影响引用它的历史单据,部分后端已做引用校验 (如委外加工类型「有子级或被引用时拒绝」),但不是所有项都有。
经 MCP 调用须先向用户复述并获同意后携 confirm: true。
未纳入本批
- 导入导出任务(
/data-tasks/*):与其他域一致,属辅助接口。 - 供应商评分、供应商银行账户、商品客户别名、商品图片台账:是业务数据而非设置,
按域归属应进
srm,另批评估。 - 物料选择器筛选偏好:使用者个人偏好,非租户级配置。