查询小满产品策略实战教程:从CRM拉取物料到中间层的工程实践
小满OKKICRM鼎捷t100策略教程物料主数据QUERY_ONLY增量同步轻易云CRM与ERP集成
这个策略解决什么问题
在一次零售与制造一体的客户现场,CRM 里维护着最权威的产品主数据,而下游 ERP 是后续所有业务单据的源头。两边一旦编码不一致,后面订单、库存、价格全部会跟着错。我们用轻易云数据集成平台做的第一件事,就是先把 CRM 里的产品数据稳定、可重复地拉到一个中间层。这条名为「查询小满产品」的策略,正好承担这一职责——它本身不写任何目标系统,只负责把数据按增量窗口取出。
数据流向与字段映射
数据流向非常干净:小满 OKKI CRM → 轻易云集成平台(中间层) → 等待下一条写入策略落到下游 ERP。本策略只走前半段。
| 维度 | 源端(小满 OKKI CRM) | 目标端(轻易云中间层) |
|---|---|---|
| API 路径 | /v1/product/list(GET) | 写入空操作(POST) |
| 作用类型 | QUERY | EXECUTE |
| 业务编码字段 | product_no | 0(占位,等下一条策略映射) |
| 幂等校验 | 不开启 idCheck | 开启 idCheck |
| 自动回填响应 | autoFillResponse=true | — |
入参是典型的分页+时间窗结构:start_index、count、start_time、end_time、removed。其中 start_time 与 end_time 是后续调度的关键,分别绑定 {{LAST_SYNC_TIME|datetime}} 与 {{CURRENT_TIME|datetime}},确保每次只取上次成功之后的变化。
在轻易云上如何配置
在轻易云数据集成平台里,这条策略按以下要点配置:
- 新建策略,选择「查询类」模板,源平台指定为小满 OKKI CRM,目标平台选轻易云集成平台本身。
- 接口元数据按上方 source 配置填好:
/v1/product/list,GET,product_no作为业务主键,idCheck保持关闭。 - 请求参数直接维护在
request数组里:start_index=1、count=20、removed=0三个默认值写死;start_time与end_time用平台内置的时间变量。 - 响应处理打开
autoFillResponse,让平台把返回结构直接落成可观测的数据视图,方便排查。 - 目标端选择「写入空操作」API,等同于把数据落到中间层落库,不直接推 ERP——这是客户现场最常用的一种「先落地、再分发」模式,编码映射集中管理在后续策略里完成,避免在第一条策略就引入复杂映射。
- 调度策略按
crontab设定:源端 03:02 拉取,目标端 02:23 落中间层,前后错开避免重叠。
实施步骤
我们建议按「增量起点 → 全量兜底 → 调度频率」三步推进:
- 增量起点:第一次运行不依赖
LAST_SYNC_TIME,手动指定一个明确的起点日期(比如「2024-01-01 00:00:00」),避免一上来就扫全表。 - 全量触发:在轻易云里加一个一次性的人工触发节点,用于初始化历史数据;全量跑完后再切回增量窗口模式,这是「增量与全量双轨」的常见应对方式。
- 调度频率:每天凌晨运行一次足够。CRM 端产品主数据通常不会一天改多次,过短的调度只会消耗接口配额。
- 依赖与序号:在策略编排里,这条策略序号为 A,后续「产品同步到 ERP」的写入策略序号为 B,依赖 A,形成清晰的链路。
踩坑复盘
start_time直接用CURRENT_TIME:典型错误是开始时间和结束时间都取当前时间,结果每次拉到的都是空窗口。稳妥做法是开始时间取上一次成功时间,结束时间取本次当前时间。- 分页没翻干净:
count=20是默认值,但产品主数据量一大就会漏。需要在轻易云里配置分页循环,直到返回记录数小于count才停。 removed字段忽视:客户现场经常出现「在 CRM 删了产品但 ERP 还在用」的对账纠纷。务必把removed=0与removed=1分两次跑过,定期同步删除事件。- 目标端写成真正的下游系统:本策略刻意只落到中间层。如果在第一条查询策略里就强行写 ERP,编码映射、字段裁剪、重试逻辑全混在一起,后面很难维护。
- 调度时间撞车:源端 03:02 与目标端 02:23 故意错开,是为了给落库留出时间窗。客户现场一旦把两条策略都设成同一分钟,就会出现「数据还没落完就被下游策略拉走」的诡异对不上的问题。
适用场景与不适用场景
适用:上游主数据在 CRM、需要按时间窗稳定拉取到中间层、后续有独立的写入策略完成 ERP 分发的链路。不适用:需要实时同步(应改走事件触发而非定时拉取);数据源本身已是中间库、无需二次落地的简单场景;以及对删除事件敏感、必须用订阅接口而不是轮询拉取的业务。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-okkicrm-t100-0138-nd8a66a8e-b16332b9