Skip to content

定时任务 ​

定时任务是系统按固定时间自动执行的后台工作。跨境业务大量依赖它:定时拉取平台订单、回传库存、刷新店铺令牌、同步广告与 FBA 报告、推送和同步海外仓单据、拉取物流轨迹、执行自动调价和广告规则、生成销量预测等。管理员可以在这里调整执行时间和参数、启用或停用任务、立即执行一次,并查看执行日志。

平台专属

定时任务是平台专属功能,SaaS 模式下只有平台租户的管理员可以使用。任务对所有租户统一调度:每次执行时按租户逐个运行(只运行启用且未到期的租户),某个租户失败不影响其他租户,执行说明中汇总各租户的结果。

页面入口 ​

系统监控 → 定时任务

定时任务

列表字段 ​

列说明
任务名称如「平台订单同步」
任务标识任务的唯一编码,如 ecom.orderSync
Cron执行时间表达式
参数任务参数,如 days=30
状态启用 / 停用
最近执行最近一次执行的开始时间
结果最近一次执行成功 / 失败
执行说明最近一次执行的结果说明,如「同步 3 个店铺,新增订单 25 张」「没有已授权的 1688 账号,跳过」,失败时为错误原因
操作「执行」「修改」「日志」图标(鼠标悬停显示名称)

内置任务 ​

系统内置以下任务,新版本增加的任务在系统启动时自动登记。涉及外部平台的任务只处理启用且已授权(海外仓账号还要求开启「自动同步」)的店铺 / 账号,没有授权时直接跳过;平台接口都在数据库事务之外调用,逐个店铺、逐条单据处理,一条失败不影响其他。

订单与渠道 ​

任务名称任务标识默认执行时间默认参数作用
平台订单同步ecom.orderSync每 30 分钟拉取各店铺最近更新的平台订单(与上次同步重叠 2 小时,按「店铺 + 平台订单号」去重),写入后执行订单规则
渠道库存回传ecom.inventoryPush每 15 分钟把自发货在售已配对商品的可售数(默认发货仓空闲库存 ÷ 多件装 − 保留数量)回传平台,只推变化的;锁定为手工库存的跳过
在线商品同步ecom.listingSync每天 03:20拉取各店铺的在线商品,不覆盖已有配对,卖家 SKU 等于物料编码时自动配对
渠道令牌刷新ecom.tokenRefresh每小时第 5 分钟刷新店铺授权令牌,失败的店铺标记为「需重新授权」
渠道同步日志清理ecom.syncLogClean每天 02:40days=90删除 days 天之前的渠道同步日志
物流轨迹拉取ecom.trackPull每 2 小时第 15 分钟拉取发货 60 天内未签收包裹的轨迹(物流商接口或 17TRACK),标记超时未上网、运输超时、轨迹异常等预警
电商:同步买家消息ecom.csMessageSync每 10 分钟增量拉取各店铺的买家消息
电商:同步商品评价ecom.csReviewSync每小时第 25 分钟拉取商品评价与店铺反馈,3 星及以下的提醒店铺负责人
电商:自动请求评价(亚马逊)ecom.csReviewRequest每天 10:30默认停用。对发货后 5–30 天、还没请求过的亚马逊订单自动请求评价,每店每次最多 100 张

刊登、定价与广告 ​

任务名称任务标识默认执行时间默认参数作用
刊登队列(发布、查询异步结果)ecom.publishQueue每 5 分钟处理遗漏的待发布刊登、查询平台异步处理结果,超时没有结果的记为失败
自动调价ecom.repricer每 15 分钟执行到期的自动调价规则,按规则推送新价格或生成调价建议
商品监控取数ecom.monitorFetch每天 07:10为 ASIN 监控拉取排名、卖家数、Buy Box 价等快照,并按设置发出变化预警
广告数据同步ecom.adsSync每天 04:30对开启自动同步的店铺拉取广告结构与报告
广告规则执行ecom.adRules每小时第 10 分钟执行到点的每日广告规则(调整竞价、预算、状态或仅提醒),写执行日志
广告分时调价ecom.adSchedule每小时整点按店铺时区的当前时段,把启用了分时调价的活动的竞价设为 基准竞价 × 时段系数

FBA 与平台报告 ​

任务名称任务标识默认执行时间默认参数作用
亚马逊报告任务轮询ecom.amzReportPoll每 2 分钟轮询已提交的亚马逊报告任务,完成后自动导入(库存健康、库存流水 / 赔偿、移除订单、预估费用等)
FBA 报告每日同步ecom.fbaDailySync每天 04:30days=30默认停用。每天为有授权的亚马逊店铺创建库存规划、FBA 库存、分类账、赔偿、移除订单报告

海外仓 ​

