一、【业务场景】

1、现有司机小程序、TMS入仓预约申请无地理位置距离校验机制，司机无需抵达厂区即可任意提交入仓预约。

2、大量司机存在未发车、未抵达厂区提前扫码预约的虚假预约行为，虚假预约数据过多，严重扰乱仓库收货排班计划、占用预约名额、打乱现场入仓作业秩序。

二、【功能介绍】

问题编号：EAR-253351

更新范围：WMS标准收货参数、TMS/小程序入仓申请提交流程

限制条件：无限制

本次系统升级迭代，为解决司机远距离虚假预约、预约数据失真、仓库排班混乱的问题，新增入仓申请距离管控参数及定位校验能力

三、【使用说明】

功能路径及详细操作

1、WMS-标准参数-收货参数新增配置

功能路径：WMS - 标准参数 - 收货参数配置页面

新增参数：入仓申请距离限制 N Km

参数规则：

1、默认状态：数值为空，默认不限制入仓申请距离；

2、数值规则：仅支持输入正整数；数值为空、0、未开启参数，均不做距离校验；

3、参数生效后，全量司机入仓申请统一应用该距离管控规则。

2、TMS/小程序入仓申请提交校验逻辑。

场景一：参数未开启/数值为0/空

系统无需获取定位、无需距离校验，直接放行，正常提交入仓申请，完全兼容旧逻辑。

场景二：参数开启且设置有效公里数

1、未授予小程序定位权限：直接拦截提交，弹窗提示【请开启小程序位置权限后重试提交】，无法生成入仓申请单据；

2、已授予定位权限：系统读取司机实时定位坐标，自动计算当前位置与目标仓库直线距离；

3、距离在参数设定范围内：校验通过，正常提交入仓申请；

4、距离超出设定范围：拦截提交，弹窗提示【入仓申请距离限制 N Km！无法提交入仓申请单据】。

四、【注意事项】

1、参数未设置，不影响历史司机预约作业流程，上线无业务影响，可按需开启管控。

2、距离校验为目标仓库直线距离核算，仅用于预约准入管控，不影响后续到仓签到、收货流程规则。

3、严格校验定位权限，杜绝无定位、虚假定位预约请求，从源头减少无效虚假预约。

4、参数仅支持正整数配置，保证管控公里数规范统一，避免非法数值导致校验异常。

5、开启距离限制后，仅近距离真实到厂司机可提交预约，有效净化仓库预约数据、规范现场入仓秩序、优化仓库排班准确率。