奇瑞汽车EDI数据集成技术文档
基于畅链数据集成平台与WebEDI的实施方案
| 项目名称 | 奇瑞 EDI数据对接项目 |
|---|---|
| 平台 | 西安畅链数据集成平台 |
| 对接模式 | 非直连模式（畅链平台中转） |
| 目标上线日期 | 2026年5月1日 |
| API认证方式 | AccessToken |
| 报文格式 | JSON |
| 文档版本 | V1.0 |
| 编写日期 | 2026年4月15日 |
第1章 项目概述
1.1 项目背景与目标
XXX有限公司作为奇瑞汽车股份有限公司的一级零部件供应商，长期承担关键零部件的研发与制造任务。随着奇瑞汽车供应链数字化转型战略的深入推进，全体一级供应商需按照奇瑞供应链管理体系要求，建立标准化的EDI（电子数据交换）通道，实现生产质量数据与计划物流数据的自动化、实时化传输，以替代传统的人工报送与离线对账模式。
本项目采用西安畅链数据集成平台作为核心中间件，以非直连模式完成与奇瑞系统的数据对接。所谓"非直连模式"，即XXX不直接与奇瑞SRM/MES系统建立点对点连接，而是通过畅链平台进行数据中转、格式转换、调度管理与异常处理，从而降低技术复杂度、提高系统可维护性。
项目核心目标如下：
建立XXX与奇瑞汽车之间的全自动化数据交换通道，覆盖生产质量与计划物流两大业务域
实现34个数据接口的标准化对接，确保数据传输的完整性、准确性与时效性
通过畅链ERP系统为XXX业务团队提供统一的数据展示、查询与操作平台
通过WebEDI功能实现人工判断类业务（风险确认）的在线化处理
目标上线日期：XXXX年X月X日，届时全部34个接口正式投入生产运行
1.2 业务范围
本次EDI数据对接涵盖两大业务模块，共计34个数据接口：
生产质量模块：17个接口（全部为供应商→奇瑞方向），涵盖主数据同步（供应商基础信息、人员资质、BOM、物料、工艺装备、工艺）以及业务数据传输（来料检验、过程控制项质量数据、生产过程数据、合格率、缺陷、环境、OEE、排产、附件等）
计划物流模块：17个接口（奇瑞→供应商13个 + 供应商→奇瑞4个），涵盖计划类（整车月度计划、M+6月物料需求、日物料需求、计划协议、采购订单）、物流执行类（排序供货、看板配送单、退货单）、库存监控类（RDC库存、日MRP状态/预警）、过点信息（过涂装未过总装、过涂装未过总装）、以及供应商反馈类（共享库存、风险确认）
1.3 数据流向总览
本项目涉及的34个接口按数据流向分为两大类：
供应商→奇瑞方向（共21个接口）：
生产质量模块全部17个接口：包含6个主数据接口（供应商基础信息、人员资质信息、BOM主数据、物料主数据、工艺装备、工艺）和11个业务数据接口（来料检验、过程控制项质量数据、生产过程数据、产品一次合格率、工位一次合格率、缺陷业务数据、环境业务数据、排产数据、设备OEE达成率、OEE时间明细、附件类数据）
计划物流模块4个接口：3个风险确认接口（M+6月物料需求计划风险确认、日物料需求计划风险确认、采购订单风险确认）和1个库存共享接口（供应商共享库存）
奇瑞→供应商方向（共13个接口）：
计划类5个接口：整车月度生产计划-2、M+6月物料需求计划、日物料需求计划、计划协议、采购订单
物流执行类3个接口：排序供货、看板配送单、退货单
库存监控类3个接口：奇瑞RDC共享库存、日MRP状态监控、日MRP预警推移
过点信息类2个接口：过涂装未过总装、过涂装未过总装
数据流转路径统一为：畅链平台（实施平台+ERP系统）⟷ 奇瑞API网关 ⟷ 奇瑞SRM/MES系统。畅链平台负责API调用、数据转换与调度管理，所有数据均通过HTTPS REST API以JSON格式传输。
第2章 系统架构设计
2.1 总体架构说明
本项目的系统架构以畅链数据集成平台为核心，该平台采用私有化部署方式，部署于XXX指定的服务器环境中。畅链平台分为两大组成部分，各自承担不同的职责：
- 畅链实施平台
畅链实施平台是系统的技术运维中心，面向IT实施人员与运维工程师使用，主要负责以下工作：
API接口配置：配置奇瑞侧全部API端点地址、请求方法、请求头、认证参数、请求/响应报文模板
数据映射规则配置：定义字段级映射关系、数据格式转换规则、唯一标识校验规则
调度任务管理：配置各接口的调度频率（Cron表达式）、时间窗口、触发条件、重试策略
传输协议管理：管理HTTPS通信参数、AccessToken获取与续期、报文加解密
异常监控与告警：实时监控接口运行状态、数据传输成功率、异常日志记录与告警通知
- 畅链ERP系统
畅链ERP系统是系统的业务操作中心，面向XXX业务人员日常使用，主要负责以下工作：
订单管理：展示从奇瑞拉取的采购订单、计划协议等数据，支持查询、筛选与导出
库存管理：展示奇瑞RDC共享库存、供应商自身库存数据，支持库存数据录入与维护
生产监控：展示排产计划执行情况、质量数据汇总、合格率趋势等
计划查看：展示整车月度计划、M+6月物料需求、日物料需求等奇瑞下发的计划数据
MRP监控：展示日MRP状态、预警推移数据，辅助物料齐套分析
| 重要说明 XXX有限公司不使用独立的ERP、MES或WMS系统。畅链平台（含实施平台与ERP系统）即为XXX的全部业务信息系统。因此，生产质量模块的数据源头来自畅链ERP系统中业务人员维护的数据，计划物流模块的数据展示与操作同样在畅链ERP系统中完成。 |
|---|
整体架构数据流路径如下：
畅链平台（实施平台 + ERP系统）⟷ HTTPS/REST API ⟷ 奇瑞API网关 ⟷ 奇瑞SRM/MES系统
2.2 畅链实施平台功能说明
畅链实施平台是本项目技术实施与运维的核心工具，其主要功能模块如下：
API接口管理模块
负责配置和管理与奇瑞侧对接的全部API接口信息。每个接口需配置以下内容：API端点URL（区分测试环境与生产环境）、HTTP请求方法（GET/POST）、请求头参数（Content-Type、Authorization等）、请求体模板（JSON格式）、响应解析规则、超时时间设置。系统支持接口分组管理，可按生产质量模块和计划物流模块进行分类管理。
数据映射引擎
提供可视化的字段映射配置界面，支持以下能力：源字段到目标字段的一对一映射、数据格式转换（如日期格式统一为yyyy-mm-dd HH:mm:ss）、唯一标识组合键配置（用于判断数据新增或更新）、默认值填充（如生产工单号/批次号无值时填"/"）、数据过滤与清洗规则配置。
调度引擎
支持基于Cron表达式的定时任务调度，可配置不同粒度的执行频率（从每10分钟到每日1次）。同时支持条件触发模式（用于WebEDI人工操作后的数据推送）和失败重试机制（可配置重试次数、重试间隔、最终失败后的处理策略）。
传输引擎
封装HTTPS REST API调用能力，支持JSON报文的构造与解析、AccessToken的自动获取与缓存续期、请求/响应日志的完整记录。
监控告警模块
提供接口运行状态的实时监控面板，展示各接口的最近执行时间、执行结果、成功率统计。当接口执行失败超过重试次数后，自动触发告警通知。
2.3 畅链ERP系统功能说明
畅链ERP系统作为XXX的核心业务操作平台，承担着全部业务数据的展示、维护与管理职能。系统主要功能模块如下：
订单管理
展示从奇瑞系统拉取的采购订单和计划协议数据。业务人员可按订单号、零件号、交货日期等维度进行查询与筛选，查看订单明细（包括物料编码、需求数量、交货日期、交货地点、到货数量等）。支持订单状态跟踪和历史版本对比。
库存管理
综合展示两类库存数据：一是从奇瑞拉取的RDC共享库存数据（每日15:00后更新），二是XXX自身的成品、半成品及原材料库存数据。供应商共享库存接口的数据源即来自此模块，业务人员需在此维护准确的库存信息。
生产监控
展示排产计划的制定与执行情况，包括计划数量、实际产量、完工状态等。同时汇总展示产品/工位一次合格率、缺陷数据趋势、设备OEE达成率等生产质量指标，为管理层提供生产运营的全局视图。
计划查看
展示奇瑞下发的各类计划数据，包括整车月度生产计划、M+6月物料需求计划、日物料需求计划等。支持按版次查看计划变更历史，辅助业务人员了解需求变化趋势。
MRP监控
展示日MRP状态监控和预警推移数据，帮助业务人员实时掌握物料供需匹配情况，及时发现供应缺口（GAP），采取补货或调整措施。
2.4 WebEDI功能说明
WebEDI是畅链平台提供的基于Web浏览器的人工交互入口，专门用于需要业务人员主观判断和手动确认的业务场景。在本项目中，WebEDI承担以下核心功能：
风险确认操作（3个接口）
M+6月物料需求计划风险确认：业务人员查看奇瑞下发的M+6月物料需求计划最新版次数据，逐行或批量评估自身产能是否能够满足需求，填写反馈结果（满足/不满足）、风险类型、应对措施及满足数量，确认提交后系统自动推送至奇瑞
日物料需求计划风险确认：同上流程，针对每日下发的日物料需求计划进行风险评估与反馈
采购订单风险确认：同上流程，针对每日下发的采购订单进行风险评估与反馈
数据查看
WebEDI同时提供计划数据和库存数据的查看功能，作为畅链ERP系统的补充入口，方便业务人员在不同终端和场景下快速查阅关键业务数据。
2.5 网络与通信架构
本项目的网络通信架构设计如下：
| 项目 | 技术规格 |
|---|---|
| 通信协议 | HTTPS REST API（TLS 1.2及以上） |
| 认证方式 | AccessToken（从奇瑞API网关获取，需定期续期） |
| 报文格式 | JSON（UTF-8编码） |
| 请求方法 | GET（数据拉取）/ POST（数据推送） |
| 环境配置 | 测试环境 + 生产环境（独立URL，独立Token） |
| 超时设置 | 连接超时30秒，读取超时60秒 |
| 开发依据 | 奇瑞侧提供的API接口文档 |
AccessToken认证流程：畅链实施平台通过奇瑞提供的认证接口，使用预分配的AppKey和AppSecret获取AccessToken。Token具有有效期限制，平台需在Token过期前自动续期，确保接口调用不因认证失效而中断。
第3章 接口总览与分类
3.1 按业务模块分类
| 模块 | 方向 | 接口数量 | 数据类型构成 |
|---|---|---|---|
| 生产质量 | 供应商→奇瑞 | 17 | 主数据6个 + 业务数据11个 |
| 计划物流 | 奇瑞→供应商 | 13 | 业务数据13个 |
| 计划物流 | 供应商→奇瑞 | 4 | 业务数据4个（含3个风险确认） |
| 合计 | 34 | — |
3.2 按传输频率分层
| 层级 | 频率 | 接口数 | 代表接口 |
|---|---|---|---|
| Tier 1 - 高频 | 每10分钟（144次/日） | 6 | 过程控制项质量数据、生产过程数据、产品/工位一次合格率、缺陷/环境数据 |
| Tier 2 - 中高频 | 每15分钟~1小时 | 7 | 排产数据(24次/日)、设备OEE(24次/日)、排序供货(每15分钟)、过点信息 (每15分钟)、看板配送单/退货单(每10分钟) |
| Tier 3 - 中频 | 每30分钟（有时间窗口） | 8 | 整车月度计划、M+6月计划、日物料计划、计划协议、采购订单、RDC库存、日MRP状态/预警 |
| Tier 4 - 低频 | 每2~4小时 | 3 | 来料检验(每4小时)、OEE时间明细(每2小时)、附件类(每4小时) |
| Tier 5 - 日频 | 每日1~2次 | 7 | 供应商基础信息、人员资质、BOM、物料、工艺装备、工艺(各1次/日)、供应商共享库存(2次/日) |
| Tier 6 - 事件驱动 | 人工触发 | 3 | M+6月/日物料/采购订单 风险确认 |
3.3 完整接口清单
以下为本项目全部34个数据接口的完整清单：
| 序号 | 模块 | 接口名称 | 数据流向 | 数据类型 | 传输频率 | 每日频次 | 实现方式 |
|---|---|---|---|---|---|---|---|
| 1 | 生产质量 | 来料检验数据 | 供应商→奇瑞 | 业务数据 | 增量每4小时 | 6次/日 | 畅链自动化 |
| 2 | 生产质量 | 排产数据 | 供应商→奇瑞 | 主数据 | 全量每1小时 | 24次/日 | 畅链自动化 |
| 3 | 生产质量 | 供应商基础信息 | 供应商→奇瑞 | 主数据 | 全量每日22:00 | 1次/日 | 畅链自动化 |
| 4 | 生产质量 | 人员资质信息 | 供应商→奇瑞 | 主数据 | 全量每日21:00 | 1次/日 | 畅链自动化 |
| 5 | 生产质量 | BOM主数据 | 供应商→奇瑞 | 主数据 | 全量每日23:00 | 1次/日 | 畅链自动化 |
| 6 | 生产质量 | 过程控制项质量数据 | 供应商→奇瑞 | 业务数据 | 增量每10分钟 | 144次/日 | 畅链自动化 |
| 7 | 生产质量 | 生产过程数据 | 供应商→奇瑞 | 业务数据 | 增量每10分钟 | 144次/日 | 畅链自动化 |
| 8 | 生产质量 | 产品一次合格率 | 供应商→奇瑞 | 业务数据 | 全量每10分钟 | 144次/日 | 畅链自动化 |
| 9 | 生产质量 | 工位一次合格率 | 供应商→奇瑞 | 业务数据 | 全量每10分钟 | 144次/日 | 畅链自动化 |
| 10 | 生产质量 | 缺陷业务数据 | 供应商→奇瑞 | 业务数据 | 增量每10分钟 | 144次/日 | 畅链自动化 |
| 11 | 生产质量 | 环境业务数据 | 供应商→奇瑞 | 业务数据 | 增量每10分钟 | 144次/日 | 畅链自动化 |
| 12 | 生产质量 | 设备OEE达成率 | 供应商→奇瑞 | 业务数据 | 全量每1小时 | 24次/日 | 畅链自动化 |
| 13 | 生产质量 | OEE时间明细 | 供应商→奇瑞 | 业务数据 | 全量每2小时 | 12次/日 | 畅链自动化 |
| 14 | 生产质量 | 物料主数据 | 供应商→奇瑞 | 主数据 | 全量每日1次 | 1次/日 | 畅链自动化 |
| 15 | 生产质量 | 附件类数据 | 供应商→奇瑞 | 业务数据 | 增量每4小时 | 6次/日 | 畅链自动化 |
| 16 | 生产质量 | 工艺装备 | 供应商→奇瑞 | 主数据 | 全量每日1次 | 1次/日 | 畅链自动化 |
| 17 | 生产质量 | 工艺 | 供应商→奇瑞 | 主数据 | 全量每日1次 | 1次/日 | 畅链自动化 |
| 18 | 计划物流 | 整车月度生产计划-2 | 奇瑞→供应商 | 业务数据 | 每30分钟拉取 | 按窗口期 | 畅链自动化 |
| 19 | 计划物流 | M+6月物料需求计划 | 奇瑞→供应商 | 业务数据 | 每30分钟拉取 | 按窗口期 | 畅链自动化 |
| 20 | 计划物流 | M+6月物料需求计划风险确认 | 供应商→奇瑞 | 业务数据 | 人工确认后推送 | 事件驱动 | WebEDI |
| 21 | 计划物流 | 日物料需求计划 | 奇瑞→供应商 | 业务数据 | 每日13:00后每30分钟 | 按窗口期 | 畅链自动化 |
| 22 | 计划物流 | 日物料需求计划风险确认 | 供应商→奇瑞 | 业务数据 | 人工确认后推送 | 事件驱动 | WebEDI |
| 23 | 计划物流 | 计划协议 | 奇瑞→供应商 | 业务数据 | 每日3:00后每30分钟 | 按窗口期 | 畅链自动化 |
| 24 | 计划物流 | 采购订单 | 奇瑞→供应商 | 业务数据 | 每日3:00后每30分钟 | 按窗口期 | 畅链自动化 |
| 25 | 计划物流 | 采购订单风险确认 | 供应商→奇瑞 | 业务数据 | 人工确认后推送 | 事件驱动 | WebEDI |
| 26 | 计划物流 | 过焊装未过总装 | 奇瑞→供应商 | 业务数据 | 每15分钟拉取 | 96次/日 | 畅链自动化 |
| 27 | 计划物流 | 过涂装未过总装 | 奇瑞→供应商 | 业务数据 | 每15分钟拉取 | 96次/日 | 畅链自动化 |
| 28 | 计划物流 | 排序供货 | 奇瑞→供应商 | 业务数据 | 每15分钟拉取 | 96次/日 | 畅链自动化 |
| 29 | 计划物流 | 看板配送单 | 奇瑞→供应商 | 业务数据 | 每10分钟拉取 | 144次/日 | 畅链自动化 |
| 30 | 计划物流 | 退货单 | 奇瑞→供应商 | 业务数据 | 每10分钟拉取 | 144次/日 | 畅链自动化 |
| 31 | 计划物流 | 奇瑞RDC共享库存 | 奇瑞→供应商 | 业务数据 | 每日15:00后每30分钟 | 按窗口期 | 畅链自动化 |
| 32 | 计划物流 | 供应商共享库存 | 供应商→奇瑞 | 业务数据 | 全量每日2次(9:00/21:00) | 2次/日 | 畅链自动化 |
| 33 | 计划物流 | 日MRP状态监控 | 奇瑞→供应商 | 业务数据 | 每30分钟拉取 | 48次/日 | 畅链自动化 |
| 34 | 计划物流 | 日MRP预警推移 | 奇瑞→供应商 | 业务数据 | 每日15:00后每30分钟 | 按窗口期 | 畅链自动化 |
第4章 生产质量模块接口详细设计（供应商→奇瑞，17个接口）
4.1 主数据接口（6个）
4.1.1 供应商基础信息
| 接口描述 | 用于工厂、车间、产线、工位等基础数据同步。此处"供应商"指奇瑞的一级供应商（即XXX）。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、产线顺序、工位名称、工位顺序、是否关键工位 |
| 传输规则 | 全量传输。首次传输全量数据，后续每天22:00执行，以"供应商代码+工厂代码+车间代码+产线代码+工位代码+奇瑞零件号+供应商总成零件号"为唯一标识，仅传输新增或有变化的数据。如无新增或无变化则不传输。 |
| 每日频次 | 1次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
畅链实施平台配置要点：在实施平台中为此接口配置定时调度任务，Cron表达式设为每日22:00执行（0 0 22 * * ?）。数据采集SQL应从畅链ERP系统的供应商基础信息表中提取全量数据，通过唯一标识组合键与上次传输记录进行比对，筛选出新增或有变化的记录。映射规则中需配置字段名称的中英文转换及格式校验。
4.1.2 人员资质信息
| 接口描述 | 用于同步人员在工位范围内拥有的资质信息，包括资质等级等详细数据。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 工厂名称、车间名称、产线名称、工位名称、岗位名称、工位人员账号、是否有资质、资质等级 |
| 传输规则 | 全量传输。首次全量，后续每天21:00执行，以"供应商代码+工厂代码+车间代码+产线代码+工位代码+操作人员账号"为唯一标识，仅传输新增或有变化的数据。 |
| 每日频次 | 1次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
4.1.3 BOM主数据
| 接口描述 | 供货奇瑞的零件BOM信息，从产成品到关键下级件的父子层级、单位用量，用于计算库存齐套、追溯生产过程信息。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 供应商父件编码、父件类型、子件编码、子件类型、子件用量、BOM编码、BOM版本、奇瑞零件号 |
| 传输规则 | 全量传输。首次全量，后续每天23:00执行，以"供应商代码+BOM编码+BOM版本+奇瑞零件号+供应商父件编码+子件编码"为唯一标识。根据总成零件全量传递，每次BOM版本递增，不支持更新历史数据。 |
| 每日频次 | 1次 |
| 存储规则 | 以上述唯一标识做新增存储（注意：仅新增，不更新历史记录） |
| 特别注意 BOM主数据的存储规则与其他主数据不同：仅支持新增，不支持更新。每次BOM发生变更时，BOM版本号递增，以新记录形式存入系统，历史版本数据保持不变。这一设计是为了确保BOM变更的完整追溯性。 | |
| --- |
4.1.4 物料主数据
| 接口描述 | 用于记录供应商物料与奇瑞零件对应关系明细。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 奇瑞零件号、供应商零件号、零件版本号、车型、项目名称、芯片采购类型 |
| 传输规则 | 全量传输。首次全量，后续每日一次，以"供应商代码+工厂代码+奇瑞零件号+供应商零件号"为唯一标识。 |
| 每日频次 | 1次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
4.1.5 工艺装备
| 接口描述 | 用于记录供应商的工艺装备信息数据，涵盖模具、检具、夹具和设备四大类工艺装备。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 供应商代码、工艺装备分类（模具/检具/夹具/设备）、工艺装备名称、工艺装备状态、每月有效工作天数、每天最大加工工时、设备类型、单位小时产出、当前剩余寿命 |
| 传输规则 | 全量传输。首次全量，后续每日一次，以"供应商代码+工艺装备分类+工艺装备代码"为唯一标识。 |
| 每日频次 | 1次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
4.1.6 工艺
| 接口描述 | 用于记录供应商工序及产能数据，包含工艺-工序-工艺装备三级结构。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 奇瑞零件号、供应商零件号、供应商代码、工艺编码、工艺版本、最大加工能力、工序编码、工序名称、工序顺序号、工序节拍、工序所在地、工序间流转时间、工艺装备分类、工艺装备代码、工艺装备名称 |
| 传输规则 | 全量传输。首次全量，后续每日一次，以"供应商代码+奇瑞零件号+工艺编码+工序编码+工艺装备代码"为唯一标识。 |
| 每日频次 | 1次 |
| 存储规则 | 主表以上述唯一标识做新增或更新存储；二级表（工序表）及三级表（工艺装备关联表）根据一级表的唯一标识进行校验，进行新增或覆盖更新。 |
4.2 高频业务数据接口（6个，每10分钟）
4.2.1 过程控制项质量数据
| 接口描述 | 关键控制项（奇瑞图纸要求的工艺参数和产品特性，具体范围与SQE商定）在供应商生产过程中采集的检测数据。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 奇瑞零件号、供应商零件号、奇瑞总成SN码、供应商总成SN码、供应商总成批次号、控制项名称、SPC、控制项标准值、控制项上限、控制项下限、控制项实测值 |
| 传输规则 | 增量传输。每10分钟执行一次，传输该时间段内新增的检测数据。 |
| 每日频次 | 144次 |
| 存储规则 | 存储新增数据 |
4.2.2 生产过程数据
| 接口描述 | 用于记录供应商生产过程扣料信息、追溯信息。数据在物料出工位后才触发传输。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 奇瑞零件号、供应商零件号、奇瑞总成SN码、供应商总成SN码、子件编码、子件批次号/SN码、分供方名称、工位名称、进工位时间、出工位时间 |
| 传输规则 | 增量传输。每10分钟执行一次，传输该时间段内物料出工位后的新增数据。 |
| 每日频次 | 144次 |
| 存储规则 | 存储新增数据 |
| 特殊说明 生产过程数据的传输时机与其他接口不同：数据并非实时产生即传输，而是在物料出工位后才触发传输。畅链实施平台需根据出工位时间字段来判断数据是否已满足传输条件。 | |
| --- |
4.2.3 产品一次合格率
| 接口描述 | 用于记录供应商生产过程中，以产品为维度统计的合格率数据。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、生产工单号、生产批次号、生产日期、班次、合格数、不合格数 |
| 传输规则 | 全量传输。首次全量，后续每10分钟执行，以"供应商代码+工厂代码+车间代码+产线代码+奇瑞零件号+生产批次号+工单号+生产日期+班次"为唯一标识。 |
| 数据处理规则 | 按（供应商+工厂+车间+产线+奇瑞零件号+生产工单号/批次号+生产日期+班次）汇总当前数据的不合格数、合格数。 |
| 每日频次 | 144次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
| 易混淆字段说明 "生产工单号"与"生产批次号"：均为必填项。若业务中没有相应的值，统一传"/"。 "生产日期"：指该班次开始时的日期，格式统一为"yyyy-mm-dd 00:00:00"。注意跨天班次的归属规则：例如12月1日22:00开始的夜班与12月2日03:00仍在进行的同一夜班，其生产日期均应为"2024-12-01 00:00:00"，即以班次开始时的日期为准。 | |
| --- |
4.2.4 工位一次合格率
| 接口描述 | 用于记录供应商生产过程中，以工位为维度统计的合格率数据。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、工位名称、生产工单号、生产批次号、生产日期、班次、合格数、不合格数 |
| 传输规则 | 全量传输。首次全量，后续每10分钟执行，以"供应商代码+工厂代码+车间代码+产线代码+工位代码+奇瑞零件号+生产批次号+工单号+生产日期+班次"为唯一标识。 |
| 数据处理规则 | 同产品一次合格率，增加工位维度的汇总。 |
| 每日频次 | 144次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
易混淆字段说明同产品一次合格率（4.2.3节）。
4.2.5 缺陷业务数据
| 接口描述 | 用于记录供应商生产过程中缺陷数据，以工单及产品总数更新。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 奇瑞零件号、供应商零件号、生产批次号、生产工单号、缺陷名称、缺陷分类、缺陷件数、缺陷录入时间 |
| 传输规则 | 增量传输。每10分钟执行一次，传输新增的缺陷数据。 |
| 每日频次 | 144次 |
| 存储规则 | 存储新增数据 |
4.2.6 环境业务数据
| 接口描述 | 用于记录供应商生产过程中环境监测数据，如温度、湿度、洁净度等。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 工厂名称、车间名称、产线名称、环境指标名称、指标实测值、上限、下限 |
| 传输规则 | 增量传输。每10分钟执行一次，传输新增的环境监测数据。 |
| 每日频次 | 144次 |
| 存储规则 | 存储新增数据 |
4.3 中高频业务数据接口（2个）
4.3.1 排产数据
| 接口描述 | 用于供应商排产计划及其完成情况推送，涵盖计划制定与实际执行的完整生命周期。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 主数据 |
| 关键字段 | 奇瑞零件号、供应商零件号、生产批次号、批次计划数量、排产状态、计划开始时间、计划结束时间、实际开始时间、实际结束时间 |
| 传输规则 | 全量传输。首次全量，后续每1小时执行，以"供应商+工厂+奇瑞零件号+计划单号+工单号+批次号"为唯一标识。 |
| 每日频次 | 24次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
| 易混淆字段说明 "生产工单号"与"生产批次号"：均为必填项，若没有相应的值统一传"/"。 "排产状态"枚举值说明： • "已完工"：表示正常生产完成。此时合格数+不合格数应等于批次计划数量，若有差值则应能关联到缺陷件数据。 • "已终止"：表示未按计划完工而提前关闭。此时合格数+不合格数不等于计划数量，表示该批次未完成全部生产任务。 | |
| --- |
4.3.2 设备OEE达成率
| 接口描述 | 用于记录供应商设备OEE（Overall Equipment Effectiveness，设备综合效率）达成率。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、工位名称、设备名称、OEE实际值、OEE目标值、生产日期、班次 |
| 传输规则 | 全量传输。每1小时执行一次，以"供应商代码+工厂代码+车间代码+产线代码+工位代码+设备代码+奇瑞零件号+生产批次号+工单号+生产日期+班次"为唯一标识。 |
| 每日频次 | 24次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
4.4 中低频业务数据接口（3个）
4.4.1 来料检验数据
| 接口描述 | 用于供应商进货检验数据推送，记录分供方来料的检验参数和结果。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 子件编码、子件批次号/SN码、分供方名称、参数/特性名称、参数/特性标准值、参数/特性实测值、来料检验结果 |
| 传输规则 | 增量传输。每4小时执行一次，传输检验完成时间在该4小时时间窗内的新增数据。未检验完成的数据不传输。 |
| 每日频次 | 6次 |
| 存储规则 | 存储新增数据，按供应商检验时间倒序排列 |
4.4.2 OEE时间明细
| 接口描述 | 用于记录供应商设备的OEE时间明细，包括各设备的计划工作、计划停机、非计划停机的开始和结束时间。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 工厂名称、车间名称、产线名称、工位名称、工艺装备分类、工艺装备代码、工艺装备名称、记录ID、大类（计划工作/计划停机/非计划停机）、小类、计划开始时间、计划结束时间、实际开始时间、实际结束时间 |
| 传输规则 | 全量传输。每2小时执行一次，以"供应商代码+记录ID"为唯一标识。 |
| 每日频次 | 12次 |
| 存储规则 | 以上述唯一标识做新增或更新存储 |
4.4.3 附件类数据
| 接口描述 | 用于传输供应商人员资质证明、监控视频等附件数据。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 数据类型（产前管理/人员资质/监控视频）、文件名、图文地址 |
| 传输规则 | 增量传输。每4小时执行一次，传输完成时间在该4小时时间窗内的新增数据。 |
| 每日频次 | 6次 |
| 存储规则 | 存储新增数据 |
第5章 计划物流模块接口详细设计（17个接口）
5.1 计划类数据接口（奇瑞→供应商，拉取，5个）
5.1.1 整车月度生产计划-2
| 接口描述 | 奇瑞将整车月度生产计划共享给供应商，用于供应商提前了解整车排产趋势并做好物料准备。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 需求发布版次、车型、物料号、工厂、起始月份、数量 |
| 传输规则 | 每月24日至次月15日为业务发布或更新窗口期，建议在此窗口期内每天每30分钟拉取一次。 |
| 特殊说明 | 业务一般从当月24日开始下发计划至次月15日都有可能变动，设置每天每30分钟的频率，确保及时获取最新数据版本。 |
畅链ERP展示：拉取后的整车月度生产计划数据存入畅链ERP系统的计划管理模块，业务人员可按车型、物料号、工厂等维度查看计划明细，并对比不同版次的计划变动情况。
5.1.2 M+6月物料需求计划
| 接口描述 | 奇瑞将未来6个月的物料需求计划共享给供应商，用于中长期产能和物料规划。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 需求发布版次、零件号、工厂、起始月份、需求数量 |
| 传输规则 | 同整车月度计划，每月24日至次月15日为窗口期，每30分钟拉取一次。 |
| 特殊说明 | 同整车月度计划的窗口期说明。 |
5.1.3 日物料需求计划
| 接口描述 | 奇瑞将日物料需求计划共享给供应商，用于供应商按日安排生产和配送。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 需求发布版次、零件号、工厂、起始日期、需求数量 |
| 传输规则 | 每日下午13:00之后，每天每30分钟拉取一次。 |
5.1.4 计划协议（周物料需求计划）
| 接口描述 | 奇瑞将计划协议（周物料需求计划）共享给供应商，用于周级别的物料需求和交货安排。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 计划协议号、零件号、工厂、需求数量、交货日期 |
| 传输规则 | 每日凌晨3:00之后，每天每30分钟拉取一次。 |
| 特殊说明 | 上游系统当天推送的数据为前一日新增或修改的数据。 |
5.1.5 采购订单
| 接口描述 | 奇瑞将采购订单信息共享给供应商，包含具体的物料需求数量和交货要求。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 采购订单号、工厂、物料编码、需求数量、交货日期、交货地点、到货数量 |
| 传输规则 | 每日凌晨3:00之后，每天每30分钟拉取一次。 |
| 特殊说明 | 同计划协议，上游系统当天推送的数据为前一日新增或修改的数据。 |
5.2 物流执行类数据接口（奇瑞→供应商，拉取，3个）
5.2.1 排序供货
| 接口描述 | 奇瑞将排序信息（JIS/JIT）共享给供应商，供应商据此安排零部件的配送顺序和时间。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 车型、VIN、产线、物料编码、排序日期时间、上线日期时间 |
| 传输规则 | 每15分钟拉取1次，确保供应商能及时获取最新的排序需求。 |
5.2.2 看板配送单
| 接口描述 | 奇瑞将看板配送单数据共享给供应商，指导供应商按看板模式进行配送。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 配送单号、配送单状态、零件号、工厂、收货道口、数量、要求到货时间、道口发货时间、道口收货时间 |
| 传输规则 | 每10分钟拉取一次。 |
5.2.3 退货单
| 接口描述 | 奇瑞将退货单数据共享给供应商，通知供应商进行退货处理。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 退货单号、退货单状态、零件号、数量、工厂、取货地、需求取货时间、退货类型 |
| 传输规则 | 每10分钟拉取一次。 |
5.3 库存与MRP监控类数据接口（奇瑞→供应商，拉取，3个）
5.3.1 奇瑞RDC共享库存
| 接口描述 | 奇瑞将RDC（区域配送中心）库存数据共享给供应商，便于供应商了解奇瑞侧的库存水平。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 工厂、零件号、当前库存数量、库存状态 |
| 传输规则 | 每日下午15:00之后，每30分钟拉取一次。 |
5.3.2 日MRP状态监控
| 接口描述 | 奇瑞基于日物料需求计划及配送情况进行日MRP全过程监控，并把监控数据共享给供应商。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 工厂、零件号、需求状态、需求日期、需求数量、已建单数量、已发货数量、已收货数量、在途数量 |
| 传输规则 | 每30分钟拉取一次，全天执行。 |
5.3.3 日MRP预警推移
| 接口描述 | 奇瑞基于库存进行日MRP预警推移分析，将供需缺口（GAP）数据共享给供应商。 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 工厂、零件号、当前库存、需求数量、满足数量、在途数量、GAP（缺口数量） |
| 传输规则 | 每日下午15:00之后，每30分钟拉取一次。 |
5.4 供应商推送类数据接口（供应商→奇瑞，4个）
5.4.1 供应商共享库存（畅链自动化推送）
| 接口描述 | 供应商将成品库存（奇瑞采购件）、半成品及原材料库存（BOM关键件）共享给奇瑞，用于奇瑞进行供应链库存分析。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 供应商代码、零件号、物料类型（成品/半成品/原材料）、当前库存数量、安全库存、生产/采购周期 |
| 传输规则 | 全量传输。每日上午9:00、晚上21:00各推送一次时点库存数据。 |
| 每日频次 | 2次 |
畅链ERP配合：库存数据在畅链ERP系统的库存管理模块中维护和管理。业务人员需确保在每日9:00和21:00推送前，库存数据已更新为最新的时点数据。
5.4.2 M+6月物料需求计划风险确认（WebEDI人工操作）
| 接口描述 | 供应商基于自身产能、原材料供应等因素，对奇瑞下发的M+6月物料需求计划进行风险确认。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 供应商代码、需求发布版次、零件号、工厂、反馈结果、风险类型、应对措施、满足数量 |
| 传输规则 | 全量传输。基于获取到的M+6月物料需求计划，需要供应商业务人员及时确认反馈后推送。 |
| 特殊说明 | 取自M+6月物料需求计划接口中的最新需求发布版次，针对该版次的需求进行风险反馈。 |
WebEDI操作流程：
- 系统自动拉取M+6月物料需求计划最新版次数据，并在WebEDI界面中展示待确认列表
- 业务人员在WebEDI界面逐行查看需求明细，评估自身产能是否满足
- 逐行或批量填写反馈结果（满足/不满足）、风险类型（产能不足/原材料短缺/其他）、应对措施、满足数量
- 确认提交后，畅链实施平台自动将反馈数据按照奇瑞API规范构造JSON报文，推送至奇瑞系统
5.4.3 日物料需求计划风险确认（WebEDI人工操作）
| 接口描述 | 供应商基于自身产能等因素，对每日下发的日物料需求计划进行风险确认。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 供应商代码、需求发布版次、零件号、工厂、反馈结果、风险类型、应对措施、满足数量 |
| 传输规则 | 全量传输。基于每日拉取的日物料需求计划，需要供应商业务人员及时确认反馈后推送。 |
| 特殊说明 | 取自日物料需求计划接口中的最新需求发布版次，针对该版次的需求进行风险反馈。 |
5.4.4 采购订单风险确认（WebEDI人工操作）
| 接口描述 | 供应商基于自身产能等因素，对每日下发的采购订单进行风险确认。 |
|---|---|
| 数据流向 | 供应商→奇瑞 |
| 数据类型 | 业务数据表 |
| 关键字段 | 供应商代码、采购订单号、反馈结果、风险类型、应对措施、满足数量 |
| 传输规则 | 全量传输。基于每日拉取的采购订单，需要供应商业务人员及时确认反馈后推送。 |
5.5 过点信息类数据接口（奇瑞→供应商，拉取，2个）
5.5.1 过焊装未过总装
| 接口描述 | 奇瑞将过点信息共享给供应商，供应商据此安排配送时间 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 车型、VIN、产线、物料编码、上线日期时间 |
5.5.2 过涂装未过总装
| 接口描述 | 奇瑞将过点信息共享给供应商，供应商据此安排配送时间 |
|---|---|
| 数据流向 | 奇瑞→供应商 |
| 数据类型 | 业务数据表 |
| 关键字段 | 车型、VIN、产线、物料编码、上线日期时间、总装车间 |
第6章 数据映射与转换规则
6.1 编码映射规则
在本项目中，奇瑞零件号与供应商（XXX）零件号之间存在一对一或一对多的映射关系。所有编码映射关系在畅链ERP系统中统一维护，具体规则如下：
映射表维护：在畅链ERP系统的"物料主数据"模块中建立奇瑞零件号与供应商零件号的对照表，作为所有接口数据转换的基础
映射方向：推送方向接口（供应商→奇瑞）在数据构造时，需将供应商内部编码映射为奇瑞标准编码；拉取方向接口（奇瑞→供应商）在数据存储时，需将奇瑞编码映射为供应商内部编码以便业务使用
变更管理：编码映射关系发生变更时（如新增零件、零件号变更等），需在畅链ERP中及时更新映射表，同时通过物料主数据接口同步至奇瑞
6.2 日期时间格式
统一格式：全部接口的日期时间字段统一采用 yyyy-mm-dd HH:mm:ss 格式。
生产日期特殊处理规则：
"生产日期"字段指该班次开始时的日期，格式为 yyyy-mm-dd 00:00:00（时分秒部分固定为00:00:00）。对于跨天班次（如夜班），归属日期以班次开始的日期为准。
举例说明：
| 实际时间 | 班次 | 生产日期字段值 |
|---|---|---|
| 2024年12月1日 22:00 | 夜班（当日开始） | 2024-12-01 00:00:00 |
| 2024年12月2日 03:00 | 夜班（次日凌晨，仍属12月1日夜班） | 2024-12-01 00:00:00 |
| 2024年12月2日 08:00 | 白班 | 2024-12-02 00:00:00 |
6.3 特殊字段处理规则
以下字段在多个接口中共同使用，需遵循统一的处理规则：
| 字段名 | 处理规则 | 涉及接口 |
|---|---|---|
| 生产工单号 / 生产批次号 | 均为必填项。若业务中没有相应的值，统一传"/" | 产品一次合格率、工位一次合格率、排产数据、设备OEE达成率 |
| 排产状态 | 枚举值： "已完工"——正常完成，合格数+不合格数=计划数量 "已终止"——提前关闭，合格数+不合格数≠计划数量 | 排产数据 |
| BOM版本 | 每次递增（如V1→V2→V3），不支持更新历史版本数据，仅以新记录方式新增 | BOM主数据 |
| 工艺装备分类 | 枚举值：模具 / 检具 / 夹具 / 设备 | 工艺装备、工艺、OEE时间明细 |
| 物料类型 | 枚举值：成品 / 半成品 / 原材料 | 供应商共享库存 |
| 数据类型（附件） | 枚举值：产前管理 / 人员资质 / 监控视频 | 附件类数据 |
| 需求发布版次 | 取最新版次进行风险确认反馈 | M+6月/日物料需求计划风险确认 |
6.4 唯一标识规则
以下为全部34个接口的唯一标识（组合键）规则汇总：
| 序号 | 接口名称 | 唯一标识（组合键） |
|---|---|---|
| 1 | 来料检验数据 | 增量新增，无唯一标识校验（按检验完成时间筛选新增） |
| 2 | 排产数据 | 供应商+工厂+奇瑞零件号+计划单号+工单号+批次号 |
| 3 | 供应商基础信息 | 供应商代码+工厂代码+车间代码+产线代码+工位代码+奇瑞零件号+供应商总成零件号 |
| 4 | 人员资质信息 | 供应商代码+工厂代码+车间代码+产线代码+工位代码+操作人员账号 |
| 5 | BOM主数据 | 供应商代码+BOM编码+BOM版本+奇瑞零件号+供应商父件编码+子件编码 |
| 6 | 过程控制项质量数据 | 增量新增，无唯一标识校验 |
| 7 | 生产过程数据 | 增量新增，无唯一标识校验 |
| 8 | 产品一次合格率 | 供应商代码+工厂代码+车间代码+产线代码+奇瑞零件号+生产批次号+工单号+生产日期+班次 |
| 9 | 工位一次合格率 | 供应商代码+工厂代码+车间代码+产线代码+工位代码+奇瑞零件号+生产批次号+工单号+生产日期+班次 |
| 10 | 缺陷业务数据 | 增量新增，无唯一标识校验 |
| 11 | 环境业务数据 | 增量新增，无唯一标识校验 |
| 12 | 设备OEE达成率 | 供应商代码+工厂代码+车间代码+产线代码+工位代码+设备代码+奇瑞零件号+生产批次号+工单号+生产日期+班次 |
| 13 | OEE时间明细 | 供应商代码+记录ID |
| 14 | 物料主数据 | 供应商代码+工厂代码+奇瑞零件号+供应商零件号 |
| 15 | 附件类数据 | 增量新增，无唯一标识校验 |
| 16 | 工艺装备 | 供应商代码+工艺装备分类+工艺装备代码 |
| 17 | 工艺 | 供应商代码+奇瑞零件号+工艺编码+工序编码+工艺装备代码 |
| 18 | 整车月度生产计划-2 | 由奇瑞侧定义（拉取接口，按版次管理） |
| 19 | M+6月物料需求计划 | 由奇瑞侧定义（拉取接口，按版次管理） |
| 20 | M+6月物料需求计划风险确认 | 供应商代码+需求发布版次+零件号+工厂 |
| 21 | 日物料需求计划 | 由奇瑞侧定义（拉取接口，按版次管理） |
| 22 | 日物料需求计划风险确认 | 供应商代码+需求发布版次+零件号+工厂 |
| 23 | 计划协议 | 由奇瑞侧定义（拉取接口） |
| 24 | 采购订单 | 由奇瑞侧定义（拉取接口） |
| 25 | 采购订单风险确认 | 供应商代码+采购订单号 |
| 26 | 过焊装未过总装 | 由奇瑞侧定义（拉取接口） |
| 27 | 过涂装未过总装 | 由奇瑞侧定义（拉取接口） |
| 28 | 排序供货 | 由奇瑞侧定义（拉取接口） |
| 29 | 看板配送单 | 由奇瑞侧定义（拉取接口） |
| 30 | 退货单 | 由奇瑞侧定义（拉取接口） |
| 31 | 奇瑞RDC共享库存 | 由奇瑞侧定义（拉取接口） |
| 32 | 供应商共享库存 | 供应商代码+零件号+物料类型 |
| 33 | 日MRP状态监控 | 由奇瑞侧定义（拉取接口） |
| 34 | 日MRP预警推移 | 由奇瑞侧定义（拉取接口） |
6.5 全量/增量策略
本项目的数据传输采用两种基本策略：
策略一：全量+变化传输
首次传输全量数据，后续仅传输新增或有变化的数据。系统通过唯一标识组合键与上次传输记录进行比对，自动识别需要传输的新增记录和变更记录。此策略适用于以下场景：
全部主数据接口（供应商基础信息、人员资质、BOM、物料、工艺装备、工艺）
合格率类接口（产品一次合格率、工位一次合格率）——以唯一标识更新汇总数据
排产数据、设备OEE达成率——以唯一标识更新状态和数值
OEE时间明细——以记录ID更新时间数据
供应商共享库存——全量时点快照推送
风险确认类接口——全量反馈最新版次的确认结果
策略二：纯增量传输
每次仅传输指定时间窗口内新产生的数据，不做历史数据比对和更新。此策略适用于实时采集类、高频写入类数据：
过程控制项质量数据——每10分钟增量
生产过程数据——每10分钟增量（出工位后触发）
缺陷业务数据——每10分钟增量
环境业务数据——每10分钟增量
来料检验数据——每4小时增量
附件类数据——每4小时增量
第7章 调度策略与频率配置
7.1 调度任务总表
以下为全部34个接口的调度任务配置详情：
| 序号 | 接口名称 | 调度类型 | Cron表达式/触发条件 | 时间窗口约束 | 首次同步策略 |
|---|---|---|---|---|---|
| 1 | 来料检验数据 | 定时 | 0 0 0/4 * * ? | 无 | 全量回溯 |
| 2 | 排产数据 | 定时 | 0 0 * * * ? | 无 | 全量推送 |
| 3 | 供应商基础信息 | 定时 | 0 0 22 * * ? | 每日22:00 | 全量推送 |
| 4 | 人员资质信息 | 定时 | 0 0 21 * * ? | 每日21:00 | 全量推送 |
| 5 | BOM主数据 | 定时 | 0 0 23 * * ? | 每日23:00 | 全量推送 |
| 6 | 过程控制项质量数据 | 定时 | 0 0/10 * * * ? | 无 | 增量起始 |
| 7 | 生产过程数据 | 定时 | 0 0/10 * * * ? | 无 | 增量起始 |
| 8 | 产品一次合格率 | 定时 | 0 0/10 * * * ? | 无 | 全量推送 |
| 9 | 工位一次合格率 | 定时 | 0 0/10 * * * ? | 无 | 全量推送 |
| 10 | 缺陷业务数据 | 定时 | 0 0/10 * * * ? | 无 | 增量起始 |
| 11 | 环境业务数据 | 定时 | 0 0/10 * * * ? | 无 | 增量起始 |
| 12 | 设备OEE达成率 | 定时 | 0 0 * * * ? | 无 | 全量推送 |
| 13 | OEE时间明细 | 定时 | 0 0 0/2 * * ? | 无 | 全量推送 |
| 14 | 物料主数据 | 定时 | 0 0 20 * * ? | 每日20:00 | 全量推送 |
| 15 | 附件类数据 | 定时 | 0 0 0/4 * * ? | 无 | 增量起始 |
| 16 | 工艺装备 | 定时 | 0 0 20 * * ? | 每日20:00 | 全量推送 |
| 17 | 工艺 | 定时 | 0 0 20 * * ? | 每日20:00 | 全量推送 |
| 18 | 整车月度生产计划-2 | 定时 | 0 0/30 * * * ? | 每月24日~次月15日 | 全量拉取 |
| 19 | M+6月物料需求计划 | 定时 | 0 0/30 * * * ? | 每月24日~次月15日 | 全量拉取 |
| 20 | M+6月物料需求计划风险确认 | 手动触发 | WebEDI提交后触发 | 无 | 不适用 |
| 21 | 日物料需求计划 | 定时 | 0 0/30 13-23 * * ? | 每日13:00后 | 全量拉取 |
| 22 | 日物料需求计划风险确认 | 手动触发 | WebEDI提交后触发 | 无 | 不适用 |
| 23 | 计划协议 | 定时 | 0 0/30 3-23 * * ? | 每日3:00后 | 全量拉取 |
| 24 | 采购订单 | 定时 | 0 0/30 3-23 * * ? | 每日3:00后 | 全量拉取 |
| 25 | 采购订单风险确认 | 手动触发 | WebEDI提交后触发 | 无 | 不适用 |
| 26 | 过焊装未过总装 | 定时 | 0 0/15 * * * ? | 无 | 全量拉取 |
| 27 | 过涂装未过总装 | 定时 | 0 0/15 * * * ? | 无 | 全量拉取 |
| 28 | 排序供货 | 定时 | 0 0/15 * * * ? | 无 | 全量拉取 |
| 29 | 看板配送单 | 定时 | 0 0/10 * * * ? | 无 | 全量拉取 |
| 30 | 退货单 | 定时 | 0 0/10 * * * ? | 无 | 全量拉取 |
| 31 | 奇瑞RDC共享库存 | 定时 | 0 0/30 15-23 * * ? | 每日15:00后 | 全量拉取 |
| 32 | 供应商共享库存 | 定时 | 0 0 9,21 * * ? | 每日9:00/21:00 | 全量推送 |
| 33 | 日MRP状态监控 | 定时 | 0 0/30 * * * ? | 无 | 全量拉取 |
| 34 | 日MRP预警推移 | 定时 | 0 0/30 15-23 * * ? | 每日15:00后 | 全量拉取 |
7.2 时间窗口规划
部分接口需在特定时间窗口内执行调度，以匹配奇瑞侧数据发布节奏。详细时间窗口规划如下：
月度窗口（每月24日~次月15日）
整车月度生产计划-2：奇瑞业务一般从当月24日开始下发整车月度计划，直到次月15日仍有可能变动。在此窗口期内每30分钟拉取一次，确保及时获取最新版次。
M+6月物料需求计划：同上，在同一窗口期内每30分钟拉取。
每日13:00后窗口
- 日物料需求计划：奇瑞系统在每日下午13:00后发布日物料需求计划数据，从13:00起每30分钟拉取一次。
每日3:00后窗口
计划协议（周物料需求计划）：奇瑞上游系统在凌晨完成数据处理后，当天推送的为前一日新增或修改的数据。从3:00起每30分钟拉取。
采购订单：同上，从3:00起每30分钟拉取。
每日15:00后窗口
奇瑞RDC共享库存：奇瑞在每日下午15:00后更新RDC库存数据，从15:00起每30分钟拉取。
日MRP预警推移：同上，从15:00起每30分钟拉取。
固定时间点
供应商基础信息：每日22:00推送
人员资质信息：每日21:00推送
BOM主数据：每日23:00推送
供应商共享库存：每日9:00和21:00各推送一次
7.3 调度失败重试策略
当调度任务执行失败时（包括网络超时、认证失败、数据异常等情况），畅链实施平台将按以下策略进行自动重试：
| 参数 | 配置值 |
|---|---|
| 自动重试次数 | 3次 |
| 重试间隔 | 5分钟（固定间隔） |
| 重试失败后处理 | 记录异常日志，触发告警通知（邮件/企业微信） |
| 人工干预 | 运维人员在告警通知中查看失败原因，手动排除故障后可通过实施平台手动触发重新执行 |
第8章 异常处理与监控告警
8.1 异常分类
本项目中可能发生的异常按类型分为以下四大类：
| 异常类型 | 典型场景 | 影响范围 |
|---|---|---|
| 网络异常 | API调用超时（连接超时/读取超时）、DNS解析失败、TCP连接被拒绝、网络中断 | 单次调用失败，可通过重试恢复 |
| 认证异常 | AccessToken过期未续期、Token被撤销、AppKey/AppSecret配置错误、认证接口不可用 | 全部接口调用失败，需修复认证后才能恢复 |
| 数据异常 | 必填字段缺失、字段格式错误（如日期格式不符）、唯一标识冲突、数据长度超限、编码映射缺失 | 单条/单批数据推送失败，需修正数据后重试 |
| 业务异常 | 奇瑞API返回业务错误码（如零件号不存在、订单号重复、版次已过期等） | 单条/单批数据推送失败，需根据错误码排查业务原因 |
8.2 重试与降级策略
针对不同类型的异常，采取差异化的重试与降级策略：
自动重试机制：
重试次数：3次
重试间隔：递增策略，分别为1分钟、3分钟、5分钟
适用异常：网络异常、认证异常（Token过期时自动续期后重试）
全部重试失败后：记录异常日志（包含请求参数、响应内容、错误堆栈），触发告警通知
数据异常处理：
不自动重试（数据问题不会因重试而解决）
将异常数据记录到异常队列，标记失败原因
触发告警通知，提示运维人员修正数据
修正后可手动触发重新推送
业务异常处理：
根据奇瑞API返回的错误码判断是否可重试
可重试类错误（如服务端临时繁忙）：自动重试3次
不可重试类错误（如数据业务规则不符）：记录异常，告警通知
8.3 告警通知
畅链实施平台支持多通道告警通知，根据实际部署环境配置：
邮件告警：发送至项目运维团队邮箱，包含接口名称、失败时间、错误信息、重试次数等详情
企业微信/钉钉告警：通过Webhook推送至运维群组，实现实时通知
平台内告警：在畅链实施平台监控面板中展示告警列表，支持按时间、接口、严重程度筛选
告警分级如下：
| 级别 | 触发条件 | 通知方式 |
|---|---|---|
| P0 - 严重 | 认证失败导致全部接口不可用、核心高频接口连续失败超过30分钟 | 邮件+即时通讯+电话 |
| P1 - 重要 | 单接口重试全部失败、数据异常率超过5% | 邮件+即时通讯 |
| P2 - 一般 | 单次调用超时后自动恢复、低频接口偶发失败 | 平台内记录 |
8.4 数据对账机制
为确保数据传输的完整性和一致性，需建立定期数据对账机制：
每日对账：对比畅链平台记录的推送/拉取数据量与奇瑞侧接收/发送的数据量，确认无遗漏
对账维度：按接口、按日期汇总记录条数，对比两端数据
差异处理：发现数据差异时，由运维团队排查原因（网络丢包、重复推送、数据被过滤等），必要时进行数据补推
对账报告：每周生成数据传输质量报告，统计各接口的成功率、平均响应时间、数据量趋势
第9章 安全与权限设计
9.1 API认证与鉴权
本项目采用AccessToken作为API认证机制，具体设计如下：
Token获取流程：
- 畅链实施平台使用奇瑞预分配的AppKey和AppSecret，调用奇瑞API网关的认证接口
- 认证通过后，获取AccessToken及其有效期（Expires_in）
- 平台将Token缓存在本地，后续API调用时在请求头中携带Token
Token续期策略：
在Token到期前提前续期（建议在到期前10分钟自动获取新Token）
续期失败时，自动重试3次，间隔1分钟
续期全部失败后，触发P0级别告警，要求运维人员立即介入
Token安全存储：
AppKey和AppSecret采用加密存储，不以明文形式出现在配置文件中
Token存储在平台内存缓存中，不持久化到磁盘
日志中对Token进行脱敏处理，仅显示前4位和后4位
9.2 数据传输加密
全部API通信均通过HTTPS协议传输，确保数据在传输过程中的机密性和完整性：
协议版本：TLS 1.2及以上
证书管理：使用受信任CA签发的SSL证书，定期检查证书有效期
禁止使用HTTP明文传输
9.3 用户权限管理
畅链ERP系统及WebEDI的用户权限按角色进行管理：
| 角色 | 畅链实施平台 | 畅链ERP系统 | WebEDI |
|---|---|---|---|
| 系统管理员 | 全部功能权限 | 全部功能权限 | 全部功能权限 |
| IT运维人员 | 接口配置、调度管理、监控告警 | 只读权限 | 只读权限 |
| 业务主管 | 无权限 | 全模块查看+导出 | 全功能操作 |
| 业务操作员 | 无权限 | 所属模块查看 | 风险确认操作 |
| 审计人员 | 日志查看（只读） | 全模块查看（只读） | 操作记录查看（只读） |
第10章 测试方案
10.1 测试环境
奇瑞方面提供独立的测试环境与生产环境，两套环境完全隔离：
测试环境：独立的API端点URL、独立的AccessToken，用于接口联调和功能验证
生产环境：正式环境的API端点URL和认证信息，仅在全部测试通过后切换使用
畅链实施平台需同时配置两套环境的参数，支持一键切换
10.2 测试内容
测试工作分为四个阶段逐步推进：
阶段一：单接口测试（34个接口逐一验证）
字段完整性验证：确认所有必填字段均已传输，字段值不为空或null
格式正确性验证：日期格式、数值精度、编码长度、枚举值范围等
唯一标识验证：确认唯一标识组合键的正确性，测试新增和更新场景
响应码验证：确认奇瑞API返回正确的成功码和错误码
阶段二：集成测试（端到端数据流通验证）
拉取→展示流程：验证从奇瑞拉取的数据能正确存入畅链ERP并展示
采集→推送流程：验证畅链ERP中维护的数据能正确推送至奇瑞
WebEDI流程：验证风险确认从查看→填写→提交→推送的完整链路
数据一致性：对比畅链平台与奇瑞系统两端的数据，确认一致
阶段三：性能测试
高频接口压力测试：模拟144次/日（每10分钟）的调用频率，验证系统在持续高频调用下的稳定性
大数据量测试：模拟单次传输大批量数据的场景，验证传输效率和超时处理
并发测试：模拟多个接口同时执行的场景，验证系统资源调度能力
阶段四：业务验证（UAT）
生产质量数据准确性：业务人员核对推送至奇瑞的质量数据与实际生产数据一致
计划物流数据时效性：验证拉取的计划和订单数据是否在规定时间窗口内更新
WebEDI操作体验：业务人员实际操作风险确认流程，验证界面易用性和数据推送成功率
异常场景模拟：模拟网络断开、Token过期等异常场景，验证系统的自恢复和告警能力
第11章 上线计划与里程碑
本项目按照以下阶段推进实施，各阶段具体时间由项目组根据实际情况确定：
| 阶段 | 时间 | 交付物 |
|---|---|---|
| 环境准备与网络打通 | 待定 | 畅链平台私有化部署完成，与奇瑞API网关网络联通，测试环境认证通过 |
| 主数据接口对接 | 待定 | 6个主数据接口（供应商基础信息、人员资质、BOM、物料、工艺装备、工艺）测试通过并上线 |
| 高频业务接口对接 | 待定 | 8个10分钟级高频接口（过程控制项质量数据、生产过程数据、产品/工位一次合格率、缺陷/环境数据、看板配送单、退货单）测试通过并上线 |
| 计划物流接口对接 | 待定 | 15个计划物流接口（含计划类、物流执行类、库存监控类、供应商推送类）测试通过并上线 |
| WebEDI功能上线 | 待定 | 3个风险确认功能（M+6月/日物料需求计划/采购订单风险确认）完成开发、测试并可正式使用 |
| UAT业务验证 | 待定 | 全量业务验证通过，业务人员确认数据准确性和操作流程可用性 |
| 正式上线 | 待定 | 全部34个接口投入生产运行，监控告警机制就绪，运维交接完成 |
附录A 全部接口字段明细表
以下为全部34个接口的完整字段清单，供开发和测试团队参考：
A.1 生产质量模块 — 主数据接口
| 接口 | 完整字段列表 |
|---|---|
| 供应商基础信息 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、产线顺序、工位名称、工位顺序、是否关键工位 |
| 人员资质信息 | 工厂名称、车间名称、产线名称、工位名称、岗位名称、工位人员账号、是否有资质、资质等级 |
| BOM主数据 | 供应商父件编码、父件类型、子件编码、子件类型、子件用量、BOM编码、BOM版本、奇瑞零件号 |
| 物料主数据 | 奇瑞零件号、供应商零件号、零件版本号、车型、项目名称、芯片采购类型 |
| 工艺装备 | 供应商代码、工艺装备分类（模具/检具/夹具/设备）、工艺装备名称、工艺装备状态、每月有效工作天数、每天最大加工工时、设备类型、单位小时产出、当前剩余寿命 |
| 工艺 | 奇瑞零件号、供应商零件号、供应商代码、工艺编码、工艺版本、最大加工能力、工序编码、工序名称、工序顺序号、工序节拍、工序所在地、工序间流转时间、工艺装备分类、工艺装备代码、工艺装备名称 |
A.2 生产质量模块 — 业务数据接口
| 接口 | 完整字段列表 |
|---|---|
| 来料检验数据 | 子件编码、子件批次号/SN码、分供方名称、参数/特性名称、参数/特性标准值、参数/特性实测值、来料检验结果 |
| 排产数据 | 奇瑞零件号、供应商零件号、生产批次号、批次计划数量、排产状态、计划开始时间、计划结束时间、实际开始时间、实际结束时间 |
| 过程控制项质量数据 | 奇瑞零件号、供应商零件号、奇瑞总成SN码、供应商总成SN码、供应商总成批次号、控制项名称、SPC、控制项标准值、控制项上限、控制项下限、控制项实测值 |
| 生产过程数据 | 奇瑞零件号、供应商零件号、奇瑞总成SN码、供应商总成SN码、子件编码、子件批次号/SN码、分供方名称、工位名称、进工位时间、出工位时间 |
| 产品一次合格率 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、生产工单号、生产批次号、生产日期、班次、合格数、不合格数 |
| 工位一次合格率 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、工位名称、生产工单号、生产批次号、生产日期、班次、合格数、不合格数 |
| 缺陷业务数据 | 奇瑞零件号、供应商零件号、生产批次号、生产工单号、缺陷名称、缺陷分类、缺陷件数、缺陷录入时间 |
| 环境业务数据 | 工厂名称、车间名称、产线名称、环境指标名称、指标实测值、上限、下限 |
| 设备OEE达成率 | 奇瑞零件号、供应商零件号、工厂名称、车间名称、产线名称、工位名称、设备名称、OEE实际值、OEE目标值、生产日期、班次 |
| OEE时间明细 | 工厂名称、车间名称、产线名称、工位名称、工艺装备分类、工艺装备代码、工艺装备名称、记录ID、大类（计划工作/计划停机/非计划停机）、小类、计划开始时间、计划结束时间、实际开始时间、实际结束时间 |
| 附件类数据 | 数据类型（产前管理/人员资质/监控视频）、文件名、图文地址 |
A.3 计划物流模块 — 奇瑞→供应商接口
| 接口 | 完整字段列表 |
|---|---|
| 整车月度生产计划-2 | 需求发布版次、车型、物料号、工厂、起始月份、数量 |
| M+6月物料需求计划 | 需求发布版次、零件号、工厂、起始月份、需求数量 |
| 日物料需求计划 | 需求发布版次、零件号、工厂、起始日期、需求数量 |
| 计划协议 | 计划协议号、零件号、工厂、需求数量、交货日期 |
| 采购订单 | 采购订单号、工厂、物料编码、需求数量、交货日期、交货地点、到货数量 |
| 过焊装未过总装 | 车型、VIN、产线、物料编码、上线日期时间 |
| 过涂装未过总装 | 车型、VIN、产线、物料编码、上线日期时间、总装车间 |
| 排序供货 | 车型、VIN、产线、物料编码、排序日期时间、上线日期时间 |
| 看板配送单 | 配送单号、配送单状态、零件号、工厂、收货道口、数量、要求到货时间、道口发货时间、道口收货时间 |
| 退货单 | 退货单号、退货单状态、零件号、数量、工厂、取货地、需求取货时间、退货类型 |
| 奇瑞RDC共享库存 | 工厂、零件号、当前库存数量、库存状态 |
| 日MRP状态监控 | 工厂、零件号、需求状态、需求日期、需求数量、已建单数量、已发货数量、已收货数量、在途数量 |
| 日MRP预警推移 | 工厂、零件号、当前库存、需求数量、满足数量、在途数量、GAP |
A.4 计划物流模块 — 供应商→奇瑞接口
| 接口 | 完整字段列表 |
|---|---|
| 供应商共享库存 | 供应商代码、零件号、物料类型（成品/半成品/原材料）、当前库存数量、安全库存、生产/采购周期 |
| M+6月物料需求计划风险确认 | 供应商代码、需求发布版次、零件号、工厂、反馈结果、风险类型、应对措施、满足数量 |
| 日物料需求计划风险确认 | 供应商代码、需求发布版次、零件号、工厂、反馈结果、风险类型、应对措施、满足数量 |
| 采购订单风险确认 | 供应商代码、采购订单号、反馈结果、风险类型、应对措施、满足数量 |
附录B 术语表
| 术语 | 全称/说明 |
|---|---|
| EDI | Electronic Data Interchange（电子数据交换）。一种企业间结构化数据传输的标准化方法，用于替代纸质文档的自动化数据交换。 |
| AccessToken | 访问令牌。一种基于令牌的身份认证机制，客户端通过AppKey/AppSecret获取Token，后续API调用携带Token进行身份验证。 |
| JSON | JavaScript Object Notation（JavaScript对象表示法）。一种轻量级的数据交换格式，易于人阅读和编写，同时便于机器解析和生成。 |
| WebEDI | 基于Web浏览器的EDI交互界面。相比传统EDI需要专用软件，WebEDI通过标准浏览器即可完成数据查看和操作，降低了使用门槛。 |
| SPC | Statistical Process Control（统计过程控制）。一种应用统计方法监控和控制生产过程的质量管理技术。 |
| OEE | Overall Equipment Effectiveness（设备综合效率）。衡量设备利用率的指标，由可用率×性能率×良品率三部分组成。 |
| BOM | Bill of Materials（物料清单）。描述产品结构的文件，列出产成品所需的全部原材料、子零件及其数量关系。 |
| MRP | Material Requirements Planning（物料需求计划）。基于主生产计划、BOM和库存信息，计算物料采购和生产计划的管理方法。 |
| RDC | Regional Distribution Center（区域配送中心）。主机厂设立的区域性仓储配送设施，用于零部件的集中存储和配送。 |
| GAP | 供需缺口。在MRP预警推移中，指需求数量与可用供应量（当前库存+在途数量）之间的差额，负值表示供应不足。 |
| SN码 | Serial Number（序列号）。用于唯一标识单个产品或零部件的编码，实现产品级别的追溯。 |
| DUNS | Data Universal Numbering System（邓白氏编码）。一种国际通用的企业标识编码体系，用于全球范围内唯一标识一个企业。 |
| SRM | Supplier Relationship Management（供应商关系管理）。管理企业与供应商之间关系的信息系统。 |
| MES | Manufacturing Execution System（制造执行系统）。位于计划层与控制层之间，负责车间生产管理和调度的信息系统。 |
| JIS/JIT | Just In Sequence / Just In Time（准时顺序/准时制）。精益生产中的供货模式，要求供应商按指定顺序和时间交付零部件。 |
| UAT | User Acceptance Testing（用户验收测试）。由最终用户执行的测试阶段，验证系统是否满足业务需求。 |
| Cron表达式 | 一种用于定义定时任务执行时间的标准化表达式格式，格式为"秒 分 时 日 月 星期"。 |
| REST API | Representational State Transfer Application Programming Interface（表述性状态转移应用编程接口）。一种基于HTTP协议的Web服务架构风格。 |
XXX有限公司 × 奇瑞汽车 EDI数据集成技术文档 V1.0 | 2026年4月15日