金蝶库存覆盖小满:即时库存同步策略实战教程
这个策略解决什么问题
在很多零售与分销场景里,金蝶云星空是后台ERP的库存真源,小满OKKICRM承担前端销售与客户运营。当客户在前台下单时,看到的库存必须与ERP一致,否则超卖、漏单、客服投诉会接踵而至。"金蝶库存覆盖小满"这条策略的目标很直接:用ERP的即时库存去覆盖CRM侧的库存数值,把库存真源牢牢锁在金蝶,小满只负责展示与下单。本教程围绕这条策略的端到端实施展开。
数据流向与字段映射
整条链路是单向覆盖:金蝶云星空 → 轻易云集成平台(中间层) → 小满OKKICRM。
源端在金蝶侧调用库存查询接口,按物料ID和仓库ID拉取当前即时库存与可用量。中间层负责把金蝶的内部物料ID转换为小满侧的SKU编码——这一步靠的是"编码映射集中管理":物料编码先经一条独立的"查询金蝶物料"策略拉取并落库,再在库存同步里通过查找集合把FMaterialId对应的物料编号解析成小满的sku_id。目标端调用小满的库存修改接口,把实际库存与可用库存一并写回。
关键字段对照如下:
| 业务含义 | 金蝶源字段 | 中间层处理 | 小满目标字段 |
|---|---|---|---|
| 物料唯一标识 | FMaterialId / FMaterialId_FNumber | 查找映射表转换为sku_code | sku_id |
| 仓库维度 | FStockId | 过滤/映射 | (由小满侧按sku维度接收) |
| 当前库存量 | FBaseQty | 直接透传 | real_count |
| 可用库存量 | FBaseAVBQty | 与FBaseQty取同值或按规则计算 | enable_count |
| 修改类型 | — | 固定常量 | inventory_type=1 |
在轻易云上如何配置
在轻易云数据集成平台里,这条策略以"源策略+目标策略"成对配置。
源端配置要点:API选金蝶云星空的库存查询,请求体里声明FID、FStockId、FMaterialId、FBaseQty、FBaseAVBQty等返回字段;主键用FMaterialId_FNumber,便于后续按物料编号做幂等。分页参数根据金蝶侧的页大小上限调整,避免单页过大被截断。
目标端配置要点:API选小满的库存修改接口,字段sku_id的值写成"从映射集合里查找sku_id,其中sku_code等于{{FMaterialId_FNumber}}"——这就是常说的编码映射集中管理:不在每条策略里重复维护映射关系,而是依托物料主数据策略的结果集统一解析。real_count与enable_count分别绑定{{FBaseQty}},inventory_type写死常量1,代表"按绝对值覆盖"。
中间层编排:在轻易云的策略编排画布里,把"金蝶库存覆盖小满"放在依赖链末端,显式声明它依赖前置的"金蝶物料=>小满产品"主数据同步策略。映射集合只有在主数据落库后才有数据,否则sku_id解析会全部为空,这是新手最容易忽略的依赖问题。
实施步骤
- 基础物料先行:先跑通"金蝶物料=>小满产品"策略,把物料主数据同步完成,确保映射集合里有数据。这一步是整个库存同步的前置条件,不能跳过。
- 首轮全量触发:物料就绪后,手动触发一次"金蝶库存覆盖小满"的全量执行,核对小满侧每个SKU的库存数值是否与金蝶一致。全量阶段建议放在业务低峰期,并提前知会业务方。
- 切到增量调度:全量核对无误后,把源端crontab配成
*/30 7-23 * * *,目标端配成1-59/30 7-23 * * *,源与目标错开半分钟,形成稳态的近实时同步窗口,覆盖全天主要营业时段。 - 监控与告警接入:在轻易云上挂上策略运行看板,关注源端空跑、目标端4xx/5xx、字段映射空值三类异常,任一超过阈值即触发告警。
- 周期对账:每周固定一次,抽10个SKU把金蝶、小满两侧的库存做一次人工对账,核对同步链路是否真的"零漂移"。
踩坑复盘
- 典型错误一:没跑主数据就直接同步库存。映射集合是空的,所有sku_id都解析不到,结果就是"同步成功但库存全是0"。稳妥的做法是先验证物料主数据策略的产出,再去触发库存同步。
- 典型错误二:用增量号段代替绝对覆盖。如果目标端用了"差量修改"语义而非"绝对覆盖",而源端在盘点后出现了负向调整,小满侧会越累越偏。这里inventory_type=1(覆盖)是必要的语义声明,不能图省事改掉。
- 典型错误三:仓库维度被忽略。金蝶按仓库核算库存,小满按SKU汇总,如果不在源端就按目标仓库过滤掉非业务仓,虚拟仓、调拨仓的库存会被一起写进CRM,数字看起来漂亮但业务不对。
- 典型错误四:幂等键没设对。源端主键如果用FID而不是FMaterialId_FNumber,同一物料多仓多行会重复触发覆盖,导致接口被限流。稳妥的做法是用"物料编号+仓库"组合作为幂等键。
- 典型错误五:调度窗口撞上业务高峰。如果半小时一次的同步正好压在促销整点,接口排队会拖垮小满侧。这里我们把源端整点跑、目标端错开半分钟跑,本质上就是源与目标错峰的常见做法。
适用场景与不适用场景
适用:ERP为库存真源、CRM/前端系统只做展示与下单的零售与分销场景;需要近实时(半小时级)库存对齐、对超卖敏感的业务。 不适用:CRM侧需要保留独立库存语义(如分仓预留、渠道配额)的场景;以及网络条件差、双方系统都长期离线的边缘门店场景——那种更应该走离线批量而非实时覆盖。