定时任务
定时任务是系统按固定时间自动执行的后台工作。跨境业务大量依赖它:定时拉取平台订单、回传库存、刷新店铺令牌、同步广告与 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:40 | days=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:30 | days=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:20 | days=30 | days 天内到期且有库存的批次,提醒仓库人员(每个批次一次),见批次与序列号 |
| 应收逾期提醒 | 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-59 | 0-59 | 0-23 | 1-31 | 1-12 | 0-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) | 执行用时,毫秒 |
| 结果 | 成功 / 失败 |
| 说明 | 执行说明或失败原因;多租户时按「租户名:结果」用分号分隔 |
店铺、海外仓账号级别的同步明细(每次请求的结果、失败原因)记录在「运营管理 → 渠道接入」的同步日志和各账号的「最近同步时间与失败原因」中,比这里的汇总更详细。
注意事项
注意
- 部署时如果在服务端关闭了定时任务调度(一般只在测试环境这样做),所有任务都不会自动执行,只能在本页手动执行;
- 停用订单同步、库存回传等任务后,平台订单不会自动进入系统、平台上的库存不会自动更新,可能造成超卖;
- 停用提醒类任务后,相关人员将收不到对应的站内提醒,首页待办中的数据不受影响。