蓝鲸&Epicor API 标准化数据同步
技术白皮书 V3.2（2023-10-14）· 12 项同步/回写接口持续演进 · 标准化对接架构
白皮书定位
《蓝鲸&Epicor API 标准化技术白皮书》由蓝鲸软件开发部维护（作者：陈海峰），自 2022 年 3 月 V1.0 发布以来持续演进至 V3.2，沉淀了多个 Epicor 客户项目中的同步与回写接口：通讯协议、访问授权、请求参数、调用流程与联调测试方式全部标准化，新项目按规范快速接入。
对接与联调
蓝鲸标准化对接架构：Epicor ERP 端与蓝鲸 MES 端各自提供明确的调用流程；联调分 EpicorERP 端与蓝鲸 MES 端两侧验证，接口错误以 BW 错误代码标准化返回，配套 32 条错误代码解决方法指引，降低联调成本。
接口清单
按版本演进沉淀的 12 项标准化接口
① Epicor → 蓝鲸 MES 同步
Epicor ERP 同步蓝鲸 MES：工单、订单、物料、工艺等基础与单据数据同步（V1.0 起持续优化）。
② MES 报工回写
MES 报工接口回写 Epicor（V2.0，2022-06-29 发布）：车间报工经审核后写入 Epicor 报数记录。
③ 成品挂单回写包装
MES 成品挂单回写 Epicor 订单包装资料（V2.1）；成品挂单标签回写 Epicor 销售订单包装资料（V2.9）。
④ 收货输入同步
Epicor 收货输入同步 MES 采购进货单（V2.2，2023-02-02）：采购收货数据双向一致。
⑤ 成品入库回写工单收货
MES 成品入库回写 Epicor 工单收货至工单（V2.5，2023-02-07），对应 ReceiptsFromMfg 逻辑。
⑥ 发料回写库存转移
MES 工单发料回写 Epicor Inventory Transfer（V2.8，2023-02-10），材料出库实时过账。
⑦ 出货审核回写
销售订单审核回写 Epicor 客户出货输入为已出货（V3.0，2023-02-18），出货状态闭环。
⑧ 库存调拨回写
MES 库存调拨单回写 Epicor 库位转移（V3.1，2023-02-22），库位级库存保持一致。
⑨ 库存实时同步
Epicor 库存实时同步至蓝鲸库存（V3.2，2023-10-14），库存查询以 ERP 为准绳。
⑩ Epicor BO 直接调用
ReceiptsFromMfg.dll（工单收货至库存）、CustShip.dll（客户出货）、TransOrderShip.dll（转移出货）、TransOrderReceipt.dll（关联公司接收）。
⑪ 数据变化表同步
系统外数据变化表（t_synctabledatetime + 触发表）不影响 Epicor 运作，支持重同步与追溯。
⑫ 标准错误代码
BW101~BW602 错误代码体系：登录限制、工单/物料/工艺、出货、库存各类问题均有解决方法指引。
版本演进
持续迭代的接口体系（节选）
2022.03.25
蓝鲸 API 第一版发布
2022.05.31
回写/同步细节优化
2022.06.29
MES 报工回写
2022.12.20
成品挂单回写包装
2023.02.02
收货输入同步
2023.02.07
成品入库回写
2023.02.10
发料回写库存转移
2023.02.15
挂单标签回写
2023.02.18
出货审核回写
2023.02.22
调拨回写库位转移
2023.10.14
库存实时同步
标准错误代码（节选）
联调与运行问题的标准化指引
BW101 登录限制
Epicor 登录用户数已达最大限制，退出重登或等待释放。
BW2xx 工单类
工单校验（BW201~BW224）：订单单号/品号一致性、仓库编号、工序应出良品数、订单号 10 位上限、联合物料拼数与并发模式、资源组 TCC 资源、单位小数限制、按顺序审核回写等。
BW3xx/4xx 工艺物料
BW301 Epicor 工艺资源群组编号不能超过 8 位；BW401 物料 UOM 类别已占用；BW402 批次追踪与自动扣料二选一；BW403 已使用物料不允许删除。
BW5xx/6xx 出货库存
BW501 出货数量不允许为 0；BW502 无取消已出货权限；BW601 库位转移库存不足；BW602 找不到有效工单（检查工单完结与发放勾选）。
标准协议 | 12 项接口 | BO 直调 | 错误代码指引
—— 让每一次对接，都站在已验证的白皮书之上 ——