扫码验货失败排查

本文汇总扫码验货过程中可能遇到的问题，按下面步骤排查。

问题一：扫了码没反应

症状：用小程序对准箱子二维码扫描，没反应或一直停在扫码界面。

排查步骤：

1. 检查二维码：码有没有被污损、折痕、胶带挡住？如果不完整，改用手动输入箱子码
2. 调整距离：手机离二维码 15~25cm 识别效果最好
3. 检查光线：太暗或太阳直射都会影响识别，换个角度试试
4. 擦擦镜头：手机摄像头有污渍会影响扫描
5. 换个码试试：扫另一个箱子的码，看是手机问题还是这张码本身的问题

实在扫不出来，可以用页面上的「手动输入」功能，输入箱子上的唯一码

问题二：扫描后提示「无权操作」

症状：二维码能扫出来，但页面提示无法操作。

常见提示和解决办法：

提示内容	原因	怎么办
请先创建或加入团队	你还没团队	让发货方把你拉进他的团队，或自己创建一个
该发货单尚未认领	发货单还没被收货方认领	先让发货方分享给你，或者扫箱码时系统会自动认领
该发货单已被其他团队认领	这张单被别人先认了	联系发货方确认
成员已被禁用	管理元把你的权限停了	联系团队创始人恢复
发货方不能验自己的货	你是发货方，不能给自己验货	让收货方来验

问题三：手动输入箱子码提示「不存在」

症状：在手动输入页面输入箱子上的唯一码，系统提示找不到。

排查步骤：

1. 确认输入正确：核对箱子码有没有输错，注意数字 0 和字母 O、数字 1 和字母 I 的区别
2. 确认位数：箱子码是 BOX 开头加 14 位数字，总共 17 位。少了或多了都会提示不存在
3. 确认来源：箱子上的码和二维码是对应的，拍了照对照输入最保险
4. 确认发货单状态：如果发货单已取消，箱子码也会失效

建议：箱子上的码拍照保存，对照输入，不要凭记忆。

问题四：提交时网络不好

症状：填好转货结果和照片，提交时因为网络问题失败了。

解决办法：

1. 换网络：换一个信号好的无线网或手机流量
2. 重试：填好的内容不会丢，网络好了重新提交就行
3. 照片保留：如果上传失败，照片还在手机相册里，重新上传就行

提交成功之前，数据不会保存到系统。下次进来需要重新填写，所以建议在信号好的地方操作。

问题五：照片太大上不了

症状：拍照后提示图片超出大小限制。

解决：系统会自动把照片压缩到 2MB 以内。如果还是有问题：

• 检查照片格式是不是常见的 JPG 或 PNG
• 重新选照片再上传一次

一般很少遇到这个问题。

问题六：获取不到位置信息

症状：提交验货时提示「请开启定位后再提交验货」。

原因：

1. 手机定位服务没开
2. 微信没给小程序位置权限
3. 在室内 GPS 信号弱

怎么办：

1. 打开手机定位：下拉控制中心，打开位置服务开关
2. 授权小程序：在微信里进入「发现 → 小程序」，找到到可到对货，进入「设置」开启位置权限
3. 走到窗边或室外：GPS 信号会好很多
4. 重新获取位置：页面有「刷新定位」按钮，点一下重新获取

验货必须绑定位置信息，没有位置不能提交。请先解决定位问题再操作。

通用排查

码扫不出来 → 检查二维码是否清晰完整 → 手动输入箱子码
无权操作   → 检查团队和认领状态
提交失败   → 检查网络和定位 → 重试

手动输入箱子码是扫码失败时的备用方案，箱子上的码一定有用。