一物一码对接 ERP、WMS：先对齐业务含义，再联调接口

一物一码对接 ERP 或 WMS，最常见的分歧并不在接口地址，而在“出库”到底表示什么。有的系统表示创建出库单，有的表示拣货完成，有的表示实物交接。若把这些动作映射成同一个状态，接口可以持续返回成功，仓库却仍然对不上账。建议先用一张真实业务单走完各系统流程，再讨论字段。

给每一类数据确定责任方

产品基础信息、包装规格、批次、客户、仓库、库存数量、单品身份和包装关联，应逐项明确谁创建、谁修改、谁审核。一个字段不宜由两边互相覆盖而没有优先规则。产品更名、仓库停用、客户合并等变化也要有同步办法，不能只有初始导入。

建议接口清单至少写明业务触发点、发送方、接收方、数据范围、确认条件和异常责任人。GS1 CBV 提供配合事件数据使用的业务词汇，说明共享数据不仅需要相同字段，还需要一致含义。来源：GS1 CBV 标准采用内部词汇也可以，但双方要保存明确映射，不能凭中文名称猜测。

单据与码明细要能相互查到

建议每次交换携带来源系统、业务单号、明细行号、事件号、动作、发生时间和数据版本。产品数量可以在 ERP 中按箱计，在码系统中按瓶计，因此包装换算关系、单位精度和部分箱处理都必须提前确认。数量相等但码属于另一个批次，仍然是业务错误。

撤销单据也不是删除上一条记录那么简单。建议约定已拣货、已出库、已交接三个阶段分别允许如何撤销，退货是否必须关联原单。双方都应能够解释为何库存增加或减少，而不是靠手工修改总数修平差异。

把超时和部分成功当成正常测试项目

当调用方没有收到响应时，接收方可能已经完成业务。建议使用稳定请求标识查询处理结果，再决定重试。批量传输还需返回行级错误，避免一条无效码拖住全部正常数据，或者接收方静默丢弃错误行。大单拆分时应标识原任务和分片，便于汇总对账。

异常队列最好区分技术失败、资料缺失和业务拒绝。网络超时适合自动重试；客户档案不存在需要补资料；库存不足则需要业务复核。三种问题如果全部交给同一个“重新发送”按钮，操作员会重复点击，却不知道谁应该解决原因。

验收以完整业务结果为准

建议选正常出库、部分出库、跨批出库、退货、撤销、重复请求、延迟到达和未知码八组场景。每组从界面发起，检查传输记录，再回到双方系统核对库存、单据状态、码状态和操作历史。接口返回成功只是证据之一，不能单独作为验收结论。

日常对账应同时比较数量和身份清单。按日期看总量相等，可能掩盖昨天少发、今天多发或两个批次互换的问题。建议形成“单据总量对账—差异单定位—码明细比对—责任人处理”的固定路径，保留最终处理依据。

采购或实施合同中值得写清的内容包括接口版本、调用限制、测试环境、升级通知、问题响应和数据导出。不要默认软件升级后原接口永久兼容。小范围真实单据验证通过后再扩展，可减少多个系统同时改变造成的定位困难。