结论先说清楚:WMS 与 ERP 对接出问题,十有八九不是接口写错了,是主数据不同步。商品主数据、库位、客户、供应商、计量单位、条码,这六样东西只要有一处对不上,单子发不出去、库存对不上、拣选报错,全会一起来。接口能做的只是把数据从一边搬到另一边,数据本身是错的,搬得越快错得越快。

这个坑我见过三次,三次的剧本一模一样。上线前接口测试全过,演示单子跑得漂漂亮亮,真单子一进来,仓库直接卡住。客户的第一反应永远是打电话骂接口,第二反应才是查数据。等查到数据头上,往往已经浪费了一整天。

主数据不同步,单子先乱在哪五处

**第一处,商品主数据:同一个商品,两个身份。**ERP 里建的商品是一个编码、一个单位、一个条码,到了 WMS 里单位变了,或者条码缺了,或者条码是箱码、单子要的是个位数。单子分不下去,只能进异常队列。去年三月一家美国俄亥俄州的分销商上线,活跃商品大概 4000 个——场景示意数字,未经核实——其中约 180 个的计量单位在两边不一致。不到 5% 的比例,偏偏全是畅销品,结果一整天的出库单全卡住了。

**第二处,库位:ERP 只认仓库,WMS 要认到货位。**ERP 眼里一个仓库就是一个地点,WMS 要的是巷道、排、层、位。库位映射没做全,收货在 ERP 里入了逻辑仓,WMS 却找不到物理货位,上架任务没地方去。操作员只能自己想办法,而这种临时办法用上一周就成了默认流程。

**第三处,客户和供应商:名字看着一样,编码完全不同。**ERP 里叫「艾克米贸易」,WMS 里叫「艾克米贸易公司」,人眼看是一个客户,系统看是两个客户。送货地址、税务、路由规则全跟着错,提前发货通知发出去也是错的编码。供应商这边也一样:采购单到了,WMS 对不上供应商编码,收货停在月台上,只能打电话回办公室问。

**第四处,计量单位:最安静的乘法错误。**个、内包装、箱、托盘,每一个换算系数都是一次出错的机会,而且错起来都是 12 倍、24 倍这种量级。最要命的是它看起来像盘点错:一个单位下数量是对的,换个单位就错了,团队把同一个货位复盘三遍,最后才发现是换算表错了。这个坑我见过三次,每次团队都是先怪盘点的人,后查数据。

**第五处,条码:一个商品,三种条码。**厂家条码、内部条码、供应商条码全在,偏偏没人定下来哪一个是主键。拣货员扫了一个完全合法的条码,WMS 却报「未知商品」,因为那个条码存在 WMS 从来不读的字段里。货在仓库里,单子在系统里,两边就是碰不上。

为什么接口总是先替主数据背锅

单子一失败,第一个电话永远打给接口团队。接口日志往往干干净净,因为接口确实干了它的活:老老实实地把错误数据从一边搬到了另一边。真正的问题是归属权:每个字段到底谁说了算。这件事必须在上线前白纸黑字定下来,不能等到第一批异常单出现再谈。

这里有个反常识的判断:接口越完美,坏主数据的危害越大。手工流程慢,慢到有人有机会发现单位错了、客户重了;自动同步快,快到错误在有人发现之前就已经扩散到几百张单子里。速度本身不是效率,没有治理的速度只是把错误批量分发出去。很多人买对接是冲着快去的,却忘了快只会放大数据本来的质量,好是更好,坏是更坏。

主数据域 说了算的一方 不同步会坏什么 最先看到的症状
商品主数据 ERP 单子无法分配 异常队列暴涨
库位 WMS 上架没有目的地 收货堆在月台
客户 ERP 送货地址与路由错 提前发货通知被拒
供应商 ERP 收货对不上采购单 月台积压
计量单位 ERP 为主,WMS 复核 库存按倍数错 反复复盘同一货位
条码 约定一个关键字段,一人负责 扫码报未知商品 拣选停线

