跳到主要内容

PO → ASN Sync

这个菜单做什么​

当你在 AutoCount 为供应商的来货建一张 Purchase Order，这个菜单告诉 WMS 准备收货（称为 "ASN" —— Advance Shipment Notice，预到货通知）。

等货真的到仓库、WMS 标记已收货之后，WMS Sync Hub 会自动在 AutoCount 建好 GRN（Goods Received Note）。不用再重新录入。

⚡ 重点先看​

已经建 GRN 就不能取消 ASN

一旦 WMS 报了收货、WMS Sync Hub 在 AutoCount 建好 GRN，Cancel Synced ASN 按钮会被挡 —— 库存已经记进 AutoCount 了，直接取消 ASN 会导致两边对不上。

真的要撤销：

  1. 先在 AutoCount 用正常方式取消 GRN。
  2. 回来这里再按 Cancel Synced ASN。
删了 PO，ASN 会自动取消

如果你在 AutoCount 里直接删掉那张 PO（或 set Cancelled = 'T'），WMS Sync Hub 会自动检测到，10 秒内帮你在 WMS 那边取消 ASN。不用手动按 Cancel Synced ASN。

但是：如果那张 PO 已经有 GRN，删 PO 的自动取消不会动 WMS（防止出现孤单货）。这种情况下要先取消 GRN 再删 PO。

v1.6.1+：跳过本地 item 检查

从 v1.6.1 起，Transfer Selected to ASN 不再先检查 item 是否在 WMS 上。客户偏好让 WMS 自己返回错误（错误信息更权威 + 实时）。

如果有 SKU 没在 WMS 上注册，WMS 会拒绝整张 ASN，错误信息会出现在 Sync Log 里（含完整 request + response payload）。

怎么用​

  1. 照常在 AutoCount 建 Purchase Order。
  2. 在左侧打开 PO → ASN Sync 菜单。
  3. 在表格里找你的 PO。可以用 Search 输入 DocNo / 供应商名 / 描述等任一关键字，按 Enter 筛选。
  4. Ctrl + Click 选中要推的 PO 行（可以一次选最多 10 张）。
  5. 点表格顶部的 Transfer Selected to ASN。
  6. 弹出确认对话框，列出要推的 PO 数量，点 Yes。
  7. 推送结果会逐张显示：
    • ✓ 成功的 PO，WMS ASN # 列填上号码
    • ✗ 失败的 PO，弹窗显示 WMS 返回的错误（INVALID_DATA、ITEM_NOT_EXISTS 等）
  8. 货真的到了以后，WMS 标记已收货，WMS Sync Hub 通过 webhook 自动建 GRN。
  9. GRN # 列会显示新 GRN 的号码。点 View 在 AutoCount 打开 GRN 原始窗口确认。
支持大单：最多 1000+ 行

从 v1.6.2 起，单张 PO 最多可以推超过 1000 行 line items（之前在 ~200 行时会因为 URI 长度限制而失败）。这个限制已被修复（绕过 FormUrlEncodedContent 的内部 cap）。

取消已同步的 ASN​

如果你推错 PO，或供应商取消来货：

  1. 在这菜单找到那张 PO 的行。
  2. 选中它（同样支持多选），点 Cancel Synced ASN。
  3. 确认对话框点 Yes。
  4. ASN 会在 WMS 上取消（worker 在 10 秒内异步处理），WMS ASN # 列清空。

前提：

  • 还没建 GRN（PODTL.TransferedQty = 0）
  • 否则会被本地的 GRN 检查拦下来，弹窗告诉你哪些 PO 被挡

Retry Failed PO Pushes​

如果某张 PO 推送失败（WMS Stage = 'Failed'），原因可能是 SKU 没在 WMS、warehouseCode 配置错、网络问题。修好之后重试：

  1. 在表格里Ctrl + Click 选中所有 Failed 状态的 PO 行（一次最多 10）。
  2. 点顶部的 Retry Failed PO Pushes 按钮。
  3. 弹出确认对话框，列出要重试的 PO 号，点 Yes。
  4. 状态从 Failed 重置为空，下一轮 AsnCreateWorker poll 会重新推。
