三种集成方式
| 方式 | 读 | 写 | 适合 |
|---|---|---|---|
| 直写数据库 | 直接 SQL 查询 | 直接 INSERT / UPDATE 业务表 | 只读报表可以；写入不建议 |
| 中间表 + ERP 侧导入 | 查询或同步 | 外部系统写中间表，ERP 侧程序或人工导入 | 批量、低实时性的数据交换 |
| 调用 ERP 原程序 / 原厂接口 | 只读查询 | 调用易飞原保存、检查、审核程序，或鼎捷官方 WebAPI 方案 | 现场实时写单、需要与人工录单完全一致的场景 |
鼎捷也提供官方的 WebAPI 类解决方案，可以向原厂或代理商咨询适用版本与费用。无论用哪种「调用原程序」的方式，外层的可靠性设计（幂等、任务、核对）都需要自己做好。
直写数据库的 6 个风险
- 单号与取号：绕过易飞取号规则，容易出现单号重复或跳号，与单别编码方式不一致。
- 校验被绕过：超量、工序顺序、权限、关账日期等检查都在原程序里，直写不会触发。
- 关联数据遗漏：一张单据往往牵动多张表，例如工艺入库审核时 ERP 会自动生成关联的生产入库；直写很容易只写了一半。
- 库存与在制不更新：库存流水、工单完工量、工序在制量由审核逻辑维护，直写后账实不符。
- 审核码伪造：直接改审核码等于跳过审核，取消审核时也无法正确回滚。
- 升级即失效：ERP 版本升级后字段或逻辑变化，直写程序不会报错，只会悄悄写错。
可靠写入接口的 8 项能力
| 能力 | 说明 |
|---|---|
| 只读查询 + 原程序写入 | 业务表只读；所有写入交给 ERP 原组件事务 |
| 幂等 | 同一笔提交重复发送只生效一次，不会重复建单 |
| 异步持久任务 | 先记录再处理，返回受理编号；断网、关页面、重启都不丢 |
| 串行执行 | ERP 原程序一次处理一笔，避免并发冲突 |
| 结果回读核对 | 执行后回读单据与数量，以 ERP 实际结果为准 |
| 待核对恢复 | 结果不确定时不自动宣布成功、也不盲目重提，由人工依据 ERP 结案 |
| 权限映射 | 调用人映射到 ERP 用户，执行前重读权限，失败不放行 |
| 审计与版本校验 | 记录谁、何时、执行了什么；ERP 升级后先验证、再上线 |
维钉云是怎么做的
易飞 ERP 开放接口是维钉云平台的底座，部署在客户内网。业务数据只读，不修改 ERP 表结构；单据写入交由易飞原程序完成取号、保存、检查、审核、取消审核和作废。
目前已开放的业务包括工单与工序查询、扫码解析、移转报工、工艺入库、工单委外进货与退货（普通场景）、生产报表。新增单据按「确认原生单据 → 适配 → 幂等与权限测试 → 真实样本验收」的顺序逐项开放。
常见问题
只做报表，可以直接查易飞数据库吗？
可以。只读查询对 ERP 没有写入风险，但要注意用参数化查询、控制查询范围和频率，避免影响 ERP 性能；字段口径最好与易飞原程序保持一致。
已经有直写数据库的程序在跑，怎么办？
先梳理它写了哪些表和字段，用易飞原程序录同样的单据做对比，确认差异；高风险的写入建议逐步替换为调用原程序的方式。