上线前夜检查清单:能逐条打勾才算完

下面是我每个项目都在用的上线前夜检查清单,别因为哪条看着简单就跳过。半夜两点出事的,永远是看着简单的那条。

  1. 上线前 48 小时冻结主数据改动,并且通知所有能建商品、建客户、建供应商的人。切换期间改一个字段,整轮同步测试就白做了。
  2. 全量比对,不要抽查。所有在用商品、所有在用库位、所有在用客户和供应商,逐字段报差异数,不要只报通过或不通过。
  3. 每种单据类型都跑一单真实单子:普通销售、加急单、缺货补发、退货、调拨。演示单不算数。
  4. 每种供应商类型都跑一单真实收货,包括一个你从来没扫过条码的供应商。
  5. 销量前 100 的商品,计量单位换算表逐行核对。前 100 对了,尾巴可以在白天慢慢修。
  6. 所有会用到的条码类型都扫一遍——厂家条码、内部条码、供应商条码——确认每一种落在 WMS 的哪个字段。
  7. 每个字段的负责人写下来贴墙上:商品描述归 ERP,货位归 WMS,条码主键归一个具体的人。共管等于没人管。
  8. 接口挂了怎么办,写在一页纸上贴在主管桌上:谁先知道、怎么知道、接下来两小时操作员是继续干还是停下来。
  9. 上线后第一天、第三天、第七天各跑一次对账:ERP 库存对 WMS 库存,按商品、按库位。差异必须一次比一次小,变大了就先停量修数据。

接口挂了,谁先知道

答案绝不能是「客户先知道」。监控要盯三件事:发出去多少、收进来多少、被拒了多少。队列在涨是告警,营业时间队列安安静静也是告警,因为安静可能意味着发送方根本没发。告警要推给仓库主管,不要指望他记得去打开一个仪表盘看。应急手册里最重要的一行是:接口断了的这两小时,操作员是继续用纸单干,还是停下来等?上线前选一个,故障期间再选,一次两小时的接口故障就会变成两天的积压。

日常对账:上线不是结束,是每天 30 分钟的开始

上线不是主数据工作的终点,是每天习惯的起点。每天早上一个人先跑差异报告,清干净了再开第一波。昨天 ERP 新建的商品,今天 WMS 里必须有,单位和条码都对;WMS 新建的库位,ERP 该看到的地方必须看到。这件事的成本很小,假设算例:一个人每天 30 分钟、一周五天,大约是每周 2.5 小时。不做这件事的成本,是把上线那晚的混乱摊到一个月里慢慢还。每天一点纪律,永远比一个周末紧急手工改数便宜。

上线之后最常见的三种翻车

第一种是缓慢漂移。没人故意改数据,产品经理在 ERP 加了一个新包装规格,采购换了一个供应商编码,仓库主管为促销临时建了一个库位。单看每个改动都合理,合在一起两边就一点一点拉开了,直到某天单子开始失败,却没人能说出是哪次改动惹的祸。

第二种是好心办坏事。拣货员抱怨单位不对,有人在 WMS 里顺手改对了,ERP 里还是旧值,下一次同步又把改动覆盖回去。同一个错误反复出现,团队得出结论是系统坏了。系统没坏,缺的是治理:改动必须改在源头,不然一定会被覆盖。

第三种是异常队列变成停车场。异常队列本来要每天清干净,一旦变成停车场,操作员就学会了绕过它:手工分配、纸单拣货、打电话问办公室。绕路当时觉得更快,等到审计发现单子从错误的库位发给了错误的客户,代价就全回来了。异常超过 48 小时没清,就当它是数据问题,不是操作问题。

先把检查清单跑完,每个字段定一个负责人,每天把对账跑起来。对接项目失败,从来不是因为技术太难,而是因为没人对数据负责。有人负责了,接口才能干它本来就很简单的活。

作者:林晓|WMS 实施顾问,做过 30+ 上线项目