HPK 代理仓使用说明
更新时间：2026-06-04
1. 配置要点
1.1 新增 HPK 系统
菜单路径：GWMS-代理仓-代理仓系统
- 点击【新增】
- 填写【系统名称】
- 【系统类型】选择 HPK（Hipacking）
- 填写 HPK 提供的接入配置：
- 接口地址
- 登录账号
- 登录密码
- 版本号（填写 5）
- 点击【确定】
测试环境地址： http://test.hipacking.cn
1.2 配置仓库映射（重要）
菜单路径：GWMS-代理仓-代理仓系统-仓库
必须配置 4 项：
- 代理仓代码
- GWMS 仓库代码
- 虚拟上架库位（存放 HPK 合格品）
- 残品库位（存放 HPK 残品）
❗ 如果缺少专用库位配置：
- 入库只能收货，无法上架
- 无法触发库存同步
1.3 HPK 库存数量说明
HPK 返回的库存包含两部分：
- 可用库存：可以分配出库的数量
- 锁定库存：已分配但未出库的数量
重要：总库存 = 可用库存 + 锁定库存
❌ 错误理解：只看可用库存 ✅ 正确理解：可用 + 锁定 = 总库存
举例：
- HPK 显示：可用 80，锁定 20
- 实际总库存：100（不是 80）
2. 日常使用
2.1 入库业务
- GWMS 创建入库单
- 系统自动推送到 HPK
- 到《同步任务》查看任务状态
- HPK 处理完成后，GWMS 自动收货和上架
注意：
- 推送后需要等待 HPK 处理完成
- 如果任务一直等待中，属于正常情况
- 只有缺少专用库位时，才会无法上架
2.2 出库业务
HPK 出库分两类：
- 一件代发：直接发给客户，不支持取消
- 备货中转：发到中转仓，支持取消
流程：
- GWMS 创建出库单
- 系统自动推送到 HPK
- 到《同步任务》查看任务状态
2.3 库存同步
触发方式：
- 在仓库映射页面点击【同步库存】
- 系统每 12 小时自动执行一次
执行内容：
- 先完成同仓未完成的入库/出库任务
- 从 HPK 拉取库存快照
- 自动修正本地库存差异
- 保存库存快照
查看结果： 到《同步任务》查看库存同步任务详情。
注意：
- 只修正虚拟上架库位和残品库位
- 库存同步任务一次性完成，不需要等待
3. 常见问题
3.1 "未配置虚拟上架库位"
**原因：**仓库映射配置不完整
处理：
- 到《代理仓系统》查看仓库映射
- 检查是否配置了虚拟上架库位和残品库位
- 补齐缺失配置
3.2 "客户未开户，无法收货"
**原因：**本地客户资料不满足收货条件
处理：
- 到《同步任务》查看错误详情
- 确认客户的开户状态
- 检查客户是否绑定了对应仓库
- 修正后点击【立即同步】
3.3 "系统配置异常"
**原因：**系统类型或配置错误
处理：
- 确认【系统类型】是否选择了 HPK
- 确认仓库映射是否已建立
- 确认接口地址、账号、密码是否正确
- 到《日志》查看错误详情
3.4 "SKU 同步失败"
**原因：**GSKU 基础资料不完整
处理：
- 到代理仓系统的【sku】页面查看异常
- 检查 GSKU 的必填信息（名称、规格、重量等）
- 补齐后点击【重新同步】
3.5 任务一直在等待中
**原因：**HPK 还在处理，或配置有问题
处理：
- 先查看【执行摘要】是否有错误
- 如果显示"等待处理"，继续等待即可
- 如果超时未完成，到《日志》查看详情
- 必要时联系 HPK 确认处理状态