跳到主要内容

PDA 一物一码查询操作指南 🔍

📋 功能说明​

什么是一物一码查询？​

一物一码查询是通过 PDA 扫描或产品二维码，实时查询该码的全链路溯源信息、进行作废标签和转赠操作的功能。

主要功能​

  • 🔍 溯源查询：查看产品信息、批次信息、入库状态、出库记录、核销记录、扫码历史
  • ❌ 作废标签：将未核销的二维码标记为失效，使其无法再被使用
  • 🎁 转赠操作：将未核销的产品转赠给其他用户，并记录转赠原因
  • ↩️ 撤销核销：撤销已核销二维码的核销状态，恢复为未核销
  • 🔄 撤销转赠：取消已转赠的状态，恢复为正常可用状态

📱 详细操作步骤​

步骤 1：进入一物一码查询页面​

操作说明： 在 PDA 首页点击"一物一码"功能卡片。

步骤 2：输入或扫描二维码​

系统提供输入方式：

方式一：硬件按键扫码（推荐）​

操作说明：

  1. 进入页面后，扫码器自动激活
  2. 对准产品二维码
  3. 按下 PDA 设备的硬件扫码按键
  4. 系统自动识别并填入 SKU 码
  5. 自动执行查询

优点：

  • 快速便捷
  • 自动查询，无需手动点击

方式二：手动输入​

操作说明：

  1. 点击输入框
  2. 手动输入或粘贴 SKU 码
  3. 点击"查询"按钮

支持的输入格式：

  • 纯 SKU 码：例如 25090385200038
  • 完整 URL：例如 https://XXX/t/XXX/scan?skuSn=25090385200038
  • 带 @ 前缀：例如 @25090385200038

说明：系统会自动从 URL 中提取 skuSn 参数。

步骤 3：查看溯源信息​

查询成功后，系统会自动折叠输入区域，显示详细的溯源信息。

📦 产品信息卡片​

字段名称说明
产品名称商品完整名称
品牌所属品牌
规格产品规格，如：500ml×12瓶
产品类型商品类型/风格

📅 批次信息卡片​

字段名称说明
批次号生产批次编号
生产日期产品生产日期
入库状态显示入库时间和操作员，或提示"未入库（请先执行入库）"

入库状态说明：

  • 未入库：显示为 "未入库（请先执行入库）"
  • 已入库：显示为 "已入库：2025-01-07 14:30:00（操作员：张三）"

📤 出库信息卡片​

字段名称说明
出库时间产品出库的时间
售达方出库客户名称（渠道商/门店） + 城市
出库操作员执行出库操作的人员

✅ 核销信息卡片​

字段名称说明
核销时间首次核销时间
核销城市核销所在城市
核销状态未核销 / 已核销 / 已失效
奖励积分核销获得的积分
扫码次数总扫码次数
门店名称核销门店名称

核销状态说明：

  • 🟡 未核销（status=0）：二维码尚未被用户扫码核销
  • 🟢 已核销（status=1）：二维码已被用户扫码核销
  • 🔴 已失效（status=2）：二维码已作废，无法使用

🎁 转赠信息卡片（条件显示）​

显示条件：仅当二维码处于"已转赠"状态时显示

字段名称说明
转赠时间转赠操作时间
转赠操作员执行转赠的操作人员
转赠原因转赠原因说明

❌ 作废信息区域（条件显示）​

显示条件：仅当二维码处于"已失效"状态且为人工作废时显示

字段名称说明
操作时间作废操作时间
操作人执行作废的操作人员

📜 扫码历史记录​

显示该二维码的所有扫码记录，包括：

  • 扫码时间
  • 门店名称
  • 扫码城市
  • 扫码状态

步骤 4：执行操作​

查询成功后，页面底部会显示操作按钮，根据二维码的当前状态不同，显示的按钮也不同。

🟡 未核销状态（status=0，未转赠）​

显示按钮：

  • 作废二维码：将二维码标记为失效
  • 转赠：将产品转赠给其他用户

操作说明：见下方"作废二维码"和"转赠操作"详细步骤

🟢 已核销状态（status=1，未转赠）​

显示按钮：

  • 撤销核销：撤销核销状态，恢复为未核销

操作说明：见下方"撤销核销"详细步骤

🎁 已转赠状态（extendedStatus=3）​

显示按钮：

  • 撤销转赠：取消转赠状态

操作说明：见下方"撤销转赠"详细步骤

🔴 已失效状态（status=2）​

显示按钮：

  • 无操作按钮（已失效的二维码无法再进行任何操作）

❌ 作废二维码操作​

功能说明​

将未核销的二维码标记为失效，使其无法再被用户扫码核销。

