上传新文件

集成约定.md

+# 景弘盛 — 集成约定
+
+## 概述
+景弘盛项目涉及多个外围系统与 SAP 的集成。本文件只记录与 SAP 标准流程的交汇点（触点），不记录接口内部开发逻辑。
+**脱源说明**：接口原始文档已归档，编号见 [归档索引](归档索引.md)：
+- 仓储/物料主数据 DOCX 接口 → SRC-005
+- 生产接口 TXT（BOM/工艺路线/生产订单/投料入库/报工）→ SRC-006
+- 上线研讨会切换场景 → SRC-002
+> ⚠️ **凭证提示**：生产接口 TXT 中包含 SAP 通信账号及密码（联调数据），**不复制进本 KB**。任何需要凭证的接口开发/联调，请直接到归档路径 [SRC-006] 查看原文。
+
+---
+
+## BPM → SAP 采购/销售审批
+
+**集成方向**：外部系统 → SAP
+**触发条件**：BPM 中完成采购/销售订单审批
+**替代的 SAP 手工步骤**：SAP 内部审批工作流（本项目不启用）
+**接口输出**：审批通过的采购订单/销售订单在 SAP 中创建
+**正常延迟**：实时
+
+### 异常处理
+| 现象 | 判断方法 | 处理步骤 | 升级条件 |
+|------|---------|---------|---------|
+| BPM 审批通过但 SAP 未创建 | 检查 BPM 接口日志 | 1. 确认BPM已推送 2. 检查SAP接口队列 3. 手工补录 | 超过30分钟未恢复→联系开发团队 |
+
+---
+
+## PLM → SAP 主数据传输
+
+**集成方向**：外部系统 → SAP
+**触发条件**：PLM 中创建/修改 BOM、工艺路线、生产版本
+**替代的 SAP 手工步骤**：手工创建 BOM（CS01）、工艺路线（CA01）
+**接口输出**：BOM、工艺路线、生产版本在 SAP 中同步
+**正常延迟**：非实时，批量同步
+
+### 异常处理
+| 现象 | 判断方法 | 处理步骤 | 升级条件 |
+|------|---------|---------|---------|
+| BOM 未同步到 SAP | 在 SAP 中检查物料 BOM | 1. 确认PLM已发布 2. 检查接口状态 3. 手工补录 | 接口失败→联系开发团队 |
+
+---
+
+## SAP → WMS 库存数据
+
+**集成方向**：SAP → 外部系统
+**触发条件**：SAP 中发生库存移动
+**替代的 SAP 手工步骤**：无（WMS 是实际仓库执行系统）
+**接口输出**：库存变动信息同步到 WMS
+**正常延迟**：实时
+
+---
+
+## BYD → SAP 期初数据
+
+**集成方向**：外部系统 → SAP
+**触发条件**：系统切换期间
+**替代的 SAP 手工步骤**：无（一次性迁移）
+**接口输出**：期初库存、未清应收/应付、固定资产等数据
+
+### 切换场景（来源：上线研讨会 2026-04-22）【归档：SRC-002】
+
+#### 销售切换
+| 场景 | 处理 |
+|------|------|
+| 已建 SO 未发货未开票 | 整理后导入 S4，最晚5/30 |
+| 已发货未确认收入 | 转入在途库存，上线后确认收入时转主营业务成本 |
+| 部分发货 | 已发参照上条，未发参照第一条 |
+| 已收预付款未发货需开票 | 财务手工做总账凭证，后续冲销 |
+
+#### 采购切换
+| 场景 | 处理 |
+|------|------|
+| 已建 PO 未收货未收发票 | 整理后导入 S4，最晚5/30 |
+| 已收货未收发票 | "应付账款-期初暂估"科目导入 |
+| 部分收货 | 已收参照上条，未收参照第一条 |
+| 已收发票未收货 | 发票金额放入"在途物资"，收货后冲销 |
+| 公司间交易 | 要求切换前完结 |
+
+#### 生产切换
+| 场景 | 处理 |
+|------|------|
+| 在制订单 | 提前完结（BYD 完成发料/报工/入库/关单） |
+
+#### 仓库切换
+| 要求 | 说明 |
+|------|------|
+| 不允许负库存 | — |
+| 成本金额 >= 0 | 有数量的物料必须有成本 |
+| 一物一价 | 一个物料一个工厂只能一个价格 |
+| 静态盘点 | 盘点期间禁止出入库 |
+
+---
+
+## 接口清单
+
+### 生产类接口
+> 来源：JHS-接口文档-生产（归档：SRC-006；字段级定义 + 凭证见归档原文）
+
+| 接口名称 | 方向 | OData 服务 | 说明 |
+|---------|------|-----------|------|
+| 主数据-BOM-工艺-版本 | PLM→SAP | API_PRODUCT_SRV | BOM/工艺路线/生产版本同步 |
+| 生产订单创建/修改 | 外部→SAP | — | 生产订单操作 |
+| 生产订单投料/入库 | 外部→SAP | — | 投料和入库操作 |
+| 生产订单报工 | 外部→SAP | — | 确认/反确认 |
+
+### 物料主数据接口
+> 来源：景弘盛_SAP项目 接口文档（物料主数据）.docx（归档：SRC-005）
+
+| 接口名称 | 方向 | OData 服务 | 说明 |
+|---------|------|-----------|------|
+| 物料创建 | 外部→SAP | API_PRODUCT_SRV | 创建物料主数据 |
+| 物料修改 | 外部→SAP | API_PRODUCT_SRV | 修改物料主数据 |
+
+### 仓储类接口
+> 来源：景弘盛_SAP项目 接口文档（仓储）V1.0.docx（归档：SRC-005）
+
+| 接口名称 | 方向 | OData 服务 | 说明 |
+|---------|------|-----------|------|
+| 退货交货单查询 | SAP→外部 | API_CUSTOMER_RETURNS_DELIVERY_SRV | 查询退货交货单 |
+| 退货交货单修改 | 外部→SAP | API_CUSTOMER_RETURNS_DELIVERY_SRV | 修改退货交货单 |
+| 退货交货单过账 | 外部→SAP | API_CUSTOMER_RETURNS_DELIVERY_SRV | 过账退货发货 |
+
+---
+
+## 外围系统
+| 系统 | 用途 | 与 SAP 集成点 |
+|------|------|-------------|
+| BPM | 审批流程 | 采购/销售订单审批后推送到 SAP |
+| PLM | 产品数据管理 | BOM/工艺路线/生产版本同步到 SAP |
+| BYD | 旧 ERP 系统 | 期初数据迁移 |
+| WMS | 仓库管理系统 | 库存变动同步 |
+| CRS | 客户关系系统 | 用户账号/权限管理 |