分销商销售退货单同步实战:旺店通·企业奇门到金蝶云星辰 V2
旺店通金蝶云星辰销售退货同步分销商版字段映射轻易云Qeasy旺店通 金蝶云星辰供应链集成
这个策略解决什么问题
某零售企业在多渠道分销场景下,电商门店的退货单先落在旺店通·企业奇门,财务核算与库存账却统一在金蝶云星辰 V2。分销商作为独立客户主体进行退货核算,一旦两侧数据脱节,就会出现「旺店通退了货,金蝶库存没回、账上没数」的尴尬。这条策略就是把旺店通里已完成的退货入库单,按分销商维度同步成金蝶的销售退货入库单,让电商退货与供应链/财务核算自动衔接。我们在客户现场通常会用轻易云数据集成平台(Qeasy)承接,目标是把分销商退货数据稳定落到金蝶。
数据流向与字段映射
数据流向非常清晰:旺店通·企业奇门(退货入库单) → 轻易云中间层 → 金蝶云星辰 V2(销售退货入库单)。
主表关键字段对照:
| 源字段(旺店通) | 目标字段(金蝶云星辰) | 映射类型 | 转换规则 |
|---|---|---|---|
check_time | bill_date | TRANSFORM | 日期格式转换,截取 yyyy-MM-dd |
fenxiao_nick | customer_id | COLLECTION | _findCollection 联查客户档案 ID |
order_no | bill_no | DIRECT | 单据编码直接透传 |
shop_name | remark | TRANSFORM | 拼接 店铺名称:{{shop_name}} |
| — | IsAutoSubmitAndAudit | CONSTANT | 固定为 true |
details_list | material_entity | ARRAY | 明细行一一对应 |
明细行字段对照:
| 源字段 | 目标字段 | 映射类型 | 业务说明 |
|---|---|---|---|
details_list[].spec_no / goods_no | material_entity[].material_number | DIRECT | SKU 编码对应物料编码 |
details_list[].num | material_entity[].qty | DIRECT | 退回数量 |
details_list[].price | material_entity[].price | DIRECT | 退货单价 |
details_list[].total_amount | material_entity[].amount | DIRECT | 行金额 |
details_list[].remark | material_entity[].comment | DIRECT | 行备注 |
在轻易云上如何配置
在轻易云数据集成平台(Qeasy)上,我们把这条策略拆成三段配置,避免把所有映射压在一个节点上:
- 源端(QUERY):接口
wdt.stockin.order.query.refund,POST 请求,时间窗用start_time = {{LAST_SYNC_TIME}}、end_time = {{CURRENT_TIME}},status写死80(已完成),分页参数page_size由平台分页变量驱动。 - 中间层(编码映射集中管理):
fenxiao_nick → customer_id这种联查,放在同一份客户主数据方案中,通过_findCollection find id from <客户方案> where name={{fenxiao_nick}}一行表达式完成,后续任何分销商维度的策略都可以复用。SKU 编码则依赖前置的物料主数据同步,确保两边一致。 - 目标端(EXECUTE):接口
/jdy/v2/scm/sal_in_bound,POST 写入,IsAutoSubmitAndAudit固定true,由金蝶自动提交并审核,减少人工干预。
实施步骤
我们建议分阶段上线,采取「增量起步、全量兜底、双轨并行」的调度模式:
- 第一步:增量起点。初次上线时,把
start_time回拨到业务开始日(如月初),end_time取当前时间,跑一轮历史增量,只同步status=80的已完结单据,避免噪音数据进金蝶。 - 第二步:全量触发。在增量稳定运行 1–2 个调度窗口后,按需补跑一次全量,通常用于换月或主数据大规模调整后的场景。
- 第三步:调度频率。建议采用
*/10 8-22 * * *,营业时段每 10 分钟一次,凌晨留给源系统维护窗口,既兼顾实时性,也避免夜间空跑。 - 第四步:监控与对账。上线后第一周,我们会让客户每天抽 30 分钟对照旺店通与金蝶两侧的退货单号、金额和客户名称,确认编码映射没有跑偏。
踩坑复盘
fenxiao_nick来源不明就上线。这个字段在源端 schema 里不直接出现,常常要从分销订单里取。如果不先和数据负责人对齐「它到底是昵称、姓名还是店铺标识」,联查出来的客户 ID 会大批量为空。稳妥的做法是上线前先抽样 50 条源单,人工核对分销商口径。status不写死 80。源端默认会返回10/20/30/60等中间态单据,一旦原样同步到金蝶,会出现「审核中的退货」被自动审核掉的脏数据。我们强烈建议在源端请求里就硬编码status=80。- SKU 编码假设一致。旺店通的
spec_no与金蝶的material_number通常不会自然相同,前置的物料主数据同步没有跑稳就开退货,会出现整行明细落不进金蝶的情况。这里的典型错误是「等出了问题再补主数据」,正确顺序是先打通物料和客户,再开退货单。 IsAutoSubmitAndAudit=true双刃剑。自动审核确实省事,但如果源端数据有偏差,审核后再回滚成本很高。建议上线第一周先关掉,核对无误后再打开。- 表头表体一次性同步。明细行一旦有任何一条不过整单都会被目标端拒收。稳妥的做法是表头和表体分阶段调试,先跑通表头,再放开明细。
适用场景与不适用场景
适用:分销/代销模式下,以分销商为独立客户主体的电商退货,需要把旺店通的退货数据落到金蝶云星辰做财务核算和库存回写的场景。 不适用:单店直营、店铺即客户的退货核算;以及源端尚未完成审核、需要中间态单据实时同步的场景,这类需求应使用店铺版策略或另建中间态方案。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-wdt-kingdee-cloud-5121-ndf9056e2-953c392e