任务名称任务标识默认执行时间默认参数作用
海外仓出库推送与同步ecom.owhOutbound每 15 分钟自动推送开启了自动推送的仓库的待推送包裹,同步处理中的出库单;拿到运单号后自动发货、回传平台
海外仓入库单收货同步ecom.owhInbound每小时第 10 分钟同步入库单、退件单、调拨单的收货结果,收货完成后签收头程货件 / 调拨单、退货入库
海外仓库存同步ecom.owhStock每 2 小时拉取海外仓的可用、在途、锁定库存,与系统账面比对差异
海外仓费用同步ecom.owhFee每天 03:30同步最近 7 天的海外仓费用并入账(操作费、尾程运费计入订单物流成本,仓租等按销量分摊)

采购 ​

任务名称任务标识默认执行时间默认参数作用
1688 采购单同步ecom.ali1688OrderSync每小时第 10 分钟同步未结束的 1688 订单的状态、实付金额和物流信息
1688 货源价格同步ecom.ali1688PriceSync每天 07:00同步关联货源的价格和库存,涨跌幅超过提醒阈值的进首页待办
补货提醒scm.reorder每天 08:30预计库存不高于再订货点的物料,每天提醒采购人员一次(见安全库存补货)

分析、库存与财务 ​

任务名称任务标识默认执行时间默认参数作用
电商每日库存快照ecom.stockSnapshot每天 23:50记录在售已配对 SKU 当天的平台仓 / 本地仓可售数,用于断货日识别和销量预测,保留 730 天
电商销量预测ecom.forecast每天 04:00为全部 SKU 生成未来销量预测(补货建议可使用)
批次临期提醒wms.batchExpiry每天 08:20days=30days 天内到期且有库存的批次,提醒仓库人员(每个批次一次),见批次与序列号
应收逾期提醒fin.arOverdue每天 09:00汇总逾期未收的应收单,提醒应收人员
智能报告-周报ai.weeklyReport每周一 07:00为开启了智能报告的租户生成上周经营周报,见智能报告
智能报告-月报ai.monthlyReport每月 1 日 07:30生成上月经营月报

「默认参数」中的 days 可以在「修改」中调整。没有默认参数的任务不需要填写参数。

修改任务 ​

点击「修改」打开「修改定时任务」:

修改定时任务

字段必填说明
任务显示任务名称和标识,不可修改
Cron 表达式是6 段:秒 分 时 日 月 周,如 0 30 1 * * * 表示每天 01:30;格式错误时提示「Cron 表达式不正确」
参数否key=value 格式,多个用英文逗号分隔,如 days=30
状态是启用 / 停用。停用后不再自动执行,但仍可手动「执行」
备注否

保存后立即按新的时间重新调度,无需重启系统。

同步频率与平台限流

各平台接口都有调用频率限制。订单、库存回传、海外仓出库这类任务不建议改得比默认更频繁;店铺多时可以适当放宽间隔,避免触发限流。

Cron 表达式写法 ​

使用 6 段 Cron 表达式,各段依次为:

段秒分时日月周
取值0-590-590-231-311-120-7(0 和 7 都是周日)或 MON-SUN

常用符号:* 表示每一个;, 列举多个值;- 表示范围;/ 表示间隔;? 用在日或周上表示不指定。

表达式含义
0 0 8 * * *每天 08:00
0 30 1 * * *每天 01:30
0 0 9 * * MON-FRI工作日(周一至周五)09:00
0 0 */2 * * *每 2 小时整点
0 */30 * * * *每 30 分钟
0 0 2 1 * *每月 1 日 02:00

提示

执行时间以服务器时区为准(不是店铺所在站点的时区)。

立即执行 ​

点击行末的「执行」图标,任务会马上运行一次(不影响原有的定时计划),完成后提示执行结果,并刷新列表。

  • 同一任务正在运行时不能重复执行,提示「任务『xxx』正在运行」;
  • 手动执行在执行日志中记为「手动」触发;
  • 常用于新授权店铺后立即拉取订单、修改参数后验证、补发当天遗漏的提醒。

执行日志 ​

  • 行末的「日志」图标:查看该任务的执行日志;
  • 工具栏「执行日志」:查看全部任务的执行日志。

执行日志

列说明
任务任务标识
触发定时 / 手动
开始时间
耗时(ms)执行用时,毫秒
结果成功 / 失败
说明执行说明或失败原因;多租户时按「租户名:结果」用分号分隔

店铺、海外仓账号级别的同步明细(每次请求的结果、失败原因)记录在「运营管理 → 渠道接入」的同步日志和各账号的「最近同步时间与失败原因」中,比这里的汇总更详细。

注意事项 ​

注意

  • 部署时如果在服务端关闭了定时任务调度(一般只在测试环境这样做),所有任务都不会自动执行,只能在本页手动执行;
  • 停用订单同步、库存回传等任务后,平台订单不会自动进入系统、平台上的库存不会自动更新,可能造成超卖;
  • 停用提醒类任务后,相关人员将收不到对应的站内提醒,首页待办中的数据不受影响。

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