先说结论:WMS 和 TMS 对接,难的从来不是接口,是订单出了仓之后,信息还在不在。接口调通那天,项目组开香槟,太早了。真正的验收在上线第二周,司机到了门口,单子还在不在系统里。
这个坑我见过三次。第一次是一家华东做汽配的客户,上线第二周就出事。一辆提货的车到了月台,司机报了订单号,仓库的人在系统里一查,订单还是"待出库",可货明明半小时前就装车了。司机在门口等,仓库的人打电话问调度,调度说系统里没显示发车。最后是仓库主管翻了纸质的出库单,才把车放走。问题出在哪?状态回传只做了一个方向:仓储系统把"已拣货"推给了运输系统,运输系统却从来没把"已装车""已发车"推回来。信息出了仓,就断在门口了。
WMS 和 TMS 对接:先对齐,再谈接口
很多项目一上来就谈接口,字段、格式、调用频率,谈得热火朝天。我每次都先拦下来:先谈业务,再谈技术。两个系统对同一张订单的理解不一样,接口写得再漂亮也是白搭。
先对齐五件事。订单在两个系统里用同一个号,还是各编各的号再映射。订单状态有几个,分别是谁来改,改完多久对方能看到。运单号谁生成,什么时候回传,丢了谁负责。预计到达时间变了,谁通知谁,用什么方式通知。最后一条最容易漏:对接断了怎么办,是自动重传,还是人工补,是先堵住还是先放行。
这五件事没对齐就写代码,等于地基没打就盖楼。接口联调的时候一切正常,因为测试数据都是编好的、按顺序来的。真实订单一进来,状态乱跳、时间错位、号码对不上,问题全冒出来了。
WMS 和 TMS 对接的第一步不是写接口,是把两边的状态口径对齐。同一个"已发车",仓储系统认为是车出了大门,运输系统认为是司机接了单,两边差着半小时,状态一对就乱。口径对齐了,接口才有意义;口径没对齐,接口调通了也是各说各话。
还有一个反常识的判断:字段越全越好,是错的。刚开始对接,先对齐五个关键字段就够了:订单号、运单号、承运商、预计到达、状态。五个字段跑稳了,再慢慢加。一次想把几十个字段全接上,联调三个月都调不完,五个字段两周就能跑起来。字段少了还有一个好处:出问题好查,断在哪一眼就能看出来。先跑起来,再求全,这才是上线项目的节奏。
订单一出仓,信息最容易断在三个地方
第一个断点,装车状态回传。货装上车,仓储系统以为完事了,运输系统还以为货在库里。司机走了,系统里订单还是"待出库",客服接到客户电话一查,说货还没发。客户急,仓库冤,问题就出在"已装车"这个状态没人回传。
第二个断点,运单号回传。承运商换了,新的运单号只在运输系统里,仓储系统不知道。客户问"我的货到哪了",客服在仓储系统里查不到运单号,只能再去运输系统翻,翻到了还得手动贴过去。旺季一天几千单,手动贴运单号,贴错是迟早的事。
第三个断点,预计到达时间。路上有个堵车,到达时间晚了半天,运输系统知道了,仓储系统不知道,收货方更不知道。货到了没人接,车在门口等,等来的不是卸货,是罚时费。这个断点最隐蔽,因为平时不堵车,什么事都没有,一堵车全露馅了。
第二个客户就是栽在运单号上的。一家做快消的仓,旺季一天几千单,承运商临时换了一家,运单号没回传。客服团队整整一周都在手动查单子、贴单号,客诉涨了一大截。事后复盘,技术上就是少了一个回传动作,业务上就是没人规定"运单号必须在发车后多久回到仓储系统"。没人规定,就没人做。
还有一个容易被忽略的细节:签收回传。货送到了,客户签了字,这个"已签收"要不要回传仓储系统?不要,客服永远不知道这单算不算完;要,就得在对接方案里写清楚签收回传的时限。很多项目上线时没写,三个月后客服还在打电话问司机"货送到了吗"。
上线前夜,把 WMS 和 TMS 这张交接表跑一遍
上线前夜检查清单,我每次都要求项目组拿着下面这张表,一条一条实测过去。测的不是接口通不通,是信息断不断。
| 信息项 | 从哪来 | 到哪去 | 什么时候到 | 断了谁先知道 |
|---|---|---|---|---|
| 订单号 | 仓储系统 | 运输系统 | 建单时 | 运输调度 |
| 已装车状态 | 仓储系统 | 运输系统 | 装车后立即 | 仓库主管 |
| 已发车状态 | 运输系统 | 仓储系统 | 发车后立即 | 客服 |
| 运单号 | 运输系统 | 仓储系统 | 发车后立即 | 客服 |
| 预计到达时间 | 运输系统 | 仓储系统 | 变化时立即 | 收货方联系人 |
跑这张表有个诀窍:别用编好的测试单跑,用一张真实的订单,从建单跟到签收。真实订单才会遇到承运商临时换、到达时间变、状态回跳这些情况。测试单永远按剧本走,测不出断点。
还有三条翻车点,写进上线检查清单里。第一,对接断了有没有告警,还是悄悄断了三天才发现。第二,重传会不会重复建单,同一张订单出现两次,库存就乱了。第三,两个系统的时间是不是一致的,差几分钟不要紧,差一个时区就是事故。
订单出了仓,信息别断在门口。接口调通只是开始,信息从建单跟到签收不断,才算对接好了。上线前夜,把这张表跑一遍,跑通了再开香槟。表跑通了,WMS 和 TMS 对接才算真的交付了。
作者:林晓|WMS 实施顾问,做过 30+ 上线项目







