BOM
30 个接口（读 12 / 写 18） · 其中 7 个高危 · 凭证范围：查询需 srm:read，写操作需 srm:write
| 接口 | 编码 | 后端签名 | |
|---|---|---|---|
| GET | 获取 BOM 审批日志 | srm.bom.approval-log | /v1/bom/approval-log |
| POST 高危 | 归档 (已失效 → 已归档) | srm.bom.archive | /v1/bom/archive |
| POST 高危 | 批量删除 BOM | srm.bom.batch-delete | /v1/bom/batch-delete |
| POST 高危 | 批量失效 BOM | srm.bom.batch-disable | /v1/bom/batch-disable |
| POST | 批量导入 BOM (主档 + 扁平结构, 后端重建树并按 BOM 隔离事务) | srm.bom.batch-import | /v1/bom/batch-import |
| GET | 校验 BOM 编码是否已存在 | srm.bom.check-code | /v1/bom/check-code |
| POST | 复制 BOM | srm.bom.copy | /v1/bom/copy |
| POST | 创建 BOM | srm.bom.create | /v1/bom/create |
| POST | 创建 BOM + 保存结构 (单事务) | srm.bom.create-with-structure | /v1/bom/create-with-structure |
| POST 高危 | 删除 BOM | srm.bom.delete | /v1/bom/delete |
| GET | BOM 详情 | srm.bom.detail | /v1/bom/detail |
| POST | BOM 对比 (按物料编码 diff) | srm.bom.diff | /v1/bom/diff |
| POST 高危 | 失效 (已生效 → 已失效) | srm.bom.disable | /v1/bom/disable |
| GET | 获取BOM自定义导出可选字段列表 | srm.bom.export-fields | /v1/bom/export-fields |
| POST | 批量校验 BOM 编码是否已在系统存在 (忽略大小写) | srm.bom.import.check-codes | /v1/bom/import/check-codes |
| POST | 创建新版本 (已生效 → 草稿) | srm.bom.new-version | /v1/bom/new-version |
| POST | BOM 分页查询 | srm.bom.page | /v1/bom/page |
| GET | 按项目 ID 查询 BOM 物料汇总统计 | srm.bom.project-bom-stats | /v1/bom/project-bom-stats |
| GET | 按项目 ID 查询关联 BOM 下拉选项 | srm.bom.project-options | /v1/bom/project-options |
| GET | BOM 缺料分析 (根据库存计算物料缺口) | srm.bom.shortage-analysis | /v1/bom/shortage-analysis |
| GET | 各状态 BOM 数量统计 | srm.bom.status-count | /v1/bom/status-count |
| POST | 添加单个 BOM 节点 | srm.bom.structure.add-node | /v1/bom/structure/add-node |
| POST | 批量导入物料 (基于商品库) | srm.bom.structure.batch-import | /v1/bom/structure/batch-import |
| POST 高危 | 删除节点 (含子树) | srm.bom.structure.delete-node | /v1/bom/structure/delete-node |
| POST | 保存完整 BOM 结构 (全量替换) | srm.bom.structure.save | /v1/bom/structure/save |
| POST | 更新单个节点字段 | srm.bom.structure.update-node | /v1/bom/structure/update-node |
| POST 高危 | 提交 BOM 评审 | srm.bom.submit-review | /v1/bom/submit-review |
| POST | 更新 BOM | srm.bom.update | /v1/bom/update |
| POST | 更新 BOM + 保存结构 (单事务) | srm.bom.update-with-structure | /v1/bom/update-with-structure |
| GET | 获取 BOM 版本列表 | srm.bom.versions | /v1/bom/versions |
调用协议（各页通用）
本实体接口统一通过 POST https://open.risemap.cn/v1/api/invoke 调用，用 apiCode 指定接口。
JSON 响应为统一信封 { code, message, data }，文件接口成功时直接返回文件；
错误码见错误码说明；凭证获取与调用协议见开放接口清单。
示例中的鉴权头为 OAuth 访问令牌形态；AppKey 集成商换成 -H "X-App-Key: <appKey>" -H "X-App-Secret: <appSecret>" 即可，其余不变。
所有调用以绑定员工身份执行，员工须具备对应主站功能权限（默认按后端接口 URL 自动对照，个别接口单独标注权限码）。
本页由接口注册表与后端接口规格自动生成。