本次新增启用（237 个）​

售后服务模块​

覆盖售后服务从受理到结算的全流程：

• 服务工单：新建、受理、派工 / 改派、预约上门、挂起与恢复、拆分、重新打开、升级协同、回访与时间线； 以及服务人员、收费项目、工单类型、付款模板、技能标签、SLA 规则、报价设置等工单配置
• 报修池：报修单的认领、合并重复、忽略与联系记录
• 服务报价：报价单的编制、发送客户、执行、撤回与作废
• 备件申请：申请提交与取消、分批出库、退库与验收入库、异常处置
• 工时与成本费用：工时登记，成本费用登记与报销提交
• 服务结算：按报价生成结算单、提交审批、查询可核销的收款流水
• 质保：质保卡的新建、按销售订单批量建卡、激活、延保、终止与恢复；质保规则与匹配试算；按 SN 查询客户资产
• 服务工作台：我的工单、报价、备件申请、结算单与服务业绩

所需范围为 sales:read / sales:write，与销售域其他接口一致。完整清单见 开放接口清单。

前批待部署接口已启用​

2026-09-29 公告中登记但暂未启用的接口，已随后端必填校验发布启用：

• 新建 / 编辑类写接口：跟进记录、拜访计划、客户收货地址、框架协议、附加费用、其他收入、 销售目标、特价申请、物料折扣与阶梯价，行政各台账与申请的新建编辑，财务订单优惠申请的创建、 更新、反审核与作废，以及销售业务设置的编辑与启停。
• 行政申请的提交：请假、加班、出差、补签以当前用户为申请人发起；各类草稿只能由本人提交。
• 单据手动完结：供应链与项目的 document-completion.complete / .reopen，用于部分执行的单据 提前完结或重新打开；完结前须先调用前置校验，数据已变化时返回 40911。
• 查询：请假详情（按数据权限返回，事由与附件可能含敏感信息）、设备工单的执行记录、 操作日志与费用明细。

授信审批的通过 / 驳回、多数单据的反审核、派车结算、折旧计提等管理动作，以及人员清单类接口，仍不向 AI 开放。

下线 / 合并​

财务分类（finance.fin-categories.*，/v1/fin-categories）是旧的费用类别接口，其 6 个接口与费用类别接口功能重复，现已停用，调用返回 92201。请使用费用类别 finance.expense-categories.*（/v1/expense-categories）。

参数说明订正​

• office.fixed-asset.page：补充汇总统计字段的口径（全租户未报废资产）。
• sales.price-product.category-tree：明确 productCount 按物料计数、含全部子分类，不是 SKU 数。
• sales.price-group.unassigned-sku-page：补全查询参数。

开放规模​

各域明细见开放接口清单，字段级说明见接口参考。

批量导入：import-rows / import-result​

srm、sales、finance、project 四个服务各新增一组同形接口：

• 单次请求 ≤500 行，单个任务 ≤5000 行、≤200,000 个单元格、约 10MB 文本；超过 500 行按 sessionId + chunkIndex + finalChunk 分批串行提交；
• requestId 幂等：同一批重试复用同一 requestId，24 小时内返回首次结果，不重复建任务；
• 仅本租户系统管理员可用；SRM_BOM、SRM_PRD_GROUP、FIN_BANK_TXN_IMPORT 暂不支持，请在主站上传 Excel。

批量删除：batch-delete​

新增一批实体的 .batch-delete 接口，body 为 id 数组，单次上限 200 条（销售订单、发货单为 50 条）， 逐条独立处理并返回 totalCount / successCount / failCount / failReasons。 此前已开放的 srm 批量删除（物料、供应商、BOM、价格本等）保持「全部成功或全部失败」语义。 批量删除均为高危接口，MCP 调用须先向用户逐项确认。

错误码：新增 92205，订正防重说明​

• 新增 92205 写操作处理超时，结果未知：写接口等待下游超过 30 秒时返回。下游可能仍在执行， 须先查询确认，不能按失败重试；此前这类情况返回 92203。
• 结果未知时防重锁续持 120 秒，紧随其后的相同写请求收到 92302。
• 订正：防重锁兜底有效期 30 秒、执行期间不续期；Redis 不可用时放行而非拒绝，平台不存在 92303。

详见错误码与必填字段的判定。

本次新开放接口​

