跨系统集成场景¶

适用基线：测试环境目标 / dev 分支 / 2026-07-15。阅读对象：测试、实施、运维（主）；集成开发（顺带）。说明集成方向与权威边界；报文映射未确认时不编造。平台重试见数据交换。

业务目的与适用范围¶

跨系统联调时，先确认「谁推谁、权威落在哪边」，再谈字段映射。本页收敛已从模块文档得到的场景方向；未证实项保持缺口，不补伪接口。

读完本页，应能：按场景找到文档入口与权威落点；用检查清单自检一次集成设计是否漏了幂等与失败恢复。

如何使用本页¶

你的目的	建议阅读
看集成方向总览	下方 mermaid + 场景矩阵
查某条链路的业务细则	矩阵「文档入口」列
设计/验收一次外部集成	「集成设计检查清单」
查调用约定与抽样路径	调用约定、模块接口索引

总览¶

flowchart LR ERP["ERP / 外部"] <--> SCP["SCP"] ERP <--> MES["MES"] SCP --> WMS["WMS"] WMS <--> QMS["QMS"] MES <--> WMS MES -.->|GAP-071| QMS DBC["DBC 主数据"] --> WMS DBC --> MES DBC --> SCP IOT["IoT 网关"] --> MES IOT --> WMS EDGE["边缘 / MQTT"] --> IOT AGV["AGV 回调"] -.-> IOT

场景矩阵¶

场景	方向	权威落点	文档入口	状态
供应商发货协同 / ASN	SCP → WMS	库存与收货执行在 WMS	发货协同	推送线索已证实；字段映射 P2
SCP 主数据	SCP `basic_*` ↔ DBC	主数据长期归属待确认；并存	SCP 基础数据	同步未证实
来料检验触发	WMS 到货确认 → QMS	检验结论在 QMS；放行/隔离库存在 WMS	来料检验	主触发已证实
采购收货建检	（历史）	—	同上	已停用，勿再写成现状
ERP 订单入 MES	ERP 订单 → 转换生产订单 → 工单	执行在 MES	计划管理	转换动作已证实
工单下发与报工	MES 内部 API	过程事实在 MES	计划 / 终端	已证实
完工 / 投料库存	MES 协同 → WMS	WMS 事务与余额	WMS 生产/发料页；`GAP-067` 等	边界已写；联调 P2
报工 NG → QMS	MES → QMS	—	`GAP-071`	未证实
备件出入库	EAM ↔ WMS 非计划	库存 WMS	EAM 备件	同步线索已写；盘点回写待确认
排程结果发布	PS → MES/ERP	—	PS	无实现
设备参数采集配置	Web `/iot` → IoT 网关	配置与时序在 iotgw	数采管理	Web 路径已证实；网关 DDL 仓外
业务读参 / 发消息	MES/WMS → iotgw RPC	业务结论仍在 MES/WMS	边缘接入模型	依赖线索已证实；场景矩阵 P2
AGV IOT 回调	外部 → AGV `/iotCallback`	任务在 AGV；点位在 DBC	DBC 点位 / AGV 模块	回调入口已证实；与采集点映射待联调
Node-RED 编排	边缘 → MES/数采	—	NodeRed	页面薄弱（`GAP-072`）
接口失败恢复	任意 → 平台记录	调用信息 + 异步重试	数据交换	平台能力已证实

发货协同等分组从 SCP 概述进入即可。

写实示例

给定： SCP 推送 ASN 后仓库要收货。 期望判断： 库存与收货执行权威在 WMS；在 WMS 收货链验收，而不是在 SCP 内改库存。失败时先查接口调用信息再重试。

集成设计检查清单¶

明确哪边是库存/质量/计划的权威。
外部单号与内部单号可双向联查。
失败可在接口调用信息中定位，并有重试/补偿说明。
权限：集成账号最小权限，不使用超管。
幂等：重复推送不产生双库存/双检验。

建议验证点¶

任选一条「已证实」场景：能说出方向、权威落点与文档入口。
涉及库存的场景：验收落在 WMS，而不是协同侧页面。
未证实项（如 GAP-071、PS 发布）不写入培训现状。

与业务挂接模型页的关系¶

更宏观的「待填任务」仍见第三方接口与单据挂接。本页记录时点已从模块文档收敛的结论；冲突时以更新的模块证据为准并回写本表。