跟踪代理仓同步任务
更新时间：2026-07-31
1. 操作场景
同步任务页用于跟踪代理仓相关业务的执行结果。仓库在发起入库推送、出库推送、取消确认、库存同步或状态回写后，可以通过任务页查看任务状态、执行摘要、HTTP 日志和库存快照，并在需要时手工发起一次【立即同步】。
本文适用于仓库运营、实施和排障人员。常见场景包括：
- 查看某个入库单或出库单是否已经完成代理仓同步；
- 判断任务当前是在继续等待、正在执行、已经成功，还是需要人工处理；
- 打开任务详情查看请求日志和错误信息；
- 查看库存同步任务抓取到的代理仓库存快照；
- 对未完成任务手工执行一次【立即同步】。
这页适合放在运营处理流程的第一站：
- 业务发出去以后，先来这里看结果。
- 这里能判断要不要继续等、要不要点【立即同步】、要不要先修正配置或资料。
- 如果要看更具体的请求与响应，再去《日志》。
2. 操作指引
前提条件
- 当前账号可以进入
GWMS-代理仓-同步任务。 - 目标业务已经触发过代理仓交互，系统中已经生成任务。
- 如果要执行【立即同步】，请确认任务当前不是【成功】或【已取消】状态。
2.1 进入同步任务页面
菜单路径：GWMS-代理仓-同步任务
- 登录 GWMS 后，进入左侧【代理仓】模块。
- 点击【同步任务】。
- 页面分为三个区域：
- 筛选区（顶部）：搜索条件
- 任务概览（中间）：快速统计和定位
- 任务列表（底部）：任务明细表格
筛选区支持的条件
- 【状态】：选择任务当前状态
- 【业务类型】：选择入库、出库等业务类型
- 【任务类型】：选择任务类别，包括：
- 查询任务：补查某条业务当前在代理仓的最新状态
- 创建任务：确认入库单、出库单是否已被代理仓受理并继续处理
- 取消任务：确认取消动作是否已经在代理仓完成
- 库存同步任务：拉取代理仓库存快照并修正 GWMS 托管库存
- 【仓库】：选择具体仓库
- 【创建时间】：选择日期范围
任务类型说明
当前系统支持 4 种任务类型：
| 任务类型 | 含义 | 适用场景 |
|---|---|---|
| 查询任务 | 状态补查 | 自动或手工补查某条业务在代理仓的最新状态 |
| 创建任务 | 创建确认 | 确认入库单、出库单已被代理仓受理并继续处理 |
| 取消任务 | 取消确认 | 确认取消动作是否已经在代理仓完成 |
| 库存同步任务 | 库存校正 | 从代理仓拉取库存快照并同步到 GWMS 托管库存 |
补充说明：
- 当前序列号相关能力不会在这里单独生成第 5 种任务类型。
- 现有代码里的序列号相关场景至少包括 4 类：入库建单后补推、入库序列号后续增量同步、代理仓入库结果回写、代理仓出库结果回写。
- 如果要排查序列号为什么没有推过去或没有拉回来，优先去《日志》看对应请求与响应，再回到这里结合入库/出库任务状态判断主链路是否已经闭环。
这页看序列号时，重点看什么：
- 看入库单或出库单主流程是不是已经成功、等待中或人工处理。
- 看【执行摘要】里有没有提示主流程失败、本地动作失败或仍在等待下一次查询。
- 不要把“任务成功”直接理解成“序列号一定已经完整回写”；序列号回写和主流程结果不是完全等价的。
2.2 使用任务概览快速定位异常
任务概览区域用于按风险级别快速筛选任务。
概览卡片结构
- 顶部显示【任务概览】和帮助说明图标
- 右侧显示【展开】/【收起】切换按钮
- 主要指标区域：显示关键统计数字
- 筛选提示条：选择某个指标后显示当前筛选条件
- 展开区域：显示更多次要指标和处理提醒
主要指标
每个指标卡片显示：
- 指标名称
- 统计数量
- 颜色标识：红色（需要处理）、黄色（注意）、蓝色（信息）
- 可点击筛选：点击后自动筛选列表
常见指标包括：
- 积压任务数：当前仍处于等待中、还没有完成的任务
- 运行中任务数：当前正在执行的任务
- 需要人工处理的任务数：自动链路已经停下、需要人工介入的任务
使用建议
建议这样使用：
- 先看积压、运行中、人工处理类指标，快速识别异常
- 发现某个指标异常时，点击对应卡片
- 系统会自动筛选到对应任务集合
- 处理完成后，点击【清除筛选】恢复全部任务
如果当前主要在排库存同步问题，建议把【任务类型】筛选为"库存同步任务"后再看概览。
展开区域内容
展开后显示：
- 次要指标：更多统计维度
- 处理提醒：需要注意的风险提示
2.3 查看任务列表
任务列表主要分 6 列：
【单号】列
显示两行内容：
- 第一行：业务单号（可点击查看详情，可复制）
- 第二行：第三方单号（如果有，可复制）
【类型】列
显示两项内容：
- 第一行：任务类型（创建任务、取消任务、查询任务、库存同步任务）
- 第二行：业务类型（入库、出库等）
【状态】列
显示当前任务状态：
- 等待中（黄色）
- 运行中（蓝色）
- 成功（绿色）
- 人工处理（红色）
- 已取消（灰色）
这些状态怎么理解
- 等待中：这条任务还没有结束。常见情况是系统已经安排了下一次自动查询或重试，不一定代表代理仓此刻正在处理。
- 运行中：系统正在执行这条任务，不建议重复点击【立即同步】。
- 成功：这条任务已经闭环完成。
- 人工处理：自动链路已经停下，需要先排查配置、资料、业务状态或本地动作条件。
- 已取消：这条任务已经关闭，不会继续执行。
【路由信息】列
显示任务关联的配置：
- GWMS 仓库代码
- 代理仓仓库代码
- 代理仓系统编码
【执行摘要】列
显示结果说明或错误信息，用于快速判断任务成功或失败原因。
【时间】列
显示三个时间：
- 创建时间
- 最后执行时间
- 下次执行时间（如果任务还在等待中）
【操作】列
- 【立即同步】按钮：只对未结束任务显示
- 已经成功或已取消的任务不会再显示这个按钮
2.4 查看任务详情
- 在任务列表中点击业务单号。
- 系统打开任务详情弹窗。
- 默认显示【任务详情】页签，可查看：
- 任务编号
- 任务类型
- 任务状态
- 业务类型
- 业务单号 / 第三方单号
- 代理仓系统信息
- 仓库编码 / 代理仓编码
- 请求编号
- 最后执行时间 / 下次执行时间 / 创建时间
- 执行结果
- 错误信息
如果该任务有关联请求记录，详情弹窗还会显示【请求日志】页签。库存同步任务还会额外显示【代理仓库存】页签。
2.5 查看请求日志
- 在任务详情弹窗切换到【请求日志】。
- 列表会展示这次任务关联的接口记录。
- 展开某一行后，左侧显示请求内容，右侧显示响应内容。
这里适合确认：
- 调用的是哪个接口
- 请求单号、仓库编码、SKU 是否正确
- 代理仓返回的是成功、失败还是空结果
2.6 查看库存同步任务快照
当任务类型为”库存同步任务”时，详情弹窗会多一个【代理仓库存】页签。
该页签主要显示本次库存同步任务执行时保存的代理仓库存快照，字段包括：
| 字段 | 说明 |
|---|---|
| 代理仓 SKU | 代理仓系统中的 SKU 编码 |
| GSKU | GWMS 中的全局 SKU |
| 本地 SKU | 客户侧 SKU 编码 |
| 可用库存 | 代理仓返回的可用数量 |
| 锁定库存 | 代理仓返回的锁定数量 |
| 总库存 | 可用库存 + 锁定库存 |
| 库存类型 | 合格品 / 残品 |
| 代理仓入库单号 | 代理仓记录的入库单号 |
| 本地入库单号 | GWMS 入库单号 |
| 入库时间 | 代理仓记录的入库时间 |
| 快照时间 | 本次任务抓取快照的时间 |
| 代理仓仓库编码 | 代理仓仓库代码 |
| GWMS 仓库编码 | GWMS 仓库代码 |
快照数据的理解方式
需要注意的是：
- 这个页签展示的是任务执行当时抓取下来的库存快照，不是实时再次查询代理仓
- 它适合做”当次同步为什么这样处理”的回溯
- 如果需要看当前最新库存，请重新触发一次库存同步任务
库存数量计算规则
- 总库存 = 可用库存 + 锁定库存
- 不要把”可用库存”直接当成 GWMS 的总库存
- 看到锁定库存时，要一起算进总库存
- 如果只比较可用库存，容易误判库存是否一致
库存明细拆分规则
代理仓会把库存按不同入库批次拆开返回。GWMS 同步时，主要按下面这些信息判断对应到哪一批库存：
- 仓库
- SKU
- 库存类型（合格品/残品）
- 入库单号
- 入库时间
需要注意：
- GWMS 只修正代理仓托管的专用库位（虚拟上架库位、残品库位），不会修改其他普通库位
2.7 手工执行立即同步
- 在未结束任务所在行点击【立即同步】按钮。
- 系统弹出确认框【是否确认立即执行任务？】。
- 确认后，系统提示【执行请求已提交】。
- 刷新列表或等待一段时间后，再查看任务状态和执行摘要。
如果执行失败，页面会直接提示失败原因。
立即同步的工作方式
点击【立即同步】后，系统会优先把这条任务重新投入执行队列，而不是继续等到原来的下次执行时间。
适用场景
建议在下面场景使用【立即同步】：
- 代理仓已经完成处理，但本地任务还在等待下一次查询
- 你刚修正了映射、系统配置或基础资料，想马上再执行一次
- 需要验证某次异常修复是否生效
不建议在下面场景反复点击：
- 任务已经成功或已经取消
- 任务仍在处理中
- 任务错误原因还没有排除，例如系统配置、仓库映射或 SKU 资料仍然错误
执行后的观察要点
点击后只是提交执行请求。任务还需要经过实际执行、查询和回写。请注意：
- 先看【最后执行时间】是否更新
- 再结合【执行摘要】判断结果
- 如果状态仍是等待中，说明系统判断还需要继续自动查询或重试
- 如果状态变为人工处理，说明当前已经不能只靠自动链路完成
3. 补充说明
3.1 任务自动查询时间
系统会根据不同任务类型，自动安排下次查询或重试时间：
| 任务类型 | 自动节奏 | 说明 |
|---|---|---|
| 创建任务 | 30 分钟 | 创建确认任务默认每 30 分钟继续查一次 |
| 取消任务 | 10 分钟 → 20 分钟 → 1 小时 → 4 小时 | 取消确认任务按重试次数递增 |
| 库存同步任务 | 12 小时 | 执行异常后按 12 小时节奏再次尝试 |
| 查询任务 | 24 小时 | 状态补查任务默认 24 小时后再继续查一次 |
说明：
- 创建任务（入库/出库）：固定每 30 分钟继续确认一次
- 取消任务：首次 10 分钟，第二次 20 分钟，第三次 1 小时，第四次及以后 4 小时
- 如果不想等待，可以点击【立即同步】手工触发
3.2 常见任务状态
常见状态说明：
| 页面状态 | 含义 | 说明 |
|---|---|---|
| 等待中 | 还未结束 | 任务正在等待下一次自动查询、自动重试，或刚被重新投入执行队列 |
| 运行中 | 正在执行 | 任务正在执行，本轮不要重复点击【立即同步】 |
| 成功 | 已完成 | 任务已经闭环完成 |
| 人工处理 | 需要介入 | 自动链路已经停下，常见原因包括代理仓失败、状态无法识别、本地动作条件不满足、自动取消受阻、连续失败超预算 |
| 已取消 | 已关闭 | 任务已取消，不会继续执行 |
3.3 什么情况下适合点立即同步
建议在下面场景使用【立即同步】：
- 代理仓已经完成处理，但本地任务还在等待下一次查询
- 你刚修正了映射、系统配置或基础资料，想马上再执行一次
- 需要验证某次异常修复是否生效
不建议在下面场景反复点击：
- 任务已经成功或已经取消
- 任务仍在处理中
- 任务错误原因还没有排除，例如系统配置、仓库映射或 SKU 资料仍然错误
3.4 库存同步任务和业务同步任务的区别
库存同步任务只负责库存校正，不直接对应某一张业务单据。它的重点是：
- 抓取代理仓快照
- 对比本地库存
- 记录本次使用的代理仓库存明细
需要注意：
- 库存同步不会无限等待同仓其他业务任务全部结束；
- 系统只会先尽量处理一部分同仓待处理任务，然后继续做库存校正；
- 所以库存同步成功，不等于同仓所有业务任务都已经全部闭环。
业务同步任务则更关注某张入库单、出库单或取消操作有没有完成。
4. 常见问题
Q1：为什么列表里没有【立即同步】按钮？
A1：这条任务通常已经处于结束状态，例如【成功】或【已取消】。页面只对未结束任务提供【立即同步】入口。
Q2：点击【立即同步】后，为什么状态没有马上变成成功？
A2：点击后只是提交执行请求。任务还需要经过实际执行、查询和回写。请先看【最后执行时间】是否更新，再结合【执行摘要】判断结果。
Q3：为什么库存同步任务详情里看不到【代理仓库存】页签？
A3：只有库存同步任务才会显示这个页签。请先确认当前查看的是库存同步任务。
Q4：任务状态一直在等待中，应该先看哪里？
A4：先看【执行摘要】和【错误信息】。如果提示是接口问题，再去《日志》看原始请求与响应；如果提示是仓库、渠道、SKU、客户资料或系统配置问题，请先回到《代理仓系统》检查映射和基础资料。
Q5：库存快照里的数量为什么和现在代理仓页面看到的不一样？
A5：任务详情里的库存数据是这次任务执行时保存下来的快照，不会随着代理仓后续变化实时更新。它用于回溯”这次任务当时看到的库存”，不是实时库存看板。