同步与定时任务
同步机制
| 同步 | 方向 | 说明 |
|---|---|---|
| 拉取订单 | 平台 → ERP | 定时 ecom.orderSync 每 30 分钟,增量水位为上次同步时间往前重叠 2 小时(平台可通过 lookbackHours 加长);按「店铺 + 平台订单号」幂等,写入后在同一事务中执行审单规则、地址校验、利润预估 |
| 回传发货 | ERP → 平台 | 发货事务提交后回传运单号;多包裹订单在支持部分发货的平台上按包裹回传,失败可在订单或包裹上重新回传 |
| 回传库存 | ERP → 平台 | ecom.inventoryPush 每 15 分钟:自发货、在售、已映射的商品,可售 = ⌊默认发货仓空闲库存 ÷ 多件装⌋ − 保留数量(组合商品取各组件可凑成的套数),只推变化的;锁定为手工库存的跳过 |
| 拉取在线商品 | 平台 → ERP | ecom.listingSync 每天,不覆盖已有映射,平台 SKU 等于物料编码时自动映射 |
| 令牌维护 | - | ecom.tokenRefresh 每小时,失败标记需重新授权 |
| 同步日志 | - | 每次同步写 ecom_sync_log(店铺、类型、结果、条数、错误),保留 90 天(ecom.syncLogClean) |
所有同步都只处理启用且配置了授权的店铺(店铺上可关闭各项同步开关);一个店铺失败不影响其他店铺,失败原因写入同步日志,并在「渠道接入」页面汇总显示各能力最近一次结果和 24 小时失败次数。

电商定时任务
定时任务在「系统监控 → 定时任务」中修改 Cron(6 段:秒 分 时 日 月 周)、参数、启停和立即执行。下表为默认值:
| 任务标识 | 默认时间 | 内容 |
|---|---|---|
ecom.orderSync | 每 30 分钟 | 拉取订单 |
ecom.inventoryPush | 每 15 分钟 | 回传库存 |
ecom.listingSync | 每天 3:20 | 拉取在线商品 |
ecom.tokenRefresh | 每小时 | 刷新令牌 |
ecom.syncLogClean | 每天 2:40 | 清理 90 天前的同步日志 |
ecom.trackPull | 每 2 小时 | 拉取发货 60 天内未签收包裹的物流轨迹,计算超时预警 |
ecom.publishQueue | 每 5 分钟 | 处理遗漏的待发布刊登、查询异步刊登结果 |
ecom.repricer | 每 15 分钟 | 执行到期的自动调价规则 |
ecom.adsSync | 每天 4:30 | 同步广告结构与报告(参数 days,默认 3 天) |
ecom.adRules | 每小时第 10 分钟 | 执行到点的广告规则 |
ecom.adSchedule | 每小时整点 | 分时调价 |
ecom.csMessageSync / ecom.csReviewSync / ecom.csReviewRequest | 每 10 分钟 / 每小时 / 每天 | 买家消息、评价同步与自动请求评价 |
ecom.fbaDailySync / ecom.amzReportPoll | 每天 4:30 / 每 2 分钟 | FBA 报告任务的创建与轮询下载 |
ecom.owhOutbound | 每 15 分钟 | 海外仓自动推送出库并同步出库状态 |
ecom.owhInbound | 每小时 | 海外仓入库单、退件单、调拨单状态 |
ecom.owhStock | 每 2 小时 | 海外仓库存 |
ecom.owhFee | 每天 3:30 | 海外仓最近 7 天费用 |
ecom.ali1688PriceSync / ecom.ali1688OrderSync | 每天 7:00 / 每小时 | 1688 货源价格库存、1688 采购单状态与物流 |
ecom.stockSnapshot | 每天 23:50 | 每日库存快照(断货日识别、销量预测) |
ecom.forecast | 每天 4:00 | 销量预测 |
ecom.monitorFetch | 每天 7:10 | ASIN 监控抓取 |

编写同步代码的约定
- 定时任务实现
framework/job/JobHandler(key、名称、默认 Cron、run),启动时自动登记;调度器按租户逐个调用。 - 外部接口在事务之外调用,写库用
TransactionTemplate逐条提交,一条失败不影响其他。 - 需要生成出入库单等业务单据时以系统身份执行(如海外仓任务的
EcomOwhSupport.asSystem)。 - 定时任务不受店铺数据权限限制。
- 演示 / 测试用的海外仓账号关闭「自动同步」,定时任务跳过,只能手工操作。