先说结论:快递面单接口丢单,九成不是承运商把你的单弄丢了,是某一环没把单传下去。订单下了,出库单建了,面单却没出来,包裹卡在打包台上,客服电话先炸了。这个坑我见过三次,每次的病根都不一样,但排查的链路是同一条:OMS 到 WMS 到承运商接口再到打印机,一段一段往下查,先定位,再动手。
丢单最要命的不是丢,是找不着北。打包员说系统没出单,客服说订单已经确认了,IT 说接口没报错。三个人说的都对,因为单子卡在了他们仨中间的缝里。下面这条链路,就是帮你把缝找出来的。
先定位:快递面单接口丢单发生在四段里的哪一段
别一上来就重启服务、重下订单。先花五分钟定位,丢单发生在四段里的哪一段,后面每一步都不一样。
查订单在 OMS 里是什么状态:已确认待出库,还是已经推送 WMS?如果 OMS 里根本没推送,问题在 OMS 的推送规则,不在面单接口。再查 WMS 里有没有这票出库任务,任务状态是待拣选、已拣选还是已打包。任务都没有,单子死在 OMS 到 WMS 之间。任务有、面单请求发了、承运商没回执,问题在接口那段。请求回了、面单文件到了、打印机没动静,问题在打印那段。
定位就问四个问题,答案写下来再往下走:OMS 推了没有?WMS 收到没有?承运商回了没有?打印机打了没有?四个问题,卡在哪一段,答案就在哪一段。
快递面单接口丢单排查:从下单到出库四段走
第一段,OMS 到 WMS。最常见的翻车点是推送规则漏了订单类型。比如大促期间新加了一个礼品单类型,推送规则没覆盖,订单在 OMS 里躺着,WMS 永远收不到。查法:拿丢单的订单号去 OMS 的推送日志里搜,有没有推送记录、推送返回什么。没有记录就是规则问题,有记录但失败就是网络或字段问题。兜底做法:OMS 加一层推送失败重试和告警,失败超过三次直接推给值班,别让单子悄悄躺着。
第二段,WMS 内部。任务建了,拣选完成了,到打面单那步卡住了。这个坑我见过三次,次次都是同一个病根:面单请求发出去之前,WMS 要先校验地址、重量、承运商服务产品,三项里任何一项校验不过,请求发不出去,还不报错,只在任务备注里留一行小字。查法:打开任务详情,看校验那栏。兜底做法:校验失败必须弹提示、写日志,别让它静默失败。静默失败是丢单最大的帮凶。
第三段,承运商接口。请求发出去了,回执迟迟不来。这里分两种:一种是承运商接口超时,一种是回执回来了但 WMS 没认出来。超时先看接口的超时时间设了多少秒,再看是不是高峰期排队。回执没认出来,多半是承运商返回的状态码和你系统里映射的状态码对不上。查法:拿请求流水号去接口日志里对,看承运商到底回了什么。兜底做法:超时自动重试一次,但重试之前先查面单号有没有生成,别一单出两个面单号。
第四段,打印机和面单文件。面单文件到了,打印机没动静,或者打出来了系统却显示未出库。先查打印机队列,再查面单文件格式对不对,最后查回写:打印成功有没有回写到 WMS。回写失败最坑,打出来的包裹已经走了,系统里还是待出库,库存和订单状态全乱套。查法:对一对打印机日志和系统出库记录,数量对不上就是回写丢了。兜底做法:打印成功必须等回写确认再放行,宁可打包台上多等十秒,也别让系统和实物脱节。
| 环节 | 典型症状 | 先查什么 | 兜底做法 |
|---|---|---|---|
| OMS 到 WMS | WMS 无任务 | 推送日志、订单类型规则 | 失败重试三次加告警 |
| WMS 内部 | 任务卡在打面单 | 地址重量校验栏 | 校验失败弹提示写日志 |
| 承运商接口 | 有请求无回执 | 接口日志、状态码映射 | 先查面单号再重试 |
| 打印机 | 打了未出库 | 打印队列、回写记录 | 等回写确认再放行 |
说个反常识的判断:丢单最怕的不是丢,是重复出单。很多人一见丢单就点重试、重新下单,单子最后出来了,出来两张。两张面单号,同一个订单,包裹发出去一票,另一票面单号还在系统里飘着,轻则库存乱,重则客户收到货系统还显示未发货,客服再炸一次。重试之前先查面单号有没有生成,这是铁律。宁可慢十分钟定位,也别快三秒钟重下一单。
去年有个客户,大促前夜切新承运商接口,上线第一天丢了两百多单。查下来病根很土:新接口的截单时间比旧接口早一小时,大促当晚的单子过了截单时间,接口直接拒了,系统还没告警。最后靠人工一单一单补打面单,打到凌晨三点。那次之后我定了个规矩:切接口这种事,永远不要放在大促前夜做。
上线前夜 checklist:这张表过一遍再睡觉
上线前夜,别聊愿景,对着这张表一个一个打钩。
第一,推送规则:所有订单类型都覆盖了吗?拿真实订单跑一遍端到端,别只跑测试单。第二,校验规则:地址、重量、服务产品三项,校验失败能不能看到提示?第三,超时和重试:超时时间几秒?重试几次?重试前查不查面单号?第四,状态码映射:承运商返回的状态码,系统里都认得吗?第五,打印回写:打印机断网、缺纸、卡纸三种情况,系统分别怎么处理?第六,告警:丢单超过多少票、卡住超过多少分钟,谁会收到电话?第七,兜底:接口全挂的时候,人工补打面单的流程谁负责,面单号从哪来?
七项全打钩再睡觉。有一项没打钩,半夜的电话就是你的。
快递面单接口丢单这事,查一次不难,难的是每次都按链路查,而不是凭感觉猜。把这张排查表贴在打包台边上,下次面单出不来,照着四段往下走,十分钟就能定位。定位准了,修起来就快。
作者:林晓|WMS 实施顾问







