跳到主要内容

Item Code Sync

这个菜单做什么​

WMS 要先认识你的 items，才能接受 picking note 或 PO。这个菜单把 AutoCount 的 item master（stock items）推到 WMS。

把它想成把你的 items 介绍给仓库 —— 一旦 WMS 知道 "Item ABC-123 存在，长这样"，它就能接受这个 item 的订单。

⚡ 重点先看​

一个 item 最多只能有 3 种包装

WMS 只支持 EA + INP + CS 三种包装（最小件 / 内包 / 箱）。如果你 AutoCount 里一个 item 有超过 3 个 UOMs，多出来的会被丢弃。仓库的扫码流程可能跑不到那些被丢掉的包装。

精简 AutoCount 的 UOMs，只保留 3 个最重要的。

AutoCount 的 Item Type 必须先在 WMS 商品分类里存在

WMS Sync Hub 同步时会把 AutoCount 里 item 的 Item Type（存货类别） 送到 WMS，放进 WMS 的商品分类里。

  • 如果那个 Item Type 在 WMS 商品分类里不存在 → WMS 不会显示你同步过去的 item code，仿佛什么都没发生过。
  • 修法：用本页右上角的 Item Type Sync... 按钮把 AutoCount 的 Item Type 一次性推到 WMS BAS（直接建分类）。或者让仓库管理员在 WMS 网页上手动建好。
  • 如果 Item Type 在 AutoCount 里没填 → WMS 会把它放进 GENERAL 默认桶，不好跟踪。

推荐做法：第一次用时，先按 Item Type Sync... 把分类全部推过去，再开始同步 items。

怎么用​

  1. 在左侧菜单点 Item Code Sync。
  2. 用顶部的 Search 找到要推的 item（直接按 Enter = Filter）。
  3. 在那一行的 Sync 列打勾 ✓（一次最多勾 20 行）。
  4. 点顶部的 Sync Now 按钮。
  5. 弹出确认对话框列出你勾的 items，点 Yes 确认。
  6. 看 Sync Status 列：
    • N = 待同步（还没推）
    • S = 已同步成功
    • E = 出错（鼠标移到上面看错误信息）
提示

一次勾多个 item 一起推。上限 20 行 —— 防止一次推太多打到 WMS API 速率限制。

警告

所有 Sync Now 按钮都会弹出确认对话框。这是为了防止误推。仔细看清楚要推的清单再点 Yes。

Auto-sync new（自动同步开关）​

页面顶部的 Auto-sync new 勾上后，AutoCount 里新建的 item 会自动加进队列、由 worker 推到 WMS（前提：Start Sync 是 ON 状态）。已经存在的 item 不受影响 —— 那些还是要手动勾 + Sync Now。

Retry Failed Items —— 重试失败的​

如果某些 item 同步出错（Sync Status = E），原因可能是网络抖动、WMS 暂时挂了、或 Item Type 没在 WMS 上建好。修好原因之后，重试这些失败的 item：

  1. 在表格里勾选所有失败行的 Sync 列（一次最多 20）。
  2. 点顶部的 Retry Failed Items 按钮。
  3. 弹出确认对话框列出要重试的 items，点 Yes。
  4. 状态从 E 重置为 N，下一轮 worker poll 会重新推。
备注

Retry Failed 只动你勾选的且状态为 E 的行。没勾的、或状态 = N / S 的，完全不会被影响。

顶部的三个辅助按钮​

Item Code Sync 页右上方还有三个特殊按钮：

Push UOM (focused)​

  • 作用：单行触发 —— 把当前光标所在那一行的 UOM 名称（比如 UN / CT）推送到 WMS BAS，覆盖 packagingList 里的描述。
  • 什么时候用：这个 item 的 UOM 名字在 WMS 上不对，或者第一次推完之后想补 UOM 描述。
  • 前提：这个 item 必须已经同步过（LastSyncDate 不为空）。

Item Type Sync...​

  • 作用：打开 Item Type Sync 弹窗。把 AutoCount 的 Item Type（存货类别）批量推到 WMS BAS，建为 SKU category。
  • 里面的 Sync Now 按钮会弹确认对话框，确认后会把所有 status ≠ S 的 Item Type 一起 queue 给 worker 处理。

UOM Names Sync...​

  • 作用：打开 Push UOM Names to WMS 弹窗。Phase 2 的批量同步 —— 把所有还没推过 UOM 描述的 item，一个一个调 BAS API 补上。
  • 有 master switch（开关）控制是否启用；默认是 OFF（opt-in）。
  • 用前先确认 BAS 凭证已配置好。

同步过去之后，在 WMS 上长什么样？​

你 AutoCount 的 items 可以有任意多个 UOMs —— UN、CT、PK、BX、BD 等等。WMS 只认 3 种包装：

WMS 包装中文意思
EA单件 / 散装最小单位，一个货品
INPInner Pack内包（一般是几个 EA 装一袋）
CSCase / Carton箱（最大的包装，整箱）

所以同步时，WMS Sync Hub 会把你 AutoCount 的 UOMs 映射成 WMS 这 3 种包装。规则是：

  1. Rate = 1 的那一行 → EA（base unit，WMS 必须要有）
  2. UOM = 'CT' 的那一行 → CS（箱）
  3. 其他所有 UOMs → INP（内包）

真实例子​

假设你 AutoCount 里的 item 113005 有 3 个 UOMs：

AutoCount UOMRate意思
UN11 UN = 1 件
CT41 CT = 4 件
PK61 PK = 6 件

同步后，WMS 上这个 item 的包装结构会是：

WMS 包装pcsQty（含几个 EA）从哪里来
EA1从 UN（Rate=1）
INP6从 PK（规则 3，其他）
CS4从 CT

各自的 barcode 也会跟着送过去 —— 如果 AutoCount 里该 UOM 有填 BarCode，WMS 上这个包装就能用那个条码扫。

各种情况会变什么​

你 AutoCount 里有WMS 上会有会不会丢?
只有 UN (Rate=1)只有 EA✅ 全保留
UN + CT（最常见）EA + CS✅ 全保留
UN + CT + PKEA + INP + CS✅ 全保留
UN + PK（没 CT）EA + INP，没 CS✅ 全保留（CS slot 留空）
UN + PK + BX（两个非 CT）EA + INP（PK 占，BX 被丢）⚠️ BX 被丢弃
没 ItemUOM 记录只有 EA，pcsQty=1 占位⚠️ 包装信息丢失

常见问题​

  • 问：可以把 item 从 WMS 删掉吗？ 不行 —— item 一旦上了 WMS 就留下了。你只需要停止送用到它的单。用不到了就在 AutoCount 里把它设为停用。
  • 问：如果我忘了同步 item 就去推 picking note 会怎样？ Picking note 会失败，错误为 "item not found on WMS"。去 Item Code Sync 勾上缺的 item，按 Sync Now，等它变 S，再回去重新同步 picking note。
  • 问：item 描述改了要重新同步吗？ Worker 会自动检测 AutoCount 里 Item.LastModified > LastSyncDate 的 item，下一轮 poll 自动重推。不用手动操作。