MES订单出库到U8销售发货的同步策略实战教程
这个策略解决什么问题
在离散制造现场,MES 是"出货事实"的产生地,ERP(用友U8)是"财务和库存"的归集地。MES 上完成订单出库确认后,如果再让仓库人员手工去 U8 录入发货单,不仅慢,还容易出现"MES 出完了,U8 还没发货",导致销售订单无法关闭、库存账和财务账长期对不齐。
本策略的核心是:MES 端订单出库确认即触发,在 U8 自动生成一张关联到原销售订单号的发货单,做到"MES 出货即记账"。
数据流向与字段映射
整体链路是单向推送:MES(WebAPI) → 轻易云数据集成平台 → 用友U8(WebAPI)。
源端:MES 提供 common/search 查询接口(POST),分页拉取出库确认单,主键字段是 confrimNo(出库确认号),增量标识可使用 id 或更新时间戳。
目标端:U8 提供 XSFHDAdd 销售发货单新增接口(POST),写入时需要把 MES 的出库确认号、销售订单号、发货日期、物料行等映射进去。
关键字段对照(仅列实战中容易出错的几项):
| 业务含义 | MES 源字段 | U8 目标字段 | 说明 |
|---|---|---|---|
| 出库确认号 | confrimNo | cDLCode | 单据号,U8 要求唯一 |
| 销售订单号 | saleOrderNo | cSOCode | 必须与 U8 已存在的销售订单匹配,否则会被退回 |
| 发货日期 | createTime | dDate | 注意格式,通常 yyyy-MM-dd |
| 业务类型 | 固定值 | cBusType | 写"普通销售",避免 U8 走错模板 |
| 是否自动审核 | 固定值 | AutoAudit | 建议先 false,跑稳后改 true |
| 物料编码 | materialCode | cInvCode | 跨系统的"通用语言",编码映射集中管理是关键 |
| 数量 | qty | iQuantity | 注意 U8 的单位换算与基本/辅助单位 |
在轻易云上如何配置
我们用轻易云数据集成平台(Qeasy)承接这条策略,整体分三块:源端采集、目标端写入、字段映射与转换。
源端配置要点:
- 接口选
common/search,方法 POST,queryKey与wsId按 MES 租户实际值填入(写成变量,不要硬编码到生产环境)。 - 分页:
pageNum从 1 开始,pageSize建议 100,既能保证吞吐又不会因单次数据过大触发 MES 端超时。 - 增量策略:用 MES 的出库确认时间作为增量游标,轻易云的"调度增量起点"会自动记忆上一次成功调度的截止时间,首次跑全量,后续只推新增/变更。
目标端配置要点:
- 接口选
XSFHDAdd,方法 POST,AddType=1(新增发货单)。 - 关键占位符:
cDLCode取{{confrimNo}},cSOCode取源端销售订单号字段,dDate取{{createTime}}。 - 自动审核:
AutoAudit初期建议设为false,等数据稳了再打开——这是踩坑最多的一处,很多客户一上来就开启自动审核,结果单据错了连带库存也错了,排查很费劲。
字段映射与转换:
- 编码映射(物料、客户、仓库)放在轻易云"编码映射"模块集中维护,不要在脚本里写死,后期 MES 或 U8 任一边改了编码,一处即可生效。
- 表头与表体分阶段处理:第一阶段只推表头(单据号、订单号、日期),确认无误后再开表体行项目,这是轻易云客户常用的"稳妥打法"。
实施步骤
第一步:全量初始化(一次性)
- 在轻易云上手动触发一次全量,跑历史出库确认单;这一轮建议关闭自动审核,把生成的 U8 发货单作为"影子数据"对账,确认金额、数量、订单号都对得上,再进入增量。
- 全量调度频率设为"手动触发"即可,不需要配 crontab。
第二步:增量起点设定
- 把增量游标切到全量截止时间点,例如
2026-01-15 23:59:59之后的第一条出库确认记录。 - 这一步千万不要跳过,否则全量和增量会重复推送,U8 会因单据号重复报错。
第三步:日常调度
- 源端轮询建议
*/9 7-22 * * *(每 9 分钟一次,工作时间段),目标端错开几分钟,如2-59/9 7-22 * * *,避免源端还没拉完数据目标端就开始写。 - 非工作时段可不调度,避免夜间误操作触发审核。
第四步:监控与对账
- 在轻易云上配置"源端拉取数 = 目标端成功写入数"的对账看板,差异 > 0 立刻告警。
- 每周抽 5~10 单到 U8 端手工核对库存和发货单状态。
踩坑复盘
- 销售订单号没匹配上,整批被退回:U8 的发货单必须关联到一张已存在且未关闭的销售订单,如果 MES 端的订单号在 U8 里压根不存在,
XSFHDAdd会直接报错。稳妥做法是先在轻易云加一道前置校验脚本,查 U8 的销售订单列表确认订单号存在再推送。 - 单据号重复导致重复发货:MES 出库确认号理论上唯一,但跨日重跑或手工补单时容易撞号。建议把
cDLCode加上 MES 端的租户/工厂前缀,例如{工厂编码}-{confrimNo},从根本上规避冲突。 - 单位换算被忽略:MES 用"件",U8 用"箱"或者有基本/辅助单位之分,数量直接传过去经常出现"数量异常"。这一项必须在映射阶段就处理好,而不是出问题后去 U8 改单。
- 自动审核开太早:很多客户图省事一上来就
AutoAudit=true,结果上游数据有问题时,U8 单据已经审核并更新了库存,后续修正成本极高。 - 跨天时区与日期边界:MES 的
createTime是带时间的,而 U8 的dDate通常只取日期;调度又在凌晨横跨零点时,容易把第二天的单据误算成前一天。建议在轻易云的字段转换里强制把日期截断到 yyyy-MM-dd。
适用场景与不适用场景
适用:MES 出库确认是出货唯一事实源、U8 已存在对应销售订单、追求"出货即记账"的离散制造企业;以及需要把 MES 与 ERP 库存账对齐的供应链一体化项目。
不适用:U8 中尚未生成销售订单、需要先开票后发货的贸易型业务;以及 MES 出库数据需要人工二次复核、暂不允许自动推送到财务的场景——这类建议走人工确认后再触发的半自动模式。