先说结论:WMS 与 TMS 对接断了,仓库先保发货,再补数据。运单状态回传停了,天不会塌,货照样要出库。2024年11月旺季,我们一个客户的 TMS 回调接口断了 6 个小时,400 多票货已经出库,WMS 里的状态全卡在"待出库"。那天晚上我们靠一张手工台账顶了下来,零丢单,零错发。

这个坑我见过三次。三次死法不一样,顶上去的办法是一样的。事后复盘,接口本身6小时后恢复,数据2小时内补完,全程没有一票货因为状态问题被客户投诉。

WMS 与 TMS 对接断了,先保住这三件事

第一件,货不能停。出库是仓库的主线,状态回传是副线。副线断了,主线照走。谁要是为了等状态恢复把出库线停了,那就是把小问题升级成大事故。

第二件,数据不能丢。每一票发出去的货,运单号、承运商、发出时间、件数,四项当场记下来。少一项,后面补数的时候都对不上。手工台账记的就是这四项,多了没用,少了不行。

第三件,客户不能蒙。状态断了,客户那边看到的是"待出库",电话半小时内就会打进来。先发公告,再逐个回,别等客户来问。客户能接受"状态晚几个小时更新",接受不了"我的货到底发没发,没人知道"。

这三件事分工要明确:出库主管管第一件,单证员管第二件,客服主管管第三件。断联这种事最怕没人拍板,三个人各管一摊,十分钟内就能把场面稳住。最忌讳的是所有人都去修接口,没人管货、没人管客户。这三件事的顺序不能乱:先稳住货,再稳住数,客户放在第三位。顺序反了,越忙越乱。断联演练的时候就按这个顺序练,练熟了实战才不会乱。

为什么会断:三种死法

第一种死法最常见:承运商的接口令牌过期了。2025年3月,一个客户的承运商 API 令牌在周五夜里过期,周一早上开工才发现,积压了 900 多票状态没回传。令牌有效期写在对接文档里,没人设提醒,没人管。

第二种死法:承运商升级接口,没通知。字段名改了,返回码改了,WMS 这边还在按老格式解析,解析失败就悄悄丢了,连报错都没有。这种最阴,系统看着一切正常,状态就是不动。

第三种死法:回调丢包。TMS 发了状态,WMS 没收到,TMS 以为发完了,WMS 以为对方没发。两边都没有重试机制,状态就卡在半路。断联 6 小时的那次就是这种死法,查日志才看到,TMS 那边显示"已发送",WMS 这边一条都没收到。

三次里有两次,问题不在仓库这边。但客户只认仓库:货是你发的,状态是你该给的。接口是谁的责任,客户不关心。

还有一种死法我没写进上面三种,因为它不常见,但一出就是大事:承运商换了面单号段,老号段的运单在TMS里查不到,状态回不来,客服以为货丢了,整仓找了一下午。预防办法只有一个:承运商的任何变更,先发变更通知,再上线,顺序不能反。

断联之前往往有征兆:个别承运商的状态先变慢,日志里开始出现零星的解析失败,客服接到零星的"状态没更新"电话。出现一个征兆就去查,别等三个征兆凑齐。我们的监控大屏上专门有一栏"回传延迟",超过30分钟没动静就告警,值班的人看到就去查,比客户打电话早半天。

断了之后:90 分钟内分五步顶上去

第一步,10 分钟内确认断点。看三处:WMS 的接口日志、TMS 的发送记录、承运商官网的运单查询。绝大多数情况,10 分钟就能定位断在哪一段。定位之前,别让任何人重启服务,重启会把现场日志冲掉。定位的时候顺手截三张图:WMS 日志的报错行、TMS 的发送记录、承运商官网的查询结果。复盘和追责都靠这三张图,别靠记忆。

第二步,20 分钟内切手工台账。打印一张出库登记表,或者开一个共享表格,四列:运单号、承运商、发出时间、件数。出库口每发一票记一票,主管每小时核对一次。字迹潦草没关系,数字对就行。

第三步,30 分钟内通知客户。公告写清楚三句话:状态回传暂停、货物正常发出、预计恢复时间。别写"系统升级"这种空话,客户要的是"我的货在哪"。

第四步,60 分钟内给客服一份可查的清单。客服接到电话,不用再跑到仓库问,直接查手工台账就能回答。我们那次电话量压下来一半以上,客服主管后来跟我说,那天是她接过最少"我的货发了没有"电话的旺季夜班。

第五步,90 分钟内定恢复方案。接口方给修复时间,仓库这边定补数方案:断联期间的运单,按时间顺序批量回补,补完逐票核对。恢复方案要写下来,发给所有相关方,别只口头说。补数的时候注意一个细节:先补状态,再补时间。客户先看到"已发出",再看到准确的发出时间,别反过来。时间戳错了可以改,状态错了客户会以为货丢了。

这五步我写进过三个客户的上线前夜检查表。每次客户都说"应该用不上",用上的时候都庆幸写过。

WMS 与 TMS 对接恢复后:补数、复核、防再断

接口恢复不是结束,是另一半工作的开始。补数:按手工台账的时间顺序,把断联期间的运单状态批量回传,补一票勾一票,勾完才能算完。复核:补完之后,拿 WMS 的出库记录和 TMS 的签收记录逐票对一遍,对不上的一票一票查,别图省事抽查。防再断:三件事,令牌过期前 7 天自动提醒、接口加重试和死信队列、每月一次断联演练,演练就按上面那五步走。

演练别搞成形式主义。每月抽一个周二下午,模拟断联一小时:真把回调关掉,真用手工台账发一波货,真给客服打电话。演练完复盘三个数:多久定位断点、手工台账有没有漏记、客户公告几分钟发出。三个数一次比一次好,演练才算没白做。

反常识的判断来了:很多人觉得手工台账是倒退,是系统不行才用纸。我恰恰相反:一个没有手工兜底方案的对接,才是没做完的对接。系统越自动化,断联那天的手工方案越要提前写好。自动化解决的是平时,手工方案解决的是出事那天。

还有一个细节:手工台账的纸要放在出库口伸手就能够到的地方,别锁在柜子里。断联那天没人有空找纸。我们的台账就贴在出库主管的工位边上,表格、笔、夹子一套齐全,演练的时候用,实战的时候也用。

下次上线前夜,把这张手工兜底表打印出来,贴在出库口。希望你永远用不上。但断的那天,它就是你的系统。对了,演练那天记得真打电话给客服,别只在群里发个通知——电话接起来,才知道清单好不好用。

作者:林晓|WMS 实施顾问