v1.6.4 起：失败的 PO 不再自动重试

之前 AsnCreateWorker 会无限重试失败的 PO（每 15 秒一次）—— 如果 PO 数据有永久问题（item 没在 WMS、warehouseCode 错），会一直骚扰 WMS 服务器。

现在失败的 PO 会被 park 为 WmsStage = 'Failed'，不再自动重试。你必须看 Sync Log 找出原因，修复，然后用 Retry Failed PO Pushes 主动重试。

多 GRN per PO（v1.6.5+）​

WMS 收货是分批的 —— 比如 PO 订 100 EA，仓库可能：

  • 早上收 30 EA → 发一次 webhook（status=RECEIVING）
  • 下午又收 60 EA（累计 90） → 第二次 webhook（status=RECEIVING）
  • 全部收完 → 第三次 webhook（status=RECEIVED）

每次 webhook，WMS Sync Hub 都会建一张新 GRN，只含这一次新增的部分（delta），不重复入库。

WebhookWMS 累计已 bookedDelta建的 GRN
1 (RECEIVING)30 EA030GR-A 收 30 EA
2 (RECEIVING)90 EA3060GR-B 收 60 EA
3 (RECEIVED)100 EA9010GR-C 收 10 EA
4 (重传 / 同样 100 EA)100 EA1000（跳过，没新增）

总入库 = 30 + 60 + 10 = 100 EA，与 WMS 完全对齐。

Plugin 怎么显示多 GRN​

PO → ASN Sync 页面现在是 master / detail 视图：

  • Master 行：每张 PO 一行，含 GRNs 列显示该 PO 共建了几张 GRN
  • ▶ 展开：看到这张 PO 下所有 GRN 的明细
    • GRN # （带 View 按钮，点开 AutoCount 原始 GRN 窗口）
    • WMS Status（RECEIVING / RECEIVED / CLOSED — 是哪次 webhook 触发的）
    • GRN Date
    • Created By
    • Items（GRN 行数）
    • Webhook At（webhook 到达时间）

GRN 单位 = PO 单位​

WMS 用 EA（最小单位）报告收货数量，但 GRN 写入时自动换算回 PO 的 UOM（通常是 CT）：

  • WMS 收 24 EA + Rate=12 → GRN 写 2 CT
  • WMS 收 18 EA → GRN 写 1.5 CT（如果 item 允许小数）
  • UnitPrice 直接从 PODTL.UnitPrice 拷过来 —— 单位、价格、数量三者一致

重传保护（自动）​

WMS 网络抖动会重发同一个 webhook。新逻辑天然处理：

  • 同样的 cumulative qty → delta = 0 → 直接跳过，不建 GRN
  • Sync Log 里看到 delta = 0 ... nothing new to GRN 的记录就是被正确拦下的

常见问题​

  • 问：我还需要手动录入 GRN 吗？ 不用 —— WMS 一收货，WMS Sync Hub 自动建。每批货建一张 GRN。
  • 问：供应商只送了部分 PO 的货怎么办？ 自动建部分 GRN（只含已收的部分）。下次再送货会建另一张新 GRN，跟 PO 累计加起来。
  • 问：一张 PO 有多张 GRN 怎么看？ PO → ASN Sync 页面，点最左边的 ▶ 展开 → 显示该 PO 所有 GRN 的列表。
  • 问：同步 ASN 后还能改 PO 吗？ 改之前先取消 ASN（按 Cancel Synced ASN）。GRN 已经建了的话，要先在 AutoCount 取消 GRN 才能改。
  • 问：怎么看 PO 推送时 WMS 返回的具体错误？ 去 Sync Log，筛 Type = ASN_CREATE，找你的 PO 号，双击打开 View Payload 对话框，里面有完整的 request + response JSON。
  • 问：WMS 报告的数量跟实际 GRN 数量对得上吗？ 对。每张 GRN 都按 WMS 当时的 cumulative 减去之前已 booked 算 delta；GRN 保存后立刻把那段 EA 加到 PODTL.TransferedQty。下一个 webhook 算 delta 时基准已经更新，永不重复。