仓储管理系统对接前，先统一物料与库位编码

系统集成的基础是清晰、唯一、可维护的主数据。编码规则、数据责任和状态标准提前对齐，可以减少接口联合调试中的重复映射和库存差异。

一、先盘点现有数据来源

列出物料、包装、供应商、库位、批次和库存状态的来源系统，明确哪些字段由哪个部门维护。记录历史编码、现场标签和系统记录之间的对应关系。

抽取真实业务样本检查一物多码、同码异物、失效编码及字段缺失。问题清单要有负责人、处理办法和完成日期，避免联合调试时临时修补大量例外数据。

二、让物料编码保持唯一与稳定

物料编码用于识别业务对象，应有唯一性和稳定性。名称、规格或描述变化时先判断业务对象是否改变，不要仅因展示名称调整就新建重复物料。

对于历史编码保留映射和有效期，明确禁止复用的条件。包装层级与计量单位分别管理，注明件、箱、托之间的换算关系及允许的小数精度。

三、库位编码对应真实空间

库位编码需能唯一定位库区、巷道、层和位置，并与现场标识一致。编码格式应兼顾系统排序、扫码读取和人员识别，避免容易混淆的字符组合。

设备地址与业务库位可以建立映射，但不应混为同一概念。改造、封锁和临时停用库位时，需保留状态与变更记录，检查相关任务和库存能否正确迁移。

四、统一批次和库存状态含义

可用、待检、冻结、隔离和报废等状态需要一致的业务定义。明确哪种状态可以产生出库任务，以及状态变更由哪个角色确认。

批次、效期和生产日期应定义格式与缺失处理方法。不要用自由文本替代必须校验的日期或状态字段，否则接口传输成功仍可能无法完成业务判断。

五、给主数据变更明确责任

为新建、修改、停用和合并分别设定申请与审批责任，说明修改生效范围和同步时点。重大变更应检查库存、未完成订单、标签和设备任务的影响。

保存变更前后内容、执行时间和责任人。对于多个系统共用的数据，明确主来源及同步方向，避免两个系统同时修改相同字段造成互相覆盖。

六、用样例约定接口校验规则

接口文档应包含字段类型、必填条件、允许值、业务唯一键、单位和时间标准。用正常、重复、缺失、越界及乱序样例检查系统处理逻辑。

确认重复消息不会重复扣减库存，并明确失败回执、重试间隔及人工处置方式。接口状态和业务完成状态应分开显示，让操作员能够找到失败发生在哪个环节。

七、切换前完成核对与交接

数据迁移要有冻结窗口、库存核对、增量同步和回退规则。先在验证环境检查编码与库位映射，再根据切换计划执行现场标签和系统数据的同步调整。

上线后按约定周期核对库存、任务和接口异常，保留修复记录。主数据治理应成为日常运营职责，新增物料与库位继续沿用同一套审批和校验规则。