先说结论:WMS 和 TMS 对接,难的从来不是接口,是订单出了仓之后,信息还在不在。接口调通那天,项目组开香槟,太早了。真正的验收在上线第二周,司机到了门口,单子还在不在系统里。

这个坑我见过三次。第一次是一家华东做汽配的客户,上线第二周就出事。一辆提货的车到了月台,司机报了订单号,仓库的人在系统里一查,订单还是"待出库",可货明明半小时前就装车了。司机在门口等,仓库的人打电话问调度,调度说系统里没显示发车。最后是仓库主管翻了纸质的出库单,才把车放走。问题出在哪?状态回传只做了一个方向:仓储系统把"已拣货"推给了运输系统,运输系统却从来没把"已装车""已发车"推回来。信息出了仓,就断在门口了。

WMS 和 TMS 对接:先对齐,再谈接口

很多项目一上来就谈接口,字段、格式、调用频率,谈得热火朝天。我每次都先拦下来:先谈业务,再谈技术。两个系统对同一张订单的理解不一样,接口写得再漂亮也是白搭。

先对齐五件事。订单在两个系统里用同一个号,还是各编各的号再映射。订单状态有几个,分别是谁来改,改完多久对方能看到。运单号谁生成,什么时候回传,丢了谁负责。预计到达时间变了,谁通知谁,用什么方式通知。最后一条最容易漏:对接断了怎么办,是自动重传,还是人工补,是先堵住还是先放行。

这五件事没对齐就写代码,等于地基没打就盖楼。接口联调的时候一切正常,因为测试数据都是编好的、按顺序来的。真实订单一进来,状态乱跳、时间错位、号码对不上,问题全冒出来了。

WMS 和 TMS 对接的第一步不是写接口,是把两边的状态口径对齐。同一个"已发车",仓储系统认为是车出了大门,运输系统认为是司机接了单,两边差着半小时,状态一对就乱。口径对齐了,接口才有意义;口径没对齐,接口调通了也是各说各话。

还有一个反常识的判断:字段越全越好,是错的。刚开始对接,先对齐五个关键字段就够了:订单号、运单号、承运商、预计到达、状态。五个字段跑稳了,再慢慢加。一次想把几十个字段全接上,联调三个月都调不完,五个字段两周就能跑起来。字段少了还有一个好处:出问题好查,断在哪一眼就能看出来。先跑起来,再求全,这才是上线项目的节奏。

订单一出仓,信息最容易断在三个地方

第一个断点,装车状态回传。货装上车,仓储系统以为完事了,运输系统还以为货在库里。司机走了,系统里订单还是"待出库",客服接到客户电话一查,说货还没发。客户急,仓库冤,问题就出在"已装车"这个状态没人回传。

第二个断点,运单号回传。承运商换了,新的运单号只在运输系统里,仓储系统不知道。客户问"我的货到哪了",客服在仓储系统里查不到运单号,只能再去运输系统翻,翻到了还得手动贴过去。旺季一天几千单,手动贴运单号,贴错是迟早的事。

第三个断点,预计到达时间。路上有个堵车,到达时间晚了半天,运输系统知道了,仓储系统不知道,收货方更不知道。货到了没人接,车在门口等,等来的不是卸货,是罚时费。这个断点最隐蔽,因为平时不堵车,什么事都没有,一堵车全露馅了。

第二个客户就是栽在运单号上的。一家做快消的仓,旺季一天几千单,承运商临时换了一家,运单号没回传。客服团队整整一周都在手动查单子、贴单号,客诉涨了一大截。事后复盘,技术上就是少了一个回传动作,业务上就是没人规定"运单号必须在发车后多久回到仓储系统"。没人规定,就没人做。

还有一个容易被忽略的细节:签收回传。货送到了,客户签了字,这个"已签收"要不要回传仓储系统?不要,客服永远不知道这单算不算完;要,就得在对接方案里写清楚签收回传的时限。很多项目上线时没写,三个月后客服还在打电话问司机"货送到了吗"。

上线前夜,把 WMS 和 TMS 这张交接表跑一遍

上线前夜检查清单,我每次都要求项目组拿着下面这张表,一条一条实测过去。测的不是接口通不通,是信息断不断。

信息项 从哪来 到哪去 什么时候到 断了谁先知道
订单号 仓储系统 运输系统 建单时 运输调度
已装车状态 仓储系统 运输系统 装车后立即 仓库主管
已发车状态 运输系统 仓储系统 发车后立即 客服
运单号 运输系统 仓储系统 发车后立即 客服
预计到达时间 运输系统 仓储系统 变化时立即 收货方联系人

跑这张表有个诀窍:别用编好的测试单跑,用一张真实的订单,从建单跟到签收。真实订单才会遇到承运商临时换、到达时间变、状态回跳这些情况。测试单永远按剧本走,测不出断点。

还有三条翻车点,写进上线检查清单里。第一,对接断了有没有告警,还是悄悄断了三天才发现。第二,重传会不会重复建单,同一张订单出现两次,库存就乱了。第三,两个系统的时间是不是一致的,差几分钟不要紧,差一个时区就是事故。

订单出了仓,信息别断在门口。接口调通只是开始,信息从建单跟到签收不断,才算对接好了。上线前夜,把这张表跑一遍,跑通了再开香槟。表跑通了,WMS 和 TMS 对接才算真的交付了。

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