本批新开放 463 个接口，开放总数由 1739 增至 2193。写接口的参考页新增「必填字段」一节， 汇总参数说明与接口规格中标注的必填项，调用前可先对照。

「本次启用」的接口已在接口参考中列出；「部署后启用」的接口暂未启用，调用返回 92201。 其中 96 个已于 2026-09-30 随后端发布启用（其余审批、反审核等仍不开放），见售后服务模块开放，批量导入与批量删除上线。

销售​

• 客户经营：跟进记录、拜访计划、公海客户（领取、分配、释放、归档）、客户收货地址、客户授信
• 价格体系：客户价格表、客户物料对照、框架协议、价格组、价格调整、特价申请、物料售价查询
• 投标与商务：投标项目、投标任务、商务函件
• 费用与收款：附加费用、其他收入、商誉订单、销售收款流水分配
• 目标与分析：销售目标、销售团队、销售业绩、销售报表
• 业务设置：客户分类、客户级别、联系人决策权重、客户标签、跟进结果、线索意向等级、商机输单原因

行政（office）​

人事与办公域此前仅开放通讯录，本批开放行政办公能力：待办、会议与会议室、文档与材料库、 规章制度与员工手册、工作汇报、资质证书、政策申报、用印、用车、设备与维保工单、固定资产、 物品借用、办公物料、礼品、酒水库存；考勤记录与统计、请假、加班、出差仅开放查询。 薪资、绩效、员工档案、入离职与招聘仍不开放。

财务、供应链与项目​

• 财务：订单优惠申请、合并付款查询、待确认存货成本、发票税率差异留痕，以及借款与银行借款的删除
• 供应链：单据完结记录查询、供应商物料历史采购价批量查询；委外表单元数据查询
• 项目：单据完结记录查询

部署后启用的接口​

以下三类接口已登记，暂不启用：

• 服务端必填校验待部署：新建 / 编辑类写接口（如跟进记录与拜访计划编辑、框架协议、附加费用、 行政各台账与申请的新建编辑、单据手动完结 / 重开）。后端补齐必填校验的版本上线后再启用， 避免经接口写入缺字段的数据。
• 审批与反审核：授信申请的审批通过 / 驳回，以及各单据的反审核，不向 AI 开放。
• 个人信息与数据范围：涉及人员清单、他人请假明细等个人信息，或数据权限边界待确认的接口，核实后再开放。

本批下线​

以下 9 个接口不在本次快照中：质检的产品保修调整与保修配置（4 个）、委外发料签收、 项目预算的列表 / 汇总 / 更新与预算执行分析（4 个）。

生产域名 https://open.risemap.cn 可用，接口能力与 dev / release 环境一致。

原因​

主站有一道全局防重复提交的闸，按请求 URL 后缀判断是不是查询——/page、/list、 /detail 等自动放行，其余加锁。

开放平台的入口是泛化派发端点，URL 恒为 /v1/api/invoke（MCP 则是 /v1/mcp）， 从 URL 看不出背后调的是哪个接口，那份查询白名单永远匹配不上。于是同一个查询走 主站被放行、走开放平台却被当成写操作加了锁：

主站  POST /v1/customer/page   → 命中 /page，放行
开放  POST /v1/api/invoke      → 匹配不上，加锁 → 并发相同查询 429

现在的行为​

判定依据改为接口注册表里的读写声明，不再猜 URL：

写接口的防重保留——参数完全相同的写请求在前一次尚未返回时重发会被拦下，这是 防止重复下单、重复入库这类问题的必要保护。

新增 92302​

此前这类拒绝复用的是 429，与频率超限混在一起，集成方无从区分该退避还是该等待。 现在分开：

• 92301 请求过于频繁 —— 频率超限，退避后重试
• 92302 该请求正在处理中 —— 有参数相同的写请求未返回，等前一次返回即可，无需退避

判定依据是「凭证 + 接口编码 + 请求参数」三者全同，参数不同即视为不同请求。 详见错误码。

顺带​

这类拒绝此前发生在调用审计之前，不留任何记录。现已补记，可在调用审计中查到。

接口分布​

完整清单与字段级说明见财务域与 接口参考。

授权​

finance 与 config 都是既有的范围词汇，本次没有新增范围。但在此之前完成授权的 凭证若没勾选 finance:read / finance:write，仍访问不到财务接口——先前无接口可用时 多数集成没有勾它。

