轻易云
注册体验

京东渠道销售退货单同步:聚水潭售后退款单到金蝶云星空的实战配置

· 谢锴斌· 集成方案库· 6 次浏览· 约 4 分钟读完
聚水潭金蝶云星空销售退货增量同步轻易云供应链集成

这个策略解决什么问题

在某零售企业的全渠道业务里,京东平台的退货退款单需要在财务系统形成销售退货单,才能走完入库与退款闭环。如果靠人工导单,客服和财务每天要核对上百单,出错率高、时效也跟不上。这一策略把聚水潭里已确认收货(good_status='SELLER_RECEIVED')的售后退款单,自动推到金蝶云星空的SAL_RETURNSTOCK销售退货单,实现"买家退货—卖家收货—金蝶退货入库"的端到端流转。我们用轻易云数据集成平台承接这条链路,把源端过滤、字段映射、主键去重统一管起来,客服只管异常单,财务只看金蝶里的成品单。

数据流向与字段映射

数据流向分三层:聚水潭·奇门(源端接口 jushuitan.refund.list.query)→ 轻易云中间层(做过滤、字段转换、主键拼接)→ 金蝶云星空(目标接口 batchSave,表单 SAL_RETURNSTOCK)。

主表关键字段映射:

源字段(聚水潭)目标字段(金蝶)映射类型说明
-FBillTypeIDCONSTANT固定值 XSTHD01_SYS,标准销售退货单
as_idFBillNoDIRECT售后单号作为单据编号
-FSaleOrgIdCONSTANT销售组织 101
-FStockOrgIdCONSTANT库存组织 100
-FRetcustIdCONSTANT退货客户 CUST0009(京东渠道固定)
-FSettleCurrIdCONSTANT币别 PRE001
items.receive_dateFDateDIRECT单据日期取明细行收货日期
remarkFHeadNoteDIRECT备注
o_idF_QKMS_NBDDH1DIRECT内部订单号
createdF_QKMS_DATEFKRQDIRECT登记时间

明细行(items → FEntity)关键字段:

源字段目标字段说明
sku_idFMaterialId物料编码
qtyFRealQty实退数量(正数)
priceFTaxPrice含税单价
amountFAmount退货金额
i_idF_QKMS_SPTM商品条码
properties_valueF_QKMS_SPGG商品规格
asi_idFEntryID明细行标识

明细行按 as_id 分组,聚水潭一行售后明细对应金蝶一行退货明细,qty 直接传正数表示入库数量。

在轻易云上如何配置

在轻易云数据集成平台里,这条策略拆成源端 JstQM 资源、目标端 Kingdee.Cloud 资源、一条主策略,以及一个去重用的中间处理脚本(轻量即可,甚至可以纯配置完成)。

源端配置要点:API 选 jushuitan.refund.list.query,方法 POST,page_size=50 拉满,date_type=0 按修改时间查,good_status 硬编码 SELLER_RECEIVED,start_time 用平台变量 {{LAST_SYNC_TIME|datetime}},end_time 用 {{CURRENT_TIME|datetime}},注意时间窗口不能超 7 天,这是聚水潭 API 的硬限制。

目标端配置要点:API 选 batchSave,表单 SAL_RETURNSTOCK,Operation=Save,IsAutoSubmitAndAudit=false(只保存不审核,留给财务走线下审批),IsVerifyBaseDataField=true 让金蝶校验基础资料,SubSystemId=21 销售管理模块,BatchCount=5 控制并发。

主键设计上,把 {{as_id}}{{modified}} 拼接作为 number 和 id,idCheck=true 开启去重,buildModel=false 不建数据模型。这样同一售后单发生变更时,会触发重新同步,而不是被去重逻辑拦掉。

实施步骤

  1. 增量起点:上线前先用 page_index 翻页式全量拉一次历史单据,确认 good_status 过滤生效,核对 FRetcustId 全部命中 CUST0009。这一步在轻易云里可以用一次性手工触发完成。
  2. 调度频率:crontab 设为 0-59/50 7-22 * * *,每 50 分钟一轮,覆盖电商营业时段;凌晨低峰期不跑,减少对源端 API 的压力。
  3. 首次同步验证:挑选 3-5 单跨店铺、跨日期的京东退货单,人工对比金蝶生成的 SAL_RETURNSTOCK 头行字段、单据日期、金额、退货客户,确认无误后再放量。
  4. 持续运维:监控 LAST_SYNC_TIME 是否单调推进、idCheck 拦截率是否在合理范围(过高说明 modified 频繁抖动),超阈值触发告警。
  5. 补偿机制:失败自动重试,仍失败的单据进入异常队列,人工在轻易云里点"重跑"即可,无需重传整批。

踩坑复盘

  • 收货日期取错层级:FDate 一定要从 items.receive_date 取,而不是 as_id 主表上的某个日期字段。源端数组里有多个 receive_date,配置里要用数组聚合(取首行或按业务约定),不要误映射成字符串。这是典型翻车点。
  • 退货客户没固定:京东渠道必须用 CUST0009 这个固定客户,不能用店铺维度做映射。如果误把店铺编码塞进 FRetcustId,金蝶会报基础资料不存在,整批失败。
  • 7 天窗口被忽略:聚水潭 API 强制要求 start_time 和 end_time 间隔 ≤7 天,轻易云调度本身没问题,但如果中途停服超过 7 天再启动,会出现"查不到数据"的假象。稳妥做法是停服恢复后先做一次手工回补,再切回增量。
  • modified 抖动导致重复推送:售后单状态变更(如客服备注)会更新 modified,主键拼接里带上 modified 后,平台会当成新数据再次推,触发金蝶 update。建议在轻易云里加一段脚本:同 as_id 在短窗口内只取最新一条,避免短时间内重复打金蝶接口。
  • 明细行数被截断:聚水潭默认 page_size=50 是单据级,不是明细行级;一页可能只返回少量售后单,大促期间千万别以为 50 条就够。轻易云会自动翻页,确认 page_index 自增逻辑打开就行。

适用场景与不适用场景

适用:电商渠道(尤其是平台化渠道如京东)退货、平台已确认收货、需要财务系统形成退货入库单据的零售或分销场景。 不适用:线下门店退货、退货未确认收货(good_status 非 SELLER_RECEIVED)、需要在金蝶端走工作流自动审核的复杂审批场景,以及多店铺精细化分摊退货收入的业务(本策略把京东渠道统一归到一个固定客户)。

本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-jushuitan-kingdee-cloud-8926-ok-dcb51afa

评论