BarTender 对接 ERP/MES 系统集成方案详解
很多工厂上了 ERP、MES、WMS 之后，发现打印这一环还是靠人——操作员跑到电脑前选模板、填数据、点打印。不仅慢，还容易出错。
理想状态是：打印跟着业务事件走，而不是跟人走。ERP 过账了自动打箱贴，MES 报工了自动打流转卡，WMS 出库了自动打物流标签。
这篇文章拆解 BarTender 和业务系统对接的三种方式，以及实施时最容易踩的坑。
先看能力总览：BarTender 集成与管控能力。
一、三种集成方式，选哪个？
BarTender 提供三种主流的系统集成方式，复杂度和灵活性从低到高排列：
| 方式 | 原理 | 复杂度 | 适合场景 |
|---|---|---|---|
| 文件触发 | 业务系统生成 XML/CSV 文件放到监控目录，BarTender 检测到后自动打印 | 低 | 没有开放接口的老系统 |
| 数据库监听 | BarTender 轮询数据库表，发现新记录就触发打印 | 中 | 有数据库访问权限的系统 |
| REST API | 业务系统直接调用 BarTender 的 API，传参数、触打印 | 高 | 新系统、需要实时响应的场景 |
二、方式 1：文件触发（最简单）
工作原理
业务系统（比如 ERP）在某个事件发生时（比如出库单审核通过），自动生成一个 XML 或 CSV 文件，放到 BarTender 监控的目录里。BarTender 检测到新文件，读取里面的数据，套上对应的模板，自动打印。
优点
- 实施简单，不需要改业务系统代码
- 两边解耦——ERP 不用管打印的事
- 老系统也能用
缺点
- 有延迟——不是实时的
- 文件格式要两边约定好
- 出错了排查麻烦
适合谁
不想改 ERP 代码，能接受几秒延迟的场景。
三、方式 2：数据库监听（最常用）
工作原理
BarTender 直接连到业务系统的数据库表。每次有新记录插入（比如新的出库单），BarTender 就检测到，自动把这条记录的数据套到模板上，触发打印。
这个功能是通过 Integration Builder 实现的。
优点
- 比文件触发更实时
- 数据一致性好——直接读数据库，不会文件丢失
- 可以做复杂的过滤和条件判断
缺点
- 需要数据库访问权限
- 要和业务系统约定好表结构和字段
- 业务系统改表结构了，集成也要跟着改
适合谁
有数据库访问权限，希望比较实时的打印触发。这是大多数中型工厂的选择。
四、方式 3：REST API（最灵活）
工作原理
BarTender 提供 REST API 接口。业务系统在需要打印的时候，直接调用 API，把打印参数（模板名、数据、打印机）传过去，BarTender 就执行打印。
优点
- 实时性最好
- 灵活性最高——想什么时候打就什么时候打
- 可以做复杂的业务逻辑判断
缺点
- 需要开发量——业务系统这边要写调用代码
- 对开发能力要求高
- 需要做接口测试和异常处理
适合谁
有开发能力，希望打印完全嵌入业务流程的企业。新上的 MES/WMS 系统通常推荐这种方式。
五、集成实施时最容易踩的五个坑
坑 1：触发点没定清楚
ERP 里出库单有好几个状态：创建、审核、出库、完成。到底哪个状态触发打印？很多项目扯皮就是因为这个没说清楚。
建议：项目启动前就把触发点、去重键、补打规则写进需求文档。详见：ERP 和打印系统的责任边界怎么定。
坑 2：去重键没设计
同一张单据，可能因为网络重试被打印两次。没有去重键，就会出现重复打印。
建议：用单据号 + 行号作为唯一键，已经打印过的就不重复打。
坑 3：补打流程没考虑
标签打坏了要补打。补打时是按原记录重打，还是用新数据？流水号要不要重置？
建议：补打必须按原打印记录执行，保证数据和原始打印一致。这是 GMP 标签管理系统的核心功能之一。详见：GMP 标签管理系统。
坑 4：打印机离线了怎么办
打印队列堆积，打印机突然断网——消息就丢了。
建议：Automation 版有打印队列和故障转移机制，打印机恢复后会继续打。不要用 Professional 版做无人值守的生产打印。
坑 5：主数据不一致
ERP 里的产品名称和 BarTender 模板里的不一样，打出来的标签就是错的。
建议：打印系统只读 ERP 的数据视图，不维护自己的主数据。主数据和事务数据的边界一定要划清楚。
六、需要 Automation 还是 Enterprise？
做系统集成，至少需要 Automation 版——只有这个版本才有 Integration Builder 和 API。
但如果你的场景是：
- 多工厂统一管理
- 需要审批流程
- 需要打印记录审计
那就直接上 Enterprise 版。
详细的版本区别可以看：BarTender 版本与许可总览。
七、相关阅读
需要系统集成方案？
我们的技术开发团队做过 200+ 个 BarTender 实施项目，熟悉和主流 ERP（SAP、用友、金蝶）、MES、WMS 的对接。可以根据你的系统现状和业务流程，出一套可落地的集成方案。