跳到主要内容

批量导入、批量删除与新开放接口

Avery
Risemap 开放平台

开放平台新增 JSON 行批量导入(import-rows + import-result)与一批 batch-delete 批量删除接口, 并发布批量操作指南。写接口超时新增 92205「结果未知」, 防重复提交的说明按实际行为订正。

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

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

接口编码作用
<服务>.data-task-center.import-rows以 JSON 行提交导入任务,与主站 Excel 导入共用同一条任务链路与业务校验
<服务>.data-task-center.import-result轮询导入任务状态与行级错误(含调用方提交的 rowKey)
  • 单次请求 ≤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。写接口的参考页新增「必填字段」一节, 汇总参数说明与接口规格中标注的必填项,调用前可先对照。

服务参考页分类本次启用部署后启用
comap-sales销售20734
comap-office行政22784
comap-finance财务206
comap-srm供应链 5、生产 162
comap-project项目32

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

销售​

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

行政(office)​

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

财务、供应链与项目​

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

部署后启用的接口​

以下三类接口已登记,暂不启用:

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

本批下线​

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