一、【业务场景】

1、客户存在门店地址与仓库实际配送地址不一致的业务场景，管理中心上游修改门店资料地址后，会自动同步覆盖 WMS 配送客户地址。因仓库实际配送作业地址与门店注册地址通常不统一，导致下游配送地址频繁被错误覆盖，影响正常配送作业。

2、现有系统参数「配送客户启用自定义名称」仅对客户名称字段生效，地址字段不受参数管控，始终强制跟随上游自动同步。系统名称、地址同步管控粒度不一致，无法满足客户「名称跟随上游同步、地址下游独立维护」的差异化业务需求。

3、地址无自定义锁定能力，下游无法独立维护、导入修改配送地址，每次上游门店资料变更都会造成配送地址错乱，人工反复修正成本高、数据稳定性差。

4、客户核心需求：参照现有自定义名称逻辑，扩展系统参数支持自定义地址开关，实现地址同步可控；支持下游手动编辑、导入维护配送地址，彻底阻断上游无感知覆盖问题，保证配送地址贴合实际作业场景。

二、【功能介绍】

问题编号：EAR-256850

更新范围：WMS系统参数、新WMS配送客户明细页面、配送客户导入模板、客户主动/自动同步逻辑

限制条件：无限制

本次系统升级迭代，针对配送客户地址跟随上游强制同步、无法独立维护、字段管控粒度不一致等痛点，基于原有自定义名称参数架构，扩展自定义地址管控能力，实现名称、地址分开可控同步。

三、【使用说明】

功能路径及详细操作

1、WMS系统参数扩展配置

功能路径：WMS - 系统参数

1、原有参数「配送客户启用自定义信息」新增「地址」可勾选选项；

2、参数为多选模式，「名称」「地址」选项相互独立、不互斥，可单独开启或同时开启；

3、新增选项默认不勾选，完全沿用历史同步逻辑，存量业务无感知兼容。

2、参数【地址未勾选】逻辑（默认原生逻辑）

1、配送客户明细页面：地址字段禁止手动编辑；

2、上游自动同步：上游门店地址、经纬度修改后，下游配送客户地址、经度、纬度自动同步更新；

3、导入模板：地址字段不允许导入修改，系统自动忽略导入的地址内容；

4、客户同步操作：主动同步、自动同步均包含地址字段，正常跟随上游同步。

3、参数【地址勾选】逻辑（自定义维护逻辑）

1、配送客户明细页面：地址字段开放手动编辑权限，支持下游自主维护实际配送地址；

2、上游自动同步：上游门店地址、经纬度变更后，下游地址、经度、纬度不再自动覆盖更新，锁定下游自定义数据；

3、导入模板：开放地址列导入能力，支持通过批量导入方式修改配送客户地址；

4、客户同步操作：主动同步、自动同步链路均剔除地址、经纬度字段，不再参与上游同步。

4、新增配送客户初始化统一规则

无论「地址」参数是否勾选，新增配送客户时系统均会自动同步一次上游地址、经度、纬度信息，保证新增客户基础地址数据完整、初始化准确，后续再根据参数状态决定是否锁定维护。

四、【注意事项】

1、名称、地址选项独立控制、互不影响，支持四种组合场景，适配不同客户同步维护策略，业务灵活性更高。

2、参数默认不勾选，完全兼容历史所有同步逻辑、导入逻辑、页面编辑逻辑，存量数据与作业流程无变更、无风险。

3、地址锁定同步包含地址、经度、纬度全套字段，避免单字段锁定导致的数据不匹配问题，保证地址数据完整性。

4、仅针对新WMS配送客户明细、导入、同步客户信息模块生效，不扩展至其他无关页面，改动范围可控。

5、新增客户强制初始化同步地址数据，杜绝新建客户地址为空、数据缺失问题，兼顾初始化准确性与后期自定义灵活性。

6、开启自定义地址后，所有上游自动变更、手动同步操作均不再覆盖下游地址，完全保障仓库实际配送地址独立可控，解决地址错乱问题。