• OAuth 凭证：重新走一次授权流程，勾选所需的 finance 范围
• AppKey：授权范围创建时固定，需新建后切换、再吊销旧的

财务业务设置（付款方式、发票邮箱）归 config 域，需 config:read / config:write， 与 finance 范围相互独立。

高危操作​

183 个写接口标记为高危，占财务写接口的绝大多数——财务写操作普遍涉及资金、审批状态 或账务数据，包括收付款确认、核销、开票、成本结转、收入确认、期初数据设置与各类审批 动作（提交、审核、驳回、撤回、反审核）。

经 MCP 调用这些接口须先向用户复述操作内容并获得明确同意，再携 confirm: true 重新调用。直连 POST /v1/api/invoke 的集成方不受此门限制，请自行确保调用前已获授权。

未纳入本批​

• 一次性内部数据回填（/v1/internal/*）：运维用途，后端默认以配置开关禁用，不对外开放。
• 附件绑定、导入导出任务、打印模板等辅助接口，与其他域的处理一致。
• 路径中带 {id} 占位符的 11 个接口：统一 invoke 入口目前只传 query / body， 不做路径参数替换，登记了也调用不通。这批接口待入口支持路径参数后再开放。

站点接口总数 962 → 1365。

三个新域​

三者都承载于 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 跳转，且设计上不经开放平台鉴权。

站点接口总数 1365 → 1729。

覆盖范围​

项目计划、任务与子任务、里程碑、工时与闲置工时、预算费用与成本、支出合同、 日报与项目日志、项目分析报表，以及图纸全生命周期（档案、版本、评审、发布、 变更、发放、权限、目录、客户图纸，共 107 个接口）与交付包管理。

完整清单见项目域与 接口参考。

业务设置​

项目类型、任务类型、工时类型、成本与费用配置、项目角色、日志标签与分类、 计划模板等 14 项归 config.project，需 config:read / config:write， 与 project 范围相互独立。

授权​

project 与 config 都是既有范围词汇，本批没有新增范围。但此前 project 域 一个接口都没有，多数集成不会勾它，仍需重新授权才能访问。

• OAuth 凭证：重新走一次授权流程，勾选 project:read / project:write
• AppKey：授权范围创建时固定，需新建后切换、再吊销旧的

高危操作​

139 个写接口标记为高危，涵盖删除、作废、反审核等状态变更，以及图纸的发布、 变更、发放与权限调整——图纸发放会影响下游的生产与采购。

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

未纳入本批​

• 交付包免登录分享链接（/v1/public/*）：受邀方凭密码或短信验证码访问， 设计上不经开放平台鉴权。
• 服务间 Feign 调用 23 个、文件下载 5 个、附件与导入导出任务 56 个。

人事与办公（HR/OA）不在开放范围​

comap-office 承载的考勤、薪资、绩效、员工档案、入离职与招聘等能力 不对外开放——其中包含个人敏感信息。

覆盖的 35 项​

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

编码规则​

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

• 查询：.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 分类编码变更​

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，另批评估。
• 物料选择器筛选偏好：使用者个人偏好，非租户级配置。

接口分布​

前四组是业务数据，归 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 内部调用。

为什么需要这批​

业务接口返回的数据里到处是 ownerId、deptId、createBy、roleIds 这类 ID 字段，此前开放平台没有任何接口能把它们翻译成名称，集成方只能拿到一串数字。 本批补上组织架构的只读查询，也可用于填充人员/部门/角色选择器。

系统域（system）​

加上原有的字段定义查询，system 域现共 14 个接口，全部只读， 所需范围 system:read。

通讯录（office）​

office.contacts.list 按部门列出员工的姓名、工号、职位、职级、联系方式与头像， 所需范围 office:read。

人事与办公域仅开放这一个接口。 考勤、请假、薪资、调薪、绩效、员工档案、 入离职、招聘与资产设备等均不对外开放——其中含个人敏感信息。

未开放​

用户、部门、角色的写操作不在其列：创建与删除用户、更新用户信息、分配角色权限、 配置数据权限范围、部门排序、离职流程执行等，属账号与权限治理，风险较高。 如有需要另行评估。

授权​

system:read 与 office:read 都是既有范围词汇。system 域仅有只读词汇， 本就不存在 system:write。

旧编码即刻失效，继续使用会返回 92201 接口未登记或已停用。

为什么要拆​

业务设置横跨销售、采购、财务等多个模块，原先按所属模块归域会让同类接口分散到各处； 独立成域后，一次 config:read 即可覆盖全部模块的设置查询，权限也能与业务数据分开授予 ——比如只允许读取配置项、不允许读取客户与订单。

怎么改​

编码规则由 sales.config. + 配置项，变为 config. + 模块 + . + 配置项：

25 个配置项标识本身不变，只是前缀与域归属调整。完整清单见 开放接口清单。

⚠️ 需要重新授权​

config 是新增的范围词汇。在此之前完成授权的凭证不包含该域—— 即便原先勾了 sales:read，也读不到业务设置。

• OAuth 凭证：重新走一次授权流程，勾选 config:read / config:write
• AppKey：授权范围创建时固定、之后不可修改，需新建一个勾选了 config 范围的 AppKey，切换完成后再吊销旧的，以免中断调用

同批变化​

同时新增了 inventory 范围词汇（库存），接口登记正在进行中，稍后另行公告。

接口分布​

完整清单与字段级说明见库存域与 接口参考。

⚠️ 需要重新授权​

inventory 是新增的范围词汇。在此之前完成授权的凭证不包含该域—— 即便原先勾了 srm:read，也访问不到库存接口。

库存虽然由采购与供应链服务承载，但权限上独立成域：可以只授予库存而不给采购， 反之亦然。

• OAuth 凭证：重新走一次授权流程，勾选 inventory:read / inventory:write
• AppKey：授权范围创建时固定，需新建后切换、再吊销旧的

高危操作​

35 个写接口标记为高危，涵盖审批类（提交、确认、驳回、撤回、反审核）、 作废与删除、期初库存设置，以及推送财务（销售成本结转、收入确认单）。

经 MCP 调用这些接口须先向用户复述操作内容并获得明确同意，再携 confirm: true 重新调用。直连 POST /v1/api/invoke 的集成方不受此门限制，请自行确保调用前已获授权。

未纳入本批​

出入库单的附件绑定、导入导出任务、打印模板等辅助接口暂未开放； 库存锁定（inventory-lock）与待处理队列属内部机制，同样未开放。

开放接口​

全部经统一直通入口 POST /v1/api/invoke 按 apiCode 调用，不做路径镜像。 完整清单见开放接口清单，逐接口的请求/响应字段表见 接口参考。

财务、项目、办公等业务域尚未开放，按批次评估中。

MCP 端点​

端点 https://open.risemap.cn/v1/mcp（开发环境 open-dev.risemap.cn）， Streamable HTTP 无状态实现，协议版本 2025-06-18 / 2025-03-26。

只暴露 4 个元工具 —— list_domains、search_apis、describe_api、call_api —— 由 agent 按需检索具体接口，客户端上下文占用与接口总量解耦。接入只需填一个地址， 浏览器完成 OAuth 授权，无需接触密钥，详见客户端接入。

经 MCP 调用高危接口（删除、作废、审批等）须携 confirm: true，agent 应先向用户 复述将要执行的内容并获得明确同意。

⚠️ 审批流域需重新授权​

workflow 域是本批新增的范围词汇。在此之前完成授权的凭证不包含该域 —— 需要访问审批任务、流程实例与审批历史的调用方，请重新走一次授权流程并勾选 workflow:read / workflow:write，已有的令牌不会自动获得该范围。

AppKey 的授权范围在创建时固定、之后不可修改：需要该域的集成方请新建一个 勾选了 workflow 范围的 AppKey，切换完成后再吊销旧的，以免中断调用。

权限口径提醒​

开放平台的凭证绑定员工身份：能做的事等于「凭证授权范围 ∩ 绑定员工本人权限」。 凭证即便勾了 sales:write，绑定员工在主站没有相应销售模块的操作权限，调用仍会被拒 （92204）；能看到多少数据也与该员工在主站看到的一致。 详见认证与授权。

此时站点为占位大纲：开放平台后端于同日完成服务骨架，业务能力尚未实现， 各文档页正文待能力落地后按已验证的实现补写。

本栏目的用途​

本栏目记录开放平台的对外变更：

• 接口新增、变更与废弃
• 凭证与权限策略调整
• 限流配额规则变化
• MCP 工具集更新

对外契约的破坏性变更会在此提前公告。