旺店通销售出库单同步至金蝶云星空(店铺维度)实战教程
旺店通金蝶云星空销售订单同步轻易云供应链集成增量同步
这个策略解决什么问题
某零售企业的电商订单在旺店通里完成审核发货,但财务与供应链分析依赖金蝶云星空的销售出库单。需要把旺店通的出库单按店铺维度推到金蝶,作为后续核算与库存的源头单据。这条策略看似只是单据搬运,真正麻烦在于:出库单带表头+表体,跨系统的组织、客户、商品编码完全不同,稍不留神就会出现「单据下来了但数字对不上」。
数据流向与字段映射
整体流向为:旺店通(源)→ 轻易云中间层 → 金蝶云星空(目标)。
源端调用的是 wdt.stockout.order.query.trade(POST,QUERY),以 start_time / end_time 做增量窗口,以 order_no 作为幂等键。目标端调用金蝶的 batchSave(POST,EXECUTE),用 id 作为幂等键。
关键字段对照(典型):
| 业务含义 | 旺店通(源) | 中间层处理 | 金蝶云星空(目标) |
|---|---|---|---|
| 单据编号 | order_no | 直接透传 | FBillNo |
| 出库时间 | consign_time | 转 yyyy-MM-dd HH:mm:ss | FDate |
| 店铺名 | shop_name | 查组织映射表 | FSaleOrgId(FName=shop_name 反查) |
| 客户 | shop_name | 复用店铺作为客户 | FCustomerID |
| 单据类型 | — | 常量 | FBillTypeID(XSCKD01_SYS) |
注意 FSaleOrgId 使用了 _findCollection,即店铺名 → 销售组织编码的反查;这是轻易云上集中维护的编码映射,后续店铺增减只改一处。
在轻易云上如何配置
在轻易云数据集成平台(Qeasy)中,新建一条策略,源平台选旺店通·企业奇门,目标平台选金蝶云星空,业务模块归到「销售订单同步」。
- 源端配置:填入接口与请求字段,
start_time用{{HOURE_AGO_3|datetime}}、end_time用{{CURRENT_TIME|datetime}},开idCheck=true,以order_no去重。 - 中间层映射:用可视化映射器把源字段映射到目标字段;组织、客户走查找表,日期走格式转换,常量字段直接写死。
- 目标端配置:目标 API 选
batchSave,idCheck=true开启幂等,避免重复回写。 - 运行模式:源端建议设
buildModel=false,字段按源文档动态读取,减少后期源系统加字段带来的配置改动。
实施步骤
分三阶段上线比较稳妥:
- 阶段一 · 全量初始化:用脚本一次性把近 N 天已发货(状态 95、110)的出库单推一遍,验证映射与编码。
- 阶段二 · 增量起点:以全量截止时间为
start_time,按*/15 * * * *拉增量,目标端*/20 * * * *写入,源快于目标,留出处理缓冲。 - 阶段三 · 稳态运行:监控每日同步条数、失败重试、幂等命中,逐步放开状态范围(如异常发货 113)。
调度频率建议源 */15、目标 */20,错峰避免两端在同一秒打满。
踩坑复盘
- 店铺作为客户:金蝶里客户主数据一般不直接等于店铺,有的项目会单独维护「店铺客户」档案,组织与客户分两个查找表,不要合并到一个
shop_name字段。 - 时区与时间格式:跨秒边界容易丢单,稳妥做法是把
end_time加上 1 分钟冗余,同时在中间层做去重兜底。 - 状态过滤:源端
status默认空会拉全量,首次跑务必限定为 95/110,否则会把已取消单也带过来。 - 幂等键冲突:金蝶
FBillNo唯一,源端order_no必须保证不重,如果源系统存在改单后再推,要用order_no + consign_time组合去重。 - 组织映射变更:店铺关停或新增时,查找表要在轻易云上集中维护,不要散落在多张表里,否则 3 个月后两边数字对不上,排查极费时。
适用场景与不适用场景
适用:多店铺零售、电商订单需进入财务核算、组织-客户-商品三套编码已在金蝶侧建档的场景。
不适用:不需要在金蝶生成销售出库单、或者金蝶侧用其他单据类型(如调拨单)承接的场景;也暂不适合跨法人、跨账套的复杂组织结构。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-wdt-kingdee-cloud-2008-n0ed1326d-e6557a3c