批量导入、批量删除与新开放接口
开放平台新增 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 | 销售 | 207 | 34 |
| comap-office | 行政 | 227 | 84 |
| comap-finance | 财务 | 20 | 6 |
| comap-srm | 供应链 5、生产 1 | 6 | 2 |
| comap-project | 项目 | 3 | 2 |
「本次启用」的接口已在接口参考中列出;「部署后启用」的接口暂未启用,调用返回 92201。
其中 96 个已于 2026-09-30 随后端发布启用(其余审批、反审核等仍不开放),见售后服务模块开放,批量导入与批量删除上线。
销售
- 客户经营:跟进记录、拜访计划、公海客户(领取、分配、释放、归档)、客户收货地址、客户授信
- 价格体系:客户价格表、客户物料对照、框架协议、价格组、价格调整、特价申请、物料售价查询
- 投标与商务:投标项目、投标任务、商务函件
- 费用与收款:附加费用、其他收入、商誉订单、销售收款流水分配
- 目标与分析:销售目标、销售团队、销售业绩、销售报表
- 业务设置:客户分类、客户级别、联系人决策权重、客户标签、跟进结果、线索意向等级、商机输单原因
行政(office)
人事与办公域此前仅开放通讯录,本批开放行政办公能力:待办、会议与会议室、文档与材料库、 规章制度与员工手册、工作汇报、资质证书、政策申报、用印、用车、设备与维保工单、固定资产、 物品借用、办公物料、礼品、酒水库存;考勤记录与统计、请假、加班、出差仅开放查询。 薪资、绩效、员工档案、入离职与招聘仍不开放。
财务、供应链与项目
- 财务:订单优惠申请、合并付款查询、待确认存货成本、发票税率差异留痕,以及借款与银行借款的删除
- 供应链:单据完结记录查询、供应商物料历史采购价批量查询;委外表单元数据查询
- 项目:单据完结记录查询
部署后启用的接口
以下三类接口已登记,暂不启用:
- 服务端必填校验待部署:新建 / 编辑类写接口(如跟进记录与拜访计划编辑、框架协议、附加费用、 行政各台账与申请的新建编辑、单据手动完结 / 重开)。后端补齐必填校验的版本上线后再启用, 避免经接口写入缺字段的数据。
- 审批与反审核:授信申请的审批通过 / 驳回,以及各单据的反审核,不向 AI 开放。
- 个人信息与数据范围:涉及人员清单、他人请假明细等个人信息,或数据权限边界待确认的接口,核实后再开放。
本批下线
以下 9 个接口不在本次快照中:质检的产品保修调整与保修配置(4 个)、委外发料签收、 项目预算的列表 / 汇总 / 更新与预算执行分析(4 个)。