适用场景​

  • 产品损坏无法销售
  • 产品过期需要下架
  • 标签印刷错误需要重新打印
  • 其他需要使二维码失效的情况

操作前提​

  • ⚠️ 仅限未核销状态（status=0）
  • ⚠️ 未转赠（extendedStatus ≠ 3）
  • ⚠️ 此操作不可逆，作废后无法恢复

详细步骤​

步骤 1：点击"作废二维码"按钮​

在查询结果页面底部，点击"作废二维码"按钮。

步骤 2：确认作废操作​

系统弹出确认对话框：

对话框标题：确认作废二维码

对话框内容：

⚠️ 警告：作废后该二维码将无法使用，此操作不可逆！

请确认是否要继续作废操作？

操作选项：

  • 确认作废：继续执行作废操作
  • 取消：放弃作废操作

步骤 3：执行作废​

点击"确认作废"后，系统调用后端接口执行作废操作。

步骤 4：查看作废结果​

作废成功：

  • 显示"作废成功"提示
  • 自动刷新查询结果
  • 核销状态更新为"已失效"
  • 显示作废信息区域（作废时间、作废操作员）
  • 底部操作按钮全部隐藏

作废失败：

  • 显示"作废失败"或具体错误信息
  • 可以重新尝试作废操作

🎁 转赠操作​

功能说明​

将未核销的产品转为赠品，并记录转赠原因。转赠后，二维码状态会更新为"已转赠"。

适用场景​

  • 活动赠送给客户
  • 售后补发给用户
  • 其他转赠场景

操作前提​

  • ⚠️ 仅限未核销状态（status=0）
  • ⚠️ 未转赠（extendedStatus ≠ 3）

详细步骤​

步骤 1：点击"转赠"按钮​

在查询结果页面底部，点击"转赠"按钮。

步骤 2：进入转赠页面​

系统跳转到转赠操作页面。

页面显示：

  • 页面标题："转赠"
  • SKU 码显示
  • 转赠原因选择
  • 确认按钮

步骤 3：选择转赠原因​

预设选项（下拉选择）：

  • 活动赠送
  • 售后补发
  • 其他

自定义输入：

  • 如果预设选项不满足需求，可以在输入框中自定义输入转赠原因
  • 自定义输入的原因会覆盖预设选项

步骤 4：确认转赠​

检查信息无误后，点击"确认转赠"按钮。

步骤 5：查看转赠结果​

转赠成功：

  • 显示"转赠成功"提示
  • 自动返回查询页面
  • 查询结果自动刷新
  • 显示转赠信息卡片（转赠时间、操作员、原因）
  • 底部显示"撤销转赠"按钮

转赠失败：

  • 显示"转赠失败"或网络异常提示
  • 可以重新尝试转赠操作

🔄 撤销转赠操作​

功能说明​

取消已转赠的状态，恢复为正常可用状态。

操作前提​

  • ⚠️ 仅限已转赠状态（extendedStatus=3）

详细步骤​

步骤 1：点击"撤销转赠"按钮​

在查询结果页面底部，点击"撤销转赠"按钮。

步骤 2：进入撤销转赠页面​

系统跳转到撤销转赠操作页面。

页面显示：

  • 页面标题："撤销转赠"
  • SKU 码显示
  • 撤销按钮
  • 不显示转赠原因输入（撤销时不需要原因）

步骤 3：确认撤销​

点击"撤销转赠"按钮。

步骤 4：查看撤销结果​

撤销成功：

  • 显示"撤销转赠成功"提示
  • 自动返回查询页面
  • 查询结果自动刷新
  • 转赠信息卡片隐藏
  • 恢复显示"作废"和"转赠"按钮

撤销失败：

  • 显示"撤销转赠失败"或网络异常提示
  • 可以重新尝试撤销操作

↩️ 撤销核销操作​

功能说明​

撤销已核销二维码的核销状态，恢复为未核销状态。

适用场景​

  • 误操作导致核销错误
  • 需要重新核销
  • 其他需要撤销核销的情况

操作前提​

  • ⚠️ 仅限已核销状态（status=1）
  • ⚠️ 未转赠（extendedStatus ≠ 3）

详细步骤​

步骤 1：点击"撤销核销"按钮​

在查询结果页面底部，点击"撤销核销"按钮。

步骤 2：确认撤销操作​

系统弹出确认对话框：

对话框标题：撤销核销

对话框内容：确认要撤销该二维码的核销状态吗？

操作选项：

  • 确认：继续执行撤销操作
  • 取消：放弃撤销操作

步骤 3：执行撤销​

点击"确认"后，系统调用后端接口执行撤销核销操作。

