前置条件
开始用 WMS Sync Hub 之前,确保下面这些已经准备好。这些通常是 Solution Provider 一次性帮你弄好 —— 不需要你自己做,但知道一下有好处。
客户端清单
- WMS Sync Hub plugin 已安装:Solution Provider 已经把
.app装进 AutoCount,你打开 Operation 菜单时能看到 WMS Sync Hub。 - 后台 API 服务已安装:
WmsSyncHubApi是一个 Windows Service,安装在跟 AutoCount 同一台电脑(或同一局域网内)。它负责跟 WMS 通信、定时轮询、收 webhook。 - 数据库 schema 已就绪:第一次 API 启动会自动跑 migrations 建好所有
Z_Wms*表。你不用手动跑 SQL。 - WMS 账号已设定:Qian Yi WMS 给了你 partnerId 和 partnerKey,加上 customerCode 和 warehouseCode。Solution Provider 已经填到 API 的
appsettings.json里。 - Item master 干净:每个你要出货的 stock item 都应该有 Item Type(存货类别) 填好。Item Type 空白的 item 在 WMS 上会显示为 "GENERAL",没办法按类别跟踪。
自动更新机制
WMS Sync Hub 的 API 端用 WmsHubUpdater 自动更新:
- 在 WMS Sync Hub 主窗口左下角点 About
- 弹窗里点 Check for Updates
- 如果 S3 上有新版本(
latest.json),按提示下载安装即可 - 安装完 API 自动重启,schema 自动迁移
Plugin 端的 .app 文件需要 Solution Provider 帮你重新装一次(用 AutoCount 的 Plug-in Manager)。
你 不 需要操心的事
下面这些是 Solution Provider 的工作,不是你的:
- 数据库连接、SQL Server 配置、SQL 用户密码
- .NET Framework 4.8、AutoCount 2.2 SDK
- DevExpress、防火墙规则、API URL、HTTPS 证书、Cloudflare Tunnel
- WMS partner key 加密(DPAPI)、appsettings.json 配置
如果这些出问题,主窗口底部的 footer 或 Sync Log 会显示清楚的错误信息 —— 把那条信息转给 Solution Provider 就行。
备注
WMS Sync Hub 设计成可以整天开着。它不会动你的 AutoCount 单据。只会读单据、送到 WMS、再把 WMS 的状态(比如 "Shipped")写回来。