.jpeg)
一、【业务场景】
1、园区普遍存在多仓并存作业模式，例如同时配置冷冻仓、日配仓，多仓库均开启总提分拨业务，且不同仓库对应独立、不重复的集货位，实际作业需要按仓库区分集货点位完成分拣集货。
2、原有系统配送客户集货位能力受限，仅支持全局绑定单个集货位，集货位编码与名称唯一固定，无法针对不同仓库单独配置对应集货位，完全无法适配多仓库、多集货位的园区作业场景。
3、单一集货位绑定模式会导致跨仓库集货任务点位匹配错误、波次集货规则错乱、打印单据集货位信息不准等问题，直接影响分拣、集货、分拨出库流程的准确性与规范性，无法支撑多仓并行作业。
4、客户核心需求：重构配送客户集货位绑定模型，支持按仓库维度多集货位绑定，同仓库唯一、多仓库可多选，系统自动根据作业仓库匹配对应集货位，适配园区多仓差异化集货作业。
二、【功能介绍】
问题编号：EAR-252130
更新范围：WMS配送客户配置、WMS波次策略、WMS波次计划单、DPS打印模板、仓配App全量集货/拣货/分拨链路
限制条件：无限制
本次系统升级迭代，针对园区多仓库并行作业、客户单一集货位无法分仓匹配的痛点，全面重构客户与仓库、集货位的绑定关系，实现分仓精准匹配集货位能力。
三、【使用说明】
功能路径及详细操作
1、配送客户-集货位配置改造
功能路径：WMS - 配送客户 - 基础资料配置
配置规则升级：
1、原有规则：发货集货位仅支持全局单选，一个客户仅绑定一个集货位；
2、全新规则：支持多仓库多选集货位，同一仓库仅允许绑定一个集货位，不同仓库可分别绑定不同集货位；
3、弹窗校验：选择库位确认时，系统校验同仓库重复绑定，冲突时弹窗提示：[XX仓库1][XX仓库2]，仅允许选择一个发货集货位；
4、校验层级：前端弹窗拦截 + 后端接口唯一性双重校验，防止绕过前端直接接口违规保存。
导入覆盖规则：
批量导入集货位时，按【客户+仓库】维度判断，同仓库新集货位直接覆盖原有绑定关系，不同仓库已绑定数据保留不变；例：客户已绑定仓库1-集货位1、仓库2-集货位2，导入仓库1-集货位3后，自动覆盖为仓库1-集货位3、仓库2-集货位2。
2、波次策略与波次生成逻辑优化
1、针对波次策略中「集货位=客户绑定」「集货位=客户绑定/自动分配」两类规则统一改造；
2、波次生成时，优先读取波次策略选定仓库，从客户分仓绑定数据中精准匹配对应仓库的集货位；
3、无指定作业仓库场景，默认取仓库代码正序第一位仓库对应的集货位作为默认值。
3、波次计划单与DPS打印链路全量改造
1、重构DPS集货位获取逻辑：废弃原单一维度取值方式，打印时通过 wavePlan.storehouseNum + clientNum 双维度获取对应仓库客户集货位；
2、全量排查并统一改造所有展示、打印集货位的模板：包含DPS拣货单、箱贴、集货位排序打印逻辑；
3、保证所有纸质单据、系统展示的集货位，均与当前作业仓库、客户绑定关系完全一致。
4、仓配App全作业链路适配改造
通用规则：集货作业优先根据当前拣货/作业仓库，匹配客户对应绑定集货位作为推荐点位；若当前仓库未配置集货位，按无集货位处理，支持人工手动扫描、选择集货位。
各场景细分适配：
1、拣货集货场景：补传任务仓库参数，接口按波次/任务仓库返回对应集货位；
2、首页集货客户维度：库位校验、集货位读取统一按任务仓库+客户维度取值；
3、总提/分拨场景：已有仓库入参，直接适配新模型返回对应仓库集货位；
4、仅总提集货场景：保留原有手动扫描逻辑，无自动推荐集货位；
5、全覆盖改造所有集货入口：标准拣货跳集货、边拣边分、二次拣货、格口复核、分拨多客户总提分拨等全链路。
5、历史数据兼容规则
存量仅存在 wms_client.position_num 单集货位数据的旧客户，系统自动兼容识别为默认仓库集货位，波次生成、APP集货、单据打印均可正常取值，不会出现空值、报错、点位缺失问题。
四、【注意事项】
1、本次迭代重构客户集货位底层存储模型，由单字段存储改为多维度关联表存储，全链路接口统一改造，保证数据读写一致性。
2、系统严格遵循「同仓库唯一、跨仓库多选」规则，前后端双层校验，杜绝人工配置或接口违规写入同仓库多集货位脏数据。
3、客户导入功能采用同仓覆盖、异仓保留逻辑，批量维护数据精准可控，不会误删其他仓库已配置的集货位信息。
4、波次生成、单据打印、APP作业全场景统一按「仓库+客户」双维度取值，彻底解决多仓场景集货位匹配错乱问题。
5、无指定作业仓库时，系统自动按仓库编码正序取首位集货位，兜底规则明确，避免无数据、无推荐点位的作业卡顿问题。
6、全面兼容历史旧数据，存量单集货位客户无需手动重新配置，系统自动兜底适配，新旧业务无缝衔接。
7、覆盖所有集货、拣货、分拨、复核、打印链路，无作业场景遗漏，保障多仓并行集货作业流程标准、统一、准确。
