Skip to content

同步与定时任务 ​

同步机制 ​

同步方向说明
拉取订单平台 → ERP定时 ecom.orderSync 每 30 分钟,增量水位为上次同步时间往前重叠 2 小时(平台可通过 lookbackHours 加长);按「店铺 + 平台订单号」幂等,写入后在同一事务中执行审单规则、地址校验、利润预估
回传发货ERP → 平台发货事务提交后回传运单号;多包裹订单在支持部分发货的平台上按包裹回传,失败可在订单或包裹上重新回传
回传库存ERP → 平台ecom.inventoryPush 每 15 分钟:自发货、在售、已映射的商品,可售 = ⌊默认发货仓空闲库存 ÷ 多件装⌋ − 保留数量(组合商品取各组件可凑成的套数),只推变化的;锁定为手工库存的跳过
拉取在线商品平台 → ERPecom.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:10ASIN 监控抓取

定时任务

编写同步代码的约定 ​

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

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com