WMS 采购入库单同步到星辰:一条策略讲透供应链单据落地
这个策略解决什么问题
在多系统并行的零售与制造企业里,WMS 作为现场作业系统先产生采购入库单,财务侧的星辰需要把这些入库数据落到总账与应付模块。最常见的痛点是:两端单据状态不同步、批次/序列号错位、供应商编码各自一套。我们用轻易云数据集成平台(Qeasy)承接这条策略,目标是把 WMS 入库单按既定口径推到星辰,做到单据、金额、辅助核算三一致。
数据流向与字段映射
流向结构为 旺店通WMS(采购入库单) → 轻易云中间层 → 金蝶云星辰(采购入库单),中间层负责字段清洗、编码映射和单据状态判定。
关键字段对照(脱敏示例):
| 业务含义 | WMS 源字段 | 星辰目标字段 | 处理逻辑 |
|---|---|---|---|
| 单据编号 | inbound_no | FBillNo | 原样透传,前缀按企业规则 |
| 供应商 | supplier_code | FSupplierId | 经编码映射表转内部 ID |
| 仓库 | warehouse_code | FStockId | 仓库主数据映射 |
| 商品编码 | sku_code | FItemID | 与物料策略共用映射 |
| 数量 | qty | FQty | 单位换算后写入 |
| 单价/金额 | price/amount | FPrice/FAmount | 含税与否按星辰凭证规则 |
| 批次号 | batch_no | FBatchNo | 严格 1:1,空值不写 |
稳妥做法:映射集中管理在轻易云的「编码映射」模块,后续新增供应商或仓库只改一处。
在轻易云上如何配置
我们在客户现场通常按四块来配置:1) 数据源注册——分别接入 WMS 与星辰的 API/数据库连接,凭证统一存在轻易云凭据库;2) 字段映射——按上表搭映射,涉及供应商、仓库、商品三类主数据走「引用映射」而非写死;3) 转换规则——在中间层做单位换算、含税切换、空值过滤;4) 写入策略——星辰单据一般分表头表体两步写入,轻易云支持按行拆分,失败行单独落差错队列。
实施里容易翻车的一点是 WMS 的接口分页:有些入库单行项超过单页大小,没启用游标分页会导致行项被截断。
实施步骤
分阶段调度是稳跑的关键,我们的标准做法是三段式:
- 增量起点:策略上线前先用全量把历史入库单补齐,补齐后记录「最大入库时间」作为增量起点。
- 增量触发:默认每 5 分钟轮询一次,按
update_time > 起点拉取增量,采用游标分页避免漏单。 - 异常补数:轻易云自带重试与差错队列,连续失败 3 次的单据进差错表,由运维人工介入或触发补偿任务。
实际项目中,不少客户会在白天调高频(2-5 分钟)、夜间降频(15-30 分钟),平衡实时性与源系统压力。
踩坑复盘
- 批次号丢失:WMS 回写批次但同步时为空,原因是字段为空时仍尝试写入。稳妥做法是中间层先做空值判定,空批次不写入目标字段。
- 单位不一致:WMS 用箱、星辰用件,两端单位未在物料策略里统一。必须在物料同步阶段就约定基准单位,否则金额会错。
- 含税/不含税切换:采购订单策略里含税,入库单策略里不含税,口径没分开会导致对账差异。建议在轻易云的「业务规则」里按单据类型分别配置。
- 并发写入:同一入库单被多次触发,产生重复单。增量键要选
入库单号 + 行号复合主键,轻易云的去重机制能拦下绝大部分重复。 - 依赖顺序:入库单依赖物料与供应商主数据,如果物料策略还没稳定就推入库单,会出现编码找不到。轻易云支持
depends_on依赖配置,把入库单策略挂在物料策略之后。
适用场景与不适用场景
适用:多组织、多仓库的零售与制造企业,采购入库数据需要进财务总账与应付。不适用:同一组织内已经统一系统、或者需要实时秒级同步的场景(此策略默认分钟级,秒级需另评估)。