跳到主要内容

供应商评分/银行账户、商品别名/图片台账接入（22 个接口）

Avery
Risemap 开放平台

补齐上一批采购与供应链业务设置中列为「另批评估」的四组接口， 共 22 个：19 个进 srm 域，3 个商品图片命名规则进 config.srm。

接口分布​

实体编码前缀域接口数
供应商评分srm.supplier.scoresrm读 3 / 写 2
供应商银行账户srm.supplier.banksrm读 1 / 写 4
商品客户别名srm.product.aliassrm读 1 / 写 4
商品图片台账srm.product.image-ledgersrm读 2 / 写 2
商品图片命名规则config.srm.product-image-naming-ruleconfig读 1 / 写 2

前四组是业务数据，归 srm 域，需 srm:read / srm:write；命名规则是租户级配置， 归 config.srm，需 config:read / config:write。二者范围相互独立。

图片台账不传文件​

srm.product.image-ledger.upload 与 .batch-bind 的名字容易误解——它们 不接收文件本身，只接收已上传到文件服务的 fileIds（或绑定项列表）， 把文件与商品关联起来：

{
  "apiCode": "srm.product.image-ledger.upload",
  "body": {
    "productId": "1961000000000000001",
    "fileType": "MAIN_PIC",
    "fileIds": ["..."]
  }
}

fileType 取 MAIN_PIC（主图）/ SUB_PIC（副图）/ ATTACHMENT（附件）。 文件上传本身不在开放接口范围内。

高危操作​

4 个：三处删除（评分、银行账户、别名）与命名规则重置。删除银行账户会影响引用它的 付款记录，重置命名规则会删除当前租户的自定义规则、回落系统默认。

经 MCP 调用须先向用户复述并获同意后携 confirm: true。

授权​

两个域都是既有范围词汇，已授权的凭证无需重新授权：勾了 srm:* 即可用前四组， 勾了 config:* 即可用命名规则。

至此 srm 服务的开放情况​

comap-srm 承载三个域，合计 408 个接口：srm 93、inventory 144、config.srm 171。 仍未开放的主要是生产、委外单据、检验单、采购待办池等成套业务，以及各类附件、 导入导出任务与 Feign 内部调用。