什么是凭证视频批量直传

在承信租的实际仓储作业中，仓库发货打包和用户归还拆箱质检每天都会产生大量的录像视频。这些视频是处理用户售后争议、设备外观定损、违约索赔的重要依据。

过去管理员需要逐个找到订单、打开凭证弹窗手动选择视频上传，效率低下且容易占满服务器带宽。 凭证视频批量直传与自动绑定功能专为仓储发货与归还质检设计：

• 不占服务器带宽：视频直接从仓库电脑直传至云存储，百兆大视频秒级直达；
• 自动识单与场景判定：只要视频文件名以快递单号开头，系统自动识别是发货还是归还并精准关联订单；
• 整文件夹一次导入：支持直接选择电脑上的整个视频文件夹，自动扫描所有子目录；
• 原文件安全清理：绑定成功的本地录像文件支持一键确认批量删除，释放仓库电脑磁盘空间。

---

视频准备与命名规范（核心前提）

系统识别订单完全依靠视频文件名。仓库人员录制或导出视频后，必须遵循以下命名规则：

1. 文件名命名公式

[快递物流单号]_[任意备注].mp4

即：首个下划线 _ 前面必须是完整的快递单号。

2. 命名示例对照

视频文件名	是否合法	系统解析结果	说明
SF5156050594926_20260917.mp4	合法	单号：SF5156050594926	最标准的规范命名
787899887766_iPhone15发货验机.mp4	合法	单号：787899887766	下划线后可带中文备注
JT305888999111_01.mp4	合法	单号：JT305888999111	常见打包台录像编号
SF5156050594926.mp4	❌ 非法	无法解析	缺少下划线 _ 分隔符
_SF5156050594926.mp4	❌ 非法	无法解析	下划线前单号为空
验机视频_SF5156050594926.mp4	❌ 错误	单号解析为验机视频	单号必须位于首个下划线前面
SF5156050594926_01.mov	❌ 非法	格式不支持	仅支持 .mp4 格式

3. 文件规格与格式限制

• 文件格式：仅支持 .mp4 视频文件（其他格式请先在本地转码）；
• 文件大小：单个视频文件最大支持 1GB（1,000,000,000 字节）；
• 命名安全：文件名长度不得超过 128 字符，严禁包含斜杠（/、\）或英文双引号（"）。

---

系统自动匹配与订单判定规则

当视频导入后，系统会用提取出的快递单号同时检索系统中的发货订单和归还订单：

1. 发货场景（自动发货）判定条件

• 订单状态为：已发货（待收货） 或 已收货（租用中）；
• 订单已审核通过且合同已签署；
• 订单尚未发起归还；
• 订单的发货快递单号与视频单号完全一致。

2. 归还场景（自动归还）判定条件

• 订单状态为：已完成 或 待归还；
• 订单处于待接收质检状态（lease_status = 6）；
• 客户填写的归还物流单号与视频单号完全一致。

3. 三种匹配状态及处理方式

[导入视频] ──解析单号──► 查询匹配订单
                           │
                           ├─► 刚好命中 1 笔订单 ──► 【绿标·自动匹配】 ──► 可直接批量上传
                           │
                           ├─► 命中 0 笔订单 ────► 【灰标·0 命中】   ──► 严禁绑定，请核对单号
                           │
                           └─► 命中多笔订单 ────► 【橙标·多单冲突】 ──► 人工选定待接收归还订单

匹配状态标签	业务含义	运营处理措施
自动发货 / 自动归还	单号在系统中唯一锁定了一笔发货单或归还单	无需人工干预，直接点击开始批量上传即可。
多单冲突需选	同一个快递单号命中了多笔订单（如客户同一包裹合并归还了多部手机）	点击操作栏中的**「选择归还订单」**，在弹窗中选择本次质检对应的具体订单。
0 命中未匹配	系统中没有任何符合条件的订单匹配该单号	系统严禁人工随意挂靠订单（防止仓管错挂影响追偿）。请检查快递单号是否录错，或者走素材中心单独处理。
格式错误	文件名不合规、非 MP4 或超 1GB	鼠标悬浮查看具体原因，在本地修改文件名或转码后重新导入。

---

详细操作步骤指南

第一步：进入功能入口

登录承信租后台管理系统，进入 订单管理 -> 租赁订单。 在订单列表顶部的操作按钮区，点击 「凭证视频上传」 按钮，打开批量直传管理弹窗。

💡 提示：如果页面未显示该按钮，请联系总管理员为您分配 admin-leaseOrder-voucherVideoUpload 权限。

