轻易云
注册体验

MES订单出库到U8销售发货的同步策略实战教程

· 许创贵· 集成方案库· 12 次浏览· 约 5 分钟读完

这个策略解决什么问题

在离散制造现场,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 目标字段说明
出库确认号confrimNocDLCode单据号,U8 要求唯一
销售订单号saleOrderNocSOCode必须与 U8 已存在的销售订单匹配,否则会被退回
发货日期createTimedDate注意格式,通常 yyyy-MM-dd
业务类型固定值cBusType写"普通销售",避免 U8 走错模板
是否自动审核固定值AutoAudit建议先 false,跑稳后改 true
物料编码materialCodecInvCode跨系统的"通用语言",编码映射集中管理是关键
数量qtyiQuantity注意 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 端手工核对库存和发货单状态。

踩坑复盘

  1. 销售订单号没匹配上,整批被退回:U8 的发货单必须关联到一张已存在且未关闭的销售订单,如果 MES 端的订单号在 U8 里压根不存在,XSFHDAdd 会直接报错。稳妥做法是先在轻易云加一道前置校验脚本,查 U8 的销售订单列表确认订单号存在再推送。
  2. 单据号重复导致重复发货:MES 出库确认号理论上唯一,但跨日重跑或手工补单时容易撞号。建议把 cDLCode 加上 MES 端的租户/工厂前缀,例如 {工厂编码}-{confrimNo},从根本上规避冲突。
  3. 单位换算被忽略:MES 用"件",U8 用"箱"或者有基本/辅助单位之分,数量直接传过去经常出现"数量异常"。这一项必须在映射阶段就处理好,而不是出问题后去 U8 改单。
  4. 自动审核开太早:很多客户图省事一上来就 AutoAudit=true,结果上游数据有问题时,U8 单据已经审核并更新了库存,后续修正成本极高。
  5. 跨天时区与日期边界:MES 的 createTime 是带时间的,而 U8 的 dDate 通常只取日期;调度又在凌晨横跨零点时,容易把第二天的单据误算成前一天。建议在轻易云的字段转换里强制把日期截断到 yyyy-MM-dd。

适用场景与不适用场景

适用:MES 出库确认是出货唯一事实源、U8 已存在对应销售订单、追求"出货即记账"的离散制造企业;以及需要把 MES 与 ERP 库存账对齐的供应链一体化项目。

不适用:U8 中尚未生成销售订单、需要先开票后发货的贸易型业务;以及 MES 出库数据需要人工二次复核、暂不允许自动推送到财务的场景——这类建议走人工确认后再触发的半自动模式。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-mes-web-u8-0201-mes-u8-d57b2951

评论