跳到主要内容

故障排除

常见毛病和怎么处理。每条分两部分：问题 和 修复办法。

如果排查不出来，第一步永远是去 Sync Log —— 双击失败行看 Response payload，那里通常有 WMS 返回的精确错误。

我勾了 picking note，但它没去 WMS​

修复办法：

  1. 先确认 Start Sync 是 ON 状态（按钮显示 "Stop Sync"）。如果显示 "Start Sync"，点一下开启。
  2. 确认你点了 Sync Now 按钮并在确认对话框里点了 Yes。光勾选不会自动推。
  3. 等 30 秒看 WMS Stage 列。
  4. 还是没动？看 footer：应该是 ✓ Connected。如果是 API unreachable，后台服务没跑，找 Solution Provider。
  5. 看 Sync Log 筛 Type = ORDER_CREATE —— 有没有红色 ✗，双击看错误信息。

推 picking note 时报 "Item not found on WMS"​

修复办法：

  1. 去 Item Code Sync。
  2. 用 Search 找那个 item code。
  3. 在 Sync 列打勾，点 Sync Now。
  4. 等 Sync Status 变 S（成功）。
  5. 回 Picking List Sync 页，勾失败的 picking note，点 Retry Failed Picking Notes。

Item 同步报 "Item Type not found"​

修复办法：

WMS BAS 的商品分类里没有这个 Item Type。

  1. 去 Item Code Sync 页，点右上角 Item Type Sync... 按钮。
  2. 在弹窗里点 Sync Now（确认对话框）。
  3. 等所有 Item Type 推过去（status 变 S）。
  4. 回主页用 Retry Failed Items 重试失败的 item。

PO 推 ASN 失败，状态卡在 'Failed'​

修复办法：

从 v1.6.4 起，AsnCreateWorker 不会自动重试 Failed 的 PO（防止打死 WMS）。

  1. 去 Sync Log 筛 Type = ASN_CREATE 找你的 PO，双击看 Response 里的错误。
  2. 修复原因（item 没在 WMS、warehouseCode 错、payload 数据问题等）。
  3. 回 PO → ASN Sync 页，Ctrl + Click 选中 Failed 的 PO，点 Retry Failed PO Pushes。
  4. 确认对话框点 Yes。

我取消了 picking note，但 WMS 还显示 "Received"​

修复办法：

  1. 取消由 CancellationWorker 异步处理（每 10 秒 poll 一次）。等 1 分钟。
  2. 还在？去 Sync Log 筛今天 + Type = ORDER_CANCEL。如果有红色 ✗，双击看 WMS 的拒绝原因。
  3. 常见拒绝原因：订单已在 Shipped 阶段，取消不了。

WMS Stage 卡在 Received，永远不进 Picking​

可能原因 + 修复：

  1. WMS 那边的 outbound mode 没配置：仓库地址、carrier 路由、packaging mode 不全。错误信息通常是 "出库模式配置异常"。找 Solution Provider 联系 WMS 团队补全。
  2. 库存不够：WMS 在等库存到位。问仓库或看 PO → ASN Sync 页是否有未到货的 PO。
  3. WMS UI 上有人手动暂停了订单：让仓库管理员检查那张单的状态。

Plugin 打开很慢 / Picking List 加载卡住​

修复办法：

如果 plugin 打开窗口或刷新数据非常慢（30 秒+），可能是 picking note 表数据量太大导致 worker SQL 死锁。

  1. 看 footer 是不是 API unreachable —— 服务自己挂了。
  2. 升级 API 到 v1.6.4 或更高 —— 它带有 schema M009 自动加上了 perf index。
  3. 还慢的话，让 Solution Provider 看看是不是 SQL Server 资源不足或锁竞争。

修复办法： 跟 WMS 通信的后台 Windows Service 没在跑。要重启那个服务（Solution Provider 操作）：

sc start WmsSyncHubApi

Footer 显示 "⚠ Mismatch"​

修复办法： 你 PC 上的 WMS Sync Hub plugin 和后台 API 服务版本不一样。

  • API 端：去 About 弹窗按 Check for Updates 自动升级到最新。
  • Plugin 端：找 Solution Provider 重新装最新的 .app。
  • 两边对齐到同一个版本号，footer 就会变绿。

"Auto-sync new" 勾了好像又没勾​

这是全局设置，不是个人的。所有在这个 AutoCount 账本里用 WMS Sync Hub 的人看到的是同一个状态。

排查顺序：

  1. 别人关了：问同事，最近有没有人点过这个开关。任何人改都会影响所有人。
  2. 打开 WMS Sync Hub 时载入慢：表格数据还没载完，开关可能暂时显示默认状态。等 "⏳ Loading..." 消失再看。
  3. 真的勾了但没起作用：确认 Start Sync 是 ON 状态。Auto-sync new 勾了但 Start Sync 没按，WMS Sync Hub 不会推任何东西。

一张 PO 在 WMS 有两张 GRN（重复了）​

v1.6.3 起这个问题已修复：每次 ASN webhook 触发 GRN 创建前会先检查是否已有 GRN（包括用户手动建的）。

如果你看到旧版本造成的重复 GRN：

  1. 在 AutoCount 里手动取消其中一张 GRN（保留正确的那张）。
  2. 升级 API 到 v1.6.3 或更高。

Sync Log 太多，DB 越来越大​

修复办法：

  1. 自动清理已经在跑（每小时一次，默认清掉 90 天前的 payload 内容，保留行）。
  2. 想立刻清：去 Sync Log 按 Ctrl + Alt + 0，选日期范围 + Type，点 Clear Payloads。
  3. 想完全删除旧记录：同一对话框里点 Delete Rows（红色，硬删除，慎用）。
  4. 调整保留天数：同一对话框里 Auto-clear payloads after [N] days。0 = 关闭自动清理。

推大批 PO 报 "URI string is too long"​

v1.6.2 起已修复 —— 一张 PO 上千行也能推。如果还碰到这个错，确认 API 升级到 v1.6.2+。