ERP接口字段变更怎么验收

ERP、MES、WMS或电商平台对接时，最容易被忽略的风险不是接口完全断开，而是字段改了以后，接口仍然返回“成功”，业务数据却已经悄悄出错。

例如，发送方把“仓库编码”改成了新的字段名，接收方仍按旧字段读取；数量字段从整数改成带小数的数值；状态值从“已审核”改成“已确认”；日期格式、计量单位或必填规则发生变化。接口可能返回 HTTP 200，但 ERP 中的仓库、数量、批次或单据状态已经不正确。

接口字段变更前，应先形成字段映射表，记录字段名称、数据类型、长度、是否必填、枚举值、单位、来源系统、目标字段和生效时间。不能只在开发人员之间口头说明，也不能只发一份最新接口文档而不保留旧版本。

变更要有版本号和兼容策略。新增字段可以先设置为可选，确认上下游都能读取后再改为必填；字段含义变化时，不应直接复用旧字段名；枚举值增加或调整时，要明确旧系统如何处理未知值。涉及库存、金额、数量和日期的字段，还要特别检查精度、舍入和时区。

测试也不能只验证接口是否返回成功。至少要准备正常单据、缺失字段、超长文本、未知枚举、数量带小数、批次为空、重复提交和上下游版本不一致等样本。接口通过后，还要继续核对 ERP 中的单据、库存、状态和下游流程是否正确。

上线前应明确回滚方式、切换时间和异常责任人。正式发布后，保留请求报文、响应报文、字段版本、处理时间和业务单号，方便发现问题时追溯。对于已经进入错误状态的单据，要明确是修正原单、重新传输，还是通过补偿单处理。

盐城天讯科技咨询服务有限公司可根据接口清单、字段映射和异常样本，协助企业梳理接口版本、测试用例和验收边界。企业如果正在改造 ERP 接口，可以先准备一份旧版和新版字段表，以及几条异常单据记录。