Skip to content

Y
yidianyuan-project-kb
Commit 917f98d4 authored by 李宝旭's avatar 李宝旭
Browse files
Options

v2.0更新：新增接口8-5/8-6、实际定时任务频率、API端点；FI/SD/MM交易码与配置；批次双单位KGE；SSCUI配置编号；客户组→利润中心替代；物流箱A1000831/Z01

parent 27087f18
Hide whitespace changes
Inline Side-by-side
Showing with 317 additions and 98 deletions
KB_一甸园/00_项目概况.md
View file @ 917f98d4
# 00 一甸园项目概况
> **文档类型**：项目 KB — 导航/上下文
> **加载策略**：每次对话优先加载，获取一甸园项目基本上下文
> **加载策略**：每次对话在 `KB_00_一甸园_Navigation_Map.md` 之后优先加载，获取一甸园项目基本上下文
> **版本**：v1.0 | 2026-08-17
---
......@@ -121,12 +121,40 @@ SAP S/4HANA Cloud（一甸园双公司：A100 生产 + A200 销售）
| SC Base KB | `KB_SC/` | 标准操作步骤（引用，不重写） |
| SA KB | `KB_SA/` | 功能存在性 / Scope Item（引用） |
**一甸园 KB 文件清单**：00_项目概况、组织与主数据_真实值、蓝图决策记录、操作特例_SD_销售、操作特例_MM_采购仓储、操作特例_PP_QM_生产质量、操作特例_FI_CO_财务、集成约定、上线问题记录、未决问题清单。
**一甸园 KB 文件清单**：KB_00_一甸园_Navigation_Map（路由/红线）、00_项目概况、组织与主数据_真实值、蓝图决策记录、操作特例_SD_销售、操作特例_MM_采购仓储、操作特例_PP_QM_生产质量、操作特例_FI_CO_财务、集成约定、上线问题记录、未决问题清单。
**冲突裁决**：一甸园 KB（客户决策）> 蓝图 > SC Base > SA。
---
## 七、SAP 配置编号(SSCUI)
销售组织与主数据配置编号:
| 配置编号 | 用途 |
|----------|------|
| 102296 | 客户编号范围定义 |
| 103050 | 定义账户组(字段状态) |
| 102241 | 定义客户分组并分配编号 |
| 102741 | 分配账户组到客户分组(CUST需分配至供应商分组) |
| 102152 | 定义装运条件 |
| 102127 | 定义装运组 |
| 102126 | 分配装运点到工厂 |
| 101120 | 定义定价条件 |
| 101202 | 定义客户主数据中的定价 |
| 101117 | 定义销售定价过程(新建定价程序/步骤与条件) |
| 102174 | 定义客户收入科目分配组 |
| 102173 | 定义物料收入科目分配组 |
| 100297 | 设定销售收入科目确定 |
| 106430 | 定义客户税相关(开票页签税分类) |
| 106431 | 定义物料税相关(自定义物料税分类) |
| 101016 | 定义税码(税率) |
| VK12 | 发布销售税率(国内) |
客户组字段与利润中心替代:
- 客户主数据可定义6个预留字段(客户组)
- 管理替代/验证规则: 客户组→利润中心(覆盖必须勾选)
- 来源: 销售配置文档(SSCUI配置编号)
*00_项目概况.md | v1.0 | 2026-08-17*
---
......
KB_一甸园/上线问题记录.md
View file @ 917f98d4
......@@ -87,6 +87,23 @@
---
## 五、中台实际定时任务（来源：中台功能手册）
接口通过中台定时任务自动执行，实际频率与早期估算不同：
- 采购入库(1-1)/采购退货(2-1): 每隔6/5分钟
- B2B销售出库(3-1)/退货(4-1): 每隔2/8分钟
- 拆装(7-1~7-4)/移库(8-1~8-6): 每隔7/9分钟
- 成本中心出入库(9/10): 每隔9分钟
- 物流箱出库: 凌晨0:30执行、每天00:10同步
- B2C结算: 中台12:30/22:30、过账13:00/23:00
- 销售寄样: 每天0点/12点
- 同步聚水潭销售出库/退货入库: 每隔1小时
- 同步SAP物料: 每隔5分钟
> 来源：中台功能手册 §系统监控·定时任务。
---
*上线问题记录.md | v1.0 | 2026-08-17*
---
......
KB_一甸园/操作特例_FI_CO_财务.md
View file @ 917f98d4
......@@ -3,7 +3,7 @@
> **文档类型**：项目 KB — FI/CO 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：蓝图 BP-08/09、数据规则约定 §1-2、业务分工表（2024-03-20）
> **主要来源**：蓝图 BP-08/09、数据规则约定 §1-2、业务分工表（2024-03-20）；应付/应收/资产/总账流程基础版-手册
---
......@@ -127,6 +127,61 @@
---
## 六、SAP 交易码与报表（补充）
### 6.1 应付账款（J60）
| 事务码/App | 用途 | 说明 |
|-----------|------|------|
| FB60 | 创建进项发票（无采购订单） | 费用发票入账 |
| F-92 | 过账购置(集成应付账款)-无采购订单 | 费用报销借款 |
| 供应商发票清单 | 预制发票过账 | 借应付暂估/进项税 贷应付账款 |
| 过账付款 | 付款 | 选择清账项目 |
| 付款清账-手工清账 | 应付与预付核销 | 移至"待清算项目"，调整分配余额为0，过账 |
| 应付账款概览/账龄报表/试算平衡表 | 报表 | 账龄报表-应付账款-中国 |
| 显示流程流-应付账款 | 流程 | — |
### 6.2 应收账款（J59）
| 事务码/App | 用途 |
|-----------|------|
| FB70 | 创建销项发票(无销售订单) |
| 管理开票凭证 | 预制发票过账/问题处理 |
| 过账收款 | 收款 |
| 收款清账-手动清账 | 应收与预收核销 |
| 收款过账-针对客户 | 客户收款 |
| 应收账款概览/账龄报表 | 报表 |
| 销售量-灵活分析 | 分析 |
### 6.3 固定资产（J62）
| 事务码/App | 用途 |
|-----------|------|
| 管理固定资产 | 创建/维护资产卡片 |
| 过账购置(集成应付)-无采购订单 | 资产购置 |
| 过账报废(集成应收)-有客户 | 资产变卖(f-92) |
| 过账报废(非集成)-无客户 | 无客户报废(ABAON) |
| 过账报废-通过报废 | ABAVN |
| 计划资产会计作业 | 折旧运行(测试→正式) |
| 资产会计概览/折旧清单/资产余额/资产交易 | 查询 |
### 6.4 总账（J58）
| 事务码/App | 用途 |
|-----------|------|
| 管理总账科目主数据 | 科目主数据 |
| 过账一般日记账分录 | 记总账凭证 |
| 上载一般日记账分录 | 上载40/50凭证 |
| 管理过账期间 | 期间 |
| 管理经常性日记账分录 | 经常性凭证 |
| 管理日记账分录 | 日记账(冲销) |
| 显示凭证流/总账科目余额/总账余额-中国/行项目条目 | 查询 |
| 日记账分录分析器/审计日记账 | 分析 |
| 财务报表-中国(IDCNBSAIS) | 资产负债/损益 |
| 现金流报表-中国(IDCNCASH) | 现金流量表 |
| 科目凭证输出 | 打印 |
### 6.5 真实业务示例(委外加工费)
借预付10万/贷银行10万 → 开票(加工费97000: A每个5元×5000=25000, B每个6元×12000=72000) → 借主营加工费97000/贷应付暂估97000 → 发票预制→财务过账(借应付暂估97000/贷应付账款97000)→清账(预付挂账3000)
### 6.6
*操作特例_FI_CO_财务.md | v1.0 | 2026-08-17*
---
......
KB_一甸园/操作特例_MM_采购仓储.md
View file @ 917f98d4
......@@ -3,7 +3,7 @@
> **文档类型**：项目 KB — MM 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：物料管理操作手册（2023-11）、物料凭证接口设计记录（接口开发负责人 2023-11-20）、蓝图 BP-05/06、接口测试记录、盘点操作手册
> **主要来源**：物料管理操作手册（2023-11）、物料凭证接口设计记录（接口开发负责人 2023-11-20）、蓝图 BP-05/06、接口测试记录、盘点操作手册；批次双单位配置手册
---
......@@ -232,6 +232,17 @@
---
## 八、批次双单位配置（补充）
双单位物料需配置批次特定计量单位:
- 3个UOM: 基本UOM + 批次特定UOM(产品单位) + 特性UOM(如KGE=KG/EA)
- 基本与批次特定UOM不应属同一维度
- 计划转换系数存物料主记录;实际换算系数存批记录
- 配置路径: IMG→物流-一般→批次管理→批次特定物料计量单位→激活批次特定物料计量单位
- APP: 管理特征(CT04创建KGE)、管理类(创建KG_EA)
- 示例: LLTG006, 基本KG, 产品EA, 特征KGE; 主数据级1EA=100KG, 批次级1EA=105KG
- 收货时批次特定转换系数优先
*操作特例_MM_采购仓储.md | v1.0 | 2026-08-17*
---
......
KB_一甸园/操作特例_SD_销售.md
View file @ 917f98d4
......@@ -3,7 +3,7 @@
> **文档类型**：项目 KB — SD 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：蓝图 BP-01~04、接口确认记录 V1.1（2024-04-08）、数据规则约定 §3.3-3.5
> **主要来源**：蓝图 BP-01~04、接口确认记录 V1.1（2024-04-08）、数据规则约定 §3.3-3.5；销售订单操作手册
---
......@@ -137,6 +137,32 @@
---
## 七、SAP 交易码与订单类型（补充）
### 交易码
| VA01 | 创建销售订单 |
| VL01N | 创建出库交货-带订单参考 |
### 订单类型
- OR: 常规销售订单
- CBRE: 销售退货单(需输入原销售交货单号)
- CBFD: 销常换货补货订单/免费订单赠品
### 条件类型
- ZPB1: 固定金额折扣费
- ZPB2: 客户折扣(百分比)费
- ZPR1: 订单行价格(赠品丢失行价格，填1回车)
### 赠品与装运
- 类别 CBXN(免费增强类别) 添加赠品
- 装运点默认 1000
### 退货不退款
- 条件页签 ZPB2 折扣100 → 净值与税金变0价格
### 拣配
- 创建出库交货后"拣配"页签选发货仓与批次
*操作特例_SD_销售.md | v1.0 | 2026-08-17*
---
......
KB_一甸园/未决问题清单.md
View file @ 917f98d4
......@@ -2,8 +2,8 @@
> **文档类型**：项目 KB — 待确认/未决事项
> **用途**：列出尚需客户/顾问确认的事项，防止重复询问、留作知识缺口。**每条必须给"当前状态 + 待确认点 + 依据来源"。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：蓝图、业务分工表（2024-03-20）、项目周报待确认事项、中台方案设计、接口测试记录
> **版本**：v2.0 | 2026-08-21
> **主要来源**：蓝图、业务分工表（2024-03-20）、项目周报待确认事项、中台方案设计、接口测试记录、08交接新资料（审批流配置手册/批次双单位配置手册/销售配置文档/中台功能手册/销售订单操作手册/应付应收资产总账流程手册）
---
......@@ -22,7 +22,7 @@
| # | 问题 | 当前状态 | 待确认点 | 来源 |
|---|------|---------|---------|------|
| P1 | 云仓采购退换货、费用类采购 | 尚未实际操作 | 操作规范、财务费用类采购规则 | 业务分工表第 3/4 项 |
| P2 | 寄样出库操作 | 尚未实际操作 | 流程确认、执行人（代进强） | 业务分工表第 5 项 |
| P2 | 寄样出库操作 | **已补充**：审批流配置已完成（经理→经理的经理→运营采购→工作流程管理）；实际操作人为代进强 | 实际操作确认 | 业务分工表第 5 项；审批流配置手册 |
| P3 | 云仓退货收货方式 | 未定 | B2B 退货"使用采购入/售后单"方式需与仓库确认 | 中台方案设计 §B2B销售退货 |
| P4 | 中台新物料上线分类管理 | 已定（分类在 SAP 管理） | 操作归属确认（物料主数据由谁负责） | 中台方案设计 §主数据管理 |
......@@ -44,6 +44,19 @@
| D2 | 财务科目余额按新科目表调整分配 | 已提供 | 新旧科目对照关系备查确认 | 项目周报动态数据第 4 项 |
| D3 | 采购未清单据（已下单未收货等 4 类） | 暂未确认（请假） | 补录完成确认（接口打通前置条件） | 项目周报动态数据 |
## 五、新增事项（08交接资料更新 2026-08-21）
| # | 问题 | 当前状态 | 待确认点 | 来源 |
|---|------|---------|---------|------|
| N1 | 物流箱出库真实成本中心为 A1000831（非 A1000304） | 已确认 | 其他成本中心出库是否也用 A1000831 | 中台功能手册·物流箱出库参数 |
| N2 | 中台实际定时任务频率与早期估算不同 | 已记录 | 见 `上线问题记录.md` §五 | 中台功能手册·定时任务 |
| N3 | 销售退货交货单拆分批次、修改过账日期功能已完成 | 已确认 | 实际使用场景 | 销售相关SAP接口 §6.1 |
| N4 | 采购申请审批流配置已完成 | 已补充 | 实际审批人配置确认 | 审批流配置手册 |
| N5 | 批次双单位配置（KGE/CT04）操作细节 | 已补充 | 实际双单位物料清单确认 | 批次双单位配置手册 |
| N6 | 客户组→利润中心替代规则 | 已补充 | 6 个预留字段实际使用哪些 | 销售配置文档 §客户组字段 |
| N7 | 蓝图 V1.0 存在 2023-10-24 版本 | 与现有 2023-11-20 版本并存 | 是否为同一内容的不同修订 | 08交接蓝图文件 |
| N8 | 付款申请查看文档提取为 0 字符 | 需重新获取 | 财务付款流程完整路径 | 08交接付款申请查看.docx |
---
## 使用说明
......
KB_一甸园/蓝图决策记录.md
View file @ 917f98d4
......@@ -236,6 +236,36 @@
---
## SAP 配置编号（SSCUI）
销售组织与主数据配置：
| 配置编号 | 用途 |
|----------|------|
| 102296 | 客户编号范围定义 |
| 103050 | 定义账户组（字段状态） |
| 102241 | 定义客户分组并分配编号 |
| 102741 | 分配账户组到客户分组（CUST 需分配至供应商分组） |
| 102152 | 定义装运条件 |
| 102127 | 定义装运组 |
| 102126 | 分配装运点到工厂 |
| 101120 | 定义定价条件 |
| 101202 | 定义客户主数据中的定价 |
| 101117 | 定义销售定价过程（新建定价程序/步骤与条件） |
| 102174 | 定义客户收入科目分配组 |
| 102173 | 定义物料收入科目分配组 |
| 100297 | 设定销售收入科目确定 |
| 106430 | 定义客户税相关（开票页签税分类） |
| 106431 | 定义物料税相关（自定义物料税分类） |
| 101016 | 定义税码（税率） |
| VK12 | 发布销售税率（国内） |
客户组字段与利润中心替代：客户主数据可定义 6 个预留字段（客户组），通过"管理替代/验证规则"实现客户组→利润中心替代（覆盖必须勾选）。
> 来源：销售配置文档（SSCUI 配置编号）、销售配置文档 §客户组字段。
---
*蓝图决策记录.md | v1.0 | 2026-08-17*
---
......
KB_一甸园/集成约定.md
View file @ 917f98d4
......@@ -2,8 +2,8 @@
> **文档类型**：项目 KB — 接口触点层
> **用途**：记录与外部系统（OMS 中台/聚水潭/云仓 WMS）集成点的触发条件、输入输出和已知问题。**只记录触点，不记录接口内部开发逻辑。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：接口确认记录 V1.1、接口切换安排（2024-04-08）、接口测试记录 V1.0、物料凭证接口设计记录（接口开发负责人 2023-11-20）、中台集成开发计划 V1.4、产品主数据同步接口设计记录 v1.0（2024-04-01）、中台方案设计
> **版本**：v2.0 | 2026-08-21
> **主要来源**：接口确认记录 V1.1、接口切换安排 v1.2、接口测试记录 V1.0、物料凭证接口设计记录（接口开发负责人 2023-11-20）、中台集成开发计划 V1.4、产品主数据同步接口设计记录 v1.0（2024-04-01）、中台方案设计、SAP与聚水潭OMS集成接口文档v1.0（接口开发负责人）、中台功能手册（一甸园）
---
......@@ -13,39 +13,43 @@
电商平台（抖音/天猫/京东/拼多多/有赞/视频号/快团团/小红书/京东自营/天猫超市）
↓ 抓单 ↓ 订单/退货
OMS 中台 ◄──────────────────────────► 聚水潭 OMS（履约/云仓指令）
│ ↑ 接口（12条） │
│ ↑ 接口（16条+结算+寄样+物料） │
SAP S/4HANA Cloud（A100/A200 双公司） └──► 云仓 WMS（天津景天/无锡景天/昆山旺店通）
```
- **主键约定**：中台与 SAP 和聚水潭的集成**均以中台的 SAP 物料号传输**（中台方案设计 §结论）。
- **仓库映射**：SAP 库存地点 ↔ OMS 仓库代码（A104天津 022-002C/景天、A105无锡 510-002C/景天、A106昆山 0033/旺店通），见 `组织与主数据_真实值.md` §1.2。
- **客户**：客户主数据不同步 OMS，做虚拟客户管理（订单同步发货地址）。
- **中台定时任务**：全部接口通过中台定时任务自动执行，具体间隔见 §六。
---
## 二、接口总表（12 条，确认 V1.1）
| 接口编号 | 功能 | 方向 | 同步频率 | 切换时间 | 切换状态 |
|---------|------|------|---------|---------|---------|
| 1-1 | 采购入库单-中台至OMS采购订单同步 | SAP→OMS | 3 分钟 | 2024.04.08 | 已切换 |
| 1-2 | 采购入库单-OMS至中台采购订单同步 | OMS→SAP | 3 分钟 | | |
| 2-1 | 采购退货单-中台至OMS采购退货单同步 | SAP→OMS | 5 分钟 | 2024.04.08 | 已切换 |
| 2-2 | 采购退货单-OMS至中台采购退货单同步 | OMS→SAP | 5 分钟 | | |
| 3-1 | B2B销售出库单-中台至OMS外向交货同步 | SAP→OMS | 1 分钟 | 2024.04.08 | 已切换 |
| 3-2 | B2B销售出库单-OMS至中台外向交货单同步 | OMS→SAP | 1 分钟 | | |
| 3-3 | B2B销售出库单-OMS至中台寄样单同步 | OMS→SAP | 1 分钟 | | |
| 4-1 | SAP销售退货单-中台至OMS销售退货单同步 | SAP→OMS | 2 分钟 | 2024.04.08 | 已切换 |
| 4-2 | SAP销售退货单-OMS至中台销售退货单同步 | OMS→SAP | 2 分钟 | | |
| 7-1~7-4 | 拆装功能（委外入库/出库/拆装出库/拆装入库） | 双向 | 1 分钟 | 2024.04.08 | 已切换 |
| 8-1~8-4 | 移库出入库（UB 单移库出/入库） | 双向 | 3 分钟 | 2024.04.08 | 已切换 |
| 9-1/9-2 | 成本中心入库（预留单） | 双向 | 3 分钟 | 2024.04.19 | 待切换（有功能变动） |
| 10-1~10-3 | 成本中心出库（预留单/耗材单） | 双向 | 3 分钟 | 2024.04.19 | 待切换 |
| 11-1 | 物流箱出库-OMS至中台出库单同步 | OMS→SAP | 每天12点 | 2024.04.19 | 待切换（测试后） |
| 结算单（C端） | 接聚水潭销售出库单查询 | OMS→SAP | 每天4点/16点 | 2024.04.08 | 已切换 |
| 销售寄样单 | 接聚水潭销售出库单查询 | OMS→SAP | 每天12点/24点 | 待定 | 未切换 |
| 物料主数据 | 产品主数据同步 | SAP→OMS→聚水潭 | 1 小时 | 2024.04.19 | 已切换 |
> 来源：接口确认记录 V1.1、接口切换安排 v1.2。**数据拉取起点**：接口 1-4、7、8 同步 4月9号早上10点当天及之后的所有数据；接口 9-11、结算单、寄样单同步 4月1号当天及之后。
## 二、接口总表（16 条 + 结算/寄样/物料）
| 接口编号 | 功能 | 方向 | 实际频率（定时任务） | 切换时间 | 切换状态 |
|---------|------|------|---------------------|---------|---------|
| 1-1 | 采购入库单-中台至OMS采购订单同步 | SAP→OMS | 每隔6分钟 | 2024.04.08 | 已切换 |
| 1-2 | 采购入库单-OMS至中台采购订单同步 | OMS→SAP | 每隔6分钟 | | |
| 2-1 | 采购退货单-中台至OMS采购退货单同步 | SAP→OMS | 每隔5分钟 | 2024.04.08 | 已切换 |
| 2-2 | 采购退货单-OMS至中台采购退货单同步 | OMS→SAP | 每隔5分钟 | | |
| 3-1 | B2B销售出库单-中台至OMS外向交货同步 | SAP→OMS | 每隔2分钟 | 2024.04.08 | 已切换 |
| 3-2 | B2B销售出库单-OMS至中台外向交货单同步 | OMS→SAP | 每隔2分钟 | | |
| 3-3 | B2B销售出库单-OMS至中台寄样单同步 | OMS→SAP | 每隔2分钟 | | |
| 4-1 | SAP销售退货单-中台至OMS销售退货单同步 | SAP→OMS | 每隔8分钟 | 2024.04.08 | 已切换 |
| 4-2 | SAP销售退货单-OMS至中台销售退货单同步 | OMS→SAP | 每隔8分钟 | | |
| 7-1~7-4 | 拆装功能（委外入库/出库/拆装出库/拆装入库） | 双向 | 每隔7分钟 | 2024.04.08 | 已切换 |
| 8-1~8-4 | 移库出入库（UB 单移库出/入库） | 双向 | 每隔9分钟 | 2024.04.08 | 已切换 |
| **8-5** | **移库出入库-中台至OMS UB单采购入库同步** | SAP→OMS | 每隔9分钟 | 2024.04.08 | 已切换 |
| **8-6** | **移库出入库-OMS至中台 UB单(工厂到云仓)移库入库同步** | OMS→SAP | 每隔9分钟 | | |
| 9-1/9-2 | 成本中心入库（预留单） | 双向 | 每隔9分钟 | 2024.04.19 | 待切换（有功能变动） |
| 10-1~10-3 | 成本中心出库（预留单/耗材单） | 双向 | 每隔9分钟 | 2024.04.19 | 待切换 |
| 11-1 | 物流箱出库-OMS至中台出库单同步 | OMS→SAP | 每天00:10 | 2024.04.19 | 待切换（测试后） |
| 结算单（C端） | 接聚水潭销售出库单查询 | OMS→SAP | 每天12:30(中台)/13:00(过账)；22:30/23:00 | 2024.04.08 | 已切换 |
| 销售寄样单 | 接聚水潭销售出库单查询 | OMS→SAP | 每天0点/12点(成本中心出库) | 待定 | 未切换 |
| 物料主数据 | 产品主数据同步 | SAP→OMS→聚水潭 | 每隔5分钟 | 2024.04.19 | 已切换 |
| 同步聚水潭销售出库单/退货入库单 | 中台获取 | 聚水潭→中台 | 每隔1小时 | | |
> 来源：接口确认记录 V1.1、接口切换安排 v1.2、中台功能手册（一甸园）、SAP与聚水潭OMS集成接口文档v1.0。**数据拉取起点**：接口 1-4、7、8 同步 4月9号早上10点当天及之后的所有数据；接口 9-11、结算单、寄样单同步 4月1号当天及之后。
---
......@@ -55,38 +59,26 @@ SAP S/4HANA Cloud（A100/A200 双公司） └──► 云仓 WMS（天津景
- **触发**：SAP 采购订单创建/审批后 → 自动同步到中台（状态"已审批"），且自动创建入库申请单；OMS 收货后 → 查询 OMS 收货数据 → SAP 创建采购入库单。
- **替代 SAP 手工步骤**：云仓采购收货过账（101）。
- **特殊约定**：
- 价格直接使用 SAP 的，不走中台价格目录逻辑。
- 采购订单已在中台时取消：中台和 SAP 分别手动取消。
- 中台校验数据是否已存在：不存在→创建单据并更新 SAP 状态；已存在→直接更新 SAP 状态。
- **异常升级**：OMS 收货异常、SAP 过账失败 → 查看中台日志定位单据，联系接口开发负责人。
- **开发文档**：`物料凭证接口设计记录` §5.1.6、`中台集成开发计划（2023-11）`。
- **Owner**：接口开发负责人/中台开发。
- **特殊约定**：价格直接使用 SAP 的，不走中台价格目录逻辑；采购订单已在中台时取消需两边手动取消；中台校验数据是否已存在。
- **异常升级**：OMS 收货异常、SAP 过账失败 → 查看中台日志定位单据，联系接口负责人（李宝旭）。
### 3.2 采购退货（接口 2-1/2-2）
- **触发**：SAP 建退货采购订单（勾退货）→ 同步 OMS 形成采购退货单 → OMS 发货 → 查询发货单 → SAP 创建采购退货单（移动类型 161）。
- **替代 SAP 手工步骤**：云仓采购退货出库过账。
- **异常升级**：退货单未同步、SAP 过账失败（缺参考物料凭证/移动原因）→ 检查 SAP 收货物料凭证与 ReferenceDocumentFiscalYear 参数。
- **开发文档**：`物料凭证接口设计记录` §5.1.7。
- **Owner**：接口开发负责人/中台开发。
- **异常升级**：退货单未同步、SAP 过账失败 → 检查 SAP 收货物料凭证与 ReferenceDocumentFiscalYear 参数。
### 3.3 B2B 销售出库（接口 3-1/3-2/3-3）
- **触发**：SAP 创建外向交货单 → 传输 OMS 形成销售订单（接聚水潭销售订单创建接口）→ OMS 发货 → 查询 OMS 销售出库单 → SAP 外向交货单过账；寄样单走 3-3。
- **触发**：SAP 创建外向交货单 → 传输 OMS 形成销售订单 → OMS 发货 → 查询 OMS 销售出库单 → SAP 外向交货单过账；寄样单走 3-3。
- **替代 SAP 手工步骤**：B2B 发货过账（601）。
- **特殊约定**：销售订单额外字段有值时传字段值，无则传默认值。
- **异常升级**：发货过账失败 → 检查交货单是否已过账、OMS 出库状态；涉及财务注意实际发货日期。
- **开发文档**：中台方案设计 §B2B销售、`中台集成开发计划（2023-11）`。
- **Owner**：接口开发负责人/中台开发。
- **异常升级**：发货过账失败 → 检查交货单是否已过账、OMS 出库状态。
### 3.4 B2B 销售退货（接口 4-1/4-2）
- **触发**：SAP 创建销售退货订单 → 传输 OMS 形成售后单（接聚水潭其他入库创建接口）→ OMS 退货收货 → 查询售后收货数据 → SAP 创建退货交货单并过账。
- **触发**：SAP 创建销售退货订单 → 传输 OMS 形成售后单 → OMS 退货收货 → 查询售后收货数据 → SAP 创建退货交货单并过账。
- **替代 SAP 手工步骤**：B2B 退货入库过账。
- **异常升级**：退货收货数据回传出错（如部分退货单位不一致）→ 见 `操作特例_SD_销售.md` §4.1，需人工核对实际收货数量。
- **开发文档**：中台方案设计 §B2B销售退货。
- **Owner**：接口开发负责人/中台开发。
- **异常升级**：部分退货单位不一致导致回传 SAP 数据出错 → 需人工核对实际收货数量。
### 3.5 拆装功能（接口 7-1~7-4）
......@@ -94,16 +86,14 @@ SAP S/4HANA Cloud（A100/A200 双公司） └──► 云仓 WMS（天津景
- **关键约定**：OMS **需要先做出库再做入库，且同时完成**。
- **替代 SAP 手工步骤**：拆装包发料/收货（541/101/543）。
- **异常升级**：云仓拆装未同步、SAP 过账失败 → 检查 OMS 出入库单状态与顺序。
- **开发文档**：`物料凭证接口设计记录` §5.1.8、接口测试记录 §拆装功能。
- **Owner**：接口开发负责人/中台开发。
### 3.6 移库出入库（接口 8-1~8-4）
### 3.6 移库出入库（接口 8-1~8-6）
- **触发**：SAP 下达库存转储单（UB）→ 发 OMS 其他出库单（工厂到云仓走采购入库单接口，云仓到云仓走其它出库/其它入库）→ OMS 云仓发货 → 查询出库状态 → SAP 创建库存转储单出库单（351），同时生成 OMS 其他入库单（出库有批次需指定批次入库）→ OMS 入库 → 查询入库状态 → SAP 完成转储入库（101）。
- **8-5 补充**：中台至 OMS UB 单采购入库同步（接口 8-5，频率每隔 9 分钟）。
- **8-6 补充**：OMS 至中台 UB 单（工厂到云仓）移库入库同步（接口 8-6）。
- **替代 SAP 手工步骤**：UB 调拨发货/收货（351/101）。
- **异常升级**：**接口未打通前需两边操作**（SAP + OMS）；接口打通前置条件为"完成历史采购、生产业务单据补录"（目标 3月30日）。
- **开发文档**：`物料凭证接口设计记录` §5.1.9、接口测试记录 §仓库调拨（UB 4500000005/4500000007 测试）。
- **Owner**：接口开发负责人/张仁玲/刘亚波。
- **异常升级**：**接口未打通前需两边操作**；接口打通前置条件为"完成历史采购、生产业务单据补录"。
### 3.7 成本中心入库/出库（接口 9-1/9-2、10-1~10-3）
......@@ -111,73 +101,118 @@ SAP S/4HANA Cloud（A100/A200 双公司） └──► 云仓 WMS（天津景
- **特殊约定**：移动类型 Z05/Z07/Z11/Z13/Z15/Z17/Z19 接聚水潭销售订单创建接口，其余接其他出库创建接口；从 OMS 查询耗材的出单，SAP 直接创建成本中心出库（成本中心固定值）。
- **替代 SAP 手工步骤**：云仓成本中心领料过账。
- **异常升级**：预留单同步失败 → 检查预留单/ReservationItem/成本中心字段。
- **开发文档**：`物料凭证接口设计记录` §5.1.10-5.1.11。
- **Owner**：接口开发负责人/吴晓军。
### 3.8 物流箱出库（接口 11-1）
- **触发**：聚水潭下达其他出库单 → OMS 完成出库（云仓）→ 查询出库单 → 中台获取 → 推送 SAP 进行成本中心出库。
- **同步频率**：每天 12 点同步一次当天数据。
- **同步频率**：每天 00:10（物流箱成本中心出库过账凌晨 0:30 执行）。
- **真实值**：物流箱出库移动类型 **Z01**，成本中心 **A1000831**，工厂 **A101**，存储地点 **A103**。
- **Owner**：刘亚波（云仓物流箱出库）。
### 3.9 结算单（C端）+ 销售寄样单
- **触发**：接聚水潭销售出库单查询接口，中台同步结算系统后生成 SAP 销售订单/退货单（见 `操作特例_SD_销售.md`）。
- **同步频率**：结算单每天 4 点、16 点；寄样单每天 12 点、24 点。
- **触发**：接聚水潭销售出库单查询接口，中台同步结算系统后生成 SAP 销售订单/退货单。
- **B2C 结算频率**：中台部分每天 12:30/22:30；过账部分每天 13:00/23:00。
- **销售寄样频率**：每天 0 点和 12 点（成本中心出库）。
- **Owner**：洪飞/中台。
### 3.10 物料主数据同步（产品主数据接口）
- **触发**：中台定时（1H）访问 SAP 产品主数据中间表（API_PRODUCT_SRV）→ 推送到聚水潭（jushuitan.itemsku.upload）。
- **触发**：中台定时（每 5 分钟）访问 SAP 产品主数据中间表（API_PRODUCT_SRV）→ 推送到聚水潭（jushuitan.itemsku.upload）。
- **URL**：`https://my200448-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_PRODUCT_SRV`（OData 2.0，Basic，GET）。
- **字段映射**：ProductDescription→name、Product→sku_id/i_id、ProductStandardID→sku_code、ProductType→item_type、GrossWeight→weight、IsInternalBatchManaged→batch_enabled、TotalShelfLife→shelf_life。
- **同步范围**：Z001 成品→成品（是）、Z002 原料→原料（否）、Z003 生产辅材→包材（是）、Z004 履约包材→包材（是）、Z005 赠品周边→成品（是）、Z006 其他→（否）。
- **开发文档**：`产品主数据同步接口设计记录 v1.0`（接口开发负责人 2024-04-01）。
- **Owner**：接口开发负责人/中台。
- **Owner**：李宝旭/中台。
---
## 四、物料凭证创建接口（通用，触点说明）
**接口 URL**：`https://my200403-api.s4hana.sapcloud.cn/sap/opu/odata/sap/API_MATERIAL_DOCUMENT_SRV`（OData 2.0，Basic，POST）——开发文档示例地址，正式环境另行提供。
- **GoodsMovementCode**：采购入库固定 01、生产 02、成本中心 03、转储 04。
- **GoodsMovementRefDocType**：采购入库固定 B、生产 F，其他为空。
- **移动类型**：101 采购入库、161 采购退货、541 委外发料、101/543 委外收货+耗料、Z10 拆装包入库、351/101 UB 调拨、201/202 成本中心出入库、Z01/Z02 样品、Z03/Z04 报废（详见 `操作特例_MM_采购仓储.md` §七）。
- **委外入库**：OMS 不传子件时按标准比例扣减（前提子件无批次；子件含批次必须传消耗量，MaterialDocumentParentLine 指向母件行）。
- **异常升级**：HTTP 201 成功；4XX 失败（参数错误），需查 OMS 单与 SAP 字段映射。
> 来源：`物料凭证接口设计记录` §5.1。
## 四、接口 API 端点
| 接口 | 聚水潭 API | 方法 | 说明 |
|------|-----------|------|------|
| 采购入库 | `/open/webapi/wmsapi/purchasein/createbatch` | POST | 批量创建采购入库单 |
| 采购入库查询 | `/open/purchasein/query` | GET | 采购入库查询 |
| 采购退货 | `/open/webapi/wmsapi/purchaseout/createbatch` | POST | 批量创建采购退货单 |
| B2B销售出库(中台→OMS) | `/open/jushuitan/orders/upload` | POST | 订单上传(商家自有商城/跨境线下) |
| B2B销售出库(OMS→中台) | `/open/orders/single/query` | GET | 订单查询 |
| 寄样(OMS→中台) | `/open/orders/out/simple/query` | GET | 销售出库查询订单 |
| 销售退货(中台→OMS) | `/open/jushuitan/otherinout/upload` | POST | 新建其它出入库 |
| 销售退货(OMS→中台) | `/open/other/inout/query` | GET | 其它出入库查询 |
| 拆装(中台→OMS) | `/open/jushuitan/otherinout/upload` | POST | 新建其它出入库 |
| 拆装(OMS→中台) | `/open/other/inout/query` | GET | 其它出入库查询 |
| 移库(中台→OMS出库) | `/open/jushuitan/otherinout/upload` | POST | 新建其它出入库 |
| 移库(OMS→中台出库) | `/open/other/inout/query` | GET | 其它出入库查询 |
| 移库(中台→OMS入库/8-5) | `/open/webapi/wmsapi/purchasein/createbatch` | POST | 批量创建采购入库单 |
| 移库(OMS→中台入库/8-6) | `/open/purchasein/query` | GET | 采购入库查询 |
| 成本中心入库(中台→OMS) | `/open/jushuitan/otherinout/upload` | POST | 新建其它出入库 |
| 成本中心入库(OMS→中台) | `/open/other/inout/query` | GET | 其它出入库查询 |
| 成本中心出库(中台→OMS) | `/open/jushuitan/otherinout/upload` | POST | 新建其它出入库 |
| 成本中心出库(OMS→中台) | `/open/other/inout/query` | GET | 其它出入库查询 |
| 物流箱(OMS→中台) | `/open/other/inout/query` | GET | 接聚水潭其他出库查询接口 |
| 物料主数据 | `API_PRODUCT_SRV` (OData) | GET | 产品主数据查询 |
> 来源：SAP与聚水潭OMS集成接口文档v1.0（接口开发负责人）。
---
## 五、接口测试记录（来源：接口测试记录 V1.0）
## 五、接口测试记录（接口测试记录 V1.0）
| 场景 | SAP 单据 | OMS/聚水潭单据 | 结果 |
|------|---------|---------------|------|
| UB 工厂→云仓 | UB 4500000005（出库成品仓、入库天津仓）→ 4500000006 | 采购入库 927008（wms_co_id 13159759） | 入库 5000000000、出库 4900000269 |
| UB 云仓→云仓 | UB 4500000007（天津→无锡）、4500000008 | 其他出库 927120、其他入库 927271 | 入库 5000000011、出库 4900000256 |
| UB 工厂→云仓 | UB 4500000005 → 4500000006 | 采购入库 927008 | 入库 5000000000、出库 4900000269 |
| UB 云仓→云仓 | UB 4500000007/4500000008 | 其他出库 927120、其他入库 927271 | 入库 5000000011、出库 4900000256 |
| 拆装包 | ZY5 9400000006 | 其他入库 931477、其他出库 931476 | 541 出库 4900000464、543/101 收货 5000000033 |
| 采购入库（云仓） | ZY1 9000000003 | 采购入库 927274 | 101 收货 5000000030 |
| 采购退货（云仓） | ZY6 9500000003 | 采购入库 931236 | 161 出库 5000000021 |
> 来源：`接口测试记录 V1.0`。测试值含批次（C20231001/C20231002/C20240301/C20240307）、生产/过期日期示例。
> 来源：接口测试记录 V1.0。测试值含批次（C20231001/C20231002/C20240301/C20240307）、生产/过期日期示例。
---
## 六、中台定时任务清单（来源：中台功能手册）
| 定时任务 | 执行频率 | 说明 |
|---------|---------|------|
| 物流箱成本中心出库过账 | 凌晨0:30 | 物流箱出库成本中心出库 |
| 成本中心出库-物流箱其它出库 | 每天00:10 | — |
| B2C结算流程-中台部分 | 每天12:30/22:30 | 结算中台 |
| B2C结算流程-过账部分 | 每天13:00/23:00 | 过账 |
| 销售寄样成本中心出库 | 每天0点/12点 | 寄样出库 |
| 采购入库单-中台至OMS | 每隔6分钟 | 接口1-1 |
| 采购退货单-中台至OMS | 每隔5分钟 | 接口2-1 |
| B2B销售出库单-中台至OMS外向交货 | 每隔2分钟 | 接口3-1 |
| SAP销售退货单-中台至OMS | 每隔8分钟 | 接口4-1 |
| 拆装-中台至OMS委外入库/出库 | 每隔7分钟 | 接口7-1/7-2 |
| 移库-中台至OMS UB单(出库/入库/采购入库) | 每隔9分钟 | 接口8-1~8-5 |
| 成本中心入库-中台至OMS预留单入库 | 每隔9分钟 | 接口9-1 |
| 成本中心出库-中台至OMS | 每隔9分钟 | 接口10-1~10-3 |
| 采购入库单-OMS至中台 | 每隔6分钟 | 接口1-2 |
| 采购退货单-OMS至中台 | 每隔5分钟 | 接口2-2 |
| B2B销售出库单-OMS至中台外向交货/寄样 | 每隔2分钟 | 接口3-2/3-3 |
| SAP销售退货单-OMS至中台 | 每隔8分钟 | 接口4-2 |
| 拆装-OMS至中台拆装出库/入库 | 每隔7分钟 | 接口7-3/7-4 |
| 移库-OMS至中台 UB单(出库/入库/工厂到云仓) | 每隔9分钟 | 接口8-2~8-4、8-6 |
| 成本中心入库/出库-OMS至中台 | 每隔9分钟 | 接口9-2、10-2/10-3 |
| 同步聚水潭销售出库单/退货入库单到中台 | 每隔1小时 | — |
| 同步sap物料到中台 | 每隔5分钟 | 物料主数据 |
> 来源：中台功能手册（一甸园）§系统监控·定时任务。
---
## 六、已知集成问题/待确认
## 七、已知集成问题/待确认
| 问题 | 状态 | 详见 |
|------|------|------|
| 部分退货时 OMS 无法修改退货单位，导致回传 SAP 数据出错 | 待确认 | `操作特例_SD_销售.md` §4.1、`未决问题清单.md` |
| 部分退货时 OMS 无法修改退货单位，回传 SAP 数据出错 | 待确认 | `操作特例_SD_销售.md` §4.1、`未决问题清单.md` |
| 调拨出库/入库跨月时数据传输后 SAP 需人工调整 | 待确认 | 中台方案设计 §调拨业务 |
| 接口未打通前 UB 调拨需 SAP+OMS 两边操作 | 已切换（4.8） | 本文件 §3.6 |
| B2B 退货"使用采购入/售后单"方式需与仓库确认 | 待确认 | 中台方案设计 §B2B销售退货 |
| 成本中心出入库接口（9/10）有功能变动 | 2024.4.19 切换 | 接口确认记录 V1.1 |
| 物流箱出库接口（11-1）测试 | 测试完毕后切换 | 接口确认记录 V1.1 |
| 中台新物料上线后不管理分类，分类在 SAP 管理 | 已定 | 中台方案设计 §主数据管理 |
| 销售退货交货单拆分批次、修改过账日期 | 已完成 | 销售相关SAP接口 §6.1 |
| OMS 日志查询：执行结果录入"N"可查报错单据 | 已发现 | 中台功能手册 §日志信息查询 |
---
*集成约定.md | v1.0 | 2026-08-17*
> 来源：接口确认记录 V1.1、销售相关SAP接口（SD模块）、中台功能手册。
---
......@@ -185,14 +220,18 @@ SAP S/4HANA Cloud（A100/A200 双公司） └──► 云仓 WMS（天津景
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 接口确认记录 V1.1 | 接口确认文档 V1.1 |
| 接口切换安排（2024-04-08） | 4月8日接口切线安排 v1.2 |
| 接口切换安排 v1.2 | 切线安排 v1.2 |
| 接口测试记录 V1.0 | 接口测试文档 MM V1.0／一甸园SAP项目_接口测试文档MMV1.0.xlsx |
| 接口测试记录 | 接口测试文档 MM |
| 物料凭证接口设计记录 | 移动类型-物料凭证创建_V1.0／接口相关文件/一甸园SAP-移动类型-物料凭证创建_V1.0.doc |
| 中台集成开发计划 V1.4 | OMS集成开发计划 V1.4 |
| 中台集成开发计划（2023-11） | 一甸园OMS集成开发计划及设计_20231114_V1.4.xlsx |
| 产品主数据同步接口设计记录 v1.0 | 产品主数据同步接口 v1.0／接口相关文件/一甸园SAP项目_产品主数据同步接口v1.0 |
| 接口确认记录 V1.1 | 接口确认文档 V1.1 / 接口确认 V1.1 |
| 接口切换安排 v1.2 | 4月8日接口切线安排 v1.2 |
| 接口测试记录 V1.0 | 接口测试文档 MM V1.0 / 一甸园SAP项目_接口测试文档MMV1.0.xlsx |
| 物料凭证接口设计记录 | 移动类型-物料凭证创建_V1.0 / 接口相关文件/一甸园SAP-移动类型-物料凭证创建_V1.0.doc |
| 中台集成开发计划 V1.4 | OMS集成开发计划及设计_20231114_V1.4.xlsx |
| 产品主数据同步接口设计记录 v1.0 | 产品主数据同步接口 v1.0 / 接口相关文件/一甸园SAP项目_产品主数据同步接口v1.0 |
| 中台方案设计 | OMS 方案设计 |
| SAP与聚水潭OMS集成接口文档v1.0 | 一甸园SAP项目_接口开发功能设计文档（MM模块）V1.2 / ..._OMS_V1.0 |
| 中台功能手册 | 一甸园中台界面.docx |
| 销售相关SAP接口 | 一甸园销售相关SAP接口.docx |
| 接口开发负责人 | 李宝旭 |
---
*集成约定.md | v2.0 | 2026-08-21*
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment