定制软件对接 ERP、CRM、OA 时,接口和数据归属怎么定

跨系统开发能否顺利推进,先看客户、订单、审批等对象由谁维护,接口能否读取或写入,以及失败后由谁处理。先用责任矩阵确定权威来源和动作边界,再核对字段、权限、回写状态与异常路径;这些条件不清时,不宜直接承诺系统联通。

阅读目录6 个章节

先判断哪些对接能做,哪些要暂缓

不要先问“能不能接 ERP”,先选一项真实业务动作,例如销售在新系统发起订单、主管在 OA 审批、财务在 ERP 查看最终单据。沿着这一笔记录,列出要查询、创建、修改和回写的对象。每个动作都要找到原系统的接口、账号权限和负责确认的人。

若目标系统有可用的接口或正式交换机制,数据归属与授权明确,并能准备测试环境和样例记录,就可以进入联调设计。若只能看到页面、拿不到接口文档或账号,或者几方都认为对方会维护同一字段,应先做系统调研;此时最多能评估方案,不能把“完成双向同步”写成确定交付范围。只读展示和向原系统写入业务记录,风险与验收方法也不同。

还要区分“业务对象归属”和“字段来源”。客户基本资料可能由 CRM 维护,信用状态由 ERP 提供;不能因页面上同处一张表,就在新系统里给这两个字段设置同样的编辑权。项目准备阶段可先按软件需求文档清单记录角色、字段和业务流程。

用责任矩阵确定数据由谁维护

假设一家企业用 CRM 维护客户、ERP 维护订单、OA 处理审批,另建一个业务工作台供人员查看与发起操作。下表只演示如何填写责任矩阵;实际项目应由各系统负责人逐行确认,尤其要确认同名字段是否同义。

左右滚动表格,查看完整责任分工。

业务对象权威来源工作台允许的动作回写与失败处理确认人
客户档案CRM 的客户编号与档案按授权查询;修改时跳转或提交 CRM 接口更新失败保留原值,不在工作台生成第二份客户主档销售业务负责人、CRM 负责人
订单ERP 的订单号与最终状态发起订单草稿,取得 ERP 返回的订单号后展示超时先查原单是否已创建,再决定是否重试订单业务负责人、ERP 负责人
审批任务OA 的流程实例与审批结论发起或跳转审批;只展示 OA 返回的处理状态回调未到时显示待确认,不能自行标为已通过审批业务负责人、OA 负责人
跨系统关联各系统原始编号及工作台关联表按权限查看客户、订单、审批之间的对应关系编号无法匹配时进入待核对列表,不自动合并数据负责人、集成开发负责人

每一行最好再补“查看范围、变更审批、保留期限”,但不要把矩阵当成技术实现图。它首先回答的是:哪一套系统的结果算数,谁有权改,冲突时找谁。

把接口约定写到能联调

确定业务边界后,逐个接口记录调用方向、触发时机、请求与响应字段、原系统主键、业务幂等标识、枚举值、时间与金额口径、鉴权方式,以及“成功、拒绝、超时、结果未知”各返回什么。查询接口还要约定分页与数据更新时点;写入接口要明确重复提交、撤销和版本变更的处理方法。

接口文档不应只有一张字段列表。准备一条可在测试环境复现的样例记录,把客户编号、订单号和 OA 流程实例编号逐项串起来,再写清字段缺失、权限不足和目标系统不可用时的响应。若接口用 HTTP 描述,可参考 OpenAPI 规范组织操作、参数与响应;授权仍要由服务端逐次校验,可对照 OWASP 授权建议检查,而不是只靠页面隐藏按钮。

有些原系统仅提供定时导出或人工审批,不具备实时回写能力。这可以是可行的分期方案,但页面必须标清更新时间和处理状态,不能把批量交换包装成实时同步。

用一笔业务记录走完整链路

联调先从只读核对开始,再做写入和状态回传。按下面的顺序执行,每一步都保留记录编号与结果,避免到最后只凭页面截图判断成功。

  1. 查来源:在 CRM、ERP、OA 各找一条授权的测试记录,核对编号、字段含义与时间口径。
  2. 查映射:在工作台查看同一对象,确认字段来自约定的系统,没有把名称相近但含义不同的字段拼在一起。
  3. 做动作:由有权限的角色发起一次约定操作,保存请求标识、原系统返回编号和页面状态。
  4. 看回传:在原系统核对记录是否真实产生,再核对工作台显示是否随回调或查询更新。
  5. 重放异常:分别模拟超时、重复请求、无权限和找不到关联编号,确认记录没有被错误覆盖或重复创建。

若要从数据大屏或业务看板跳入处理流程,可再参考异常下钻与工单回写的边界;那里讨论的是特定异常路径,本篇矩阵用于更一般的跨系统对象协作。

把失败状态和处理责任说清

跨系统流程最容易在“接口报错了,但页面显示成功”时失去可信度。超时不等于失败,成功响应也不一定等于整个业务流程完成。提交后的页面至少要区分已受理、处理中、已完成、明确失败和结果待核对,并给出可追查的记录号。

  • 重复提交:先按业务标识查询原系统结果;不能在结果未知时无条件再次创建订单。
  • 数据冲突:保留来源值与更新时间,交由约定的数据负责人判断;不要把最新到达的值默认当作权威值。
  • 权限拒绝:停止写入并提示可处理路径;不要为了“跑通流程”绕过原系统授权。
  • 回调缺失:用受控查询或人工核对恢复状态,记录谁负责排查、何时升级处理。

这些状态应写进接口契约、界面说明和运维交接清单中。否则上线后业务人员只能截图报错,开发人员又无法确定是哪一系统、哪一笔记录出了问题。

最后按什么边界验收

验收时要能回答五个问题:约定对象是否来自权威系统;每种角色能否只做被授权的操作;写入后能否在原系统找到同一记录;超时或失败能否恢复到可核对状态;字段映射、账号、接口版本和异常处理人是否已交接。若其中任一项只在演示环境口头说明,不能视为完成生产对接。

验收范围要按“只读查询、单向写入、双向状态回传、历史数据迁移”逐项列明。做到前两项不等于后两项也已交付。业务部门可结合用户验收测试方法设计跨系统用例;技术移交可对照源码与接口交接清单核对后续维护条件。