金蝶其他入库单到旺店通委外入库单的同步实战:基于轻易云的单一策略落地
这个策略解决什么问题
在一次委外加工的业务里,某制造企业每天有几十张「其他入库单」在金蝶云星空生成,需要把这些单据按委外仓口径推到旺店通,变成「委外入库单」。两边系统不直接对话,财务和仓管每天手工对账,出错率高、回流慢。这条策略的目标,就是把这条单据链路由间歇手工变成自动化、可追溯的定时同步。
数据流向与字段映射
整体流向是:金蝶云星空(B 端)→ 轻易云中间层 → 旺店通(A 端,委外入库单,3000 云仓)。
我们通常在中间层维护一张映射对照,集中管理编码与表头表体的差异。下面是实际项目里最常需要确认的关键字段:
| 维度 | 源(金蝶其他入库单) | 中间层处理 | 目标(旺店通委外入库单) |
|---|---|---|---|
| 单据编号 | FBillNo | 原值透传 | outer_no(外部单号) |
| 单据日期 | FDate | yyyy-MM-dd 标准化 | order_time |
| 仓库编码 | FStockId.FNumber | 仓库映射表 | warehouse_no(委外仓) |
| 供应商/委外商 | FSupplierId.FNumber | 编码映射集中管理 | customer_no |
| 商品编码 | FMaterialId.FNumber | 码表对照 | goods_no |
| 数量 | FQty | 单位换算 | num |
| 备注 | FNote | 截断清洗 | remark |
这里要注意,委外入库单在旺店通侧通常需要带「委外仓标识」,编码映射集中管理是我们和客户一起定的铁律,后期换供应商或加仓,改一处即可,避免代码硬编码带来的扩散风险。
在轻易云上如何配置
整条策略在轻易云数据集成平台(Qeasy)里通常拆成三个对象:源取数、转换、目标写入。
源端:用金蝶云星空的查询接口拉「其他入库单」,按修改时间增量过滤,这是稳妥的增量起点。
转换层:在轻易云的转换画布里做几件事:
- 编码映射:供应商、商品、仓库走统一映射表,集中维护。
- 表头表体分阶段:先落表头,再按内码关联子表体,避免一次性写入漏行。
- 单据状态控制:已审核单据才允许推,过滤掉草稿态。
目标端:写旺店通委外入库单接口,注意目标系统的「仓库类型」字段必须传委外仓编码,否则会被默认当成普通入库,这是典型翻车点。
另外,轻易云平台对失败单据会进异常队列,我们在客户现场一般会配一条「失败重试 + 邮件告警」的兜底通道。
实施步骤
我们通常建议分三步上线:
第一步,增量起点。把金蝶云星空里近 N 天已审核的其他入库单,按 FDate + FBillNo 升序拉取,先做一轮回灌,验证两边数据是否对得上。这一步不调度,人工触发即可。
第二步,全量触发。第一次上线时,用全量回灌把历史单据补齐,轻易云的全量任务会带分页与断点续跑,避免漏单。
第三步,常态调度。转入增量与全量双轨模式:
- 增量:每 10-15 分钟跑一次,按 FModifyDate 过滤。
- 全量:每天凌晨低峰跑一次对账校验,差异进差异表。
这样日常跑增量,夜里跑全量兜底,是轻易云客户常见的应对模式之一。
踩坑复盘
-
仓库类型被默认成普通仓。委外入库单必须显式传委外仓编码,不然下游仓储作业会跑错仓位,这是最容易翻车的地方。
-
表头表体写入顺序错位。一次写入时,如果先提交表体再补表头,会出现孤儿子记录。稳妥的做法是表头表体分阶段落库,中间层先写头,再写行。
-
增量起点选错字段。有人用单据日期做增量,但单据日期不变,修改日期才动,导致漏单。我们一直用 FModifyDate 做增量过滤基线。
-
编码映射散落在脚本里。新增供应商时改十几处脚本,非常痛。统一收到映射表后,改动从十几处降到一处。
-
审核状态没卡住。源端还有草稿态单据,推过去后目标端报字段非空。稳妥做法是在转换层加「单据状态 = 已审核」的过滤。
适用场景与不适用场景
适用:金蝶云星空与旺店通委外仓场景明确、编码相对稳定、双方系统都有开放接口的制造或分销企业。不适用:跨法人主体、需要二次成本核算、或者双方编码规则经常重构的项目,这条策略需要先做编码治理再谈自动化。