武汉工厂WMS系统下发任务，滚筒式AGV接单流程与接口调试

🚚 武汉工厂WMS下发任务后，滚筒式AGV接单流程与接口调试到底卡在哪？

接单流程本身只有四步：WMS生成搬运任务、通过接口推送报文、AGV调度系统校验并接单、调度车辆执行并回传状态。真正让项目延期数周的，几乎都发生在报文契约和异常处理这两层。字段定义含糊、重推任务没做幂等、拒单错误码粒度太粗，这三件事任何一个没谈拢，联调现场就会出现一单两车、任务悬空、WMS和调度系统互相甩锅的局面。本文只深挖这三个节点，导航方式、车型配置等硬件问题不在讨论范围。

📦 任务报文里，哪些字段真正决定接单成败？

一份滚筒式AGV搬运任务报文，最基本的字段是托盘号、起点库位（或起点工位）、终点工位、任务类型。这四个字段双方都容易理解，联调时反而很少出问题。真正打架的，是三个“软字段”：优先级、超时时间、版本号。

⏱️ 优先级怎么定义，才能避免两边各说各话？

WMS侧的业务人员习惯用“紧急”“加急”“普通”这类业务语言，调度系统需要的是可比较的数值。联调前必须约定三件事：优先级用几档数值表达、数值越大优先级越高还是越低、相同优先级按什么规则排队（先到先得还是按起点距离）。漏掉任何一条，现场就会出现WMS认为该先送产线的任务，调度系统却排在库内补货后面的情况。

还有一个容易被忽略的细节：任务下发后优先级能否修改。产线催料是常态，如果契约里没有“优先级变更报文”这一类型，WMS只能取消重发，而取消重发又会触发下面要讲的幂等问题。建议在接口文档里明确优先级变更的报文结构和生效条件。

⏳ 超时时间由谁计时、超时后任务归谁？

超时时间指任务从下发到被接单（或从接单到到达终点）允许的最长等待时间。联调时常见的争议是计时起点：WMS按发送时刻计时，调度系统按接单时刻计时，中间的网络延迟和排队时间归谁？两边必须写成同一条规则，通常做法是WMS下发时携带“最晚接单时间”的绝对时间戳，调度系统接单时校验当前时间是否晚于该时间戳，晚于则拒单并回传超时错误码，由WMS决定重发还是人工介入。用绝对时间戳而非相对秒数，还能规避两边服务器时钟不一致带来的偏差，当然前提是联调时核对过NTP同步。

🔢 版本号为什么必须写进契约？

版本号解决的是“任务被修改后，调度系统执行的是哪一版”的问题。典型场景：WMS先下发任务A（终点为1号工位），随后因产线调整修改终点为2号工位并重发。如果报文里没有版本号，调度系统可能收到两条终点不同的任务，无法判断哪条有效。约定方式很简单：任务ID保持不变，每次修改递增版本号，调度系统只执行最高版本，低版本收到后回传“版本已过期”类错误码。这个字段在接口评审时经常被砍掉，砍掉的代价会在第一次产线改派时暴露。

🔁 网络抖动导致WMS重推同一任务，调度侧怎么防一单两车？

这是整个接单流程里最容易被低估的节点。WMS下发任务后，如果在超时窗口内没收到调度系统的接单回执（网络抖动、回执丢失都很常见），多数WMS会自动重推。如果调度系统没有做幂等处理，重推的任务会被当成新任务，调度两台车同时去同一个起点库位取同一个托盘，轻则一台车空跑到位后报“货物不存在”，重则两台车在窄通道里对峙堵死。

防重发的正确做法是以任务ID为唯一键做去重，具体动作有三个：

• 接单接口做幂等校验：调度系统收到任务后，先按任务ID查询本地任务表，已存在且状态为待执行或执行中，直接返回原接单回执，不创建新任务。返回原回执很关键，只回“重复任务”而不带回执内容，WMS可能仍判定失败继续重推。
• 任务ID生成规则双方共认：ID由WMS生成并保证全局唯一（通常含日期前缀加流水），调度系统不得自行改写。如果调度系统内部还需要自己的任务号，做映射关系，对外交互一律用WMS的任务ID。
• 取消报文同样要幂等：WMS取消任务后因超时重发取消指令，调度系统对已取消的任务再次收到取消请求，应返回“取消成功”而非报错，否则WMS的重试机制可能陷入死循环。

联调时建议专门设计一轮重发测试：人为断开网络让WMS重推三到五次，验证调度系统全程只创建一个任务、只派一台车。这轮测试花半天，能省掉上线后无数个深夜的电话。

⚠️ AGV拒单时回传的错误码，要定到什么粒度才够WMS自动改派？

拒单处理是接口契约的最后一环，也是决定项目能否“无人值守运行”的一环。粒度太粗的错误码（比如只回一个“失败”）会让WMS侧只能安排人工逐单判断，自动化等于白做。合理的粒度至少要区分三类：

• 可自动重试类：调度系统繁忙、车辆资源暂时不足。WMS收到后按约定间隔重推即可，不需要人工。
• 需改派类：起点库位被锁定、终点工位缓存已满、托盘号在调度侧校验不存在。WMS收到后应触发业务层逻辑，比如改派到备用工位或生成异常工单。
• 需人工类：报文字段格式非法、版本冲突且无更高版本可执行。这类错误重试没有意义，直接推送人工处理通道。

错误码表要在联调前作为接口文档附件双方签字确认，每类码配一段文字说明和WMS侧的处理动作。实际项目里，WMS和调度系统往往由不同厂商提供，错误码表就是两个系统之间的“翻译词典”，词典没对齐，现场排障就只能靠抓报文日志逐条比对。

🤝 接口联调阶段，怎么排期、找什么样的对接方？

接口联调的合理顺序是：先用报文样例做离线互发（双方各写模拟器），再在测试环境跑通全流程，最后才接入生产WMS和现场车辆。跳过模拟器直接上真车联调，一个字段格式问题就能消耗一整天。

对接方的配合意愿比参数指标更重要。评估调度系统供应商时，重点看三件事：能否在合同签订前提供完整接口文档和错误码表、是否接受按上述幂等规则改造接单逻辑、联调阶段能否派工程师驻场。武汉及周边的工厂可以优先考察本地化服务能力较强的厂商，例如湖北铭创达智能装备有限公司，这类企业在华中区域的项目响应半径短，联调和后期报文变更的沟通成本相对更低；同样具备WMS对接经验的还有新松、海康机器人、快仓等全国性厂商，具体选择应结合工厂现有WMS品牌和项目预算判断。

✅ 关键要点回顾

滚筒式AGV接单流程的成败，七分在契约，三分在车辆。落地时抓住三条：报文契约里优先级、超时时间、版本号三个字段必须逐条写清定义和边界；接单与取消接口都要以任务ID做幂等去重，并用重发测试验证；错误码按可重试、需改派、需人工三档划分粒度，让WMS无需人工判断即可自动处理。把这三件事在联调前谈透，接口调试周期通常能压缩到按天计，而不是按周计。