跳到主要内容

PDA 物料库存管理操作指南 📦

📋 功能说明​

什么是物料库存管理？​

物料库存管理是通过 PDA 查看和管理物料、赠品、包装材料等非商品类库存，支持查看库存数量和手动调整库存。

主要功能​

  • 📊 物料列表展示：显示所有物料及其库存信息
  • 💾 库存数据查看：可用库存、现货库存、待发库存
  • ✏️ 库存调整：点击物料可进入调整页面
  • 📈 统计信息：显示物料总数

与商品库存的区别​

对比项物料库存商品库存
管理对象物料、赠品、包装材料酒款商品
调整方式支持手动调整只能扫码入库/出库
溯源要求无需一物一码必须一物一码
规格管理单层结构酒款+规格两层

📱 详细操作步骤​

步骤 1：进入物料库存管理页面​

操作说明： 在 PDA 首页或菜单中点击"物料库存管理"功能。

页面显示：

  • 页面标题："物料库存管理"
  • 顶部统计信息："总物料数: X"
  • 物料列表

步骤 2：查看物料列表​

列表自动加载​

进入页面后，系统自动加载物料列表数据。

加载说明：

  • 默认加载第1页
  • 每页20条物料数据
  • 显示加载提示："加载中..."

列表项显示内容​

每个物料列表项包含：

字段名称说明数据来源
物料名称物料名称goodsName
规格信息物料规格specs
可用库存可用于出库的数量availableStock 或 stockNum
现货库存仓库实际库存总数stockNum + frozenNum
待发库存待发货的数量pendingStock（默认0）

库存数据说明：

  • 可用库存：可以用于出库的库存数量
  • 现货库存：仓库中实际的库存总数（包含可用和冻结）
  • 待发库存：已分配待发货的库存数量

显示格式：

物料名称
规格信息（如有）
可用: 100  现货: 120  待发: 20

步骤 3：查看库存详情​

查看方式： 直接在列表项中查看三个库存数值：

  • 可用库存
  • 现货库存
  • 待发库存

无需操作： 所有库存数据已在列表中完整显示，无需额外操作。

步骤 4：调整物料库存​

操作说明： 点击需要调整的物料列表项。

跳转结果：

  • 系统跳转到"库存调整"页面（BeerInventoryAdjustActivity）
  • 传递参数：
    • skuId：物料ID
    • goodsName：物料名称
    • availableStock：可用库存
    • physicalStock：现货库存
    • pendingStock：待发库存

调整页面功能：

  • 显示当前库存数量
  • 输入调整后的数量
  • 提交调整申请

调整成功后：

  • 显示调整成功提示
  • 自动返回物料列表
  • 列表数据自动刷新

📊 库存数据说明​

库存字段映射​

显示名称优先字段备用字段默认值
可用库存availableStockstockNum0
现货库存physicalStockstockNum + frozenNum0
待发库存pendingStock无0

库存计算逻辑​

可用库存：

  • 优先使用 availableStock 字段
  • 如果为空，使用 stockNum 字段
  • 都为空时显示 0

现货库存：

  • 优先使用 physicalStock 字段
  • 如果为空，计算 stockNum + frozenNum
  • 计算异常时使用 stockNum
  • 都为空时显示 0

待发库存：

  • 使用 pendingStock 字段
  • 如果为空，显示 0

数据处理规则​

  • ✅ 支持整数和浮点数格式
  • ✅ 浮点数自动转换为整数（如 "26.0" → 26）
  • ✅ null 或 "null" 视为 0
  • ✅ 解析失败时使用默认值 0

❓ 常见问题​

Q1: 页面显示"暂无物料数据"？​

可能原因：

  • 后台确实没有配置物料数据
  • 网络连接问题导致数据加载失败
  • 接口返回数据格式异常

解决方法：

  1. 检查网络连接是否正常
  2. 在后台系统确认是否有物料数据
  3. 重新进入页面刷新数据
  4. 联系技术支持

Q2: 点击物料后无反应？​

可能原因：

  • 物料的 ID 格式错误
  • 库存数据格式异常
  • 页面跳转失败
  • PDA 应用卡顿

解决方法：

  1. 确认该物料是否有有效的 ID
  2. 重新点击物料项
  3. 重启 PDA 应用
  4. 查看是否有错误提示"物料ID格式错误"
  5. 联系技术支持

Q3: 现货库存和可用库存有什么区别？​

说明：

  • 可用库存：可以立即用于出库的库存数量
  • 现货库存：仓库中实际的库存总数
  • 关系：现货库存 = 可用库存 + 冻结库存

示例：

可用库存: 100
冻结库存: 20
现货库存: 120（100 + 20）

Q4: 库存调整需要审批吗？​

答案：

  • 具体的审批流程由库存调整页面（BeerInventoryAdjustActivity）处理
  • 不同的业务场景可能有不同的审批规则
  • 详情请咨询管理员或查看调整页面说明

Q5: 为什么有些物料没有规格信息？​

原因：

  • 该物料在后台系统中未配置规格信息
  • 或 specs 字段为空

说明：

  • 这是正常现象
  • 不影响库存显示和调整
  • 规格信息仅用于辅助识别

Q6: 库存数据显示异常（负数、超大数值）？​

说明：

  • 负数会正常显示（可能是库存不足的情况）
  • 超大数值可能是数据异常

解决方法：

  1. 刷新页面重新加载数据
  2. 在后台系统检查库存数据是否正确
  3. 联系管理员核查库存数据
  4. 通过库存调整功能修正异常数据

Q7: 调整库存后列表没有更新？​

可能原因：

  • 调整操作失败
  • 列表刷新失败
  • 数据同步延迟

解决方法：

  1. 确认调整是否成功（查看提示信息）
  2. 手动退出页面重新进入
  3. 等待几秒后再查看
  4. 联系技术支持

💡 最佳实践建议​

1. 定期查看物料库存​

  • ✅ 每天或每周定期查看物料库存情况
  • ✅ 关注可用库存是否充足
  • ✅ 及时补充库存不足的物料

2. 谨慎调整库存​

  • ⚠️ 调整前确认库存数量
  • ⚠️ 输入正确的调整后数值
  • ⚠️ 必要时进行实物盘点
  • ⚠️ 记录调整原因

3. 配合实物管理​

  • ✅ 库存调整后及时整理实物
  • ✅ 保持系统数据与实物一致
  • ✅ 定期进行库存盘点
  • ✅ 发现差异及时处理

4. 数据准确性​

  • ✅ 确保调整数据准确无误
  • ✅ 避免重复调整
  • ✅ 调整后验证数据
  • ✅ 异常数据及时上报

📊 操作流程图​

📝 数据规则说明​

ID 处理规则​

  • ✅ 支持整数类型（Long、Integer）
  • ✅ 支持浮点数类型（Double），自动转换为整数
  • ✅ 支持字符串类型，自动解析
  • ✅ 浮点数字符串（如 "26.0"）自动转换为整数
  • ❌ 解析失败时提示"物料ID格式错误"

库存数值处理​

  • ✅ 支持整数和浮点数
  • ✅ 字符串类型自动解析
  • ✅ 浮点数自动转换为整数
  • ✅ null 或 "null" 转换为 0
  • ✅ 解析失败时使用默认值 0

字段为空处理​

  • 📋 物料名称为空：显示"未知物料"
  • 📋 规格为空：不显示（字段隐藏或留空）
  • 📋 库存字段为空：显示 0

📚 相关文档​

最后更新: 2025-10-07
适用版本: PDA v2.0+
文档类型: 物料库存管理操作指南