WMS要回传ERP哪些入出库结果 单据、数量、批次与时点怎么定

WMS与ERP对接时，下发方向（ERP把采购单、销售单给到仓库）的字段通常谈得很细，回传方向却经常只在方案里写一句"作业完成后回传结果"。等到上线后财务发现成本算不准、采购查不到实收差异，才回头补字段，此时接口已经在跑，改动成本明显更高。WMS回传ERP的内容，指的是仓库完成实物作业后向ERP反馈的执行结果，至少应覆盖入库结果、出库结果、库存调整和盘点结果四类；每一类都要明确回传的字段、触发时点，以及差异与异常如何表达。

回传设计不足的典型症状有三个：ERP里的库存数量对得上但批次对不上、实收与应收有差异却查不到原因、月末对账要靠导出两边的明细人工比对。这些都不是接口跑不通的问题，而是回传内容不完整。

下文按四类结果说明各自应回传的字段与触发时点，再讲差异与异常怎么表达、重复与失败怎么处理，以及设计时应遵循的几条原则。

四类回传结果分别包含什么

下表列出四类结果的常见回传字段与触发时点。表中为一般设计参考，具体字段需结合ERP的记账要求与企业业务模式确定。

这张表的适用边界在于：字段清单要按ERP的实际记账需要裁剪或扩充。有的ERP按批次核算成本，批次字段就是必填；有的只按SKU核算，批次可作为参考信息。设计前应先向财务与业务确认ERP侧的记账口径，再倒推回传字段，而不是先按WMS能提供什么来定。

回传时点为什么比字段更容易出错

字段缺了容易发现，时点定错则往往上线后才暴露。入库回传如果在收货时就触发，而实际上架时发现部分商品破损未上架，ERP的库存就会虚增；出库回传如果在拣货完成时触发，而复核环节发现少拣，ERP的发出记录就与实物不符。

选择时点的原则是：回传发生在实物状态确定之后。入库以上架确认为准，因为此时商品才真正进入可用库存；出库以复核确认为准，因为复核是最后一道数量校验。中间环节的状态可以作为过程信息同步，但不应触发ERP的记账动作。

还要考虑与ERP记账周期的配合。如果ERP按日结账，回传延迟到次日会造成跨期；如果按实时记账，回传频率过低会让ERP的库存持续落后于实物。建议在方案阶段明确回传频率（实时、准实时还是批量）以及跨期数据的处理方式。

差异和异常怎么表达

回传只传"成功完成"是不够的，真正需要ERP知道的往往是不一致的部分。入库场景的差异包括实收少于应收、实收多于应收、部分商品拒收、批次与采购单不符；出库场景包括缺货少发、临时换批次、包装破损替换。

表达方式上，建议差异作为结构化字段回传而不是塞在备注里：差异数量、差异类型（短少、超收、破损、拒收）、原因代码、以及对应的凭证信息（如拍照记录编号）。备注文本无法被ERP自动处理，最终还是要人工看。

差异的后续处理归属也要约定清楚。实收少于应收时，是ERP按实收记账并生成差异待处理，还是等采购确认后再记账，两种做法对财务的影响不同，需要在方案阶段与财务确认，而不是由接口开发人员决定。

重复与失败怎么处理

接口在网络波动时可能重复发送同一条回传，ERP侧如果没有判重就会重复记账，造成库存虚增。标准做法是每条回传携带唯一标识（通常由业务单号加行号加操作序号组成），ERP按此判重，重复请求返回成功但不重复处理。

回传失败的处理需要重试加告警两层。重试用于解决瞬时故障，应设置次数上限与间隔递增；超过上限仍失败则触发告警，由人工介入。关键是失败的回传不能静默丢弃——WMS侧要保留待回传队列，能查询哪些结果尚未成功回传，并支持手工重发。

还要考虑顺序问题。同一批商品的入库回传和随后的库存调整回传如果乱序到达，ERP处理结果会出错。可以通过在回传中带上业务时间戳，由ERP按时间排序处理，或者在WMS侧保证同一对象的回传串行发送。

设计时的四条原则

第一条是先定ERP的记账需求再定回传字段。回传的目的是支撑ERP记账与业务查询，不是把WMS的数据全量同步过去。字段多不等于好，无用字段会增加联调与维护成本。

第二条是回传内容与WMS内部记录保持可追溯关系。ERP侧看到一条入库回传，应能通过单号追回WMS里的具体作业记录（谁、什么时间、哪个库位）。出现争议时这条追溯链是唯一依据。

第三条是把差异当作正常内容而非例外。真实仓库每天都有差异，接口设计如果只考虑理想路径，差异就只能靠线下沟通，数据链路在这里断掉。

