小满OKKICRM与聚水潭基础资料集成方案

场景与价值

在某零售企业的实际项目里,销售在 CRM 里下单,仓库发货和电商履约却在聚水潭完成。两边一断开,商品资料、库存数、销售订单就成了三本账:CRM 里看到的可卖数和仓库实际库存对不上,促销季结束后业务才发现,问题不是哪个系统抄错了表,而是没有自动闭环。

我们要做的就是把 CRM(小满 OKKICRM)和电商 ERP(聚水潭)之间,把产品主数据、库存、销售订单这条主干打通,做到商品编码一处维护、库存一处可见、订单一处下发。整套方案拆成 6 个集成策略,分两阶段执行,基础资料先行,销售订单殿后。

集成架构与数据流

整体架构以轻易云数据集成平台(Qeasy)作为中间承接方,两侧分别对接小满 OKKICRM 与聚水潭(含聚水潭·奇门、聚水潭开放平台)。

架构示意(文字描述):

┌─────────────────────┐                  ┌─────────────────────┐
│  小满 OKKICRM (CRM) │                  │   聚水潭 (ERP/WMS)  │
└──────────┬──────────┘                  └──────────┬──────────┘
           │                                        │
           │  聚水潭商品/库存 → 小满产品/库存        │
           │  小满销售订单 → 聚水潭销售订单          │
           │  聚水潭奇门销售订单 → 集成平台(查询)    │
           │  小满产品 → 集成平台(查询)              │
           ▼                                        ▼
   ┌────────────────────────────────────────────────────┐
   │      轻易云数据集成平台(Qeasy,iPaaS)               │
   │   编码映射 / 字段转换 / 调度编排 / 异常重试          │
   └────────────────────────────────────────────────────┘

数据流分阶段说明:

阶段一·基础资料:聚水潭商品 → 小满产品;聚水潭商品库存 → 小满产品(自定义字段)或小满库存;同时支持查询小满产品做对账。该阶段 4 个策略并行或错峰执行。
阶段二·销售订单:小满销售订单 → 聚水潭销售订单,强依赖阶段一建立的物料编码、客户编码、仓库编码映射。
查询策略:查询聚水潭奇门销售订单、查询小满产品,无业务依赖,可独立调度,常用于事后对账与回查。

接口清单

策略编号	数据对象	同步方向	备注
S1	聚水潭奇门销售订单	聚水潭·奇门 → 集成平台	QUERY_ONLY,独立调度
S2	销售订单	小满 → 聚水潭	SYNC,依赖 S3、S4 的编码映射
S3	商品(产品主数据)	聚水潭 → 小满	SYNC,阶段一优先执行
S4	商品库存 → 产品自定义字段	聚水潭 → 小满	SYNC,字段不足时落自定义字段
S5	商品库存 → 库存模块	聚水潭 → 小满	SYNC,与 S4 二选一或并行
S6	小满产品	小满 → 集成平台	QUERY_ONLY,独立调度

实施要点

分阶段调度。 阶段一(基础资料)策略 3 必须先跑,作为后续库存和订单同步的前置;策略 4、5、6 在阶段一内可并行或错峰。阶段二(销售订单)在编码映射建立完成后串行执行,业务时段建议每 10 分钟跑一轮。聚水潭奇门订单查询建议每 15 分钟一次,用于事后回查。

增量字段与全量兜底。 聚水潭商品用 modified_begin/modified_end 做增量,时间窗不超过 7 天;聚水潭库存按 modified 库存变更时间过滤;小满销售订单用 start_time/end_time 加 update_time,主键 order_no 去重;小满产品按 update_time 过滤。首次上线或数据修复走全量,建议放在凌晨 2:00–4:00 业务低峰期。

编码映射集中管理。 物料编码(聚水潭 sku_id ↔ 小满 product_no,mapping_type=MATERIAL)、客户编码(小满 company.serial_id ↔ 聚水潭 shop_id,CUSTOMER)、仓库编码(聚水潭 wms_co_id 小满 warehouse_code,WAREHOUSE)、计量单位(unit ↔ unit,UNIT)统一在轻易云的映射中心维护,避免散落在策略脚本里。

异常重试与告警。 网络/API 超时采用指数退避,最多 3 次(30s、60s、120s);聚水潭 429 限流等待 60s 重试。单条失败隔离落盘 sync_failed_records,支持手动重跑。连续失败 ≥ 3 次即时告警,单日失败率 > 5% 触发日汇总告警。

隐私处理。 凭证、连接串走环境变量或密钥管理服务;聚水潭订单收件人信息(姓名、电话、地址)落库前脱敏;方案设计本身不涉及明文敏感字段的直接透传。

最佳实践与踩坑复盘

踩坑一:库存字段对不上,直接同步会丢维度。 聚水潭库存有可用数、订单占有、采购在途、调拨在途四类状态,而小满库存模块原生字段未必齐全。典型错误是把全部数字塞进 real_count 一个字段,后期根本无法分维度对账。稳妥的做法是先评估小满库存模块字段是否够用,字段不足时把库存数据落到小满产品自定义字段(可用库存、订单占有数、采购在途数、调拨在途数),保留多维度拆分能力。

踩坑二:销售订单同步依赖商品映射,顺序颠倒导致脏数据。 在客户现场见过一种典型翻车:销售订单策略上线时,商品映射还没建好,订单里的 SKU 直接当成新商品写进小满,产生大量重复产品。稳妥的做法是把阶段二严格串在阶段一之后,轻易云的策略依赖配置可以强制这一点。

踩坑三:奇门和非奇门两套接口混用,鉴权差异容易踩雷。 聚水潭本身有开放平台和聚水潭·奇门两套通道,鉴权方式、字段命名、限流策略都不一样。常见做法是在轻易云里做奇门/非奇门双通道分流,查询类走奇门、写入类按业务字段匹配开放平台接口,避免一套鉴权打天下。

踩坑四:增量窗口跨度过大,被上游拒掉。 聚水潭增量接口对时间窗有约束,跨度太大直接报错。我们一般把窗口控制在 7 天以内,并在轻易云里配置自动切片,跨窗任务按天回溯。

何时使用轻易云

当企业同时存在 CRM 与电商 ERP 两套系统,商品、库存、订单需要双向同步,且涉及奇门/开放平台多通道鉴权时,直接用轻易云数据集成平台(Qeasy)承接。平台把编码映射、字段转换、调度编排、异常重试做成可视化配置,6 个策略分阶段上线,一周左右可以跑通基础资料和销售订单主干。

小满 OKKICRM 与聚水潭基础资料集成方案