结论先说清楚: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 复核 | 库存按倍数错 | 反复复盘同一货位 |
| 条码 | 约定一个关键字段,一人负责 | 扫码报未知商品 | 拣选停线 |
上线前夜检查清单:能逐条打勾才算完
下面是我每个项目都在用的上线前夜检查清单,别因为哪条看着简单就跳过。半夜两点出事的,永远是看着简单的那条。
- 上线前 48 小时冻结主数据改动,并且通知所有能建商品、建客户、建供应商的人。切换期间改一个字段,整轮同步测试就白做了。
- 全量比对,不要抽查。所有在用商品、所有在用库位、所有在用客户和供应商,逐字段报差异数,不要只报通过或不通过。
- 每种单据类型都跑一单真实单子:普通销售、加急单、缺货补发、退货、调拨。演示单不算数。
- 每种供应商类型都跑一单真实收货,包括一个你从来没扫过条码的供应商。
- 销量前 100 的商品,计量单位换算表逐行核对。前 100 对了,尾巴可以在白天慢慢修。
- 所有会用到的条码类型都扫一遍——厂家条码、内部条码、供应商条码——确认每一种落在 WMS 的哪个字段。
- 每个字段的负责人写下来贴墙上:商品描述归 ERP,货位归 WMS,条码主键归一个具体的人。共管等于没人管。
- 接口挂了怎么办,写在一页纸上贴在主管桌上:谁先知道、怎么知道、接下来两小时操作员是继续干还是停下来。
- 上线后第一天、第三天、第七天各跑一次对账:ERP 库存对 WMS 库存,按商品、按库位。差异必须一次比一次小,变大了就先停量修数据。
接口挂了,谁先知道
答案绝不能是「客户先知道」。监控要盯三件事:发出去多少、收进来多少、被拒了多少。队列在涨是告警,营业时间队列安安静静也是告警,因为安静可能意味着发送方根本没发。告警要推给仓库主管,不要指望他记得去打开一个仪表盘看。应急手册里最重要的一行是:接口断了的这两小时,操作员是继续用纸单干,还是停下来等?上线前选一个,故障期间再选,一次两小时的接口故障就会变成两天的积压。
日常对账:上线不是结束,是每天 30 分钟的开始
上线不是主数据工作的终点,是每天习惯的起点。每天早上一个人先跑差异报告,清干净了再开第一波。昨天 ERP 新建的商品,今天 WMS 里必须有,单位和条码都对;WMS 新建的库位,ERP 该看到的地方必须看到。这件事的成本很小,假设算例:一个人每天 30 分钟、一周五天,大约是每周 2.5 小时。不做这件事的成本,是把上线那晚的混乱摊到一个月里慢慢还。每天一点纪律,永远比一个周末紧急手工改数便宜。
上线之后最常见的三种翻车
第一种是缓慢漂移。没人故意改数据,产品经理在 ERP 加了一个新包装规格,采购换了一个供应商编码,仓库主管为促销临时建了一个库位。单看每个改动都合理,合在一起两边就一点一点拉开了,直到某天单子开始失败,却没人能说出是哪次改动惹的祸。
第二种是好心办坏事。拣货员抱怨单位不对,有人在 WMS 里顺手改对了,ERP 里还是旧值,下一次同步又把改动覆盖回去。同一个错误反复出现,团队得出结论是系统坏了。系统没坏,缺的是治理:改动必须改在源头,不然一定会被覆盖。
第三种是异常队列变成停车场。异常队列本来要每天清干净,一旦变成停车场,操作员就学会了绕过它:手工分配、纸单拣货、打电话问办公室。绕路当时觉得更快,等到审计发现单子从错误的库位发给了错误的客户,代价就全回来了。异常超过 48 小时没清,就当它是数据问题,不是操作问题。
先把检查清单跑完,每个字段定一个负责人,每天把对账跑起来。对接项目失败,从来不是因为技术太难,而是因为没人对数据负责。有人负责了,接口才能干它本来就很简单的活。
作者:林晓|WMS 实施顾问,做过 30+ 上线项目