说明：系统会使用 skuSn 自动查找最新的核销记录进行撤销。

步骤 4：查看撤销结果​

撤销成功：

  • 显示"撤销成功"提示
  • 自动刷新查询结果
  • 核销状态更新为"未核销"
  • 底部显示"作废"和"转赠"按钮

撤销失败：

  • 显示"撤销失败"或网络异常提示
  • 可以重新尝试撤销操作

🔄 其他操作​

折叠/展开输入区域​

功能说明：

  • 查询成功后，输入区域会自动折叠，为结果展示腾出空间
  • 点击折叠后的头部可以重新展开输入区域

操作说明：

  1. 查询成功后，输入框区域自动折叠为一个简洁的头部
  2. 点击折叠的头部，输入区域会重新展开
  3. 展开后输入框自动获得焦点，方便继续输入

优点：

  • 节省屏幕空间
  • 提升结果展示体验
  • 方便快速切换查询

❓ 常见问题​

Q1: 输入 SKU 码后提示"查询失败"？​

可能原因：

  • SKU 码输入错误
  • 该二维码不存在
  • 网络连接问题
  • 后端服务异常

解决方法：

  1. 检查 SKU 码是否正确
  2. 重新扫描二维码
  3. 检查网络连接
  4. 稍后重试
  5. 联系技术支持

Q2: 为什么"作废二维码"按钮是灰色的？​

原因：

  • 二维码已核销（status=1）
  • 二维码已失效（status=2）
  • 二维码已转赠（extendedStatus=3）

解决方法：

  • 只有"未核销"且"未转赠"的二维码才能作废
  • 如需作废已核销的二维码，需先"撤销核销"
  • 如需作废已转赠的二维码，需先"撤销转赠"

Q3: 作废后能否恢复？​

答案：

  • ❌ 不能
  • 作废操作是不可逆的
  • 作废前系统会显示警告提示
  • 请谨慎操作

Q4: 转赠后二维码还能使用吗？​

答案：

  • 转赠后，二维码状态更新为"已转赠"（extendedStatus=3）
  • 转赠状态不影响二维码的正常使用
  • 赠品无法参与累计活动，但是可以获得积分
  • 转赠只是记录了产品的流转信息
  • 如需取消转赠，可点击"撤销转赠"

Q5: 硬件扫码按键无反应？​

可能原因：

  • 扫码器未初始化成功
  • 扫码器连接断开
  • PDA 设备故障

解决方法：

  1. 重新进入页面，让扫码器重新初始化
  2. 使用页面上的"扫码"按钮代替硬件按键
  3. 重启 PDA 设备
  4. 联系设备管理员检查设备

Q6: 查询结果显示"未入库"怎么办？​

说明：

  • 该二维码对应的产品尚未执行入库操作
  • 这是正常现象，不影响查询和其他操作

处理方法：

  • 如果产品已物理入库，请到"扫码入库"页面执行入库操作
  • 如果产品尚未入库，无需处理

Q7: 撤销核销提示"请先查询二维码"？​

原因：

  • 当前页面没有查询到有效的二维码信息
  • qrcodeId 未获取到

解决方法：

  1. 重新扫描或输入 SKU 码
  2. 点击"查询"按钮
  3. 等待查询结果显示后再进行操作

📊 操作流程图​

📝 操作规则说明​

作废规则​

  • ⚠️ 只有"未核销"（status=0）且"未转赠"的二维码可以作废
  • ⚠️ 作废操作不可逆，执行前会显示警告对话框
  • ⚠️ 作废后二维码状态更新为"已失效"（status=2）
  • ⚠️ 作废信息会记录操作时间和操作人员

转赠规则​

  • ✅ 只有"未核销"（status=0）且"未转赠"的二维码可以转赠
  • ✅ 转赠时必须填写转赠原因
  • ✅ 转赠后状态更新为"已转赠"（extendedStatus=3）
  • ✅ 转赠信息会记录操作时间、操作人员和转赠原因
  • ✅ 转赠后的二维码可以撤销转赠

撤销核销规则​

  • ✅ 只有"已核销"（status=1）且"未转赠"的二维码可以撤销核销
  • ✅ 撤销时会自动查找最新的核销记录
  • ✅ 撤销成功后状态恢复为"未核销"（status=0）

撤销转赠规则​

  • ✅ 只有"已转赠"（extendedStatus=3）的二维码可以撤销转赠
  • ✅ 撤销转赠时不需要填写原因
  • ✅ 撤销成功后恢复为正常可用状态

📚 相关文档​

最后更新: 2025-10-07
适用版本: PDA v2.0+
文档类型: 一物一码查询操作指南