先说结论：卖家系统跟美国海外仓的 WMS 对接，技术只占三成，七成是流程和扯皮。你准备了多少人、多少钱去对账，决定了这事顺不顺利——跟你选 API 还是 EDI，关系真不大。
我见过太多卖家把"接口调通"当成"对接完成"。2021 年黑五前，洛杉矶一个做汽配的卖家，合作的海外仓 WMS 升级了接口版本，通知邮件躺在垃圾邮箱里没人看。订单推送断了整整两天，几百个订单靠人工导表格才发出去。黑五的流量，换来的是一堆延迟发货的差评。这事分两面看：技术上是个小版本升级，业务上是一次小事故——中间缺的，就是没人盯着"通没通"这件事。
四种对接方式，先讲代价再讲收益
第一，API 直连。代价：你得养人——自己的或者外包的，仓方接口一升级你就得跟；而且仓方的接口文档，写得像天书的是多数。收益：实时，字段自己定，单量起来之后最省心，长期看总成本最低。
第二，EDI。代价：老、贵、慢，实施周期按月算。收益：大仓和大客户认这个，稳定得像自来水。小卖家别碰，这是给大客户准备的。
第三，现成连接器或者中间件。代价：按月交钱，字段映射受限，特殊需求得排队等更新。收益：几周就能上线，不用养开发，开箱即用。
第四，人工导单，表格加邮件。代价：慢、错，旺季直接崩，一个大促能把你的人累死。收益：零成本，今天就能用。
说白了，选哪种不看技术先进，看你处在哪个阶段。分界线大概在月单三五千：这以下，人工导单的错单成本还抵不上开发成本；这以上，错单和延迟的损失就盖过开发投入了。这是个经验数，不是标准答案——但方向不会错。
还有一种常见的混合打法：订单下发走 API——实时性要求最高，断了立刻能发现；库存同步走定时任务，比如 15 分钟推一次，省开发量；异常回传先走邮件加人工盯，单量起来再做系统回传。好处是先把最要命的链路做结实，代价是三套机制并存，对账时要分清楚每条链路的延迟。很多卖家第一年都是这么过来的，不丢人。
WMS 对接最容易断的三处：订单、库存、异常
第一处，订单下发。美国地址那套东西，公寓号、Suite、PO Box，写错一位就丢件。更隐蔽的是取消和改单：卖家后台取消了订单，仓方那边的拣货任务没同步取消，货照发，退回来又是运费。
第二处，库存同步。这是最坑的。卖家 ERP 里的"可用库存"和仓方 WMS 里的"可用库存"，常常不是一回事——质检中的、待上架的、冻结的，各算在哪一边？口径没对齐，超卖是迟早的事。
第三处，异常回传。缺货、破损、地址异常，每家 WMS 的状态码定义都不一样。仓方回传一个"Exception 07"，卖家客服一脸懵，答不上客户的问题。接口通了，语义没通，等于没通。
举个真事：有家卖家的客服把仓方的"地址异常"当成"缺货"，跟客户说仓库没货要等补货，客户直接取消去别家下了单。一字之差，丢的不只是一单，而是一类问题的处理 SOP。所以状态码表拿到手之后，第一件事是翻译成人话，贴在客服的显示器旁边。
对账对不上，按这个清单查
有个卖家，每月盘点都差两三百件，查了三个月，最后发现是退货：仓方退货入库做了，状态回传丢了，ERP 里这批货一直在"在途"。三个月，账上飘着一批不存在的库存，该补货没补，断货断得莫名其妙。
对账差异别一上来就怀疑对方系统作弊，按这个顺序查：先对时间——两边数据的截止时间是否一致，注意时区，美西和美东差 3 小时；再对口径——在途、质检、冻结、残损，各算在哪一边；查异常单——没回传的异常是不是卡在中间件里了；查退货——退货入库有没有同步回来；最后查手工单——有没有绕过系统的人工出库。九成的问题，死在这五步里。
再说对账频率：订单每天对——昨天的单量两边一碰，差一单马上查；库存每周对——SKU 级别抽盘，差异大的深挖；费用账单每月对——仓储费、操作费按合同条款逐项核。频率越高，问题越小，扯皮越少。
小卖家：买现成的还是自己造
trade-off 很直接：月单三千以下，老老实实买现成连接器，一年几千美金，省下一个开发的人力，这是最划算的。月单过万、天天有定制需求，再谈自研或者中间件二次开发。最怕的是月单一千就自研——系统写完了，单量没起来，开发工资照发，服务器照租。
处在中间的（三千到一万单）最适合混合打法：买现成连接器打底，把最痛的定制需求单独做小工具补。比如每天自动跑一遍对账脚本，差异超过阈值就发邮件——这一个小脚本，顶半个对账专员。
最后提醒一句：不管买还是造，上线第一个月每天看一次对账报表，跑顺了再放手。系统对接最怕的不是出问题，是出了问题没人知道。
系统对接这事，接口通了只是开始，对上账才是结束。签合同之前，先问仓方一句话：异常状态码表能不能给我一份？答不上来的，对接完有你受的。
上线前，把这张联调清单跑一遍
我见过太多对接，联调时只测" happy path "：下一单，仓方收到，皆大欢喜。上线第一周，取消单、部分缺货、地址异常全来了，系统当场露馅。联调清单上，这几项一个不能少：
第一，下测试单走全流程：从卖家后台下单，到仓方拣货、打包、贴单、回传运单号，端到端跑三遍。别只在测试环境跑，至少拿一个真实小单在生产环境跑一遍——测试环境和生产环境的字段，十次有八次不一样。
第二，造异常单。故意下一个会被取消的单、一个地址残缺的单、一个库存不足的单，看三件事：取消能不能同步过去、异常状态码回没回来、客服能不能看懂。异常测不透，上线就是裸奔。
第三，对一遍库存口径。把 ERP 和 WMS 的"可用库存"定义写在纸上，逐项对：在途算谁的、质检中的算谁的、冻结的算谁的。口径对不齐，前面都白干。
第四，定对账节奏。上线第一个月，每天对一次订单和库存；跑顺了再改成每周。别信"系统都通了就不用对了"——系统越自动，对账越重要，因为错起来都是批量的。
这张清单跑完，对接才算真的"通了"。前面说的三成技术、七成流程，联调就是那七成里最实在的一块。
作者：老米｜20年美国供应链老兵，仓储解决方案顾问
