很多卖家把海外仓当成"把货存进去、有单就发"的黑箱,直到出了超卖、漏发、库存对不上才意识到:仓和自己的店铺系统之间那条数据线,才是真正决定履约准不准的东西。系统对接做得好,库存数字在仓和平台之间来回一致,前台卖的和仓里有的对得上;做不好,前台显示有货、仓里早就空了,或者仓里堆着货、前台却不敢卖。这篇把系统对接里最关键的库存同步拆开讲,重点是接口该传什么、多久传一次、对不上怎么发现,不是教人写接口代码。

对接的核心是把库存说成同一套话

打开网易新闻 查看精彩图片

系统对接第一道坎不是技术,是口径。卖家系统里的"可售库存"、仓系统里的"在库数量"、平台前台的"可卖件数",三个数字常常不一样,因为它们本来就不是同一个东西。可售要扣掉锁定、预留、待上架的部分;在库是把仓里所有货都算上,包括卖不掉的残次;前台可卖还要再扣安全水位。

对接之前先把这三个数字的定义对齐,明确接口里传的是哪一个。如果仓传的是在库数、卖家系统却当可售数用,前台就会超卖。口径统一之后,接口字段才有意义。这一步是纯业务梳理,不涉及代码,却是最容易跳过、代价最大的一步。

同步频率要和订单节奏匹配

库存同步接口的第二个问题是多久同步一次。同步太慢,卖出去了半天没回写,前台还在卖已经没货的SKU;同步太快,接口调用量上去了,还可能触发平台的频率限制。频率不是越快越好,而是要跟订单节奏和平台规则匹配。

一个可核的判断是看库存从发生变化的那一刻,到前台数字更新为止的延迟。这个延迟如果长到够买家下几单,就有超卖风险。延迟的目标值要按自身订单速度和平台规则校准,是管理参数,不是行业统一数字。爆款SKU和冷门SKU可以分开设频率,把接口预算用在真正会卖飞的货上。

增量同步比全量同步更省力

同步方式上有增量和全量两条路。全量同步每次把整个库存表推一遍,简单粗暴,但数据量大、接口开销高,SKU一多就吃力。增量同步只传发生变化的部分——哪几个SKU动了、动了多少,效率高得多,但要求系统能准确识别变化,还要处理漏传和重复传的问题。

多数场景适合增量为主、全量为辅:日常走增量,定期做一次全量对账,把增量过程中可能漏掉的差异补回来。对账的周期同样是按自身SKU规模和变动频率校准的管理参数。全量对账不是为了天天做,而是给增量机制上一道保险。

锁库是接口必须支持的状态

库存同步里最容易出事的,是"看得见但留不住"。买家下单的瞬间到仓真正拣货之间,库存要被锁定,否则同一件货会被两个平台同时卖掉。这要求接口不只传数量,还要传状态——多少是可售的、多少是被锁定的、多少是待出库但还没拣的。

只看总数不看状态的接口,在多平台场景下几乎必然出问题。判断接口合不合格,可以问一个具体的问题:一个SKU被A平台下单锁定后,这个锁定状态多久能同步到B平台、B平台的前台会不会立刻减掉这部分可售。如果答案是"不确定"或"要等下一轮同步",超卖只是时间问题。锁库同步的延迟是需按自身平台组合校准的管理参数。

对不上要能定位到哪一版数据

即便口径统一、频率合理,库存对不上还是会偶尔发生。这时候最关键的是能查清楚:是仓的数据错了、传输过程中丢了、还是卖家系统自己算错了。要做到这一点,接口调用和数据版本要留痕——每一次库存变更记下时间、变更前后数量、触发原因,形成可以对账的记录。

没有留痕的系统,对账只能靠猜。两边数字差了十件,到底是三小时前那笔退货没回写,还是早上那单锁库重复扣了,翻记录才知道。留痕颗粒度是需按自身排查需求校准的管理参数,但至少要做到能定位到具体某次变更,否则问题会反复出现却永远查不清。

异常和退货也要进同步

库存同步最常漏掉的是逆向的那部分。退货入仓、残次品剔除、换标重新上架,这些动作都会改变可售库存,却常常不在日常同步的考虑范围内。结果就是仓里货已经回来了,前台还显示缺货;或者残次品还没清出去,前台还在卖。

把退货和异常状态纳入同步,库存数字才闭环。可以在接口里给这些状态留专门字段,让仓把"在库但不可售"的部分单独传过来,卖家系统据此调整前台可卖量。这部分的状态定义要按自身退货流程校准,不同品类的退货周期和可售判定差别很大。

对接质量看的是一致性而不是速度

评估系统对接做得好不好,接口调用快不快、字段多不多都不是重点,重点是库存数据的一致性——仓里的真实可售和前台显示的可卖,差多少、差多久、差在哪。把口径先对齐、把锁库状态传全、把变更留痕、把逆向纳入,再按自身节奏调频率,这条数据线才不会在旺季成为最脆弱的一环。它拼的不是技术多花哨,而是每一件货的数字,在仓和店铺之间始终说的是同一句话。

问:系统对接第一步该做什么?

答:先统一口径,不要急着接接口。把卖家系统的"可售库存"、仓系统的"在库数量"、平台前台的"可卖件数"三个数字的定义对齐,明确接口到底传哪一个。如果仓传在库数、卖家当可售数用,前台必然超卖。这一步是业务梳理,却最容易跳过。

问:库存同步是不是越快越好?

答:不是。同步太慢会超卖,太快会推高接口调用量、甚至触发平台频率限制。要看库存从变化到前台更新的延迟是否长到够下几单,目标值按自身订单速度和平台规则校准。爆款和冷门SKU可分开设频率,把预算用在真正会卖飞的货上。

问:为什么接口不能只传库存总数?

答:因为多平台场景下"看得见但留不住"必然出事。一个SKU被A平台下单锁定后,这个锁定状态多久同步到B平台、B前台会不会立刻减掉可售——如果答案是"要等下一轮",超卖只是时间问题。所以接口要传可售、锁定、待出库等状态,而不只是一个数字。