管易销售发货单同步到金蝶其他出库单(线上维修场景)实战教程
这个策略解决什么问题
某零售企业的线上维修业务跑在管易云上,工单完成后会在管易里生成销售发货单(发货代表实物出库)。但财务侧的金蝶云星空需要把每一次维修出库登记为其他出库单,作为成本核算和库存核减的依据。两边口径不一致时,就会出现库存账实漂移、维修成本归集不到当期的问题。
本策略要做的事很简单:把管易的销售发货单变成金蝶里的其他出库单,做到一张单据一进一出,两边账对得上。
数据流向与字段映射
整体链路是:管易云(源) → 轻易云数据集成平台(中间层) → 金蝶云星空(目标)。
中间层负责编码映射、字段转换和单据状态承接。关键字段对照如下(只列工程上最容易出问题的几列):
| 业务含义 | 管易销售发货单(源) | 金蝶其他出库单(目标) | 备注 |
|---|---|---|---|
| 单据编号 | 发货单号 | 单据编号(FBillNo) | 中间层做防重写 |
| 单据日期 | 发货时间 | 业务日期 | 时区按客户所在地 |
| 客户编码 | 客户编码 | 客户编码(FCustomerId) | 编码映射集中维护 |
| 仓库编码 | 出库仓库 | 仓库(FStockId) | 仓库资料必须先同步 |
| 商品编码 | 商品编码 | 物料编码(FMaterialId) | 物料资料必须先同步 |
| 数量 | 数量 | 实发数量(FQty) | 单位需统一 |
| 单价金额 | 销售单价 | 单价/金额 | 维修场景常为 0 价 |
| 单据类型 | / | 业务类型(其他出库) | 在目标端固定赋值 |
经验提示:编码映射一定要在轻易云里集中管理,不要散落在脚本里。我们见过客户把映射写在每个策略各自的转换脚本中,3 个月后维护人员找不到、改不动。
在轻易云上如何配置
把这条策略在轻易云数据集成平台(Qeasy)里落地,核心是四块:源系统读取、字段映射、目标系统写入、调度与告警。
- 源系统接入:配置管易云的销售发货单接口,按"已审核"状态过滤,避免把草稿单据推过去。
- 目标系统接入:配置金蝶云星空的其他出库单保存接口,业务类型固定选"其他出库",并把组织、库存组织、仓库等维度作为参数传入。
- 字段映射:在轻易云的映射画布里完成上面那张表的对齐。单位不一致时,优先在源端做单位换算,而不是依赖目标端兜底——目标端换算一旦失败,单据就会卡在金蝶里。
- 异常处理:轻易云的标准做法是,目标写入失败的单据进入"待重试队列",由值班人员二次处理,而不是直接丢回源端。
实施步骤
一次实际项目里,我们通常按"三阶段"推进:增量起点确认 → 全量触发 → 调度频率。
第一阶段:增量起点确认。 客户现场第一步不是写脚本,而是确定增量起点时间。线上维修单量不大,通常按"近 7 天已审核单"作为起点比较稳妥。早于这个时间的单据,如果数量不大,通过手工补录;如果量很大,再单独跑一次历史全量。
第二阶段:全量触发。 起点之后的存量数据,在轻易云里手动触发一次全量同步。全量跑完后立刻对账:管易发货单数量 vs 金蝶其他出库单数量,误差要求归零。误差非零时,先排查"重复单据"和"编码未映射"两类典型问题,再去调脚本。
第三阶段:调度频率。 线上维修对实时性有要求,但又不像正价订单那么高。我们常用的配置是:每 10 分钟拉取一次,合并写目标端。客户也可以根据门店分布调成 5 分钟或 15 分钟。频率过密(如 1 分钟)会把管易的查询接口打满,得不偿失。
踩坑复盘
这里列出几次实际项目里翻车的点,供后来人参考:
- 编码映射散落。最典型的错误是把仓库/客户/物料的编码对照写在每个策略的脚本里。3 个月后改一次组织架构,需要逐个策略去翻。稳妥的做法是,在轻易云里维护一张"编码映射表",所有策略引用同一份。
- 表头表体一次提交。金蝶其他出库单是表头+表体结构,如果轻易云只写了表头、表体为空或行数对不上,目标端会拒收。我们让客户用"表头表体分阶段"的配置:先写表头,再写表体,失败时不留半成品单据。
- 状态过滤遗漏。把草稿、待审、未审核的发货单一起推过去,会导致金蝶侧产生大量"其他出库"草稿,财务月结时一片混乱。源端过滤状态是基本功,但确实容易漏。
- 单位与基本计量混用。管易商品可能用"件",金蝶物料用"PCS",看起来一样,实际写入时单位换算失败。稳妥的做法是源端先换算到目标端的基本计量单位,再推送。
- 时区问题。客户如果是跨区域,源端时间戳带时区、目标端按本时区落库,会出现"单据日期"差一天。配置时统一时区(通常取客户总部所在地)是最省心的方案。
适用场景与不适用场景
适用:线上维修、售后换新、样品出库等"非销售性质但要登记出库"的业务,单据量在每日数百到数千单级别,需要财务侧完整留痕。
不适用:正价销售订单的出库(应走销售出库单)、跨组织调拨(应走调拨单)、以及源端单据状态不稳定、撤销/作废频繁的业务场景——后者会让对账逻辑变复杂,建议先治理源端。