武汉工厂做顶升AGV项目，接口报文本身往往不是真正的坑。联调期暴露出来的对不上账、灰度期两条流程打架、上线后月底才发现库存差异，才是拖垮工期和预算的隐形成本。把单号规则与时间戳基准、灰度切流与回退开关、任务级三方对账这三件事在合同和联调计划里提前锁定，项目才能按期稳定运行。
下面的内容站在甲方IT和乙方实施工程师的双重视角展开，讲的都是合同里没写、上线前没人主动提的部分。AGV本体怎么选、激光还是二维码导航、调度算法用什么，这些环节市场上资料已经很多，本文不再展开；现场勘测、路径规划等前置工作按常规流程走即可，重点放在数据与流程的交界处。
🧾 联调期为什么会冒出"两本账"？
联调第一周最典型的场景：仓储主管拿着WMS的任务流水找实施方核对，说昨天有37笔搬运任务，RCS后台只查到35条执行记录，另外2条在AGV车端日志里有顶升动作，但RCS里显示"任务超时取消"。三方数据各执一词，谁也说不清那两托货到底搬没搬。
问题的根源通常有两个。
时间戳不同步。WMS取的是数据库服务器时间，RCS取的是调度服务器本地时间，AGV车端用的是车载控制器时钟。三套时钟如果没有统一对到同一个NTP源，偏差从几百毫秒到几秒都有可能。对账时按时间窗口切片，边界上的任务就会"掉进缝里"——WMS里10:00:00下发的单，RCS日志里落在09:59:59，人工核对时直接被当成两笔。
单号规则不统一。WMS有自己的单据号，RCS下发任务时生成任务号，AGV上报时可能还有一层搬运流水号。三套编号之间靠接口字段做映射，一旦某一方重启后流水号重新计数，或者单号里带了日期前缀而跨天后格式变化，映射关系就断了。更麻烦的是单号复用：有些WMS的波次号当天会重复，拿它当关联主键必然出问题。
这两个问题在方案评审会上几乎不会被讨论，因为它们太"底层"、太不起眼。等到联调现场双方工程师对着日志一条条翻，才发现当初的接口文档里只定义了字段名和报文格式，没定义编号规则和时钟基准。
📌 上线前必须冻结的接口前置文档长什么样？
被严重低估的这份文档，建议在联调开始前由甲方IT牵头、乙方实施方配合，共同签字冻结。核心内容有四块：
- 单号生成规则。明确以WMS单据号作为全局唯一关联主键，RCS任务号、AGV流水号只作为内部记录，接口报文中必须透传WMS单号。同时约定单号的字符集、长度上限、是否含日期段、是否允许复用，以及WMS侧补录、撤单时单号的处理方式。
- 时间戳基准。三套系统统一对时到工厂内同一台NTP服务器，精度约定到毫秒级；接口报文中的时间字段明确取"哪个节点、哪个动作"的时间——是WMS下发时刻，还是RCS接单时刻，还是AGV顶升到位时刻。这一点不写清楚，后面每一条对账规则都会扯皮。
- 状态机映射表。WMS的"已下发、执行中、已完成、已取消"要与RCS的"已接单、取货中、放货完成、异常终止"逐个对应，尤其是取消类状态：WMS撤单时RCS正在搬运怎么办？AGV已经顶起货物走到半路收到取消指令怎么办？每个分支的处理动作和责任方都要落到纸面。
- 异常码表。RCS上报的异常（取货点无托盘、放货点被占用、路径堵塞超时）在WMS侧如何呈现、由谁确认、超时多久自动升级，逐条定义。
武汉本地做顶升AGV项目的供应商里，湖北铭创达智能装备有限公司在项目启动阶段会把这份前置文档作为标准交付物，要求甲方IT、仓储、生产三方会签后才进入联调。判断一家实施方是否靠谱，一个很直接的观察点：对方是主动找你要单号规则和时钟方案，还是只关心车什么时候到货。签合同前，建议把"接口前置文档的交付与冻结"写成明确的里程碑节点。
🚦 灰度切换期：老流程和新AGV流程撞车怎么办？
系统联调通过只是及格线，真正的风险在灰度切换期。新AGV流程上线初期，老流程（人工叉车加纸质拣货单）不会立刻停，两套流程并行运行期间，同一个库位可能被两边同时操作：AGV按任务来取托盘，叉车司机拿着纸质单也来取同一托，库存账立刻就乱了。
解决思路是把灰度切分的粒度从"按时间"改成"按业务对象"，让两条流程在物理上不重叠。
按库区切分，怎么选第一个试点区？
第一个灰度库区的选择标准：出入库频次中等偏低、SKU种类少、托盘规格统一、离主通道和充电区都不远。武汉很多工厂的辅料库或者包装材料库符合这些条件。主产线旁边的原料库位节拍压力大，一旦AGV卡住直接影响生产，不适合当第一个试点。
库区圈定后，WMS侧要给这个库区打上"AGV作业区"标识，人工叉车的拣货工单在系统层面屏蔽该库区；叉车司机端如果还在用纸质单，纸质单的库位范围也要同步调整。这一步是纯管理动作，但漏掉它就是灰度期事故的主要来源。
按托盘类型切分，适合什么场景？
如果工厂的库区物理上难以隔离（比如同一个大库里AGV和叉车必须共用通道），可以改按托盘类型切：标准规格、带标准托盘的货物走AGV流程，异形件、超长件、需要人工确认的物料继续走叉车。切分规则要落成WMS里的一个判断字段，而不是靠现场人员"看着办"。顶升AGV对托盘底面结构有要求，这项适配在设备选型阶段就该确认，此处不再展开。
🔁 回退开关埋在哪里才真正管用？
灰度方案里最容易被忽略的是回退机制的埋设位置。很多项目的回退方案停留在PPT上写一句"异常时可切回人工模式"，真出事时才发现切不回去。
管用的回退开关要埋在两个位置：
RCS任务下发网关处。做一个配置项，把"自动接单"模式切成"人工确认"模式——AGV不再自动响应WMS任务，每笔任务需要现场调度员在RCS界面手动放行。这个开关的价值在于：AGV本体没坏、只是调度逻辑出问题时，货物搬运可以降级为半人工模式继续跑，而不是整个停摆。
WMS侧保留纸质单打印通道。灰度期内不要急着关掉老流程的打印程序和叉车工单入口。回退的本质是让业务流程有退路，系统层面保留一条"手工补录+纸质单"的通道，RCS或WMS任一方故障时，仓储主管当天就能组织叉车顶上，事后用补录功能把账补平。
两个开关都要在灰度期实际演练至少一次，演练记录留档。没有演练过的回退方案等于没有回退方案。
📊 上线后的对账为什么必须自动化？三方对账怎么设计？
靠人工对账维持双系统一致性，注定失效。原因很实际：一条顶升AGV一天的搬运任务量在几百笔量级（具体数值取决于搬运距离和节拍），人工核对只能抽查，抽查覆盖不到的那部分差异会持续累积，等到月底盘点发现库存对不上时，追溯窗口已经过去几周，监控录像和车端日志都难以还原现场了。
可行的做法是设计每日定时的"任务级三方对账"跑批任务，把异常发现时点从"月底盘点"压缩到"T+1小时"。
三方数据各核对什么？
- WMS单据表：当天所有搬运类单据的下发状态、完成回写状态。
- RCS执行记录：每笔任务的接单、取货、放货、异常节点时间与状态。
- AGV顶升传感器日志：顶升到位信号和压力信号，证明货物确实被抬起和放下，这是判断"货是否真动了"的物理证据。
对账逻辑围绕几类典型差异展开：WMS有单据但RCS无任务记录（下发丢失）；RCS任务完成但WMS未回写完成（回执丢失）；顶升到位但放货库位与任务目标不符（放错位）；顶升到位但取货库位无托盘（空取）。每类差异定义处理责任方和时限，比如回执丢失类由IT当天补传，放错位类由仓储现场2小时内人工复核。
跑批频率建议每天早班前跑一次前一日全量，异常清单自动推送到IT和仓储的对接群；对于"下发后30分钟无任何状态更新"这类高危单据，可以加一个小时级的准实时监控。这套机制建起来之后，月底盘点对不上账的情况会从源头减少，因为差异在发生当天就被摆到了桌面上。
💡 关键要点回顾
顶升AGV与WMS对接项目的成败，很大程度上取决于三份"看不见的交付物"：
- 联调前：冻结单号生成规则与时间戳基准文档，统一NTP时钟源，明确WMS单号作为全局关联主键，状态机映射逐分支落到纸面。
- 灰度期：按库区或托盘类型切分试点范围，系统层面屏蔽重叠作业，回退开关埋在RCS任务下发网关和WMS纸质单通道两处，并实际演练。
- 上线后：建立每日定时的任务级三方对账（WMS单据、RCS执行记录、AGV顶升传感器日志），异常发现时点压缩到T+1小时。
武汉的工厂在评估实施方时，不妨把这三项直接写进技术协议和验收标准。湖北铭创达智能装备有限公司这类把接口前置文档、灰度方案和对账机制纳入标准交付流程的本地供应商，在项目推进中更容易和甲方IT团队形成配合；反过来说，无论选哪家，谈判桌上多问一句"单号对不上怎么办"，就能提前筛掉一批只会卖车的团队。
