徐工全球采购数字化平台EDI数据集成技术文档
基于畅链数据集成平台与 WebEDI 的实施方案
| 项目名称 | 徐工全球采购数字化平台 EDI 对接项目 |
|---|---|
| 平台 | 西安畅链数据集成平台 |
| 对接模式 | 平台中转模式(畅链统一适配) |
| 对接对象 | 徐工全球采购数字化平台(DSC) |
| 认证与安全 | URL 签名 + RSA/AES 混合加密 |
| 报文格式 | JSON |
| 文档版本 | V1.0 |
| 编写日期 | 2026年8月11日 |
第1章 项目概述
1.1 项目背景与目标
徐工全球采购数字化平台面向供应商开放标准化 EDI 接口,覆盖主数据、计划、订单、送货、库存、条码、检验等关键协同场景。对于供应商侧实施而言,核心难点不只是接口打通,而是要将徐工的签名认证、混合加密、字段映射、任务调度和异常闭环统一纳入一个可持续运维的集成体系。
本项目建议采用“平台中转”模式:供应商 ERP、MES、WMS、条码系统、质检系统等业务系统不直接点对点对接徐工接口,而由畅链数据集成平台统一承接协议适配、报文封装、任务编排、监控告警与对账补偿,从而降低各业务系统改造面,提升整体可维护性和上线稳定性。
项目核心目标如下:
建立供应商侧业务系统与徐工全球采购数字化平台之间的标准化数据交换通道
实现 8 类能力接口、9 个具体接口的统一接入与治理
通过畅链实施平台统一承接签名、加密、映射、调度、日志与异常处理
通过 WebEDI 承接计划确认、订单确认等需要业务判断的人工闭环场景
形成可监控、可补数、可审计、可扩展的长期运维机制
1.2 业务范围
本次徐工对接覆盖四类核心业务能力:
基础资料与单据拉取:物料主数据、采购计划、采购订单、送货单等查询类接口
自动回传:供应商库存、出厂检验报告等结构化数据回传接口
人工确认:采购计划确认、采购订单确认等需业务人员判断并提交的接口
现场协同:关重件条码打印等与现场执行相关的实时接口
1.3 对接对象与数据流向
从数据流向看,本项目可拆分为三类通道:
徐工 → 供应商:物料主数据查询、采购计划查询、采购订单查询、送货单查询
供应商 → 徐工:供应商库存、采购计划确认、采购订单确认、出厂检验报告
双向协同:关重件条码打印,由供应商提交打印请求并接收徐工返回的条码结果
整体数据流转路径统一为:供应商业务系统 ⟷ 畅链数据集成平台 / WebEDI ⟷ 徐工全球采购数字化平台。畅链平台负责 API 调用、字段映射、签名与混合加密、任务编排、异常处理与日志留痕。
第2章 系统架构设计
2.1 总体架构说明
建议采用三层架构:
- 供应商业务系统层
负责产生库存、质检、批次、条码、计划执行等业务数据,同时接收徐工侧下发的物料、计划、订单、送货单数据,支撑排产、出库、质检与现场打印等业务动作。
- 畅链集成平台层
由畅链实施平台和 WebEDI 共同构成。实施平台负责 API 配置、签名加密、字段映射、调度编排、失败重试、日志与监控;WebEDI 负责承接计划确认、订单确认等需要人工判断和责任留痕的场景。
- 徐工协同平台层
徐工全球采购数字化平台作为统一外部协同对象,对外提供查询、确认、打印、检验等接口,并返回业务执行结果与错误码。
2.2 畅链实施平台功能说明
畅链实施平台是本项目技术实施和运维治理的核心工具,建议重点建设以下能力模块:
API 接口管理:维护各接口的地址、请求方法、Header、请求体模板、响应解析规则和超时配置
安全适配器:统一处理 URL 签名、RSA/AES 混合加密、报文解密、返回码解析等公共安全能力
数据映射引擎:配置徐工字段与供应商内部字段的一对一映射、默认值、转换规则、枚举映射和数据清洗规则
调度中心:配置查询类接口的定时轮询、回传类接口的事件触发或定时推送、失败重试与补偿策略
日志与监控:记录完整的请求报文、响应报文、业务状态、失败原因和重试轨迹,支持接口运行日报和成功率分析
2.3 WebEDI 与业务协同说明
WebEDI 在徐工项目中主要承担两类职责:
人工确认入口:用于采购计划确认、采购订单确认等需要业务人员判断“接受 / 拒绝 / 承诺数量 / 承诺日期 / 原因说明”的场景
业务责任留痕:保留提交人、提交时间、提交内容、原始报文和返回结果,满足业务追溯和审计要求
2.4 网络与通信架构
| 项目 | 技术规格 |
|---|---|
| 通信协议 | HTTPS REST API |
| 认证方式 | URL 参数签名 |
| 报文安全 | RSA + AES 混合加密 |
| 数据格式 | JSON(UTF-8) |
| 请求方式 | 以 POST 为主,部分查询接口按徐工规范调用 |
| 关键 Header | timestamp、appKey、language |
| 平台职责 | 签名、加密、解密、异常归类、日志留痕 |
第3章 接口总览与分类
3.1 完整接口清单
| 序号 | 接口名称 | 数据方向 | 接口用途 | 对接方式 |
|---|---|---|---|---|
| 1 | 物料主数据查询 | 徐工 → 供应商 | 获取徐工物料、工厂、采购组织等基础资料 | 定时查询 |
| 2 | 供应商库存 | 供应商 → 徐工 | 回传成品与半成品库存信息 | 定时推送 |
| 3 | 采购计划查询 | 徐工 → 供应商 | 拉取已发布采购计划数据 | 高频定时 |
| 4 | 采购计划确认 | 供应商 → 徐工 | 回传计划确认、拒绝原因、承诺数量等 | WebEDI 触发 |
| 5 | 采购订单查询 | 徐工 → 供应商 | 拉取采购订单、配送指令、配盘单等 | 高频定时 |
| 6 | 采购订单确认 | 供应商 → 徐工 | 回传订单反馈状态与交期承诺 | WebEDI 触发 |
| 7 | 关重件条码打印 | 供应商 ↔ 徐工 | 上传批次信息,获取徐工条码并在本地打印 | 事件触发 |
| 8 | 出厂检验报告 | 供应商 → 徐工 | 上传出厂质量检验数据 | 事件触发 / 定时推送 |
| 9 | 送货单查询 | 徐工 → 供应商 | 查询徐工已创建送货单数据 | 高频定时 |
3.2 按业务能力分类
| 分类 | 具体接口 | 数量 | 特点 |
|---|---|---|---|
| 基础资料与单据拉取 | 物料主数据查询、采购计划查询、采购订单查询、送货单查询 | 4 | 以徐工下发为主,强调断点续拉和补数 |
| 自动回传 | 供应商库存、出厂检验报告 | 2 | 以供应商业务数据为源,强调完整性校验 |
| 人工确认 | 采购计划确认、采购订单确认 | 2 | 需要业务判断,必须保留责任痕迹 |
| 现场协同 | 关重件条码打印 | 1 | 实时性强,需对接本地打印服务 |
3.3 按触发方式分层
| 层级 | 触发方式 | 代表接口 | 实施要点 |
|---|---|---|---|
| 定时查询 | 每日 / 每小时 / 高频轮询 | 物料、计划、订单、送货单查询 | 支持时间窗口、断点续传、补拉 |
| 自动推送 | 定时或批次事件触发 | 供应商库存、检验报告 | 平台统一加密回传 |
| 人工提交 | WebEDI 提交后触发 | 计划确认、订单确认 | 保留提交人、时间、原始内容 |
| 实时协同 | 产线事件触发 | 关重件条码打印 | 与本地打印客户端联动 |
第4章 安全与报文处理
4.1 认证与签名机制
徐工项目建议为每个环境独立维护 appKey、appSecret、徐工 RSA 公钥、供应商 RSA 私钥和供应商公钥。接口调用时,平台需根据徐工规范生成 URL 参数签名,并按要求设置 timestamp、appKey、language 等 Header。
建议将认证能力封装为统一公共组件,避免每个接口各自实现带来的差异与风险。
4.2 混合加密与报文封装
徐工接口的业务数据采用 RSA + AES 混合加密,推荐处理流程如下:
业务系统输出原始 JSON 或 JSON 数组
畅链平台按接口映射规则进行字段转换和格式标准化
生成随机 AES 密钥,并使用 AES 加密业务数据形成
dataStr使用徐工公钥加密 AES 密钥,形成
aesPrivateKey生成 URL 参数签名并写入请求参数
设置 Header 并发起 HTTPS 请求
接收响应后统一解密和结构化解析
将结果归类为成功、业务失败、技术失败三种状态并入库
4.3 异常分类与日志留痕
| 异常类型 | 示例 | 处理建议 |
|---|---|---|
| 技术异常 | 签名错误、解密失败、HTTP 超时 | 自动重试,触发运维告警 |
| 业务异常 | 字段缺失、枚举值不合法、拒绝原因不在范围内 | 进入业务异常池,修正后重发 |
| 数据异常 | 主数据映射缺失、来源系统口径不一致 | 建立映射主表与校验规则 |
| 协同异常 | 人工确认超时、现场打印失败 | WebEDI 留痕并补充人工处理机制 |
关键接口建议完整记录请求报文、响应报文、执行结果、失败原因、提交人、提交时间和重试轨迹,满足追溯、运维和审计要求。
第5章 业务实现设计
5.1 分组与触发方式
| 业务组 | 接口 | 建议触发方式 | 实施重点 |
|---|---|---|---|
| 主数据 | 物料主数据查询 | 每日定时 + 回溯补数 | 建设徐工物料与供应商物料映射主表 |
| 计划拉取 | 采购计划查询 | 高频定时 | 按发布日期窗口轮询并落库 |
| 订单拉取 | 采购订单查询、送货单查询 | 高频定时 | 驱动 ERP 出库、交付与排产流程 |
| 自动回传 | 供应商库存、出厂检验报告 | 定时或事件触发 | 回传前统一做完整性校验 |
| 人工确认 | 采购计划确认、采购订单确认 | WebEDI 提交后触发 | 留痕、审计、支持失败重提 |
| 现场协同 | 关重件条码打印 | 产线事件触发 | 对接本地打印客户端或标签软件 |
5.2 关重件条码打印
建议畅链平台仅承接请求、签名加密、结果回执与日志留痕,具体打印动作仍在供应商本地打印客户端完成。这样可以避免浏览器打印和远程渲染给产线现场带来的不稳定因素,同时更利于连接现有标签模板和打印设备。
5.3 出厂检验报告
出厂检验报告字段较多且对数据质量敏感,建议将其建模为“检验明细上传任务”,由 MES 或质检系统按完工批次触发。上传前应在畅链侧完成以下校验:
必填字段完整性校验
数值字段格式与精度校验
物料、批次、工单等关键主键一致性校验
枚举值与业务状态合法性校验
5.4 WebEDI 确认场景
对于采购计划确认和采购订单确认,建议以 WebEDI 作为唯一人工入口,承接以下动作:
查看徐工下发计划 / 订单最新数据
填写接受或拒绝结果
维护承诺数量、承诺日期、原因说明等反馈字段
提交后由平台自动生成安全报文并回传徐工
第6章 映射与调度设计
6.1 映射主数据建设
徐工项目在正式联调前,建议优先完成以下映射主表建设:
公司 / 组织 / 工厂映射
采购组织映射
徐工物料编码与供应商物料编码映射
计量单位、仓库、批次、业务状态等枚举映射
推荐采取“平台统一维护、业务系统统一引用”的方式,避免不同系统各自维护造成多口径和对账困难。
6.2 调度策略建议
| 接口类别 | 建议频率 | 执行方式 | 补偿机制 |
|---|---|---|---|
| 物料主数据查询 | 每日 1 次 | 定时任务 | 支持按日期窗口补拉 |
| 采购计划查询 | 每 30 分钟至 1 小时 | 定时任务 | 失败自动重试,次日补拉 |
| 采购订单查询 / 送货单查询 | 每 15 至 30 分钟 | 定时任务 | 失败重跑并记录断点 |
| 供应商库存 | 每日 2 至 4 次 | 定时推送 | 支持重发指定日期数据 |
| 采购计划确认 / 订单确认 | 事件驱动 | WebEDI 提交后推送 | 保存草稿,失败可再次提交 |
| 条码打印 / 检验报告 | 业务事件触发 | 实时调用 | 失败进入待重试队列 |
6.3 对账与补偿机制
建议建立统一的对账和补偿机制:
每日生成查询成功条数、回传成功条数、失败条数、待处理条数统计日报
对技术失败任务支持自动重试、手工重跑和断点续传
对业务失败任务进入异常池,由业务修正后重发
对关键确认类接口保留原始提交内容与返回结果,确保责任可追溯
第7章 实施与上线
7.1 实施阶段建议
建议按五个阶段推进徐工对接项目:
准备阶段:确认环境参数、公私钥交换方式、供应商编码、组织和物料映射口径
能力底座阶段:完成签名、加密、解密、异常码解析等公共组件,先跑通查询类接口
回传联调阶段:完成库存、计划确认、订单确认、条码打印、检验报告等接口集成
端到端测试阶段:完成联调、补数、容错、权限和日志完整性测试
切换保驾阶段:生产切换并进行 1 至 2 周重点值守,跟踪成功率和失败原因分布
7.2 交付边界
| 责任方 | 交付范围 |
|---|---|
| 畅链侧 | 接口适配、安全组件、WebEDI 页面、调度任务、监控告警、日志与运维工具 |
| 供应商侧 | 数据源整理、主数据维护、现场打印环境、业务确认流程、源系统接口配合 |
| 徐工侧 | 提供接口规范、测试环境、密钥材料、错误码说明与联调支持 |
7.3 上线保障建议
先完成“安全适配器 + 映射主表 + 查询接口”三项基础能力,再推进确认类和现场类接口
上线前先做验签验密专项测试,再做主数据清洗,再做单接口联调,最后做全流程回归
上线初期输出接口运行日报,重点观察成功率、失败原因、重试次数和业务闭环情况
第8章 异常处理与监控告警
8.1 异常分类分级
建议将徐工项目运行异常按“技术异常、业务异常、数据异常、协同异常”四类统一治理,并按严重程度分为 P1、P2、P3 三级:
| 异常类别 | 典型场景 | 等级建议 | 处理原则 |
|---|---|---|---|
| 技术异常 | HTTP 超时、网络中断、签名失败、解密失败 | P1 / P2 | 自动重试,失败后立即告警 |
| 业务异常 | 字段缺失、枚举值错误、状态不允许提交 | P2 | 进入业务异常池,人工修正后重发 |
| 数据异常 | 主数据映射缺失、组织/物料口径不一致 | P2 | 锁定当前任务,先修复映射主表 |
| 协同异常 | WebEDI 未确认、打印失败、检验数据未回填 | P2 / P3 | 触发业务提醒,跟踪闭环时效 |
8.2 异常处理流程
建议统一采用以下处理闭环:
接口任务执行失败后立即写入异常中心
平台自动识别异常类型,并打上接口名称、业务单号、环境、时间窗口、失败原因标签
对可重试异常进入自动重试队列,对不可重试异常进入人工处理池
处理完成后保留“原始报文、修正内容、重试结果、处理人、处理时间”全链路痕迹
每日输出异常日报,统计新增异常、已关闭异常、未关闭异常和平均处理时长
8.3 监控指标设计
| 监控维度 | 核心指标 | 说明 |
|---|---|---|
| 任务执行 | 成功率、失败率、平均耗时、重试次数 | 观察接口整体稳定性 |
| 数据质量 | 缺字段率、映射缺失率、重复提交率 | 发现源数据和映射问题 |
| 业务闭环 | 待确认笔数、超时未确认笔数、打印失败笔数 | 关注人工协同和现场执行 |
| 安全能力 | 签名失败次数、解密失败次数、密钥异常次数 | 关注协议层风险 |
8.4 告警机制建议
| 告警场景 | 触发条件 | 通知对象 | 响应要求 |
|---|---|---|---|
| P1 技术故障 | 连续失败 3 次以上或全量接口不可用 | 运维、实施负责人 | 30 分钟内响应 |
| P2 业务异常积压 | 单接口待处理异常超过阈值 | 业务负责人、实施顾问 | 当日内清理 |
| 人工确认超时 | WebEDI 待确认超出约定时限 | 业务经办人、主管 | 及时催办 |
| 现场执行异常 | 条码打印或检验回传连续失败 | 现场负责人、IT 支持 | 现场优先处理 |
第9章 安全与权限设计
9.1 安全设计原则
除接口通信层的签名与加密外,平台内部还应遵循以下安全原则:
密钥与凭证集中管理,不允许散落在任务脚本或页面配置中
测试环境与生产环境严格隔离,凭证、日志、任务和权限均独立
对高风险操作实行最小权限授权和可追溯审计
对人工确认和重发操作保留完整责任痕迹
9.2 凭证与密钥管理
| 对象 | 管理要求 |
|---|---|
appKey / appSecret | 按环境独立配置,限制查看权限 |
| 徐工公钥 / 供应商私钥 | 统一存储于安全配置中心,不在页面明文展示 |
| 接口地址与 Header 模板 | 与业务配置分离,避免误改 |
| 日志报文 | 对敏感字段做脱敏或摘要存储 |
9.3 角色与权限模型
| 角色 | 主要权限 | 限制说明 |
|---|---|---|
| 系统管理员 | 环境配置、密钥维护、用户授权 | 仅限少数管理员 |
| 实施顾问 | 接口配置、映射维护、调度策略调整 | 不直接进行业务确认 |
| 运维人员 | 监控查看、异常处理、任务重跑 | 不可修改核心业务口径 |
| 业务经办人 | WebEDI 查询、计划确认、订单确认 | 仅能操作所属业务范围 |
| 审计人员 | 查看日志、查看留痕、导出审计记录 | 只读权限 |
9.4 审计与数据保护
建议对以下动作强制审计:
映射主表新增、修改、删除
密钥和凭证变更
接口任务手工重跑、补发、撤回
WebEDI 确认提交与驳回
生产环境参数和调度策略变更
第10章 测试方案
10.1 测试目标
测试目标是验证徐工对接方案在“协议正确性、数据正确性、流程完整性、异常可恢复性、上线可运维性”五个方面达到投产要求。
10.2 测试范围
| 测试类别 | 测试内容 |
|---|---|
| 接口联通测试 | 接口地址、鉴权、签名、加密、解密、返回码识别 |
| 功能测试 | 查询、回传、人工确认、条码打印、检验报告等完整功能 |
| 数据测试 | 字段映射、主数据一致性、必填项、枚举值、精度与格式 |
| 异常测试 | 超时、签名错误、解密失败、业务校验失败、补发重试 |
| 权限测试 | 角色访问边界、页面可见性、操作限制、审计日志 |
| 回归测试 | 修复问题后的主流程回归和关键场景复核 |
10.3 测试阶段划分
| 阶段 | 测试重点 | 进入条件 | 退出条件 |
|---|---|---|---|
| 单接口验证 | 协议联通、签名加密、报文收发 | 环境和密钥准备完成 | 单接口请求响应成功 |
| 业务联调 | 业务字段映射、状态流转、回传闭环 | 核心接口已跑通 | 业务主流程可闭环 |
| 场景测试 | 多接口串联、异常补偿、重试机制 | 业务联调通过 | 关键场景全部通过 |
| 用户验收 | 业务人员操作、确认流程、报表输出 | 场景测试通过 | 用户签字确认 |
| 上线前回归 | 高风险场景与生产参数复核 | 验收通过 | 可发版上线 |
10.4 关键测试用例建议
物料主数据查询:验证查询窗口、分页、主数据落库和映射表回写
采购计划查询 + 采购计划确认:验证计划拉取、WebEDI 确认、加密回传和结果留痕
采购订单查询 + 采购订单确认:验证订单状态、承诺数量、承诺日期和拒绝原因逻辑
供应商库存回传:验证日常库存推送、指定日期补发和失败重试
关重件条码打印:验证请求成功、条码返回、本地打印联动和现场失败回执
出厂检验报告:验证批次触发、字段完整性校验、业务失败回写和修正重传
10.5 验收标准
| 验收项 | 建议标准 |
|---|---|
| 协议联通 | 所有接口均完成测试环境联通验证 |
| 核心业务流程 | 查询、确认、回传、打印、检验全流程跑通 |
| 数据质量 | 关键字段正确率达到业务验收要求 |
| 异常恢复 | 重试、补发、异常处理流程可执行 |
| 运维能力 | 监控、告警、日志、日报可正常产出 |
第11章 上线计划与里程碑
11.1 上线计划
建议采用“小步快跑、分层上线”的推进方式,先验证底座能力,再逐步扩大业务范围:
| 阶段 | 时间建议 | 主要工作 | 里程碑输出 |
|---|---|---|---|
| 阶段 1 | 第 1 周 | 环境、密钥、映射准备 | 基础环境就绪 |
| 阶段 2 | 第 2 周 | 查询类接口联调 | 查询链路可用 |
| 阶段 3 | 第 3 周 | 回传类与确认类接口联调 | 核心业务闭环可跑通 |
| 阶段 4 | 第 4 周 | 场景测试、用户验收、异常演练 | 验收通过 |
| 阶段 5 | 第 5 周 | 生产切换、保驾、问题收敛 | 正式上线 |
11.2 里程碑定义
| 里程碑 | 判定标准 |
|---|---|
| M1 基础环境完成 | 测试环境、参数、密钥、网络连通全部确认 |
| M2 安全适配器完成 | 签名、加密、解密、返回码解析统一封装完成 |
| M3 查询接口完成 | 物料、计划、订单、送货单查询稳定运行 |
| M4 回传与确认完成 | 库存、确认、检验、条码场景闭环打通 |
| M5 验收完成 | 业务验收通过,问题清单关闭到可上线状态 |
| M6 正式上线 | 生产切换完成,进入保驾期 |
11.3 上线切换建议
上线前冻结映射口径、接口配置和密钥材料
切换前执行一次全量健康检查,包括接口连通性、调度状态、日志落库和告警通道
上线首日安排业务、实施、运维三方值守
上线后一周重点关注计划查询、订单确认、库存回传和条码打印四类高频场景
第12章 风险与保障
12.1 主要风险
密钥、签名或加密实现偏差,导致全量接口不可用
主数据映射不完整,导致计划、库存、送货数据错位
确认类接口责任人和流程不清晰,造成业务闭环缺失
条码和质检源数据不规范,导致接口失败被放大到现场执行层
12.2 保障建议
联调前先进行安全报文验签与验密测试,提前排除协议层问题
在主数据映射阶段建立统一口径,避免多系统多版本
对确认类接口采用 WebEDI 唯一入口,确保责任人、提交时间和结果可追溯
对条码打印、检验报告等现场和质量接口优先做数据标准化与失败补偿机制设计
12.3 结论
徐工项目的实施重点不是单个接口开发,而是建立一个能够长期稳定运行的集成治理体系。建议以畅链数据集成平台为统一技术中台,以 WebEDI 承接人工确认闭环,以映射主表、调度补偿和日志审计作为项目底座,分阶段推进、逐步收敛风险,最终实现徐工全球采购数字化平台与供应商业务系统之间的稳定协同。
附录A 全部接口字段明细表
以下字段明细为实施设计版整理清单,用于映射设计、开发准备和联调沟通;正式字段名、长度、枚举范围和嵌套结构以徐工最终接口文档及测试报文为准。
A.1 公共安全报文字段
| 层级 | 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| Header | timestamp | String | 是 | 请求时间戳 |
| Header | appKey | String | 是 | 应用标识 |
| Header | language | String | 否 | 语言标识 |
| URL 参数 | sign | String | 是 | 签名值 |
| Body | params.dataStr | String | 是 | AES 加密后的业务报文 |
| Body | params.aesPrivateKey | String | 是 | RSA 加密后的 AES 密钥 |
A.2 物料主数据查询
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
beginDate | 请求 | String | 否 | 查询开始时间 |
endDate | 请求 | String | 否 | 查询结束时间 |
pageNo | 请求 | Integer | 否 | 页码 |
pageSize | 请求 | Integer | 否 | 分页大小 |
itemCode | 响应 | String | 是 | 徐工物料编码 |
itemName | 响应 | String | 是 | 物料名称 |
plantCode | 响应 | String | 否 | 工厂编码 |
purchaseOrgCode | 响应 | String | 否 | 采购组织编码 |
A.3 供应商库存回传
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
supplierCode | 请求 | String | 是 | 供应商编码 |
itemCode | 请求 | String | 是 | 物料编码 |
stockDate | 请求 | String | 是 | 库存日期 |
stockQty | 请求 | Number | 是 | 库存数量 |
unitCode | 请求 | String | 否 | 计量单位 |
batchNo | 请求 | String | 否 | 批次号 |
warehouseCode | 请求 | String | 否 | 仓库编码 |
resultCode | 响应 | String | 是 | 返回结果码 |
A.4 采购计划查询
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
publishBeginTime | 请求 | String | 否 | 发布起始时间 |
publishEndTime | 请求 | String | 否 | 发布结束时间 |
supplierCode | 请求 | String | 否 | 供应商编码 |
planNo | 响应 | String | 是 | 计划单号 |
planLineNo | 响应 | String | 否 | 计划行号 |
itemCode | 响应 | String | 是 | 物料编码 |
demandQty | 响应 | Number | 是 | 需求数量 |
demandDate | 响应 | String | 是 | 需求日期 |
A.5 采购计划确认
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
planNo | 请求 | String | 是 | 计划单号 |
planLineNo | 请求 | String | 是 | 计划行号 |
confirmStatus | 请求 | String | 是 | 接受 / 拒绝状态 |
confirmQty | 请求 | Number | 否 | 承诺数量 |
confirmDate | 请求 | String | 否 | 承诺日期 |
rejectReason | 请求 | String | 否 | 拒绝原因 |
operator | 请求 | String | 是 | 提交人 |
resultCode | 响应 | String | 是 | 返回结果码 |
A.6 采购订单查询
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
orderBeginTime | 请求 | String | 否 | 查询开始时间 |
orderEndTime | 请求 | String | 否 | 查询结束时间 |
orderNo | 响应 | String | 是 | 采购订单号 |
orderLineNo | 响应 | String | 否 | 订单行号 |
itemCode | 响应 | String | 是 | 物料编码 |
orderQty | 响应 | Number | 是 | 订单数量 |
deliveryDate | 响应 | String | 否 | 交付日期 |
deliveryLocation | 响应 | String | 否 | 收货地点 |
A.7 采购订单确认
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
orderNo | 请求 | String | 是 | 订单号 |
orderLineNo | 请求 | String | 是 | 订单行号 |
confirmStatus | 请求 | String | 是 | 确认状态 |
confirmQty | 请求 | Number | 否 | 承诺数量 |
confirmDate | 请求 | String | 否 | 承诺交期 |
rejectReason | 请求 | String | 否 | 拒绝原因 |
operator | 请求 | String | 是 | 提交人 |
resultCode | 响应 | String | 是 | 返回结果码 |
A.8 关重件条码打印
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
supplierCode | 请求 | String | 是 | 供应商编码 |
itemCode | 请求 | String | 是 | 物料编码 |
batchNo | 请求 | String | 是 | 批次号 |
serialQty | 请求 | Integer | 是 | 打印数量 |
productionDate | 请求 | String | 否 | 生产日期 |
barcodeValue | 响应 | String | 是 | 返回条码值 |
printStatus | 响应 | String | 是 | 打印结果状态 |
A.9 出厂检验报告
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
reportNo | 请求 | String | 是 | 检验报告编号 |
itemCode | 请求 | String | 是 | 物料编码 |
batchNo | 请求 | String | 是 | 批次号 |
inspectDate | 请求 | String | 是 | 检验日期 |
inspectResult | 请求 | String | 是 | 检验结论 |
qualifiedQty | 请求 | Number | 否 | 合格数量 |
unqualifiedQty | 请求 | Number | 否 | 不合格数量 |
attachmentUrl | 请求 | String | 否 | 附件地址 |
A.10 送货单查询
| 字段名 | 方向 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
deliveryBeginTime | 请求 | String | 否 | 查询开始时间 |
deliveryEndTime | 请求 | String | 否 | 查询结束时间 |
deliveryNo | 响应 | String | 是 | 送货单号 |
orderNo | 响应 | String | 否 | 关联订单号 |
itemCode | 响应 | String | 是 | 物料编码 |
deliveryQty | 响应 | Number | 是 | 送货数量 |
deliveryDate | 响应 | String | 否 | 送货日期 |
status | 响应 | String | 否 | 单据状态 |
附录B 术语表
| 术语 | 含义 |
|---|---|
| EDI | 电子数据交换,用于企业间结构化业务数据传输 |
| DSC | 徐工全球采购数字化平台 |
| WebEDI | 面向业务人员的网页化协同入口,用于人工确认和查询 |
| ERP | 企业资源计划系统 |
| MES | 制造执行系统 |
| WMS | 仓储管理系统 |
| AK / SK | 应用访问标识与密钥 |
| RSA | 非对称加密算法,用于密钥加密 |
| AES | 对称加密算法,用于业务报文加密 |
| 映射主表 | 统一维护物料、组织、枚举等对照关系的数据表 |
| 断点续传 | 任务失败后从上次进度继续执行,而非全量重跑 |
| 补数 | 对历史遗漏或失败数据进行补采、补传、补处理 |
