线下销售出库单同步:聚水潭到金蝶云星空的实战配置教程

这个策略解决什么问题

某零售企业在多渠道经营下,门店开单产生的线下销售出库单需要进入金蝶云星空做库存扣减与财务核算。聚水潭侧出库已审,金蝶侧出库未到,两边库存口径会出现「日终对不齐」。本策略要解决的就是:把线下出库单按既定口径稳定推到金蝶本地仓,且支持历史与增量并轨。

数据流向与字段映射

整条链路是单向的:源系统(聚水潭) → 轻易云数据集成平台(Qeasy)中间层 → 目标系统(金蝶云星空·本地仓)。中间层不承担业务计算,只做映射、改写、补默认值与失败重投。

关键字段对照(节选,实际以客户主数据为准):

两个细节必须事先约定:一是「门店仓→本地仓」的仓库映射口径要集中放在轻易云里维护,不要散落在脚本里;二是带税率的单价在金蝶侧可能拆为含税/不含税两列,改写逻辑要分阶段做,先透传,后续再补。

在轻易云上如何配置

我们在客户现场通常这样落地:

1. 建源系统连接:指向聚水潭·奇门的取数接口,只取「已审核」状态的线下销售出库单,过滤条件放在请求参数层,不要拿到全量再筛。
2. 建目标系统连接:金蝶云星空的保存/审核接口,按本地仓组织隔离。
3. 配字段映射:在轻易云可视化映射画布里把字段一一对应,带税率的单价统一在一个「价格改写器」里处理,方便审计。
4. 配置错误处理:失败重试 3 次,仍失败的进「异常池」,人工补单后再重投,不进入自动循环。
5. 打开日志与监控:行级日志保留至少 7 天,出问题便于回放。

编码映射集中管理,是轻易云这类平台相对手写脚本最大的优势——客户后续新增门店或仓库,只需改一处映射,不需要改同步主流程。

实施步骤

我们建议按「增量先稳,全量补齐」的节奏上线:

• 阶段一·增量起点:上线当晚先不跑历史,只取上线后新增的已审单据,每 15 分钟拉一次,跑 3 个工作日确认零差异。这一步的目的是验证映射与字段改写的正确性。
• 阶段二·全量回灌:增量稳定后,把上线前 N 天的历史已审单据按日期段分批回灌,每批 200~500 单,跑完一批核对一次库存余额与单据列表,确认无重无漏。
• 阶段三·调度常态化:全量回灌完成后,切到日常调度——白天每 15 分钟一次增量,夜间做一次全量对账(取两边口径做差额校验,只比对、不回写)。
• 阶段四·监控与告警:库存差异阈值、失败单据数、接口耗时三个指标进入告警看板。

踩坑复盘

• 坑一:把「已审」和「已发货」混着用。聚水潭的「已审」不等于「已发货」,若直接以发货状态为准会漏单。稳妥做法是按已审核+物流单号非空双重条件过滤。
• 坑二:仓库映射散落在脚本里。门店一多,脚本维护成本指数上升,出错后定位极慢。集中放到轻易云的映射表里管理,是大多数客户最终都会走的一步。
• 坑三:税率与单价的口径不一致。聚水潭侧默认带税,金蝶侧默认不含税,直接透传会导致金额对不上。稳妥做法是先单独跑价格字段一周,确认改写逻辑正确再上线其他字段。
• 坑四:全量与增量混跑导致重复单。历史回灌阶段如果同时开着增量窗口,会出现同一张单被推两次。必须在回灌窗口临时关闭增量,或以单据编号做去重闸口。
• 坑五:对账只看总金额。总金额对得上不代表明细对得上,必须按 SKU 维度核对数量,这是客户现场最容易翻车的一环。

适用场景与不适用场景

适用:多渠道零售、门店与仓库分离、单据量稳定可按增量推进、需要在 ERP 侧做库存与财务闭环的企业。不适用:实时性要求在分钟级以内、跨组织多账套、需要复杂拆单合单规则、对失败零容忍且无法接受人工补单的场景,后者应优先评估业务系统直连方案。