轻易云
注册体验

旺店通销售出库单同步至金蝶云星空(店铺维度)实战教程

· 陈洁琳· 集成方案库· 58 次浏览· 约 3 分钟读完
旺店通金蝶云星空销售订单同步轻易云供应链集成增量同步

这个策略解决什么问题

某零售企业的电商订单在旺店通里完成审核发货,但财务与供应链分析依赖金蝶云星空的销售出库单。需要把旺店通的出库单按店铺维度推到金蝶,作为后续核算与库存的源头单据。这条策略看似只是单据搬运,真正麻烦在于:出库单带表头+表体,跨系统的组织、客户、商品编码完全不同,稍不留神就会出现「单据下来了但数字对不上」。

数据流向与字段映射

整体流向为:旺店通(源)→ 轻易云中间层 → 金蝶云星空(目标)。

源端调用的是 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:ssFDate
店铺名shop_name查组织映射表FSaleOrgId(FName=shop_name 反查)
客户shop_name复用店铺作为客户FCustomerID
单据类型—常量FBillTypeID(XSCKD01_SYS)

注意 FSaleOrgId 使用了 _findCollection,即店铺名 → 销售组织编码的反查;这是轻易云上集中维护的编码映射,后续店铺增减只改一处。

在轻易云上如何配置

在轻易云数据集成平台(Qeasy)中,新建一条策略,源平台选旺店通·企业奇门,目标平台选金蝶云星空,业务模块归到「销售订单同步」。

  1. 源端配置:填入接口与请求字段,start_time 用 {{HOURE_AGO_3|datetime}}、end_time 用 {{CURRENT_TIME|datetime}},开 idCheck=true,以 order_no 去重。
  2. 中间层映射:用可视化映射器把源字段映射到目标字段;组织、客户走查找表,日期走格式转换,常量字段直接写死。
  3. 目标端配置:目标 API 选 batchSave,idCheck=true 开启幂等,避免重复回写。
  4. 运行模式:源端建议设 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

评论