其他入库单同步实战:从旺店通到金蝶云星辰的单一策略落地教程
这个策略解决什么问题
在零售业务里,"其他入库"(调整入库、初始化、损益补录等非采购/非生产类入库单)长期是个灰色地带:电商 OMS 一边出库,ERP 一边又要补一笔库存进来。两边如果各录各的,3 个月后库存账对不上,盘点时差异上百万。
我们用轻易云数据集成平台(Qeasy)做承接,把旺店通·企业奇门的其他入库单按增量方式自动推到金蝶云星辰 V2,目标端直接审核,避免人工二次录入。常见应对模式有两种:一是把物料、仓库等编码映射放在轻易云里集中管理;二是表头/表体分阶段上线,先跑通表头再加明细。
数据流向与字段映射
数据流向:旺店通·企业奇门 → 轻易云中间层 → 金蝶云星辰 V2。源端接口 wdt.stockin.order.query,目标端接口 /jdy/v2/scm/inv_other_in。
关键字段对照:
| 维度 | 源端(旺店通) | 目标端(金蝶云星辰) | 说明 |
|---|---|---|---|
| 主键 | stockin_id | id | 系统内部唯一标识 |
| 业务键 | order_no(RK 开头) | bill_no | 单据编码,目标端唯一 |
| 单据日期 | stockin_time | bill_date | 直接取值 |
| 业务类型 | order_type=6 | trans_type_id=12 | 常量映射 |
| 操作类型 | - | operation_key=audit | 创建即审核 |
| 明细数组 | details_list | material_entity | 数组整体引用 |
明细行核心映射:goods_no → material_number、num → qty、price → price、total_amount → amount,批次与有效期按需启用。
在轻易云上如何配置
在轻易云数据集成平台里,典型配置分四块:
- 源端连接器:选旺店通·企业奇门,API 选
wdt.stockin.order.query,Method=POST,Type=QUERY。请求参数里把start_time设为{{LAST_SYNC_TIME|datetime}},end_time设为{{CURRENT_TIME|datetime}},order_type写死"6",status写死"80"。 - 目标端连接器:选金蝶云星辰 V2,API 选
/jdy/v2/scm/inv_other_in,Method=POST,Type=WebAPI/EXECUTE。 - 字段映射:主表里
bill_date取{{stockin_time}},bill_no取{{order_no}},trans_type_id与operation_key都填常量。明细用数组整体引用,把material_entity.value写为"details_list",平台按同名规则自动落到material_number、qty、price等字段。 - 调度:源端 Crontab 设
3 2 * * *(凌晨 2:03 拉),目标端设23 2 * * *(2:23 写),中间留 20 分钟缓冲。
实施步骤
我们建议分三阶段上线,稳妥不翻车:
阶段一:增量起点(冷启动)
首次运行前,手动在轻易云里把 LAST_SYNC_TIME 设为比当前早 7 天,只拉近一周数据做验证,避免一次性灌历史。
阶段二:全量触发(可选)
如果业务要求把历史也补齐,在轻易云里临时把 start_time 写死成历史起始日期,跑一次后立刻改回 {{LAST_SYNC_TIME}},切回增量。这一步很多客户现场会忘,稳妥的做法是建一个独立的"全量补数方案",跑完归档。
阶段三:常态化调度
源端每天 2:03 拉、目标端 2:23 写,轻易云自动维护 LAST_SYNC_TIME。监控面板上看源端返回条数与目标端成功条数,差值超阈值就告警。
踩坑复盘
- 物料编码两端不一致:本策略没做
_findCollection联查,goods_no直接传给material_number。客户现场出现过两边编码差一个前缀,导致金蝶直接报"物料不存在"。稳妥做法是在轻易云里建一个物料主数据同步方案做编码映射,集中管理。 - 明细数组字段名不匹配:直接写
material_entity.value="details_list"只解决"数组整体引用",但如果源端字段叫spec_no、目标端叫material_number,得在映射表里显式配对,平台不会做语义识别。 - **库存重复入库。因为
operation_key="audit"是创建即审核,网络抖动导致轻易云认为失败而重发时,容易产生重复单。典型错误是忘了用bill_no(源端order_no)做幂等键——轻易云默认会用idCheck去重,但要确认两端唯一键已对齐。 - 时间窗口过小漏单:跨天调度时,如果源端
end_time用了当前整点,刚好在边界修改的单据会被漏。稳妥做法是end_time往后多取 2 分钟,或让轻易云开启容错窗口。 trans_type_id写错:金蝶"其他入库"是固定12,和"采购入库"、盘盈入库不是同一个值。一旦配错,单据能保存但进了错误的业务类型,后期报表全乱。这里容易翻车,配置完必须核对一次。
适用场景与不适用场景
适用:电商零售场景下,WMS/OMS 产生大量非采购类入库(调整、初始化、损益),需要自动落账到财务 ERP,且物料编码已统一或由主数据方案统一管理。
不适用:两端物料编码体系完全不同、又没建主数据同步的项目;以及需要人工审批流、不希望创建即审核的场景(本策略固定 audit,不支持二次提交)。