旺店通调拨单管理同步到MySQL:单一策略深度实战
MySQL旺店通调拨单增量同步轻易云供应链集成
这个策略解决什么问题
调拨单是仓库之间的库存移动凭证,数据既要给财务核算,也要给供应链做在途分析。一次实际项目中,某零售企业的调拨量日均上千单,既要准又要快,直接拉全量接口既慢又会压垮上游,丢单更让人头疼。这条策略用「时间窗增量 + REPLACE 写入」把旺店通的调拨单稳定落到 MySQL 中间库,既快又可重放,业务系统再从 MySQL 拉数做后续计算。
数据流向与字段映射
数据流向清晰:旺店通(源) → 轻易云数据集成平台(中间层) → MySQL(目标)。
源端调用 wdt.stock.transfer.query,按 start_time / end_time 拉增量;目标端走 execute SQL,主表用 REPLACE INTO tp_wdt_stock_transfer,子表用 REPLACE INTO tp_wdt_stock_transfer_details_list,主键冲突即覆盖,天然幂等。
关键字段对照表:
| 业务含义 | 源端(旺店通) | 中间层 | 目标(MySQL) | 备注 |
|---|---|---|---|---|
| 调拨单号 | transfer_no | 直接透传 | transfer_no | 单据唯一编号 |
| 单据状态 | status | 直接透传 | status | 10/20/30/40/42/44/46/50/60/62/64/66/70/80/90 |
| 源仓库编码 | from_warehouse_no | 透传 | from_warehouse_no | 仓库唯编 |
| 目标仓库编码 | to_warehouse_no | 透传 | to_warehouse_no | 仓库唯编 |
| 创建时间 | created | 透传 | created | datetime |
| 修改时间 | modified | 透传 | modified | 增量游标 |
| 子表行号 | rec_id | 透传 | rec_id | 1:N 明细标识 |
| 商品编码 | spec_no / goods_no | 透传 | spec_no / goods_no | 多对一映射 |
在轻易云上如何配置
在轻易云数据集成平台(Qeasy)的策略画布里,这条策略本质是「源 Query + 目标 SQL Execute」两步:
- 源端:API 选
wdt.stock.transfer.query,POST 请求;start_time取{{LAST_SYNC_TIME|datetime}},end_time取{{CURRENT_TIME|datetime}},调度自动维护增量游标;status显式传50,60,70,80,90,只拉「部分出库 / 全部出库 / 部分入库 / 待结算 / 调拨完成」这些对下游有意义的单据。 - 目标端:SQL 类型 Execute,主语句
REPLACE INTO tp_wdt_stock_transfer (… ) VALUES (… );子表用extend_sql_2写入tp_wdt_stock_transfer_details_list,1:N 扩展参数为details_list。idCheck关闭,buildModel关闭,避免误判。 - 编码映射:仓库编码、商品编码、供应商编码统一进「编码映射集中管理」,不要散落在策略里。后续新建策略直接引用,这是轻易云客户常见的应对模式之一。
实施步骤
分阶段调度,稳扎稳打:
- 增量起点:先全量跑一次,把历史调拨单补齐,同时记录
LAST_SYNC_TIME;之后每 11 分钟(*/11 * * * *)增量一次,源端与目标端错开 3 分钟(3-59/11 * * * *),避免同时打 MySQL。 - 全量触发:每天凌晨低峰跑一次全量重放,以
REPLACE幂等覆盖,自然修正漂移数据,不需要复杂对账。 - 调度频率:业务旺时可调到 5 分钟,弱时可调到 30 分钟;但「源端拉数间隔」必须大于「目标端写入耗时」,否则会堆积。
- 校验:用轻易云内置的「数据校验」模块,核对
transfer_no与goods_count / goods_in_count / goods_out_count,异常进告警队列。
踩坑复盘
- 坑 1:状态字段不传。源端
status不传会返回全部状态,大量已取消单涌进来,下游误判。这里稳妥的做法是显式传50,60,70,80,90,只同步对业务有价值的单据。 - 坑 2:增量游标没维护。
LAST_SYNC_TIME必须每次成功落库后才往前推,否则失败重试会把同一批数据反复写入,虽然REPLACE幂等,但日志和告警会被刷爆。 - 坑 3:1:N 扩展参数拼错。
extend_params_2必须等于源端返回数组字段名(如details_list),写错会让明细丢失但主表还在,排查极难。建议轻易云上「表头表体分阶段」先跑主表,通了再开子表。 - 坑 4:
REPLACE误用。它会先删后插,自增主键会变,触发器会跑两次。稳妥做法是主键用transfer_id + rec_id复合唯一索引,业务主键稳定。 - 坑 5:仓库编码不对齐。旺店通是字符串编码,业务系统是数字 ID,直接透传会撞码。这里轻易云客户常见的应对模式是「编码映射集中管理」,在平台里维护一份映射表,源编码进来先查表再写。
适用场景与不适用场景
适用:日均调拨量大、要求近实时落库、源端只暴露 Query 接口、需要表头表体同库落数的零售与制造场景。不适用:要求秒级实时推送、需要触发式回调、源端没有时间字段做增量游标的场景,这时应换「即时库存同步」或消息推送策略。
本文为原创内容,转载请注明出处:https://www.qeasy.cloud/insights/solutions/strat-mysql-wdt-5427-mysql-fefb0632