跳到主要内容

采购与供应链业务设置接入(168 个接口,含编码变更)

Avery
Risemap 开放平台

采购与供应链的 35 项业务设置接入 config 域,新增 168 个接口。 同时 BOM 分类由 srm.bom.category.* 迁至 config.srm.bom-category.*, 所需范围由 srm:* 改为 config:*——旧编码即刻失效,继续调用返回 92201 接口未登记或已停用。

覆盖的 35 项​

分组配置项
物料商品分类、计量单位、商品品牌、物料来源类型、物料属性、商品编码规则、单位换算、条码打印模板
BOMBOM 分类
供应商供应商级别、供应商分类
采购采购分类、采购付款条件、采购应付节点模板
仓储仓库类型、报损类型、锁库原因、释放原因、其他入库类型、其他出库类型、物流公司(两套)、库存预警设置、库存预警规则
质检检验方案、检验项目、检验项目分类
生产改制原因、拆解原因
委外加工类型、退料原因、加工价目、全局配置
通用导入模板、导出模板

完整清单见采购与供应链业务设置。

编码规则​

与销售业务设置的「四件套」不同,本组动作段按后端接口命名:

  • 查询:.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.treeconfig.srm.bom-category.tree
srm.bom.category.createconfig.srm.bom-category.create
srm.bom.category.updateconfig.srm.bom-category.update
srm.bom.category.deleteconfig.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,另批评估。
  • 物料选择器筛选偏好:使用者个人偏好,非租户级配置。