吉客云与金蝶云·旗舰版供应链集成方案

场景与价值

在多系统并行的零售与分销业务中,前端业务系统与后端财务 ERP 之间的数据割裂,会导致销售订单、库存变动与财务应收数据无法及时对齐,进而影响对账效率与库存准确率。某零售企业在实际经营中,前端以吉客云承载电商订单与库存业务,后端以金蝶云·旗舰版承担财务核算与供应链管理,两套系统需要通过统一的数据通道完成单据与基础资料的同步。

本方案覆盖销售订单、出入库、采购、调拨、盘盈盘亏、退货以及基础资料同步等核心业务域,通过 31 个同步与查询策略,将前端业务单据按既定依赖顺序流转至后端 ERP,并将必要的物料、客户、供应商等基础资料双向同步,以支撑财务核算、库存一致性与业务追溯。

集成架构与数据流

整体集成架构以吉客云和金蝶云·旗舰版两侧系统为基础,通过集成平台承载策略编排、字段映射、编码转换与异常重试。数据流向可划分为三类:

吉客云 → 金蝶云·旗舰版(A→B):共 16 个同步策略,覆盖销售订单、出入库单、采购入库、调拨单、盘盈盘亏、组装拆卸、退货单、退款应收单等业务单据,以及销售渠道、仓库、供应商等基础资料。
金蝶云·旗舰版 → 吉客云(B→A):共 4 个同步策略,主要为客户档案查询结果回传、以及物料主数据同步至吉客云商品档案。
系统内部查询(INTERNAL):共 11 个查询策略,用于在同步过程中获取源单据、关联单据、客户档案、开户行、非奇门退换单等辅助数据。

策略执行存在严格的依赖关系:

基础资料(客户、仓库、供应商、物料)必须先于业务单据同步完成,避免单据因编码缺失而失败。
销售订单链路遵循:销售订单 → 销售出库单 → 销售退货单 / 财务应收单(仅退款),后续单据依赖前序单据的 billno 与明细行关联。
采购链路:采购入库单 → 采购退料单,退料单需通过二层联查关联至原始入库单。
调拨单:业务日期需依赖「查询吉客云入库单」返回的调拨入库单据,避免使用创建时间作为业务日期。
退货与退款:销售退货单需关联已同步的销售出库单,退款类财务应收单仅在销售订单已同步后生成。

接口清单

按数据对象与方向整理,核心同步接口如下:

基础资料同步:吉客云销售渠道 → 金蝶客户;吉客云仓库 → 金蝶仓库;吉客云供应商 → 金蝶供应商;金蝶物料 → 吉客云商品。
销售订单同步:吉客云销售单 → 金蝶销售订单、销售出库单、销售退货单、财务应收单(仅退款)。
采购订单同步:吉客云入库单(采购) → 金蝶采购入库单;吉客云出库单(采购退料) → 金蝶采购退料单。
库存同步:吉客云入库单 → 金蝶其他入库单、盘盈单;吉客云出库单 → 金蝶其他出库单、盘亏单;吉客云调拨单 → 金蝶直接调拨单。
其他业务单据:吉客云组装单 → 金蝶组装单;吉客云拆卸单 → 金蝶拆卸单。
内部查询:金蝶销售订单/销售出库单/采购入库单/客户/开户行查询;吉客云入库单/出库单/客户档案/非奇门退换单/退款单/采购退货单/组合装查询。
告警推送:异常信息通过企业微信通道推送。

实施要点

字段映射层面,各策略均采用主表 + 明细行的双层结构。主表承担单据头信息(单号、业务日期、币别、汇率、客户/供应商编码、库存组织与业务类型等),明细行通过 COLLECTION 映射源单的 goodsDetail 或 goodsDocDetailList。组合物料(货品编码以 ZH 开头)需在源端拆解为子物料行,并按 shareRatio 分摊数量与金额;销售员名称需去除括号内容后再写入目标字段。

编码映射是实施中的关键环节。店铺编码需映射至金蝶客户编码,货品编码需映射至金蝶物料编码,供应商编码需映射至金蝶供应商编码,仓库编码需映射至金蝶仓库编码。所有编码映射在基础资料同步策略中建立,并在后续业务单据同步中通过物料编码、客户编码直接引用,避免重复维护。

明细行级关联(billentry_lk)依赖 AfterTargetGenerate 脚本:在目标单据生成后,按物料编码、含税单价、数量匹配源单与目标单的明细行,并将目标明细行的关联字段回填,确保下推、退货、应收等下游单据可正确追溯。对于销售退货,数量 qty 需转为负数,并按可用数量扣减;对于采购退料,supplier_number 需校验与关联采购入库单一致。

最佳实践

基础资料先行:在系统上线初期,优先运行客户、仓库、供应商、物料四类基础资料同步策略,并启用全量同步完成首次灌入;后续切换为增量同步,以业务编码为幂等键。
依赖编排按链路推进:调度策略按"基础资料 → 销售订单 → 销售出库单 → 销售退货/应收"、"采购入库 → 采购退料"两类链路顺序触发,避免下游单据因上游未同步而失败。
编码映射集中维护:所有编码映射关系集中在基础资料策略中建立,业务单据策略只做编码引用,不重复维护映射表,降低维护成本。
特殊单据类型分离:组合物料、退货、仅退款、调拨等场景需在策略中通过单据类型常量与源单 tradeType / inouttype 区分,避免与常规单据混跑。
异常与重试:针对编码缺失、目标单据校验失败、接口限流等场景,配置统一的重试策略与告警推送,通过企业微信通道实时通知运维人员。
幂等与追溯:所有同步策略以源单主键作为目标单据的 id 或 sourcebillno,保证重跑不重复创建单据;明细行关联通过物料、单价、数量三维匹配,确保业务可追溯。

通过上述方案,某零售企业实现了吉客云与金蝶云·旗舰版之间业务单据与基础资料的全量贯通,既保留了前端业务系统的灵活性,又保障了后端 ERP 的财务核算与库存数据一致性。