京东渠道销售退货单同步:聚水潭售后退款单到金蝶云星空的实战配置
这个策略解决什么问题
在某零售企业的全渠道业务里,京东平台的退货退款单需要在财务系统形成销售退货单,才能走完入库与退款闭环。如果靠人工导单,客服和财务每天要核对上百单,出错率高、时效也跟不上。这一策略把聚水潭里已确认收货(good_status='SELLER_RECEIVED')的售后退款单,自动推到金蝶云星空的SAL_RETURNSTOCK销售退货单,实现"买家退货—卖家收货—金蝶退货入库"的端到端流转。我们用轻易云数据集成平台承接这条链路,把源端过滤、字段映射、主键去重统一管起来,客服只管异常单,财务只看金蝶里的成品单。
数据流向与字段映射
数据流向分三层:聚水潭·奇门(源端接口 jushuitan.refund.list.query)→ 轻易云中间层(做过滤、字段转换、主键拼接)→ 金蝶云星空(目标接口 batchSave,表单 SAL_RETURNSTOCK)。
主表关键字段映射:
| 源字段(聚水潭) | 目标字段(金蝶) | 映射类型 | 说明 |
|---|---|---|---|
| - | FBillTypeID | CONSTANT | 固定值 XSTHD01_SYS,标准销售退货单 |
| as_id | FBillNo | DIRECT | 售后单号作为单据编号 |
| - | FSaleOrgId | CONSTANT | 销售组织 101 |
| - | FStockOrgId | CONSTANT | 库存组织 100 |
| - | FRetcustId | CONSTANT | 退货客户 CUST0009(京东渠道固定) |
| - | FSettleCurrId | CONSTANT | 币别 PRE001 |
| items.receive_date | FDate | DIRECT | 单据日期取明细行收货日期 |
| remark | FHeadNote | DIRECT | 备注 |
| o_id | F_QKMS_NBDDH1 | DIRECT | 内部订单号 |
| created | F_QKMS_DATEFKRQ | DIRECT | 登记时间 |
明细行(items → FEntity)关键字段:
| 源字段 | 目标字段 | 说明 |
|---|---|---|
| sku_id | FMaterialId | 物料编码 |
| qty | FRealQty | 实退数量(正数) |
| price | FTaxPrice | 含税单价 |
| amount | FAmount | 退货金额 |
| i_id | F_QKMS_SPTM | 商品条码 |
| properties_value | F_QKMS_SPGG | 商品规格 |
| asi_id | FEntryID | 明细行标识 |
明细行按 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 不建数据模型。这样同一售后单发生变更时,会触发重新同步,而不是被去重逻辑拦掉。
实施步骤
- 增量起点:上线前先用
page_index翻页式全量拉一次历史单据,确认good_status过滤生效,核对FRetcustId全部命中CUST0009。这一步在轻易云里可以用一次性手工触发完成。 - 调度频率:crontab 设为
0-59/50 7-22 * * *,每 50 分钟一轮,覆盖电商营业时段;凌晨低峰期不跑,减少对源端 API 的压力。 - 首次同步验证:挑选 3-5 单跨店铺、跨日期的京东退货单,人工对比金蝶生成的
SAL_RETURNSTOCK头行字段、单据日期、金额、退货客户,确认无误后再放量。 - 持续运维:监控
LAST_SYNC_TIME是否单调推进、idCheck拦截率是否在合理范围(过高说明 modified 频繁抖动),超阈值触发告警。 - 补偿机制:失败自动重试,仍失败的单据进入异常队列,人工在轻易云里点"重跑"即可,无需重传整批。
踩坑复盘
- 收货日期取错层级:
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)、需要在金蝶端走工作流自动审核的复杂审批场景,以及多店铺精细化分摊退货收入的业务(本策略把京东渠道统一归到一个固定客户)。