第二步：导入本地视频

弹窗顶部提供了两种选择文件方式：

1. 「导入文件夹」（推荐）：
   • 点击后选择存放质检视频的文件夹；
   • 系统会自动递归遍历该文件夹及其所有子目录，把里面的全部 .mp4 文件提取出来；
   • 特别适合将打包台一整天的录像文件夹一键载入。
2. 「选择视频文件」：
   • 支持按住 Ctrl 或 Shift 键在弹出的文件窗口中批量多选视频。

第三步：核对匹配结果与人工选单

文件载入后系统会自动触发批量匹配（单批次最多支持 100 个视频）：

1. 观察表格顶部的统计看板：确认“自动匹配”、“已选归还”、“冲突待选”、“0 命中”的数量；
2. 若存在 橙色「多单冲突需选」：
   • 点击对应行的 「选择归还订单」；
   • 在弹出的候选窗口中，核对订单编号与下单时间，点击 「选择」 并确认；
   • 该项状态会转变为蓝色的 「人工归还」，进入待上传队列；
3. 对于无需处理的 0 命中项或格式错误项，可点击右侧的 「移除」 将其移出列表。

第四步：执行批量上传与绑定

点击弹窗右下角 「开始批量上传与绑定」：

1. 并发调度：系统会自动以 3 个视频同时直传的流水线队列运行，不会造成浏览器卡死；
2. 直传阶段（10% ~ 95%）：进度条显示实时上传进度；
3. 绑定阶段（98% ~ 100%）：直传完成后，服务端会对云端文件进行真实视频格式核验，并自动写入订单凭证记录。

⚠️ 网络中断与重试： 若某个视频因为网络抖动直传失败，状态会显示为红色，并提供 「重试」 按钮（单任务最多支持重试 3 次）。

第五步：批量清理本地原文件（可选）

当所有任务均已上传并成功绑定后，弹窗左下角会亮起红色按钮： 「批量删除已绑定的本地原视频 (N个)」：

1. 点击按钮，系统会弹出二次防误删确认对话框；
2. 浏览器会提示授予文件修改/删除权限，点击 「允许」；
3. 系统将仅删除已成功绑定的本地文件；所有未匹配、冲突或失败的原文件会被严格保留；
4. 彻底解决仓库质检电脑磁盘每天被大视频占满需要手动挑着删文件的痛点。

---

凭证查看与多端呈现

1. 后台订单列表查看

在租赁订单列表中，点击对应订单的 「发货图片」 或 「收货图片」：

• 批量直传的视频会自动聚合展示在凭证弹窗中；
• 鼠标悬停可查看其录制时的原始文件名与快递单号；
• 防误删保护：直传生成的凭证视频不会显示删除红叉，防止客服日常编辑时误删。

2. 移动端客户查看

租赁用户在手机小程序端的订单详情页中，点击查看发货凭证或归还凭证，可直接在线播放对应的发货打包视频或归还验机视频，流程透明可信。

---

常见问题与排错手册（FAQ）

Q1：为什么提示“0 命中未匹配”且不能人工选单？

• 原因：单号在系统中完全找不到对应订单，或者该订单既不是发货状态（如未支付、已取消），也不是待质检归还状态（如尚未申请归还）。
• 对策：
  1. 检查文件名首个下划线前的快递单号是否有多输、漏输字符；
  2. 确认系统中的订单是否已经发货或用户已提交归还单号；
  3. 若确属特殊异常件，请通过原有订单详情的素材中心进行单独补录。

Q2：提示“冲突且无待接收归还订单”是什么意思？

• 原因：同一个快递单号命中了多笔发货中订单（例如商家同一天拆单发了两个包裹但填了相同单号）。
• 对策：发货场景不支持人工盲猜消解，系统为了资金安全会阻断自动关联。请在订单详情页手动上传。

Q3：为什么点击删除本地原文件提示“权限拒绝”？

• 原因：部分现代浏览器（如 Chrome、Edge）出于安全考虑，删除本地电脑文件前必须获得用户的明确授权。
• 对策：在浏览器弹出的“是否允许网站修改此文件夹/文件”提示窗中点击 「允许」 或 「保存更改」。如果使用了 360 浏览器等极速模式未放行，可改用 Chrome 官方浏览器。

Q4：提示“已被同一任务先一步绑定”？

• 原因：同一个人或同事已经在另一台电脑上上传了同名视频且绑定成功。
• 对策：系统检测到了完全相同的业务凭证，自动判定为已完成并跳过，不会产生重复扣费或重复凭证。