轻易云
注册体验

分销商销售退货单同步实战:旺店通·企业奇门到金蝶云星辰 V2

· 集成方案库· 20 次浏览· 约 4 分钟读完
旺店通金蝶云星辰销售退货同步分销商版字段映射轻易云Qeasy旺店通 金蝶云星辰供应链集成

这个策略解决什么问题

某零售企业在多渠道分销场景下,电商门店的退货单先落在旺店通·企业奇门,财务核算与库存账却统一在金蝶云星辰 V2。分销商作为独立客户主体进行退货核算,一旦两侧数据脱节,就会出现「旺店通退了货,金蝶库存没回、账上没数」的尴尬。这条策略就是把旺店通里已完成的退货入库单,按分销商维度同步成金蝶的销售退货入库单,让电商退货与供应链/财务核算自动衔接。我们在客户现场通常会用轻易云数据集成平台(Qeasy)承接,目标是把分销商退货数据稳定落到金蝶。

数据流向与字段映射

数据流向非常清晰:旺店通·企业奇门(退货入库单) → 轻易云中间层 → 金蝶云星辰 V2(销售退货入库单)。

主表关键字段对照:

源字段(旺店通)目标字段(金蝶云星辰)映射类型转换规则
check_timebill_dateTRANSFORM日期格式转换,截取 yyyy-MM-dd
fenxiao_nickcustomer_idCOLLECTION_findCollection 联查客户档案 ID
order_nobill_noDIRECT单据编码直接透传
shop_nameremarkTRANSFORM拼接 店铺名称:{{shop_name}}
—IsAutoSubmitAndAuditCONSTANT固定为 true
details_listmaterial_entityARRAY明细行一一对应

明细行字段对照:

源字段目标字段映射类型业务说明
details_list[].spec_no / goods_nomaterial_entity[].material_numberDIRECTSKU 编码对应物料编码
details_list[].nummaterial_entity[].qtyDIRECT退回数量
details_list[].pricematerial_entity[].priceDIRECT退货单价
details_list[].total_amountmaterial_entity[].amountDIRECT行金额
details_list[].remarkmaterial_entity[].commentDIRECT行备注

在轻易云上如何配置

在轻易云数据集成平台(Qeasy)上,我们把这条策略拆成三段配置,避免把所有映射压在一个节点上:

  1. 源端(QUERY):接口 wdt.stockin.order.query.refund,POST 请求,时间窗用 start_time = {{LAST_SYNC_TIME}}、end_time = {{CURRENT_TIME}},status 写死 80(已完成),分页参数 page_size 由平台分页变量驱动。
  2. 中间层(编码映射集中管理):fenxiao_nick → customer_id 这种联查,放在同一份客户主数据方案中,通过 _findCollection find id from <客户方案> where name={{fenxiao_nick}} 一行表达式完成,后续任何分销商维度的策略都可以复用。SKU 编码则依赖前置的物料主数据同步,确保两边一致。
  3. 目标端(EXECUTE):接口 /jdy/v2/scm/sal_in_bound,POST 写入,IsAutoSubmitAndAudit 固定 true,由金蝶自动提交并审核,减少人工干预。

实施步骤

我们建议分阶段上线,采取「增量起步、全量兜底、双轨并行」的调度模式:

  • 第一步:增量起点。初次上线时,把 start_time 回拨到业务开始日(如月初),end_time 取当前时间,跑一轮历史增量,只同步 status=80 的已完结单据,避免噪音数据进金蝶。
  • 第二步:全量触发。在增量稳定运行 1–2 个调度窗口后,按需补跑一次全量,通常用于换月或主数据大规模调整后的场景。
  • 第三步:调度频率。建议采用 */10 8-22 * * *,营业时段每 10 分钟一次,凌晨留给源系统维护窗口,既兼顾实时性,也避免夜间空跑。
  • 第四步:监控与对账。上线后第一周,我们会让客户每天抽 30 分钟对照旺店通与金蝶两侧的退货单号、金额和客户名称,确认编码映射没有跑偏。

踩坑复盘

  1. fenxiao_nick 来源不明就上线。这个字段在源端 schema 里不直接出现,常常要从分销订单里取。如果不先和数据负责人对齐「它到底是昵称、姓名还是店铺标识」,联查出来的客户 ID 会大批量为空。稳妥的做法是上线前先抽样 50 条源单,人工核对分销商口径。
  2. status 不写死 80。源端默认会返回 10/20/30/60 等中间态单据,一旦原样同步到金蝶,会出现「审核中的退货」被自动审核掉的脏数据。我们强烈建议在源端请求里就硬编码 status=80。
  3. SKU 编码假设一致。旺店通的 spec_no 与金蝶的 material_number 通常不会自然相同,前置的物料主数据同步没有跑稳就开退货,会出现整行明细落不进金蝶的情况。这里的典型错误是「等出了问题再补主数据」,正确顺序是先打通物料和客户,再开退货单。
  4. IsAutoSubmitAndAudit=true 双刃剑。自动审核确实省事,但如果源端数据有偏差,审核后再回滚成本很高。建议上线第一周先关掉,核对无误后再打开。
  5. 表头表体一次性同步。明细行一旦有任何一条不过整单都会被目标端拒收。稳妥的做法是表头和表体分阶段调试,先跑通表头,再放开明细。

适用场景与不适用场景

适用:分销/代销模式下,以分销商为独立客户主体的电商退货,需要把旺店通的退货数据落到金蝶云星辰做财务核算和库存回写的场景。 不适用:单店直营、店铺即客户的退货核算;以及源端尚未完成审核、需要中间态单据实时同步的场景,这类需求应使用店铺版策略或另建中间态方案。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-wdt-kingdee-cloud-5121-ndf9056e2-953c392e

评论