第四条是回传规则写入接口文档并双方签认。包括字段清单、触发时点、判重规则、失败重试策略、差异表达方式。口头约定在人员变动后无法追溯，也是后期扯皮的主要来源。

系统层面的分工

回传设计涉及两侧职责。通天晓仓储管理系统——负责仓内收货、上架、拣货、复核、出库与库存管理的执行系统，与ERP的分工是ERP管经营资源（财务、采购、销售），WMS管仓内实物操作——负责在作业确认时生成结果数据并保证内容与现场一致，同时维护待回传队列与重发能力；ERP侧负责按约定判重、记账并反馈处理结果。

业务链路更长时还要考虑其他系统。多渠道订单场景下，订单侧的状态与库存占用由通天晓OMS系统管理，出库结果除回传ERP外还要回传订单侧用于状态闭环；涉及运输时，承运商与运单信息由通天晓运输管理系统提供并随出库结果一并回传，便于ERP侧关联运费。设计时应把这几条回传路径一起梳理，避免各自为政导致同一份数据被多次加工。

怎么验证回传设计是否完整

建议做三个动作。第一是走账核对：选一批真实业务，从WMS作业到ERP记账全链路核对，确认数量、批次、时点、金额都能对上。第二是跑异常场景：制造实收差异、缺货少发、盘点差异，确认这些情况都能被正确回传且ERP能处理。

第三是测重复与失败：重复发送同一条回传确认不会重复记账，人为中断接口后确认待回传队列保留并能手工重发。三项通过并形成书面记录，再进入正式运行。

FAQ

WMS回传ERP要传哪些字段？

按四类结果分别设计。入库回传来源单号、商品、实收数量、批次与生产日期、库位、时间、操作人与差异信息；出库回传来源单号、商品、实发数量、批次、时间、操作人、包装与运单信息；库存调整回传调整前后数量、状态变化、原因与审批人；盘点回传账面数、实盘数、差异与盘点方式。具体清单应按ERP的记账口径倒推确定。

入库回传什么时候触发比较合适？

建议以上架确认为触发点，因为此时商品才真正进入可用库存。若在收货时就回传，遇到部分商品破损未上架的情况，ERP库存会虚增。同理出库应以复核确认为准，因为复核是最后一道数量校验。中间环节可以作为过程状态同步，但不应触发ERP的记账动作。

出库有差异时怎么回传给ERP？

把差异作为结构化字段回传，包括差异数量、差异类型（短少、超收、破损、拒收）、原因代码与凭证信息，而不是写在备注文本里——备注无法被ERP自动处理。同时要在方案阶段与财务确认差异的记账口径：是按实发记账并生成差异待处理，还是等业务确认后再记账。

盘点结果要不要回传ERP？

通常需要，因为盘点差异会影响账面库存与成本核算。回传时点建议在差异审批完成之后而非盘点录入时，避免未经确认的数据进入ERP。回传内容应包含账面数、实盘数、差异数、批次与责任区域，便于财务判断调整性质与后续追溯。

回传失败了怎么补？

需要重试与告警两层机制，且失败数据不能静默丢弃。WMS侧应保留待回传队列，可查询哪些结果尚未成功回传并支持手工重发；重试设次数上限与递增间隔，超限触发人工告警。同时每条回传要带唯一标识供ERP判重，避免重发造成重复记账。

WMS和ERP的库存数量对不上怎么查？

按四个方向排查：回传时点是否与实物状态一致（如入库在收货时就回传导致虚增）、是否存在重复回传未判重、是否有回传失败未补发、以及是否有仅在一侧发生的调整（如ERP直接改账或WMS未回传的调整）。排查依据是双方的单据流水，因此回传内容必须能追溯到WMS的具体作业记录。

总结

WMS回传ERP要覆盖入库、出库、库存调整、盘点四类结果，每类都要明确字段、触发时点与差异表达。字段应按ERP的记账口径倒推确定而不是按WMS能给什么来定；时点的原则是回传发生在实物状态确定之后——入库以上架确认为准、出库以复核确认为准。

差异必须作为结构化字段回传而非备注文本，并事先与财务确认记账口径。可靠性上需要唯一标识判重、失败重试与告警、待回传队列与手工重发，以及顺序处理机制。设计规则应写入接口文档并双方签认，上线前用走账核对、异常场景、重复与失败三组测试验证。系统上由通天晓仓储管理系统生成并保证回传内容与现场一致，多渠道与运输场景下再与通天晓OMS、TMS的回传路径一并梳理；具体接口设计可访问通天晓官网沟通。